nhb-toolbox 1.7.5 → 1.8.4

package/dist/array/basics.d.ts

@@ -25,4 +25,11 @@ export declare const filterArrayOfObjects: <T extends GenericObject>(array: T[],
  * @returns Whether the array is empty.
  */
 export declare const isValidButEmptyArray: <T>(array: T[] | unknown) => boolean;
+/**
+ * * Shuffle the elements of an array.
+ *
+ * @param array Array to shuffle.
+ * @returns Shuffled array.
+ */
+export declare const shuffleArray: <T>(array: T[]) => T[];
 //# sourceMappingURL=basics.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GAAE,KACvD,CAAC,EAgBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,KAAG,OAE9D,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,GAAE,KACvD,CAAC,EAgBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,KAAG,OAE9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,EAW7C,CAAC"}

package/dist/array/basics.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidButEmptyArray = exports.filterArrayOfObjects = exports.flattenArray = void 0;
+exports.shuffleArray = exports.isValidButEmptyArray = exports.filterArrayOfObjects = exports.flattenArray = void 0;
 /**
  * * Flattens a nested array recursively or wraps any non-array data type in an array.
  *
@@ -51,3 +51,20 @@ const isValidButEmptyArray = (array) => {
     return Array.isArray(array) && array.length === 0;
 };
 exports.isValidButEmptyArray = isValidButEmptyArray;
+/**
+ * * Shuffle the elements of an array.
+ *
+ * @param array Array to shuffle.
+ * @returns Shuffled array.
+ */
+const shuffleArray = (array) => {
+    if ((0, exports.isValidButEmptyArray)(array))
+        return array;
+    const shuffled = structuredClone(array);
+    for (let i = shuffled.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+    }
+    return shuffled;
+};
+exports.shuffleArray = shuffleArray;

package/dist/array/sort.d.ts

@@ -1,4 +1,4 @@
-import type { InputObject, OrderOption, SortOptions } from "./types";
+import type { InputObject, OrderOption, SortOptions } from './types';
 /**
  * * Sorts an array of strings.
  *

package/dist/index.d.ts

@@ -1,14 +1,16 @@
 export { capitalizeString, generateRandomID, trimString, truncateString, } from './string/basics';
 export { generateAnagrams } from './string/anagram';
+export { convertStringCase } from './string/convert';
 export { convertToDecimal, getRandomNumber } from './number/basics';
 export { numberToWords } from './number/convert';
 export { findPrimeNumbers, isPrime } from './number/prime';
+export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
 export { convertColorCode, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
 export { Color } from './colors/Color';
 export { extractNumbersFromColor } from './colors/helpers';
-export { filterArrayOfObjects, flattenArray, isValidButEmptyArray, } from './array/basics';
+export { filterArrayOfObjects, flattenArray, isValidButEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray } from './array/transform';
 export { convertIntoFormData, isEmptyFormData } from './form/convert';
@@ -17,5 +19,5 @@ export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isO
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObject, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';
 export { convertObjectValues } from './object/convert';
-export { isDeepEqual } from './utils';
+export { convertArrayToString, 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,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,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,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"}
+{"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,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,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,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,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,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,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,oBAAoB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.createOptionsArray = exports.sortAnArray = exports.isValidButEmptyArray = exports.flattenArray = exports.filterArrayOfObjects = exports.extractNumbersFromColor = exports.Color = 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;
+exports.isDeepEqual = exports.convertArrayToString = 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.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidButEmptyArray = exports.flattenArray = exports.filterArrayOfObjects = exports.extractNumbersFromColor = exports.Color = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.convertStringCase = 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; } });
@@ -8,27 +8,31 @@ Object.defineProperty(exports, "trimString", { enumerable: true, get: function (
 Object.defineProperty(exports, "truncateString", { enumerable: true, get: function () { return basics_1.truncateString; } });
 var anagram_1 = require("./string/anagram");
 Object.defineProperty(exports, "generateAnagrams", { enumerable: true, get: function () { return anagram_1.generateAnagrams; } });
+var convert_1 = require("./string/convert");
+Object.defineProperty(exports, "convertStringCase", { enumerable: true, get: function () { return convert_1.convertStringCase; } });
 var basics_2 = require("./number/basics");
 Object.defineProperty(exports, "convertToDecimal", { enumerable: true, get: function () { return basics_2.convertToDecimal; } });
 Object.defineProperty(exports, "getRandomNumber", { enumerable: true, get: function () { return basics_2.getRandomNumber; } });
-var convert_1 = require("./number/convert");
-Object.defineProperty(exports, "numberToWords", { enumerable: true, get: function () { return convert_1.numberToWords; } });
+var convert_2 = require("./number/convert");
+Object.defineProperty(exports, "numberToWords", { enumerable: true, get: function () { return convert_2.numberToWords; } });
 var prime_1 = require("./number/prime");
 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 range_1 = require("./number/range");
+Object.defineProperty(exports, "getNumbersInRange", { enumerable: true, get: function () { return range_1.getNumbersInRange; } });
 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, "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; } });
+var convert_3 = require("./colors/convert");
+Object.defineProperty(exports, "convertColorCode", { enumerable: true, get: function () { return convert_3.convertColorCode; } });
+Object.defineProperty(exports, "convertHexToHsl", { enumerable: true, get: function () { return convert_3.convertHexToHsl; } });
+Object.defineProperty(exports, "convertHexToRgb", { enumerable: true, get: function () { return convert_3.convertHexToRgb; } });
+Object.defineProperty(exports, "convertHslToHex", { enumerable: true, get: function () { return convert_3.convertHslToHex; } });
+Object.defineProperty(exports, "convertHslToRgb", { enumerable: true, get: function () { return convert_3.convertHslToRgb; } });
+Object.defineProperty(exports, "convertRgbToHex", { enumerable: true, get: function () { return convert_3.convertRgbToHex; } });
+Object.defineProperty(exports, "convertRgbToHsl", { enumerable: true, get: function () { return convert_3.convertRgbToHsl; } });
 var Color_1 = require("./colors/Color");
 Object.defineProperty(exports, "Color", { enumerable: true, get: function () { return Color_1.Color; } });
 var helpers_1 = require("./colors/helpers");
@@ -37,13 +41,14 @@ var basics_3 = require("./array/basics");
 Object.defineProperty(exports, "filterArrayOfObjects", { enumerable: true, get: function () { return basics_3.filterArrayOfObjects; } });
 Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function () { return basics_3.flattenArray; } });
 Object.defineProperty(exports, "isValidButEmptyArray", { enumerable: true, get: function () { return basics_3.isValidButEmptyArray; } });
+Object.defineProperty(exports, "shuffleArray", { enumerable: true, get: function () { return basics_3.shuffleArray; } });
 var sort_1 = require("./array/sort");
 Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return sort_1.sortAnArray; } });
 var transform_1 = require("./array/transform");
 Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return transform_1.createOptionsArray; } });
-var convert_3 = require("./form/convert");
-Object.defineProperty(exports, "convertIntoFormData", { enumerable: true, get: function () { return convert_3.convertIntoFormData; } });
-Object.defineProperty(exports, "isEmptyFormData", { enumerable: true, get: function () { return convert_3.isEmptyFormData; } });
+var convert_4 = require("./form/convert");
+Object.defineProperty(exports, "convertIntoFormData", { enumerable: true, get: function () { return convert_4.convertIntoFormData; } });
+Object.defineProperty(exports, "isEmptyFormData", { enumerable: true, get: function () { return convert_4.isEmptyFormData; } });
 var transform_2 = require("./form/transform");
 Object.defineProperty(exports, "createControlledFormData", { enumerable: true, get: function () { return transform_2.createControlledFormData; } });
 var basics_4 = require("./object/basics");
@@ -61,7 +66,8 @@ Object.defineProperty(exports, "mergeAndFlattenObjects", { enumerable: true, get
 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_4 = require("./object/convert");
-Object.defineProperty(exports, "convertObjectValues", { enumerable: true, get: function () { return convert_4.convertObjectValues; } });
+var convert_5 = require("./object/convert");
+Object.defineProperty(exports, "convertObjectValues", { enumerable: true, get: function () { return convert_5.convertObjectValues; } });
 var utils_1 = require("./utils");
+Object.defineProperty(exports, "convertArrayToString", { enumerable: true, get: function () { return utils_1.convertArrayToString; } });
 Object.defineProperty(exports, "isDeepEqual", { enumerable: true, get: function () { return utils_1.isDeepEqual; } });

package/dist/number/basics.d.ts

@@ -9,7 +9,7 @@ import type { DecimalOptions, RandomNumberOptions } from './types';
  */
 export declare const getRandomNumber: (options?: RandomNumberOptions) => number;
 /**
- * * Utility to round a number to a given decimal places.
+ * * Utility to round a number to given decimal places.
  *
  * @param num - Number to round.
  * @param options - Options for rounding behavior, including decimal places and return type.

package/dist/number/basics.js

@@ -44,7 +44,7 @@ const getRandomNumber = (options) => {
 };
 exports.getRandomNumber = getRandomNumber;
 /**
- * * Utility to round a number to a given decimal places.
+ * * Utility to round a number to given decimal places.
  *
  * @param num - Number to round.
  * @param options - Options for rounding behavior, including decimal places and return type.

package/dist/number/range.d.ts

@@ -0,0 +1,11 @@
+import type { GetAs, NumberType, RangedNumbers, RangeOptions } from './types';
+/**
+ * * Function to get numbers within a range based on the provided `NumberType` and options.
+ * * Returns either a string or an array of numbers based on the `getAs` property in options.
+ *
+ * @param type - The type of numbers to generate ('random', 'prime', etc.).
+ * @param options - Options to configure number generation, including range and formatting.
+ * @returns Either a string or an array of numbers.
+ */
+export declare function getNumbersInRange<T extends GetAs>(type?: NumberType, options?: RangeOptions<T>): RangedNumbers<T>;
+//# sourceMappingURL=range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/number/range.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,EAChD,IAAI,GAAE,UAAkB,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,aAAa,CAAC,CAAC,CAAC,CAsGlB"}

package/dist/number/range.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNumbersInRange = getNumbersInRange;
+const basics_1 = require("../array/basics");
+const utils_1 = require("../utils");
+const basics_2 = require("./basics");
+const prime_1 = require("./prime");
+/**
+ * * Function to get numbers within a range based on the provided `NumberType` and options.
+ * * Returns either a string or an array of numbers based on the `getAs` property in options.
+ *
+ * @param type - The type of numbers to generate ('random', 'prime', etc.).
+ * @param options - Options to configure number generation, including range and formatting.
+ * @returns Either a string or an array of numbers.
+ */
+function getNumbersInRange(type = 'any', options) {
+    const { getAs = 'array', min = 0, max = 100, includeMin = true, includeMax = true, separator = ',', multiples, } = options || {};
+    let output = [];
+    /**
+     * Apply multiples of a number if there is any.
+     * @param array Array of numbers to apply the condition on.
+     * @param multiples The multiples of which number.
+     * @returns Array of multiples of the desired number
+     */
+    const _applyMultiples = (array, multiples) => {
+        if (!multiples)
+            return array;
+        return array.filter((n) => n % multiples === 0);
+    };
+    /**
+     * Helper function to apply range and get array of numbers in that range.
+     *
+     * @param start The start of the range.
+     * @param end The end of the range.
+     * @returns The array of numbers in the range.
+     */
+    const _applyRangeOptions = (start, end) => {
+        let startNumber = start;
+        let endNumber = end;
+        if (start > end) {
+            [startNumber, endNumber] = [end, start];
+        }
+        const numbers = [];
+        for (let i = startNumber; i <= endNumber; i++) {
+            if (i >= min &&
+                i <= max &&
+                (includeMin || i > min) &&
+                (includeMax || i < max)) {
+                numbers.push(i);
+            }
+        }
+        return numbers;
+    };
+    if (type === 'prime' && multiples !== undefined) {
+        console.warn('Warning: The "multiples" option is ignored when the type is "prime"!');
+    }
+    switch (type) {
+        case 'random':
+            output = (0, basics_1.shuffleArray)(_applyRangeOptions(min, max).map((n) => (0, basics_2.getRandomNumber)({
+                min: n,
+                max: n,
+                includeMin,
+                includeMax,
+            })));
+            break;
+        case 'prime':
+            output = _applyRangeOptions(min, max).filter(prime_1.isPrime);
+            break;
+        case 'odd':
+            output = _applyRangeOptions(min, max).filter((i) => i % 2 !== 0);
+            break;
+        case 'even':
+            output = _applyRangeOptions(min, max).filter((i) => i % 2 === 0);
+            break;
+        case 'natural':
+            output = _applyRangeOptions(Math.max(min, 1), max);
+            break;
+        default:
+            output = _applyRangeOptions(min, max);
+            break;
+    }
+    if (type !== 'prime') {
+        output = _applyMultiples(output, multiples);
+    }
+    return getAs === 'string' ?
+        (0, utils_1.convertArrayToString)(output, separator)
+        : output;
+}

package/dist/number/types.d.ts

@@ -16,4 +16,19 @@ export interface DecimalOptions {
     /** If the return value is in `string` or `number`. Defaults to `false`. */
     isString?: boolean;
 }
+/** - Type of numbers to generate */
+export type NumberType = 'any' | 'natural' | 'odd' | 'even' | 'prime' | 'random';
+/** - Output format for the generated numbers */
+export type GetAs = 'array' | 'string';
+/** - Options for generating numbers in a range */
+export interface RangeOptions<T extends GetAs> extends RandomNumberOptions {
+    /** Separator for the string format if `getAs` is `'string'`. Defaults to `,`. */
+    separator?: string;
+    /** The multiples of which number to consider in the result. */
+    multiples?: number;
+    /** The format for the result - either `'array'` or `'string'`. Default is `array` */
+    getAs?: T;
+}
+/** - The return type of the `getNumbersInRange` function */
+export type RangedNumbers<T extends GetAs> = T extends 'array' ? number[] : string;
 //# 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;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC9B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"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,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC9B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,oCAAoC;AACpC,MAAM,MAAM,UAAU,GACnB,KAAK,GACL,SAAS,GACT,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAEZ,gDAAgD;AAChD,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvC,kDAAkD;AAClD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,mBAAmB;IACzE,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,CAAC,CAAC;CACV;AAED,4DAA4D;AAC5D,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,KAAK,IACxC,CAAC,SAAS,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC"}

package/dist/string/convert.d.ts

@@ -0,0 +1,9 @@
+/**
+ * * Converts a string to `camelCase`, `snake_case`, or `kebab-case`.
+ *
+ * @param string - The input string to be converted. Words should be separated by **non-alphanumeric characters** (e.g., spaces, hyphens, underscores, dots, slashes, etc.).
+ * @param format - The format to convert the string to (`'camelCase'`, `'snake_case'`, or `'kebab-case'`).
+ * @returns The formatted string in the specified case format.
+ */
+export declare function convertStringCase(string: string, format: 'camelCase' | 'snake_case' | 'kebab-case'): string;
+//# sourceMappingURL=convert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/string/convert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAC/C,MAAM,CA8BR"}

package/dist/string/convert.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * * Converts a string to `camelCase`, `snake_case`, or `kebab-case`.
+ *
+ * @param string - The input string to be converted. Words should be separated by **non-alphanumeric characters** (e.g., spaces, hyphens, underscores, dots, slashes, etc.).
+ * @param format - The format to convert the string to (`'camelCase'`, `'snake_case'`, or `'kebab-case'`).
+ * @returns The formatted string in the specified case format.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertStringCase = convertStringCase;
+function convertStringCase(string, format) {
+    if (!string || typeof string !== 'string')
+        return '';
+    const formattedString = string.replace(/[^a-zA-Z0-9]+(.)?/g, (_, chr) => (chr ? chr.toUpperCase() : ''));
+    if (!formattedString)
+        return '';
+    switch (format) {
+        case 'camelCase':
+            return (formattedString.charAt(0).toLowerCase() +
+                formattedString.slice(1));
+        case 'snake_case':
+            return formattedString.replace(/[A-Z]/g, (letter, index) => index === 0 ? letter.toLowerCase() : `_${letter.toLowerCase()}`);
+        case 'kebab-case':
+            return formattedString.replace(/[A-Z]/g, (letter, index) => index === 0 ? letter.toLowerCase() : `-${letter.toLowerCase()}`);
+        default:
+            return formattedString;
+    }
+}

package/dist/utils/index.d.ts

@@ -6,4 +6,12 @@
  * @returns Whether the values are deeply equal.
  */
 export declare const isDeepEqual: <T>(a: T, b: T) => boolean;
+/**
+ * * Utility to convert an array to string with custom separator.
+ *
+ * @param array Array to convert.
+ * @param separator Separate each element of the array. Can be `,`, `-`, `|` etc. Default is `,`.
+ * @returns Converted array in string format with the separator.
+ */
+export declare const convertArrayToString: <T>(array: T[], separator?: string) => string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAC9B,CAAC,EAAE,cACC,MAAM,KACf,MAKF,CAAC"}

package/dist/utils/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDeepEqual = void 0;
+exports.convertArrayToString = exports.isDeepEqual = void 0;
+const basics_1 = require("../array/basics");
 /**
  * * Deeply compare two values (arrays, objects, or primitive values).
  *
@@ -35,3 +36,17 @@ const isDeepEqual = (a, b) => {
     return false;
 };
 exports.isDeepEqual = isDeepEqual;
+/**
+ * * Utility to convert an array to string with custom separator.
+ *
+ * @param array Array to convert.
+ * @param separator Separate each element of the array. Can be `,`, `-`, `|` etc. Default is `,`.
+ * @returns Converted array in string format with the separator.
+ */
+const convertArrayToString = (array, separator = ',') => {
+    if (!basics_1.isValidButEmptyArray) {
+        throw new Error('Please, provide a valid array!');
+    }
+    return array.join(separator);
+};
+exports.convertArrayToString = convertArrayToString;

package/package.json

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