nhb-toolbox 4.30.26 → 4.31.0

package/CHANGELOG.md

@@ -4,6 +4,11 @@
 
 All notable changes to the package will be documented here.
 
+## [4.31.0] - 2026-06-16
+
+- **Added** new *methods* for `Color` class: `toString()`, `toJSON()`, `Symbol.toPrimitive`.
+- **Fixed** multiple bugs and lint errors/warnings across the codebase.
+
 ## [4.30.26] - 2026-06-09
 
 - **Fixed** issues with *delimiter normalizer* and *updated return types* for *non-literal strings* in *string case converter* utilities.

package/dist/cjs/array/helpers.js

@@ -10,19 +10,11 @@ function _resolveNestedKey(obj, path) {
             if ((0, non_primitives_1.isNotEmptyObject)(acc)) {
                 return acc[key];
             }
+            return undefined;
         }, obj);
     }
 }
 function _getNumericProp(obj, path) {
-    if ((0, non_primitives_1.isNotEmptyObject)(obj)) {
-        const value = path?.split('.').reduce((acc, key) => {
-            if ((0, non_primitives_1.isNotEmptyObject)(acc)) {
-                return acc[key];
-            }
-        }, obj);
-        return (0, utilities_1.normalizeNumber)(value) ?? 0;
-    }
-    else {
-        return 0;
-    }
+    const value = _resolveNestedKey(obj, path);
+    return (0, utilities_1.normalizeNumber)(value) ?? 0;
 }

package/dist/cjs/array/transform.js

@@ -14,7 +14,7 @@ const index_1 = require("../utils/index");
 const helpers_1 = require("./helpers");
 function createOptionsArray(data, config) {
     const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', retainNumberValue = false, } = config || {};
-    if (data && data?.length) {
+    if (data?.length) {
         return data?.map((datum) => {
             const firstValue = retainNumberValue && (0, primitives_1.isNumber)(datum[firstFieldKey])
                 ? datum[firstFieldKey]

package/dist/cjs/colors/Color.js

@@ -68,6 +68,16 @@ class Color {
         yield this.hsl;
         yield this.hsla;
     }
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'string') {
+            return this.hex8;
+        }
+        else if (hint === 'number') {
+            const hex = this.hex8.endsWith('FF') ? this.hex : this.hex8;
+            return parseInt(hex.replace('#', '0x'), 16);
+        }
+        return this;
+    }
     #hex6ToHex8(hex) {
         return `${hex.toUpperCase()}${(0, utils_1.percentToHex)(100)}`;
     }
@@ -79,6 +89,12 @@ class Color {
         const [h, s, l] = (0, utils_1.extractSolidColorValues)(hsl);
         return `hsla(${h}, ${s}%, ${l}%, 1)`;
     }
+    toString() {
+        return this.hex8;
+    }
+    toJSON() {
+        return this.hex8;
+    }
     applyOpacity(opacity) {
         const hex8 = `${this.hex.slice(0, 7)}${(0, utils_1.percentToHex)(opacity)}`.toUpperCase();
         return new _a(hex8);
@@ -110,30 +126,30 @@ class Color {
     }
     blendWith(other, weight = 0.5) {
         const w = Math.max(0, Math.min(1, weight));
-        const converted = _a.isCSSColor(other) ? new _a(other) : new _a(other);
-        const [r1, b1, g1, a1] = (0, utils_1.extractAlphaColorValues)(this.rgba);
-        const [r2, b2, g2, a2] = (0, utils_1.extractAlphaColorValues)(converted.rgba);
+        const otherColor = new _a(other);
+        const [r1, g1, b1, a1] = (0, utils_1.extractAlphaColorValues)(this.rgba);
+        const [r2, g2, b2, a2] = (0, utils_1.extractAlphaColorValues)(otherColor.rgba);
         const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
-        const blendChannel = (c1, c2) => {
+        const _blendChannel = (c1, c2) => {
             return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
         };
-        const r = blendChannel(r1, r2);
-        const g = blendChannel(g1, g2);
-        const b = blendChannel(b1, b2);
+        const r = _blendChannel(r1, r2);
+        const g = _blendChannel(g1, g2);
+        const b = _blendChannel(b1, b2);
         const blended = `rgba(${r}, ${g}, ${b}, ${alpha})`;
         return new _a(blended);
     }
     contrastRatio(other) {
-        const newColor = _a.isCSSColor(other) ? new _a(other) : new _a(other);
-        const luminance = (rgb) => {
+        const otherColor = new _a(other);
+        const _luminance = (rgb) => {
             const [r, g, b] = (0, utils_1.extractSolidColorValues)(rgb).map((v) => {
                 const c = v / 255;
-                return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+                return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
             });
             return 0.2126 * r + 0.7152 * g + 0.0722 * b;
         };
-        const lum1 = luminance(this.rgb);
-        const lum2 = luminance(newColor.rgb);
+        const lum1 = _luminance(this.rgb);
+        const lum2 = _luminance(otherColor.rgb);
         const brighter = Math.max(lum1, lum2);
         const darker = Math.min(lum1, lum2);
         const ratio = (brighter + 0.05) / (darker + 0.05);

package/dist/cjs/colors/convert.js

@@ -58,7 +58,7 @@ const convertRgbToHsl = (r, g, b) => {
 };
 exports.convertRgbToHsl = convertRgbToHsl;
 const convertHslToHex = (h, s, l) => {
-    const rgb = (0, exports.convertHslToRgb)(h, s, l).match(/\d+/g).map(Number);
+    const rgb = (0, exports.convertHslToRgb)(h, s, l).match(/\d+/g)?.map(Number) ?? [0, 0, 0];
     return (0, exports.convertRgbToHex)(rgb[0], rgb[1], rgb[2]);
 };
 exports.convertHslToHex = convertHslToHex;

package/dist/cjs/colors/helpers.js

@@ -36,7 +36,7 @@ const _isSimilarToLast = (recentColors, newColor) => {
 };
 exports._isSimilarToLast = _isSimilarToLast;
 function _isValidAlpha(value) {
-    return value >= 0 && value <= 1 && !isNaN(value);
+    return value >= 0 && value <= 1 && !Number.isNaN(value);
 }
 function _isValidRGBComponent(value) {
     return value >= 0 && value <= 255;

package/dist/cjs/colors/initials.js

@@ -34,14 +34,12 @@ function getColorForInitial(input = '', opacity = 100) {
     else if (Array.isArray(input)) {
         if (input?.length < 1)
             return [...constants_1.ALPHABET_COLOR_PALETTE, ...constants_1.NUMBER_COLOR_PALETTE].map((color) => (0, helpers_1._applyOpacity)(color, hexOpacity));
-        return input
-            .map((el) => {
+        return input.flatMap((el) => {
             if (Array.isArray(el)) {
                 return getColorForInitial(el, opacity);
             }
             return getColorForInitial(el, opacity);
-        })
-            .flat();
+        });
     }
     return (0, helpers_1._applyOpacity)(DEFAULT, hexOpacity);
 }

package/dist/cjs/date/BanglaCalendar.js

@@ -27,7 +27,7 @@ class BanglaCalendar {
                     !_a.isBanglaYearEn(dateBnYrOrCfg)
                     ? dateBnYrOrCfg
                     : Date.now());
-        if (isNaN(date.getTime())) {
+        if (Number.isNaN(date.getTime())) {
             date = new Date();
         }
         const { year, month, monthDate } = this.#processDate(date);

package/dist/cjs/date/Chronos.js

@@ -104,7 +104,7 @@ class Chronos {
     }
     #toNewDate(value) {
         const date = value instanceof _a ? value.toDate() : (0, helpers_1._dateArgsToDate)(value);
-        if (isNaN(date.getTime())) {
+        if (Number.isNaN(date.getTime())) {
             throw new Error('Provided date is invalid!');
         }
         return date;
@@ -763,7 +763,7 @@ class Chronos {
         return value instanceof Date;
     }
     static isDateString(value) {
-        return (0, primitives_1.isString)(value) && !isNaN(Date.parse(value));
+        return (0, primitives_1.isString)(value) && !Number.isNaN(Date.parse(value));
     }
     static isValidChronos(value) {
         return value instanceof _a;

package/dist/cjs/date/plugins/banglaPlugin.js

@@ -10,7 +10,7 @@ const banglaPlugin = ($Chronos) => {
     function $bnDaysMonthIdx(date, variant) {
         return (0, helpers_1._bnDaysMonthIdx)(date, variant ?? DEFAULT_CONFIG.get('config')?.variant);
     }
-    $Chronos.prototype.configureBanglaCalendar = function (configs) {
+    $Chronos.prototype.configureBanglaCalendar = (configs) => {
         DEFAULT_CONFIG.set('config', configs);
     };
     $Chronos.prototype.getBanglaYear = function (locale = 'bn') {
@@ -94,7 +94,7 @@ const banglaPlugin = ($Chronos) => {
             Z: offset,
             ZZ: offset,
             S: seasonName,
-            SS: seasonName + 'কাল',
+            SS: `${seasonName}কাল`,
         };
         return (0, helpers_1._formatDateCore)(fmt || 'ddd, DD mmmm (SS), YYYY বঙ্গাব্দ - hh:mm:ss (A)', dateComponents);
     };

package/dist/cjs/date/plugins/zodiacPlugin.js

@@ -16,7 +16,7 @@ const zodiacPlugin = ($Chronos) => {
         const { birthDate } = options ?? {};
         let month;
         let date;
-        if (birthDate && birthDate?.includes('-')) {
+        if (birthDate?.includes('-')) {
             [month, date] = birthDate.split('-').map(Number);
         }
         else {
@@ -30,7 +30,7 @@ const zodiacPlugin = ($Chronos) => {
                 return sign;
             }
             if (i === 0) {
-                return sortedSigns.at(-1)[0];
+                return sortedSigns.at(-1)?.[0];
             }
         }
         return sortedSigns[0][0];
@@ -38,7 +38,7 @@ const zodiacPlugin = ($Chronos) => {
     $Chronos.prototype.zodiac = function (options) {
         return this.getZodiacSign(options);
     };
-    $Chronos.prototype.getZodiacMeta = function (sign, options) {
+    $Chronos.prototype.getZodiacMeta = (sign, options) => {
         const sortedSigns = _resolveSigns(options);
         const index = sortedSigns.findIndex(([s]) => s === sign);
         if (index === -1) {

package/dist/cjs/date/utils.js

@@ -92,7 +92,7 @@ function getTimeZoneIds(offset) {
 function formatDate(options) {
     const { date = new Date(), format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false, } = options ?? {};
     const $date = (0, helpers_1._dateArgsToDate)(date);
-    if (isNaN($date.getTime())) {
+    if (Number.isNaN($date.getTime())) {
         return 'Invalid Date!';
     }
     const _getUnitValue = (suffix) => {
@@ -108,7 +108,7 @@ function formatTimePart(time, format) {
 }
 function formatDateRelative(date, format) {
     const $date = (0, helpers_1._dateArgsToDate)(date);
-    if (isNaN($date.getTime())) {
+    if (Number.isNaN($date.getTime())) {
         return 'Invalid Date!';
     }
     const now = Date.now();
@@ -143,7 +143,7 @@ function getTimestamp(args, format) {
         $format = format || 'utc';
     }
     let date = (0, helpers_1._dateArgsToDate)($value);
-    if (isNaN(date.getTime())) {
+    if (Number.isNaN(date.getTime())) {
         date = new Date();
     }
     if ($format === 'local') {

package/dist/cjs/form/convert.js

@@ -122,11 +122,15 @@ const createControlledFormData = (data, configs) => {
             return;
         }
         if ((0, guards_2.isCustomFileArray)(value)) {
-            value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+            for (const file of value) {
+                formData.append(transformedKey, file?.originFileObj);
+            }
         }
         else if ((0, guards_2.isFileUpload)(value)) {
             if (value?.fileList) {
-                value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+                for (const file of value.fileList) {
+                    formData.append(transformedKey, file?.originFileObj);
+                }
             }
             else if (value?.file) {
                 if ((0, guards_2.isCustomFile)(value?.file)) {

package/dist/cjs/guards/specials.js

@@ -23,7 +23,7 @@ function isEmailArray(value) {
     return (0, non_primitives_1.isArray)(value) && value?.every(isEmail);
 }
 function isDateString(value) {
-    return (0, primitives_1.isString)(value) && !isNaN(Date.parse(value));
+    return (0, primitives_1.isString)(value) && !Number.isNaN(Date.parse(value));
 }
 function isUUID(value) {
     const h = '[0-9a-f]';

package/dist/cjs/hash/TextCodec.js

@@ -60,16 +60,16 @@ class TextCodec {
         return (0, utils_1.bytesToBase64)((0, utils_1.utf8ToBytes)(text));
     }
     static base64ToHex(b64, spaced = true) {
-        return this.utf8ToHex(this.base64ToUtf8(b64), spaced);
+        return TextCodec.utf8ToHex(TextCodec.base64ToUtf8(b64), spaced);
     }
     static base64ToBinary(b64, spaced = true) {
-        return this.utf8ToBinary(this.base64ToUtf8(b64), spaced);
+        return TextCodec.utf8ToBinary(TextCodec.base64ToUtf8(b64), spaced);
     }
     static hexToBase64(hex) {
-        return this.utf8ToBase64(this.hexToUtf8(hex));
+        return TextCodec.utf8ToBase64(TextCodec.hexToUtf8(hex));
     }
     static binaryToBase64(binary) {
-        return this.utf8ToBase64(this.binaryToUtf8(binary));
+        return TextCodec.utf8ToBase64(TextCodec.binaryToUtf8(binary));
     }
 }
 exports.TextCodec = TextCodec;

package/dist/cjs/hash/utils.js

@@ -106,8 +106,8 @@ function bytesToBase64(bytes) {
         out +=
             _b64chars[h1] +
                 _b64chars[h2] +
-                _b64chars[isNaN(o2) ? 64 : h3] +
-                _b64chars[isNaN(o3) ? 64 : h4];
+                _b64chars[Number.isNaN(o2) ? 64 : h3] +
+                _b64chars[Number.isNaN(o3) ? 64 : h4];
     }
     return out;
 }

package/dist/cjs/number/basics.js

@@ -128,7 +128,7 @@ function getAverage(...numbers) {
     return count === 0 ? NaN : Math.round((sum / count) * 1000) / 1000;
 }
 function roundNumber(number, roundTo = 2) {
-    const factor = Math.pow(10, roundTo);
+    const factor = 10 ** roundTo;
     const num = (0, primitives_1.isNumber)(number) ? number : Number(number);
     return Math.round(num * factor) / factor;
 }

package/dist/cjs/number/convert.js

@@ -13,7 +13,7 @@ const helpers_1 = require("./helpers");
 const utilities_1 = require("./utilities");
 function numberToWords(num) {
     let number = Math.trunc(Number(num));
-    if (!Number.isFinite(number) || isNaN(number)) {
+    if (!Number.isFinite(number) || Number.isNaN(number)) {
         return 'Invalid Number!';
     }
     const isNegative = number < 0;
@@ -217,7 +217,7 @@ function banglaToDigit(bnDigit, forceNumber = true) {
     if (forceNumber) {
         return Number(digitStr
             .split('')
-            .filter((dig) => !isNaN(Number(dig)))
+            .filter((dig) => !Number.isNaN(Number(dig)))
             .join(''));
     }
     return digitStr;

package/dist/cjs/number/fibonacci.js

@@ -28,8 +28,9 @@ function getFibonacciSeriesMemo(limit) {
         [1, 1],
     ]);
     const fib = (n) => {
-        if (memo.has(n))
+        if (memo.has(n)) {
             return memo.get(n);
+        }
         const val = fib(n - 1) + fib(n - 2);
         memo.set(n, val);
         return val;

package/dist/cjs/number/percent.js

@@ -6,7 +6,7 @@ const guards_1 = require("./guards");
 function calculatePercentage(options) {
     const { roundTo = 3 } = options;
     const _roundNumber = (num) => {
-        const factor = Math.pow(10, roundTo);
+        const factor = 10 ** roundTo;
         return Math.round(num * factor) / factor;
     };
     switch (options?.mode) {

package/dist/cjs/object/sanitize.js

@@ -143,7 +143,7 @@ function parseObjectValues(object, parseNested = true) {
                 else if (data === 'undefined') {
                     return undefined;
                 }
-                else if (!isNaN(Number(data))) {
+                else if (!Number.isNaN(Number(data))) {
                     return Number(data);
                 }
                 else

package/dist/cjs/string/basics.js

@@ -18,7 +18,7 @@ function generateRandomID(options) {
     const { prefix = '', suffix = '', timeStamp = false, length = 16, separator = '', caseOption = null, } = options || {};
     const date = timeStamp ? Date.now() : '';
     const randomString = Array.from({ length }, () => Math.random().toString(36).slice(2, 3)).join('');
-    const ID = [prefix && prefix.trim(), date, randomString, suffix && suffix.trim()]
+    const ID = [prefix?.trim(), date, randomString, suffix?.trim()]
         .filter(Boolean)
         .join(separator);
     switch (caseOption) {

package/dist/dts/colors/Color.d.ts

@@ -16,11 +16,17 @@ import type { Analogous, ColorType, CSSColor, Hex6, Hex8, HSL, HSLA, RGB, RGBA,
  */
 export declare class Color {
     #private;
+    /** {@link Hex6 Hex} color representation (without alpha). */
     readonly hex: Hex6;
+    /** {@link Hex8} color representation including alpha. */
     readonly hex8: Hex8;
+    /** {@link RGB} color representation (without alpha). */
     readonly rgb: RGB;
+    /** {@link RGBA} color representation including alpha. */
     readonly rgba: RGBA;
+    /** {@link HSL} color representation (without alpha). */
     readonly hsl: HSL;
+    /** {@link HSLA} color representation including alpha. */
     readonly hsla: HSLA;
     /**
      * * Creates a new `Color` instance with a random color and automatically converts the generated color to all other supported formats: {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA}.
@@ -157,6 +163,29 @@ export declare class Color {
     constructor(color?: ColorType | CSSColor);
     /** Iterates over the color representations (`Hex`, `RGB`, `HSL`). */
     [Symbol.iterator](): Generator<Hex8 | HSL | Hex6 | RGB | RGBA | HSLA, void, unknown>;
+    /**
+     * Allows the color to be used in string and number contexts.
+     * @param hint The hint to determine the conversion type.
+     */
+    [Symbol.toPrimitive](hint: string): number | Hex8 | this;
+    /**
+     * @instance Convert the color to string.
+     * @returns The `Hex8` representation of the color.
+     *
+     * @remarks
+     * - Called by `String()`, `Object.prototype.toString()` or in template literals.
+     * - Uses the same implementation as `toJSON()`.
+     */
+    toString(): Hex8;
+    /**
+     * @instance Convert the color to JSON.
+     * @returns The `Hex8` representation of the color.
+     *
+     * @remarks
+     * - Called by `JSON.stringify()`.
+     * - It uses the same implementation as `toString()`.
+     */
+    toJSON(): Hex8;
     /**
      * @instance Applies or modifies the opacity of a color and returns a new instance.
      *

package/dist/esm/array/helpers.js

@@ -6,19 +6,11 @@ export function _resolveNestedKey(obj, path) {
             if (isNotEmptyObject(acc)) {
                 return acc[key];
             }
+            return undefined;
         }, obj);
     }
 }
 export function _getNumericProp(obj, path) {
-    if (isNotEmptyObject(obj)) {
-        const value = path?.split('.').reduce((acc, key) => {
-            if (isNotEmptyObject(acc)) {
-                return acc[key];
-            }
-        }, obj);
-        return normalizeNumber(value) ?? 0;
-    }
-    else {
-        return 0;
-    }
+    const value = _resolveNestedKey(obj, path);
+    return normalizeNumber(value) ?? 0;
 }

package/dist/esm/array/transform.js

@@ -4,7 +4,7 @@ import { isDeepEqual } from '../utils/index.js';
 import { _resolveNestedKey } from './helpers.js';
 export function createOptionsArray(data, config) {
     const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', retainNumberValue = false, } = config || {};
-    if (data && data?.length) {
+    if (data?.length) {
         return data?.map((datum) => {
             const firstValue = retainNumberValue && isNumber(datum[firstFieldKey])
                 ? datum[firstFieldKey]

package/dist/esm/colors/Color.js

@@ -65,6 +65,16 @@ export class Color {
         yield this.hsl;
         yield this.hsla;
     }
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'string') {
+            return this.hex8;
+        }
+        else if (hint === 'number') {
+            const hex = this.hex8.endsWith('FF') ? this.hex : this.hex8;
+            return parseInt(hex.replace('#', '0x'), 16);
+        }
+        return this;
+    }
     #hex6ToHex8(hex) {
         return `${hex.toUpperCase()}${percentToHex(100)}`;
     }
@@ -76,6 +86,12 @@ export class Color {
         const [h, s, l] = extractSolidColorValues(hsl);
         return `hsla(${h}, ${s}%, ${l}%, 1)`;
     }
+    toString() {
+        return this.hex8;
+    }
+    toJSON() {
+        return this.hex8;
+    }
     applyOpacity(opacity) {
         const hex8 = `${this.hex.slice(0, 7)}${percentToHex(opacity)}`.toUpperCase();
         return new _a(hex8);
@@ -107,30 +123,30 @@ export class Color {
     }
     blendWith(other, weight = 0.5) {
         const w = Math.max(0, Math.min(1, weight));
-        const converted = _a.isCSSColor(other) ? new _a(other) : new _a(other);
-        const [r1, b1, g1, a1] = extractAlphaColorValues(this.rgba);
-        const [r2, b2, g2, a2] = extractAlphaColorValues(converted.rgba);
+        const otherColor = new _a(other);
+        const [r1, g1, b1, a1] = extractAlphaColorValues(this.rgba);
+        const [r2, g2, b2, a2] = extractAlphaColorValues(otherColor.rgba);
         const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
-        const blendChannel = (c1, c2) => {
+        const _blendChannel = (c1, c2) => {
             return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
         };
-        const r = blendChannel(r1, r2);
-        const g = blendChannel(g1, g2);
-        const b = blendChannel(b1, b2);
+        const r = _blendChannel(r1, r2);
+        const g = _blendChannel(g1, g2);
+        const b = _blendChannel(b1, b2);
         const blended = `rgba(${r}, ${g}, ${b}, ${alpha})`;
         return new _a(blended);
     }
     contrastRatio(other) {
-        const newColor = _a.isCSSColor(other) ? new _a(other) : new _a(other);
-        const luminance = (rgb) => {
+        const otherColor = new _a(other);
+        const _luminance = (rgb) => {
             const [r, g, b] = extractSolidColorValues(rgb).map((v) => {
                 const c = v / 255;
-                return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+                return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
             });
             return 0.2126 * r + 0.7152 * g + 0.0722 * b;
         };
-        const lum1 = luminance(this.rgb);
-        const lum2 = luminance(newColor.rgb);
+        const lum1 = _luminance(this.rgb);
+        const lum2 = _luminance(otherColor.rgb);
         const brighter = Math.max(lum1, lum2);
         const darker = Math.min(lum1, lum2);
         const ratio = (brighter + 0.05) / (darker + 0.05);

package/dist/esm/colors/convert.js

@@ -52,7 +52,7 @@ export const convertRgbToHsl = (r, g, b) => {
     return `hsl(${Math.round(h)}, ${Number((s * 100).toFixed(2))}%, ${Number((l * 100).toFixed(2))}%)`;
 };
 export const convertHslToHex = (h, s, l) => {
-    const rgb = convertHslToRgb(h, s, l).match(/\d+/g).map(Number);
+    const rgb = convertHslToRgb(h, s, l).match(/\d+/g)?.map(Number) ?? [0, 0, 0];
     return convertRgbToHex(rgb[0], rgb[1], rgb[2]);
 };
 export const convertHexToHsl = (hex) => {

package/dist/esm/colors/helpers.js

@@ -26,7 +26,7 @@ export const _isSimilarToLast = (recentColors, newColor) => {
     return hueDifference < 48 && saturationDifference < 24 && lightnessDifference < 16;
 };
 export function _isValidAlpha(value) {
-    return value >= 0 && value <= 1 && !isNaN(value);
+    return value >= 0 && value <= 1 && !Number.isNaN(value);
 }
 export function _isValidRGBComponent(value) {
     return value >= 0 && value <= 255;

package/dist/esm/colors/initials.js

@@ -31,14 +31,12 @@ export function getColorForInitial(input = '', opacity = 100) {
     else if (Array.isArray(input)) {
         if (input?.length < 1)
             return [...ALPHABET_COLOR_PALETTE, ...NUMBER_COLOR_PALETTE].map((color) => _applyOpacity(color, hexOpacity));
-        return input
-            .map((el) => {
+        return input.flatMap((el) => {
             if (Array.isArray(el)) {
                 return getColorForInitial(el, opacity);
             }
             return getColorForInitial(el, opacity);
-        })
-            .flat();
+        });
     }
     return _applyOpacity(DEFAULT, hexOpacity);
 }

package/dist/esm/date/BanglaCalendar.js

@@ -24,7 +24,7 @@ export class BanglaCalendar {
                     !_a.isBanglaYearEn(dateBnYrOrCfg)
                     ? dateBnYrOrCfg
                     : Date.now());
-        if (isNaN(date.getTime())) {
+        if (Number.isNaN(date.getTime())) {
             date = new Date();
         }
         const { year, month, monthDate } = this.#processDate(date);

package/dist/esm/date/Chronos.js

@@ -101,7 +101,7 @@ export class Chronos {
     }
     #toNewDate(value) {
         const date = value instanceof _a ? value.toDate() : _dateArgsToDate(value);
-        if (isNaN(date.getTime())) {
+        if (Number.isNaN(date.getTime())) {
             throw new Error('Provided date is invalid!');
         }
         return date;
@@ -760,7 +760,7 @@ export class Chronos {
         return value instanceof Date;
     }
     static isDateString(value) {
-        return isString(value) && !isNaN(Date.parse(value));
+        return isString(value) && !Number.isNaN(Date.parse(value));
     }
     static isValidChronos(value) {
         return value instanceof _a;

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

@@ -7,7 +7,7 @@ export const banglaPlugin = ($Chronos) => {
     function $bnDaysMonthIdx(date, variant) {
         return _bnDaysMonthIdx(date, variant ?? DEFAULT_CONFIG.get('config')?.variant);
     }
-    $Chronos.prototype.configureBanglaCalendar = function (configs) {
+    $Chronos.prototype.configureBanglaCalendar = (configs) => {
         DEFAULT_CONFIG.set('config', configs);
     };
     $Chronos.prototype.getBanglaYear = function (locale = 'bn') {
@@ -91,7 +91,7 @@ export const banglaPlugin = ($Chronos) => {
             Z: offset,
             ZZ: offset,
             S: seasonName,
-            SS: seasonName + 'কাল',
+            SS: `${seasonName}কাল`,
         };
         return _formatDateCore(fmt || 'ddd, DD mmmm (SS), YYYY বঙ্গাব্দ - hh:mm:ss (A)', dateComponents);
     };

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

@@ -13,7 +13,7 @@ export const zodiacPlugin = ($Chronos) => {
         const { birthDate } = options ?? {};
         let month;
         let date;
-        if (birthDate && birthDate?.includes('-')) {
+        if (birthDate?.includes('-')) {
             [month, date] = birthDate.split('-').map(Number);
         }
         else {
@@ -27,7 +27,7 @@ export const zodiacPlugin = ($Chronos) => {
                 return sign;
             }
             if (i === 0) {
-                return sortedSigns.at(-1)[0];
+                return sortedSigns.at(-1)?.[0];
             }
         }
         return sortedSigns[0][0];
@@ -35,7 +35,7 @@ export const zodiacPlugin = ($Chronos) => {
     $Chronos.prototype.zodiac = function (options) {
         return this.getZodiacSign(options);
     };
-    $Chronos.prototype.getZodiacMeta = function (sign, options) {
+    $Chronos.prototype.getZodiacMeta = (sign, options) => {
         const sortedSigns = _resolveSigns(options);
         const index = sortedSigns.findIndex(([s]) => s === sign);
         if (index === -1) {

package/dist/esm/date/utils.js

@@ -76,7 +76,7 @@ export function getTimeZoneIds(offset) {
 export function formatDate(options) {
     const { date = new Date(), format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false, } = options ?? {};
     const $date = _dateArgsToDate(date);
-    if (isNaN($date.getTime())) {
+    if (Number.isNaN($date.getTime())) {
         return 'Invalid Date!';
     }
     const _getUnitValue = (suffix) => {
@@ -92,7 +92,7 @@ export function formatTimePart(time, format) {
 }
 export function formatDateRelative(date, format) {
     const $date = _dateArgsToDate(date);
-    if (isNaN($date.getTime())) {
+    if (Number.isNaN($date.getTime())) {
         return 'Invalid Date!';
     }
     const now = Date.now();
@@ -127,7 +127,7 @@ export function getTimestamp(args, format) {
         $format = format || 'utc';
     }
     let date = _dateArgsToDate($value);
-    if (isNaN(date.getTime())) {
+    if (Number.isNaN(date.getTime())) {
         date = new Date();
     }
     if ($format === 'local') {

package/dist/esm/form/convert.js

@@ -119,11 +119,15 @@ export const createControlledFormData = (data, configs) => {
             return;
         }
         if (isCustomFileArray(value)) {
-            value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+            for (const file of value) {
+                formData.append(transformedKey, file?.originFileObj);
+            }
         }
         else if (isFileUpload(value)) {
             if (value?.fileList) {
-                value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+                for (const file of value.fileList) {
+                    formData.append(transformedKey, file?.originFileObj);
+                }
             }
             else if (value?.file) {
                 if (isCustomFile(value?.file)) {

package/dist/esm/guards/specials.js

@@ -7,7 +7,7 @@ export function isEmailArray(value) {
     return isArray(value) && value?.every(isEmail);
 }
 export function isDateString(value) {
-    return isString(value) && !isNaN(Date.parse(value));
+    return isString(value) && !Number.isNaN(Date.parse(value));
 }
 export function isUUID(value) {
     const h = '[0-9a-f]';

package/dist/esm/hash/TextCodec.js

@@ -57,15 +57,15 @@ export class TextCodec {
         return bytesToBase64(utf8ToBytes(text));
     }
     static base64ToHex(b64, spaced = true) {
-        return this.utf8ToHex(this.base64ToUtf8(b64), spaced);
+        return TextCodec.utf8ToHex(TextCodec.base64ToUtf8(b64), spaced);
     }
     static base64ToBinary(b64, spaced = true) {
-        return this.utf8ToBinary(this.base64ToUtf8(b64), spaced);
+        return TextCodec.utf8ToBinary(TextCodec.base64ToUtf8(b64), spaced);
     }
     static hexToBase64(hex) {
-        return this.utf8ToBase64(this.hexToUtf8(hex));
+        return TextCodec.utf8ToBase64(TextCodec.hexToUtf8(hex));
     }
     static binaryToBase64(binary) {
-        return this.utf8ToBase64(this.binaryToUtf8(binary));
+        return TextCodec.utf8ToBase64(TextCodec.binaryToUtf8(binary));
     }
 }

package/dist/esm/hash/utils.js

@@ -92,8 +92,8 @@ export function bytesToBase64(bytes) {
         out +=
             _b64chars[h1] +
                 _b64chars[h2] +
-                _b64chars[isNaN(o2) ? 64 : h3] +
-                _b64chars[isNaN(o3) ? 64 : h4];
+                _b64chars[Number.isNaN(o2) ? 64 : h3] +
+                _b64chars[Number.isNaN(o3) ? 64 : h4];
     }
     return out;
 }

package/dist/esm/number/basics.js

@@ -114,7 +114,7 @@ export function getAverage(...numbers) {
     return count === 0 ? NaN : Math.round((sum / count) * 1000) / 1000;
 }
 export function roundNumber(number, roundTo = 2) {
-    const factor = Math.pow(10, roundTo);
+    const factor = 10 ** roundTo;
     const num = isNumber(number) ? number : Number(number);
     return Math.round(num * factor) / factor;
 }

package/dist/esm/number/convert.js

@@ -5,7 +5,7 @@ import { _convertLessThanThousand } from './helpers.js';
 import { normalizeNumber } from './utilities.js';
 export function numberToWords(num) {
     let number = Math.trunc(Number(num));
-    if (!Number.isFinite(number) || isNaN(number)) {
+    if (!Number.isFinite(number) || Number.isNaN(number)) {
         return 'Invalid Number!';
     }
     const isNegative = number < 0;
@@ -207,7 +207,7 @@ export function banglaToDigit(bnDigit, forceNumber = true) {
     if (forceNumber) {
         return Number(digitStr
             .split('')
-            .filter((dig) => !isNaN(Number(dig)))
+            .filter((dig) => !Number.isNaN(Number(dig)))
             .join(''));
     }
     return digitStr;

package/dist/esm/number/fibonacci.js

@@ -22,8 +22,9 @@ export function getFibonacciSeriesMemo(limit) {
         [1, 1],
     ]);
     const fib = (n) => {
-        if (memo.has(n))
+        if (memo.has(n)) {
             return memo.get(n);
+        }
         const val = fib(n - 1) + fib(n - 2);
         memo.set(n, val);
         return val;

package/dist/esm/number/percent.js

@@ -3,7 +3,7 @@ import { areInvalidNumbers } from './guards.js';
 export function calculatePercentage(options) {
     const { roundTo = 3 } = options;
     const _roundNumber = (num) => {
-        const factor = Math.pow(10, roundTo);
+        const factor = 10 ** roundTo;
         return Math.round(num * factor) / factor;
     };
     switch (options?.mode) {

package/dist/esm/object/sanitize.js

@@ -139,7 +139,7 @@ export function parseObjectValues(object, parseNested = true) {
                 else if (data === 'undefined') {
                     return undefined;
                 }
-                else if (!isNaN(Number(data))) {
+                else if (!Number.isNaN(Number(data))) {
                     return Number(data);
                 }
                 else

package/dist/esm/string/basics.js

@@ -13,7 +13,7 @@ export function generateRandomID(options) {
     const { prefix = '', suffix = '', timeStamp = false, length = 16, separator = '', caseOption = null, } = options || {};
     const date = timeStamp ? Date.now() : '';
     const randomString = Array.from({ length }, () => Math.random().toString(36).slice(2, 3)).join('');
-    const ID = [prefix && prefix.trim(), date, randomString, suffix && suffix.trim()]
+    const ID = [prefix?.trim(), date, randomString, suffix?.trim()]
         .filter(Boolean)
         .join(separator);
     switch (caseOption) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.30.26",
+  "version": "4.31.0",
   "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,12 +44,12 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@biomejs/biome": "^2.4.15",
+    "@biomejs/biome": "^2.5.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.3",
     "husky": "^9.1.7",
     "jest": "^30.4.2",
-    "lint-staged": "^17.0.5",
+    "lint-staged": "^17.0.7",
     "nhb-scripts": "^1.9.2",
     "ts-jest": "^29.4.11",
     "typescript": "^6.0.3"
@@ -119,8 +119,8 @@
   ],
   "lint-staged": {
     "*.+((c|m)?js(x)?|(c|m)?ts(x)?)": [
-      "biome format --write --diagnostic-level=error",
-      "biome lint --diagnostic-level=error"
+      "biome format --write --diagnostic-level=warn",
+      "biome lint --diagnostic-level=warn"
     ]
   },
   "exports": {
@@ -437,9 +437,10 @@
     "test": "jest --coverage --verbose",
     "test:watch": "jest --onlyChanged --verbose --watch",
     "start": "start coverage/lcov-report/index.html",
-    "lint": "biome lint --diagnostic-level=error",
-    "fix": "biome check --write --diagnostic-level=error",
-    "format": "biome format --write --diagnostic-level=error",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint --diagnostic-level=warn",
+    "fix": "biome check --write --diagnostic-level=warn",
+    "format": "biome format --write --diagnostic-level=warn",
     "build": "nhb-build",
     "commit": "nhb-commit",
     "module": "nhb-module",