@oliversalzburg/js-utils 0.7.0 → 0.8.0

package/lib/data/nil.js

@@ -0,0 +1,131 @@
+/**
+ * Check if something is nil.
+ * Can be used as a typeguard.
+ * @param subject - The subject that could be nil.
+ * @typeParam TSubject - The type of the subject.
+ * @returns `true` if the subject is nil, `false` otherwise.
+ */
+export function isNil(subject) {
+    return subject === null || subject === undefined;
+}
+/**
+ * Check if something is a concrete value of the given type.
+ * Can be used as a typeguard.
+ * @param subject - The subject that could be nil.
+ * @param Prototype - The prototype to check against.
+ * @typeParam TSubject - The type to check against.
+ * @returns `true` if the input element matches the given type,
+ * `false` otherwise.
+ */
+export function is(subject, Prototype) {
+    return !isNil(subject) && subject instanceof Prototype;
+}
+/**
+ * Thrown when an unexpected nil value was encountered.
+ */
+export class UnexpectedNilError extends Error {
+    /**
+     * Constructs a new {@linkcode UnexpectedNilError}.
+     * @param message - The error message.
+     */
+    constructor(message = "unexpected nil value") {
+        super(message);
+    }
+}
+/**
+ * Ensure that the passed subject is not nil; throw otherwise.
+ * @param subject - A subject that is possibly nil.
+ * @param errorMessage - An optional error message to throw when the subject is nil.
+ * @typeParam TSubject - The type of the subject.
+ * @returns The subject, if it isn't nil.
+ * @throws {@linkcode UnexpectedNilError} When the subject is nil.
+ */
+export function mustExist(subject, errorMessage) {
+    if (isNil(subject)) {
+        throw new UnexpectedNilError(errorMessage);
+    }
+    return subject;
+}
+/**
+ * Ensure that all passed subjects are not nil; throw otherwise.
+ * @param subjects - The subjects that are possibly nil.
+ * @param errorMessage - An optional error message to throw when a subject is nil.
+ * @typeParam TSubject - The type a the subject.
+ * @returns The subjects, if they aren't nil.
+ * @throws {@linkcode UnexpectedNilError} When a subject is nil.
+ */
+export function mustExistAll(subjects, errorMessage) {
+    for (const subject of subjects) {
+        if (isNil(subject)) {
+            throw new UnexpectedNilError(errorMessage);
+        }
+    }
+    return subjects;
+}
+/**
+ * Ensure that the passed subject is not nil; throw otherwise.
+ * @param subject - A subject that is possibly nil.
+ * @typeParam TSubject - The type of the subject.
+ * @throws {@linkcode UnexpectedNilError} When the subject is nil.
+ */
+export function assertExists(subject) {
+    if (isNil(subject)) {
+        throw new UnexpectedNilError();
+    }
+}
+/**
+ * Ensure that the passed subjects are not nil; throw otherwise.
+ * @param subjects - Subjects that are possibly nil.
+ * @typeParam TSubject - The type of a subject.
+ * @throws {@linkcode UnexpectedNilError} When a subject is nil.
+ */
+export function assertExistsAll(subjects) {
+    for (const subject of subjects) {
+        if (isNil(subject)) {
+            throw new UnexpectedNilError();
+        }
+    }
+}
+/**
+ * Convert a nilable into a real value, if it is nil.
+ * @param nilable - The subject to convert to an optional.
+ * @param to - The value to coalese to.
+ * @returns The input value, if it wasn't nil, or the value to coalesce to.
+ */
+export function coalesce(nilable, to) {
+    if (isNil(nilable)) {
+        return to;
+    }
+    return nilable;
+}
+/**
+ * Drop all nil values from an array, or replaces them with another value.
+ * @param nilables - The subject to convert.
+ * @param to - The value to coalese to.
+ * @returns An array with where all values are not nil.
+ */
+export function coalesceArray(nilables, to) {
+    const result = new Array();
+    for (const nilable of nilables) {
+        if (!isNil(nilable)) {
+            result.push(nilable);
+        }
+        else if (!isNil(to)) {
+            result.push(to);
+        }
+    }
+    return result;
+}
+/**
+ * Convert a nilable into an optional argument.
+ * This means `null` is normalized to `undefined`.
+ * @param nilable - The subject to convert to an optional.
+ * @returns The value, normalized to `undefined`, if it was nil.
+ */
+export function toOptional(nilable) {
+    if (isNil(nilable)) {
+        return undefined;
+    }
+    return nilable;
+}
+//# sourceMappingURL=nil.js.map

package/lib/data/nil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nil.js","sourceRoot":"","sources":["../../source/data/nil.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAW,OAAwB;IACvD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC;AAClD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,EAAE,CACjB,OAAkC,EAClC,SAAkC;IAElC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,YAAY,SAAS,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C;;;OAGG;IACH,YAAY,OAAO,GAAG,sBAAsB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;IAChB,CAAC;CACD;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACxB,OAAwB,EACxB,YAAqB;IAErB,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC3B,QAAgC,EAChC,YAAqB;IAErB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAED,OAAO,QAA2B,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,OAAwB;IAExB,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,EAAE,CAAC;IAChC,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC9B,QAAgC;IAEhC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAkB,EAAE,CAAC;QAChC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,OAAiB,EAAE,EAAK;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACX,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC5B,QAAyB,EACzB,EAAa;IAEb,MAAM,MAAM,GAAG,IAAI,KAAK,EAAK,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,OAAiB;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/lib/data/random.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Helps with generating random numbers.
+ */
+export declare class Random {
+    /**
+     * The value this PRNG was seeded with.
+     */
+    private _seed;
+    /**
+     * Retrieve the seed of the PRNG.
+     * @returns The seed of the PRNG.
+     */
+    get seed(): number;
+    /**
+     * The permutation table for simplex noise.
+     */
+    private _perm;
+    /**
+     * The gradient map for simplex noise.
+     */
+    private _gradP;
+    /**
+     * Skewing and unskewing factors for 2, 3, and 4 dimensions.
+     */
+    private _F2;
+    /**
+     * Skewing and unskewing factors for 2, 3, and 4 dimensions.
+     */
+    private _G2;
+    /**
+     * Creates a pseudo-random value generator. The seed must be an integer.
+     *
+     * Uses an optimized version of the Park-Miller PRNG.
+     * http://www.firstpr.com.au/dsp/rand31/
+     * @param seed - The seed for the random number generator.
+     */
+    constructor(seed?: number);
+    /**
+     * Returns a pseudo-random value between 1 and 2^32 - 2.
+     * @returns A pseudo-random value between 1 and 2^32 - 2.
+     */
+    next(): number;
+    /**
+     * Returns a random value in a given range.
+     * @param min - The lower bound.
+     * @param max - The upper bound.
+     * @returns A random value between the lower and upper bound.
+     */
+    nextRange(min: number, max: number): number;
+    /**
+     * Returns either `true` or `false`.
+     * @returns Either `true` or `false`.
+     */
+    nextBoolean(): boolean;
+    /**
+     * Returns a pseudo-random floating point number in range [0, 1).
+     * @returns a pseudo-random floating point number in range [0, 1).
+     */
+    nextFloat(): number;
+    /**
+     * Creates a new Random instance, with a seed that is based of the seed
+     * of this Random instance.
+     * @returns A new random number generator.
+     */
+    nextRandom(): Random;
+    static ALLOWED_CHARACTERS: string;
+    /**
+     * Returns a random ASCII string.
+     * @param length - The length of the string.
+     * @returns A random ASCII string.
+     */
+    nextString(length: number, characters?: string): string;
+    /**
+     * Returns a 2D simplex noise value for a given input coordinate.
+     * @param x - The X input coordinate.
+     * @param y - The Y input coordinate.
+     * @returns The noise value for the input coordinates.
+     */
+    simplex2(x: number, y: number): number;
+    /**
+     * Returns a 3D simplex noise value for a given input coordinate.
+     * @param x - The X input coordinate.
+     * @param y - The Y input coordinate.
+     * @param z - The Z input coordinate.
+     * @returns The noise value for the input coordinates.
+     */
+    simplex3(x: number, y: number, z: number): number;
+}
+/**
+ * Returns a random value in a given range.
+ *
+ * Uses the JS-internal `Math.random()`. Use {@linkcode Random} for a PRNG with more features.
+ *
+ * Note that this method returns floating point numbers, regardless of your inputs potentially
+ * being integers. If you require integers, ensure to truncate the resulting random value.
+ * @param min - The lower bound.
+ * @param max - The upper bound.
+ * @returns A random value between the lower and upper bound.
+ */
+export declare const randomRange: (min: number, max: number) => number;
+/**
+ * Generates a numberic seed, to be used as an input for a PRNG,
+ * from a string.
+ * @param input - The string to use as a seed.
+ * @returns A numeric seed value for a PRNG.
+ */
+export declare const seedFromString: (input: string) => number;
+/**
+ * A global PRNG instance that is ready-to-use.
+ */
+export declare const random: Random;

package/lib/data/random.js

@@ -0,0 +1,381 @@
+import { Vector3 } from "../math/vector3.js";
+/**
+ * Helps with generating random numbers.
+ */
+export class Random {
+    /**
+     * The value this PRNG was seeded with.
+     */
+    _seed;
+    /**
+     * Retrieve the seed of the PRNG.
+     * @returns The seed of the PRNG.
+     */
+    get seed() {
+        return this._seed;
+    }
+    /**
+     * The permutation table for simplex noise.
+     */
+    _perm;
+    /**
+     * The gradient map for simplex noise.
+     */
+    _gradP;
+    /**
+     * Skewing and unskewing factors for 2, 3, and 4 dimensions.
+     */
+    _F2;
+    /**
+     * Skewing and unskewing factors for 2, 3, and 4 dimensions.
+     */
+    _G2;
+    /**
+     * Creates a pseudo-random value generator. The seed must be an integer.
+     *
+     * Uses an optimized version of the Park-Miller PRNG.
+     * http://www.firstpr.com.au/dsp/rand31/
+     * @param seed - The seed for the random number generator.
+     */
+    constructor(seed = 0) {
+        this._seed = Math.trunc(seed) % 2147483647;
+        if (this._seed <= 0) {
+            this._seed += 2147483646;
+        }
+        const grad3 = [
+            new Vector3(1, 1, 0),
+            new Vector3(-1, 1, 0),
+            new Vector3(1, -1, 0),
+            new Vector3(-1, -1, 0),
+            new Vector3(1, 0, 1),
+            new Vector3(-1, 0, 1),
+            new Vector3(1, 0, -1),
+            new Vector3(-1, 0, -1),
+            new Vector3(0, 1, 1),
+            new Vector3(0, -1, 1),
+            new Vector3(0, 1, -1),
+            new Vector3(0, -1, -1),
+        ];
+        const p = [
+            151, 160, 137, 91, 90, 15, 131, 13, 201, 95, 96, 53, 194, 233, 7, 225,
+            140, 36, 103, 30, 69, 142, 8, 99, 37, 240, 21, 10, 23, 190, 6, 148, 247,
+            120, 234, 75, 0, 26, 197, 62, 94, 252, 219, 203, 117, 35, 11, 32, 57, 177,
+            33, 88, 237, 149, 56, 87, 174, 20, 125, 136, 171, 168, 68, 175, 74, 165,
+            71, 134, 139, 48, 27, 166, 77, 146, 158, 231, 83, 111, 229, 122, 60, 211,
+            133, 230, 220, 105, 92, 41, 55, 46, 245, 40, 244, 102, 143, 54, 65, 25,
+            63, 161, 1, 216, 80, 73, 209, 76, 132, 187, 208, 89, 18, 169, 200, 196,
+            135, 130, 116, 188, 159, 86, 164, 100, 109, 198, 173, 186, 3, 64, 52, 217,
+            226, 250, 124, 123, 5, 202, 38, 147, 118, 126, 255, 82, 85, 212, 207, 206,
+            59, 227, 47, 16, 58, 17, 182, 189, 28, 42, 223, 183, 170, 213, 119, 248,
+            152, 2, 44, 154, 163, 70, 221, 153, 101, 155, 167, 43, 172, 9, 129, 22,
+            39, 253, 19, 98, 108, 110, 79, 113, 224, 232, 178, 185, 112, 104, 218,
+            246, 97, 228, 251, 34, 242, 193, 238, 210, 144, 12, 191, 179, 162, 241,
+            81, 51, 145, 235, 249, 14, 239, 107, 49, 192, 214, 31, 181, 199, 106, 157,
+            184, 84, 204, 176, 115, 121, 50, 45, 127, 4, 150, 254, 138, 236, 205, 93,
+            222, 114, 67, 29, 24, 72, 243, 141, 128, 195, 78, 66, 215, 61, 156, 180,
+        ];
+        this._perm = new Array(512);
+        this._gradP = new Array(512);
+        for (let i = 0; i < 256; i++) {
+            let v;
+            if (i & 1) {
+                v = p[i] ^ (this._seed & 255);
+            }
+            else {
+                v = p[i] ^ ((this._seed >> 8) & 255);
+            }
+            this._perm[i] = this._perm[i + 256] = v;
+            this._gradP[i] = this._gradP[i + 256] = grad3[v % 12];
+        }
+        this._F2 = 0.5 * (Math.sqrt(3) - 1);
+        this._G2 = (3 - Math.sqrt(3)) / 6;
+    }
+    /**
+     * Returns a pseudo-random value between 1 and 2^32 - 2.
+     * @returns A pseudo-random value between 1 and 2^32 - 2.
+     */
+    next() {
+        this._seed = (this._seed * 16807) % 2147483647;
+        return this._seed;
+    }
+    /**
+     * Returns a random value in a given range.
+     * @param min - The lower bound.
+     * @param max - The upper bound.
+     * @returns A random value between the lower and upper bound.
+     */
+    nextRange(min, max) {
+        return this.nextFloat() * (max - min) + min;
+    }
+    /**
+     * Returns either `true` or `false`.
+     * @returns Either `true` or `false`.
+     */
+    nextBoolean() {
+        return this.next() < 2147483646 / 2;
+    }
+    /**
+     * Returns a pseudo-random floating point number in range [0, 1).
+     * @returns a pseudo-random floating point number in range [0, 1).
+     */
+    nextFloat() {
+        // We know that result of next() will be 1 to 2147483646 (inclusive).
+        return (this.next() - 1) / 2147483646;
+    }
+    /**
+     * Creates a new Random instance, with a seed that is based of the seed
+     * of this Random instance.
+     * @returns A new random number generator.
+     */
+    nextRandom() {
+        return new Random(this.seed + 1);
+    }
+    static ALLOWED_CHARACTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+    /**
+     * Returns a random ASCII string.
+     * @param length - The length of the string.
+     * @returns A random ASCII string.
+     */
+    nextString(length, characters = Random.ALLOWED_CHARACTERS) {
+        let result = "";
+        while (result.length < length) {
+            const characterIndex = Math.floor(this.nextFloat() * characters.length);
+            result += characters.substring(characterIndex, characterIndex + 1);
+        }
+        return result;
+    }
+    /**
+     * Returns a 2D simplex noise value for a given input coordinate.
+     * @param x - The X input coordinate.
+     * @param y - The Y input coordinate.
+     * @returns The noise value for the input coordinates.
+     */
+    simplex2(x, y) {
+        let n0, n1, n2; // Noise contributions from the three corners
+        // Skew the input space to determine which simplex cell we're in
+        const s = (x + y) * this._F2; // Hairy factor for 2D
+        let i = Math.floor(x + s);
+        let j = Math.floor(y + s);
+        const t = (i + j) * this._G2;
+        const x0 = x - i + t; // The x,y distances from the cell origin, unskewed.
+        const y0 = y - j + t;
+        // For the 2D case, the simplex shape is an equilateral triangle.
+        // Determine which simplex we are in.
+        let i1, j1; // Offsets for second (middle) corner of simplex in (i,j) coords
+        if (x0 > y0) {
+            // lower triangle, XY order: (0,0)->(1,0)->(1,1)
+            i1 = 1;
+            j1 = 0;
+        }
+        else {
+            // upper triangle, YX order: (0,0)->(0,1)->(1,1)
+            i1 = 0;
+            j1 = 1;
+        }
+        // A step of (1,0) in (i,j) means a step of (1-c,-c) in (x,y), and
+        // a step of (0,1) in (i,j) means a step of (-c,1-c) in (x,y), where
+        // c = (3-sqrt(3))/6
+        const x1 = x0 - i1 + this._G2; // Offsets for middle corner in (x,y) unskewed coords
+        const y1 = y0 - j1 + this._G2;
+        const x2 = x0 - 1 + 2 * this._G2; // Offsets for last corner in (x,y) unskewed coords
+        const y2 = y0 - 1 + 2 * this._G2;
+        // Work out the hashed gradient indices of the three simplex corners
+        i &= 255;
+        j &= 255;
+        const gi0 = this._gradP[i + this._perm[j]];
+        const gi1 = this._gradP[i + i1 + this._perm[j + j1]];
+        const gi2 = this._gradP[i + 1 + this._perm[j + 1]];
+        // Calculate the contribution from the three corners
+        let t0 = 0.5 - x0 * x0 - y0 * y0;
+        if (t0 < 0) {
+            n0 = 0;
+        }
+        else {
+            t0 *= t0;
+            n0 = t0 * t0 * gi0.dotXYZ(x0, y0, 0); // (x,y) of grad3 used for 2D gradient
+        }
+        let t1 = 0.5 - x1 * x1 - y1 * y1;
+        if (t1 < 0) {
+            n1 = 0;
+        }
+        else {
+            t1 *= t1;
+            n1 = t1 * t1 * gi1.dotXYZ(x1, y1, 0);
+        }
+        let t2 = 0.5 - x2 * x2 - y2 * y2;
+        if (t2 < 0) {
+            n2 = 0;
+        }
+        else {
+            t2 *= t2;
+            n2 = t2 * t2 * gi2.dotXYZ(x2, y2, 0);
+        }
+        // Add contributions from each corner to get the final noise value.
+        // The result is scaled to return values in the interval [-1,1].
+        return 70 * (n0 + n1 + n2);
+    }
+    /**
+     * Returns a 3D simplex noise value for a given input coordinate.
+     * @param x - The X input coordinate.
+     * @param y - The Y input coordinate.
+     * @param z - The Z input coordinate.
+     * @returns The noise value for the input coordinates.
+     */
+    simplex3(x, y, z) {
+        const F3 = 1 / 3;
+        const G3 = 1 / 6;
+        let n0, n1, n2, n3; // Noise contributions from the four corners
+        // Skew the input space to determine which simplex cell we're in
+        const s = (x + y + z) * F3; // Hairy factor for 2D
+        let i = Math.floor(x + s);
+        let j = Math.floor(y + s);
+        let k = Math.floor(z + s);
+        const t = (i + j + k) * G3;
+        const x0 = x - i + t; // The x,y distances from the cell origin, unskewed.
+        const y0 = y - j + t;
+        const z0 = z - k + t;
+        // For the 3D case, the simplex shape is a slightly irregular tetrahedron.
+        // Determine which simplex we are in.
+        let i1, j1, k1; // Offsets for second corner of simplex in (i,j,k) coords
+        let i2, j2, k2; // Offsets for third corner of simplex in (i,j,k) coords
+        if (x0 >= y0) {
+            if (y0 >= z0) {
+                i1 = 1;
+                j1 = 0;
+                k1 = 0;
+                i2 = 1;
+                j2 = 1;
+                k2 = 0;
+            }
+            else if (x0 >= z0) {
+                i1 = 1;
+                j1 = 0;
+                k1 = 0;
+                i2 = 1;
+                j2 = 0;
+                k2 = 1;
+            }
+            else {
+                i1 = 0;
+                j1 = 0;
+                k1 = 1;
+                i2 = 1;
+                j2 = 0;
+                k2 = 1;
+            }
+        }
+        else {
+            if (y0 < z0) {
+                i1 = 0;
+                j1 = 0;
+                k1 = 1;
+                i2 = 0;
+                j2 = 1;
+                k2 = 1;
+            }
+            else if (x0 < z0) {
+                i1 = 0;
+                j1 = 1;
+                k1 = 0;
+                i2 = 0;
+                j2 = 1;
+                k2 = 1;
+            }
+            else {
+                i1 = 0;
+                j1 = 1;
+                k1 = 0;
+                i2 = 1;
+                j2 = 1;
+                k2 = 0;
+            }
+        }
+        // A step of (1,0,0) in (i,j,k) means a step of (1-c,-c,-c) in (x,y,z),
+        // a step of (0,1,0) in (i,j,k) means a step of (-c,1-c,-c) in (x,y,z), and
+        // a step of (0,0,1) in (i,j,k) means a step of (-c,-c,1-c) in (x,y,z), where
+        // c = 1/6.
+        const x1 = x0 - i1 + G3; // Offsets for second corner
+        const y1 = y0 - j1 + G3;
+        const z1 = z0 - k1 + G3;
+        const x2 = x0 - i2 + 2 * G3; // Offsets for third corner
+        const y2 = y0 - j2 + 2 * G3;
+        const z2 = z0 - k2 + 2 * G3;
+        const x3 = x0 - 1 + 3 * G3; // Offsets for fourth corner
+        const y3 = y0 - 1 + 3 * G3;
+        const z3 = z0 - 1 + 3 * G3;
+        // Work out the hashed gradient indices of the four simplex corners
+        i &= 255;
+        j &= 255;
+        k &= 255;
+        const gi0 = this._gradP[i + this._perm[j + this._perm[k]]];
+        const gi1 = this._gradP[i + i1 + this._perm[j + j1 + this._perm[k + k1]]];
+        const gi2 = this._gradP[i + i2 + this._perm[j + j2 + this._perm[k + k2]]];
+        const gi3 = this._gradP[i + 1 + this._perm[j + 1 + this._perm[k + 1]]];
+        // Calculate the contribution from the four corners
+        let t0 = 0.6 - x0 * x0 - y0 * y0 - z0 * z0;
+        if (t0 < 0) {
+            n0 = 0;
+        }
+        else {
+            t0 *= t0;
+            n0 = t0 * t0 * gi0.dotXYZ(x0, y0, z0); // (x,y) of grad3 used for 2D gradient
+        }
+        let t1 = 0.6 - x1 * x1 - y1 * y1 - z1 * z1;
+        if (t1 < 0) {
+            n1 = 0;
+        }
+        else {
+            t1 *= t1;
+            n1 = t1 * t1 * gi1.dotXYZ(x1, y1, z1);
+        }
+        let t2 = 0.6 - x2 * x2 - y2 * y2 - z2 * z2;
+        if (t2 < 0) {
+            n2 = 0;
+        }
+        else {
+            t2 *= t2;
+            n2 = t2 * t2 * gi2.dotXYZ(x2, y2, z2);
+        }
+        let t3 = 0.6 - x3 * x3 - y3 * y3 - z3 * z3;
+        if (t3 < 0) {
+            n3 = 0;
+        }
+        else {
+            t3 *= t3;
+            n3 = t3 * t3 * gi3.dotXYZ(x3, y3, z3);
+        }
+        // Add contributions from each corner to get the final noise value.
+        // The result is scaled to return values in the interval [-1,1].
+        return 32 * (n0 + n1 + n2 + n3);
+    }
+}
+/**
+ * Returns a random value in a given range.
+ *
+ * Uses the JS-internal `Math.random()`. Use {@linkcode Random} for a PRNG with more features.
+ *
+ * Note that this method returns floating point numbers, regardless of your inputs potentially
+ * being integers. If you require integers, ensure to truncate the resulting random value.
+ * @param min - The lower bound.
+ * @param max - The upper bound.
+ * @returns A random value between the lower and upper bound.
+ */
+export const randomRange = (min, max) => {
+    return Math.random() * (max - min) + min;
+};
+/**
+ * Generates a numberic seed, to be used as an input for a PRNG,
+ * from a string.
+ * @param input - The string to use as a seed.
+ * @returns A numeric seed value for a PRNG.
+ */
+export const seedFromString = (input) => {
+    return input
+        .split("")
+        .reduce((seed, char) => (seed = seed + ((char.charCodeAt(0) * 17989) % 2147483647)), 0);
+};
+/**
+ * A global PRNG instance that is ready-to-use.
+ */
+export const random = new Random();
+//# sourceMappingURL=random.js.map

package/lib/data/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../source/data/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,MAAM;IAClB;;OAEG;IACK,KAAK,CAAS;IAEtB;;;OAGG;IACH,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,KAAK,CAAgB;IAE7B;;OAEG;IACK,MAAM,CAAiB;IAE/B;;OAEG;IACK,GAAG,CAAS;IAEpB;;OAEG;IACK,GAAG,CAAS;IAEpB;;;;;;OAMG;IACH,YAAY,IAAI,GAAG,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC;QAC1B,CAAC;QAED,MAAM,KAAK,GAAG;YACb,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACtB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACtB,CAAC;QAEF,MAAM,CAAC,GAAG;YACT,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;YACrE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG;YACvE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG;YACzE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG;YACvE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG;YACxE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;YACtE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;YACtE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG;YACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;YACzE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;YACvE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;YACtE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;YACrE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;YACtE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;YACzE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,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"}

package/lib/data/string.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Indent every line of the passed text.
+ * @param subject - The text to indent.
+ * @param depth - How often to apply the indenting.
+ * @param prefix - The string to use as the indent.
+ * @returns The indented text.
+ */
+export declare const indent: (subject: string, depth?: number, prefix?: string) => string;
+/**
+ * A fast and simple 53-bit string hash function with decent collision resistance.
+ * Largely inspired by MurmurHash2/3, but with a focus on speed/simplicity.
+ * License: Public domain. Attribution appreciated.
+ * cyrb53 (c) 2018 bryc (github.com/bryc)
+ * @param subject - The string to hash.
+ * @param seed - An optional seed value.
+ * @returns A hash of the string.
+ */
+export declare const hashCyrb53: (subject: string, seed?: number) => string;
+/**
+ * Encodes the provided string in Base64.
+ * @param subject - The string to encode.
+ * @returns The subject string encoded in Base64.
+ */
+export declare const base64Encode: (subject: string) => string;
+/**
+ * Decodes the provided Base64 encoded string.
+ * @param subject - The string to decode.
+ * @returns The decoded subject string.
+ */
+export declare const base64Decode: (subject: string) => string;