nhb-toolbox 4.0.76 → 4.0.88

package/dist/cjs/array/Finder.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Finder = void 0;
+/**
+ * The `Finder` class performs optimized searching on arrays.
+ * It supports binary search, fuzzy search, and smart caching with TTL.
+ */
+class Finder {
+    static DEFAULT_TTL = 1000 * 60 * 5;
+    #cache = new Map();
+    #sortedCache = new Map();
+    #ttl;
+    #items;
+    /**
+     * * Creates a new `Finder` instance.
+     *
+     * @param ttl Time-to-live (in milliseconds) for cached search results. Defaults to {@link Finder.DEFAULT_TTL 5 Minutes}.
+     * @param items The initial array of items to be used for searching.
+     */
+    constructor(ttl = Finder.DEFAULT_TTL, items) {
+        this.#ttl = ttl;
+        this.#items = items;
+    }
+    /**
+     * @instance Clears cache globally or for a specific key.
+     * @param key Optional key to clear only a specific cache entry.
+     */
+    clearCache(key) {
+        if (key) {
+            this.#cache.delete(key);
+        }
+        else {
+            this.#cache.clear();
+        }
+    }
+    /**
+     * @instance Finds all items that match the provided matcher using optional caching or fuzzy logic.
+     * @param matcher The value to match against.
+     * @param keySelector Property key or selector function.
+     * @param options Optional settings for search behavior and source list.
+     */
+    findAll(matcher, keySelector, options) {
+        const { fuzzy = false, needSorting = true, cacheKey = 'finder-cache', forceBinary = false, caseInsensitive = true, data, } = options ?? {};
+        const source = typeof data === 'function' ? data() : (data ?? this.#items);
+        if (!source?.length)
+            return [];
+        const rawGetKey = typeof keySelector === 'function' ? keySelector : ((item) => item[keySelector]);
+        const getKey = Finder.#createMemoizedKeyGetter(rawGetKey);
+        const normalizedMatcher = caseInsensitive && typeof matcher === 'string' ?
+            matcher.toLowerCase()
+            : matcher;
+        if (cacheKey) {
+            const entry = this.#cache.get(cacheKey);
+            if (entry && Date.now() - entry.timestamp < this.#ttl) {
+                return entry.result;
+            }
+            else {
+                this.#cache.delete(cacheKey);
+            }
+        }
+        let results = [];
+        if (source.length < 100 && !forceBinary) {
+            results = source.filter((item) => {
+                const key = getKey(item);
+                const value = caseInsensitive && typeof key === 'string' ?
+                    key.toLowerCase()
+                    : key;
+                return value === normalizedMatcher;
+            });
+        }
+        else {
+            const sorted = needSorting ?
+                this.#sortAndCache(source, getKey, cacheKey)
+                : source;
+            const firstMatch = this.binarySearch(sorted, normalizedMatcher, getKey, caseInsensitive);
+            if (firstMatch) {
+                const baseKey = getKey(firstMatch);
+                const base = caseInsensitive && typeof baseKey === 'string' ?
+                    baseKey.toLowerCase()
+                    : baseKey;
+                results = sorted.filter((item) => {
+                    const key = getKey(item);
+                    const value = caseInsensitive && typeof key === 'string' ?
+                        key.toLowerCase()
+                        : key;
+                    return value === base;
+                });
+            }
+        }
+        if (!results.length && fuzzy && typeof normalizedMatcher === 'string') {
+            results = source.filter((item) => {
+                const rawKey = getKey(item);
+                const key = caseInsensitive && typeof rawKey === 'string' ?
+                    rawKey.toLowerCase()
+                    : String(rawKey);
+                return this.#match(key, normalizedMatcher);
+            });
+        }
+        if (cacheKey) {
+            this.#cache.set(cacheKey, {
+                result: results,
+                timestamp: Date.now(),
+            });
+        }
+        return results;
+    }
+    /**
+     * @instance Finds first matching item that matches the provided matcher using optional caching or fuzzy logic.
+     * @param matcher The value to match.
+     * @param keySelector Property key or selector function.
+     * @param options Optional behavior flags and item source.
+     */
+    findOne(matcher, keySelector, options) {
+        const { fuzzy = false, needSorting = true, cacheKey = 'finder-cache', forceBinary = false, caseInsensitive = true, data, } = options ?? {};
+        const source = typeof data === 'function' ? data() : (data ?? this.#items);
+        if (!source?.length)
+            return undefined;
+        const rawGetKey = typeof keySelector === 'function' ? keySelector : ((item) => item[keySelector]);
+        const getKey = Finder.#createMemoizedKeyGetter(rawGetKey);
+        const normalizedMatcher = caseInsensitive && typeof matcher === 'string' ?
+            matcher.toLowerCase()
+            : matcher;
+        if (cacheKey) {
+            const entry = this.#cache.get(cacheKey);
+            if (entry && Date.now() - entry.timestamp < this.#ttl) {
+                return entry.result[0];
+            }
+            else {
+                this.#cache.delete(cacheKey);
+            }
+        }
+        let result;
+        if (source.length < 100 && !forceBinary) {
+            result = source.find((item) => {
+                const key = getKey(item);
+                const value = caseInsensitive && typeof key === 'string' ?
+                    key.toLowerCase()
+                    : key;
+                return value === normalizedMatcher;
+            });
+        }
+        else {
+            result = this.binarySearch(needSorting ?
+                this.#sortAndCache(source, getKey, cacheKey)
+                : source, normalizedMatcher, getKey, caseInsensitive);
+        }
+        if (!result && fuzzy && typeof normalizedMatcher === 'string') {
+            return this.fuzzySearch(source, normalizedMatcher, getKey, caseInsensitive);
+        }
+        if (cacheKey && result) {
+            this.#cache.set(cacheKey, {
+                result: [result],
+                timestamp: Date.now(),
+            });
+        }
+        return result;
+    }
+    /**
+     * @instance Asynchronous variant of `findAll` that accepts a promise-based data supplier.
+     * @param supplier Async function resolving the items list.
+     * @param matcher The value to match.
+     * @param keySelector Property key or selector function.
+     * @param options Optional settings for search behavior and cache.
+     */
+    async findAllAsync(supplier, matcher, keySelector, options) {
+        const items = await supplier();
+        return this.findAll(matcher, keySelector, { ...options, data: items });
+    }
+    /**
+     * @instance Asynchronous variant of `findOne`.
+     * @param supplier Async function resolving the items list.
+     * @param matcher The value to match.
+     * @param keySelector Property key or selector function.
+     * @param options Optional settings for behavior and cache.
+     */
+    async findOneAsync(supplier, matcher, keySelector, options) {
+        const items = await supplier();
+        return this.findOne(matcher, keySelector, { ...options, data: items });
+    }
+    /**
+     * @instance Performs a binary search on a sorted array using a custom key selector.
+     *
+     * @param sorted - The sorted array of items to search.
+     * @param matcher - The value to search for.
+     * @param keySelector - A function that extracts the comparable key from each item.
+     * @param caseInsensitive - Whether to compare string keys ignoring case.
+     * @returns The first matching item if found; otherwise, undefined.
+     */
+    binarySearch(sorted, matcher, keySelector, caseInsensitive) {
+        let min = 0, max = sorted.length - 1;
+        while (min <= max) {
+            const mid = Math.floor((min + max) / 2);
+            const midKey = keySelector(sorted[mid]);
+            const key = caseInsensitive && typeof midKey === 'string' ?
+                midKey.toLowerCase()
+                : midKey;
+            if (key === matcher)
+                return sorted[mid];
+            if (key < matcher)
+                min = mid + 1;
+            else
+                max = mid - 1;
+        }
+        return undefined;
+    }
+    /**
+     * @instance Performs a fuzzy search on an array by matching characters in sequence.
+     *
+     * @param array - The array of items to search.
+     * @param matcher - The fuzzy search string to match against.
+     * @param keySelector - A function that extracts the key to search from each item.
+     * @param caseInsensitive - Whether to compare ignoring case for string values.
+     * @returns The first fuzzy-matching item if found; otherwise, undefined.
+     */
+    fuzzySearch(array, matcher, keySelector, caseInsensitive) {
+        for (const item of array) {
+            const rawKey = keySelector(item);
+            const key = caseInsensitive && typeof rawKey === 'string' ?
+                rawKey.toLowerCase()
+                : String(rawKey);
+            if (this.#match(key, matcher))
+                return item;
+        }
+        return undefined;
+    }
+    /**
+     * @private Checks if the characters in the target string appear in order within the source string.
+     * @param source Source string to search within.
+     * @param target Target string to match against the source string.
+     * @returns True if the target string is a fuzzy match within the source string; otherwise, false.
+     */
+    #match(source, target) {
+        let i = 0;
+        for (const char of target) {
+            i = source.indexOf(char, i);
+            if (i === -1)
+                return false;
+            i++;
+        }
+        return true;
+    }
+    /**
+     * @private Sorts an array and caches the result for a specified time-to-live (TTL).
+     * @param data Data to sort and cache.
+     * @param getKey Key extraction function.
+     * @param cacheKey Optional cache key for storing the result.
+     * @returns
+     */
+    #sortAndCache(data, getKey, cacheKey) {
+        if (cacheKey) {
+            const entry = this.#sortedCache.get(cacheKey);
+            if (entry && Date.now() - entry.timestamp < this.#ttl) {
+                return entry.result;
+            }
+            else {
+                this.#sortedCache.delete(cacheKey);
+            }
+        }
+        const sorted = [...data].sort((a, b) => {
+            const keyA = getKey(a);
+            const keyB = getKey(b);
+            return (keyA < keyB ? -1
+                : keyA > keyB ? 1
+                    : 0);
+        });
+        if (cacheKey) {
+            this.#sortedCache.set(cacheKey, {
+                result: sorted,
+                timestamp: Date.now(),
+            });
+        }
+        return sorted;
+    }
+    /**
+     * @static @private Creates a memoized version of a key extractor.
+     * @param getKey Original key extraction function
+     */
+    static #createMemoizedKeyGetter(getKey) {
+        const cache = new Map();
+        return (item) => {
+            if (cache.has(item))
+                return cache.get(item);
+            const key = getKey(item);
+            cache.set(item, key);
+            return key;
+        };
+    }
+}
+exports.Finder = Finder;

package/dist/cjs/colors/Color.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Color = void 0;
 const convert_1 = require("./convert");
+const css_colors_1 = require("./css-colors");
 const helpers_1 = require("./helpers");
 const random_1 = require("./random");
 const hsl = (0, random_1.generateRandomHSLColor)();
@@ -9,7 +10,7 @@ const { hex, rgb } = (0, convert_1.convertColorCode)(hsl);
 /**
  * * Class representing a color and its conversions among `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` and `HSLA` formats.
  * * It has 13 instance methods to manipulate and play with the color values.
- * * It has 6 static methods that can be used to check if a color is in `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` format.
+ * * It has 7 static methods that can be used to check if a color is in `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` format.
  *
  * @property hex - The color in `Hex` format.
  * @property hex8 - The color in `Hex8` format.
@@ -44,7 +45,7 @@ class Color {
      * - It has 13 instance methods to manipulate and play with the color values.
      * - Use static methods like `Color.isHex6(color)` to validate color strings.
      *
-     * @param toConvert - An optional input color string in any supported format (`Hex`, `Hex8`, `RGB`, `RGBA`, `HSL`, or `HSLA`) to convert in all other (includes the current format) formats.
+     * @param color - An optional input color string in any supported format (`Hex`, `Hex8`, `RGB`, `RGBA`, `HSL`, or `HSLA`) to convert in all other (includes the current format) formats.
      *
      * @example
      * // Convert an existing Hex color to all other formats
@@ -68,31 +69,42 @@ class Color {
      *
      * @returns Instance of `Color`.
      */
-    constructor(toConvert) {
-        if (toConvert) {
-            const colors = this.#convertColorToOthers(toConvert);
-            if ('hex8' in colors) {
-                // Extract alpha color values (Hex8, RGBA, HSLA)
-                const rgbaValues = (0, helpers_1._extractAlphaColorValues)(colors.rgba);
-                const hslaValues = (0, helpers_1._extractAlphaColorValues)(colors.hsla);
-                this.hex = colors.hex8.toUpperCase().slice(0, 7);
-                this.hex8 = colors.hex8.toUpperCase();
-                this.rgb = `rgb(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`;
-                this.rgba = colors.rgba;
-                this.hsl = `hsl(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`;
-                this.hsla = colors.hsla;
+    constructor(color) {
+        if (color) {
+            if (Color.isCSSColor(color)) {
+                const newColor = new Color(css_colors_1.CSS_COLORS[color]);
+                this.hex = newColor.hex;
+                this.hex8 = newColor.hex8;
+                this.rgb = newColor.rgb;
+                this.rgba = newColor.rgba;
+                this.hsl = newColor.hsl;
+                this.hsla = newColor.hsla;
             }
             else {
-                // Extract solid color values (Hex, RGB, HSL)
-                const rgbValues = (0, helpers_1._extractSolidColorValues)(colors.rgb);
-                const hslValues = (0, helpers_1._extractSolidColorValues)(colors.hsl);
-                this.hex = colors.hex.toUpperCase();
-                this.hex8 =
-                    `${colors.hex.toUpperCase()}${(0, helpers_1._convertOpacityToHex)(100)}`;
-                this.rgb = colors.rgb;
-                this.rgba = `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, 1)`;
-                this.hsl = colors.hsl;
-                this.hsla = `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, 1)`;
+                const colors = this.#convertColorToOthers(color);
+                if ('hex8' in colors) {
+                    // Extract alpha color values (Hex8, RGBA, HSLA)
+                    const rgbaValues = (0, helpers_1._extractAlphaColorValues)(colors.rgba);
+                    const hslaValues = (0, helpers_1._extractAlphaColorValues)(colors.hsla);
+                    this.hex = colors.hex8.toUpperCase().slice(0, 7);
+                    this.hex8 = colors.hex8.toUpperCase();
+                    this.rgb = `rgb(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`;
+                    this.rgba = colors.rgba;
+                    this.hsl = `hsl(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`;
+                    this.hsla = colors.hsla;
+                }
+                else {
+                    // Extract solid color values (Hex, RGB, HSL)
+                    const rgbValues = (0, helpers_1._extractSolidColorValues)(colors.rgb);
+                    const hslValues = (0, helpers_1._extractSolidColorValues)(colors.hsl);
+                    this.hex = colors.hex.toUpperCase();
+                    this.hex8 =
+                        `${colors.hex.toUpperCase()}${(0, helpers_1._convertOpacityToHex)(100)}`;
+                    this.rgb = colors.rgb;
+                    this.rgba = `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, 1)`;
+                    this.hsl = colors.hsl;
+                    this.hsla = `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, 1)`;
+                }
             }
         }
         else {
@@ -370,6 +382,23 @@ class Color {
     static isHSLA(color) {
         return (0, helpers_1._isHSLA)(color);
     }
+    /**
+     * @static Checks if a color is a valid CSS color name.
+     * - This method checks against a predefined list of CSS color names.
+     * - It does not validate format types like Hex, RGB, or HSL or their alpha channels.
+     *
+     * @param color - The color to check.
+     * @returns `true` if the color is a valid CSS color name, `false` otherwise.
+     */
+    static isCSSColor(color) {
+        return (!Color.isHex6(color) &&
+            !Color.isHex8(color) &&
+            !(0, helpers_1._isRGB)(color) &&
+            !(0, helpers_1._isRGBA)(color) &&
+            !(0, helpers_1._isHSL)(color) &&
+            !(0, helpers_1._isHSLA)(color) &&
+            color in css_colors_1.CSS_COLORS);
+    }
     /**
      * @private Converts the given color to all other formats while preserving the original.
      *

package/dist/cjs/colors/css-colors.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSS_COLORS = void 0;
+exports.CSS_COLORS = {
+    black: '#000000',
+    silver: '#C0C0C0',
+    gray: '#808080',
+    white: '#FFFFFF',
+    maroon: '#800000',
+    red: '#FF0000',
+    purple: '#800080',
+    fuchsia: '#FF00FF',
+    green: '#008000',
+    lime: '#00FF00',
+    olive: '#808000',
+    yellow: '#FFFF00',
+    navy: '#000080',
+    blue: '#0000FF',
+    teal: '#008080',
+    aqua: '#00FFFF',
+    aliceblue: '#F0F8FF',
+    antiquewhite: '#FAEBD7',
+    aquamarine: '#7FFFD4',
+    azure: '#F0FFFF',
+    beige: '#F5F5DC',
+    bisque: '#FFE4C4',
+    blanchedalmond: '#FFEBCD',
+    blueviolet: '#8A2BE2',
+    brown: '#A52A2A',
+    burlywood: '#DEB887',
+    cadetblue: '#5F9EA0',
+    chartreuse: '#7FFF00',
+    chocolate: '#D2691E',
+    coral: '#FF7F50',
+    cornflowerblue: '#6495ED',
+    cornsilk: '#FFF8DC',
+    crimson: '#DC143C',
+    cyan: '#00FFFF',
+    darkblue: '#00008B',
+    darkcyan: '#008B8B',
+    darkgoldenrod: '#B8860B',
+    darkgray: '#A9A9A9',
+    darkgreen: '#006400',
+    darkgrey: '#A9A9A9',
+    darkkhaki: '#BDB76B',
+    darkmagenta: '#8B008B',
+    darkolivegreen: '#556B2F',
+    darkorange: '#FF8C00',
+    darkorchid: '#9932CC',
+    darkred: '#8B0000',
+    darksalmon: '#E9967A',
+    darkseagreen: '#8FBC8F',
+    darkslateblue: '#483D8B',
+    darkslategray: '#2F4F4F',
+    darkslategrey: '#2F4F4F',
+    darkturquoise: '#00CED1',
+    darkviolet: '#9400D3',
+    deeppink: '#FF1493',
+    deepskyblue: '#00BFFF',
+    dimgray: '#696969',
+    dimgrey: '#696969',
+    dodgerblue: '#1E90FF',
+    firebrick: '#B22222',
+    floralwhite: '#FFFAF0',
+    forestgreen: '#228B22',
+    gainsboro: '#DCDCDC',
+    ghostwhite: '#F8F8FF',
+    gold: '#FFD700',
+    goldenrod: '#DAA520',
+    greenyellow: '#ADFF2F',
+    grey: '#808080',
+    honeydew: '#F0FFF0',
+    hotpink: '#FF69B4',
+    indianred: '#CD5C5C',
+    indigo: '#4B0082',
+    ivory: '#FFFFF0',
+    khaki: '#F0E68C',
+    lavender: '#E6E6FA',
+    lavenderblush: '#FFF0F5',
+    lawngreen: '#7CFC00',
+    lemonchiffon: '#FFFACD',
+    lightblue: '#ADD8E6',
+    lightcoral: '#F08080',
+    lightcyan: '#E0FFFF',
+    lightgoldenrodyellow: '#FAFAD2',
+    lightgray: '#D3D3D3',
+    lightgreen: '#90EE90',
+    lightgrey: '#D3D3D3',
+    lightpink: '#FFB6C1',
+    lightsalmon: '#FFA07A',
+    lightseagreen: '#20B2AA',
+    lightskyblue: '#87CEFA',
+    lightslategray: '#778899',
+    lightslategrey: '#778899',
+    lightsteelblue: '#B0C4DE',
+    lightyellow: '#FFFFE0',
+    limegreen: '#32CD32',
+    linen: '#FAF0E6',
+    magenta: '#FF00FF',
+    mediumaquamarine: '#66CDAA',
+    mediumblue: '#0000CD',
+    mediumorchid: '#BA55D3',
+    mediumpurple: '#9370DB',
+    mediumseagreen: '#3CB371',
+    mediumslateblue: '#7B68EE',
+    mediumspringgreen: '#00FA9A',
+    mediumturquoise: '#48D1CC',
+    mediumvioletred: '#C71585',
+    midnightblue: '#191970',
+    mintcream: '#F5FFFA',
+    mistyrose: '#FFE4E1',
+    moccasin: '#FFE4B5',
+    navajowhite: '#FFDEAD',
+    oldlace: '#FDF5E6',
+    olivedrab: '#6B8E23',
+    orange: '#FFA500',
+    orangered: '#FF4500',
+    orchid: '#DA70D6',
+    palegoldenrod: '#EEE8AA',
+    palegreen: '#98FB98',
+    paleturquoise: '#AFEEEE',
+    palevioletred: '#DB7093',
+    papayawhip: '#FFEFD5',
+    peachpuff: '#FFDAB9',
+    peru: '#CD853F',
+    pink: '#FFC0CB',
+    plum: '#DDA0DD',
+    powderblue: '#B0E0E6',
+    rebeccapurple: '#663399',
+    rosybrown: '#BC8F8F',
+    royalblue: '#4169E1',
+    saddlebrown: '#8B4513',
+    salmon: '#FA8072',
+    sandybrown: '#F4A460',
+    seagreen: '#2E8B57',
+    seashell: '#FFF5EE',
+    sienna: '#A0522D',
+    skyblue: '#87CEEB',
+    slateblue: '#6A5ACD',
+    slategray: '#708090',
+    slategrey: '#708090',
+    snow: '#FFFAFA',
+    springgreen: '#00FF7F',
+    steelblue: '#4682B4',
+    tan: '#D2B48C',
+    thistle: '#D8BFD8',
+    tomato: '#FF6347',
+    transparent: '#00000000',
+    turquoise: '#40E0D0',
+    violet: '#EE82EE',
+    wheat: '#F5DEB3',
+    whitesmoke: '#F5F5F5',
+    yellowgreen: '#9ACD32',
+    grape: '#CC5DE8',
+    dark: '#3B3B3B',
+    volcano: '#FA541C',
+    geekblue: '#2F54EB',
+    success: '#4CAF50',
+    info: '#2196F3',
+    warning: '#FF9800',
+    error: '#F44336',
+};

package/dist/cjs/index.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getAverageOfNumbers = exports.getAverage = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateAverage = exports.wordCount = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.roundNumber = exports.numberToOrdinal = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.numberToWords = exports.numericToRoman = exports.convertToRomanNumerals = exports.convertNumberToWords = exports.isPerfectSquare = exports.isParOfFibonacciSeries = exports.isParOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isMultiple = exports.isInvalidNumbers = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = void 0;
-exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getMinutesFromUTC = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.greet = exports.getGreeting = exports.generateGreeting = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = void 0;
-exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedValues = exports.parseStringifiedPrimitives = exports.parseStringifiedObjectValues = exports.parsePrimitives = exports.parsePrimitiveData = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = void 0;
-exports.isDate = exports.isBigInt = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.getQueryStringAsObject = exports.queryStringToObject = exports.parseQueryString = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = void 0;
+exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getMinutesFromUTC = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.greet = exports.getGreeting = exports.generateGreeting = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = void 0;
+exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedValues = exports.parseStringifiedPrimitives = exports.parseStringifiedObjectValues = exports.parsePrimitives = exports.parsePrimitiveData = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = void 0;
+exports.isBigInt = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.getQueryStringAsObject = exports.queryStringToObject = exports.parseQueryString = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.remapObjectFields = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = void 0;
 // ! String Utilities
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
@@ -182,6 +182,8 @@ Object.defineProperty(exports, "getLastArrayElement", { enumerable: true, get: f
 Object.defineProperty(exports, "isInvalidOrEmptyArray", { enumerable: true, get: function () { return basics_3.isInvalidOrEmptyArray; } });
 Object.defineProperty(exports, "isValidEmptyArray", { enumerable: true, get: function () { return basics_3.isInvalidOrEmptyArray; } });
 Object.defineProperty(exports, "shuffleArray", { enumerable: true, get: function () { return basics_3.shuffleArray; } });
+var Finder_1 = require("./array/Finder");
+Object.defineProperty(exports, "Finder", { enumerable: true, get: function () { return Finder_1.Finder; } });
 var sort_1 = require("./array/sort");
 Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return sort_1.sortAnArray; } });
 var transform_1 = require("./array/transform");