adaptive-extender 0.2.5

package/CHANGELOG.md

@@ -0,0 +1,2 @@
+## 0.2.5 (14.08.2025)
+*First stable version*

package/README.md

@@ -0,0 +1 @@
+## Adaptive extender

package/dist/core/array.d.ts

@@ -0,0 +1,42 @@
+import "./global.js";
+declare global {
+    interface ArrayConstructor {
+        /**
+         * Imports an array from a source.
+         * @param source The source to import from.
+         * @param name The name of the source.
+         * @returns The imported array.
+         * @throws {TypeError} If the source is not an array.
+         */
+        import(source: any, name?: string): any[];
+        /**
+         * Creates an array of integers between the specified minimum and maximum values (exclusive).
+         * @param min The minimum value of the range (inclusive).
+         * @param max The maximum value of the range (exclusive).
+         */
+        range(min: number, max: number): number[];
+        /**
+         * Combines elements from multiple iterables into tuples.
+         * Iteration stops when the shortest iterable is exhausted.
+         * @returns A generator yielding tuples.
+         */
+        zip<T extends unknown[]>(...iterables: {
+            [K in keyof T]: Iterable<T[K]>;
+        }): Generator<T, void>;
+    }
+    interface Array<T> {
+        /**
+         * Swaps the elements at the given indices in the array.
+         * @param index1 The index of the first element.
+         * @param index2 The index of the second element.
+         */
+        swap(index1: number, index2: number): void;
+        /**
+         * Resizes the array to a specified length, filling with a default value if extended.
+         * @param length The new length of the array.
+         * @param _default The value used to fill when the array grows.
+         */
+        resize(length: number, _default: T): T[];
+    }
+}
+export {};

package/dist/core/array.js

@@ -0,0 +1,40 @@
+"use strict";
+import "./global.js";
+const { trunc } = Math;
+Array.import = function (source, name = "[source]") {
+    if (!Array.isArray(source))
+        throw new TypeError(`Unable to import array from ${name} due its ${typename(source)} type`);
+    return source;
+};
+Array.range = function (min, max) {
+    min = trunc(min);
+    max = trunc(max);
+    const array = [];
+    for (let index = 0; index < max - min; index++) {
+        array.push(index + min);
+    }
+    return array;
+};
+Array.zip = function* (...iterables) {
+    const iterators = iterables.map(iterable => iterable[Symbol.iterator]());
+    while (true) {
+        const results = iterators.map(iterator => iterator.next());
+        if (results.some(result => result.done))
+            break;
+        yield results.map(result => result.value);
+    }
+};
+Array.prototype.swap = function (index1, index2) {
+    index1 = trunc(index1);
+    index2 = trunc(index2);
+    const temporary = this[index1];
+    this[index1] = this[index2];
+    this[index2] = temporary;
+};
+Array.prototype.resize = function (length, _default) {
+    while (length > this.length)
+        this.push(_default);
+    this.length = length;
+    return this;
+};
+//# sourceMappingURL=array.js.map

package/dist/core/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/core/array.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAErB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;AA0CvB,KAAK,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,OAAe,UAAU;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxH,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,KAAK,CAAC,KAAK,GAAG,UAAU,GAAW,EAAE,GAAW;IAC/C,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,EAAsB,GAAG,SAA6C;IAC1F,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM;QAC/C,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAM,CAAC;IAChD,CAAC;AACF,CAAC,CAAC;AAEF,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,UAAU,MAAc,EAAE,MAAc;IAC9D,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAC1B,CAAC,CAAC;AAEF,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,UAAwB,MAAc,EAAE,QAAW;IAC3E,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}

package/dist/core/boolean.d.ts

@@ -0,0 +1,14 @@
+import "./global.js";
+declare global {
+    interface BooleanConstructor {
+        /**
+         * Imports a boolean value from a source.
+         * @param source The source value to import.
+         * @param name The name of the source value.
+         * @returns The imported boolean value.
+         * @throws {TypeError} If the source is not a boolean.
+         */
+        import(source: any, name?: string): boolean;
+    }
+}
+export {};

package/dist/core/boolean.js

@@ -0,0 +1,8 @@
+"use strict";
+import "./global.js";
+Boolean.import = function (source, name = "[source]") {
+    if (typeof (source) !== "boolean")
+        throw new TypeError(`Unable to import boolean from ${name} due its ${typename(source)} type`);
+    return source.valueOf();
+};
+//# sourceMappingURL=boolean.js.map

package/dist/core/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../src/core/boolean.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAerB,OAAO,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,OAAe,UAAU;IAChE,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjI,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC"}

package/dist/core/color.d.ts

@@ -0,0 +1,369 @@
+import "./number.js";
+import "./string.js";
+/**
+ * Represents available color formats.
+ */
+declare enum ColorFormats {
+    rgb = "RGB",
+    hsl = "HSL",
+    hex = "HEX"
+}
+interface ColorProperties {
+    /**
+     * Indicates whether the alpha channel is included.
+     */
+    deep: boolean;
+    /**
+     * The output format of the color.
+     */
+    format: ColorFormats;
+}
+/**
+ * Represents a color in RGB, HSL, or HEX format with support for alpha channel,
+ * conversion between formats, creation from components, and parsing from strings.
+ */
+declare class Color {
+    #private;
+    /**
+     * Gets the red color component.
+     */
+    get red(): number;
+    /**
+     * Sets the red color component.
+     */
+    set red(value: number);
+    /**
+     * Gets the green color component.
+     */
+    get green(): number;
+    /**
+     * Sets the green color component.
+     */
+    set green(value: number);
+    /**
+     * Gets the blue color component.
+     */
+    get blue(): number;
+    /**
+     * Sets the blue color component.
+     */
+    set blue(value: number);
+    /**
+     * Gets the hue color component.
+     */
+    get hue(): number;
+    /**
+     * Sets the hue color component.
+     */
+    set hue(value: number);
+    /**
+     * Gets the saturation color component.
+     */
+    get saturation(): number;
+    /**
+     * Sets the saturation color component.
+     */
+    set saturation(value: number);
+    /**
+     * Gets the lightness color component.
+     */
+    get lightness(): number;
+    /**
+     * Sets the lightness color component.
+     */
+    set lightness(value: number);
+    /**
+     * Gets the alpha color component.
+     */
+    get alpha(): number;
+    /**
+     * Sets the alpha color component.
+     */
+    set alpha(value: number);
+    /**
+     * Creates a new black color.
+     */
+    constructor();
+    /**
+     * Copies values from another color.
+     * @param source The source color to copy from.
+     */
+    constructor(source: Readonly<Color>);
+    /**
+     * Creates a color from RGB components.
+     * @throws {Error} If any component is not a finite number.
+     */
+    static fromRGB(red: number, green: number, blue: number): Color;
+    /**
+     * Creates a color from RGB components with alpha channel.
+     * @throws {Error} If any component is not a finite number.
+     */
+    static fromRGB(red: number, green: number, blue: number, alpha: number): Color;
+    /**
+     * Creates a color from HSL components.
+     * @param hue The hue component.
+     * @param saturation The saturation component.
+     * @param lightness The lightness component.
+     * @returns A new color instance.
+     * @throws {Error} If any component is not a finite number.
+     */
+    static fromHSL(hue: number, saturation: number, lightness: number): Color;
+    /**
+     * Creates a color from HSL components with alpha channel.
+     * @param hue The hue component.
+     * @param saturation The saturation component.
+     * @param lightness The lightness component.
+     * @param alpha The alpha channel value.
+     * @returns A new color instance.
+     * @throws {Error} If any component is not a finite number.
+     */
+    static fromHSL(hue: number, saturation: number, lightness: number, alpha: number): Color;
+    /**
+     * Attempts to create a color from a string using all color variations.
+     * @param string The string to parse.
+     * @returns The parsed color or null if parsing fails.
+     */
+    static tryParse(string: string): Color | null;
+    /**
+     * Attempts to create a color from a string using the specified variations.
+     * @param string The string to parse.
+     * @param options The options for variations.
+     * @returns The parsed color or null if parsing fails.
+     */
+    static tryParse(string: string, options: Partial<ColorProperties>): Color | null;
+    /**
+     * Parses a color from a string using all color variations.
+     * @param string The string to parse.
+     * @returns The parsed color.
+     * @throws {SyntaxError} If parsing fails for all color variations.
+     */
+    static parse(string: string): Color;
+    /**
+     * Parses a color from a string using the specified variations.
+     * @param string The string to parse.
+     * @param options The options for variations.
+     * @returns The parsed color.
+     * @throws {SyntaxError} If parsing fails for the specified variations.
+     */
+    static parse(string: string, options: Partial<ColorProperties>): Color;
+    /**
+     * Returns a string representation of the color in RGB format by default.
+     * @returns The string representation of the color.
+     */
+    toString(): string;
+    /**
+     * Returns a string representation of the color using the specified options.
+     * @param options The options to define the output format and alpha channel inclusion.
+     * @returns The string representation of the color.
+     * @throws {Error} If the specified color format is invalid.
+     */
+    toString(options: Partial<ColorProperties>): string;
+    /**
+     * Transparent color preset.
+     * @readonly
+     */
+    static get newTransparent(): Color;
+    /**
+     * Maroon color preset.
+     * @readonly
+     */
+    static get newMaroon(): Color;
+    /**
+     * Red color preset.
+     * @readonly
+     */
+    static get newRed(): Color;
+    /**
+     * Orange color preset.
+     * @readonly
+     */
+    static get newOrange(): Color;
+    /**
+     * Yellow color preset.
+     * @readonly
+     */
+    static get newYellow(): Color;
+    /**
+     * Olive color preset.
+     * @readonly
+     */
+    static get newOlive(): Color;
+    /**
+     * Green color preset.
+     * @readonly
+     */
+    static get newGreen(): Color;
+    /**
+     * Purple color preset.
+     * @readonly
+     */
+    static get newPurple(): Color;
+    /**
+     * Fuchsia color preset.
+     * @readonly
+     */
+    static get newFuchsia(): Color;
+    /**
+     * Lime color preset.
+     * @readonly
+     */
+    static get newLime(): Color;
+    /**
+     * Teal color preset.
+     * @readonly
+     */
+    static get newTeal(): Color;
+    /**
+     * Aqua color preset.
+     * @readonly
+     */
+    static get newAqua(): Color;
+    /**
+     * Blue color preset.
+     * @readonly
+     */
+    static get newBlue(): Color;
+    /**
+     * Navy color preset.
+     * @readonly
+     */
+    static get newNavy(): Color;
+    /**
+     * Black color preset.
+     * @readonly
+     */
+    static get newBlack(): Color;
+    /**
+     * Gray color preset.
+     * @readonly
+     */
+    static get newGray(): Color;
+    /**
+     * Silver color preset.
+     * @readonly
+     */
+    static get newSilver(): Color;
+    /**
+     * White color preset.
+     * @readonly
+     */
+    static get newWhite(): Color;
+    /**
+     * Creates a new color by mixing two colors evenly.
+     * @param first The first color.
+     * @param second The second color.
+     * @returns The new mixed color.
+     */
+    static mix(first: Readonly<Color>, second: Readonly<Color>): Color;
+    /**
+     * Creates a new color by mixing two colors by the given ratio.
+     * @param first The first color.
+     * @param second The second color.
+     * @param ratio Ratio between the first and second color [0 - 1].
+     * @returns The new mixed color.
+     * @throws {Error} If `ratio` is not a finite number.
+     */
+    static mix(first: Readonly<Color>, second: Readonly<Color>, ratio: number): Color;
+    /**
+     * Converts the current color to grayscale with full scale.
+     * @returns The modified current color.
+     */
+    grayscale(): Color;
+    /**
+     * Converts the current color to grayscale by the given scale.
+     * @param scale Grayscale scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    grayscale(scale: number): Color;
+    /**
+     * Emphasizes the red channel fully on the current color.
+     * @returns The modified current color.
+     */
+    redEmphasis(): Color;
+    /**
+     * Emphasizes the red channel by the given scale on the current color.
+     * @param scale Emphasis scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    redEmphasis(scale: number): Color;
+    /**
+     * Emphasizes the green channel fully on the current color.
+     * @returns The modified current color.
+     */
+    greenEmphasis(): Color;
+    /**
+     * Emphasizes the green channel by the given scale on the current color.
+     * @param scale Emphasis scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    greenEmphasis(scale: number): Color;
+    /**
+     * Emphasizes the blue channel fully on the current color.
+     * @returns The modified current color.
+     */
+    blueEmphasis(): Color;
+    /**
+     * Emphasizes the blue channel by the given scale on the current color.
+     * @param scale Emphasis scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    blueEmphasis(scale: number): Color;
+    /**
+     * Inverts the current color fully.
+     * @returns The modified current color.
+     */
+    invert(): Color;
+    /**
+     * Inverts the current color by the given scale.
+     * @param scale Inversion scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    invert(scale: number): Color;
+    /**
+     * Applies full sepia filter on the current color.
+     * @returns The modified current color.
+     */
+    sepia(): Color;
+    /**
+     * Applies sepia filter by the given scale on the current color.
+     * @param scale Sepia scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    sepia(scale: number): Color;
+    /**
+     * Rotates the hue of the current color by the given angle in degrees.
+     * @param angle Rotation angle in degrees.
+     * @returns The modified current color.
+     * @throws {Error} If `angle` is not a finite number.
+     */
+    rotate(angle: number): Color;
+    /**
+     * Sets the saturation of the current color by scale.
+     * @param scale Saturation scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    saturate(scale: number): Color;
+    /**
+     * Sets the lightness of the current color by scale.
+     * @param scale Lightness scale [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    illuminate(scale: number): Color;
+    /**
+     * Sets the alpha of the current color.
+     * @param scale Alpha value [0 - 1].
+     * @returns The modified current color.
+     * @throws {Error} If `scale` is not a finite number.
+     */
+    pass(scale: number): Color;
+}
+export { ColorProperties };
+export { ColorFormats, Color };