adaptive-extender 0.2.5

package/dist/core/global.d.ts

@@ -0,0 +1,14 @@
+declare global {
+    /**
+     * Returns the prototype of the given non-nullable value.
+     * @param value The value whose prototype is to be retrieved. It cannot be null or undefined.
+     */
+    function prototype<T>(value: NonNullable<T>): Function;
+    /**
+     * Gets the type name of a value.
+     * @param value The value to get the type name of.
+     * @returns The type name of the value.
+     */
+    function typename(value: any): string;
+}
+export {};

package/dist/core/global.js

@@ -0,0 +1,13 @@
+"use strict";
+globalThis.prototype = function (value) {
+    return value.constructor;
+};
+globalThis.typename = function (value) {
+    switch (value) {
+        case undefined: return "Undefined";
+        case null: return "Null";
+        default: return prototype(value).name;
+    }
+};
+export {};
+//# sourceMappingURL=global.js.map

package/dist/core/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/core/global.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAgBb,UAAU,CAAC,SAAS,GAAG,UAAa,KAAqB;IACxD,OAAO,KAAK,CAAC,WAAW,CAAC;AAC1B,CAAC,CAAC;AAEF,UAAU,CAAC,QAAQ,GAAG,UAAU,KAAU;IACzC,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;AACF,CAAC,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,17 @@
+import "./global.js";
+import { PrimitivesHintMap } from "./primitives.js";
+import "./number.js";
+import "./string.js";
+import "./boolean.js";
+import "./date.js";
+import "./math.js";
+import "./array.js";
+import "./object.js";
+import "./error.js";
+import { ImplementationError } from "./error.js";
+import "./promise.js";
+import { Promisable } from "./promise.js";
+import { Random } from "./random.js";
+import { ColorFormats, ColorProperties, Color } from "./color.js";
+export { PrimitivesHintMap, Promisable, ColorProperties };
+export { ImplementationError, Random, ColorFormats, Color };

package/dist/core/index.js

@@ -0,0 +1,16 @@
+"use strict";
+import "./global.js";
+import "./number.js";
+import "./string.js";
+import "./boolean.js";
+import "./date.js";
+import "./math.js";
+import "./array.js";
+import "./object.js";
+import "./error.js";
+import { ImplementationError } from "./error.js";
+import "./promise.js";
+import { Random } from "./random.js";
+import { ColorFormats, Color } from "./color.js";
+export { ImplementationError, Random, ColorFormats, Color };
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAErB,OAAO,aAAa,CAAC;AACrB,OAAO,aAAa,CAAC;AACrB,OAAO,cAAc,CAAC;AACtB,OAAO,WAAW,CAAC;AACnB,OAAO,WAAW,CAAC;AACnB,OAAO,YAAY,CAAC;AACpB,OAAO,aAAa,CAAC;AACrB,OAAO,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAmB,KAAK,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/dist/core/math.d.ts

@@ -0,0 +1,44 @@
+declare global {
+    interface Math {
+        /**
+         * Splits a number into its integer and fractional parts.
+         * @param x The number to be split.
+         * @returns A tuple where the first element is the integer part and the second element is the fractional part.
+         * ```ts
+         * const [integer, fractional] = Math.split(x);
+         * ```
+         */
+        split(x: number): [number, number];
+        /**
+         * Calculates the square of a number.
+         * @param x The number to square.
+         */
+        sqpw(x: number): number;
+        /**
+         * Converts radians to degrees.
+         * @param radians The angle in radians.
+         */
+        toDegrees(radians: number): number;
+        /**
+         * Converts degrees to radians.
+         * @param degrees The angle in degrees.
+         */
+        toRadians(degrees: number): number;
+        /**
+         * Calculates the arithmetic mean of the given numbers.
+         * @param values The numbers to calculate the mean from.
+         */
+        meanArithmetic(...values: number[]): number;
+        /**
+         * Calculates the geometric mean of the given numbers.
+         * @param values The numbers to calculate the mean from.
+         */
+        meanGeometric(...values: number[]): number;
+        /**
+         * Calculates the harmonic mean of the given numbers.
+         * @param values The numbers to calculate the mean from.
+         */
+        meanHarmonic(...values: number[]): number;
+    }
+}
+export {};

package/dist/core/math.js

@@ -0,0 +1,43 @@
+"use strict";
+const { PI, trunc, pow } = Math;
+Math.split = function (x) {
+    const integer = trunc(x);
+    return [integer, (x - integer)];
+};
+Math.sqpw = function (x) {
+    return x * x;
+};
+const toDegreeFactor = 180 / PI;
+Math.toDegrees = function (radians) {
+    return radians * toDegreeFactor;
+};
+const toRadianFactor = PI / 180;
+Math.toRadians = function (degrees) {
+    return degrees * toRadianFactor;
+};
+Math.meanArithmetic = function (...values) {
+    let summary = 0;
+    for (let index = 0; index < values.length; index++) {
+        summary += values[index];
+    }
+    return summary / values.length;
+};
+Math.meanGeometric = function (...values) {
+    let product = 1;
+    for (let index = 0; index < values.length; index++) {
+        product *= values[index];
+    }
+    return pow(product, 1 / values.length);
+};
+Math.meanHarmonic = function (...values) {
+    let summary = 0;
+    for (let index = 0; index < values.length; index++) {
+        const value = values[index];
+        if (value === 0)
+            return NaN;
+        summary += 1 / value;
+    }
+    return values.length / summary;
+};
+export {};
+//# sourceMappingURL=math.js.map

package/dist/core/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/core/math.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AA8ChC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAS;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,IAAI,CAAC,IAAI,GAAG,UAAU,CAAS;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,GAAG,GAAG,EAAE,CAAC;AAChC,IAAI,CAAC,SAAS,GAAG,UAAU,OAAe;IACzC,OAAO,OAAO,GAAG,cAAc,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,EAAE,GAAG,GAAG,CAAC;AAChC,IAAI,CAAC,SAAS,GAAG,UAAU,OAAe;IACzC,OAAO,OAAO,GAAG,cAAc,CAAC;AACjC,CAAC,CAAC;AAEF,IAAI,CAAC,cAAc,GAAG,UAAU,GAAG,MAAgB;IAClD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;AAChC,CAAC,CAAC;AAEF,IAAI,CAAC,aAAa,GAAG,UAAU,GAAG,MAAgB;IACjD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,IAAI,CAAC,YAAY,GAAG,UAAU,GAAG,MAAgB;IAChD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;AAChC,CAAC,CAAC"}

package/dist/core/number.d.ts

@@ -0,0 +1,59 @@
+import "./global.js";
+declare global {
+    interface NumberConstructor {
+        /**
+         * Imports a number from a source.
+         * @param source The source value to import.
+         * @param name The name of the source value.
+         * @returns The imported number value.
+         * @throws {TypeError} If the source is not a number.
+         */
+        import(source: any, name?: string): number;
+    }
+    interface Number {
+        /**
+         * Clamps a value between a minimum and maximum.
+         * @param min The minimum value.
+         * @param max The maximum value.
+         * @returns The clamped value.
+         */
+        clamp(min: number, max: number): number;
+        /**
+         * Interpolates the number from one range to another.
+         * @param min1 The minimum value of the original range.
+         * @param max1 The maximum value of the original range.
+         * @param min2 The minimum value of the target range. Defaults to 0.
+         * @param max2 The maximum value of the target range. Defaults to 1.
+         * @returns The interpolated value within the target range.
+         * @throws {Error} If the minimum and maximum of either range are equal.
+         */
+        interpolate(min1: number, max1: number, min2?: number, max2?: number): number;
+        /**
+         * Modulates the current number within a specified range.
+         * @param length The range length.
+         * @param start The start of the range. Defaults to 0.
+         * @returns The number constrained within the range.
+         * @throws {Error} If the range is zero.
+         */
+        modulate(length: number, start?: number): number;
+        /**
+         * Returns the current number unless it is NaN, replacing it with the provided value.
+         * @param value The fallback value.
+         * @returns The original number or the fallback.
+         */
+        insteadNaN<T>(value: T): number | T;
+        /**
+         * Returns the current number unless it is NaN or infinite, replacing it with the provided value.
+         * @param value The fallback value.
+         * @returns The original number or the fallback.
+         */
+        insteadInfinity<T>(value: T): number | T;
+        /**
+         * Returns the current number unless it is zero, NaN, or infinite, replacing it with the provided value.
+         * @param value The fallback value.
+         * @returns The original number or the fallback.
+         */
+        insteadZero<T>(value: T): number | T;
+    }
+}
+export {};

package/dist/core/number.js

@@ -0,0 +1,51 @@
+"use strict";
+import "./global.js";
+Number.import = function (source, name = "[source]") {
+    if (typeof (source) !== "number")
+        throw new TypeError(`Unable to import number from ${name} due its ${typename(source)} type`);
+    return source.valueOf();
+};
+Number.prototype.clamp = function (min, max) {
+    let value = this.valueOf();
+    if (value < min)
+        return min;
+    if (value > max)
+        return max;
+    return value;
+};
+Number.prototype.interpolate = function (min1, max1, min2 = 0, max2 = 1) {
+    if (min1 === max1)
+        throw new Error("Minimum and maximum of the original range cant be equal");
+    if (min2 === max2)
+        throw new Error("Minimum and maximum of the target range cant be equal");
+    return min2 + (max2 - min2) * ((this.valueOf() - min1) / (max1 - min1));
+};
+Number.prototype.modulate = function (length, start = 0) {
+    if (length === 0)
+        throw new Error("Range can't be zero");
+    let value = (this.valueOf() - start) % length;
+    if (value < 0)
+        value += length;
+    return value + start;
+};
+Number.prototype.insteadNaN = function (value) {
+    const current = this.valueOf();
+    if (Number.isNaN(current))
+        return value;
+    return current;
+};
+Number.prototype.insteadInfinity = function (value) {
+    const current = this.valueOf();
+    if (!Number.isFinite(current))
+        return value;
+    return current;
+};
+Number.prototype.insteadZero = function (value) {
+    const current = this.valueOf();
+    if (!Number.isFinite(current))
+        return value;
+    if (current === 0)
+        return value;
+    return current;
+};
+//# sourceMappingURL=number.js.map

package/dist/core/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/core/number.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AA6DrB,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,OAAe,UAAU;IAC/D,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,UAAU,GAAW,EAAE,GAAW;IAC1D,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,WAAW,GAAG,UAAU,IAAY,EAAE,IAAY,EAAE,OAAe,CAAC,EAAE,OAAe,CAAC;IACtG,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC9F,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC5F,OAAO,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,UAAU,MAAc,EAAE,QAAgB,CAAC;IACtE,IAAI,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzD,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC;IAC9C,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,IAAI,MAAM,CAAC;IAC/B,OAAO,KAAK,GAAG,KAAK,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,UAAU,GAAG,UAAa,KAAQ;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,eAAe,GAAG,UAAa,KAAQ;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,WAAW,GAAG,UAAa,KAAQ;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC"}

package/dist/core/object.d.ts

@@ -0,0 +1,30 @@
+declare global {
+    interface ObjectConstructor {
+        /**
+         * Imports an object from a source.
+         * @param source The source to import from.
+         * @param name The name of the source.
+         * @returns The imported object.
+         * @throws {TypeError} If the source is not an object or null.
+         */
+        import(source: any, name?: string): object;
+        /**
+         * Applies a callback function to a non-nullable value, or returns the original nullable value.
+         * @template T The type of the input value.
+         * @template N The type representing nullable.
+         * @template R The return type of the callback function.
+         * @param value The value to map.
+         * @param callback The function to apply if the value is non-nullable.
+         * @returns The mapped result.
+         */
+        map<T, N extends Exclude<T, NonNullable<T>>, R>(value: NonNullable<T> | N, callback: (object: NonNullable<T>) => R): R | N;
+        /**
+         * Ensures that the given value is neither null nor undefined.
+         * @param value The value to check.
+         * @param message Optional error message.
+         * @throws {ReferenceError} If the value is null or undefined.
+         */
+        suppress<T>(value: T, message?: string): NonNullable<T>;
+    }
+}
+export {};

package/dist/core/object.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.import = function (source, name = "[source]") {
+    if (typeof (source) !== "object" || source === null)
+        throw new TypeError(`Unable to import object from ${name} due its ${typename(source)} type`);
+    return source;
+};
+Object.map = function (value, callback) {
+    if (value === null || value === undefined)
+        return value;
+    else
+        return callback(value);
+};
+Object.suppress = function (value, message) {
+    switch (value) {
+        case null: throw new ReferenceError(message ?? "Value mustn't be null");
+        case undefined: throw new ReferenceError(message ?? "Value mustn't be undefined");
+        default: return value;
+    }
+};
+export {};
+//# sourceMappingURL=object.js.map

package/dist/core/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/core/object.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAgCb,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,OAAe,UAAU;IAC/D,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClJ,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,GAAG,GAAG,UAAmB,KAAyB,EAAE,QAAuC;IACjG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;;QACnD,OAAO,QAAQ,CAAC,KAAuB,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,QAAQ,GAAG,UAAa,KAAQ,EAAE,OAA2B;IACnE,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,cAAc,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC;QACxE,KAAK,SAAS,CAAC,CAAC,MAAM,IAAI,cAAc,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAC;QAClF,OAAO,CAAC,CAAC,OAAQ,KAAwB,CAAC;IAC3C,CAAC;AACF,CAAC,CAAC"}

package/dist/core/primitives.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A mapping interface that associates primitive types with string keys.
+ * This is used to handle conversions to different primitive types.
+ */
+interface PrimitivesHintMap {
+    "number": number;
+    "boolean": boolean;
+    "string": string;
+}
+export { PrimitivesHintMap };

package/dist/core/primitives.js

@@ -0,0 +1,3 @@
+"use strict";
+export {};
+//# sourceMappingURL=primitives.js.map

package/dist/core/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/dist/core/promise.d.ts

@@ -0,0 +1,28 @@
+declare global {
+    interface Promise<T> {
+        /**
+         * Checks if the promise is settled.
+         */
+        readonly isSettled: Promise<boolean>;
+        /**
+         * Checks if the promise is resolved.
+         */
+        readonly isResolved: Promise<boolean>;
+        /**
+         * Checks if the promise is rejected.
+         */
+        readonly isRejected: Promise<boolean>;
+        /**
+         * Retrieves the value of a resolved promise.
+         * @throws {Error} Throws an error if the promise is rejected.
+         */
+        readonly value: Promise<T>;
+        /**
+         * Retrieves the reason of a rejected promise.
+         * @throws {Error} Throws an error if the promise is fulfilled.
+         */
+        readonly reason: Promise<any>;
+    }
+}
+type Promisable<T> = T | Promise<T>;
+export { Promisable };

package/dist/core/promise.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(Promise.prototype, "isSettled", {
+    async get() {
+        const symbol = Symbol();
+        try {
+            const result = (await Promise.race([this, symbol]) !== symbol);
+            return result;
+        }
+        catch {
+            return true;
+        }
+    }
+});
+Object.defineProperty(Promise.prototype, "isResolved", {
+    async get() {
+        try {
+            await this;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+});
+Object.defineProperty(Promise.prototype, "isRejected", {
+    async get() {
+        try {
+            await this;
+            return false;
+        }
+        catch {
+            return true;
+        }
+    }
+});
+Object.defineProperty(Promise.prototype, "value", {
+    async get() {
+        try {
+            return await this;
+        }
+        catch {
+            throw new Error("Unable to get value of rejected promise");
+        }
+    }
+});
+Object.defineProperty(Promise.prototype, "reason", {
+    async get() {
+        try {
+            await this;
+        }
+        catch (reason) {
+            return reason;
+        }
+        throw new Error("Unable to get reason of resolved promise");
+    }
+});
+export {};
+//# sourceMappingURL=promise.js.map

package/dist/core/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../src/core/promise.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AA6Bb,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE;IACrD,KAAK,CAAC,GAAG;QACR,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE;IACtD,KAAK,CAAC,GAAG;QACR,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC;YACX,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE;IACtD,KAAK,CAAC,GAAG;QACR,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC;YACX,OAAO,KAAK,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE;IACjD,KAAK,CAAC,GAAG;QACR,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC5D,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE;IAClD,KAAK,CAAC,GAAG;QACR,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC;QACZ,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QACf,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC7D,CAAC;CACD,CAAC,CAAC"}

package/dist/core/random.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Provides utility methods for generating random values.
+ */
+declare class Random {
+    #private;
+    /**
+     * Gets the global shared random generator instance.
+     * @readonly
+     */
+    static get global(): Random;
+    /**
+     * Generates a random boolean with a 50% probability of being `true`.
+     * @returns A random boolean value.
+     */
+    boolean(): boolean;
+    /**
+     * Generates a random boolean with the given probability of being `true`.
+     * @param factor Probability of returning `true` [0 – 1].
+     * @returns A random boolean value.
+     * @throws {Error} If `factor` is not a finite number.
+     * @throws {RangeError} If `factor` is outside the range.
+     */
+    boolean(factor: number): boolean;
+    /**
+     * Generates a random floating-point number between the smallest and largest possible number.
+     * @returns A random floating-point number.
+     */
+    number(): number;
+    /**
+     * Generates a random floating-point number between 0 and the specified maximum.
+     * @param max The maximum value (exclusive).
+     * @returns A random floating-point number.
+     */
+    number(max: number): number;
+    /**
+     * Generates a random floating-point number between the specified minimum and maximum.
+     * @param min The minimum value (inclusive).
+     * @param max The maximum value (exclusive).
+     * @returns A random floating-point number.
+     */
+    number(min: number, max: number): number;
+    /**
+     * Generates a random integer between the minimum safe integer and the maximum safe integer.
+     * @returns A random integer value.
+     */
+    integer(): number;
+    /**
+     * Generates a random integer between 0 and the specified maximum.
+     * @param max The maximum value (inclusive).
+     * @returns A random integer value.
+     */
+    integer(max: number): number;
+    /**
+     * Generates a random integer between the specified minimum and maximum.
+     * @param min The minimum value (inclusive).
+     * @param max The maximum value (inclusive).
+     * @returns A random integer value.
+     */
+    integer(min: number, max: number): number;
+    /**
+     * Selects a random item from a non-empty array.
+     * @param array The array to pick from.
+     * @returns A random element from the array.
+     * @throws {Error} If the array is empty.
+     */
+    item<T>(array: readonly T[]): T;
+    /**
+     * Creates a shuffled range of numbers between `min` and `max`.
+     * @param min Minimum value (inclusive).
+     * @param max Maximum value (inclusive).
+     * @returns An array of shuffled numbers in the specified range.
+     */
+    range(min: number, max: number): number[];
+    /**
+     * Returns all elements of the array in random order.
+     * @param array The source array.
+     * @returns A shuffled copy of the array.
+     */
+    subarray<T>(array: readonly T[]): T[];
+    /**
+     * Returns a random subset of the given size from the array.
+     * @param array The source array.
+     * @param count The number of elements to select.
+     * @returns A shuffled array containing the selected elements.
+     * @throws {Error} If `count` is not an integer.
+     * @throws {RangeError} If `count` is outside the valid range.
+     */
+    subarray<T>(array: readonly T[], count: number): T[];
+    /**
+     * Randomly shuffles the order of elements in an array in place.
+     * @param array The array to shuffle.
+     */
+    shuffle<T>(array: T[]): void;
+    /**
+     * Selects a random key from a map based on assigned weights.
+     * @param cases A map of items to their respective weights.
+     * @returns A randomly selected item based on weights.
+     * @throws {Error} If the map is empty.
+     * @throws {Error} If no item can be selected.
+     */
+    case<T>(cases: Readonly<Map<T, number>>): T;
+}
+export { Random };

package/dist/core/random.js

@@ -0,0 +1,114 @@
+"use strict";
+const { random, trunc } = Math;
+//#region Random
+/**
+ * Provides utility methods for generating random values.
+ */
+class Random {
+    static #global = new Random();
+    /**
+     * Gets the global shared random generator instance.
+     * @readonly
+     */
+    static get global() {
+        return Random.#global;
+    }
+    boolean(factor = 0.5) {
+        if (!Number.isFinite(factor))
+            throw new Error(`The factor ${factor} must be a finite number`);
+        if (0 > factor || factor > 1)
+            throw new RangeError(`The factor ${factor} is out of range [0 - 1]`);
+        return random() < factor;
+    }
+    #number(min, max) {
+        return random() * (max - min) + min;
+    }
+    number(arg1, arg2) {
+        if (arg1 === undefined)
+            return this.#number(-Number.MAX_VALUE, Number.MAX_VALUE);
+        if (arg2 === undefined)
+            return this.#number(0, arg1);
+        return this.#number(arg1, arg2);
+    }
+    #integer(min, max) {
+        return trunc(this.#number(min, max + 1));
+    }
+    integer(arg1, arg2) {
+        if (arg1 === undefined)
+            return this.#integer(Number.MIN_SAFE_INTEGER, Number.MAX_SAFE_INTEGER);
+        if (arg2 === undefined)
+            return this.#integer(0, arg1);
+        return this.#integer(arg1, arg2);
+    }
+    /**
+     * Selects a random item from a non-empty array.
+     * @param array The array to pick from.
+     * @returns A random element from the array.
+     * @throws {Error} If the array is empty.
+     */
+    item(array) {
+        if (array.length < 1)
+            throw new Error(`Array must have at least 1 item`);
+        return array[this.#integer(0, array.length - 1)];
+    }
+    /**
+     * Creates a shuffled range of numbers between `min` and `max`.
+     * @param min Minimum value (inclusive).
+     * @param max Maximum value (inclusive).
+     * @returns An array of shuffled numbers in the specified range.
+     */
+    range(min, max) {
+        const array = Array.range(min, max);
+        this.shuffle(array);
+        return array;
+    }
+    subarray(array, count = array.length) {
+        if (!Number.isInteger(count))
+            throw new Error(`The count ${count} must be a finite integer number`);
+        if (0 > count || count > array.length)
+            throw new RangeError(`The count ${count} is out of range [0 - ${array.length}]`);
+        const clone = Array.from(array);
+        const subarray = [];
+        for (let index = 0; index < count; index++) {
+            subarray.push(...clone.splice(this.#integer(0, clone.length - 1), 1));
+        }
+        return subarray;
+    }
+    /**
+     * Randomly shuffles the order of elements in an array in place.
+     * @param array The array to shuffle.
+     */
+    shuffle(array) {
+        for (let index = 0; index < array.length - 1; index++) {
+            const pair = this.#integer(index, array.length - 1);
+            if (pair === index)
+                continue;
+            array.swap(index, pair);
+        }
+    }
+    /**
+     * Selects a random key from a map based on assigned weights.
+     * @param cases A map of items to their respective weights.
+     * @returns A randomly selected item based on weights.
+     * @throws {Error} If the map is empty.
+     * @throws {Error} If no item can be selected.
+     */
+    case(cases) {
+        if (1 > cases.size)
+            throw new Error(`The cases must have at least 1 item`);
+        const summary = Array.from(cases).reduce((previous, [, weight]) => previous + weight, 0);
+        const random = this.#number(0, summary);
+        let begin = 0;
+        for (const [item, weight] of cases) {
+            const end = begin + weight;
+            if (begin <= random && random < end)
+                return item;
+            begin = end;
+        }
+        throw new Error(`Unable to select element with value ${random}`);
+    }
+    ;
+}
+//#endregion
+export { Random };
+//# sourceMappingURL=random.js.map