nhb-toolbox 4.29.1 → 4.29.20

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 All notable changes to the package will be documented here.
 
+## [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*.
+- **Added** new *date utility* `formatDateRelative` to format a date as a relative time string (e.g., `"5m ago"`, `"2h from now"`, etc.) with an optional *custom format* for dates older than a week.
+
 ## [4.29.1] - 2026-03-27
 
 - **Updated** `getLevenshteinDistance` utility to be more *efficient* by using a *single-dimensional array* instead of a *matrix* for storing intermediate distances.

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/Color.js

@@ -6,7 +6,6 @@ const primitives_1 = require("../guards/primitives");
 const convert_1 = require("./convert");
 const css_colors_1 = require("./css-colors");
 const guards_1 = require("./guards");
-const helpers_1 = require("./helpers");
 const random_1 = require("./random");
 const utils_1 = require("./utils");
 class Color {
@@ -70,7 +69,7 @@ class Color {
         yield this.hsla;
     }
     #hex6ToHex8(hex) {
-        return `${hex.toUpperCase()}${(0, helpers_1._percentToHex)(100)}`;
+        return `${hex.toUpperCase()}${(0, utils_1.percentToHex)(100)}`;
     }
     #rgbToRGBA(rgb) {
         const [r, g, b] = (0, utils_1.extractSolidColorValues)(rgb);
@@ -81,7 +80,7 @@ class Color {
         return `hsla(${h}, ${s}%, ${l}%, 1)`;
     }
     applyOpacity(opacity) {
-        const hex8 = `${this.hex.slice(0, 7)}${(0, helpers_1._percentToHex)(opacity)}`.toUpperCase();
+        const hex8 = `${this.hex.slice(0, 7)}${(0, utils_1.percentToHex)(opacity)}`.toUpperCase();
         return new _a(hex8);
     }
     applyDarkness(percent) {

package/dist/cjs/colors/convert.js

@@ -113,7 +113,7 @@ const convertRgbaToHex8 = (r, g, b, a = 1) => {
         newAlpha = 1;
         console.warn(`Alpha value must be between 0-1, ${a} converted to 1!`);
     }
-    const alphaHex = (0, helpers_1._percentToHex)(Math.round(newAlpha * 100));
+    const alphaHex = (0, utils_1.percentToHex)(Math.round(newAlpha * 100));
     const hex = (0, exports.convertRgbToHex)(r, g, b);
     return `${hex}${alphaHex}`;
 };
@@ -155,7 +155,7 @@ const convertHslaToHex8 = (h, s, l, a = 1) => {
         newAlpha = 1;
         console.warn(`Alpha value must be between 0-1, ${a} converted to 1!`);
     }
-    const alphaHex = (0, helpers_1._percentToHex)(Math.round(newAlpha * 100));
+    const alphaHex = (0, utils_1.percentToHex)(Math.round(newAlpha * 100));
     const hex = (0, exports.convertHslToHex)(h, s, l);
     return `${hex}${alphaHex}`;
 };

package/dist/cjs/colors/helpers.js

@@ -1,16 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = exports._percentToHex = void 0;
+exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = void 0;
 exports._isValidAlpha = _isValidAlpha;
 exports._isValidRGBComponent = _isValidRGBComponent;
 exports._isValidHue = _isValidHue;
 exports._isValidPercentage = _isValidPercentage;
-const _percentToHex = (percent) => {
-    const validOpacity = Math.min(100, Math.max(0, percent));
-    const alpha = Math.round((validOpacity / 100) * 255);
-    return alpha.toString(16).padStart(2, '0').toUpperCase();
-};
-exports._percentToHex = _percentToHex;
 const _applyOpacity = (color, opacity) => {
     return color?.slice(0, 7).concat(opacity);
 };

package/dist/cjs/colors/initials.js

@@ -1,16 +1,18 @@
 "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");
 function getColorForInitial(input = '', opacity = 100) {
     let initial;
-    const hexOpacity = (0, helpers_1._percentToHex)(opacity);
+    const hexOpacity = (0, utils_1.percentToHex)(opacity);
     const NUMBERS = '0123456789';
     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);
@@ -22,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

@@ -1,18 +1,45 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractAlphaColorValues = exports.extractSolidColorValues = void 0;
+exports.extractSolidColorValues = extractSolidColorValues;
+exports.extractAlphaColorValues = extractAlphaColorValues;
+exports.percentToHex = percentToHex;
+exports.applyOpacityToHex = applyOpacityToHex;
+const primitives_1 = require("../guards/primitives");
 const guards_1 = require("./guards");
-const extractSolidColorValues = (color) => {
+const helpers_1 = require("./helpers");
+function extractSolidColorValues(color) {
     if ((0, guards_1.isHSL)(color) || (0, guards_1.isRGB)(color)) {
         return (color?.trim()?.match(/[\d.]+%?/g) || [])?.map((value) => parseFloat(value));
     }
     return [0, 0, 0];
-};
-exports.extractSolidColorValues = extractSolidColorValues;
-const extractAlphaColorValues = (color) => {
+}
+function extractAlphaColorValues(color) {
     if ((0, guards_1.isHSLA)(color) || (0, guards_1.isRGBA)(color)) {
         return (color?.trim()?.match(/[\d.]+%?/g) || [])?.map((value) => parseFloat(value));
     }
     return [0, 0, 0, 0];
-};
-exports.extractAlphaColorValues = extractAlphaColorValues;
+}
+function percentToHex(percent) {
+    const validOpacity = Math.min(100, Math.max(0, percent));
+    const alpha = Math.round((validOpacity / 100) * 255);
+    return alpha.toString(16).padStart(2, '0').toUpperCase();
+}
+function applyOpacityToHex(color, opacity) {
+    if ((0, guards_1.isHex6)(color) || (0, guards_1.isHex8)(color)) {
+        const upperColor = color.toUpperCase();
+        if ((0, primitives_1.isNumber)(opacity)) {
+            return (0, helpers_1._applyOpacity)(upperColor, percentToHex(opacity));
+        }
+        else if ((0, primitives_1.isNonEmptyString)(opacity) && /^[0-9A-Fa-f]{2}$/.test(opacity)) {
+            return (0, helpers_1._applyOpacity)(upperColor, opacity.toUpperCase());
+        }
+        else {
+            return (0, helpers_1._applyOpacity)(upperColor, percentToHex(100));
+        }
+    }
+    else {
+        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

@@ -12,8 +12,11 @@ exports.getTimeZoneDetails = getTimeZoneDetails;
 exports.getTimeZoneIds = getTimeZoneIds;
 exports.formatDate = formatDate;
 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");
@@ -37,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}`;
@@ -92,6 +106,28 @@ function formatTimePart(time, format) {
     const timeWithDate = `${formatDate({ format: 'YYYY-MM-DD' })}T${(0, helpers_1._normalizeOffset)(time)}`;
     return formatDate({ date: timeWithDate, format: format || 'hh:mm:ss a' });
 }
+function formatDateRelative(date, format) {
+    const $date = (0, helpers_1._dateArgsToDate)(date);
+    if (isNaN($date.getTime())) {
+        return 'Invalid Date!';
+    }
+    const now = Date.now();
+    const then = $date.getTime();
+    const diff = Math.abs(now - then);
+    const minutes = Math.floor(diff / 60000);
+    const hours = Math.floor(diff / 3600000);
+    const days = Math.floor(diff / 86400000);
+    const suffix = then < now ? 'ago' : 'from now';
+    if (minutes < 1)
+        return 'Just now';
+    if (minutes < 60)
+        return `${minutes}m ${suffix}`;
+    if (hours < 24)
+        return `${hours}h ${suffix}`;
+    if (days < 7)
+        return `${days}d ${suffix}`;
+    return formatDate({ date, format: format || 'mmm D, yyyy hh:mm a' });
+}
 function getTimestamp(args, format) {
     let $value;
     let $format;

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/index.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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.getCharacterDifferences = exports.computeTextDiff = 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.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.banglaToDigit = 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 = exports.convertToDecimal = exports.calculateLCM = void 0;
 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.digitToBangla = exports.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = exports.convertRomanToNumeric = exports.convertRomanToInteger = exports.convertRomanToArabic = void 0;
-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.Bongabdo = exports.BnCalendar = exports.BanglaCalendar = exports.isValidUTCOffset = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isTimeWithUnit = exports.isNativeTimeZoneId = exports.isLeapYear = exports.isDateLike = exports.parseMSec = exports.parseMs = 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 = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = void 0;
-exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = 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.getTimeZoneIds = exports.getTimeZoneDetails = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getNativeTimeZoneId = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getTimestamp = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.formatTimePart = exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = void 0;
-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 = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = void 0;
-exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.stripJsonEdgeGarbage = exports.stableStringify = 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 = 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 = void 0;
-exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isHexString = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBinaryString = 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 = 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 = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = void 0;
+exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.Bongabdo = exports.BnCalendar = exports.BanglaCalendar = exports.isValidUTCOffset = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isTimeWithUnit = exports.isNativeTimeZoneId = exports.isLeapYear = exports.isDateLike = exports.parseMSec = exports.parseMs = exports.greet = exports.getGreeting = exports.generateGreeting = exports.percentToHex = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.applyOpacityToHex = 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 = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = void 0;
+exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = 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.getTimeZoneIds = exports.getTimeZoneDetails = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getNativeTimeZoneId = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getTimestamp = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.formatTimePart = exports.formatRelativeTime = exports.formatRelativeDate = exports.formatDateRelative = exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = void 0;
+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 = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = 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 = void 0;
+exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.stripJsonEdgeGarbage = exports.stableStringify = 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 = 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 = void 0;
+exports.isHexString = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBinaryString = 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 = 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 = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
 Object.defineProperty(exports, "trimString", { enumerable: true, get: function () { return basics_1.trimString; } });
@@ -203,8 +203,10 @@ var Color_1 = require("./colors/Color");
 Object.defineProperty(exports, "Color", { enumerable: true, get: function () { return Color_1.Color; } });
 Object.defineProperty(exports, "Colour", { enumerable: true, get: function () { return Color_1.Colour; } });
 var utils_1 = require("./colors/utils");
+Object.defineProperty(exports, "applyOpacityToHex", { enumerable: true, get: function () { return utils_1.applyOpacityToHex; } });
 Object.defineProperty(exports, "extractAlphaColorValues", { enumerable: true, get: function () { return utils_1.extractAlphaColorValues; } });
 Object.defineProperty(exports, "extractSolidColorValues", { enumerable: true, get: function () { return utils_1.extractSolidColorValues; } });
+Object.defineProperty(exports, "percentToHex", { enumerable: true, get: function () { return utils_1.percentToHex; } });
 var greet_1 = require("./date/greet");
 Object.defineProperty(exports, "generateGreeting", { enumerable: true, get: function () { return greet_1.getGreeting; } });
 Object.defineProperty(exports, "getGreeting", { enumerable: true, get: function () { return greet_1.getGreeting; } });
@@ -250,6 +252,9 @@ Object.defineProperty(exports, "extractTimeStringFromUTC", { enumerable: true, g
 Object.defineProperty(exports, "extractTotalMinutesFromTime", { enumerable: true, get: function () { return utils_2.getTotalMinutes; } });
 Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return utils_2.formatDate; } });
 Object.defineProperty(exports, "formatDateTime", { enumerable: true, get: function () { return utils_2.formatDate; } });
+Object.defineProperty(exports, "formatDateRelative", { enumerable: true, get: function () { return utils_2.formatDateRelative; } });
+Object.defineProperty(exports, "formatRelativeDate", { enumerable: true, get: function () { return utils_2.formatDateRelative; } });
+Object.defineProperty(exports, "formatRelativeTime", { enumerable: true, get: function () { return utils_2.formatDateRelative; } });
 Object.defineProperty(exports, "formatTimePart", { enumerable: true, get: function () { return utils_2.formatTimePart; } });
 Object.defineProperty(exports, "formatUTCOffset", { enumerable: true, get: function () { return utils_2.formatUTCOffset; } });
 Object.defineProperty(exports, "getCurrentDateTime", { enumerable: true, get: function () { return utils_2.getCurrentDateTime; } });