nhb-toolbox 1.2.9 → 1.4.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { capitalizeString, generateRandomID, trimString, truncateString, } from './string/basics';
+export { generateAnagrams } from './string/anagram';
 export { convertToDecimal, getRandomNumber } from './number/basics';
 export { numberToWords } from './number/convert';
+export { isPrime, findPrimeNumbers } from './number/prime';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColor } from './colors/random';
 export { convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';

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,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,16 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.isEmptyObject = exports.isDeepEqual = exports.generateQueryParams = exports.flattenObject = exports.countObjectFields = exports.cloneObject = exports.sortAnArray = exports.flattenArray = exports.filterArrayOfObjects = exports.createOptionsArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForInitial = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.isEmptyObject = exports.isDeepEqual = exports.generateQueryParams = exports.flattenObject = exports.countObjectFields = exports.cloneObject = exports.sortAnArray = exports.flattenArray = exports.filterArrayOfObjects = exports.createOptionsArray = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.generateRandomColor = exports.getColorForInitial = exports.findPrimeNumbers = exports.isPrime = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 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; } });
 Object.defineProperty(exports, "trimString", { enumerable: true, get: function () { return basics_1.trimString; } });
 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 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 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; } });
 var initials_1 = require("./colors/initials");
 Object.defineProperty(exports, "getColorForInitial", { enumerable: true, get: function () { return initials_1.getColorForInitial; } });
 var random_1 = require("./colors/random");

package/dist/number/prime.d.ts

@@ -0,0 +1,16 @@
+/**
+ * * Checks if a number is prime.
+ *
+ * @param number The number to check.
+ * @returns Boolean: `true` if the number is prime, otherwise `false`.
+ */
+export declare const isPrime: (number: number) => boolean;
+/**
+ * * Find prime numbers in a given range.
+ *
+ * @param start The starting number of the range. Default is `1`.
+ * @param end The ending number of the range. Default is `1000`.
+ * @returns An array of prime numbers within the range (inclusive).
+ */
+export declare const findPrimeNumbers: (start?: number, end?: number) => number[];
+//# sourceMappingURL=prime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../src/number/prime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,WAAY,MAAM,KAAG,OAUxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,oCAA4B,MAAM,EAY9D,CAAC"}

package/dist/number/prime.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPrimeNumbers = exports.isPrime = void 0;
+/**
+ * * Checks if a number is prime.
+ *
+ * @param number The number to check.
+ * @returns Boolean: `true` if the number is prime, otherwise `false`.
+ */
+const isPrime = (number) => {
+    if (number < 2)
+        return false;
+    if (number === 2 || number === 3)
+        return true;
+    if (number % 2 === 0 || number % 3 === 0)
+        return false;
+    for (let i = 5; i * i <= number; i += 6) {
+        if (number % i === 0 || number % (i + 2) === 0)
+            return false;
+    }
+    return true;
+};
+exports.isPrime = isPrime;
+/**
+ * * Find prime numbers in a given range.
+ *
+ * @param start The starting number of the range. Default is `1`.
+ * @param end The ending number of the range. Default is `1000`.
+ * @returns An array of prime numbers within the range (inclusive).
+ */
+const findPrimeNumbers = (start = 1, end = 1000) => {
+    let startNumber = start, endNumber = end;
+    if (start > end) {
+        [startNumber, endNumber] = [end, start];
+    }
+    return Array.from({ length: endNumber - startNumber + 1 }, (_, i) => startNumber + i).filter(exports.isPrime);
+};
+exports.findPrimeNumbers = findPrimeNumbers;

package/dist/string/anagram.d.ts

@@ -0,0 +1,8 @@
+/**
+ * * Utility to generate unique anagrams of a word.
+ * @param word The word for generating anagrams.
+ * @param limit The maximum number of anagrams to return ('all' for unlimited). Default is `100`.
+ * @returns An array of generated anagrams. The first element is always the given word.
+ */
+export declare function generateAnagrams(word: string, limit?: number | 'all'): string[];
+//# sourceMappingURL=anagram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anagram.d.ts","sourceRoot":"","sources":["../../src/string/anagram.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,GAAG,KAAW,GACzB,MAAM,EAAE,CA6BV"}

package/dist/string/anagram.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAnagrams = generateAnagrams;
+/**
+ * * Utility to generate unique anagrams of a word.
+ * @param word The word for generating anagrams.
+ * @param limit The maximum number of anagrams to return ('all' for unlimited). Default is `100`.
+ * @returns An array of generated anagrams. The first element is always the given word.
+ */
+function generateAnagrams(word, limit = 100) {
+    if (word.length <= 1)
+        return [word];
+    const uniqueAnagrams = new Set();
+    /**
+     * * Helper function to generate permutations.
+     * @param str Current permutation being formed.
+     * @param remaining Remaining characters to process.
+     */
+    const _permute = (str, remaining) => {
+        if (!remaining.length) {
+            uniqueAnagrams.add(str);
+            return;
+        }
+        for (let i = 0; i < remaining.length; i++) {
+            if (limit !== 'all' && uniqueAnagrams.size >= limit)
+                return;
+            _permute(str + remaining[i], remaining.slice(0, i) + remaining.slice(i + 1));
+        }
+    };
+    _permute('', word.toLowerCase());
+    return Array.from(uniqueAnagrams);
+}

package/dist/string/types.d.ts

@@ -22,4 +22,11 @@ export interface RandomIdOptions {
     /** Specifies the case for the random alphanumeric string. */
     caseOption?: 'upper' | 'lower' | null;
 }
+/** - Options for generating anagrams. */
+export interface AnagramOptions {
+    /** Limit the anagrams output. Default is `100`. */
+    limit?: number | 'all';
+    /** Whether to lookup in the dictionary. Default is `false`. */
+    validWords?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/string/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;CACtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/string/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC9B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/package.json

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