nhb-toolbox 1.5.1 → 1.6.6

package/dist/colors/convert.d.ts

@@ -1,4 +1,4 @@
-import type { ColorNumbers, Hex, HSL, RGB } from './types';
+import type { Hex, HSL, RGB } from './types';
 /**
  * * Converts HSL to RGB color format.
  *
@@ -39,9 +39,10 @@ export declare const convertHexToHsl: (hex: Hex | string) => HSL;
  * @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) => Hex;
+export declare const convertRgbToHex: (r: number, g: number, b: number, a?: number) => Hex;
 /**
  * * Converts Hex to RGB color format.
  *
@@ -49,14 +50,6 @@ export declare const convertRgbToHex: (r: number, g: number, b: number) => Hex;
  * @returns A string representing the color in RGB format (e.g., `rgb(255, 0, 0)`).
  */
 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.
  *

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

@@ -1 +1 @@
-{"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;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAKjE,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"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/colors/convert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;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;;;;;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,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractNumbersFromColor = exports.convertHexToRgb = exports.convertRgbToHex = exports.convertHexToHsl = exports.convertHslToHex = exports.convertRgbToHsl = exports.convertHslToRgb = void 0;
+exports.convertHexToRgb = exports.convertRgbToHex = exports.convertHexToHsl = exports.convertHslToHex = exports.convertRgbToHsl = exports.convertHslToRgb = void 0;
 exports.convertColorCode = convertColorCode;
+const helpers_1 = require("./helpers");
 /**
  * * Converts HSL to RGB color format.
  *
@@ -110,13 +111,21 @@ exports.convertHexToHsl = convertHexToHsl;
  * @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 `#${[r, g, b]
+const convertRgbToHex = (r, g, b, a) => {
+    let hex = [r, g, b]
         .map((v) => v.toString(16).padStart(2, '0'))
         .join('')
-        .toUpperCase()}`;
+        .toUpperCase();
+    if (a !== undefined) {
+        const alphaHex = Math.round(a * 255)
+            .toString(16)
+            .padStart(2, '0');
+        hex += alphaHex;
+    }
+    return `#${hex}`;
 };
 exports.convertRgbToHex = convertRgbToHex;
 /**
@@ -140,17 +149,6 @@ const convertHexToRgb = (hex) => {
     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.
  *
@@ -167,18 +165,15 @@ function convertColorCode(color) {
     }
     if (color.startsWith('rgb')) {
         return {
-            hex: (0, exports.convertRgbToHex)(...(0, exports.extractNumbersFromColor)(color)),
-            hsl: (0, exports.convertRgbToHsl)(...(0, exports.extractNumbersFromColor)(color)),
+            hex: (0, exports.convertRgbToHex)(...(0, helpers_1.extractNumbersFromColor)(color)),
+            hsl: (0, exports.convertRgbToHsl)(...(0, helpers_1.extractNumbersFromColor)(color)),
         };
     }
     if (color.startsWith('hsl')) {
         return {
-            hex: (0, exports.convertHslToHex)(...(0, exports.extractNumbersFromColor)(color)),
-            rgb: (0, exports.convertHslToRgb)(...(0, exports.extractNumbersFromColor)(color)),
+            hex: (0, exports.convertHslToHex)(...(0, helpers_1.extractNumbersFromColor)(color)),
+            rgb: (0, exports.convertHslToRgb)(...(0, helpers_1.extractNumbersFromColor)(color)),
         };
     }
     throw new Error(`Unrecognized Color Format: ${color}`);
 }
-console.info(convertColorCode('#3c6945'));
-console.info(convertColorCode('rgb(60, 105, 69)'));
-console.info(convertColorCode('hsl(132, 27.27%, 32.35%)'));

package/dist/colors/helpers.d.ts

@@ -1,24 +1,24 @@
-import type { OpacityValue } from './types';
+import type { ColorNumbers, HSL, OpacityValue, RGB } from './types';
 /**
  * * Converts opacity percentage (0-100) to a 2-digit hex string.
  *
  * @param opacity - The opacity value as a percentage (0-100).
  * @returns A 2-digit hex string representing the alpha value.
  */
-export declare const convertOpacityToHex: (opacity: OpacityValue) => string;
+export declare const _convertOpacityToHex: (opacity: OpacityValue) => string;
 /**
  * * Applies an opacity value to a color string.
  * @param color The color string to apply opacity to.
  * @param opacity The opacity value as a percentage (0-100).
  * @returns The color string with the opacity value applied.
  */
-export declare const applyOpacity: (color: string, opacity: string) => string;
+export declare const _applyOpacity: (color: string, opacity: string) => string;
 /**
  * * Helper function to generate a random HSL color.
  *
  * @returns A random HSL color string.
  */
-export declare const generateColorHSL: () => string;
+export declare const _generateRandomHSL: () => HSL;
 /**
  * * Helper function to check if the new color is visually too similar to the previous one.
  * * It compares the hue, saturation, and lightness difference between the new color and the last one generated.
@@ -27,5 +27,13 @@ export declare const generateColorHSL: () => string;
  * @param newColor - The new color to compare.
  * @returns `Boolean` : `true` if the new color is similar to the previous one.
  */
-export declare const isSimilarToLast: (recentColors: string[], newColor: string) => boolean;
+export declare const _isSimilarToLast: (recentColors: string[], newColor: string) => boolean;
+/**
+ * * 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;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/colors/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAa,YAAY,KAAG,MAO3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,UAAW,MAAM,WAAW,MAAM,KAAG,MAE7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAKnC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,iBACb,MAAM,EAAE,YACZ,MAAM,KACd,OA2BF,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/colors/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,YAAY,KAAG,MAO5D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAAW,MAAM,WAAW,MAAM,KAAG,MAE9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,GAKrC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,iBACd,MAAM,EAAE,YACZ,MAAM,KACd,OA2BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,gBACtB,GAAG,GAAG,GAAG,KACpB,YAIF,CAAC"}

package/dist/colors/helpers.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSimilarToLast = exports.generateColorHSL = exports.applyOpacity = exports.convertOpacityToHex = void 0;
+exports.extractNumbersFromColor = exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = exports._convertOpacityToHex = void 0;
 /**
  * * Converts opacity percentage (0-100) to a 2-digit hex string.
  *
  * @param opacity - The opacity value as a percentage (0-100).
  * @returns A 2-digit hex string representing the alpha value.
  */
-const convertOpacityToHex = (opacity) => {
+const _convertOpacityToHex = (opacity) => {
     // Ensure opacity is between 0 and 100
     const validOpacity = Math.min(100, Math.max(0, opacity));
     // Convert to a value between 0 and 255, then to a hex string
@@ -15,29 +15,29 @@ const convertOpacityToHex = (opacity) => {
     // Ensure it's 2 digits (e.g., 0x0A instead of 0xA)
     return alpha.toString(16).padStart(2, '0').toUpperCase();
 };
-exports.convertOpacityToHex = convertOpacityToHex;
+exports._convertOpacityToHex = _convertOpacityToHex;
 /**
  * * Applies an opacity value to a color string.
  * @param color The color string to apply opacity to.
  * @param opacity The opacity value as a percentage (0-100).
  * @returns The color string with the opacity value applied.
  */
-const applyOpacity = (color, opacity) => {
+const _applyOpacity = (color, opacity) => {
     return color.concat(opacity);
 };
-exports.applyOpacity = applyOpacity;
+exports._applyOpacity = _applyOpacity;
 /**
  * * Helper function to generate a random HSL color.
  *
  * @returns A random HSL color string.
  */
-const generateColorHSL = () => {
+const _generateRandomHSL = () => {
     const hue = Math.floor(Math.random() * 360);
     const saturation = 75 + Math.floor(Math.random() * 25);
     const lightness = 50 + Math.floor(Math.random() * 15);
     return `hsl(${hue}, ${saturation}%, ${lightness}%)`;
 };
-exports.generateColorHSL = generateColorHSL;
+exports._generateRandomHSL = _generateRandomHSL;
 /**
  * * Helper function to check if the new color is visually too similar to the previous one.
  * * It compares the hue, saturation, and lightness difference between the new color and the last one generated.
@@ -46,7 +46,7 @@ exports.generateColorHSL = generateColorHSL;
  * @param newColor - The new color to compare.
  * @returns `Boolean` : `true` if the new color is similar to the previous one.
  */
-const isSimilarToLast = (recentColors, newColor) => {
+const _isSimilarToLast = (recentColors, newColor) => {
     if (recentColors.length === 0)
         return false;
     const newHSL = newColor.match(/hsl\((\d+), (\d+)%, (\d+)%\)/);
@@ -66,4 +66,15 @@ const isSimilarToLast = (recentColors, newColor) => {
         saturationDifference < 24 &&
         lightnessDifference < 16);
 };
-exports.isSimilarToLast = isSimilarToLast;
+exports._isSimilarToLast = _isSimilarToLast;
+/**
+ * * 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;

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

@@ -1 +1 @@
-{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/colors/initials.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGzE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,CAAC;AAEV;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,EAAE,CAAC"}
+{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/colors/initials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,CAAC;AAEV;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,EAAE,CAAC"}

package/dist/colors/initials.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getColorForInitial = getColorForInitial;
-const helpers_1 = require("./helpers");
 const constants_1 = require("./constants");
+const helpers_1 = require("./helpers");
 /**
  *  * Generates a hex color based on the first character (initial) of a string or number; or an array of hex colors based on the first character (initial) of an array of strings/numbers or even nested arrays of strings/numbers.
  *
@@ -16,38 +16,38 @@ const constants_1 = require("./constants");
  */
 function getColorForInitial(input = '', opacity = 100) {
     let initial;
-    const hexOpacity = (0, helpers_1.convertOpacityToHex)(opacity);
+    const hexOpacity = (0, helpers_1._convertOpacityToHex)(opacity);
     const numbers = '0123456789';
     // Handle empty string case
     if (!input)
-        return (0, helpers_1.applyOpacity)('#010514', hexOpacity);
+        return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
     // Handle string input
     if (typeof input === 'string') {
         initial = input[0];
         // Handle number as string
         if (numbers.includes(initial)) {
-            return (0, helpers_1.applyOpacity)(constants_1.numberColorPalette[parseInt(initial, 10)], hexOpacity);
+            return (0, helpers_1._applyOpacity)(constants_1.numberColorPalette[parseInt(initial, 10)], hexOpacity);
         }
         const upperInitial = initial.toUpperCase();
         const index = upperInitial.charCodeAt(0) - 'A'.charCodeAt(0);
         // Validate alphabet
         if (index >= 0 && index < constants_1.alphabetColorPalette.length) {
-            return (0, helpers_1.applyOpacity)(constants_1.alphabetColorPalette[index], hexOpacity);
+            return (0, helpers_1._applyOpacity)(constants_1.alphabetColorPalette[index], hexOpacity);
         }
-        return (0, helpers_1.applyOpacity)('#010514', hexOpacity);
+        return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
         // Handle number input
     }
     else if (typeof input === 'number' && !isNaN(input)) {
         initial = input.toString()[0];
         if (numbers.includes(initial)) {
-            return (0, helpers_1.applyOpacity)(constants_1.numberColorPalette[parseInt(initial, 10)], hexOpacity);
+            return (0, helpers_1._applyOpacity)(constants_1.numberColorPalette[parseInt(initial, 10)], hexOpacity);
         }
-        return (0, helpers_1.applyOpacity)('#010514', hexOpacity);
+        return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
         // Handle array of strings/numbers
     }
     else if (Array.isArray(input)) {
         if (input.length < 1)
-            return [...constants_1.alphabetColorPalette, ...constants_1.numberColorPalette].map((color) => (0, helpers_1.applyOpacity)(color, hexOpacity));
+            return [...constants_1.alphabetColorPalette, ...constants_1.numberColorPalette].map((color) => (0, helpers_1._applyOpacity)(color, hexOpacity));
         return input
             .map((el) => {
             if (Array.isArray(el)) {
@@ -57,5 +57,5 @@ function getColorForInitial(input = '', opacity = 100) {
         })
             .flat();
     }
-    return (0, helpers_1.applyOpacity)('#010514', hexOpacity);
+    return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
 }

package/dist/colors/random.d.ts

@@ -1,7 +1,19 @@
+import type { Hex, HSL, RGB } from './types';
 /**
  * * Utility to generate a unique random HSL color.
- * @param maxColors - The maximum number of recent colors to store in memory.
- * @returns Generated unique random color.
+ *
+ * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
+ * @returns Generated unique random color in `HSL` format.
  */
-export declare const generateRandomColor: (maxColors?: number) => string;
+export declare const generateRandomHSLColor: (maxColors?: number) => HSL;
+/**
+ * * Utility to generate a unique random color in Hex and RGB format.
+ *
+ * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
+ * @returns An object of generated unique random color in both `Hex` and `RGB` formats.
+ */
+export declare const generateRandomColorInHexRGB: (maxColors?: number) => {
+    hex: Hex;
+    rgb: RGB;
+};
 //# sourceMappingURL=random.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/colors/random.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,eAAe,MAAM,KAAQ,MAqB5D,CAAC"}
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/colors/random.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAQ7C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,eAAe,MAAM,KAAQ,GAqB/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,eAC5B,MAAM,KACf;IACF,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CAGT,CAAC"}

package/dist/colors/random.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateRandomColor = void 0;
+exports.generateRandomColorInHexRGB = exports.generateRandomHSLColor = void 0;
+const convert_1 = require("./convert");
 const helpers_1 = require("./helpers");
 /** Track previously generated colors. */
 const generatedColors = new Set();
@@ -8,16 +9,17 @@ const generatedColors = new Set();
 const recentColors = [];
 /**
  * * Utility to generate a unique random HSL color.
- * @param maxColors - The maximum number of recent colors to store in memory.
- * @returns Generated unique random color.
+ *
+ * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
+ * @returns Generated unique random color in `HSL` format.
  */
-const generateRandomColor = (maxColors = 16) => {
+const generateRandomHSLColor = (maxColors = 16) => {
     let color;
     // Keep generating until a unique color is found that is also different from the last one
     do {
-        color = (0, helpers_1.generateColorHSL)();
+        color = (0, helpers_1._generateRandomHSL)();
     } while (generatedColors.has(color) ||
-        (0, helpers_1.isSimilarToLast)(recentColors, color));
+        (0, helpers_1._isSimilarToLast)(recentColors, color));
     // Add the newly generated color to the set and recent colors
     generatedColors.add(color);
     recentColors.push(color);
@@ -27,4 +29,14 @@ const generateRandomColor = (maxColors = 16) => {
     }
     return color;
 };
-exports.generateRandomColor = generateRandomColor;
+exports.generateRandomHSLColor = generateRandomHSLColor;
+/**
+ * * Utility to generate a unique random color in Hex and RGB format.
+ *
+ * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
+ * @returns An object of generated unique random color in both `Hex` and `RGB` formats.
+ */
+const generateRandomColorInHexRGB = (maxColors = 16) => {
+    return (0, convert_1.convertColorCode)((0, exports.generateRandomHSLColor)(maxColors));
+};
+exports.generateRandomColorInHexRGB = generateRandomColorInHexRGB;

package/dist/colors/types.d.ts

@@ -7,7 +7,7 @@ export interface ColorInputArray extends Array<ColorInput | ColorInputArray> {
 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`
+ * * Format: `#3C6945`
  */
 export type Hex = `#${string}`;
 /**

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;AAEP;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,IAAI,CAAC;AAE3D,oEAAoE;AACpE,MAAM,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEpC,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,KAAK,CAC/C,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;CACjC"}
+{"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;AAEP;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,IAAI,CAAC;AAM3D,oEAAoE;AACpE,MAAM,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEpC,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,KAAK,CAC/C,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;CACjC"}

package/dist/index.d.ts

@@ -2,12 +2,15 @@ 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, convertColorCode, extractNumbersFromColor, } from './colors/convert';
+export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
+export { convertColorCode, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
+export { extractNumbersFromColor } from './colors/helpers';
 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,EACf,gBAAgB,EAChB,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,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,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,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.extractNumbersFromColor = exports.convertColorCode = 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.generateRandomHSLColor = exports.generateRandomColorInHexRGB = 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,21 +14,23 @@ 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; } });
+Object.defineProperty(exports, "generateRandomColorInHexRGB", { enumerable: true, get: function () { return random_1.generateRandomColorInHexRGB; } });
+Object.defineProperty(exports, "generateRandomHSLColor", { enumerable: true, get: function () { return random_1.generateRandomHSLColor; } });
 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, "convertColorCode", { enumerable: true, get: function () { return convert_2.convertColorCode; } });
-Object.defineProperty(exports, "extractNumbersFromColor", { enumerable: true, get: function () { return convert_2.extractNumbersFromColor; } });
+var helpers_1 = require("./colors/helpers");
+Object.defineProperty(exports, "extractNumbersFromColor", { enumerable: true, get: function () { return helpers_1.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; } });
@@ -37,13 +39,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.5.1",
+  "version": "1.6.6",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",