nhb-toolbox 0.9.8 → 1.0.0

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { capitalizeString, truncateString, generateRandomID } from './string';
-export { getRandomNumber } from './number';
+export { getRandomNumber, convertToDecimal } from './number';
 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,MAAM,UAAU,CAAC;AAE3C,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,12 +1,13 @@
 "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.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; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return string_1.generateRandomID; } });
 var number_1 = require("./number");
 Object.defineProperty(exports, "getRandomNumber", { enumerable: true, get: function () { return number_1.getRandomNumber; } });
+Object.defineProperty(exports, "convertToDecimal", { enumerable: true, get: function () { return number_1.convertToDecimal; } });
 var colors_1 = require("./colors");
 Object.defineProperty(exports, "getColorForFirstCharacter", { enumerable: true, get: function () { return colors_1.getColorForFirstCharacter; } });
 var random_1 = require("./colors/random");
@@ -23,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

@@ -1,4 +1,4 @@
-import type { RandomNumberOptions } from './types';
+import type { DecimalOptions, RandomNumberOptions } from './types';
 /**
  * * Utility to generate a random number between a given range.
  * * If no options are provided, it will generate a random number between `0` and `100` (inclusive).
@@ -8,4 +8,12 @@ import type { RandomNumberOptions } from './types';
  * @returns Random number.
  */
 export declare const getRandomNumber: (options?: RandomNumberOptions) => number;
+/**
+ * * Utility to round a number to a given decimal places.
+ *
+ * @param num - Number to round.
+ * @param options - Options for rounding behavior, including decimal places and return type.
+ * @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,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAAc,mBAAmB,KAAG,MA+C/D,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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRandomNumber = void 0;
+exports.convertToDecimal = exports.getRandomNumber = void 0;
 /**
  * * Utility to generate a random number between a given range.
  * * If no options are provided, it will generate a random number between `0` and `100` (inclusive).
@@ -43,3 +43,18 @@ const getRandomNumber = (options) => {
     return 0;
 };
 exports.getRandomNumber = getRandomNumber;
+/**
+ * * Utility to round a number to a given decimal places.
+ *
+ * @param num - Number to round.
+ * @param options - Options for rounding behavior, including decimal places and return type.
+ * @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 parseFloat(num.toFixed(decimalPlaces));
+};
+exports.convertToDecimal = convertToDecimal;

package/dist/number/types.d.ts

@@ -9,4 +9,11 @@ export interface RandomNumberOptions {
     /** Whether to include the maximum number. */
     includeMax?: boolean;
 }
+/** Decimal options for converting to decimal */
+export interface DecimalOptions {
+    /** Number of decimal places to round to. Defaults to `2`. */
+    decimalPlaces?: number;
+    /** If the return value is in `string` or `number`. Defaults to `false`. */
+    isString?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/number/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IACnC,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/number/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IACnC,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC9B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB"}

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.8",
+  "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",