nhb-toolbox 4.26.74 → 4.27.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.27.0] - 2025-11-28
+
+### New
+
+- **Added** *typed* **string case converters** which can only be imported via the *subpath* `'nhb-toolbox/change-case'`.
+  - **Also added** *new* utility types for formatting case(s) in type level.
+- **Added** *new* hash utilities: `randomHex`, `md5`, `sha1`, `uuid`. `decodeUUID` and *uuid version checkers* derived from `isUUID`.
+  - **Hash utilities** can only be imported via the *subpath* `'nhb-toolbox/hash'`
+- **Added** *new* `definePrototypeMethod` utility to inject *prototype* methods in a safe (also *type-safe*) manner.
+
+### Updates
+
+- **Updated** `convertStringCase` utility to accept new format: `'Sentence case'`.
+- **Updated** `isUUID` to verify versions 1-8 (not just `v4`). It now *narrows down* the value to **branded type** `UUID<UUIDVersion>`.
+
 ## [4.26.74] - 2025-11-23
 
 - **Added** optional `serializer` and `deserializer` for *local and session storage* utilities with *improved error handling*.

package/README.md

@@ -359,12 +359,11 @@ const user = {
 };
 
 sanitizeData(user, { ignoreNullish: true, ignoreEmpty: true });
-// Returns { name: "John Doe", address: { city: "NYC" } } with exact input type
+// Returns { name: "John Doe", address: { city: "NYC" } } with exact input type which may cause issue when accessing missing properties
 
-sanitizeData(user, { ignoreNullish: true }, 'partial');
-// Return type: FlattenPartial<typeof user> which is Partial<T>
+sanitizeData(user, { ignoreNullish: true, ignoreEmpty: true }, 'partial');
+// Return type: $DeepPartial<typeof user> safe property access by making all the properties (nested objects/arrays) optional 
 // Returns { name: "John Doe", address: { city: "NYC" } }
-// { name: 'John' }
 ```
 
 [Documentation →](https://toolbox.nazmul-nhb.dev/docs/utilities/object/sanitizeData)

package/dist/cjs/guards/specials.js

@@ -24,8 +24,9 @@ function isDateString(value) {
     return (0, primitives_1.isString)(value) && !isNaN(Date.parse(value));
 }
 function isUUID(value) {
-    return ((0, primitives_1.isString)(value) &&
-        /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value));
+    const h = '[0-9a-f]';
+    const expr = new RegExp(`^${h}{8}-${h}{4}-[1-8]${h}{3}-[89ab]${h}{3}-${h}{12}$`, 'i');
+    return (0, primitives_1.isString)(value) && expr.test(value);
 }
 function isBrowser() {
     return typeof window !== 'undefined' && typeof document !== 'undefined';

package/dist/cjs/hash/helpers.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._runMd5Rounds = _runMd5Rounds;
+exports._uuidTimestamp = _uuidTimestamp;
+exports._randomNode48 = _randomNode48;
+exports._clockSeq14 = _clockSeq14;
+exports._formatUUID = _formatUUID;
+exports._isOptionV3V5 = _isOptionV3V5;
+exports._checkUUIDVersion = _checkUUIDVersion;
+const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
+const specials_1 = require("../guards/specials");
+const index_1 = require("./index");
+function _runMd5Rounds(words, h) {
+    let [a, b, c, d] = h;
+    const funcs = [
+        (x, y, z) => (x & y) | (~x & z),
+        (x, y, z) => (x & z) | (y & ~z),
+        (x, y, z) => x ^ y ^ z,
+        (x, y, z) => y ^ (x | ~z),
+    ];
+    const r1 = [7, 12, 17, 22];
+    const r2 = [5, 9, 14, 20];
+    const r3 = [4, 11, 16, 23];
+    const r4 = [6, 10, 15, 21];
+    const shifts = [
+        ...r1,
+        ...r1,
+        ...r1,
+        ...r1,
+        ...r2,
+        ...r2,
+        ...r2,
+        ...r2,
+        ...r3,
+        ...r3,
+        ...r3,
+        ...r3,
+        ...r4,
+        ...r4,
+        ...r4,
+        ...r4,
+    ];
+    const K = Array.from({ length: 64 }, (_, i) => Math.floor(Math.abs(Math.sin(i + 1)) * 2 ** 32));
+    function _rotl(x, c) {
+        return (x << c) | (x >>> (32 - c));
+    }
+    function _add(x, y) {
+        return (x + y) | 0;
+    }
+    for (let i = 0; i < 64; i++) {
+        const round = i >> 4;
+        const f = funcs[round](b, c, d);
+        let g;
+        if (round === 0)
+            g = i;
+        else if (round === 1)
+            g = (5 * i + 1) % 16;
+        else if (round === 2)
+            g = (3 * i + 5) % 16;
+        else
+            g = (7 * i) % 16;
+        const temp = d;
+        d = c;
+        c = b;
+        b = _add(b, _rotl(_add(_add(a, f), _add(words[g], K[i])), shifts[i]));
+        a = temp;
+    }
+    h[0] = _add(h[0], a);
+    h[1] = _add(h[1], b);
+    h[2] = _add(h[2], c);
+    h[3] = _add(h[3], d);
+}
+function _uuidTimestamp() {
+    const UUID_EPOCH_DIFF = 12219292800000n;
+    const unixMs = BigInt(Date.now());
+    const uuidMs = unixMs + UUID_EPOCH_DIFF;
+    return uuidMs * 10000n;
+}
+function _randomNode48() {
+    const node = (0, index_1.randomHex)(12).split('');
+    const firstByte = parseInt(node.slice(0, 2).join(''), 16);
+    const modified = (firstByte | 0b00000001).toString(16).padStart(2, '0');
+    return modified + node.slice(2).join('');
+}
+function _clockSeq14() {
+    const seq = parseInt((0, index_1.randomHex)(4), 16) & 0x3fff;
+    return seq.toString(16).padStart(4, '0');
+}
+function _formatUUID(h, v, up) {
+    const part3 = String(v) + h.slice(13, 16);
+    const part4 = _hexVariant(h.slice(16, 18)) + h.slice(18, 20);
+    const formatted = [h.slice(0, 8), h.slice(8, 12), part3, part4, h.slice(20, 32)].join('-');
+    return (up ? formatted.toUpperCase() : formatted);
+}
+function _hexVariant(hex) {
+    const v = parseInt(hex, 16);
+    return ((v & 0x3f) | 0x80).toString(16).padStart(2, '0');
+}
+function _isOptionV3V5(opt) {
+    if ((0, non_primitives_1.isObjectWithKeys)(opt, ['name', 'namespace'])) {
+        return (0, specials_1.isUUID)(opt?.namespace) && (0, primitives_1.isNonEmptyString)(opt?.name);
+    }
+    return false;
+}
+function _checkUUIDVersion(value, v) {
+    return (0, specials_1.isUUID)(value) && value[14] === v;
+}

package/dist/cjs/hash/index.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUUID = exports.generateRandomID = void 0;
+exports.randomHex = randomHex;
+exports.md5 = md5;
+exports.sha1 = sha1;
+exports.uuid = uuid;
+exports.decodeUUID = decodeUUID;
+exports.isUUIDv1 = isUUIDv1;
+exports.isUUIDv2 = isUUIDv2;
+exports.isUUIDv3 = isUUIDv3;
+exports.isUUIDv4 = isUUIDv4;
+exports.isUUIDv5 = isUUIDv5;
+exports.isUUIDv6 = isUUIDv6;
+exports.isUUIDv7 = isUUIDv7;
+exports.isUUIDv8 = isUUIDv8;
+const specials_1 = require("../guards/specials");
+Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return specials_1.isUUID; } });
+const helpers_1 = require("./helpers");
+function randomHex(length, uppercase = false) {
+    const genHex = () => Math.floor(Math.random() * 16).toString(16);
+    const hex = Array.from({ length }, genHex).join('');
+    return uppercase ? hex.toUpperCase() : hex;
+}
+function md5(str) {
+    const h = [1732584193, -271733879, -1732584194, 271733878];
+    const bytes = Array.from(new TextEncoder().encode(str));
+    const n = ((bytes.length + 8) >> 6) + 1;
+    const words = new Array(n * 16).fill(0);
+    bytes.forEach((b, i) => {
+        words[i >> 2] |= b << ((i % 4) * 8);
+    });
+    words[bytes.length >> 2] |= 0x80 << ((bytes.length % 4) * 8);
+    words[n * 16 - 2] = bytes.length * 8;
+    for (let i = 0; i < words.length; i += 16) {
+        (0, helpers_1._runMd5Rounds)(words.slice(i, i + 16), h);
+    }
+    return h.map((n) => (n >>> 0).toString(16).padStart(8, '0')).join('');
+}
+function sha1(msg) {
+    const utf8 = new TextEncoder().encode(msg);
+    const K = [0x5a827999, 0x6ed9eba1, 0x8f1bbcdc, 0xca62c1d6];
+    const rotl = (n, bits) => (n << bits) | (n >>> (32 - bits));
+    const toHex = (n) => (n >>> 0).toString(16).padStart(8, '0');
+    const words = new Uint32Array(((utf8.length + 8) >> 2) + 2);
+    for (let i = 0; i < utf8.length; i++) {
+        words[i >> 2] |= utf8[i] << (24 - (i % 4) * 8);
+    }
+    words[utf8.length >> 2] |= 0x80 << (24 - (utf8.length % 4) * 8);
+    words[words.length - 1] = utf8.length * 8;
+    const h = [0x67452301, 0xefcdab89, 0x98badcfe, 0x10325476, 0xc3d2e1f0];
+    const W = new Uint32Array(80);
+    for (let i = 0; i < words.length; i += 16) {
+        for (let j = 0; j < 16; j++)
+            W[j] = words[i + j] | 0;
+        for (let j = 16; j < 80; j++) {
+            W[j] = rotl(W[j - 3] ^ W[j - 8] ^ W[j - 14] ^ W[j - 16], 1);
+        }
+        let a = h[0], b = h[1], c = h[2], d = h[3], e = h[4];
+        for (let j = 0; j < 80; j++) {
+            let f, k;
+            if (j < 20) {
+                f = (b & c) | (~b & d);
+                k = K[0];
+            }
+            else if (j < 40) {
+                f = b ^ c ^ d;
+                k = K[1];
+            }
+            else if (j < 60) {
+                f = (b & c) | (b & d) | (c & d);
+                k = K[2];
+            }
+            else {
+                f = b ^ c ^ d;
+                k = K[3];
+            }
+            const temp = (rotl(a, 5) + f + e + k + W[j]) | 0;
+            e = d;
+            d = c;
+            c = rotl(b, 30);
+            b = a;
+            a = temp;
+        }
+        h[0] = (h[0] + a) | 0;
+        h[1] = (h[1] + b) | 0;
+        h[2] = (h[2] + c) | 0;
+        h[3] = (h[3] + d) | 0;
+        h[4] = (h[4] + e) | 0;
+    }
+    return h.map(toHex).join('');
+}
+function uuid(options) {
+    const { version = 'v4', uppercase = false } = options || {};
+    switch (version) {
+        case 'v1': {
+            const timestamp = (0, helpers_1._uuidTimestamp)().toString(16).padStart(15, '0');
+            const vTimeHigh = (parseInt(timestamp.slice(0, -12).padStart(3, '0'), 16) | 0x1000)
+                .toString(16)
+                .padStart(4, '0');
+            const clockSeq = (0, helpers_1._clockSeq14)();
+            const clockSeqHi = ((parseInt(clockSeq.slice(0, 2), 16) & 0x3f) | 0x80)
+                .toString(16)
+                .padStart(2, '0');
+            const clockSeqLow = clockSeq.slice(2);
+            const raw = timestamp.slice(-8) +
+                timestamp.slice(-12, -8) +
+                vTimeHigh +
+                clockSeqHi +
+                clockSeqLow +
+                (0, helpers_1._randomNode48)();
+            return (0, helpers_1._formatUUID)(raw, 1, uppercase);
+        }
+        case 'v3': {
+            if ((0, helpers_1._isOptionV3V5)(options)) {
+                const hash = md5(options.namespace + options.name);
+                return (0, helpers_1._formatUUID)(hash, 3, uppercase);
+            }
+            throw new Error('v3 requires valid namespace (uuid) and name!');
+        }
+        case 'v4': {
+            const bytes = new Uint8Array(16);
+            for (let i = 0; i < 16; i++) {
+                bytes[i] = Math.floor(Math.random() * 256);
+            }
+            let hex = '';
+            for (let i = 0; i < 16; i++) {
+                hex += bytes[i].toString(16).padStart(2, '0');
+            }
+            return (0, helpers_1._formatUUID)(hex, 4, uppercase);
+        }
+        case 'v5': {
+            if ((0, helpers_1._isOptionV3V5)(options)) {
+                const hash = sha1(options.namespace + options.name).slice(0, 32);
+                return (0, helpers_1._formatUUID)(hash, 5, uppercase);
+            }
+            throw new Error('v5 requires valid namespace (uuid) and name!');
+        }
+        case 'v6': {
+            const timestamp = (0, helpers_1._uuidTimestamp)().toString(16).padStart(15, '0');
+            const vTimeLow = (parseInt(timestamp.slice(12).padStart(3, '0'), 16) | 0x6000)
+                .toString(16)
+                .padStart(4, '0');
+            const clockSeq = (0, helpers_1._clockSeq14)();
+            const clockSeqHi = ((parseInt(clockSeq.slice(0, 2), 16) & 0x3f) | 0x80)
+                .toString(16)
+                .padStart(2, '0');
+            const clockSeqLow = clockSeq.slice(2);
+            const raw = timestamp.slice(0, 8) +
+                timestamp.slice(8, 12) +
+                vTimeLow +
+                clockSeqHi +
+                clockSeqLow +
+                (0, helpers_1._randomNode48)();
+            return (0, helpers_1._formatUUID)(raw, 6, uppercase);
+        }
+        case 'v7': {
+            const tsHex = Date.now().toString(16).padStart(12, '0');
+            return (0, helpers_1._formatUUID)(tsHex + randomHex(20), 7, uppercase);
+        }
+        case 'v8': {
+            const ts = BigInt(Date.now());
+            const bytes = new Uint8Array(16);
+            let temp = ts;
+            for (let i = 5; i >= 0; i--) {
+                bytes[i] = Number(temp & 0xffn);
+                temp >>= 8n;
+            }
+            for (let i = 6; i < 16; i++) {
+                bytes[i] = Math.floor(Math.random() * 256);
+            }
+            let hex = '';
+            for (let i = 0; i < 16; i++) {
+                hex += bytes[i].toString(16).padStart(2, '0');
+            }
+            return (0, helpers_1._formatUUID)(hex, 8, uppercase);
+        }
+        default:
+            throw new RangeError('Unsupported UUID version!');
+    }
+}
+function decodeUUID(uuid) {
+    if (!(0, specials_1.isUUID)(uuid))
+        return null;
+    const plain = uuid.replace(/-/g, '');
+    const parts = uuid.toLowerCase().split('-');
+    const version = parseInt(parts[2][0], 16);
+    const variantNibble = parseInt(parts[3][0], 16);
+    let variant = 'RFC4122';
+    if ((variantNibble & 0b1000) === 0)
+        variant = 'NCS';
+    else if ((variantNibble & 0b1100) === 0b1000)
+        variant = 'RFC4122';
+    else if ((variantNibble & 0b1110) === 0b1100)
+        variant = 'Microsoft';
+    else
+        variant = 'Future';
+    const decoded = {
+        version,
+        variant,
+        raw: uuid,
+        plain,
+        singleInt: BigInt('0x' + plain),
+    };
+    const UUID_EPOCH_DIFF = 122192928000000000n;
+    if (version === 1 || version === 6) {
+        let tsHex = parts[2].slice(1) + parts[1] + parts[0];
+        if (version === 6)
+            tsHex = parts[0] + parts[1] + parts[2].slice(1);
+        const unixMs = Number((BigInt('0x' + tsHex) - UUID_EPOCH_DIFF) / 10000n);
+        decoded.timestamp = unixMs;
+        decoded.node = parts[4];
+        return decoded;
+    }
+    if (version === 7 || version === 8) {
+        const tsHex = parts.join('').slice(0, 12);
+        decoded.variant = version === 7 ? 'RFC4122' : 'Future';
+        decoded.timestamp = parseInt(tsHex, 16);
+        return decoded;
+    }
+    return decoded;
+}
+function isUUIDv1(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '1');
+}
+function isUUIDv2(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '2');
+}
+function isUUIDv3(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '3');
+}
+function isUUIDv4(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '4');
+}
+function isUUIDv5(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '5');
+}
+function isUUIDv6(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '6');
+}
+function isUUIDv7(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '7');
+}
+function isUUIDv8(value) {
+    return (0, helpers_1._checkUUIDVersion)(value, '8');
+}
+var basics_1 = require("../string/basics");
+Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });

package/dist/cjs/hash/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.js

@@ -1,15 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateFactorial = exports.calculateAverage = exports.verbalizer = exports.Verbalizer = exports.pluralizer = exports.Pluralizer = exports.VolumeConverter = exports.TimeConverter = exports.TemperatureConverter = exports.MassConverter = exports.LengthConverter = exports.DataConverter = exports.converter = exports.Converter = exports.AreaConverter = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateFactorial = exports.calculateAverage = exports.verbalizer = exports.Verbalizer = exports.pluralizer = exports.Pluralizer = exports.VolumeConverter = exports.TimeConverter = exports.TemperatureConverter = exports.MassConverter = exports.LengthConverter = exports.DataConverter = exports.converter = exports.Converter = exports.AreaConverter = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.capitalizeString = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = void 0;
 exports.convertRomanToNumeric = exports.convertRomanToInteger = exports.convertRomanToArabic = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.arabicToRoman = exports.isPerfectSquare = exports.isPartOfFibonacciSeries = exports.isPartOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isNumberInvalid = exports.isMultiple = exports.isInvalidNumber = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areNumbersInvalid = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.roundToDecimal = exports.roundNumber = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getRandomInt = exports.getFactors = exports.getFactorial = exports.getDivisors = exports.getAverageOfNumbers = exports.getAverage = exports.factorsOf = exports.factorial = exports.convertToFixed = void 0;
 exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.getRandomHSL = exports.getRandomColor = exports.generateRandomHSLColor = exports.generateRandomHSL = exports.generateRandomColorInHexRGB = exports.generateRandomColor = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.wordToNumber = exports.wordsToNumber = exports.toRomanNumeral = exports.toRoman = exports.romanToNumeric = exports.romanToInteger = exports.romanToArabic = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = void 0;
 exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTCOffset = exports.isValidUTC = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isNativeTimeZoneId = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.isRGBA = exports.isRGB = exports.isHSLA = exports.isHSL = exports.isHex8 = exports.isHex6 = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = void 0;
 exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeZoneDetails = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = void 0;
 exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = void 0;
-exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = void 0;
+exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getStaticGetterNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getInstanceGetterNames = exports.getClassDetails = exports.definePrototypeMethod = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = 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; } });
@@ -23,6 +22,7 @@ Object.defineProperty(exports, "isPalindrome", { enumerable: true, get: function
 Object.defineProperty(exports, "isPascalCase", { enumerable: true, get: function () { return guards_1.isPascalCase; } });
 Object.defineProperty(exports, "isSnakeCase", { enumerable: true, get: function () { return guards_1.isSnakeCase; } });
 var case_1 = require("./string/case");
+Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return case_1.capitalizeString; } });
 Object.defineProperty(exports, "convertStringCase", { enumerable: true, get: function () { return case_1.convertStringCase; } });
 var convert_1 = require("./string/convert");
 Object.defineProperty(exports, "extractEmails", { enumerable: true, get: function () { return convert_1.extractEmails; } });
@@ -367,9 +367,12 @@ Object.defineProperty(exports, "countInstanceMethods", { enumerable: true, get:
 Object.defineProperty(exports, "countStaticMethods", { enumerable: true, get: function () { return index_1.countStaticMethods; } });
 Object.defineProperty(exports, "debounceAction", { enumerable: true, get: function () { return index_1.debounceAction; } });
 Object.defineProperty(exports, "deepParsePrimitives", { enumerable: true, get: function () { return index_1.deepParsePrimitives; } });
+Object.defineProperty(exports, "definePrototypeMethod", { enumerable: true, get: function () { return index_1.definePrototypeMethod; } });
 Object.defineProperty(exports, "getClassDetails", { enumerable: true, get: function () { return index_1.getClassDetails; } });
+Object.defineProperty(exports, "getInstanceGetterNames", { enumerable: true, get: function () { return index_1.getInstanceGetterNames; } });
 Object.defineProperty(exports, "getInstanceMethodNames", { enumerable: true, get: function () { return index_1.getInstanceMethodNames; } });
 Object.defineProperty(exports, "getInstanceMethodsCount", { enumerable: true, get: function () { return index_1.countInstanceMethods; } });
+Object.defineProperty(exports, "getStaticGetterNames", { enumerable: true, get: function () { return index_1.getStaticGetterNames; } });
 Object.defineProperty(exports, "getStaticMethodNames", { enumerable: true, get: function () { return index_1.getStaticMethodNames; } });
 Object.defineProperty(exports, "getStaticMethodsCount", { enumerable: true, get: function () { return index_1.countStaticMethods; } });
 Object.defineProperty(exports, "isDeepEqual", { enumerable: true, get: function () { return index_1.isDeepEqual; } });

package/dist/cjs/number/convert.js

@@ -127,7 +127,7 @@ function numberToWordsOrdinal(number) {
     }
 }
 function wordsToNumber(word) {
-    if (!word || typeof word !== 'string')
+    if (!(0, primitives_1.isNonEmptyString)(word))
         return NaN;
     const trimmed = word.trim();
     if (/^[+-]?\d{1,3}(,\d{3})*(\.\d+)?$/.test(trimmed)) {

package/dist/cjs/string/anagram.js

@@ -1,22 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateAnagrams = generateAnagrams;
-function generateAnagrams(word, limit = 100) {
-    if (word?.length <= 1) {
+const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
+const DICT_CACHE = new WeakMap();
+function _getDictSet(dict) {
+    if (DICT_CACHE.has(dict))
+        return DICT_CACHE.get(dict);
+    const dictSet = new Set(dict.map((w) => w.toLowerCase()));
+    DICT_CACHE.set(dict, dictSet);
+    return dictSet;
+}
+function generateAnagrams(word, options) {
+    if (!(0, primitives_1.isNonEmptyString)(word))
+        return [];
+    if (word?.length === 1)
         return [word?.toLowerCase()];
-    }
-    const uniqueAnagrams = new Set();
-    const _permute = (str, remaining) => {
-        if (!remaining?.length) {
-            uniqueAnagrams.add(str);
+    const { limit = 100, dictionary = false } = options || {};
+    const outSet = new Set();
+    const dictSet = (0, non_primitives_1.isValidArray)(dictionary) ? _getDictSet(dictionary) : undefined;
+    const _permute = (current, remaining) => {
+        if (!remaining.length) {
+            if (!dictSet || dictSet.has(current)) {
+                outSet.add(current);
+            }
             return;
         }
-        for (let i = 0; i < remaining?.length; i++) {
-            if (limit !== 'all' && uniqueAnagrams.size >= limit)
+        const usedSet = new Set();
+        for (let i = 0; i < remaining.length; i++) {
+            const char = remaining[i];
+            if (usedSet.has(char))
+                continue;
+            usedSet.add(char);
+            if (limit !== 'all' && outSet.size >= limit)
                 return;
-            _permute(str + remaining[i], remaining?.slice(0, i) + remaining?.slice(i + 1));
+            _permute(current + char, remaining.slice(0, i) + remaining.slice(i + 1));
         }
     };
     _permute('', word.toLowerCase());
-    return Array.from(uniqueAnagrams);
+    return [...outSet];
 }

package/dist/cjs/string/basics.js

@@ -1,36 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateRandomID = exports.truncateString = void 0;
-exports.capitalizeString = capitalizeString;
 exports.trimString = trimString;
-function capitalizeString(string, options) {
-    if (typeof string !== 'string' || !string)
-        return '';
-    const trimmedString = string.trim();
-    if (!trimmedString)
-        return '';
-    const { capitalizeAll = false, capitalizeEachFirst = false, lowerCaseRest = true, } = options || {};
-    if (capitalizeAll) {
-        return trimmedString.toUpperCase();
-    }
-    if (capitalizeEachFirst) {
-        return trimmedString
-            ?.split(/\s+/)
-            ?.map((word) => capitalizeString(word, { lowerCaseRest }))
-            ?.join(' ');
-    }
-    const matchArray = trimmedString.match(/^(\W*)(\w)(.*)$/);
-    if (matchArray && matchArray?.length === 4) {
-        const [_, leadingSymbols, firstLetter, rest] = matchArray;
-        return leadingSymbols
-            .concat(firstLetter.toUpperCase())
-            .concat(lowerCaseRest ? rest.toLowerCase() : rest);
-    }
-    return trimmedString
-        .charAt(0)
-        .toUpperCase()
-        .concat(lowerCaseRest ? trimmedString.slice(1).toLowerCase() : trimmedString.slice(1));
-}
 const truncateString = (string, maxLength) => {
     if (typeof string !== 'string' || !string)
         return '';