nhb-toolbox 4.28.30 → 4.28.44

package/CHANGELOG.md

@@ -6,6 +6,15 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.28.44] - 2025-12-19
+
+- **Updated** `DateTimeFormatOptions` with *improved type system* and **removed** *unsupported* **locales/currencies** from *constants* and *types*.
+
+## [4.28.40] - 2025-12-15
+
+- **Added** *new class* `TextCodec` with only *static methods* to convert between `text`, `hex`, `binary`, and `Base64` representations using *byte-level transformations*.
+- **Added** *new utility* `hexToBytes` with 2 new special *type guards:* `isHexString` and `isBinaryString`.
+
 ## [4.28.30] - 2025-12-13
 
 - **Updated** *tsdoc* for `Chronos` and *signature* of `Currency` class with generic `CurrencyCode`.

package/dist/cjs/date/Chronos.js

@@ -216,7 +216,7 @@ class Chronos {
         return this.toDate().toISOString();
     }
     toLocaleString(locales, options) {
-        return this.toUTC().toDate().toLocaleString(locales, options);
+        return this.#date.toLocaleString(locales, options);
     }
     getTimeStamp() {
         return this.toDate().getTime();

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.chronos = void 0;
 const Chronos_1 = require("./Chronos");
-const chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
+const $chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
     if (typeof valueOrYear === 'number' && typeof month === 'number') {
         return new Chronos_1.Chronos(valueOrYear, month, date ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
     }
@@ -10,27 +10,25 @@ const chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
         return new Chronos_1.Chronos(valueOrYear);
     }
 };
-const chronosStatics = new Proxy(chronos, {
+function _isChronosStaticKey(prop) {
+    return (prop in Chronos_1.Chronos &&
+        prop !== 'prototype' &&
+        prop !== 'name' &&
+        prop !== 'length' &&
+        typeof Chronos_1.Chronos[prop] === 'function');
+}
+const chronosStatics = new Proxy($chronos, {
     get(target, prop, receiver) {
         if (prop in target) {
             return Reflect.get(target, prop, receiver);
         }
-        if (prop in Chronos_1.Chronos &&
-            prop !== 'prototype' &&
-            prop !== 'name' &&
-            prop !== 'length' &&
-            typeof Chronos_1.Chronos[prop] === 'function') {
+        if (_isChronosStaticKey(prop)) {
             return Chronos_1.Chronos[prop];
         }
         return Reflect.get(target, prop, receiver);
     },
     has(target, prop) {
-        return (prop in target ||
-            (prop in Chronos_1.Chronos &&
-                prop !== 'prototype' &&
-                prop !== 'name' &&
-                prop !== 'length' &&
-                typeof Chronos_1.Chronos[prop] === 'function'));
+        return prop in target || _isChronosStaticKey(prop);
     },
 });
 exports.chronos = chronosStatics;

package/dist/cjs/date/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MS_MAP = exports.TIME_UNIT_VARIANTS = exports.ZODIAC_PRESETS = exports.VEDIC_ZODIAC_SIGNS = exports.WESTERN_ZODIAC_SIGNS = exports.DATE_PART_RANGES = exports.SORTED_TIME_FORMATS = exports.TIME_FORMATS = exports.MILLISECOND_FORMATS = exports.ZONE_FORMATS = exports.SECOND_FORMATS = exports.MINUTE_FORMATS = exports.HOUR_FORMATS = exports.DAY_FORMATS = exports.DATE_FORMATS = exports.MONTH_FORMATS = exports.YEAR_FORMATS = exports.MONTHS = exports.DAYS = exports.INTERNALS = void 0;
+exports.LOCALE_NUMBERING_SYSTEMS = exports.LOCALE_CALENDARS = exports.MS_MAP = exports.TIME_UNIT_VARIANTS = exports.ZODIAC_PRESETS = exports.VEDIC_ZODIAC_SIGNS = exports.WESTERN_ZODIAC_SIGNS = exports.DATE_PART_RANGES = exports.SORTED_TIME_FORMATS = exports.TIME_FORMATS = exports.MILLISECOND_FORMATS = exports.ZONE_FORMATS = exports.SECOND_FORMATS = exports.MINUTE_FORMATS = exports.HOUR_FORMATS = exports.DAY_FORMATS = exports.DATE_FORMATS = exports.MONTH_FORMATS = exports.YEAR_FORMATS = exports.MONTHS = exports.DAYS = exports.INTERNALS = void 0;
 exports.INTERNALS = Symbol('Internals');
 exports.DAYS = /* @__PURE__ */ Object.freeze([
     'Sunday',
@@ -151,3 +151,102 @@ exports.MS_MAP = /* @__PURE__ */ Object.freeze((() => {
         milliseconds: 1,
     };
 })());
+exports.LOCALE_CALENDARS = /* @__PURE__ */ Object.freeze([
+    'buddhist',
+    'chinese',
+    'coptic',
+    'dangi',
+    'ethioaa',
+    'ethiopic',
+    'gregory',
+    'hebrew',
+    'indian',
+    'islamic',
+    'islamic-civil',
+    'islamic-rgsa',
+    'islamic-tbla',
+    'islamic-umalqura',
+    'iso8601',
+    'japanese',
+    'persian',
+    'roc',
+]);
+exports.LOCALE_NUMBERING_SYSTEMS = /* @__PURE__ */ Object.freeze([
+    'adlm',
+    'ahom',
+    'arab',
+    'arabext',
+    'bali',
+    'beng',
+    'bhks',
+    'brah',
+    'cakm',
+    'cham',
+    'deva',
+    'diak',
+    'fullwide',
+    'gara',
+    'gong',
+    'gonm',
+    'gujr',
+    'gukh',
+    'guru',
+    'hanidec',
+    'hmng',
+    'hmnp',
+    'java',
+    'kali',
+    'kawi',
+    'khmr',
+    'knda',
+    'krai',
+    'lana',
+    'lanatham',
+    'laoo',
+    'latn',
+    'lepc',
+    'limb',
+    'mathbold',
+    'mathdbl',
+    'mathmono',
+    'mathsanb',
+    'mathsans',
+    'mlym',
+    'modi',
+    'mong',
+    'mroo',
+    'mtei',
+    'mymr',
+    'mymrepka',
+    'mymrpao',
+    'mymrshan',
+    'mymrtlng',
+    'nagm',
+    'newa',
+    'nkoo',
+    'olck',
+    'onao',
+    'orya',
+    'osma',
+    'outlined',
+    'rohg',
+    'saur',
+    'segment',
+    'shrd',
+    'sind',
+    'sinh',
+    'sora',
+    'sund',
+    'sunu',
+    'takr',
+    'talu',
+    'tamldec',
+    'telu',
+    'thai',
+    'tibt',
+    'tirh',
+    'tnsa',
+    'vaii',
+    'wara',
+    'wcho',
+]);

package/dist/cjs/guards/specials.js

@@ -8,6 +8,8 @@ exports.isBrowser = isBrowser;
 exports.isNode = isNode;
 exports.isURL = isURL;
 exports.isBase64 = isBase64;
+exports.isHexString = isHexString;
+exports.isBinaryString = isBinaryString;
 exports.isPhoneNumber = isPhoneNumber;
 exports.isIPAddress = isIPAddress;
 exports.isEnvironment = isEnvironment;
@@ -49,6 +51,14 @@ function isBase64(value) {
     return ((0, primitives_1.isString)(value) &&
         /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value));
 }
+function isHexString(value) {
+    return ((0, primitives_1.isString)(value) &&
+        /^[\da-fA-F\s]+$/.test(value) &&
+        value.replace(/\s+/g, '').length % 2 === 0);
+}
+function isBinaryString(value) {
+    return ((0, primitives_1.isString)(value) && /^[01\s]+$/.test(value) && value.replace(/\s+/g, '').length % 8 === 0);
+}
 function isPhoneNumber(value) {
     return (0, primitives_1.isString)(value) && /^\+?[1-9]\d{1,14}$/.test(value);
 }

package/dist/cjs/hash/TextCodec.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextCodec = void 0;
+const primitives_1 = require("../guards/primitives");
+const specials_1 = require("../guards/specials");
+const helpers_1 = require("./helpers");
+const utils_1 = require("./utils");
+class TextCodec {
+    constructor() { }
+    static isValidHex(hex) {
+        return (0, specials_1.isHexString)(hex);
+    }
+    static isValidBinary(binary) {
+        return (0, specials_1.isBinaryString)(binary);
+    }
+    static isValidBase64(b64) {
+        return (0, specials_1.isBase64)(b64);
+    }
+    static utf8ToHex(text, spaced = true) {
+        return [...(0, utils_1.utf8ToBytes)(text)]
+            .map((b) => (0, helpers_1._padStartWith0)(b, 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static utf8ToBinary(text, spaced = true) {
+        return [...(0, utils_1.utf8ToBytes)(text)]
+            .map((b) => (0, helpers_1._padStartWith0)(b, 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static hexToUtf8(hex) {
+        return (0, utils_1.bytesToUtf8)((0, utils_1.hexToBytes)(hex));
+    }
+    static binaryToUtf8(binary) {
+        if (!(0, specials_1.isBinaryString)(binary))
+            return '';
+        const bytes = (0, helpers_1._splitByCharLength)(binary, 8).map((b) => parseInt(b, 2));
+        return (0, utils_1.bytesToUtf8)(new Uint8Array(bytes));
+    }
+    static hexToBinary(hex, spaced = true) {
+        if (!(0, specials_1.isHexString)(hex))
+            return '';
+        return (0, helpers_1._splitByCharLength)(hex, 2)
+            .map((h) => (0, helpers_1._padStartWith0)(parseInt(h, 16), 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static binaryToHex(binary, spaced = true) {
+        if (!(0, specials_1.isBinaryString)(binary))
+            return '';
+        return (0, helpers_1._splitByCharLength)(binary, 8)
+            .map((b) => (0, helpers_1._padStartWith0)(parseInt(b, 2), 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static base64ToUtf8(b64) {
+        if (!(0, specials_1.isBase64)(b64))
+            return '';
+        return (0, utils_1.bytesToUtf8)((0, utils_1.base64ToBytes)(b64));
+    }
+    static utf8ToBase64(text) {
+        if (!(0, primitives_1.isNonEmptyString)(text))
+            return '';
+        return (0, utils_1.bytesToBase64)((0, utils_1.utf8ToBytes)(text));
+    }
+    static base64ToHex(b64, spaced = true) {
+        return this.utf8ToHex(this.base64ToUtf8(b64), spaced);
+    }
+    static base64ToBinary(b64, spaced = true) {
+        return this.utf8ToBinary(this.base64ToUtf8(b64), spaced);
+    }
+    static hexToBase64(hex) {
+        return this.utf8ToBase64(this.hexToUtf8(hex));
+    }
+    static binaryToBase64(binary) {
+        return this.utf8ToBase64(this.binaryToUtf8(binary));
+    }
+}
+exports.TextCodec = TextCodec;

package/dist/cjs/hash/helpers.js

@@ -10,6 +10,8 @@ exports._formatUUID = _formatUUID;
 exports._isOptionV3V5 = _isOptionV3V5;
 exports._checkUUIDVersion = _checkUUIDVersion;
 exports._constantTimeEquals = _constantTimeEquals;
+exports._splitByCharLength = _splitByCharLength;
+exports._padStartWith0 = _padStartWith0;
 const non_primitives_1 = require("../guards/non-primitives");
 const primitives_1 = require("../guards/primitives");
 const specials_1 = require("../guards/specials");
@@ -168,3 +170,16 @@ function _constantTimeEquals(a, b) {
     }
     return res === 0;
 }
+function _splitByCharLength(str, splitByChars = 2) {
+    if (!(0, primitives_1.isNonEmptyString)(str))
+        return [];
+    const sanitized = str.replace(/\s+/g, '');
+    const result = [];
+    for (let i = 0; i < sanitized.length; i += splitByChars) {
+        result.push(sanitized.slice(i, i + splitByChars));
+    }
+    return result;
+}
+function _padStartWith0(byte, type) {
+    return byte.toString(type === 'hex' ? 16 : 2).padStart(type === 'hex' ? 2 : 8, '0');
+}

package/dist/cjs/hash/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uuid = exports.isUUIDv8 = exports.isUUIDv7 = exports.isUUIDv6 = exports.isUUIDv5 = exports.isUUIDv4 = exports.isUUIDv3 = exports.isUUIDv2 = exports.isUUIDv1 = exports.decodeUUID = exports.utf8ToBytes = exports.uint8To32ArrayBE = exports.sha256Bytes = exports.randomHex = exports.intTo4BytesBE = exports.hmacSha256 = exports.concatBytes = exports.bytesToUtf8 = exports.bytesToHex = exports.bytesToBase64 = exports.base64ToBytes = exports.Signet = exports.sha256 = exports.sha1 = exports.md5 = exports.Cipher = exports.randomID = exports.generateRandomID = exports.isUUID = void 0;
+exports.uuid = exports.isUUIDv8 = exports.isUUIDv7 = exports.isUUIDv6 = exports.isUUIDv5 = exports.isUUIDv4 = exports.isUUIDv3 = exports.isUUIDv2 = exports.isUUIDv1 = exports.decodeUUID = exports.utf8ToBytes = exports.uint8To32ArrayBE = exports.sha256Bytes = exports.randomHex = exports.intTo4BytesBE = exports.hmacSha256 = exports.hexToBytes = exports.concatBytes = exports.bytesToUtf8 = exports.bytesToHex = exports.bytesToBase64 = exports.base64ToBytes = exports.TextCodec = exports.Signet = exports.sha256 = exports.sha1 = exports.md5 = exports.Cipher = exports.randomID = exports.generateRandomID = exports.isUUID = void 0;
 var specials_1 = require("../guards/specials");
 Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return specials_1.isUUID; } });
 var basics_1 = require("../string/basics");
@@ -14,12 +14,15 @@ Object.defineProperty(exports, "sha1", { enumerable: true, get: function () { re
 Object.defineProperty(exports, "sha256", { enumerable: true, get: function () { return core_1.sha256; } });
 var Signet_1 = require("./Signet");
 Object.defineProperty(exports, "Signet", { enumerable: true, get: function () { return Signet_1.Signet; } });
+var TextCodec_1 = require("./TextCodec");
+Object.defineProperty(exports, "TextCodec", { enumerable: true, get: function () { return TextCodec_1.TextCodec; } });
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "base64ToBytes", { enumerable: true, get: function () { return utils_1.base64ToBytes; } });
 Object.defineProperty(exports, "bytesToBase64", { enumerable: true, get: function () { return utils_1.bytesToBase64; } });
 Object.defineProperty(exports, "bytesToHex", { enumerable: true, get: function () { return utils_1.bytesToHex; } });
 Object.defineProperty(exports, "bytesToUtf8", { enumerable: true, get: function () { return utils_1.bytesToUtf8; } });
 Object.defineProperty(exports, "concatBytes", { enumerable: true, get: function () { return utils_1.concatBytes; } });
+Object.defineProperty(exports, "hexToBytes", { enumerable: true, get: function () { return utils_1.hexToBytes; } });
 Object.defineProperty(exports, "hmacSha256", { enumerable: true, get: function () { return utils_1.hmacSha256; } });
 Object.defineProperty(exports, "intTo4BytesBE", { enumerable: true, get: function () { return utils_1.intTo4BytesBE; } });
 Object.defineProperty(exports, "randomHex", { enumerable: true, get: function () { return utils_1.randomHex; } });

package/dist/cjs/hash/utils.js

@@ -11,6 +11,9 @@ exports.hmacSha256 = hmacSha256;
 exports.uint8To32ArrayBE = uint8To32ArrayBE;
 exports.intTo4BytesBE = intTo4BytesBE;
 exports.bytesToHex = bytesToHex;
+exports.hexToBytes = hexToBytes;
+const specials_1 = require("../guards/specials");
+const helpers_1 = require("./helpers");
 function randomHex(length, uppercase = false) {
     const genHex = () => Math.floor(Math.random() * 16).toString(16);
     const hex = Array.from({ length }, genHex).join('');
@@ -250,3 +253,9 @@ function bytesToHex(bytes) {
     }
     return hex;
 }
+function hexToBytes(hex) {
+    if (!(0, specials_1.isHexString)(hex))
+        return new Uint8Array();
+    const bytes = (0, helpers_1._splitByCharLength)(hex, 2).map((h) => parseInt(h, 16));
+    return new Uint8Array(bytes);
+}

package/dist/cjs/index.js

@@ -7,7 +7,7 @@ exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTim
 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 = 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.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = void 0;
 exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = void 0;
 exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.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 = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = 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 = 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; } });
@@ -439,12 +439,14 @@ Object.defineProperty(exports, "HttpStatus", { enumerable: true, get: function (
 Object.defineProperty(exports, "httpStatus", { enumerable: true, get: function () { return HttpStatus_1.httpStatus; } });
 var specials_1 = require("./guards/specials");
 Object.defineProperty(exports, "isBase64", { enumerable: true, get: function () { return specials_1.isBase64; } });
+Object.defineProperty(exports, "isBinaryString", { enumerable: true, get: function () { return specials_1.isBinaryString; } });
 Object.defineProperty(exports, "isBrowser", { enumerable: true, get: function () { return specials_1.isBrowser; } });
 Object.defineProperty(exports, "isDateString", { enumerable: true, get: function () { return specials_1.isDateString; } });
 Object.defineProperty(exports, "isEmail", { enumerable: true, get: function () { return specials_1.isEmail; } });
 Object.defineProperty(exports, "isEmailArray", { enumerable: true, get: function () { return specials_1.isEmailArray; } });
 Object.defineProperty(exports, "isEnvironment", { enumerable: true, get: function () { return specials_1.isEnvironment; } });
 Object.defineProperty(exports, "isExpectedNodeENV", { enumerable: true, get: function () { return specials_1.isEnvironment; } });
+Object.defineProperty(exports, "isHexString", { enumerable: true, get: function () { return specials_1.isHexString; } });
 Object.defineProperty(exports, "isIPAddress", { enumerable: true, get: function () { return specials_1.isIPAddress; } });
 Object.defineProperty(exports, "isNode", { enumerable: true, get: function () { return specials_1.isNode; } });
 Object.defineProperty(exports, "isNodeENV", { enumerable: true, get: function () { return specials_1.isEnvironment; } });

package/dist/cjs/number/constants.js

@@ -243,10 +243,6 @@ exports.CURRENCY_CODES = /* @__PURE__ */ Object.freeze([
     'VND',
     'VUV',
     'WST',
-    'XAF',
-    'XCD',
-    'XOF',
-    'XPF',
     'YER',
     'ZAR',
     'ZMW',
@@ -532,10 +528,6 @@ exports.CURRENCY_LOCALES = /* @__PURE__ */ Object.freeze({
     VND: 'vi-VN',
     VUV: 'en-VU',
     WST: 'en-WS',
-    XAF: 'fr-XAF',
-    XCD: 'en-XCD',
-    XOF: 'fr-XOF',
-    XPF: 'fr-XPF',
     YER: 'ar-YE',
     ZAR: 'en-ZA',
     ZMW: 'en-ZM',

package/dist/dts/date/Chronos.d.ts

@@ -215,10 +215,10 @@ export declare class Chronos {
     /** @instance Returns a date as a string value in ISO format (UTC). */
     toISOString(): string;
     /**
-     * @instance Wrapper over native `toLocaleString` with improved type system.
+     * @instance Wrapper over native {@link Date.toLocaleString} with improved type system.
      * @description Converts a date and time to a string by using the current or specified locale.
      *
-     * @param locales A locale string, array of locale strings, `Intl.Locale` object, or array of `Intl.Locale` objects that contain one or more language or locale tags (see: {@link LocalesArguments}). If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
+     * @param locales A locale string, array of locale strings, {@link Intl.Locale} object, or array of {@link Intl.Locale} objects that contain one or more language or locale tags (see: {@link LocalesArguments}). If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
      * @param options An object that contains one or more properties that specify comparison options (see: {@link DateTimeFormatOptions}).
      */
     toLocaleString(locales?: LocalesArguments, options?: DateTimeFormatOptions): string;

package/dist/dts/date/constants.d.ts

@@ -15,7 +15,7 @@ export declare const SECOND_FORMATS: readonly ["ss", "s"];
 export declare const ZONE_FORMATS: readonly ["ZZ"];
 export declare const MILLISECOND_FORMATS: readonly ["ms", "mss"];
 export declare const TIME_FORMATS: readonly ["a", "A"];
-export declare const SORTED_TIME_FORMATS: readonly ("MM" | "DD" | "D" | "Do" | "M" | "mmm" | "mmmm" | "d" | "dd" | "ddd" | "YYYY" | "YY" | "yyyy" | "yy" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "a" | "A" | "ss" | "s" | "ms" | "mss" | "ZZ")[];
+export declare const SORTED_TIME_FORMATS: readonly ("MM" | "ms" | "DD" | "D" | "Do" | "M" | "mmm" | "mmmm" | "d" | "dd" | "ddd" | "YYYY" | "YY" | "yyyy" | "yy" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "a" | "A" | "ss" | "s" | "mss" | "ZZ")[];
 /** Ranges for day parts. */
 export declare const DATE_PART_RANGES: Readonly<Record<DayPart, [ClockHour, ClockHour]>>;
 /** Western Zodiac Signs */
@@ -41,4 +41,8 @@ export declare const TIME_UNIT_VARIANTS: Readonly<{
     readonly millisecond: readonly ["ms", "msec", "msecs", "millisecond", "milliseconds"];
 }>;
 /** Map to different time units to milliseconds */
-export declare const MS_MAP: Readonly<Record<"year" | "month" | "hour" | "minute" | "second" | "millisecond" | "day" | "d" | "h" | "m" | "s" | "ms" | "week" | "min" | "y" | "yr" | "yrs" | "years" | "mo" | "months" | "w" | "weeks" | "days" | "hr" | "hrs" | "hours" | "mins" | "minutes" | "sec" | "secs" | "seconds" | "msec" | "msecs" | "milliseconds", number>>;
+export declare const MS_MAP: Readonly<Record<"year" | "month" | "hour" | "minute" | "second" | "millisecond" | "day" | "ms" | "hr" | "d" | "h" | "m" | "s" | "week" | "min" | "y" | "yr" | "yrs" | "years" | "mo" | "months" | "w" | "weeks" | "days" | "hrs" | "hours" | "mins" | "minutes" | "sec" | "secs" | "seconds" | "msec" | "msecs" | "milliseconds", number>>;
+/** List of locale calendars supported by {@link Intl} API */
+export declare const LOCALE_CALENDARS: readonly ["buddhist", "chinese", "coptic", "dangi", "ethioaa", "ethiopic", "gregory", "hebrew", "indian", "islamic", "islamic-civil", "islamic-rgsa", "islamic-tbla", "islamic-umalqura", "iso8601", "japanese", "persian", "roc"];
+/** List of locale numbering systems supported by {@link Intl} API */
+export declare const LOCALE_NUMBERING_SYSTEMS: readonly ["adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "brah", "cakm", "cham", "deva", "diak", "fullwide", "gara", "gong", "gonm", "gujr", "gukh", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "kawi", "khmr", "knda", "krai", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrepka", "mymrpao", "mymrshan", "mymrtlng", "nagm", "newa", "nkoo", "olck", "onao", "orya", "osma", "outlined", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "sunu", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "tnsa", "vaii", "wara", "wcho"];

package/dist/dts/date/types.d.ts

@@ -1,9 +1,9 @@
 import type { Enumerate, LocaleCode, NumberRange } from '../number/types';
 import type { Maybe } from '../types/index';
-import type { LooseLiteral, RangeTuple } from '../utils/types';
+import type { LooseLiteral, RangeTuple, Split } from '../utils/types';
 import type { Chronos } from './Chronos';
 import type { ChronosStatics } from './chronos-statics';
-import type { DATE_FORMATS, DAY_FORMATS, DAYS, HOUR_FORMATS, MILLISECOND_FORMATS, MINUTE_FORMATS, MONTH_FORMATS, MONTHS, SECOND_FORMATS, TIME_FORMATS, TIME_UNIT_VARIANTS, WESTERN_ZODIAC_SIGNS, YEAR_FORMATS, ZODIAC_PRESETS } from './constants';
+import type { DATE_FORMATS, DAY_FORMATS, DAYS, HOUR_FORMATS, LOCALE_NUMBERING_SYSTEMS, MILLISECOND_FORMATS, MINUTE_FORMATS, MONTH_FORMATS, MONTHS, SECOND_FORMATS, LOCALE_CALENDARS, TIME_FORMATS, TIME_UNIT_VARIANTS, WESTERN_ZODIAC_SIGNS, YEAR_FORMATS, ZODIAC_PRESETS } from './constants';
 import type { SEASON_PRESETS } from './seasons';
 import type { TIME_ZONE_IDS, TIME_ZONE_LABELS, TIME_ZONES, TIME_ZONES_NATIVE } from './timezone';
 export type { ChronosStatics, UTCOffset as UTCOffSet };
@@ -101,12 +101,22 @@ type DateTimeISO = 'YYYY-MM-DDTHH:mm:ss.mssZZ';
 type DateTimeConnector = ' ' | ', ' | '; ' | ' - ';
 /** Pre-defined literal types for formatting date and time. Optionally can pass any string. */
 export type StrictFormat = LooseLiteral<DateTimeISO | DateParts | TimeParts | `${DateParts}${DateTimeConnector}${TimeParts}`>;
-/** Locale arguments for `toLocaleString` method. Includes `BCP47` tags and `Intl.Locale`. */
-export type LocalesArguments = LocaleCode | Intl.Locale | Array<LocaleCode | Intl.Locale>;
-/** Format options for `toLocaleString` method. Extends `Intl.DateTimeFormatOptions `to update `timeZone` option. */
+/** `BCP47` locale string or {@link Intl.Locale} object that contain one or more language or locale tags */
+export type $LocalArguments = LooseLiteral<LocaleCode | Split<LocaleCode, '-'>[0]> | Intl.Locale;
+/** `BCP47` locale string, array of locale strings, {@link Intl.Locale} object, or array of {@link Intl.Locale} objects that contain one or more language or locale tags. */
+export type LocalesArguments = $LocalArguments | $LocalArguments[];
+/** Locale calendars supported by {@link Intl} API */
+export type LocaleCalendar = (typeof LOCALE_CALENDARS)[number];
+/** Locale numbering systems supported by {@link Intl} API */
+export type NumberingSystem = (typeof LOCALE_NUMBERING_SYSTEMS)[number];
+/** Extends {@link Intl.DateTimeFormatOptions} with improved type system. */
 export interface DateTimeFormatOptions extends Intl.DateTimeFormatOptions {
-    /** {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones Time zone identifier} excluding `'Factory'`. */
+    /** {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones Time zone identifier} to use (excluding `'Factory'`). */
     timeZone?: $TimeZoneIdentifier;
+    /** Locale calendar system to use. */
+    calendar?: LocaleCalendar;
+    /** Locale numbering system to use. */
+    numberingSystem?: NumberingSystem;
 }
 /** Iterable `Chronos` object properties */
 export interface ChronosObject {

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

@@ -45,6 +45,18 @@ export declare function isURL(value: unknown): value is string;
  * @returns `true` if the value is a valid Base64 string, otherwise `false`.
  */
 export declare function isBase64(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid hexadecimal byte sequence.
+ * @param value - The value to check, spaced between bytes or un-spaced.
+ * @returns `true` if the value is a valid hexadecimal byte sequence, otherwise `false`.
+ */
+export declare function isHexString(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid binary byte sequence.
+ * @param value - The value to check, spaced between bytes or un-spaced.
+ * @returns `true` if the value is a valid binary byte sequence, otherwise `false`.
+ */
+export declare function isBinaryString(value: unknown): value is string;
 /**
  * * Type guard to check if a value is a valid phone number.
  * @param value - The value to check.
@@ -66,8 +78,9 @@ export declare function isEnvironment(env: string): boolean;
 /**
  * * Type guard to check if a value is a string representing a finite number.
  *
- * Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
- * Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
+ * @remarks
+ * - Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
+ * - Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
  *
  * @param value - The value to test.
  * @returns `true` if the value is a string that fully represents a finite number.

package/dist/dts/hash/TextCodec.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @class `TextCodec` provides **UTF-8–safe** conversions between `text`, `hex`, `binary`, and `Base64` representations using byte-level transformations.
+ *
+ * @example
+ * TextCodec.utf8ToHex('ভাষা'); // 'e0 a6 ad e0 a6 be e0 a6 b7 e0 a6 be'
+ * TextCodec.hexToUtf8('e0 a6 ad e0 a6 be'); // 'ভা'
+ */
+export declare class TextCodec {
+    private constructor();
+    /**
+     * @static Validates whether a string represents a valid hexadecimal byte sequence.
+     *
+     * @param hex - Hex string, spaced or un-spaced (e.g. "ff 0a" or "ff0a")
+     * @returns `true` if the input is valid hex byte string
+     *
+     * @example
+     * TextCodec.isValidHex('ff 0a');
+     */
+    static isValidHex(hex: string): boolean;
+    /**
+     * @static Validates whether a string represents a valid binary byte sequence.
+     *
+     * @param binary - Binary string, spaced or un-spaced
+     * @returns `true` if the input is valid binary byte string
+     *
+     * @example
+     * TextCodec.isValidBinary('01000001');
+     */
+    static isValidBinary(binary: string): boolean;
+    /**
+     * @static Validates whether a string represents a valid Base64-encoded string.
+     *
+     * @param b64 - Base64 string to check
+     * @returns `true` if the input is valid Base64-encoded string
+     *
+     * @example
+     * TextCodec.isValidBase64('SGVsbG8=');
+     */
+    static isValidBase64(b64: string): boolean;
+    /**
+     * @static Converts UTF-8 text into hexadecimal byte representation.
+     *
+     * @param text - UTF-8 text to convert
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Hexadecimal byte string
+     *
+     * @example
+     * TextCodec.utf8ToHex('Hi');
+     */
+    static utf8ToHex(text: string, spaced?: boolean): string;
+    /**
+     * @static Converts UTF-8 text into binary byte representation.
+     *
+     * @param text - UTF-8 text to convert
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Binary byte string
+     *
+     * @example
+     * TextCodec.utf8ToBinary('A');
+     */
+    static utf8ToBinary(text: string, spaced?: boolean): string;
+    /**
+     * @static Converts hexadecimal byte string into UTF-8 text.
+     *
+     * @param hex - Hexadecimal byte string
+     * @returns Decoded UTF-8 text
+     *
+     * @example
+     * TextCodec.hexToUtf8('48 69');
+     */
+    static hexToUtf8(hex: string): string;
+    /**
+     * @static Converts binary byte string into UTF-8 text.
+     *
+     * @param binary - Binary byte string
+     * @returns Decoded UTF-8 text
+     *
+     * @example
+     * TextCodec.binaryToUtf8('01001000 01101001');
+     */
+    static binaryToUtf8(binary: string): string;
+    /**
+     * @static Converts hexadecimal byte string into binary byte string.
+     *
+     * @param hex - Hexadecimal byte string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Binary byte string
+     *
+     * @example
+     * TextCodec.hexToBinary('ff');
+     */
+    static hexToBinary(hex: string, spaced?: boolean): string;
+    /**
+     * @static Converts binary byte string into hexadecimal byte string.
+     *
+     * @param binary - Binary byte string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Hexadecimal byte string
+     *
+     * @example
+     * TextCodec.binaryToHex('00000001');
+     */
+    static binaryToHex(binary: string, spaced?: boolean): string;
+    /**
+     * @static Converts a Base64-encoded string into UTF-8 text.
+     *
+     * @param b64 - Base64 encoded string
+     * @returns Decoded UTF-8 text
+     *
+     * @example
+     * TextCodec.base64ToUtf8('SGVsbG8=');
+     */
+    static base64ToUtf8(b64: string): string;
+    /**
+     * @static Converts UTF-8 text into a Base64-encoded string.
+     *
+     * @param text - UTF-8 text to encode
+     * @returns Base64 encoded string
+     *
+     * @example
+     * TextCodec.utf8ToBase64('Hello');
+     */
+    static utf8ToBase64(text: string): string;
+    /**
+     * @static Converts Base64 directly into hexadecimal byte string.
+     *
+     * @param b64 - Base64 encoded string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Hexadecimal byte string
+     *
+     * @example
+     * TextCodec.base64ToHex('SGVsbG8=');
+     */
+    static base64ToHex(b64: string, spaced?: boolean): string;
+    /**
+     * @static Converts Base64 directly into binary byte string.
+     *
+     * @param b64 - Base64 encoded string
+     * @param spaced - Whether to separate bytes with spaces, defaults to `true`
+     * @returns Binary byte string
+     *
+     * @example
+     * TextCodec.base64ToBinary('SGVsbG8=');
+     */
+    static base64ToBinary(b64: string, spaced?: boolean): string;
+    /**
+     * @static Converts hexadecimal byte string into a Base64 string.
+     *
+     * @param hex - Hexadecimal byte string
+     * @returns Base64 encoded string
+     *
+     * @example
+     * TextCodec.hexToBase64('48 69');
+     */
+    static hexToBase64(hex: string): string;
+    /**
+     * @static Converts binary byte string into a Base64 string.
+     *
+     * @param binary - Binary byte string
+     * @returns Base64 encoded string
+     *
+     * @example
+     * TextCodec.binaryToBase64('01001000 01101001');
+     */
+    static binaryToBase64(binary: string): string;
+}

package/dist/dts/hash/helpers.d.ts

@@ -28,3 +28,7 @@ export declare function _checkUUIDVersion(value: unknown, v: `${$UUIDVersion}`):
  * Prevents timing attacks by ensuring equal-time checks regardless of data differences.
  */
 export declare function _constantTimeEquals(a: string | Uint8Array, b: string | Uint8Array): boolean;
+/** Split string by substring length, intended to be used internally for hex and binary converters only */
+export declare function _splitByCharLength(str: string, splitByChars?: number): string[];
+/** Pad start of a byte with 0 for `hex` or `binary` */
+export declare function _padStartWith0(byte: number, type: 'hex' | 'binary'): string;

package/dist/dts/hash/index.d.ts

@@ -3,5 +3,6 @@ export { generateRandomID, generateRandomID as randomID } from '../string/basics
 export { Cipher } from './Cipher';
 export { md5, sha1, sha256 } from './core';
 export { Signet } from './Signet';
-export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils';
+export { TextCodec } from './TextCodec';
+export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hexToBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils';
 export { decodeUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, uuid, } from './uuid';

package/dist/dts/hash/utils.d.ts

@@ -343,6 +343,45 @@ export declare function intTo4BytesBE(n: number): Uint8Array;
  * - Converting binary data for JSON serialization
  * - Creating hex-encoded strings for APIs and protocols
  *
- * @see {@link sha256Bytes} for raw byte hash results
+ * @see {@link hexToBytes} for reverse process
  */
 export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * * Converts a hexadecimal string to a `Uint8Array`.
+ *   - This function decodes a hexadecimal-encoded string into its raw byte representation, where every two hexadecimal characters (00–ff) are converted into one byte.
+ *
+ * @example
+ * ```ts
+ * // Convert hex to bytes
+ * const hex = '12abff00';
+ * const bytes = hexToBytes(hex);
+ * // Returns: Uint8Array(4) [18, 171, 255, 0]
+ *
+ * // Empty string
+ * const emptyBytes = hexToBytes('');
+ * // Returns: Uint8Array []
+ *
+ * // Decode SHA-256 hash from hex
+ * const hashHex = '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824';
+ * const hashBytes = hexToBytes(hashHex);
+ * // Returns: Uint8Array(32)
+ * ```
+ *
+ * @param hex - A hexadecimal string where each byte is represented by two characters (00–ff).
+ * @returns A `Uint8Array` containing the decoded bytes. Returns an empty array for invalid input.
+ *
+ * @remarks
+ * - Accepts lowercase and uppercase hexadecimal characters (0–9, a–f, A–F) with or without space between bytes
+ * - Ignores no prefixes (e.g., does not support "0x")
+ * - Requires an even number of hexadecimal characters
+ * - Efficient O(n) implementation with direct byte parsing
+ *
+ * **Common use cases:**
+ * - Decoding cryptographic hashes and signatures
+ * - Parsing hex-encoded binary payloads
+ * - Reconstructing binary data from storage or transport formats
+ * - Working with low-level protocols and binary APIs
+ *
+ * @see {@link bytesToHex} for the reverse process
+ */
+export declare function hexToBytes(hex: string): Uint8Array;

package/dist/dts/index.d.ts

@@ -65,4 +65,4 @@ export { Paginator } from './utils/Paginator';
 export { isBigInt, isBoolean, isFalsy, isInteger, isNonEmptyString, isNormalPrimitive, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives';
 export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isMethodDescriptor as isMethod, isMethodDescriptor, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';
 export { HttpStatus, httpStatus } from './http-status/HttpStatus';
-export { isBase64, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials';
+export { isBase64, isBinaryString, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isHexString, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials';

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

@@ -7,10 +7,10 @@ export declare const ORDINAL_UNDER_TEEN: Readonly<Record<string, string>>;
 /** Ordinals that don't cleanly map by suffix alone */
 export declare const ORDINAL_TO_CARDINAL: Readonly<Record<string, string>>;
 /** List of ISO 4217 currency codes */
-export declare const CURRENCY_CODES: readonly ["AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "FOK", "GBP", "GEL", "GGP", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IMP", "INR", "IQD", "IRR", "ISK", "JEP", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KID", "KMF", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLE", "SOS", "SRD", "SSP", "STN", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TVD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VES", "VND", "VUV", "WST", "XAF", "XCD", "XOF", "XPF", "YER", "ZAR", "ZMW", "ZWL"];
+export declare const CURRENCY_CODES: readonly ["AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "FOK", "GBP", "GEL", "GGP", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IMP", "INR", "IQD", "IRR", "ISK", "JEP", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KID", "KMF", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLE", "SOS", "SRD", "SSP", "STN", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TVD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VES", "VND", "VUV", "WST", "YER", "ZAR", "ZMW", "ZWL"];
 /** List of all supported BCP 47 locales */
 export declare const LOCALE_CODES: readonly ["af-ZA", "am-ET", "ar-AE", "ar-BH", "ar-DZ", "ar-EG", "ar-IQ", "ar-JO", "ar-KW", "ar-LB", "ar-LY", "ar-MA", "ar-OM", "ar-QA", "ar-SA", "ar-SD", "ar-SY", "ar-TN", "ar-YE", "az-AZ", "be-BY", "bg-BG", "bn-BD", "bn-IN", "bs-BA", "ca-ES", "cs-CZ", "cy-GB", "da-DK", "de-AT", "de-CH", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-IE", "en-IN", "en-NZ", "en-PH", "en-SG", "en-US", "en-ZA", "es-AR", "es-BO", "es-CL", "es-CO", "es-CR", "es-DO", "es-EC", "es-ES", "es-GT", "es-HN", "es-MX", "es-NI", "es-PA", "es-PE", "es-PR", "es-PY", "es-SV", "es-US", "es-UY", "es-VE", "et-EE", "eu-ES", "fa-IR", "fi-FI", "fil-PH", "fr-BE", "fr-CA", "fr-CH", "fr-FR", "ga-IE", "gl-ES", "gu-IN", "he-IL", "hi-IN", "hr-HR", "hu-HU", "hy-AM", "id-ID", "is-IS", "it-CH", "it-IT", "ja-JP", "ka-GE", "kk-KZ", "km-KH", "kn-IN", "ko-KR", "ky-KG", "lt-LT", "lv-LV", "mk-MK", "ml-IN", "mn-MN", "mr-IN", "ms-MY", "mt-MT", "nb-NO", "ne-NP", "nl-BE", "nl-NL", "pl-PL", "pt-BR", "pt-PT", "ro-RO", "ru-RU", "sk-SK", "sl-SI", "sq-AL", "sr-Latn", "sv-SE", "sw-KE", "ta-IN", "te-IN", "th-TH", "tr-TR", "uk-UA", "ur-PK", "uz-UZ", "vi-VN", "zh-CN", "zh-HK", "zh-TW"];
-/** Mapping of CurrencyCodes to LocaleCodes */
+/** Mapping of CurrencyCodes to `LocaleCodes` */
 export declare const CURRENCY_LOCALES: Readonly<{
     readonly AED: "ar-AE";
     readonly AFN: "fa-IR";
@@ -164,10 +164,6 @@ export declare const CURRENCY_LOCALES: Readonly<{
     readonly VND: "vi-VN";
     readonly VUV: "en-VU";
     readonly WST: "en-WS";
-    readonly XAF: "fr-XAF";
-    readonly XCD: "en-XCD";
-    readonly XOF: "fr-XOF";
-    readonly XPF: "fr-XPF";
     readonly YER: "ar-YE";
     readonly ZAR: "en-ZA";
     readonly ZMW: "en-ZM";

package/dist/esm/date/Chronos.js

@@ -213,7 +213,7 @@ export class Chronos {
         return this.toDate().toISOString();
     }
     toLocaleString(locales, options) {
-        return this.toUTC().toDate().toLocaleString(locales, options);
+        return this.#date.toLocaleString(locales, options);
     }
     getTimeStamp() {
         return this.toDate().getTime();

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

@@ -1,5 +1,5 @@
 import { Chronos } from './Chronos.js';
-const chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
+const $chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
     if (typeof valueOrYear === 'number' && typeof month === 'number') {
         return new Chronos(valueOrYear, month, date ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
     }
@@ -7,27 +7,25 @@ const chronos = (valueOrYear, month, date, hours, minutes, seconds, ms) => {
         return new Chronos(valueOrYear);
     }
 };
-const chronosStatics = new Proxy(chronos, {
+function _isChronosStaticKey(prop) {
+    return (prop in Chronos &&
+        prop !== 'prototype' &&
+        prop !== 'name' &&
+        prop !== 'length' &&
+        typeof Chronos[prop] === 'function');
+}
+const chronosStatics = new Proxy($chronos, {
     get(target, prop, receiver) {
         if (prop in target) {
             return Reflect.get(target, prop, receiver);
         }
-        if (prop in Chronos &&
-            prop !== 'prototype' &&
-            prop !== 'name' &&
-            prop !== 'length' &&
-            typeof Chronos[prop] === 'function') {
+        if (_isChronosStaticKey(prop)) {
             return Chronos[prop];
         }
         return Reflect.get(target, prop, receiver);
     },
     has(target, prop) {
-        return (prop in target ||
-            (prop in Chronos &&
-                prop !== 'prototype' &&
-                prop !== 'name' &&
-                prop !== 'length' &&
-                typeof Chronos[prop] === 'function'));
+        return prop in target || _isChronosStaticKey(prop);
     },
 });
 export { chronosStatics as chronos };

package/dist/esm/date/constants.js

@@ -148,3 +148,102 @@ export const MS_MAP = /* @__PURE__ */ Object.freeze((() => {
         milliseconds: 1,
     };
 })());
+export const LOCALE_CALENDARS = /* @__PURE__ */ Object.freeze([
+    'buddhist',
+    'chinese',
+    'coptic',
+    'dangi',
+    'ethioaa',
+    'ethiopic',
+    'gregory',
+    'hebrew',
+    'indian',
+    'islamic',
+    'islamic-civil',
+    'islamic-rgsa',
+    'islamic-tbla',
+    'islamic-umalqura',
+    'iso8601',
+    'japanese',
+    'persian',
+    'roc',
+]);
+export const LOCALE_NUMBERING_SYSTEMS = /* @__PURE__ */ Object.freeze([
+    'adlm',
+    'ahom',
+    'arab',
+    'arabext',
+    'bali',
+    'beng',
+    'bhks',
+    'brah',
+    'cakm',
+    'cham',
+    'deva',
+    'diak',
+    'fullwide',
+    'gara',
+    'gong',
+    'gonm',
+    'gujr',
+    'gukh',
+    'guru',
+    'hanidec',
+    'hmng',
+    'hmnp',
+    'java',
+    'kali',
+    'kawi',
+    'khmr',
+    'knda',
+    'krai',
+    'lana',
+    'lanatham',
+    'laoo',
+    'latn',
+    'lepc',
+    'limb',
+    'mathbold',
+    'mathdbl',
+    'mathmono',
+    'mathsanb',
+    'mathsans',
+    'mlym',
+    'modi',
+    'mong',
+    'mroo',
+    'mtei',
+    'mymr',
+    'mymrepka',
+    'mymrpao',
+    'mymrshan',
+    'mymrtlng',
+    'nagm',
+    'newa',
+    'nkoo',
+    'olck',
+    'onao',
+    'orya',
+    'osma',
+    'outlined',
+    'rohg',
+    'saur',
+    'segment',
+    'shrd',
+    'sind',
+    'sinh',
+    'sora',
+    'sund',
+    'sunu',
+    'takr',
+    'talu',
+    'tamldec',
+    'telu',
+    'thai',
+    'tibt',
+    'tirh',
+    'tnsa',
+    'vaii',
+    'wara',
+    'wcho',
+]);

package/dist/esm/guards/specials.js

@@ -35,6 +35,14 @@ export function isBase64(value) {
     return (isString(value) &&
         /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value));
 }
+export function isHexString(value) {
+    return (isString(value) &&
+        /^[\da-fA-F\s]+$/.test(value) &&
+        value.replace(/\s+/g, '').length % 2 === 0);
+}
+export function isBinaryString(value) {
+    return (isString(value) && /^[01\s]+$/.test(value) && value.replace(/\s+/g, '').length % 8 === 0);
+}
 export function isPhoneNumber(value) {
     return isString(value) && /^\+?[1-9]\d{1,14}$/.test(value);
 }

package/dist/esm/hash/TextCodec.js

@@ -0,0 +1,71 @@
+import { isNonEmptyString } from '../guards/primitives.js';
+import { isBase64, isBinaryString, isHexString } from '../guards/specials.js';
+import { _padStartWith0, _splitByCharLength } from './helpers.js';
+import { base64ToBytes, bytesToBase64, bytesToUtf8, hexToBytes, utf8ToBytes } from './utils.js';
+export class TextCodec {
+    constructor() { }
+    static isValidHex(hex) {
+        return isHexString(hex);
+    }
+    static isValidBinary(binary) {
+        return isBinaryString(binary);
+    }
+    static isValidBase64(b64) {
+        return isBase64(b64);
+    }
+    static utf8ToHex(text, spaced = true) {
+        return [...utf8ToBytes(text)]
+            .map((b) => _padStartWith0(b, 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static utf8ToBinary(text, spaced = true) {
+        return [...utf8ToBytes(text)]
+            .map((b) => _padStartWith0(b, 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static hexToUtf8(hex) {
+        return bytesToUtf8(hexToBytes(hex));
+    }
+    static binaryToUtf8(binary) {
+        if (!isBinaryString(binary))
+            return '';
+        const bytes = _splitByCharLength(binary, 8).map((b) => parseInt(b, 2));
+        return bytesToUtf8(new Uint8Array(bytes));
+    }
+    static hexToBinary(hex, spaced = true) {
+        if (!isHexString(hex))
+            return '';
+        return _splitByCharLength(hex, 2)
+            .map((h) => _padStartWith0(parseInt(h, 16), 'binary'))
+            .join(spaced ? ' ' : '');
+    }
+    static binaryToHex(binary, spaced = true) {
+        if (!isBinaryString(binary))
+            return '';
+        return _splitByCharLength(binary, 8)
+            .map((b) => _padStartWith0(parseInt(b, 2), 'hex'))
+            .join(spaced ? ' ' : '');
+    }
+    static base64ToUtf8(b64) {
+        if (!isBase64(b64))
+            return '';
+        return bytesToUtf8(base64ToBytes(b64));
+    }
+    static utf8ToBase64(text) {
+        if (!isNonEmptyString(text))
+            return '';
+        return bytesToBase64(utf8ToBytes(text));
+    }
+    static base64ToHex(b64, spaced = true) {
+        return this.utf8ToHex(this.base64ToUtf8(b64), spaced);
+    }
+    static base64ToBinary(b64, spaced = true) {
+        return this.utf8ToBinary(this.base64ToUtf8(b64), spaced);
+    }
+    static hexToBase64(hex) {
+        return this.utf8ToBase64(this.hexToUtf8(hex));
+    }
+    static binaryToBase64(binary) {
+        return this.utf8ToBase64(this.binaryToUtf8(binary));
+    }
+}

package/dist/esm/hash/helpers.js

@@ -156,3 +156,16 @@ export function _constantTimeEquals(a, b) {
     }
     return res === 0;
 }
+export function _splitByCharLength(str, splitByChars = 2) {
+    if (!isNonEmptyString(str))
+        return [];
+    const sanitized = str.replace(/\s+/g, '');
+    const result = [];
+    for (let i = 0; i < sanitized.length; i += splitByChars) {
+        result.push(sanitized.slice(i, i + splitByChars));
+    }
+    return result;
+}
+export function _padStartWith0(byte, type) {
+    return byte.toString(type === 'hex' ? 16 : 2).padStart(type === 'hex' ? 2 : 8, '0');
+}

package/dist/esm/hash/index.js

@@ -3,5 +3,6 @@ export { generateRandomID, generateRandomID as randomID } from '../string/basics
 export { Cipher } from './Cipher.js';
 export { md5, sha1, sha256 } from './core.js';
 export { Signet } from './Signet.js';
-export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils.js';
+export { TextCodec } from './TextCodec.js';
+export { base64ToBytes, bytesToBase64, bytesToHex, bytesToUtf8, concatBytes, hexToBytes, hmacSha256, intTo4BytesBE, randomHex, sha256Bytes, uint8To32ArrayBE, utf8ToBytes, } from './utils.js';
 export { decodeUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, uuid, } from './uuid.js';

package/dist/esm/hash/utils.js

@@ -1,3 +1,5 @@
+import { isHexString } from '../guards/specials.js';
+import { _splitByCharLength } from './helpers.js';
 export function randomHex(length, uppercase = false) {
     const genHex = () => Math.floor(Math.random() * 16).toString(16);
     const hex = Array.from({ length }, genHex).join('');
@@ -237,3 +239,9 @@ export function bytesToHex(bytes) {
     }
     return hex;
 }
+export function hexToBytes(hex) {
+    if (!isHexString(hex))
+        return new Uint8Array();
+    const bytes = _splitByCharLength(hex, 2).map((h) => parseInt(h, 16));
+    return new Uint8Array(bytes);
+}

package/dist/esm/index.js

@@ -50,4 +50,4 @@ export { Paginator } from './utils/Paginator.js';
 export { isBigInt, isBoolean, isFalsy, isInteger, isNonEmptyString, isNormalPrimitive, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives.js';
 export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isMethodDescriptor as isMethod, isMethodDescriptor, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives.js';
 export { HttpStatus, httpStatus } from './http-status/HttpStatus.js';
-export { isBase64, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials.js';
+export { isBase64, isBinaryString, isBrowser, isDateString, isEmail, isEmailArray, isEnvironment, isEnvironment as isExpectedNodeENV, isHexString, isIPAddress, isNode, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isNumericString, isPhoneNumber, isURL, isUUID, isEmail as isValidEmail, isURL as isValidURL, } from './guards/specials.js';

package/dist/esm/number/constants.js

@@ -240,10 +240,6 @@ export const CURRENCY_CODES = /* @__PURE__ */ Object.freeze([
     'VND',
     'VUV',
     'WST',
-    'XAF',
-    'XCD',
-    'XOF',
-    'XPF',
     'YER',
     'ZAR',
     'ZMW',
@@ -529,10 +525,6 @@ export const CURRENCY_LOCALES = /* @__PURE__ */ Object.freeze({
     VND: 'vi-VN',
     VUV: 'en-VU',
     WST: 'en-WS',
-    XAF: 'fr-XAF',
-    XCD: 'en-XCD',
-    XOF: 'fr-XOF',
-    XPF: 'fr-XPF',
     YER: 'ar-YE',
     ZAR: 'en-ZA',
     ZMW: 'en-ZM',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.30",
+  "version": "4.28.44",
   "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",
@@ -29,8 +29,13 @@
   "contributors": [
     {
       "name": "Nazmul Hassan",
-      "email": "nazmulnhb@gmail.com",
+      "email": "nazmulnhb007@yahoo.com",
       "url": "https://github.com/nazmul-nhb"
+    },
+    {
+      "name": "Nazmul Hassan",
+      "email": "nazmulnhb@gmail.com",
+      "url": "https://github.com/nhb-nazmul"
     }
   ],
   "bugs": {
@@ -41,9 +46,9 @@
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.1",
-    "@typescript-eslint/eslint-plugin": "^8.49.0",
-    "@typescript-eslint/parser": "^8.49.0",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -51,11 +56,11 @@
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "lint-staged": "^16.2.7",
-    "nhb-scripts": "^1.9.0",
+    "nhb-scripts": "^1.9.2",
     "prettier": "^3.7.4",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.49.0"
+    "typescript-eslint": "^8.50.0"
   },
   "keywords": [
     "toolbox",