nhb-toolbox 1.4.0 → 1.6.0

package/dist/colors/convert.d.ts

@@ -1,51 +1,91 @@
+import type { ColorNumbers, Hex, HSL, RGB } from './types';
 /**
- * Converts HSL to RGB color format.
+ * * Converts HSL to RGB color format.
  *
  * @param h - The hue component of the HSL color, in degrees (0 to 360).
  * @param s - The saturation component of the HSL color, as a percentage (0 to 100).
  * @param l - The lightness component of the HSL color, as a percentage (0 to 100).
  * @returns A string representing the color in RGB format (e.g., `rgb(255, 0, 0)`).
  */
-export declare const convertHslToRgb: (h: number, s: number, l: number) => string;
+export declare const convertHslToRgb: (h: number, s: number, l: number) => RGB;
 /**
- * Converts RGB to HSL color format.
+ * * Converts RGB to HSL color format.
  *
  * @param r - The red component of the RGB color, in the range 0 to 255.
  * @param g - The green component of the RGB color, in the range 0 to 255.
  * @param b - The blue component of the RGB color, in the range 0 to 255.
  * @returns A string representing the color in HSL format (e.g., `hsl(0, 100%, 50%)`).
  */
-export declare const convertRgbToHsl: (r: number, g: number, b: number) => string;
+export declare const convertRgbToHsl: (r: number, g: number, b: number) => HSL;
 /**
- * Converts HSL to Hex color format.
+ * * Converts HSL to Hex color format.
  *
  * @param h - The hue component of the HSL color, in degrees (0 to 360).
  * @param s - The saturation component of the HSL color, as a percentage (0 to 100).
  * @param l - The lightness component of the HSL color, as a percentage (0 to 100).
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
-export declare const convertHslToHex: (h: number, s: number, l: number) => string;
+export declare const convertHslToHex: (h: number, s: number, l: number) => Hex;
 /**
- * Converts Hex to HSL color format.
+ * * Converts Hex to HSL color format.
  *
  * @param hex - A string representing the color in Hex format (e.g., `#FF0000`).
  * @returns A string representing the color in HSL format (e.g., `hsl(0, 100%, 50%)`).
  */
-export declare const convertHexToHsl: (hex: string) => string;
+export declare const convertHexToHsl: (hex: Hex | string) => HSL;
 /**
- * Converts RGB to Hex color format.
+ * * Converts RGB to Hex color format.
  *
  * @param r - The red component of the RGB color, in the range 0 to 255.
  * @param g - The green component of the RGB color, in the range 0 to 255.
  * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha opacity of the RGB color, in the range 0 to 255.
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
-export declare const convertRgbToHex: (r: number, g: number, b: number) => string;
+export declare const convertRgbToHex: (r: number, g: number, b: number, a?: number) => Hex;
 /**
- * Converts Hex to RGB color format.
+ * * Converts Hex to RGB color format.
  *
  * @param hex - A string representing the color in Hex format (e.g., `#FF0000`).
  * @returns A string representing the color in RGB format (e.g., `rgb(255, 0, 0)`).
  */
-export declare const convertHexToRgb: (hex: string) => string;
+export declare const convertHexToRgb: (hex: Hex | string) => RGB;
+/**
+ * * Extracts numbers from a color string like `rgb(66, 103, 69)` or `hsl(120, 42.86%, 41.18%)`.
+ * * Converts percentage values to decimal (e.g., `42.86%` → `42.86`).
+ *
+ * @param colorString The color string in RGB or HSL format.
+ * @returns An array of extracted numbers.
+ */
+export declare const extractNumbersFromColor: (colorString: HSL | RGB) => ColorNumbers;
+/**
+ * * Converts a `Hex` color code to `RGB` and `HSL` formats.
+ *
+ * @param color The `Hex` color code (e.g., `#3c6945`).
+ * @returns An object containing the `RGB` and `HSL` formats of the given `Hex` color.
+ */
+export declare function convertColorCode(color: Hex): {
+    rgb: RGB;
+    hsl: HSL;
+};
+/**
+ * * Converts an `RGB` color to `Hex` and `HSL` formats.
+ *
+ * @param color The `RGB` color string (e.g., `rgb(60, 105, 69)`).
+ * @returns An object containing the `Hex` and `HSL` formats of the given `RGB` color.
+ */
+export declare function convertColorCode(color: RGB): {
+    hex: Hex;
+    hsl: HSL;
+};
+/**
+ * * Converts an `HSL` color to `Hex` and `RGB` formats.
+ *
+ * @param color The `HSL` color string (e.g., `hsl(132, 27.27%, 32.35%)`).
+ * @returns An object containing the `Hex` and `RGB` formats of the given `HSL` color.
+ */
+export declare function convertColorCode(color: HSL): {
+    hex: Hex;
+    rgb: RGB;
+};
 //# sourceMappingURL=convert.d.ts.map

package/dist/colors/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/colors/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,MAuCjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,MAoCjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,MAKjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,MAAM,KAAG,MAU7C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,MAEjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,MAAM,KAAG,MAU7C,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/colors/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,YAAY,EAEZ,GAAG,EACH,GAAG,EACH,GAAG,EACH,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAwBjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAkCjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAIjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,GAAG,GAAG,MAAM,KAAG,GAenD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,MACxB,MAAM,KACN,MAAM,KACN,MAAM,MACL,MAAM,KACR,GAcF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,GAAG,GAAG,MAAM,KAAG,GAgBnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,gBACtB,GAAG,GAAG,GAAG,KACpB,YAIF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC"}

package/dist/colors/convert.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertHexToRgb = exports.convertRgbToHex = exports.convertHexToHsl = exports.convertHslToHex = exports.convertRgbToHsl = exports.convertHslToRgb = void 0;
+exports.extractNumbersFromColor = exports.convertHexToRgb = exports.convertRgbToHex = exports.convertHexToHsl = exports.convertHslToHex = exports.convertRgbToHsl = exports.convertHslToRgb = void 0;
+exports.convertColorCode = convertColorCode;
 /**
- * Converts HSL to RGB color format.
+ * * Converts HSL to RGB color format.
  *
  * @param h - The hue component of the HSL color, in degrees (0 to 360).
  * @param s - The saturation component of the HSL color, as a percentage (0 to 100).
@@ -17,31 +18,18 @@ const convertHslToRgb = (h, s, l) => {
     const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
     const m = l - c / 2;
     let r = 0, g = 0, b = 0;
-    if (h >= 0 && h < 60) {
-        r = c;
-        g = x;
-    }
-    else if (h >= 60 && h < 120) {
-        r = x;
-        g = c;
-    }
-    else if (h >= 120 && h < 180) {
-        g = c;
-        b = x;
-    }
-    else if (h >= 180 && h < 240) {
-        g = x;
-        b = c;
-    }
-    else if (h >= 240 && h < 300) {
-        r = x;
-        b = c;
-    }
-    else if (h >= 300 && h < 360) {
-        r = c;
-        b = x;
-    }
-    // Convert RGB to 0-255 range and apply m
+    if (h >= 0 && h < 60)
+        [r, g] = [c, x];
+    else if (h >= 60 && h < 120)
+        [r, g] = [x, c];
+    else if (h >= 120 && h < 180)
+        [g, b] = [c, x];
+    else if (h >= 180 && h < 240)
+        [g, b] = [x, c];
+    else if (h >= 240 && h < 300)
+        [r, b] = [x, c];
+    else if (h >= 300 && h < 360)
+        [r, b] = [c, x];
     r = Math.round((r + m) * 255);
     g = Math.round((g + m) * 255);
     b = Math.round((b + m) * 255);
@@ -49,7 +37,7 @@ const convertHslToRgb = (h, s, l) => {
 };
 exports.convertHslToRgb = convertHslToRgb;
 /**
- * Converts RGB to HSL color format.
+ * * Converts RGB to HSL color format.
  *
  * @param r - The red component of the RGB color, in the range 0 to 255.
  * @param g - The green component of the RGB color, in the range 0 to 255.
@@ -57,40 +45,34 @@ exports.convertHslToRgb = convertHslToRgb;
  * @returns A string representing the color in HSL format (e.g., `hsl(0, 100%, 50%)`).
  */
 const convertRgbToHsl = (r, g, b) => {
-    // Normalize the RGB values
     r /= 255;
     g /= 255;
     b /= 255;
     const max = Math.max(r, g, b);
     const min = Math.min(r, g, b);
-    const delta = max - min;
-    let h = 0, s = 0, l = (max + min) / 2;
-    if (delta !== 0) {
-        if (max === r) {
-            h = (g - b) / delta;
+    let h = 0, s = 0;
+    const l = (max + min) / 2;
+    if (max !== min) {
+        const diff = max - min;
+        s = l > 0.5 ? diff / (2 - max - min) : diff / (max + min);
+        switch (max) {
+            case r:
+                h = (g - b) / diff + (g < b ? 6 : 0);
+                break;
+            case g:
+                h = (b - r) / diff + 2;
+                break;
+            case b:
+                h = (r - g) / diff + 4;
+                break;
         }
-        else if (max === g) {
-            h = (b - r) / delta + 2;
-        }
-        else {
-            h = (r - g) / delta + 4;
-        }
-        s = delta / (1 - Math.abs(2 * l - 1));
         h *= 60;
-        if (s === 0)
-            l = Math.round(l * 100); // for pure colors
-    }
-    else {
-        s = 0;
     }
-    h = Math.round(h);
-    s = Math.round(s * 100);
-    l = Math.round(l * 100);
-    return `hsl(${h}, ${s}%, ${l}%)`;
+    return `hsl(${Math.round(h)}, ${Number((s * 100).toFixed(2))}%, ${Number((l * 100).toFixed(2))}%)`;
 };
 exports.convertRgbToHsl = convertRgbToHsl;
 /**
- * Converts HSL to Hex color format.
+ * * Converts HSL to Hex color format.
  *
  * @param h - The hue component of the HSL color, in degrees (0 to 360).
  * @param s - The saturation component of the HSL color, as a percentage (0 to 100).
@@ -98,52 +80,110 @@ exports.convertRgbToHsl = convertRgbToHsl;
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
 const convertHslToHex = (h, s, l) => {
-    const rgb = (0, exports.convertHslToRgb)(h, s, l);
-    const [r, g, b] = rgb.match(/\d+/g).map((value) => parseInt(value, 10));
-    return `#${((1 << 24) | (r << 16) | (g << 8) | b).toString(16).slice(1).toUpperCase().padStart(6, '0')}`;
+    const rgb = (0, exports.convertHslToRgb)(h, s, l).match(/\d+/g).map(Number);
+    return (0, exports.convertRgbToHex)(rgb[0], rgb[1], rgb[2]);
 };
 exports.convertHslToHex = convertHslToHex;
 /**
- * Converts Hex to HSL color format.
+ * * Converts Hex to HSL color format.
  *
  * @param hex - A string representing the color in Hex format (e.g., `#FF0000`).
  * @returns A string representing the color in HSL format (e.g., `hsl(0, 100%, 50%)`).
  */
 const convertHexToHsl = (hex) => {
-    const hexCode = hex.replace('#', '');
-    // Parse the hex value
-    const r = parseInt(hexCode.slice(0, 2), 16);
-    const g = parseInt(hexCode.slice(2, 4), 16);
-    const b = parseInt(hexCode.slice(4, 6), 16);
-    // Convert RGB to HSL
+    let newHex = hex.replace('#', '');
+    if (newHex.length === 3) {
+        newHex = newHex
+            .split('')
+            .map((char) => char + char)
+            .join('');
+    }
+    const r = parseInt(newHex.slice(0, 2), 16);
+    const g = parseInt(newHex.slice(2, 4), 16);
+    const b = parseInt(newHex.slice(4, 6), 16);
     return (0, exports.convertRgbToHsl)(r, g, b);
 };
 exports.convertHexToHsl = convertHexToHsl;
 /**
- * Converts RGB to Hex color format.
+ * * Converts RGB to Hex color format.
  *
  * @param r - The red component of the RGB color, in the range 0 to 255.
  * @param g - The green component of the RGB color, in the range 0 to 255.
  * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha opacity of the RGB color, in the range 0 to 255.
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
-const convertRgbToHex = (r, g, b) => {
-    return `#${((1 << 24) | (r << 16) | (g << 8) | b).toString(16).slice(1).toUpperCase().padStart(6, '0')}`;
+const convertRgbToHex = (r, g, b, a) => {
+    let hex = [r, g, b]
+        .map((v) => v.toString(16).padStart(2, '0'))
+        .join('')
+        .toUpperCase();
+    if (a !== undefined) {
+        const alphaHex = Math.round(a * 255)
+            .toString(16)
+            .padStart(2, '0');
+        hex += alphaHex;
+    }
+    return `#${hex}`;
 };
 exports.convertRgbToHex = convertRgbToHex;
 /**
- * Converts Hex to RGB color format.
+ * * Converts Hex to RGB color format.
  *
  * @param hex - A string representing the color in Hex format (e.g., `#FF0000`).
  * @returns A string representing the color in RGB format (e.g., `rgb(255, 0, 0)`).
  */
 const convertHexToRgb = (hex) => {
     // Remove the # if present
-    hex = hex.replace('#', '');
-    // Parse the hex value
-    const r = parseInt(hex.slice(0, 2), 16);
-    const g = parseInt(hex.slice(2, 4), 16);
-    const b = parseInt(hex.slice(4, 6), 16);
+    let newHex = hex.replace('#', '');
+    if (newHex.length === 3) {
+        newHex = newHex
+            .split('')
+            .map((char) => char + char)
+            .join('');
+    }
+    const r = parseInt(newHex.slice(0, 2), 16);
+    const g = parseInt(newHex.slice(2, 4), 16);
+    const b = parseInt(newHex.slice(4, 6), 16);
     return `rgb(${r}, ${g}, ${b})`;
 };
 exports.convertHexToRgb = convertHexToRgb;
+/**
+ * * Extracts numbers from a color string like `rgb(66, 103, 69)` or `hsl(120, 42.86%, 41.18%)`.
+ * * Converts percentage values to decimal (e.g., `42.86%` → `42.86`).
+ *
+ * @param colorString The color string in RGB or HSL format.
+ * @returns An array of extracted numbers.
+ */
+const extractNumbersFromColor = (colorString) => {
+    return (colorString.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
+};
+exports.extractNumbersFromColor = extractNumbersFromColor;
+/**
+ * * Converts a color from `Hex`, `RGB`, or `HSL` format to its equivalent representations.
+ *
+ * @param color The color string in `Hex`, `RGB`, or `HSL` format.
+ * @returns The converted color representations excluding the input format.
+ * @throws If the color format is unrecognized throws `Error`.
+ */
+function convertColorCode(color) {
+    if (color.startsWith('#')) {
+        return {
+            rgb: (0, exports.convertHexToRgb)(color),
+            hsl: (0, exports.convertHexToHsl)(color),
+        };
+    }
+    if (color.startsWith('rgb')) {
+        return {
+            hex: (0, exports.convertRgbToHex)(...(0, exports.extractNumbersFromColor)(color)),
+            hsl: (0, exports.convertRgbToHsl)(...(0, exports.extractNumbersFromColor)(color)),
+        };
+    }
+    if (color.startsWith('hsl')) {
+        return {
+            hex: (0, exports.convertHslToHex)(...(0, exports.extractNumbersFromColor)(color)),
+            rgb: (0, exports.convertHslToRgb)(...(0, exports.extractNumbersFromColor)(color)),
+        };
+    }
+    throw new Error(`Unrecognized Color Format: ${color}`);
+}

package/dist/colors/types.d.ts

@@ -5,4 +5,50 @@ export interface ColorInputArray extends Array<ColorInput | ColorInputArray> {
 }
 /** - Opacity options */
 export type OpacityValue = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100;
+/**
+ * * Represents a hexadecimal color code.
+ * Format: `#3C6945`
+ */
+export type Hex = `#${string}`;
+/**
+ * * Represents an RGB color string.
+ * * Format: `rgb(R, G, B)`
+ *
+ * - R (Red): 0-255
+ * - G (Green): 0-255
+ * - B (Blue): 0-255
+ */
+export type RGB = `rgb(${number}, ${number}, ${number})`;
+/**
+ * * Represents an HSL color string.
+ * * Format: `hsl(H, S%, L%)`
+ *
+ * - H (Hue): 0-360
+ * - S (Saturation): 0-100%
+ * - L (Lightness): 0-100%
+ */
+export type HSL = `hsl(${number}, ${number}%, ${number}%)`;
+export type RGBA = `rgba(${number}, ${number}, ${number}, ${number})`;
+export type HSLA = `hsla(${number}, ${number}%, ${number}%, ${number})`;
+/** * Union type representing a color in Hex, RGB, or HSL format. */
+export type Color = Hex | RGB | HSL | RGBA | HSLA;
+/** * Represents a tuple of three numerical values corresponding to RGB or HSL color components. */
+export type ColorNumbers = [number, number, number];
+/**
+ * * Represents the converted color formats for a given color type.
+ *
+ * - If the input is `Hex`, the output includes `RGB` and `HSL`.
+ * - If the input is `RGB`, the output includes `Hex` and `HSL`.
+ * - If the input is `HSL`, the output includes `Hex` and `RGB`.
+ *
+ * @template T The input color type (`Hex`, `RGB`, or `HSL`).
+ */
+export interface ConvertedColors<T extends Color> extends Record<string, Hex | RGB | HSL> {
+    /** - The Hex representation (excluded if the input is already Hex). */
+    hex: T extends Hex ? never : Hex;
+    /** - The RGB representation (excluded if the input is already RGB). */
+    rgb: T extends RGB ? never : RGB;
+    /** - The HSL representation (excluded if the input is already HSL). */
+    hsl: T extends HSL ? never : HSL;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/colors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,+FAA+F;AAC/F,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,UAAU,GAAG,eAAe,CAAC;CAAG;AAE/E,wBAAwB;AACxB,MAAM,MAAM,YAAY,GACrB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,GAAG,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,12 +2,14 @@ export { capitalizeString, generateRandomID, trimString, truncateString, } from
 export { generateAnagrams } from './string/anagram';
 export { convertToDecimal, getRandomNumber } from './number/basics';
 export { numberToWords } from './number/convert';
-export { isPrime, findPrimeNumbers } from './number/prime';
+export { findPrimeNumbers, isPrime } from './number/prime';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColor } from './colors/random';
-export { convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
+export { convertColorCode, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, extractNumbersFromColor, } from './colors/convert';
 export { createOptionsArray, filterArrayOfObjects, flattenArray, sortAnArray, } from './array/basics';
-export { cloneObject, countObjectFields, flattenObject, generateQueryParams, isDeepEqual, isEmptyObject, mergeAndFlattenObjects, mergeObjects, } from './object/basics';
+export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isObject, } from './object/basics';
+export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObject, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';
 export { convertObjectValues } from './object/convert';
+export { isDeepEqual } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.isEmptyObject = exports.isDeepEqual = exports.generateQueryParams = exports.flattenObject = exports.countObjectFields = exports.cloneObject = exports.sortAnArray = exports.flattenArray = exports.filterArrayOfObjects = exports.createOptionsArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForInitial = exports.findPrimeNumbers = exports.isPrime = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.isDeepEqual = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObject = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = exports.sortAnArray = exports.flattenArray = exports.filterArrayOfObjects = exports.createOptionsArray = exports.extractNumbersFromColor = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertColorCode = exports.generateRandomColor = exports.getColorForInitial = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
@@ -14,19 +14,21 @@ Object.defineProperty(exports, "getRandomNumber", { enumerable: true, get: funct
 var convert_1 = require("./number/convert");
 Object.defineProperty(exports, "numberToWords", { enumerable: true, get: function () { return convert_1.numberToWords; } });
 var prime_1 = require("./number/prime");
-Object.defineProperty(exports, "isPrime", { enumerable: true, get: function () { return prime_1.isPrime; } });
 Object.defineProperty(exports, "findPrimeNumbers", { enumerable: true, get: function () { return prime_1.findPrimeNumbers; } });
+Object.defineProperty(exports, "isPrime", { enumerable: true, get: function () { return prime_1.isPrime; } });
 var initials_1 = require("./colors/initials");
 Object.defineProperty(exports, "getColorForInitial", { enumerable: true, get: function () { return initials_1.getColorForInitial; } });
 var random_1 = require("./colors/random");
 Object.defineProperty(exports, "generateRandomColor", { enumerable: true, get: function () { return random_1.generateRandomColor; } });
 var convert_2 = require("./colors/convert");
+Object.defineProperty(exports, "convertColorCode", { enumerable: true, get: function () { return convert_2.convertColorCode; } });
 Object.defineProperty(exports, "convertHexToHsl", { enumerable: true, get: function () { return convert_2.convertHexToHsl; } });
 Object.defineProperty(exports, "convertHexToRgb", { enumerable: true, get: function () { return convert_2.convertHexToRgb; } });
 Object.defineProperty(exports, "convertHslToHex", { enumerable: true, get: function () { return convert_2.convertHslToHex; } });
 Object.defineProperty(exports, "convertHslToRgb", { enumerable: true, get: function () { return convert_2.convertHslToRgb; } });
 Object.defineProperty(exports, "convertRgbToHex", { enumerable: true, get: function () { return convert_2.convertRgbToHex; } });
 Object.defineProperty(exports, "convertRgbToHsl", { enumerable: true, get: function () { return convert_2.convertRgbToHsl; } });
+Object.defineProperty(exports, "extractNumbersFromColor", { enumerable: true, get: function () { return convert_2.extractNumbersFromColor; } });
 var basics_3 = require("./array/basics");
 Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return basics_3.createOptionsArray; } });
 Object.defineProperty(exports, "filterArrayOfObjects", { enumerable: true, get: function () { return basics_3.filterArrayOfObjects; } });
@@ -35,13 +37,19 @@ Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function
 var basics_4 = require("./object/basics");
 Object.defineProperty(exports, "cloneObject", { enumerable: true, get: function () { return basics_4.cloneObject; } });
 Object.defineProperty(exports, "countObjectFields", { enumerable: true, get: function () { return basics_4.countObjectFields; } });
-Object.defineProperty(exports, "flattenObject", { enumerable: true, get: function () { return basics_4.flattenObject; } });
 Object.defineProperty(exports, "generateQueryParams", { enumerable: true, get: function () { return basics_4.generateQueryParams; } });
-Object.defineProperty(exports, "isDeepEqual", { enumerable: true, get: function () { return basics_4.isDeepEqual; } });
 Object.defineProperty(exports, "isEmptyObject", { enumerable: true, get: function () { return basics_4.isEmptyObject; } });
-Object.defineProperty(exports, "mergeAndFlattenObjects", { enumerable: true, get: function () { return basics_4.mergeAndFlattenObjects; } });
-Object.defineProperty(exports, "mergeObjects", { enumerable: true, get: function () { return basics_4.mergeObjects; } });
+Object.defineProperty(exports, "isObject", { enumerable: true, get: function () { return basics_4.isObject; } });
+var objectify_1 = require("./object/objectify");
+Object.defineProperty(exports, "extractNewFields", { enumerable: true, get: function () { return objectify_1.extractNewFields; } });
+Object.defineProperty(exports, "extractUpdatedAndNewFields", { enumerable: true, get: function () { return objectify_1.extractUpdatedAndNewFields; } });
+Object.defineProperty(exports, "extractUpdatedFields", { enumerable: true, get: function () { return objectify_1.extractUpdatedFields; } });
+Object.defineProperty(exports, "flattenObject", { enumerable: true, get: function () { return objectify_1.flattenObject; } });
+Object.defineProperty(exports, "mergeAndFlattenObjects", { enumerable: true, get: function () { return objectify_1.mergeAndFlattenObjects; } });
+Object.defineProperty(exports, "mergeObjects", { enumerable: true, get: function () { return objectify_1.mergeObjects; } });
 var sanitize_1 = require("./object/sanitize");
 Object.defineProperty(exports, "sanitizeData", { enumerable: true, get: function () { return sanitize_1.sanitizeData; } });
 var convert_3 = require("./object/convert");
 Object.defineProperty(exports, "convertObjectValues", { enumerable: true, get: function () { return convert_3.convertObjectValues; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "isDeepEqual", { enumerable: true, get: function () { return utils_1.isDeepEqual; } });

package/dist/object/basics.d.ts

@@ -34,34 +34,10 @@ export declare const isEmptyObject: <T extends GenericObject>(obj: T) => boolean
  */
 export declare const countObjectFields: <T extends GenericObject>(obj: T) => number;
 /**
- * * Deeply merge two or more objects using `Map`.
+ * * Check whether data is object and not array.
  *
- * @param objects Objects to merge.
- * @returns Merged object.
+ * @param data Data to check if its an object and not array.
+ * @returns Boolean: `true` if it's an object, `false` if not.
  */
-export declare const mergeObjects: <T extends GenericObject>(...objects: T[]) => T;
-/**
- * * Deeply merge objects and flatten nested objects.
- * * Useful for flattening a single object or merging multiple objects with duplicate key(s).
- * * If keys are duplicated, the last object's value will be used.
- *
- * @param objects Objects to merge.
- * @returns Merged object with flattened structure.
- */
-export declare const mergeAndFlattenObjects: <T extends GenericObject>(...objects: T[]) => GenericObject;
-/**
- * * Flattens a nested object into a dot notation format.
- *
- * @param object - The `object` to flatten.
- * @returns A `flattened object` with dot notation keys.
- */
-export declare const flattenObject: <T extends GenericObject>(object: T) => GenericObject;
-/**
- * * Deeply compare two values (arrays, objects, or primitive values).
- *
- * @param a First value to compare.
- * @param b Second value to compare.
- * @returns Whether the values are deeply equal.
- */
-export declare const isDeepEqual: <T>(a: T, b: T) => boolean;
+export declare const isObject: (data: unknown) => boolean;
 //# sourceMappingURL=basics.d.ts.map

package/dist/object/basics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/object/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,WAChD,CAAC,KACP,MA4BF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,CAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,OAE/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAEnE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,aAAa,UAC5C,CAAC,KACP,aA6BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/object/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,WAChD,CAAC,KACP,MA4BF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,CAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,OAE/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAEnE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,SAAU,OAAO,KAAG,OAExC,CAAC"}

package/dist/object/basics.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDeepEqual = exports.flattenObject = exports.mergeAndFlattenObjects = exports.mergeObjects = exports.countObjectFields = exports.isEmptyObject = exports.cloneObject = exports.generateQueryParams = void 0;
+exports.isObject = exports.countObjectFields = exports.isEmptyObject = exports.cloneObject = exports.generateQueryParams = void 0;
 /**
  * * Utility to generate query parameters from an object.
  *
@@ -46,7 +46,7 @@ exports.cloneObject = cloneObject;
  * @returns Whether the object is empty.
  */
 const isEmptyObject = (obj) => {
-    return Object.keys(obj).length === 0 && obj.constructor === Object;
+    return (0, exports.countObjectFields)(obj) === 0;
 };
 exports.isEmptyObject = isEmptyObject;
 /**
@@ -60,137 +60,12 @@ const countObjectFields = (obj) => {
 };
 exports.countObjectFields = countObjectFields;
 /**
- * * Deeply merge two or more objects using `Map`.
+ * * Check whether data is object and not array.
  *
- * @param objects Objects to merge.
- * @returns Merged object.
+ * @param data Data to check if its an object and not array.
+ * @returns Boolean: `true` if it's an object, `false` if not.
  */
-const mergeObjects = (...objects) => {
-    const map = new Map();
-    objects.forEach((obj) => {
-        for (const key in obj) {
-            const existingValue = map.get(key);
-            if (obj[key] instanceof Object && !Array.isArray(obj[key])) {
-                // If the key already exists in the map and both are objects, merge them
-                if (existingValue &&
-                    existingValue instanceof Object &&
-                    !Array.isArray(existingValue)) {
-                    map.set(key, (0, exports.mergeObjects)(existingValue, obj[key]));
-                }
-                else {
-                    // Otherwise, just set the value
-                    map.set(key, obj[key]);
-                }
-            }
-            else {
-                // If it's not an object, just set the value
-                map.set(key, obj[key]);
-            }
-        }
-    });
-    const result = {};
-    map.forEach((value, key) => {
-        result[key] = value;
-    });
-    return result;
+const isObject = (data) => {
+    return typeof data === 'object' && !Array.isArray(data);
 };
-exports.mergeObjects = mergeObjects;
-/**
- * * Deeply merge objects and flatten nested objects.
- * * Useful for flattening a single object or merging multiple objects with duplicate key(s).
- * * If keys are duplicated, the last object's value will be used.
- *
- * @param objects Objects to merge.
- * @returns Merged object with flattened structure.
- */
-const mergeAndFlattenObjects = (...objects) => {
-    const map = new Map();
-    const _flattenObject = (obj, parentKey = '') => {
-        for (const key in obj) {
-            const newKey = parentKey ? `${String(parentKey)}.${key}` : key;
-            if (obj[key] instanceof Object && !Array.isArray(obj[key])) {
-                // Recursively flatten nested objects
-                _flattenObject(obj[key], newKey);
-            }
-            else {
-                // Set the flattened key
-                map.set(newKey, obj[key]);
-            }
-        }
-    };
-    objects.forEach((obj) => _flattenObject(obj));
-    const result = {};
-    map.forEach((value, key) => {
-        result[key] = value;
-    });
-    return result;
-};
-exports.mergeAndFlattenObjects = mergeAndFlattenObjects;
-/**
- * * Flattens a nested object into a dot notation format.
- *
- * @param object - The `object` to flatten.
- * @returns A `flattened object` with dot notation keys.
- */
-const flattenObject = (object) => {
-    /**
-     * * Recursively flattens an object, transforming nested structures into dot-notation keys.
-     *
-     * @param source - The `object` to be flattened.
-     * @param prefix - The prefix to prepend to each key. Used for nested objects.
-     * @returns A flattened version of the input object.
-     */
-    const _flattenObject = (source, prefix = '') => {
-        const flattened = {};
-        for (const [key, value] of Object.entries(source)) {
-            // Construct the dot-notation key
-            const newKey = prefix ? `${String(prefix)}.${key}` : key;
-            if (value && typeof value === 'object' && !Array.isArray(value)) {
-                // Recursively process nested objects
-                Object.assign(flattened, _flattenObject(value, newKey));
-            }
-            else {
-                // Directly assign non-object values
-                flattened[newKey] = value;
-            }
-        }
-        return flattened;
-    };
-    // Call the recursive function with an empty prefix initially
-    return _flattenObject(object);
-};
-exports.flattenObject = flattenObject;
-/**
- * * Deeply compare two values (arrays, objects, or primitive values).
- *
- * @param a First value to compare.
- * @param b Second value to compare.
- * @returns Whether the values are deeply equal.
- */
-const isDeepEqual = (a, b) => {
-    // If both values are strictly equal (handles primitive types and same references)
-    if (a === b)
-        return true;
-    // If the types of the two values are different
-    if (typeof a !== typeof b)
-        return false;
-    // If either is null or undefined, they must both be null or undefined
-    if (a === null || b === null)
-        return a === b;
-    // Check for array equality
-    if (Array.isArray(a) && Array.isArray(b)) {
-        if (a.length !== b.length)
-            return false;
-        return a.every((element, index) => (0, exports.isDeepEqual)(element, b[index]));
-    }
-    // Check for object equality
-    if (typeof a === 'object' && typeof b === 'object') {
-        const aKeys = Object.keys(a);
-        const bKeys = Object.keys(b);
-        if (aKeys.length !== bKeys.length)
-            return false;
-        return aKeys.every((key) => (0, exports.isDeepEqual)(a[key], b[key]));
-    }
-    return false;
-};
-exports.isDeepEqual = isDeepEqual;
+exports.isObject = isObject;

package/dist/object/objectify.d.ts

@@ -0,0 +1,49 @@
+import type { GenericObject, LooseObject } from './types';
+/**
+ * * Deeply merge two or more objects using `Map`.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object.
+ */
+export declare const mergeObjects: <T extends GenericObject>(...objects: T[]) => T;
+/**
+ * * Deeply merge objects and flatten nested objects.
+ * * Useful for flattening a single object or merging multiple objects with duplicate key(s).
+ * * If keys are duplicated, the last object's value will be used.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object with flattened structure.
+ */
+export declare const mergeAndFlattenObjects: <T extends GenericObject>(...objects: T[]) => GenericObject;
+/**
+ * * Flattens a nested object into a dot notation format.
+ *
+ * @param object - The `object` to flatten.
+ * @returns A `flattened object` with dot notation keys.
+ */
+export declare const flattenObject: <T extends GenericObject>(object: T) => GenericObject;
+/**
+ * * Extracts only the fields that have changed between the original and updated object.
+ *
+ * @param baseObject The original object to compare against.
+ * @param updatedObject The modified object containing potential updates.
+ * @returns A new object containing only the changed fields.
+ */
+export declare const extractUpdatedFields: <T extends LooseObject>(baseObject: T, updatedObject: Partial<T>) => Partial<T>;
+/**
+ * * Extracts only new fields that exist in updatedObject but not in baseObject.
+ *
+ * @param baseObject The original object to compare against.
+ * @param updatedObject The modified object containing potential new fields.
+ * @returns A new object containing only the new fields.
+ */
+export declare const extractNewFields: <T extends LooseObject>(baseObject: T, updatedObject: Partial<T>) => Partial<T>;
+/**
+ * * Extracts changed fields from the updated object while also identifying newly added keys.
+ *
+ * @param baseObject The original object to compare against.
+ * @param updatedObject The modified object containing potential updates.
+ * @returns An object containing modified fields and new fields separately.
+ */
+export declare const extractUpdatedAndNewFields: <T extends LooseObject>(baseObject: T, updatedObject: Partial<T> & LooseObject) => Partial<T> & LooseObject;
+//# sourceMappingURL=objectify.d.ts.map

package/dist/object/objectify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../src/object/objectify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,aAAa,UAC5C,CAAC,KACP,aA6BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,WAAW,cAC7C,CAAC,iBACE,OAAO,CAAC,CAAC,CAAC,KACvB,OAAO,CAAC,CAAC,CAwBX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,WAAW,cACzC,CAAC,iBACE,OAAO,CAAC,CAAC,CAAC,KACvB,OAAO,CAAC,CAAC,CAqBX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,WAAW,cACnD,CAAC,iBACE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,KACrC,OAAO,CAAC,CAAC,CAAC,GAAG,WAwBf,CAAC"}

package/dist/object/objectify.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractUpdatedFields = exports.flattenObject = exports.mergeAndFlattenObjects = exports.mergeObjects = void 0;
+const utils_1 = require("../utils");
+const basics_1 = require("./basics");
+/**
+ * * Deeply merge two or more objects using `Map`.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object.
+ */
+const mergeObjects = (...objects) => {
+    const map = new Map();
+    objects.forEach((obj) => {
+        for (const key in obj) {
+            const existingValue = map.get(key);
+            if (obj[key] instanceof Object && !Array.isArray(obj[key])) {
+                // If the key already exists in the map and both are objects, merge them
+                if (existingValue &&
+                    existingValue instanceof Object &&
+                    !Array.isArray(existingValue)) {
+                    map.set(key, (0, exports.mergeObjects)(existingValue, obj[key]));
+                }
+                else {
+                    // Otherwise, just set the value
+                    map.set(key, obj[key]);
+                }
+            }
+            else {
+                // If it's not an object, just set the value
+                map.set(key, obj[key]);
+            }
+        }
+    });
+    const result = {};
+    map.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+};
+exports.mergeObjects = mergeObjects;
+/**
+ * * Deeply merge objects and flatten nested objects.
+ * * Useful for flattening a single object or merging multiple objects with duplicate key(s).
+ * * If keys are duplicated, the last object's value will be used.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object with flattened structure.
+ */
+const mergeAndFlattenObjects = (...objects) => {
+    const map = new Map();
+    const _flattenObject = (obj, parentKey = '') => {
+        for (const key in obj) {
+            const newKey = parentKey ? `${String(parentKey)}.${key}` : key;
+            if (obj[key] instanceof Object && !Array.isArray(obj[key])) {
+                // Recursively flatten nested objects
+                _flattenObject(obj[key], newKey);
+            }
+            else {
+                // Set the flattened key
+                map.set(newKey, obj[key]);
+            }
+        }
+    };
+    objects.forEach((obj) => _flattenObject(obj));
+    const result = {};
+    map.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+};
+exports.mergeAndFlattenObjects = mergeAndFlattenObjects;
+/**
+ * * Flattens a nested object into a dot notation format.
+ *
+ * @param object - The `object` to flatten.
+ * @returns A `flattened object` with dot notation keys.
+ */
+const flattenObject = (object) => {
+    /**
+     * * Recursively flattens an object, transforming nested structures into dot-notation keys.
+     *
+     * @param source - The `object` to be flattened.
+     * @param prefix - The prefix to prepend to each key. Used for nested objects.
+     * @returns A flattened version of the input object.
+     */
+    const _flattenObject = (source, prefix = '') => {
+        const flattened = {};
+        for (const [key, value] of Object.entries(source)) {
+            // Construct the dot-notation key
+            const newKey = prefix ? `${String(prefix)}.${key}` : key;
+            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                // Recursively process nested objects
+                Object.assign(flattened, _flattenObject(value, newKey));
+            }
+            else {
+                // Directly assign non-object values
+                flattened[newKey] = value;
+            }
+        }
+        return flattened;
+    };
+    // Call the recursive function with an empty prefix initially
+    return _flattenObject(object);
+};
+exports.flattenObject = flattenObject;
+/**
+ * * Extracts only the fields that have changed between the original and updated object.
+ *
+ * @param baseObject The original object to compare against.
+ * @param updatedObject The modified object containing potential updates.
+ * @returns A new object containing only the changed fields.
+ */
+const extractUpdatedFields = (baseObject, updatedObject) => {
+    const updatedFields = {};
+    for (const key in updatedObject) {
+        if (key in baseObject &&
+            !(0, utils_1.isDeepEqual)(updatedObject[key], baseObject[key])) {
+            if (updatedObject[key] && (0, basics_1.isObject)(updatedObject[key])) {
+                updatedFields[key] = (0, exports.extractUpdatedFields)(baseObject[key], updatedObject[key]);
+                if (updatedFields[key] && (0, basics_1.isEmptyObject)(updatedFields[key])) {
+                    delete updatedFields[key];
+                }
+            }
+            else {
+                updatedFields[key] = updatedObject[key];
+            }
+        }
+    }
+    return updatedFields;
+};
+exports.extractUpdatedFields = extractUpdatedFields;
+/**
+ * * Extracts only new fields that exist in updatedObject but not in baseObject.
+ *
+ * @param baseObject The original object to compare against.
+ * @param updatedObject The modified object containing potential new fields.
+ * @returns A new object containing only the new fields.
+ */
+const extractNewFields = (baseObject, updatedObject) => {
+    const newFields = {};
+    for (const key in updatedObject) {
+        if (!(key in baseObject)) {
+            // Directly assign new fields
+            newFields[key] = updatedObject[key];
+        }
+        else if ((0, basics_1.isObject)(updatedObject[key]) && (0, basics_1.isObject)(baseObject[key])) {
+            // Recursively extract new fields inside nested objects
+            const nestedNewFields = (0, exports.extractNewFields)(baseObject[key], updatedObject[key]);
+            if (!(0, basics_1.isEmptyObject)(nestedNewFields)) {
+                newFields[key] = nestedNewFields;
+            }
+        }
+    }
+    return newFields;
+};
+exports.extractNewFields = extractNewFields;
+/**
+ * * Extracts changed fields from the updated object while also identifying newly added keys.
+ *
+ * @param baseObject The original object to compare against.
+ * @param updatedObject The modified object containing potential updates.
+ * @returns An object containing modified fields and new fields separately.
+ */
+const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
+    const updatedFields = {};
+    const newFields = {};
+    for (const key in updatedObject) {
+        if (!(key in baseObject)) {
+            newFields[key] = updatedObject[key];
+        }
+        else if (!(0, utils_1.isDeepEqual)(updatedObject[key], baseObject[key])) {
+            if (updatedObject[key] && (0, basics_1.isObject)(updatedObject[key])) {
+                updatedFields[key] = (0, exports.extractUpdatedAndNewFields)(baseObject[key], updatedObject[key]);
+                if (updatedFields[key] && (0, basics_1.isEmptyObject)(updatedFields[key])) {
+                    delete updatedFields[key];
+                }
+            }
+            else {
+                updatedFields[key] = updatedObject[key];
+            }
+        }
+    }
+    return { ...updatedFields, ...newFields };
+};
+exports.extractUpdatedAndNewFields = extractUpdatedAndNewFields;

package/dist/object/types.d.ts

@@ -1,5 +1,7 @@
-/** - Generic object type */
+/** - Generic object with `unknown` value */
 export type GenericObject = Record<string, unknown>;
+/** - Generic object but with `any` value */
+export type LooseObject = Record<string, any>;
 /** - Query object type `Record<string, string | number | string[] | number[]` */
 export type QueryObject = Record<string, string | number | null | undefined | (string | number | null | undefined)[]>;
 /** - Dot-notation keys for nested objects */

package/dist/object/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * * Deeply compare two values (arrays, objects, or primitive values).
+ *
+ * @param a First value to compare.
+ * @param b Second value to compare.
+ * @returns Whether the values are deeply equal.
+ */
+export declare const isDeepEqual: <T>(a: T, b: T) => boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDeepEqual = void 0;
+/**
+ * * Deeply compare two values (arrays, objects, or primitive values).
+ *
+ * @param a First value to compare.
+ * @param b Second value to compare.
+ * @returns Whether the values are deeply equal.
+ */
+const isDeepEqual = (a, b) => {
+    // If both values are strictly equal (handles primitive types and same references)
+    if (a === b)
+        return true;
+    // If the types of the two values are different
+    if (typeof a !== typeof b)
+        return false;
+    // If either is null or undefined, they must both be null or undefined
+    if (a === null || b === null)
+        return a === b;
+    // Check for array equality
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((element, index) => (0, exports.isDeepEqual)(element, b[index]));
+    }
+    // Check for object equality
+    if (typeof a === 'object' && typeof b === 'object') {
+        const aKeys = Object.keys(a);
+        const bKeys = Object.keys(b);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every((key) => (0, exports.isDeepEqual)(a[key], b[key]));
+    }
+    return false;
+};
+exports.isDeepEqual = isDeepEqual;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",