nhb-toolbox 4.29.10 → 4.29.21

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 
 All notable changes to the package will be documented here.
 
+## [4.29.21] - 2026-04-05
+
+- **Updated** tsdoc for `getNumbersInRange` utility to clarify the return type based on the `getAsString` flag.
+
+## [4.29.20] - 2026-04-03
+
+- **Updated** `isEven` and `isOdd` utilities to accept *numeric string* and return `false` for `NaN` and *non-integer* values.
+- **Replaced** manual type checks with *type guards* internally for better *type safety* and *code readability*.
+
 ## [4.29.10] - 2026-03-27
 
 - **Added** new *color utlities* `applyOpacityToHex` and `percentToHex` for working with *hex colors* and *opacity*.

package/dist/cjs/array/Finder.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Finder = void 0;
+const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
 class Finder {
     static #DEFAULT_TTL = 1000 * 60 * 5;
     #cachedResult = new Map();
@@ -9,7 +11,7 @@ class Finder {
     #items;
     constructor(data, ttl = Finder.#DEFAULT_TTL) {
         this.#ttl = ttl;
-        this.#items = typeof data === 'function' ? data() : data;
+        this.#items = (0, non_primitives_1.isFunction)(data) ? data() : data;
     }
     clearCache(key) {
         if (key) {
@@ -21,14 +23,14 @@ class Finder {
     }
     findAll(matcher, keySelector, options) {
         const { fuzzy = false, needSorting = true, cacheKey = 'finder-cache', forceBinary = false, caseInsensitive = true, data, } = options ?? {};
-        const source = typeof data === 'function' ? data() : (data ?? this.#items);
+        const source = (0, non_primitives_1.isFunction)(data) ? data() : (data ?? this.#items);
         if (!source?.length)
             return [];
         const rawGetKey = typeof keySelector === 'function'
             ? keySelector
             : (item) => item[keySelector];
         const getKey = Finder.#createMemoizedKeyGetter(rawGetKey);
-        const normalizedMatcher = caseInsensitive && typeof matcher === 'string' ? matcher.toLowerCase() : matcher;
+        const normalizedMatcher = caseInsensitive && (0, primitives_1.isString)(matcher) ? matcher.toLowerCase() : matcher;
         if (cacheKey) {
             const entry = this.#cachedResult.get(cacheKey);
             if (entry && Date.now() - entry.timestamp < this.#ttl) {
@@ -42,7 +44,7 @@ class Finder {
         if (source.length < 100 && !forceBinary) {
             results = source.filter((item) => {
                 const key = getKey(item);
-                const value = caseInsensitive && typeof key === 'string' ? key.toLowerCase() : key;
+                const value = caseInsensitive && (0, primitives_1.isString)(key) ? key.toLowerCase() : key;
                 return value === normalizedMatcher;
             });
         }
@@ -51,22 +53,18 @@ class Finder {
             const firstMatch = this.binarySearch(sorted, normalizedMatcher, getKey, caseInsensitive);
             if (firstMatch) {
                 const baseKey = getKey(firstMatch);
-                const base = caseInsensitive && typeof baseKey === 'string'
-                    ? baseKey.toLowerCase()
-                    : baseKey;
+                const base = caseInsensitive && (0, primitives_1.isString)(baseKey) ? baseKey.toLowerCase() : baseKey;
                 results = sorted.filter((item) => {
                     const key = getKey(item);
-                    const value = caseInsensitive && typeof key === 'string' ? key.toLowerCase() : key;
+                    const value = caseInsensitive && (0, primitives_1.isString)(key) ? key.toLowerCase() : key;
                     return value === base;
                 });
             }
         }
-        if (!results.length && fuzzy && typeof normalizedMatcher === 'string') {
+        if (!results.length && fuzzy && (0, primitives_1.isString)(normalizedMatcher)) {
             results = source.filter((item) => {
                 const rawKey = getKey(item);
-                const key = caseInsensitive && typeof rawKey === 'string'
-                    ? rawKey.toLowerCase()
-                    : String(rawKey);
+                const key = caseInsensitive && (0, primitives_1.isString)(rawKey) ? rawKey.toLowerCase() : String(rawKey);
                 return this.#match(key, normalizedMatcher);
             });
         }
@@ -80,14 +78,14 @@ class Finder {
     }
     findOne(matcher, keySelector, options) {
         const { fuzzy = false, needSorting = true, cacheKey = 'finder-cache', forceBinary = false, caseInsensitive = true, data, } = options ?? {};
-        const source = typeof data === 'function' ? data() : (data ?? this.#items);
+        const source = (0, non_primitives_1.isFunction)(data) ? data() : (data ?? this.#items);
         if (!source?.length)
             return undefined;
         const rawGetKey = typeof keySelector === 'function'
             ? keySelector
             : (item) => item[keySelector];
         const getKey = Finder.#createMemoizedKeyGetter(rawGetKey);
-        const normalizedMatcher = caseInsensitive && typeof matcher === 'string' ? matcher.toLowerCase() : matcher;
+        const normalizedMatcher = caseInsensitive && (0, primitives_1.isString)(matcher) ? matcher.toLowerCase() : matcher;
         if (cacheKey) {
             const entry = this.#cachedResult.get(cacheKey);
             if (entry && Date.now() - entry.timestamp < this.#ttl) {
@@ -101,14 +99,14 @@ class Finder {
         if (source?.length < 100 && !forceBinary) {
             result = source?.find((item) => {
                 const key = getKey(item);
-                const value = caseInsensitive && typeof key === 'string' ? key.toLowerCase() : key;
+                const value = caseInsensitive && (0, primitives_1.isString)(key) ? key.toLowerCase() : key;
                 return value === normalizedMatcher;
             });
         }
         else {
             result = this.binarySearch(needSorting ? this.#sortAndCache(source, getKey, cacheKey) : source, normalizedMatcher, getKey, caseInsensitive);
         }
-        if (!result && fuzzy && typeof normalizedMatcher === 'string') {
+        if (!result && fuzzy && (0, primitives_1.isString)(normalizedMatcher)) {
             return this.fuzzySearch(source, normalizedMatcher, getKey, caseInsensitive);
         }
         if (cacheKey && result) {
@@ -132,7 +130,7 @@ class Finder {
         while (min <= max) {
             const mid = Math.floor((min + max) / 2);
             const midKey = keySelector(sorted[mid]);
-            const key = caseInsensitive && typeof midKey === 'string' ? midKey.toLowerCase() : midKey;
+            const key = caseInsensitive && (0, primitives_1.isString)(midKey) ? midKey.toLowerCase() : midKey;
             if (key === matcher)
                 return sorted[mid];
             if (key < matcher)
@@ -145,9 +143,7 @@ class Finder {
     fuzzySearch(array, matcher, keySelector, caseInsensitive) {
         for (const item of array) {
             const rawKey = keySelector(item);
-            const key = caseInsensitive && typeof rawKey === 'string'
-                ? rawKey.toLowerCase()
-                : String(rawKey);
+            const key = caseInsensitive && (0, primitives_1.isString)(rawKey) ? rawKey.toLowerCase() : String(rawKey);
             if (this.#match(key, matcher))
                 return item;
         }

package/dist/cjs/array/sort.js

@@ -36,18 +36,18 @@ function naturalSort(a, b, options) {
     for (let i = 0; i < Math.min(aChunks?.length, bChunks?.length); i++) {
         let aChunk = aChunks[i];
         let bChunk = bChunks[i];
-        if (caseInsensitive && typeof aChunk === 'string' && typeof bChunk === 'string') {
+        if (caseInsensitive && (0, primitives_1.isString)(aChunk) && (0, primitives_1.isString)(bChunk)) {
             aChunk = aChunk?.toLowerCase();
             bChunk = bChunk?.toLowerCase();
         }
         if (typeof aChunk !== typeof bChunk) {
-            return typeof aChunk === 'string' ? 1 : -1;
+            return (0, primitives_1.isString)(aChunk) ? 1 : -1;
         }
         if (aChunk !== bChunk) {
-            if (typeof aChunk === 'number' && typeof bChunk === 'number') {
+            if ((0, primitives_1.isNumber)(aChunk) && (0, primitives_1.isNumber)(bChunk)) {
                 return aChunk - bChunk;
             }
-            if (typeof aChunk === 'string' && typeof bChunk === 'string') {
+            if ((0, primitives_1.isString)(aChunk) && (0, primitives_1.isString)(bChunk)) {
                 if (localeAware) {
                     const cmp = aChunk.localeCompare(bChunk, undefined, {
                         sensitivity: caseInsensitive ? 'accent' : 'variant',

package/dist/cjs/colors/initials.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getColorForInitial = getColorForInitial;
+const primitives_1 = require("../guards/primitives");
 const constants_1 = require("./constants");
 const helpers_1 = require("./helpers");
 const utils_1 = require("./utils");
@@ -11,7 +12,7 @@ function getColorForInitial(input = '', opacity = 100) {
     const DEFAULT = '#010514';
     if (!input)
         return (0, helpers_1._applyOpacity)(DEFAULT, hexOpacity);
-    if (typeof input === 'string') {
+    if ((0, primitives_1.isString)(input)) {
         initial = input[0];
         if (NUMBERS.includes(initial)) {
             return (0, helpers_1._applyOpacity)(constants_1.NUMBER_COLOR_PALETTE[parseInt(initial, 10)], hexOpacity);
@@ -23,7 +24,7 @@ function getColorForInitial(input = '', opacity = 100) {
         }
         return (0, helpers_1._applyOpacity)(DEFAULT, hexOpacity);
     }
-    else if (typeof input === 'number' && !isNaN(input)) {
+    else if ((0, primitives_1.isNumber)(input)) {
         initial = input.toString()[0];
         if (NUMBERS.includes(initial)) {
             return (0, helpers_1._applyOpacity)(constants_1.NUMBER_COLOR_PALETTE[parseInt(initial, 10)], hexOpacity);

package/dist/cjs/colors/utils.js

@@ -38,6 +38,8 @@ function applyOpacityToHex(color, opacity) {
         }
     }
     else {
-        throw new TypeError('Invalid color value. Must be a hex color string in the format #RRGGBB or #RRGGBBAA.');
+        throw new TypeError('Invalid color value!', {
+            cause: 'Value must be a hex color string in the format #RRGGBB or #RRGGBBAA.',
+        });
     }
 }

package/dist/cjs/date/chronos-fn.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = void 0;
+const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
 const Chronos_1 = require("./Chronos");
 const $chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
-    if (typeof valueOrYear === 'number' && typeof month === 'number') {
+    if ((0, primitives_1.isNumber)(valueOrYear) && (0, primitives_1.isNumber)(month)) {
         return new Chronos_1.Chronos(valueOrYear, month, date ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
     }
     else {
@@ -15,7 +17,7 @@ function _isChronosStaticKey(prop) {
         prop !== 'prototype' &&
         prop !== 'name' &&
         prop !== 'length' &&
-        typeof Chronos_1.Chronos[prop] === 'function');
+        (0, non_primitives_1.isFunction)(Chronos_1.Chronos[prop]));
 }
 exports.chronos = new Proxy($chronos, {
     get(target, prop, receiver) {

package/dist/cjs/date/guards.js

@@ -7,6 +7,7 @@ exports.isNativeTimeZoneId = isNativeTimeZoneId;
 exports.isLeapYear = isLeapYear;
 exports.isDateLike = isDateLike;
 exports.isTimeWithUnit = isTimeWithUnit;
+const non_primitives_1 = require("../guards/non-primitives");
 const primitives_1 = require("../guards/primitives");
 const specials_1 = require("../guards/specials");
 const utilities_1 = require("../number/utilities");
@@ -37,27 +38,24 @@ function isLeapYear(year) {
 function isDateLike(value) {
     if (value instanceof Date)
         return true;
-    if (value && typeof value === 'object') {
-        const v = value;
-        if (typeof v.format === 'function' &&
-            typeof v.toJSON === 'function' &&
-            typeof v.toISOString === 'function') {
+    if ((0, non_primitives_1.isObject)(value)) {
+        if ((0, non_primitives_1.isFunction)(value.format) &&
+            (0, non_primitives_1.isFunction)(value.toJSON) &&
+            (0, non_primitives_1.isFunction)(value.toISOString)) {
             return true;
         }
-        if (typeof v.toISO === 'function' &&
-            typeof v.toFormat === 'function' &&
-            typeof v.isValid === 'boolean') {
+        if ((0, non_primitives_1.isFunction)(value.toISO) && (0, non_primitives_1.isFunction)(value.toFormat) && (0, primitives_1.isBoolean)(value.isValid)) {
             return true;
         }
-        if (typeof v.plus === 'function' &&
-            typeof v.minus === 'function' &&
-            typeof v.equals === 'function' &&
-            typeof v.getClass === 'function') {
+        if ((0, non_primitives_1.isFunction)(value.plus) &&
+            (0, non_primitives_1.isFunction)(value.minus) &&
+            (0, non_primitives_1.isFunction)(value.equals) &&
+            (0, non_primitives_1.isFunction)(value.getClass)) {
             return true;
         }
-        if (typeof v.toJSON === 'function' &&
-            typeof v.toString === 'function' &&
-            ['PlainDate', 'ZonedDateTime', 'Instant'].includes(v.constructor?.name ?? '')) {
+        if ((0, non_primitives_1.isFunction)(value.toJSON) &&
+            (0, non_primitives_1.isFunction)(value.toString) &&
+            ['PlainDate', 'ZonedDateTime', 'Instant'].includes(value.constructor?.name ?? '')) {
             return true;
         }
     }

package/dist/cjs/date/utils.js

@@ -15,6 +15,8 @@ exports.formatTimePart = formatTimePart;
 exports.formatDateRelative = formatDateRelative;
 exports.getTimestamp = getTimestamp;
 const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
+const utilities_1 = require("../number/utilities");
 const guards_1 = require("./guards");
 const helpers_1 = require("./helpers");
 const timezone_1 = require("./timezone");
@@ -38,13 +40,24 @@ function extractMinutesFromUTC(utc) {
     return getTotalMinutes(extractTimeFromUTC(utc));
 }
 function convertMinutesToTime(minutes) {
-    const numMIn = Math.abs(typeof minutes === 'number' ? minutes : Number(minutes));
+    const parsed = (0, utilities_1.normalizeNumber)(minutes);
+    if ((0, primitives_1.isUndefined)(parsed)) {
+        throw new TypeError(`Invalid numeric input!`, {
+            cause: `${minutes} cannot be converted to a number.`,
+        });
+    }
+    const numMIn = Math.abs(parsed);
     return `${String(Math.floor(numMIn / 60))}:${String(numMIn % 60).padStart(2, '0')}`;
 }
 function formatUTCOffset(minutes) {
-    const numMIn = typeof minutes === 'number' ? minutes : Number(minutes);
-    const sign = numMIn < 0 ? '-' : '+';
-    const abs = Math.abs(numMIn);
+    const parsed = (0, utilities_1.normalizeNumber)(minutes);
+    if ((0, primitives_1.isUndefined)(parsed)) {
+        throw new TypeError(`Invalid numeric input!`, {
+            cause: `${minutes} cannot be converted to a number.`,
+        });
+    }
+    const sign = parsed < 0 ? '-' : '+';
+    const abs = Math.abs(parsed);
     const hours = String(Math.floor(abs / 60)).padStart(2, '0');
     const mins = String(abs % 60).padStart(2, '0');
     return `UTC${sign}${hours}:${mins}`;

package/dist/cjs/dom/query.js

@@ -5,22 +5,19 @@ exports.getQueryParams = getQueryParams;
 exports.updateQueryParam = updateQueryParam;
 exports.parseQueryString = parseQueryString;
 exports.parseQueryStringLiteral = parseQueryStringLiteral;
+const primitives_1 = require("../guards/primitives");
 const objectify_1 = require("../object/objectify");
 const sanitize_1 = require("../object/sanitize");
 const index_1 = require("../utils/index");
 function generateQueryParams(params = {}) {
     const flattenedParams = (0, objectify_1.flattenObjectKeyValue)(params);
     const queryParams = Object.entries(flattenedParams)
-        ?.filter(([_, value]) => value !== undefined &&
-        value !== null &&
-        !(typeof value === 'string' && value?.trim() === ''))
+        ?.filter(([_, value]) => value != null && !((0, primitives_1.isString)(value) && value?.trim() === ''))
         ?.flatMap(([key, value]) => Array.isArray(value)
         ? value
-            ?.filter((v) => v !== undefined &&
-            v !== null &&
-            !(typeof v === 'string' && v.trim() === ''))
-            ?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(typeof v === 'boolean' ? String(v) : String(v))}`)
-        : `${encodeURIComponent(key)}=${encodeURIComponent(typeof value === 'boolean' ? String(value) : String(value))}`)
+            ?.filter((v) => v != null && !((0, primitives_1.isString)(v) && v.trim() === ''))
+            ?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(String(v))}`)
+        : `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
         .join('&');
     return queryParams ? `?${queryParams}` : '';
 }

package/dist/cjs/form/convert.js

@@ -70,7 +70,7 @@ const createControlledFormData = (data, configs) => {
                     }
                 }
                 else {
-                    if (typeof value === 'string') {
+                    if ((0, primitives_1.isString)(value)) {
                         if ((0, primitives_1.isNonEmptyString)(value)) {
                             let cleanString = value;
                             if (configs?.trimStrings) {
@@ -175,7 +175,7 @@ const createControlledFormData = (data, configs) => {
         else {
             const isNotNullish = value != null && value !== '';
             if (isNotNullish || _isRequiredKey(key)) {
-                if (typeof value === 'string' && _shouldLowercaseValue(key)) {
+                if ((0, primitives_1.isString)(value) && _shouldLowercaseValue(key)) {
                     formData.append(transformedKey, value?.toLowerCase());
                 }
                 else {

package/dist/cjs/form/guards.js

@@ -8,6 +8,7 @@ exports.isFileArray = isFileArray;
 exports.isFileList = isFileList;
 exports.isFileOrBlob = isFileOrBlob;
 exports.isFileUpload = isFileUpload;
+const primitives_1 = require("../guards/primitives");
 function isValidFormData(value) {
     if (!(value instanceof FormData))
         return false;
@@ -25,7 +26,7 @@ function isOriginFileObj(value) {
         return false;
     }
     const obj = value;
-    return typeof obj.uid === 'string';
+    return (0, primitives_1.isString)(obj.uid);
 }
 function isCustomFile(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {

package/dist/cjs/form/transform.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.serializeForm = serializeForm;
 exports.parseFormData = parseFormData;
 const query_1 = require("../dom/query");
+const primitives_1 = require("../guards/primitives");
 const sanitize_1 = require("../object/sanitize");
 function serializeForm(form, toQueryString = false) {
     const formData = new FormData(form);
@@ -25,11 +26,11 @@ function serializeForm(form, toQueryString = false) {
 }
 function parseFormData(data, parsePrimitives = true) {
     const parsed = {};
-    if (typeof data === 'string') {
+    if ((0, primitives_1.isString)(data)) {
         const params = new URLSearchParams(data);
         params?.forEach((value, key) => {
             const existing = parsed[key];
-            if (typeof existing === 'string') {
+            if ((0, primitives_1.isString)(existing)) {
                 parsed[key] = [existing, value];
             }
             else if (Array.isArray(existing)) {
@@ -55,7 +56,7 @@ function parseFormData(data, parsePrimitives = true) {
                 }
             }
             else {
-                if (typeof existing === 'string') {
+                if ((0, primitives_1.isString)(existing)) {
                     parsed[key] = [existing, value];
                 }
                 else if (Array.isArray(existing)) {

package/dist/cjs/number/basics.js

@@ -43,10 +43,13 @@ const getRandomNumber = (options) => {
 exports.getRandomNumber = getRandomNumber;
 const convertToDecimal = (input, options) => {
     const { decimalPlaces = 2, isString = false } = options || {};
-    const number = typeof input === 'number' ? input : Number(input);
-    return isString
-        ? number.toFixed(decimalPlaces)
-        : Number(number.toFixed(decimalPlaces));
+    const parsed = (0, utilities_1.normalizeNumber)(input);
+    if ((0, primitives_1.isUndefined)(parsed)) {
+        throw new TypeError(`Invalid numeric input!`, {
+            cause: `${input} cannot be converted to a number.`,
+        });
+    }
+    return (isString ? parsed.toFixed(decimalPlaces) : Number(parsed.toFixed(decimalPlaces)));
 };
 exports.convertToDecimal = convertToDecimal;
 const calculateHCF = (...numbers) => {
@@ -117,7 +120,7 @@ function getAverage(...numbers) {
     let count = 0;
     for (const n of numbers) {
         const num = Number(n);
-        if (typeof num === 'number' && !isNaN(num)) {
+        if ((0, primitives_1.isNumber)(num)) {
             sum += num;
             count++;
         }

package/dist/cjs/number/guards.js

@@ -4,12 +4,20 @@ exports.isMultiple = exports.isOdd = exports.isEven = void 0;
 exports.isPerfectSquare = isPerfectSquare;
 exports.isFibonacci = isFibonacci;
 exports.areInvalidNumbers = areInvalidNumbers;
+const primitives_1 = require("../guards/primitives");
+const utilities_1 = require("./utilities");
 const isEven = (input) => {
-    return input % 2 === 0;
+    const parsed = (0, utilities_1.normalizeNumber)(input);
+    if ((0, primitives_1.isUndefined)(parsed))
+        return false;
+    return parsed % 2 === 0;
 };
 exports.isEven = isEven;
 const isOdd = (input) => {
-    return input % 2 !== 0;
+    const parsed = (0, utilities_1.normalizeNumber)(input);
+    if ((0, primitives_1.isUndefined)(parsed))
+        return false;
+    return parsed % 2 !== 0;
 };
 exports.isOdd = isOdd;
 const isMultiple = (input, multipleOf) => {

package/dist/cjs/number/range.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNumbersInRange = getNumbersInRange;
 const basics_1 = require("../array/basics");
+const primitives_1 = require("../guards/primitives");
 const index_1 = require("../utils/index");
 const basics_2 = require("./basics");
 const guards_1 = require("./guards");
@@ -27,7 +28,7 @@ function getNumbersInRange(type = 'any', options) {
         }
         return numbers;
     };
-    if (type === 'prime' && multiplesOf !== undefined) {
+    if (type === 'prime' && !(0, primitives_1.isUndefined)(multiplesOf)) {
         console.warn('Warning: The "multiplesOf" option is ignored when the type is "prime"!');
     }
     switch (type) {
@@ -58,7 +59,5 @@ function getNumbersInRange(type = 'any', options) {
     if (type !== 'prime') {
         output = (0, helpers_1._applyMultiples)(output, multiplesOf);
     }
-    return getAsString
-        ? (0, index_1.convertArrayToString)(output, { separator })
-        : output;
+    return (getAsString ? (0, index_1.convertArrayToString)(output, { separator }) : output);
 }

package/dist/cjs/pluralizer/Pluralizer.js

@@ -71,7 +71,7 @@ class Pluralizer {
     }
     #isUncountable(word) {
         for (const entry of this.#uncountables) {
-            if (typeof entry === 'string') {
+            if ((0, primitives_1.isString)(entry)) {
                 if (entry.toLowerCase() === word)
                     return true;
             }
@@ -89,7 +89,7 @@ class Pluralizer {
         this.#singularRules.push([rule, replacement]);
     }
     addUncountable(word) {
-        this.#uncountables.add(typeof word === 'string' ? word?.toLowerCase() : word);
+        this.#uncountables.add((0, primitives_1.isString)(word) ? word?.toLowerCase() : word);
     }
     addIrregular(single, plural) {
         const singleLower = single?.toLowerCase();
@@ -99,7 +99,7 @@ class Pluralizer {
     }
     pluralize(word, options = {}) {
         const count = (0, utilities_1.normalizeNumber)(options?.count);
-        if (typeof count === 'number') {
+        if (!(0, primitives_1.isUndefined)(count)) {
             const pluralized = count === 1 ? this.toSingular(word) : this.toPlural(word);
             return options?.inclusive ? `${count} ${pluralized}` : pluralized;
         }

package/dist/cjs/string/convert.js

@@ -5,10 +5,11 @@ exports.normalizeString = normalizeString;
 exports.extractEmails = extractEmails;
 exports.extractURLs = extractURLs;
 exports.formatUnitWithPlural = formatUnitWithPlural;
+const primitives_1 = require("../guards/primitives");
 const basics_1 = require("./basics");
 const replaceAllInString = (input, find, replace) => {
     const trimmedString = (0, basics_1.trimString)(input);
-    const regex = typeof find === 'string'
+    const regex = (0, primitives_1.isString)(find)
         ? new RegExp(find, 'g')
         : new RegExp(find, find?.flags.includes('g') ? find?.flags : find?.flags + 'g');
     return trimmedString?.replace(regex, replace);

package/dist/cjs/utils/index.js

@@ -198,7 +198,7 @@ function deepParsePrimitives(input) {
     return input;
 }
 function definePrototypeMethod(proto, name, impl, options) {
-    const alreadyExists = Object.prototype.hasOwnProperty.call(proto, name);
+    const alreadyExists = Object.hasOwn(proto, name);
     if (alreadyExists && !options?.overwrite)
         return;
     Object.defineProperty(proto, name, {

package/dist/dts/converter/Converter.d.ts

@@ -14,4 +14,4 @@ import { $Volume } from './volume';
  * The returned instance exposes only methods relevant to the provided unit type.
  */
 export declare function Converter<U extends $Unit>(value: Numeric, unit?: U): Converted<U>;
-export { $Area as AreaConverter, Converter as converter, $Data as DataConverter, $Length as LengthConverter, $Mass as MassConverter, $Temperature as TemperatureConverter, $Time as TimeConverter, $Volume as VolumeConverter, };
+export { $Area as AreaConverter, $Data as DataConverter, $Length as LengthConverter, $Mass as MassConverter, $Temperature as TemperatureConverter, $Time as TimeConverter, $Volume as VolumeConverter, Converter as converter, };

package/dist/dts/number/guards.d.ts

@@ -1,17 +1,18 @@
+import type { Numeric } from '../types/index';
 /**
  * * Check if a number is even or not.
  *
- * @param input The number to check.
+ * @param input The number or numeric string to check.
  * @returns Boolean: `true` if even and `false` if not even.
  */
-export declare const isEven: (input: number) => boolean;
+export declare const isEven: (input: Numeric) => boolean;
 /**
  * * Checks if a number is odd or not.
  *
- * @param input The number to check.
+ * @param input The number or numeric string to check.
  * @returns Boolean: `true` if odd and `false` if not odd.
  */
-export declare const isOdd: (input: number) => boolean;
+export declare const isOdd: (input: Numeric) => boolean;
 /**
  * * Checks if a number is a multiple of another number.
  *

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

@@ -1,10 +1,11 @@
 import type { 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.
+ * * Function to get numbers within a range based on the provided {@link NumberType} and options.
+ *
+ * @remarks Returns either string or array of numbers based on the {@link RangeOptions.getAsString getAsString} option.
  *
  * @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.
+ * @returns The numbers in the range based on {@link type} and {@link options} either as string or array of numbers.
  */
 export declare function getNumbersInRange<T extends boolean = false>(type?: NumberType, options?: RangeOptions<T>): RangedNumbers<T>;

package/dist/esm/array/Finder.js

@@ -1,3 +1,5 @@
+import { isFunction } from '../guards/non-primitives.js';
+import { isString } from '../guards/primitives.js';
 export class Finder {
     static #DEFAULT_TTL = 1000 * 60 * 5;
     #cachedResult = new Map();
@@ -6,7 +8,7 @@ export class Finder {
     #items;
     constructor(data, ttl = Finder.#DEFAULT_TTL) {
         this.#ttl = ttl;
-        this.#items = typeof data === 'function' ? data() : data;
+        this.#items = isFunction(data) ? data() : data;
     }
     clearCache(key) {
         if (key) {
@@ -18,14 +20,14 @@ export class Finder {
     }
     findAll(matcher, keySelector, options) {
         const { fuzzy = false, needSorting = true, cacheKey = 'finder-cache', forceBinary = false, caseInsensitive = true, data, } = options ?? {};
-        const source = typeof data === 'function' ? data() : (data ?? this.#items);
+        const source = isFunction(data) ? data() : (data ?? this.#items);
         if (!source?.length)
             return [];
         const rawGetKey = typeof keySelector === 'function'
             ? keySelector
             : (item) => item[keySelector];
         const getKey = Finder.#createMemoizedKeyGetter(rawGetKey);
-        const normalizedMatcher = caseInsensitive && typeof matcher === 'string' ? matcher.toLowerCase() : matcher;
+        const normalizedMatcher = caseInsensitive && isString(matcher) ? matcher.toLowerCase() : matcher;
         if (cacheKey) {
             const entry = this.#cachedResult.get(cacheKey);
             if (entry && Date.now() - entry.timestamp < this.#ttl) {
@@ -39,7 +41,7 @@ export class Finder {
         if (source.length < 100 && !forceBinary) {
             results = source.filter((item) => {
                 const key = getKey(item);
-                const value = caseInsensitive && typeof key === 'string' ? key.toLowerCase() : key;
+                const value = caseInsensitive && isString(key) ? key.toLowerCase() : key;
                 return value === normalizedMatcher;
             });
         }
@@ -48,22 +50,18 @@ export class Finder {
             const firstMatch = this.binarySearch(sorted, normalizedMatcher, getKey, caseInsensitive);
             if (firstMatch) {
                 const baseKey = getKey(firstMatch);
-                const base = caseInsensitive && typeof baseKey === 'string'
-                    ? baseKey.toLowerCase()
-                    : baseKey;
+                const base = caseInsensitive && isString(baseKey) ? baseKey.toLowerCase() : baseKey;
                 results = sorted.filter((item) => {
                     const key = getKey(item);
-                    const value = caseInsensitive && typeof key === 'string' ? key.toLowerCase() : key;
+                    const value = caseInsensitive && isString(key) ? key.toLowerCase() : key;
                     return value === base;
                 });
             }
         }
-        if (!results.length && fuzzy && typeof normalizedMatcher === 'string') {
+        if (!results.length && fuzzy && isString(normalizedMatcher)) {
             results = source.filter((item) => {
                 const rawKey = getKey(item);
-                const key = caseInsensitive && typeof rawKey === 'string'
-                    ? rawKey.toLowerCase()
-                    : String(rawKey);
+                const key = caseInsensitive && isString(rawKey) ? rawKey.toLowerCase() : String(rawKey);
                 return this.#match(key, normalizedMatcher);
             });
         }
@@ -77,14 +75,14 @@ export class Finder {
     }
     findOne(matcher, keySelector, options) {
         const { fuzzy = false, needSorting = true, cacheKey = 'finder-cache', forceBinary = false, caseInsensitive = true, data, } = options ?? {};
-        const source = typeof data === 'function' ? data() : (data ?? this.#items);
+        const source = isFunction(data) ? data() : (data ?? this.#items);
         if (!source?.length)
             return undefined;
         const rawGetKey = typeof keySelector === 'function'
             ? keySelector
             : (item) => item[keySelector];
         const getKey = Finder.#createMemoizedKeyGetter(rawGetKey);
-        const normalizedMatcher = caseInsensitive && typeof matcher === 'string' ? matcher.toLowerCase() : matcher;
+        const normalizedMatcher = caseInsensitive && isString(matcher) ? matcher.toLowerCase() : matcher;
         if (cacheKey) {
             const entry = this.#cachedResult.get(cacheKey);
             if (entry && Date.now() - entry.timestamp < this.#ttl) {
@@ -98,14 +96,14 @@ export class Finder {
         if (source?.length < 100 && !forceBinary) {
             result = source?.find((item) => {
                 const key = getKey(item);
-                const value = caseInsensitive && typeof key === 'string' ? key.toLowerCase() : key;
+                const value = caseInsensitive && isString(key) ? key.toLowerCase() : key;
                 return value === normalizedMatcher;
             });
         }
         else {
             result = this.binarySearch(needSorting ? this.#sortAndCache(source, getKey, cacheKey) : source, normalizedMatcher, getKey, caseInsensitive);
         }
-        if (!result && fuzzy && typeof normalizedMatcher === 'string') {
+        if (!result && fuzzy && isString(normalizedMatcher)) {
             return this.fuzzySearch(source, normalizedMatcher, getKey, caseInsensitive);
         }
         if (cacheKey && result) {
@@ -129,7 +127,7 @@ export class Finder {
         while (min <= max) {
             const mid = Math.floor((min + max) / 2);
             const midKey = keySelector(sorted[mid]);
-            const key = caseInsensitive && typeof midKey === 'string' ? midKey.toLowerCase() : midKey;
+            const key = caseInsensitive && isString(midKey) ? midKey.toLowerCase() : midKey;
             if (key === matcher)
                 return sorted[mid];
             if (key < matcher)
@@ -142,9 +140,7 @@ export class Finder {
     fuzzySearch(array, matcher, keySelector, caseInsensitive) {
         for (const item of array) {
             const rawKey = keySelector(item);
-            const key = caseInsensitive && typeof rawKey === 'string'
-                ? rawKey.toLowerCase()
-                : String(rawKey);
+            const key = caseInsensitive && isString(rawKey) ? rawKey.toLowerCase() : String(rawKey);
             if (this.#match(key, matcher))
                 return item;
         }

package/dist/esm/array/sort.js

@@ -32,18 +32,18 @@ export function naturalSort(a, b, options) {
     for (let i = 0; i < Math.min(aChunks?.length, bChunks?.length); i++) {
         let aChunk = aChunks[i];
         let bChunk = bChunks[i];
-        if (caseInsensitive && typeof aChunk === 'string' && typeof bChunk === 'string') {
+        if (caseInsensitive && isString(aChunk) && isString(bChunk)) {
             aChunk = aChunk?.toLowerCase();
             bChunk = bChunk?.toLowerCase();
         }
         if (typeof aChunk !== typeof bChunk) {
-            return typeof aChunk === 'string' ? 1 : -1;
+            return isString(aChunk) ? 1 : -1;
         }
         if (aChunk !== bChunk) {
-            if (typeof aChunk === 'number' && typeof bChunk === 'number') {
+            if (isNumber(aChunk) && isNumber(bChunk)) {
                 return aChunk - bChunk;
             }
-            if (typeof aChunk === 'string' && typeof bChunk === 'string') {
+            if (isString(aChunk) && isString(bChunk)) {
                 if (localeAware) {
                     const cmp = aChunk.localeCompare(bChunk, undefined, {
                         sensitivity: caseInsensitive ? 'accent' : 'variant',

package/dist/esm/colors/initials.js

@@ -1,3 +1,4 @@
+import { isNumber, isString } from '../guards/primitives.js';
 import { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './constants.js';
 import { _applyOpacity } from './helpers.js';
 import { percentToHex } from './utils.js';
@@ -8,7 +9,7 @@ export function getColorForInitial(input = '', opacity = 100) {
     const DEFAULT = '#010514';
     if (!input)
         return _applyOpacity(DEFAULT, hexOpacity);
-    if (typeof input === 'string') {
+    if (isString(input)) {
         initial = input[0];
         if (NUMBERS.includes(initial)) {
             return _applyOpacity(NUMBER_COLOR_PALETTE[parseInt(initial, 10)], hexOpacity);
@@ -20,7 +21,7 @@ export function getColorForInitial(input = '', opacity = 100) {
         }
         return _applyOpacity(DEFAULT, hexOpacity);
     }
-    else if (typeof input === 'number' && !isNaN(input)) {
+    else if (isNumber(input)) {
         initial = input.toString()[0];
         if (NUMBERS.includes(initial)) {
             return _applyOpacity(NUMBER_COLOR_PALETTE[parseInt(initial, 10)], hexOpacity);

package/dist/esm/colors/utils.js

@@ -32,6 +32,8 @@ export function applyOpacityToHex(color, opacity) {
         }
     }
     else {
-        throw new TypeError('Invalid color value. Must be a hex color string in the format #RRGGBB or #RRGGBBAA.');
+        throw new TypeError('Invalid color value!', {
+            cause: 'Value must be a hex color string in the format #RRGGBB or #RRGGBBAA.',
+        });
     }
 }

package/dist/esm/converter/Converter.js

@@ -36,4 +36,4 @@ export function Converter(value, unit) {
             return new $BaseConverter(value, unit);
     }
 }
-export { $Area as AreaConverter, Converter as converter, $Data as DataConverter, $Length as LengthConverter, $Mass as MassConverter, $Temperature as TemperatureConverter, $Time as TimeConverter, $Volume as VolumeConverter, };
+export { $Area as AreaConverter, $Data as DataConverter, $Length as LengthConverter, $Mass as MassConverter, $Temperature as TemperatureConverter, $Time as TimeConverter, $Volume as VolumeConverter, Converter as converter, };

package/dist/esm/date/chronos-fn.js

@@ -1,6 +1,8 @@
+import { isFunction } from '../guards/non-primitives.js';
+import { isNumber } from '../guards/primitives.js';
 import { Chronos } from './Chronos.js';
 const $chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
-    if (typeof valueOrYear === 'number' && typeof month === 'number') {
+    if (isNumber(valueOrYear) && isNumber(month)) {
         return new Chronos(valueOrYear, month, date ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
     }
     else {
@@ -12,7 +14,7 @@ function _isChronosStaticKey(prop) {
         prop !== 'prototype' &&
         prop !== 'name' &&
         prop !== 'length' &&
-        typeof Chronos[prop] === 'function');
+        isFunction(Chronos[prop]));
 }
 export const chronos = new Proxy($chronos, {
     get(target, prop, receiver) {

package/dist/esm/date/guards.js

@@ -1,4 +1,5 @@
-import { isNonEmptyString, isString } from '../guards/primitives.js';
+import { isFunction, isObject } from '../guards/non-primitives.js';
+import { isBoolean, isNonEmptyString, isString } from '../guards/primitives.js';
 import { isNumericString } from '../guards/specials.js';
 import { normalizeNumber } from '../number/utilities.js';
 import { IANA_TZ_IDS, NATIVE_TZ_IDS } from './timezone.js';
@@ -28,27 +29,24 @@ export function isLeapYear(year) {
 export function isDateLike(value) {
     if (value instanceof Date)
         return true;
-    if (value && typeof value === 'object') {
-        const v = value;
-        if (typeof v.format === 'function' &&
-            typeof v.toJSON === 'function' &&
-            typeof v.toISOString === 'function') {
+    if (isObject(value)) {
+        if (isFunction(value.format) &&
+            isFunction(value.toJSON) &&
+            isFunction(value.toISOString)) {
             return true;
         }
-        if (typeof v.toISO === 'function' &&
-            typeof v.toFormat === 'function' &&
-            typeof v.isValid === 'boolean') {
+        if (isFunction(value.toISO) && isFunction(value.toFormat) && isBoolean(value.isValid)) {
             return true;
         }
-        if (typeof v.plus === 'function' &&
-            typeof v.minus === 'function' &&
-            typeof v.equals === 'function' &&
-            typeof v.getClass === 'function') {
+        if (isFunction(value.plus) &&
+            isFunction(value.minus) &&
+            isFunction(value.equals) &&
+            isFunction(value.getClass)) {
             return true;
         }
-        if (typeof v.toJSON === 'function' &&
-            typeof v.toString === 'function' &&
-            ['PlainDate', 'ZonedDateTime', 'Instant'].includes(v.constructor?.name ?? '')) {
+        if (isFunction(value.toJSON) &&
+            isFunction(value.toString) &&
+            ['PlainDate', 'ZonedDateTime', 'Instant'].includes(value.constructor?.name ?? '')) {
             return true;
         }
     }

package/dist/esm/date/plugins/timeZonePlugin.js

@@ -1,7 +1,7 @@
 import { INTERNALS } from '../constants.js';
 import { isValidUTCOffset } from '../guards.js';
 import { _gmtToUtcOffset, _resolveNativeTzName } from '../helpers.js';
-import { NATIVE_TZ_IDS, TIME_ZONES, TIME_ZONE_LABELS } from '../timezone.js';
+import { NATIVE_TZ_IDS, TIME_ZONE_LABELS, TIME_ZONES } from '../timezone.js';
 import { extractMinutesFromUTC } from '../utils.js';
 export const timeZonePlugin = ($Chronos) => {
     const { internalDate: $Date, withOrigin, offset } = $Chronos[INTERNALS];

package/dist/esm/date/utils.js

@@ -1,4 +1,6 @@
 import { isObject } from '../guards/non-primitives.js';
+import { isUndefined } from '../guards/primitives.js';
+import { normalizeNumber } from '../number/utilities.js';
 import { isValidUTCOffset } from './guards.js';
 import { _dateArgsToDate, _formatDate, _gmtToUtcOffset, _normalizeOffset, _resolveNativeTzName, } from './helpers.js';
 import { NATIVE_TZ_IDS } from './timezone.js';
@@ -22,13 +24,24 @@ export function extractMinutesFromUTC(utc) {
     return getTotalMinutes(extractTimeFromUTC(utc));
 }
 export function convertMinutesToTime(minutes) {
-    const numMIn = Math.abs(typeof minutes === 'number' ? minutes : Number(minutes));
+    const parsed = normalizeNumber(minutes);
+    if (isUndefined(parsed)) {
+        throw new TypeError(`Invalid numeric input!`, {
+            cause: `${minutes} cannot be converted to a number.`,
+        });
+    }
+    const numMIn = Math.abs(parsed);
     return `${String(Math.floor(numMIn / 60))}:${String(numMIn % 60).padStart(2, '0')}`;
 }
 export function formatUTCOffset(minutes) {
-    const numMIn = typeof minutes === 'number' ? minutes : Number(minutes);
-    const sign = numMIn < 0 ? '-' : '+';
-    const abs = Math.abs(numMIn);
+    const parsed = normalizeNumber(minutes);
+    if (isUndefined(parsed)) {
+        throw new TypeError(`Invalid numeric input!`, {
+            cause: `${minutes} cannot be converted to a number.`,
+        });
+    }
+    const sign = parsed < 0 ? '-' : '+';
+    const abs = Math.abs(parsed);
     const hours = String(Math.floor(abs / 60)).padStart(2, '0');
     const mins = String(abs % 60).padStart(2, '0');
     return `UTC${sign}${hours}:${mins}`;

package/dist/esm/dom/query.js

@@ -1,19 +1,16 @@
+import { isString } from '../guards/primitives.js';
 import { flattenObjectKeyValue } from '../object/objectify.js';
 import { parseObjectValues } from '../object/sanitize.js';
 import { deepParsePrimitives } from '../utils/index.js';
 export function generateQueryParams(params = {}) {
     const flattenedParams = flattenObjectKeyValue(params);
     const queryParams = Object.entries(flattenedParams)
-        ?.filter(([_, value]) => value !== undefined &&
-        value !== null &&
-        !(typeof value === 'string' && value?.trim() === ''))
+        ?.filter(([_, value]) => value != null && !(isString(value) && value?.trim() === ''))
         ?.flatMap(([key, value]) => Array.isArray(value)
         ? value
-            ?.filter((v) => v !== undefined &&
-            v !== null &&
-            !(typeof v === 'string' && v.trim() === ''))
-            ?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(typeof v === 'boolean' ? String(v) : String(v))}`)
-        : `${encodeURIComponent(key)}=${encodeURIComponent(typeof value === 'boolean' ? String(value) : String(value))}`)
+            ?.filter((v) => v != null && !(isString(v) && v.trim() === ''))
+            ?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(String(v))}`)
+        : `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
         .join('&');
     return queryParams ? `?${queryParams}` : '';
 }

package/dist/esm/form/convert.js

@@ -1,6 +1,6 @@
 import { isDateLike } from '../date/guards.js';
 import { isEmptyObject, isNotEmptyObject, isValidArray } from '../guards/non-primitives.js';
-import { isNonEmptyString } from '../guards/primitives.js';
+import { isNonEmptyString, isString } from '../guards/primitives.js';
 import { isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileOrBlob, isFileUpload, } from './guards.js';
 export const createControlledFormData = (data, configs) => {
     const formData = new FormData();
@@ -67,7 +67,7 @@ export const createControlledFormData = (data, configs) => {
                     }
                 }
                 else {
-                    if (typeof value === 'string') {
+                    if (isString(value)) {
                         if (isNonEmptyString(value)) {
                             let cleanString = value;
                             if (configs?.trimStrings) {
@@ -172,7 +172,7 @@ export const createControlledFormData = (data, configs) => {
         else {
             const isNotNullish = value != null && value !== '';
             if (isNotNullish || _isRequiredKey(key)) {
-                if (typeof value === 'string' && _shouldLowercaseValue(key)) {
+                if (isString(value) && _shouldLowercaseValue(key)) {
                     formData.append(transformedKey, value?.toLowerCase());
                 }
                 else {

package/dist/esm/form/guards.js

@@ -1,3 +1,4 @@
+import { isString } from '../guards/primitives.js';
 export function isValidFormData(value) {
     if (!(value instanceof FormData))
         return false;
@@ -15,7 +16,7 @@ export function isOriginFileObj(value) {
         return false;
     }
     const obj = value;
-    return typeof obj.uid === 'string';
+    return isString(obj.uid);
 }
 export function isCustomFile(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {

package/dist/esm/form/transform.js

@@ -1,4 +1,5 @@
 import { generateQueryParams } from '../dom/query.js';
+import { isString } from '../guards/primitives.js';
 import { parseObjectValues } from '../object/sanitize.js';
 export function serializeForm(form, toQueryString = false) {
     const formData = new FormData(form);
@@ -21,11 +22,11 @@ export function serializeForm(form, toQueryString = false) {
 }
 export function parseFormData(data, parsePrimitives = true) {
     const parsed = {};
-    if (typeof data === 'string') {
+    if (isString(data)) {
         const params = new URLSearchParams(data);
         params?.forEach((value, key) => {
             const existing = parsed[key];
-            if (typeof existing === 'string') {
+            if (isString(existing)) {
                 parsed[key] = [existing, value];
             }
             else if (Array.isArray(existing)) {
@@ -51,7 +52,7 @@ export function parseFormData(data, parsePrimitives = true) {
                 }
             }
             else {
-                if (typeof existing === 'string') {
+                if (isString(existing)) {
                     parsed[key] = [existing, value];
                 }
                 else if (Array.isArray(existing)) {

package/dist/esm/number/basics.js

@@ -1,4 +1,4 @@
-import { isNumber } from '../guards/primitives.js';
+import { isNumber, isUndefined } from '../guards/primitives.js';
 import { _find2NumbersHCF, _find2NumbersLCM } from './helpers.js';
 import { normalizeNumber } from './utilities.js';
 export const getRandomNumber = (options) => {
@@ -32,10 +32,13 @@ export const getRandomNumber = (options) => {
 };
 export const convertToDecimal = (input, options) => {
     const { decimalPlaces = 2, isString = false } = options || {};
-    const number = typeof input === 'number' ? input : Number(input);
-    return isString
-        ? number.toFixed(decimalPlaces)
-        : Number(number.toFixed(decimalPlaces));
+    const parsed = normalizeNumber(input);
+    if (isUndefined(parsed)) {
+        throw new TypeError(`Invalid numeric input!`, {
+            cause: `${input} cannot be converted to a number.`,
+        });
+    }
+    return (isString ? parsed.toFixed(decimalPlaces) : Number(parsed.toFixed(decimalPlaces)));
 };
 export const calculateHCF = (...numbers) => {
     const converted = numbers?.map(Number);
@@ -103,7 +106,7 @@ export function getAverage(...numbers) {
     let count = 0;
     for (const n of numbers) {
         const num = Number(n);
-        if (typeof num === 'number' && !isNaN(num)) {
+        if (isNumber(num)) {
             sum += num;
             count++;
         }

package/dist/esm/number/guards.js

@@ -1,8 +1,16 @@
+import { isUndefined } from '../guards/primitives.js';
+import { normalizeNumber } from './utilities.js';
 export const isEven = (input) => {
-    return input % 2 === 0;
+    const parsed = normalizeNumber(input);
+    if (isUndefined(parsed))
+        return false;
+    return parsed % 2 === 0;
 };
 export const isOdd = (input) => {
-    return input % 2 !== 0;
+    const parsed = normalizeNumber(input);
+    if (isUndefined(parsed))
+        return false;
+    return parsed % 2 !== 0;
 };
 export const isMultiple = (input, multipleOf) => {
     return input % multipleOf === 0;

package/dist/esm/number/range.js

@@ -1,4 +1,5 @@
 import { shuffleArray } from '../array/basics.js';
+import { isUndefined } from '../guards/primitives.js';
 import { convertArrayToString } from '../utils/index.js';
 import { getRandomNumber } from './basics.js';
 import { isEven, isOdd } from './guards.js';
@@ -24,7 +25,7 @@ export function getNumbersInRange(type = 'any', options) {
         }
         return numbers;
     };
-    if (type === 'prime' && multiplesOf !== undefined) {
+    if (type === 'prime' && !isUndefined(multiplesOf)) {
         console.warn('Warning: The "multiplesOf" option is ignored when the type is "prime"!');
     }
     switch (type) {
@@ -55,7 +56,5 @@ export function getNumbersInRange(type = 'any', options) {
     if (type !== 'prime') {
         output = _applyMultiples(output, multiplesOf);
     }
-    return getAsString
-        ? convertArrayToString(output, { separator })
-        : output;
+    return (getAsString ? convertArrayToString(output, { separator }) : output);
 }

package/dist/esm/pluralizer/Pluralizer.js

@@ -1,4 +1,4 @@
-import { isNonEmptyString } from '../guards/primitives.js';
+import { isNonEmptyString, isString, isUndefined } from '../guards/primitives.js';
 import { normalizeNumber } from '../number/utilities.js';
 import { irregularRules, pluralRules, singularRules, uncountables } from './rules.js';
 export class Pluralizer {
@@ -68,7 +68,7 @@ export class Pluralizer {
     }
     #isUncountable(word) {
         for (const entry of this.#uncountables) {
-            if (typeof entry === 'string') {
+            if (isString(entry)) {
                 if (entry.toLowerCase() === word)
                     return true;
             }
@@ -86,7 +86,7 @@ export class Pluralizer {
         this.#singularRules.push([rule, replacement]);
     }
     addUncountable(word) {
-        this.#uncountables.add(typeof word === 'string' ? word?.toLowerCase() : word);
+        this.#uncountables.add(isString(word) ? word?.toLowerCase() : word);
     }
     addIrregular(single, plural) {
         const singleLower = single?.toLowerCase();
@@ -96,7 +96,7 @@ export class Pluralizer {
     }
     pluralize(word, options = {}) {
         const count = normalizeNumber(options?.count);
-        if (typeof count === 'number') {
+        if (!isUndefined(count)) {
             const pluralized = count === 1 ? this.toSingular(word) : this.toPlural(word);
             return options?.inclusive ? `${count} ${pluralized}` : pluralized;
         }

package/dist/esm/string/convert.js

@@ -1,7 +1,8 @@
+import { isString } from '../guards/primitives.js';
 import { trimString } from './basics.js';
 export const replaceAllInString = (input, find, replace) => {
     const trimmedString = trimString(input);
-    const regex = typeof find === 'string'
+    const regex = isString(find)
         ? new RegExp(find, 'g')
         : new RegExp(find, find?.flags.includes('g') ? find?.flags : find?.flags + 'g');
     return trimmedString?.replace(regex, replace);

package/dist/esm/utils/index.js

@@ -179,7 +179,7 @@ export function deepParsePrimitives(input) {
     return input;
 }
 export function definePrototypeMethod(proto, name, impl, options) {
-    const alreadyExists = Object.prototype.hasOwnProperty.call(proto, name);
+    const alreadyExists = Object.hasOwn(proto, name);
     if (alreadyExists && !options?.overwrite)
         return;
     Object.defineProperty(proto, name, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.29.10",
+  "version": "4.29.21",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -44,14 +44,14 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@biomejs/biome": "^2.4.9",
+    "@biomejs/biome": "^2.4.10",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.5.0",
     "husky": "^9.1.7",
     "jest": "^30.3.0",
     "lint-staged": "^16.4.0",
     "nhb-scripts": "^1.9.2",
-    "ts-jest": "^29.4.6",
+    "ts-jest": "^29.4.9",
     "typescript": "^6.0.2"
   },
   "keywords": [