nhb-toolbox 0.9.9 → 1.0.0

package/dist/index.d.ts

@@ -4,5 +4,5 @@ export { getColorForFirstCharacter } from './colors';
 export { generateRandomColor } from './colors/random';
 export { convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
 export { flattenArray, createSelectOptions } from './array';
-export { generateQueryParams } from './object';
+export { generateQueryParams, deepClone, deepEqual, mergeObjects, flattenObject, isEmptyObject, countObjectFields, } from './object';
 //# 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,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAErD,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,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAErD,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,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE5D,OAAO,EACN,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,iBAAiB,GACjB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateQueryParams = exports.createSelectOptions = exports.flattenArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForFirstCharacter = exports.convertToDecimal = exports.getRandomNumber = exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
+exports.countObjectFields = exports.isEmptyObject = exports.flattenObject = exports.mergeObjects = exports.deepEqual = exports.deepClone = exports.generateQueryParams = exports.createSelectOptions = exports.flattenArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForFirstCharacter = exports.convertToDecimal = exports.getRandomNumber = exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
 var string_1 = require("./string");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return string_1.capitalizeString; } });
 Object.defineProperty(exports, "truncateString", { enumerable: true, get: function () { return string_1.truncateString; } });
@@ -24,3 +24,9 @@ Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function
 Object.defineProperty(exports, "createSelectOptions", { enumerable: true, get: function () { return array_1.createSelectOptions; } });
 var object_1 = require("./object");
 Object.defineProperty(exports, "generateQueryParams", { enumerable: true, get: function () { return object_1.generateQueryParams; } });
+Object.defineProperty(exports, "deepClone", { enumerable: true, get: function () { return object_1.deepClone; } });
+Object.defineProperty(exports, "deepEqual", { enumerable: true, get: function () { return object_1.deepEqual; } });
+Object.defineProperty(exports, "mergeObjects", { enumerable: true, get: function () { return object_1.mergeObjects; } });
+Object.defineProperty(exports, "flattenObject", { enumerable: true, get: function () { return object_1.flattenObject; } });
+Object.defineProperty(exports, "isEmptyObject", { enumerable: true, get: function () { return object_1.isEmptyObject; } });
+Object.defineProperty(exports, "countObjectFields", { enumerable: true, get: function () { return object_1.countObjectFields; } });

package/dist/number/index.d.ts

@@ -13,9 +13,7 @@ export declare const getRandomNumber: (options?: RandomNumberOptions) => number;
  *
  * @param num - Number to round.
  * @param options - Options for rounding behavior, including decimal places and return type.
- * @param options.decimalPlaces - Number of decimal places to round to.
- * @param options.isString - Flag to determine if the result should be returned as a string (default: `false`).
- * @returns - Rounded number (as a `number`) or string (if `isString` is `true`).
+ * @returns Converted number (as a `number`) or string (if `isString` is `true`).
  */
 export declare const convertToDecimal: (num: number, options?: DecimalOptions) => number | string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAAc,mBAAmB,KAAG,MA+C/D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,QACvB,MAAM,YACD,cAAc,KACtB,MAAM,GAAG,MAQX,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAAc,mBAAmB,KAAG,MA+C/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QACvB,MAAM,YACD,cAAc,KACtB,MAAM,GAAG,MAQX,CAAC"}

package/dist/number/index.js

@@ -48,15 +48,13 @@ exports.getRandomNumber = getRandomNumber;
  *
  * @param num - Number to round.
  * @param options - Options for rounding behavior, including decimal places and return type.
- * @param options.decimalPlaces - Number of decimal places to round to.
- * @param options.isString - Flag to determine if the result should be returned as a string (default: `false`).
- * @returns - Rounded number (as a `number`) or string (if `isString` is `true`).
+ * @returns Converted number (as a `number`) or string (if `isString` is `true`).
  */
 const convertToDecimal = (num, options) => {
     const { decimalPlaces = 2, isString = false } = options || {};
     if (isString) {
-        return num.toFixed(decimalPlaces); // Return as string
+        return num.toFixed(decimalPlaces);
     }
-    return parseFloat(num.toFixed(decimalPlaces)); // Return as number
+    return parseFloat(num.toFixed(decimalPlaces));
 };
 exports.convertToDecimal = convertToDecimal;

package/dist/object/index.d.ts

@@ -10,4 +10,47 @@
  * generateQueryParams({ key1: ['value1', 'value2'], key2: 42 }); // "?key1=value1&key1=value2&key2=42"
  */
 export declare const generateQueryParams: <T extends Record<string, string | number | string[] | number[]>>(params?: T) => string;
+/**
+ * * Deep clone an object.
+ *
+ * @param obj Object to clone.
+ * @returns Deep cloned object.
+ */
+export declare const deepClone: <T extends Record<string, unknown>>(obj: T) => T;
+/**
+ * * Check if an object is empty.
+ *
+ * @param obj Object to check.
+ * @returns Whether the object is empty.
+ */
+export declare const isEmptyObject: <T extends Record<string, unknown>>(obj: T) => boolean;
+/**
+ * * Count the number of fields in an object.
+ *
+ * @param obj Object to check.
+ * @returns Number of fields in the object.
+ */
+export declare const countObjectFields: <T extends Record<string, unknown>>(obj: T) => number;
+/**
+ * * Deeply merge two or more objects using `Map`.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object.
+ */
+export declare const mergeObjects: <T extends Record<string, unknown>>(...objects: T[]) => T;
+/**
+ * * Deeply merge objects and flatten nested objects.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object with flattened structure.
+ */
+export declare const flattenObject: <T extends Record<string, unknown>>(...objects: T[]) => T;
+/**
+ * * 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 deepEqual: <T>(a: T, b: T) => boolean;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,WAEvD,CAAC,KACP,MAkBF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,WAEvD,CAAC,KACP,MAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,KAAG,CAErE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OACzD,CAAC,KACJ,OAEF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAC7D,CAAC,KACJ,MAEF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cACjD,CAAC,EAAE,KACb,CAuCF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAClD,CAAC,EAAE,KACb,CAyBF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OAgCzC,CAAC"}

package/dist/object/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateQueryParams = void 0;
+exports.deepEqual = exports.flattenObject = exports.mergeObjects = exports.countObjectFields = exports.isEmptyObject = exports.deepClone = exports.generateQueryParams = void 0;
 /**
  * * Utility function to generate query parameters from an object.
  *
@@ -22,3 +22,132 @@ const generateQueryParams = (params = {}) => {
     return queryParams ? `?${queryParams}` : '';
 };
 exports.generateQueryParams = generateQueryParams;
+/**
+ * * Deep clone an object.
+ *
+ * @param obj Object to clone.
+ * @returns Deep cloned object.
+ */
+const deepClone = (obj) => {
+    return JSON.parse(JSON.stringify(obj));
+};
+exports.deepClone = deepClone;
+/**
+ * * Check if an object is empty.
+ *
+ * @param obj Object to check.
+ * @returns Whether the object is empty.
+ */
+const isEmptyObject = (obj) => {
+    return Object.keys(obj).length === 0;
+};
+exports.isEmptyObject = isEmptyObject;
+/**
+ * * Count the number of fields in an object.
+ *
+ * @param obj Object to check.
+ * @returns Number of fields in the object.
+ */
+const countObjectFields = (obj) => {
+    return Object.keys(obj).length;
+};
+exports.countObjectFields = countObjectFields;
+/**
+ * * 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.
+ *
+ * @param objects Objects to merge.
+ * @returns Merged object with flattened structure.
+ */
+const flattenObject = (...objects) => {
+    const map = new Map();
+    const flattenObject = (obj, parentKey = '') => {
+        for (const key in obj) {
+            const newKey = parentKey ? `${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.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 deepEqual = (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.deepEqual)(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.deepEqual)(a[key], b[key]));
+    }
+    return false;
+};
+exports.deepEqual = deepEqual;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "0.9.9",
+  "version": "1.0.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",