nhb-toolbox 4.0.32 → 4.0.40

package/dist/cjs/array/transform.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOptionsArray = void 0;
 exports.removeDuplicatesFromArray = removeDuplicatesFromArray;
+exports.getDuplicates = getDuplicates;
+exports.findMissingElements = findMissingElements;
 exports.splitArray = splitArray;
 exports.rotateArray = rotateArray;
 exports.moveArrayElement = moveArrayElement;
@@ -35,6 +37,48 @@ exports.createOptionsArray = createOptionsArray;
 function removeDuplicatesFromArray(array) {
     return array.filter((item, index, self) => index === self.findIndex((el) => (0, utils_1.isDeepEqual)(el, item)));
 }
+/**
+ * * Finds duplicate values in an array, runs deep comparison for objects and arrays.
+ *
+ * @param array - The array in which to find duplicates.
+ * @returns An array containing all duplicate entries (each one only once).
+ */
+function getDuplicates(array) {
+    const seen = [];
+    const duplicates = [];
+    for (const item of array) {
+        const hasSeen = seen.find((el) => (0, utils_1.isDeepEqual)(el, item));
+        const hasDuplicate = duplicates.find((el) => (0, utils_1.isDeepEqual)(el, item));
+        if (hasSeen && !hasDuplicate) {
+            duplicates.push(item);
+        }
+        else if (!hasSeen) {
+            seen.push(item);
+        }
+    }
+    return duplicates;
+}
+/**
+ * * Finds elements missing from one array compared to another using deep comparison.
+ *
+ * @param options - Configuration to specify which array to compare and direction of check.
+ * @returns An array of missing elements based on the comparison direction.
+ */
+/**
+ * * Finds elements missing from one array compared to another using deep comparison.
+ *
+ * @param array1 The first array to compare.
+ * @param array2 The second array to compare.
+ * @param missingFrom Which direction to compare for missing values:.
+ *					  - `'from-first'` → values in `array1` missing in `array2`.
+ *					  - `'from-second'` → values in `array2` missing in `array1`.
+ * @returns An array of missing elements based on the comparison direction.
+ */
+function findMissingElements(array1, array2, missingFrom) {
+    const source = missingFrom === 'from-first' ? array1 : array2;
+    const target = missingFrom === 'from-first' ? array2 : array1;
+    return source.filter((item) => !target.some((t) => (0, utils_1.isDeepEqual)(t, item)));
+}
 /**
  * * Splits an array into chunks of a given size.
  *

package/dist/cjs/colors/Color.js

@@ -8,7 +8,7 @@ const hsl = (0, random_1.generateRandomHSLColor)();
 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 1 instance method `applyOpacity()` to apply opacity to `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` color.
+ * * 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.
  *
  * @property hex - The color in `Hex` format.
@@ -41,7 +41,7 @@ class Color {
      * If no color is passed, a random color will be generated.
      *
      * Additionally:
-     * - Use `.applyOpacity(opacity)` to modify or add opacity to the 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.
@@ -118,12 +118,12 @@ class Color {
         yield this.hsla;
     }
     /**
-     * * Applies or modifies the opacity of a color.
-     * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity
-     * - For alpha colors (Hex8/RGBA/HSLA): Updates the existing alpha channel
+     * @instance Applies or modifies the opacity of a color. Mutate the original instance.
+     * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity.
+     * - For alpha colors (Hex8/RGBA/HSLA): Updates the existing alpha channel.
      *
-     * @param opacity - A number between 0-100 representing the opacity percentage
-     * @returns An object containing all color formats with the applied opacity
+     * @param opacity - A number between 0-100 representing the opacity percentage.
+     * @returns A new instance of `Color` containing all color formats with the applied opacity.
      *
      * @example
      * const color = new Color("#ff0000");
@@ -141,14 +141,168 @@ class Color {
         const alphaDecimal = validOpacity / 100;
         const rgbValues = (0, helpers_1._extractSolidColorValues)(this.rgb);
         const hslValues = (0, helpers_1._extractSolidColorValues)(this.hsl);
-        return {
+        return Color.#fromParts({
             hex: this.hex.slice(0, 7).toUpperCase(),
             hex8: `${this.hex.slice(0, 7)}${alphaHex}`.toUpperCase(),
             rgb: `rgb(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]})`,
             rgba: `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, ${alphaDecimal})`,
             hsl: `hsl(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%)`,
             hsla: `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, ${alphaDecimal})`,
+        });
+    }
+    /**
+     * @instance Darkens the color by reducing the lightness by the given percentage.
+     * @param percent - The percentage to darken (0–100).
+     * @returns A new `Color` instance with the modified darkness.
+     */
+    applyDarkness(percent) {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const newL = Math.max(0, l - percent);
+        const newHSL = `hsl(${h}, ${s}%, ${newL}%)`;
+        return new Color(newHSL);
+    }
+    /**
+     * @instance Lightens the color by increasing the lightness by the given percentage.
+     * @param percent - The percentage to brighten (0–100).
+     * @returns A new `Color` instance with the modified lightness.
+     */
+    applyBrightness(percent) {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const newL = Math.min(100, l + percent);
+        const newHSL = `hsl(${h}, ${s}%, ${newL}%)`;
+        return new Color(newHSL);
+    }
+    /**
+     * @instance Reduces the saturation of the color to make it appear duller.
+     * @param percent - The percentage to reduce saturation (0–100).
+     * @returns A new `Color` instance with the modified saturation.
+     */
+    applyDullness(percent) {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const newS = Math.max(0, s - percent);
+        const newHSL = `hsl(${h}, ${newS}%, ${l}%)`;
+        return new Color(newHSL);
+    }
+    /**
+     * @instance Softens the color toward white by reducing saturation and increasing lightness based on a percentage.
+     * - *This creates a soft UI-like white shade effect (similar to some UI libraries' light color scale).*
+     * @param percent - Value from 0 to 100 representing how far to push the color toward white.
+     * @returns A new `Color` instance shifted toward white.
+     */
+    applyWhiteShade(percent) {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        // Cap values to avoid overshooting
+        const newS = Math.max(0, s - (s * percent) / 100);
+        const newL = Math.min(100, l + ((100 - l) * percent) / 100);
+        const newHSL = `hsl(${h}, ${newS}%, ${newL}%)`;
+        return new Color(newHSL);
+    }
+    /**
+     * @instance Blends the current color with another color based on the given weight.
+     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` to blend with.
+     * @param weight - A number from 0 to 1 indicating the weight of the other color. Defaults to `0.5`.
+     * 				 - `weight = 0` → only the original color (this)
+     *				 - `weight = 1` → only the other color
+     *				 - `weight = 0.5` → equal blend between the two
+     * @returns A new `Color` instance representing the blended result.
+     */
+    blendWith(other, weight = 0.5) {
+        const w = Math.max(0, Math.min(1, weight));
+        const converted = new Color(other);
+        const rgb1 = (0, helpers_1._extractSolidColorValues)(this.rgb);
+        const rgb2 = (0, helpers_1._extractSolidColorValues)(converted.rgb);
+        const blended = rgb1.map((c, i) => Math.round(c * (1 - w) + rgb2[i] * w));
+        const blendedRGB = `rgb(${blended[0]}, ${blended[1]}, ${blended[2]})`;
+        return new Color(blendedRGB);
+    }
+    /**
+     * @instance Calculates the contrast ratio between this color and another color (WCAG).
+     * @param other - The other color to compare against.
+     * @returns A number representing the contrast ratio (rounded to 2 decimal places).
+     */
+    contrastRatio(other) {
+        const newColor = new Color(other);
+        const luminance = (rgb) => {
+            const [r, g, b] = (0, helpers_1._extractSolidColorValues)(rgb).map((v) => {
+                const c = v / 255;
+                return c <= 0.03928 ?
+                    c / 12.92
+                    : Math.pow((c + 0.055) / 1.055, 2.4);
+            });
+            return 0.2126 * r + 0.7152 * g + 0.0722 * b;
         };
+        const lum1 = luminance(this.rgb);
+        const lum2 = luminance(newColor.rgb);
+        const brighter = Math.max(lum1, lum2);
+        const darker = Math.min(lum1, lum2);
+        const ratio = (brighter + 0.05) / (darker + 0.05);
+        return Math.round(ratio * 100) / 100;
+    }
+    /**
+     * @instance Returns the complementary color by rotating the hue 180 degrees.
+     * @returns A new Color that is the complement of the current color.
+     */
+    getComplementaryColor() {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const newHue = (h + 180) % 360;
+        const newHSL = `hsl(${newHue}, ${s}%, ${l}%)`;
+        return new Color(newHSL);
+    }
+    /**
+     * @instance Generates a color scheme of analogous colors, including the base color.
+     * Analogous colors are next to each other on the color wheel (±30°).
+     * @returns An array of three Color instances: [base, left, right].
+     */
+    getAnalogousColors() {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const left = `hsl(${(h + 330) % 360}, ${s}%, ${l}%)`;
+        const right = `hsl(${(h + 30) % 360}, ${s}%, ${l}%)`;
+        return [this, new Color(left), new Color(right)];
+    }
+    /**
+     * @instance Generates a color triad scheme including the base color.
+     * Triadic colors are evenly spaced (120° apart) on the color wheel.
+     * @returns An array of three Color instances: [base, triad1, triad2].
+     */
+    getTriadColors() {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const c1 = `hsl(${(h + 120) % 360}, ${s}%, ${l}%)`;
+        const c2 = `hsl(${(h + 240) % 360}, ${s}%, ${l}%)`;
+        return [this, new Color(c1), new Color(c2)];
+    }
+    /**
+     * @instance Generates a tetradic color scheme including the base color.
+     * Tetradic colors form a rectangle on the color wheel (90° apart).
+     * @returns An array of four Color instances: [base, tetrad1, tetrad2, tetrad3].
+     */
+    getTetradColors() {
+        const [h, s, l] = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        const c1 = `hsl(${(h + 90) % 360}, ${s}%, ${l}%)`;
+        const c2 = `hsl(${(h + 180) % 360}, ${s}%, ${l}%)`;
+        const c3 = `hsl(${(h + 270) % 360}, ${s}%, ${l}%)`;
+        return [this, new Color(c1), new Color(c2), new Color(c3)];
+    }
+    /**
+     * @instance Gets the `WCAG` accessibility rating between this and another color.
+     * @param other - The other color to test contrast against.
+     * @returns 'Fail', 'AA', or 'AAA' based on `WCAG 2.1` contrast standards.
+     */
+    getWCAGRating(other) {
+        const ratio = this.contrastRatio(other);
+        if (ratio >= 7)
+            return 'AAA';
+        if (ratio >= 4.5)
+            return 'AA';
+        return 'Fail';
+    }
+    /**
+     * @instance Determines if the color is light based on its perceived brightness.
+     * @returns `true` if light, `false` if dark.
+     */
+    isLightColor() {
+        const [r, g, b] = (0, helpers_1._extractSolidColorValues)(this.rgb);
+        const brightness = (r * 299 + g * 587 + b * 114) / 1000;
+        return brightness > 127.5;
     }
     /**
      * @static Checks if a color is in `Hex6` format.
@@ -169,40 +323,40 @@ class Color {
         return /^#[0-9A-Fa-f]{8}$/.test(color);
     }
     /**
-     * @static Checks if a color is in `RGB` format.
+     * @static Checks if a color is in `RGB` format and within valid ranges.
      *
      * @param color Color to check.
-     * @returns Boolean: `true` if it's an `RGB` color, `false` if not.
+     * @returns `true` if it's a `RGB` color, `false` if not.
      */
     static isRGB(color) {
-        return /^rgb\(\d{1,3},\s*\d{1,3},\s*\d{1,3}\)$/.test(color);
+        return (0, helpers_1._isRGB)(color);
     }
     /**
-     * @static Checks if a color is in `RGBA` format.
+     * @static Checks if a color is in `RGBA` format and within valid ranges.
      *
      * @param color Color to check.
-     * @returns Boolean: `true` if it's an `RGBA` color, `false` if not.
+     * @returns `true` if it's a `RGBA` color, `false` if not.
      */
     static isRGBA(color) {
-        return /^rgba\(\d{1,3},\s*\d{1,3},\s*\d{1,3},\s*(0|1|0?\.\d+)\)$/.test(color);
+        return (0, helpers_1._isRGBA)(color);
     }
     /**
-     * @static Checks if a color is in `HSL` format.
+     * @static Checks if a color is in `HSL` format and within valid ranges.
      *
      * @param color Color to check.
-     * @returns Boolean: `true` if it's an `HSL` color, `false` if not.
+     * @returns `true` if it's a `HSL` color, `false` if not.
      */
     static isHSL(color) {
-        return /^hsl\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%\)$/.test(color);
+        return (0, helpers_1._isHSL)(color);
     }
     /**
-     * @static Checks if a color is in `HSLA` format.
+     * @static Checks if a color is in `HSLA` format and within valid ranges.
      *
      * @param color Color to check.
-     * @returns Boolean: `true` if it's an `HSLA` color, `false` if not.
+     * @returns `true` if it's a `HSLA` color, `false` if not.
      */
     static isHSLA(color) {
-        return /^hsla\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%,\s*(0|1|0?\.\d+)\)$/.test(color);
+        return (0, helpers_1._isHSLA)(color);
     }
     /**
      * @private Converts the given color to all other formats while preserving the original.
@@ -237,5 +391,20 @@ class Color {
         }
         throw new Error(`Unrecognized color format: ${color}`);
     }
+    /**
+     * @private @static Internal factory to create a Color instance from parsed parts.
+     * @param parts All the color parts as object.
+     * @returns An instance of `Color`.
+     */
+    static #fromParts(parts) {
+        const color = Object.create(Color.prototype);
+        color.hex = parts.hex;
+        color.hex8 = parts.hex8;
+        color.rgb = parts.rgb;
+        color.rgba = parts.rgba;
+        color.hsl = parts.hsl;
+        color.hsla = parts.hsla;
+        return color;
+    }
 }
 exports.Color = Color;

package/dist/cjs/colors/helpers.js

@@ -2,12 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._extractAlphaColorValues = exports._extractSolidColorValues = exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = exports._convertOpacityToHex = void 0;
 exports._isHex6 = _isHex6;
-exports._isRGB = _isRGB;
-exports._isHSL = _isHSL;
 exports._isHex8 = _isHex8;
+exports._isRGB = _isRGB;
 exports._isRGBA = _isRGBA;
+exports._isHSL = _isHSL;
 exports._isHSLA = _isHSLA;
 exports._isValidAlpha = _isValidAlpha;
+exports._isValidRGBComponent = _isValidRGBComponent;
+exports._isValidHue = _isValidHue;
+exports._isValidPercentage = _isValidPercentage;
 /**
  * * Converts opacity percentage (0-100) to a 2-digit hex string.
  *
@@ -97,7 +100,7 @@ const _extractAlphaColorValues = (colorString) => {
 };
 exports._extractAlphaColorValues = _extractAlphaColorValues;
 /**
- * * Checks if a color is in `Hex` format.
+ * @private Checks if a color is in `Hex` format.
  *
  * @param color Color to check.
  * @returns Boolean: `true` if it's a `Hex` color, `false` if not.
@@ -106,58 +109,92 @@ function _isHex6(color) {
     return /^#[0-9A-Fa-f]{6}$/.test(color);
 }
 /**
- * * Checks if a color is in `RGB` format.
+ * @private Checks if a color is in `Hex8` format.
  *
  * @param color Color to check.
- * @returns Boolean: `true` if it's an `RGB` color, `false` if not.
+ * @returns Boolean: `true` if it's a `Hex8` color, `false` if not.
  */
-function _isRGB(color) {
-    return /^rgb\(\d{1,3},\s*\d{1,3},\s*\d{1,3}\)$/.test(color);
+function _isHex8(color) {
+    return /^#[0-9A-Fa-f]{8}$/.test(color);
 }
 /**
- * * Checks if a color is in `HSL` format.
+ * @private Checks if a color is in `RGB` format and within valid ranges.
  *
  * @param color Color to check.
- * @returns Boolean: `true` if it's an `HSL` color, `false` if not.
+ * @returns `true` if it's a `RGB` color, `false` if not.
  */
-function _isHSL(color) {
-    return /^hsl\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%\)$/.test(color);
+function _isRGB(color) {
+    const match = color.match(/^rgb\(\s*(\d{1,3}(?:\.\d+)?),\s*(\d{1,3}(?:\.\d+)?),\s*(\d{1,3}(?:\.\d+)?)\s*\)$/);
+    if (!match)
+        return false;
+    const [r, g, b] = match.slice(1).map(Number);
+    return (_isValidRGBComponent(r) &&
+        _isValidRGBComponent(g) &&
+        _isValidRGBComponent(b));
 }
 /**
- * @static
- * Checks if a color is in `Hex8` format.
+ * @private Checks if a color is in `RGBA` format and within valid ranges.
  *
  * @param color Color to check.
- * @returns Boolean: `true` if it's a `Hex8` color, `false` if not.
+ * @returns `true` if it's a `RGBA` color, `false` if not.
  */
-function _isHex8(color) {
-    return /^#[0-9A-Fa-f]{8}$/.test(color);
+function _isRGBA(color) {
+    const match = color.match(/^rgba\(\s*(\d{1,3}(?:\.\d+)?),\s*(\d{1,3}(?:\.\d+)?),\s*(\d{1,3}(?:\.\d+)?),\s*(0|1|0?\.\d+)\s*\)$/);
+    if (!match)
+        return false;
+    const [r, g, b, a] = match.slice(1).map(Number);
+    return (_isValidRGBComponent(r) &&
+        _isValidRGBComponent(g) &&
+        _isValidRGBComponent(b) &&
+        _isValidAlpha(a));
 }
 /**
- * @static
- * Checks if a color is in `RGBA` format.
+ * @private Checks if a color is in `HSL` format and within valid ranges.
  *
  * @param color Color to check.
- * @returns Boolean: `true` if it's an `RGBA` color, `false` if not.
+ * @returns `true` if it's a `HSL` color, `false` if not.
  */
-function _isRGBA(color) {
-    return /^rgba\(\d{1,3},\s*\d{1,3},\s*\d{1,3},\s*(0|1|0?\.\d+)\)$/.test(color);
+function _isHSL(color) {
+    const match = color.match(/^hsl\(\s*(\d{1,3}(?:\.\d+)?),\s*(\d{1,3}(?:\.\d+)?)%,\s*(\d{1,3}(?:\.\d+)?)%\s*\)$/);
+    if (!match)
+        return false;
+    const [h, s, l] = match.slice(1).map(Number);
+    return _isValidHue(h) && _isValidPercentage(s) && _isValidPercentage(l);
 }
 /**
- * @static
- * Checks if a color is in `HSLA` format.
+ * @private Checks if a color is in `HSLA` format and within valid ranges.
  *
  * @param color Color to check.
- * @returns Boolean: `true` if it's an `HSLA` color, `false` if not.
+ * @returns `true` if it's a `HSLA` color, `false` if not.
  */
 function _isHSLA(color) {
-    return /^hsla\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%,\s*(0|1|0?\.\d+)\)$/.test(color);
+    const match = color.match(/^hsla\(\s*(\d{1,3}(?:\.\d+)?),\s*(\d{1,3}(?:\.\d+)?)%,\s*(\d{1,3}(?:\.\d+)?)%,\s*(0|1|0?\.\d+)\s*\)$/);
+    if (!match)
+        return false;
+    const [h, s, l, a] = match.slice(1).map(Number);
+    return (_isValidHue(h) &&
+        _isValidPercentage(s) &&
+        _isValidPercentage(l) &&
+        _isValidAlpha(a));
 }
 /**
- * * Type guard to validate alpha value.
+ * @private Checks if a number is valid alpha value.
+ *
  * @param value Alpha value to check.
- * @returns Boolean: `true` if it's a valid alpha value, `false` if not.
+ * @returns `true` if it's a valid alpha value, `false` if not.
  */
 function _isValidAlpha(value) {
     return value >= 0 && value <= 1 && !isNaN(value);
 }
+/** * @private Validates RGB component (0–255). */
+function _isValidRGBComponent(value) {
+    return value >= 0 && value <= 255;
+}
+/** * @private Validates HSL hue (0–360). */
+function _isValidHue(value) {
+    return value >= 0 && value <= 360;
+}
+/** * @private Validates HSL percentage components (0–100). */
+function _isValidPercentage(value) {
+    return value >= 0 && value <= 100;
+}

package/dist/cjs/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = 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.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = 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.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = 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.convertToRomanNumerals = exports.convertNumberToWords = exports.isPerfectSquare = exports.isParOfFibonacciSeries = exports.isParOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isMultiple = exports.isInvalidNumbers = exports.isFibonacci = exports.isEvenNumber = exports.isEven = void 0;
-exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.moveArrayElement = 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 = void 0;
-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.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = 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.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 = void 0;
-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 = 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.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.debounceAction = exports.countStaticMethods = 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 = void 0;
+exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = 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.countWordsInString = exports.wordCount = exports.countWords = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = 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.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = 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.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 = void 0;
+exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = 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 = void 0;
+exports.updateQueryParam = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = 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.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 = void 0;
+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 = 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.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = 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 = 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 = void 0;
 // ! String Utilities
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
@@ -37,6 +37,9 @@ var utilities_1 = require("./string/utilities");
 Object.defineProperty(exports, "extractNumbersFromString", { enumerable: true, get: function () { return utilities_1.extractNumbersFromString; } });
 Object.defineProperty(exports, "getLevenshteinDistance", { enumerable: true, get: function () { return utilities_1.getLevenshteinDistance; } });
 Object.defineProperty(exports, "levenshteinDistance", { enumerable: true, get: function () { return utilities_1.getLevenshteinDistance; } });
+Object.defineProperty(exports, "countWords", { enumerable: true, get: function () { return utilities_1.countWords; } });
+Object.defineProperty(exports, "wordCount", { enumerable: true, get: function () { return utilities_1.countWords; } });
+Object.defineProperty(exports, "countWordsInString", { enumerable: true, get: function () { return utilities_1.countWords; } });
 // ! Number Utilities
 var basics_2 = require("./number/basics");
 Object.defineProperty(exports, "calculateAverage", { enumerable: true, get: function () { return basics_2.getAverage; } });
@@ -177,7 +180,15 @@ var sort_1 = require("./array/sort");
 Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return sort_1.sortAnArray; } });
 var transform_1 = require("./array/transform");
 Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return transform_1.createOptionsArray; } });
+Object.defineProperty(exports, "extractDuplicates", { enumerable: true, get: function () { return transform_1.getDuplicates; } });
+Object.defineProperty(exports, "extractDuplicatesFromArray", { enumerable: true, get: function () { return transform_1.getDuplicates; } });
+Object.defineProperty(exports, "extractMissingElements", { enumerable: true, get: function () { return transform_1.findMissingElements; } });
+Object.defineProperty(exports, "findMissingElements", { enumerable: true, get: function () { return transform_1.findMissingElements; } });
+Object.defineProperty(exports, "getDuplicates", { enumerable: true, get: function () { return transform_1.getDuplicates; } });
+Object.defineProperty(exports, "getDuplicatesFromArray", { enumerable: true, get: function () { return transform_1.getDuplicates; } });
+Object.defineProperty(exports, "getMissingElements", { enumerable: true, get: function () { return transform_1.findMissingElements; } });
 Object.defineProperty(exports, "moveArrayElement", { enumerable: true, get: function () { return transform_1.moveArrayElement; } });
+Object.defineProperty(exports, "removeDuplicates", { enumerable: true, get: function () { return transform_1.removeDuplicatesFromArray; } });
 Object.defineProperty(exports, "removeDuplicatesFromArray", { enumerable: true, get: function () { return transform_1.removeDuplicatesFromArray; } });
 Object.defineProperty(exports, "rotateArray", { enumerable: true, get: function () { return transform_1.rotateArray; } });
 Object.defineProperty(exports, "splitArray", { enumerable: true, get: function () { return transform_1.splitArray; } });

package/dist/cjs/string/utilities.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLevenshteinDistance = exports.extractNumbersFromString = void 0;
+exports.countWords = countWords;
 /**
  * * Extracts all numbers from a string as array of numbers.
  * @param input - The string to extract numbers from.
@@ -33,3 +34,12 @@ const getLevenshteinDistance = (a, b) => {
     return dp[lenA][lenB];
 };
 exports.getLevenshteinDistance = getLevenshteinDistance;
+/**
+ * * Counts the number of words in a string, supporting multiple languages and scripts.
+ *
+ * @param text - The input string to count words from.
+ * @returns Number of words (Unicode-aware).
+ */
+function countWords(text) {
+    return (text.match(/\p{L}[\p{L}\p{M}\p{Pd}'’]*/gu) || []).length;
+}

package/dist/dts/array/transform.d.ts

@@ -15,6 +15,30 @@ export declare const createOptionsArray: <T extends GenericObject, K1 extends st
  * @returns A new array with duplicates removed.
  */
 export declare function removeDuplicatesFromArray<T>(array: T[]): T[];
+/**
+ * * Finds duplicate values in an array, runs deep comparison for objects and arrays.
+ *
+ * @param array - The array in which to find duplicates.
+ * @returns An array containing all duplicate entries (each one only once).
+ */
+export declare function getDuplicates<T>(array: T[]): T[];
+/**
+ * * Finds elements missing from one array compared to another using deep comparison.
+ *
+ * @param options - Configuration to specify which array to compare and direction of check.
+ * @returns An array of missing elements based on the comparison direction.
+ */
+/**
+ * * Finds elements missing from one array compared to another using deep comparison.
+ *
+ * @param array1 The first array to compare.
+ * @param array2 The second array to compare.
+ * @param missingFrom Which direction to compare for missing values:.
+ *					  - `'from-first'` → values in `array1` missing in `array2`.
+ *					  - `'from-second'` → values in `array2` missing in `array1`.
+ * @returns An array of missing elements based on the comparison direction.
+ */
+export declare function findMissingElements<T, U>(array1: T[], array2: U[], missingFrom: 'from-first' | 'from-second'): (T | U)[];
 /**
  * * Splits an array into chunks of a given size.
  *

package/dist/dts/array/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/array/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,aAAa,EACvB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAgB5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK5D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAQ3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,GAAG,EAAE,CAAC,EAAE,EACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,CAAC,EAAE,CAQL"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/array/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,aAAa,EACvB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAgB5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAgBhD;AAED;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACvC,MAAM,EAAE,CAAC,EAAE,EACX,MAAM,EAAE,CAAC,EAAE,EACX,WAAW,EAAE,YAAY,GAAG,aAAa,GACvC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAKX;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAQ3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,GAAG,EAAE,CAAC,EAAE,EACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,CAAC,EAAE,CAQL"}