nhb-toolbox 4.28.66 → 4.28.71

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.71] - 2026-02-06
+
+- **Fixed** an *issue* in `reconstruct` method of `Chronos` class where the *internal state* of the reconstructed instance was not properly when the timezone offset is different from the local system's timezone offset.
+
+## [4.28.70] - 2026-02-06
+
+- **Added** *new static methods*: `isReconstructable` and `reconstruct` to `Chronos` class for *validating* and *reconstructing* instances from plain objects.
+- **Added** `getTimestamp` utility for generating ISO 8601 timestamps with options to control input date and output format.
+- **Improved** `UUID v4/v8` generation to prefer `crypto.getRandomValues` with a `Math.random` fallback when unavailable.
+
 ## [4.28.66] - 2026-01-23
 
 - **Refined** `TSDoc` to *improve* **IDE IntelliSense** for `Chronos` constructor.

package/README.md

@@ -3,15 +3,15 @@
 > “I solve problems you face daily”
 
 <p>
-  <!-- NPM Info -->
+  <!-- Package Info -->
   <a href="https://www.npmjs.com/package/nhb-toolbox" aria-label="NPM Downloads">
     <img src="https://img.shields.io/npm/dm/nhb-toolbox.svg?label=DOWNLOADS&style=flat&color=red&logo=npm" alt="Downloads" />
   </a>
   <a href="https://www.npmjs.com/package/nhb-toolbox" aria-label="Latest Version">
     <img src="https://img.shields.io/npm/v/nhb-toolbox.svg?label=NPM&style=flat&color=teal&logo=npm" alt="Latest Version" />
   </a>
-  <a href="https://bundlephobia.com/result?p=nhb-toolbox" aria-label="Bundle Size">
-    <img src="https://img.shields.io/bundlephobia/minzip/nhb-toolbox?style=flat&color=purple&label=SIZE&logo=nodedotjs" alt="Bundle Size" />
+  <a href="https://bundlejs.com/?q=nhb-toolbox" aria-label="Bundle Size">
+    <img src="https://deno.bundlejs.com/badge?q=nhb-toolbox" alt="Bundle Size" />
   </a>
 
   <!-- Project Metadata -->
@@ -515,25 +515,31 @@ debounceAction(fetchResults, 300);
 
 ## 🔗 Related Packages
 
-<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div title="React Hooks: nhb-hooks" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-hooks">
     <img src="https://img.shields.io/badge/React_Hooks-nhb--hooks-blue" alt="nhb-hooks" />
   </a>
 </div>
 
-<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div title="IndexedDB ORM: locality-idb" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/locality-idb">
+    <img src="https://img.shields.io/badge/IndexedDB_ORM-locality--idb-darkviolet" alt="locality-idb" />
+  </a>
+</div>
+
+<div title="Development Scripts: nhb-scripts" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-scripts">
     <img src="https://img.shields.io/badge/Development_Scripts-nhb--scripts-red" alt="nhb-scripts" />
   </a>
 </div>
 
-<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div title="Express Server Scaffolder: nhb-express" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-express">
     <img src="https://img.shields.io/badge/Express_Server_Scaffolder-nhb--express-orange" alt="nhb-express" />
   </a>
 </div>
 
-<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div title="Anagram Generator: nhb-anagram-generator" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-anagram-generator">
     <img src="https://img.shields.io/badge/Anagram_Generator-nhb--anagram--generator-teal" alt="nhb-anagram-generator" />
   </a>

package/dist/cjs/date/Chronos.js

@@ -104,9 +104,7 @@ class Chronos {
         return this.#date.getTime();
     }
     #toNewDate(value) {
-        const date = value instanceof _a ?
-            value.toDate()
-            : new Date((0, primitives_1.isString)(value) ? value.replace(/['"]/g, '') : (value ?? Date.now()));
+        const date = value instanceof _a ? value.toDate() : (0, helpers_1._dateArgsToDate)(value);
         if (isNaN(date.getTime())) {
             throw new Error('Provided date is invalid!');
         }
@@ -807,6 +805,20 @@ class Chronos {
     static isValidChronos(value) {
         return value instanceof _a;
     }
+    static isReconstructable(value) {
+        return (0, helpers_1._hasChronosProperties)(value);
+    }
+    static reconstruct(value) {
+        if (!(0, helpers_1._hasChronosProperties)(value)) {
+            throw new TypeError('Invalid input for reconstruction!');
+        }
+        const { native, origin, utcOffset, timeZoneName, timeZoneId, $tzTracker } = value;
+        const offsetMins = (0, utils_1.extractMinutesFromUTC)(utcOffset);
+        const instance = new _a(native);
+        const diffMins = instance.getTimeZoneOffsetMinutes() - offsetMins;
+        const target = instance.utcOffset === utcOffset ? instance : instance.add(-diffMins, 'minute');
+        return target.#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
+    }
     static use(plugin) {
         if (!_a.#plugins.has(plugin)) {
             _a.#plugins.add(plugin);

package/dist/cjs/date/helpers.js

@@ -16,6 +16,11 @@ exports._getElapsedDays = _getElapsedDays;
 exports._bnDaysMonthIdx = _bnDaysMonthIdx;
 exports._padZero = _padZero;
 exports._padShunno = _padShunno;
+exports._dateArgsToDate = _dateArgsToDate;
+exports._hasChronosProperties = _hasChronosProperties;
+const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
+const specials_1 = require("../guards/specials");
 const utilities_1 = require("../number/utilities");
 const constants_1 = require("./constants");
 const guards_1 = require("./guards");
@@ -150,3 +155,20 @@ function _padZero(value, length = 2) {
 function _padShunno(str, length = 2) {
     return str.padStart(length, '০');
 }
+function _dateArgsToDate(value) {
+    return (0, non_primitives_1.isDate)(value) ? value : (new Date((0, primitives_1.isString)(value) ? value.replace(/['"]/g, '') : (value ?? Date.now())));
+}
+function _hasChronosProperties(value) {
+    return ((0, non_primitives_1.isObjectWithKeys)(value, [
+        'origin',
+        'native',
+        'utcOffset',
+        'timeZoneName',
+        'timeZoneId',
+    ]) &&
+        (0, primitives_1.isNonEmptyString)(value.origin) &&
+        ((0, non_primitives_1.isDate)(value.native) || (0, specials_1.isDateString)(value.native)) &&
+        (0, guards_1.isValidUTCOffset)(value.utcOffset) &&
+        (0, primitives_1.isNonEmptyString)(value.timeZoneName) &&
+        ((0, primitives_1.isNonEmptyString)(value.timeZoneId) || (0, non_primitives_1.isValidArray)(value.timeZoneId)));
+}

package/dist/cjs/date/utils.js

@@ -12,7 +12,8 @@ exports.getTimeZoneDetails = getTimeZoneDetails;
 exports.getTimeZoneIds = getTimeZoneIds;
 exports.formatDate = formatDate;
 exports.formatTimePart = formatTimePart;
-const primitives_1 = require("../guards/primitives");
+exports.getTimestamp = getTimestamp;
+const non_primitives_1 = require("../guards/non-primitives");
 const guards_1 = require("./guards");
 const helpers_1 = require("./helpers");
 const timezone_1 = require("./timezone");
@@ -76,7 +77,7 @@ function getTimeZoneIds(offset) {
 }
 function formatDate(options) {
     const { date = new Date(), format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false, } = options ?? {};
-    const $date = date instanceof Date ? date : (new Date((0, primitives_1.isString)(date) ? date.replace(/['"]/g, '') : date));
+    const $date = (0, helpers_1._dateArgsToDate)(date);
     if (isNaN($date.getTime())) {
         return 'Invalid Date!';
     }
@@ -91,3 +92,29 @@ function formatTimePart(time, format) {
     const timeWithDate = `${formatDate({ format: 'YYYY-MM-DD' })}T${(0, helpers_1._normalizeOffset)(time)}`;
     return formatDate({ date: timeWithDate, format: format || 'hh:mm:ss a' });
 }
+function getTimestamp(args, format) {
+    let $value;
+    let $format;
+    const _isTsOptions = (opt) => {
+        return (0, non_primitives_1.isObject)(opt) && ('value' in opt || 'format' in opt);
+    };
+    if (_isTsOptions(args)) {
+        $value = args.value || new Date();
+        $format = args.format || 'utc';
+    }
+    else {
+        $value = args || new Date();
+        $format = format || 'utc';
+    }
+    let date = (0, helpers_1._dateArgsToDate)($value);
+    if (isNaN(date.getTime())) {
+        date = new Date();
+    }
+    if ($format === 'local') {
+        const offsetMins = date.getTimezoneOffset();
+        const localDate = new Date(date.getTime() - offsetMins * 60000);
+        const offset = formatUTCOffset(-offsetMins).slice(3);
+        return localDate.toISOString().replace('Z', offset);
+    }
+    return date.toISOString();
+}

package/dist/cjs/hash/uuid.js

@@ -43,8 +43,13 @@ function uuid(options) {
         }
         case 'v4': {
             const bytes = new Uint8Array(16);
-            for (let i = 0; i < 16; i++) {
-                bytes[i] = Math.floor(Math.random() * 256);
+            if (crypto.getRandomValues) {
+                crypto.getRandomValues(bytes);
+            }
+            else {
+                for (let i = 0; i < 16; i++) {
+                    bytes[i] = Math.floor(Math.random() * 256);
+                }
             }
             let hex = '';
             for (let i = 0; i < 16; i++) {
@@ -88,8 +93,13 @@ function uuid(options) {
                 bytes[i] = Number(temp & 0xffn);
                 temp >>= 8n;
             }
-            for (let i = 6; i < 16; i++) {
-                bytes[i] = Math.floor(Math.random() * 256);
+            if (crypto.getRandomValues) {
+                crypto.getRandomValues(bytes);
+            }
+            else {
+                for (let i = 6; i < 16; i++) {
+                    bytes[i] = Math.floor(Math.random() * 256);
+                }
             }
             let hex = '';
             for (let i = 0; i < 16; i++) {

package/dist/cjs/index.js

@@ -4,11 +4,11 @@ exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports
 exports.convertRomanToInteger = exports.convertRomanToArabic = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.banglaToDigit = exports.arabicToRoman = exports.isPerfectSquare = exports.isPartOfFibonacciSeries = exports.isPartOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isNumberInvalid = exports.isMultiple = exports.isInvalidNumber = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areNumbersInvalid = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.roundToDecimal = exports.roundNumber = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getRandomInt = exports.getFactors = exports.getFactorial = exports.getDivisors = exports.getAverageOfNumbers = exports.getAverage = exports.factorsOf = exports.factorial = exports.convertToFixed = void 0;
 exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.getRandomHSL = exports.getRandomColor = exports.generateRandomHSLColor = exports.generateRandomHSL = exports.generateRandomColorInHexRGB = exports.generateRandomColor = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.wordToNumber = exports.wordsToNumber = exports.toRomanNumeral = exports.toRoman = exports.romanToNumeric = exports.romanToInteger = exports.romanToArabic = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.digitToBangla = exports.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = exports.convertRomanToNumeric = void 0;
 exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.Bongabdo = exports.BnCalendar = exports.BanglaCalendar = exports.isValidUTCOffset = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isTimeWithUnit = exports.isNativeTimeZoneId = exports.isLeapYear = exports.isDateLike = exports.parseMSec = exports.parseMs = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.isRGBA = exports.isRGB = exports.isHSLA = exports.isHSL = exports.isHex8 = exports.isHex6 = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = void 0;
-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 = exports.formatTimePart = exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = void 0;
-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 = exports.convertIntoFormData = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = void 0;
-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 = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = void 0;
-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 = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = void 0;
-exports.isValidURL = exports.isValidEmail = void 0;
+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.getTimestamp = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.formatTimePart = exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = void 0;
+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 = exports.convertIntoFormData = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = void 0;
+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 = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = void 0;
+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 = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = 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; } });
@@ -251,6 +251,7 @@ Object.defineProperty(exports, "formatTimePart", { enumerable: true, get: functi
 Object.defineProperty(exports, "formatUTCOffset", { enumerable: true, get: function () { return utils_2.formatUTCOffset; } });
 Object.defineProperty(exports, "getCurrentDateTime", { enumerable: true, get: function () { return utils_2.getCurrentDateTime; } });
 Object.defineProperty(exports, "getCurrentTime", { enumerable: true, get: function () { return utils_2.getCurrentDateTime; } });
+Object.defineProperty(exports, "getTimestamp", { enumerable: true, get: function () { return utils_2.getTimestamp; } });
 Object.defineProperty(exports, "getHourMinutesFromMinutes", { enumerable: true, get: function () { return utils_2.convertMinutesToTime; } });
 Object.defineProperty(exports, "getMinutesFromUTC", { enumerable: true, get: function () { return utils_2.extractMinutesFromUTC; } });
 Object.defineProperty(exports, "getNativeTimeZoneId", { enumerable: true, get: function () { return utils_2.getNativeTimeZoneId; } });

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

@@ -1,7 +1,7 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { LooseLiteral, TupleOf } from '../utils/types';
 import { INTERNALS } from './constants';
-import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeOnlyFormat, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
+import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosProperties, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeOnlyFormat, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
  * @class Creates a new immutable `Chronos` instance.
  *      - **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
@@ -822,6 +822,23 @@ export declare class Chronos {
      * @returns `true` if the value is an instance of `Chronos`, otherwise `false`.
      */
     static isValidChronos(value: unknown): value is Chronos;
+    /**
+     * @static Checks if the given value has the necessary properties to be reconstructed into a `Chronos` instance.
+     * - Can be used for validating objects that may represent serialized `Chronos` data.
+     * @param value - The value to check.
+     * @returns `true` if the value has the required properties for reconstruction, otherwise `false`.
+     */
+    static isReconstructable(value: unknown): value is ChronosProperties;
+    /**
+     * @static Reconstructs a `Chronos` instance from an object containing the necessary properties.
+     * - The input object must have the properties defined in {@link ChronosProperties} interface.
+     * - If the input is not reconstructable, an error is thrown.
+     *
+     * @param value - An object containing the properties required to reconstruct a `Chronos` instance.
+     * @returns A new `Chronos` instance created from the provided properties.
+     * @throws `TypeError` if the input value does not have the necessary properties for reconstruction.
+     */
+    static reconstruct(value: ChronosProperties): Chronos;
     /**
      * @static Injects a plugin into the `Chronos` system.
      * @param plugin The plugin to inject.

package/dist/dts/date/chronos-fn.d.ts

@@ -40,6 +40,8 @@ import type { ChronosStatics } from './types';
  * chronos.isValidDate(value: unknown): boolean;
  * chronos.isDateString(value: unknown): boolean;
  * chronos.isValidChronos(value: unknown): boolean;
+ * chronos.isReconstructable(value: unknown): value is ChronosProperties;
+ * chronos.reconstruct(value: ChronosProperties): Chronos;
  * chronos.formatTimePart(time: string, format?: TimeParts): string;
  * chronos.getDatesForDay(day: WeekDay, options?: WeekdayOptions): string[];
  * chronos.use(plugin: ChronosPlugin): void;

package/dist/dts/date/chronos-statics.d.ts

@@ -1,5 +1,5 @@
 import type { Chronos } from './Chronos';
-import type { ChronosInput, ChronosPlugin, ChronosWithOptions, DateRangeOptions, FormatOptions, RelativeRangeOptions, TimeFormatToken, WeekDay, WeekdayOptions } from './types';
+import type { ChronosInput, ChronosPlugin, ChronosProperties, ChronosWithOptions, DateRangeOptions, FormatOptions, RelativeRangeOptions, TimeFormatToken, WeekDay, WeekdayOptions } from './types';
 /** All the statics methods in `Chronos` class */
 export interface ChronosStatics {
     /**
@@ -302,4 +302,21 @@ export interface ChronosStatics {
      * @returns `true` if the value is an instance of `Chronos`, otherwise `false`.
      */
     isValidChronos(value: unknown): value is Chronos;
+    /**
+     * * Checks if the given value has the necessary properties to be reconstructed into a `Chronos` instance.
+     * - Can be used for validating objects that may represent serialized `Chronos` data.
+     * @param value - The value to check.
+     * @returns `true` if the value has the required properties for reconstruction, otherwise `false`.
+     */
+    isReconstructable(value: unknown): value is ChronosProperties;
+    /**
+     * * Reconstructs a `Chronos` instance from an object containing the necessary properties.
+     * - The input object must have the properties defined in {@link ChronosProperties} interface.
+     * - If the input is not reconstructable, an error is thrown.
+     *
+     * @param value - An object containing the properties required to reconstruct a `Chronos` instance.
+     * @returns A new `Chronos` instance created from the provided properties.
+     * @throws `TypeError` if the input value does not have the necessary properties for reconstruction.
+     */
+    reconstruct(value: ChronosProperties): Chronos;
 }

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

@@ -1,6 +1,6 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { Maybe } from '../types/index';
-import type { $BnEn, $GMTOffset, $TimeZoneIdentifier, BanglaSeasonName, BnCalendarVariant, TimeZoneNameNative } from './types';
+import type { $BnEn, $GMTOffset, $TimeZoneIdentifier, BanglaSeasonName, BnCalendarVariant, ChronosProperties, DateArgs, TimeZoneNameNative } from './types';
 /** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
 export declare function _formatDateCore(format: string, dateComponents: Record<string, string>): string;
 /** Core formatting logic shared by `formatDate` and `Chronos` class */
@@ -57,4 +57,20 @@ export declare function _padZero(value: number, length?: number): string;
  * @returns The padded string
  */
 export declare function _padShunno(str: string, length?: number): string;
+/**
+ * Convert a string, number, or `Date` object to a `Date` object.
+ * - If the input is already a `Date`, it is returned as is.
+ * - If it's a string, it is parsed into a `Date`.
+ * - If it's a number or undefined, it is treated as a timestamp and converted to a `Date`.
+ * @param value The date input to convert, which can be a `Date` object, a date string, a timestamp number, or undefined (which defaults to the current date and time).
+ * @returns A `Date` object representing the input date.
+ */
+export declare function _dateArgsToDate(value: Maybe<DateArgs>): Date;
+/**
+ * Type guard to check if a value has the necessary properties to be reconstructed into a `Chronos` instance.
+ * - Validates that the value is an object with the required keys and that the `native` property is a valid date or date string, and that the `utcOffset` is valid.
+ * @param value The value to check for reconstructability.
+ * @returns `true` if the value has the required properties for reconstruction, otherwise `false`.
+ */
+export declare function _hasChronosProperties(value: unknown): value is ChronosProperties;
 export {};

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

@@ -1,5 +1,5 @@
 import type { $BnOnes, BanglaDigit, Enumerate, LocaleCode, NumberRange } from '../number/types';
-import type { Maybe } from '../types/index';
+import type { Branded, Maybe } from '../types/index';
 import type { LooseLiteral, RangeTuple, Repeat, Split } from '../utils/types';
 import type { Chronos } from './Chronos';
 import type { ChronosStatics } from './chronos-statics';
@@ -62,7 +62,7 @@ export type TimeZoneDetails = {
 /** Options for `formatDate` utility */
 export interface DateFormatOptions extends FormatOptions {
     /** - Date to format, must be parsable by {@link Date} constructor. Can be string, number or `Date`. Defaults to current time. */
-    date?: string | number | Date;
+    date?: DateArgs;
     format?: StrictFormat;
 }
 /** Name of time unit from `year` to `millisecond` */
@@ -248,6 +248,21 @@ export type ChronosMethods = $InstanceMethods | $StaticMethods | $PluginMethods;
  * and convert it to the **equivalent local time** using the current environment's UTC offset.*
  */
 export type ChronosInput = number | string | Date | Chronos;
+/** Properties required to reconstruct a `Chronos` instance. */
+export interface ChronosProperties {
+    /** The method or plugin name from which the instance was created. */
+    origin: LooseLiteral<ChronosMethods>;
+    /** The native date value, either as a `Date` object or a date string. */
+    native: Date | string;
+    /** The UTC offset in `UTC±HH:mm` format. */
+    utcOffset: UTCOffset;
+    /** The full time zone name (e.g., `"Pacific Standard Time"`). */
+    timeZoneName: LooseLiteral<TimeZoneName>;
+    /** The time zone identifier(s) associated with the instance (e.g., `"Asia/Dhaka"`). */
+    timeZoneId: TimeZoneId;
+    /** Optional tracker to identify the instance created by `timeZone` method. */
+    $tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset;
+}
 /** Represents key of `ChronosStatics` (each static method and property) */
 export type ChronosStaticKey = keyof ChronosStatics;
 /** Key of {@link TIME_ZONE_LABELS} ({@link UTCOffset}) */
@@ -280,6 +295,26 @@ export type $UTCOffset = `${PositiveUTCHour | NegativeUTCHour}:${UTCMinute}`;
 export type UTCOffset = `UTC${$UTCOffset}`;
 /** GMT offset in `GMT±HH:mm` or simply `GMT` format */
 export type $GMTOffset = `GMT${$UTCOffset}` | 'GMT';
+/** Timestamp string type in ISO 8601 format */
+export type Timestamp = Branded<string, 'Timestamp'>;
+/** Valid argument type accepted by `Date` constructor */
+export type DateArgs = string | number | Date;
+/** Type for ISO date format options */
+export type ISODateFormat = 'local' | 'utc';
+/** Options for `getTimestamp` utility */
+export interface TimestampOptions {
+    /**
+     * Optional date input (string, number, or `Date` object).
+     * Defaults to {@link Date new Date()}.
+     */
+    value?: DateArgs;
+    /**
+     * Output format for the timestamp.
+     * - `'utc'` (default) → returns ISO string in UTC (`...Z`).
+     * - `'local'` → returns ISO string with current system offset (`...+05:30`).
+     */
+    format?: ISODateFormat;
+}
 /** `Chronos` Date Format options */
 export interface FormatOptions {
     /**
@@ -349,7 +384,7 @@ export type MonthName = (typeof MONTHS)[number];
 /** Common options for formatting and rounding dates */
 interface $CommonRangeOptions {
     /** - Output format: return ISO strings in `'local'` or `'utc'` format. Defaults to `'local'`. */
-    format?: 'local' | 'utc';
+    format?: ISODateFormat;
     /** - Whether to round the dates in the range to the start of the day. Default is `false`. */
     roundDate?: boolean;
 }

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

@@ -1,5 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { $TimeZoneIdentifier, ClockTime, DateFormatOptions, HourMinutes, TimeOnlyFormat, TimeZoneDetails, TimeZoneIdNative, UTCOffset } from './types';
+import type { $TimeZoneIdentifier, ClockTime, DateArgs, DateFormatOptions, HourMinutes, ISODateFormat, TimeOnlyFormat, TimeZoneDetails, TimeZoneIdNative, Timestamp, TimestampOptions, UTCOffset } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
@@ -18,6 +18,8 @@ export declare function getTotalMinutes(time: `-${ClockTime}` | ClockTime): numb
  * * Returns the current date and time as `Date` object.
  * - All the methods and properties of `new Date()` are accessible.
  *
+ * @remarks This function is a simple wrapper around `new Date()` and is provided for consistency and potential future enhancements.
+ *
  * @returns The current date and time as a `Date` object.
  */
 export declare function getCurrentDateTime(): Date;
@@ -83,7 +85,7 @@ export declare function getTimeZoneIds(offset: UTCOffset): TimeZoneIdNative[];
  *
  * @remarks
  * - If no date is provided, the current date and time will be used.
- * - If the provided date is invalid, the function will return `"Invalid Date!"`.
+ * - If the provided date is invalid, the function will return `'Invalid Date!'`.
  * - The default format is `'dd, mmm DD, YYYY HH:mm:ss'` (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
  * - By default, local time is used; set `useUTC` to `true` to format in UTC.
  * - The format string supports various tokens for date and time components, as well as literal text enclosed in square brackets.
@@ -114,3 +116,44 @@ export declare function formatDate(options?: DateFormatOptions): string;
  * @returns Formatted time string in local (System) time.
  */
 export declare function formatTimePart(time: string, format?: TimeOnlyFormat): string;
+/**
+ * * Get timestamp in ISO 8601 format.
+ *
+ * @param value - Date value to convert to timestamp. Supported formats include:
+ * - `Date` object → e.g., `new Date()`
+ * - Date string → e.g., `'2025-04-06'`, `'2025-04-06 16:11:55'`, `'April 6, 2025 16:11:55'` etc.
+ * - Timestamp number → e.g., `1712748715000`
+ *
+ * @remarks If the provided {@link value} is invalid, the current date and time will be used.
+ *
+ * @returns Timestamp string in ISO 8601 format.
+ */
+export declare function getTimestamp(): Timestamp;
+/**
+ * * Get timestamp in ISO 8601 format.
+ *
+ * @param value - Date value to convert to timestamp. Supported formats include:
+ * - `Date` object → e.g., `new Date()`
+ * - Date string → e.g., `'2025-04-06'`, `'2025-04-06 16:11:55'`, `'April 6, 2025 16:11:55'` etc.
+ * - Timestamp number → e.g., `1712748715000`
+ * @param format - Format of the output timestamp.
+ * - Use `format: 'local'` to include the current system timezone offset.
+ * - Default is `'utc'` which returns timestamp in UTC format (ending with 'Z').
+ *
+ * @remarks If the provided {@link value} is invalid, the current date and time will be used.
+ *
+ * @returns Timestamp string in ISO 8601 format.
+ */
+export declare function getTimestamp(value: DateArgs, format?: ISODateFormat): Timestamp;
+/**
+ * * Get timestamp in ISO 8601 format.
+ *
+ * @param options Options to control date input and output format.
+ *
+ * @remarks
+ * - If the provided {@link TimestampOptions.value value} is invalid, the current date and time will be used.
+ * - Use `format: 'local'` to include the current system timezone offset.
+ *
+ * @returns Timestamp string in ISO 8601 format.
+ */
+export declare function getTimestamp(options?: TimestampOptions): Timestamp;

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

@@ -34,8 +34,9 @@ import type { DecodedUUID, SupportedVersion, UUID, UUIDOptions } from './types';
  * - This utility provides a complete, engine-agnostic UUID generator with full RFC compliance, predictable formatting, and reliable uniqueness characteristics, suitable for browsers, Node.js, and restricted JavaScript runtimes.
  * - **Notes**
  *   - `v1` and `v6` use a generated pseudo-node identifier.
- *   - `v4`, `v7`, `v8` **do not rely on crypto APIs**, preserving engine-agnostic behavior.
+ *   - `v4` and `v8` uses {@link Math.random} when {@link crypto.getRandomValues} is unavailable, ensuring broad compatibility.
  *   - `v3` and `v5` use internal `MD5`/`SHA-1` implementations and remain fully deterministic.
+ *   - `v7` **do not rely on crypto APIs**, preserving engine-agnostic behavior.
  *
  * - **Limitations**
  *   - `v1`/`v6`: Node identifier is pseudo-random, not derived from real MAC addresses (for privacy).

package/dist/dts/index.d.ts

@@ -45,7 +45,7 @@ export { BanglaCalendar, BnCalendar, Bongabdo } from './date/BanglaCalendar';
 export { Chronos, Chronus } from './date/Chronos';
 export { INTERNALS } from './date/constants';
 export { chronos, chronosjs, chronosts, chronus, chronusjs, chronusts, } from './date/chronos-fn';
-export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatTimePart, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, convertMinutesToTime as getHourMinutesFromMinutes, extractMinutesFromUTC as getMinutesFromUTC, getNativeTimeZoneId, convertMinutesToTime as getTimeFromMinutes, extractTimeFromUTC as getTimeStringFromUTC, getTimeZoneDetails, getTimeZoneIds, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils';
+export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatTimePart, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getTimestamp, convertMinutesToTime as getHourMinutesFromMinutes, extractMinutesFromUTC as getMinutesFromUTC, getNativeTimeZoneId, convertMinutesToTime as getTimeFromMinutes, extractTimeFromUTC as getTimeStringFromUTC, getTimeZoneDetails, getTimeZoneIds, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { averageByField, averageByField as avgByField, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, sumByField, sumFieldDifference, sumFieldDifference as totalDeltaByField, } from './array/calc';
 export { Finder } from './array/Finder';

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

@@ -150,7 +150,7 @@ export declare function stripJsonEdgeGarbage(str: string): string;
 /**
  * * Parses any valid JSON string, optionally converting stringified primitives inside (nested) arrays or objects.
  *
- * @template T - Expected return type (default is unknown).
+ * @typeParam T - Expected return type (default is unknown).
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives (default: `true`).
  * @returns The parsed JSON value typed as `T`, or the original parsed value with optional primitive conversion.
@@ -167,7 +167,7 @@ export declare const parseJSON: <T = unknown>(value: string, parsePrimitives?: b
 /**
  * * Recursively parses primitive values inside objects and arrays.
  *
- * @template T - Expected return type after parsing (default is unknown).
+ * @typeParam T - Expected return type after parsing (default is unknown).
  * @param input - Any input value to parse recursively.
  * @returns Input with primitives (strings like "true", "123") converted, typed as `T`.
  */

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

@@ -236,7 +236,7 @@ export type LooseLiteral<T extends string | number> = T | (T extends string ? st
 /**
  * * Extracts an object type containing only the optional keys from `T`.
  *
- * @template T - The original object type
+ * @typeParam T - The original object type
  * @returns A new object type with only optional keys from `T`
  * @example
  * type Example = { a: string; b?: number; c?: boolean };
@@ -249,7 +249,7 @@ export type ExtractOptional<T> = {
 /**
  * * Extracts an object type containing only the required keys from `T`.
  *
- * @template T - The original object type
+ * @typeParam T - The original object type
  * @returns A new object type with only required keys from `T`
  * @example
  * type Example = { a: string; b?: number; c: boolean };
@@ -262,7 +262,7 @@ export type ExtractRequired<T> = {
 /**
  * * Converts a readonly tuple to a union of its element types.
  *
- * @template T - A tuple type (must be readonly if using `as const`)
+ * @typeParam T - A tuple type (must be readonly if using `as const`)
  * @example
  * const roles = ['admin', 'user', 'guest'] as const;
  * type Role = TupleToUnion<typeof roles>; // "admin" | "user" | "guest"
@@ -300,8 +300,8 @@ export type RangeTuple<T, Min extends number, Max extends number> = $Range<Min,
  * If `K` is provided, only those properties' values become optional (keys remain required).
  * If `K` is omitted, all property values become optional.
  *
- * @template O - The original object type.
- * @template K - Optional union of keys in `O` whose values should become optional.
+ * @typeParam O - The original object type.
+ * @typeParam K - Optional union of keys in `O` whose values should become optional.
  *
  * @example
  * type A = { name: string; age: number };
@@ -321,8 +321,8 @@ export type $Without<T, U> = {
 /**
  * * Creates a type that is either `T` or `U`, but not both at the same time.
  * * This is useful for defining types that can be one of two options, but not both.
- * * @template T - First type option.
- * @template U - Second type option.
+ * @typeParam T - First type option.
+ * @typeParam U - Second type option.
  * @example
  * type A = { a: string };
  * type B = { b: number };
@@ -333,7 +333,7 @@ export type OneOf<T, U> = (T & $Without<U, T>) | (U & $Without<T, U>);
 /**
  * * Checks whether a type is a strict object (excluding functions).
  *
- * @template T - The type to test.
+ * @typeParam T - The type to test.
  *
  * @example
  * type A = IsStrictObject<{}>;          // false
@@ -346,7 +346,7 @@ export type IsStrictObject<T> = T extends object ? T extends AdvancedTypes ? fal
  * * Returns the keyof `T` only if `T` is a non-function object, otherwise `null`.
  * * Prevents extracting keys from primitives or functions.
  *
- * @template T - The input type.
+ * @typeParam T - The input type.
  *
  * @example
  * type A = Keyof<{ x: number }>; // "x"
@@ -356,7 +356,7 @@ export type Keyof<T> = IsStrictObject<T> extends true ? keyof T : null;
 /**
  * * Recursively generates dot-separated keys from a nested object.
  *
- * @template T - The input nested object type.
+ * @typeParam T - The input nested object type.
  *
  * @example
  * type Obj = { user: { name: string; meta: { id: number } } };
@@ -369,8 +369,8 @@ export type DeepKeyof<T> = IsStrictObject<T> extends true ? {
 /**
  * * Creates a new type by picking properties from `T` whose values extend type `V`.
  *
- * @template T - The object type.
- * @template V - The value type to filter by.
+ * @typeParam T - The object type.
+ * @typeParam V - The value type to filter by.
  *
  * @example
  * type T = { name: string; age: number; active: boolean };
@@ -382,8 +382,8 @@ export type PickByValue<T, V> = {
 /**
  * * Maps all values of object `T` to a fixed type `R`, keeping original keys.
  *
- * @template T - The source object type.
- * @template R - The replacement value type.
+ * @typeParam T - The source object type.
+ * @typeParam R - The replacement value type.
  *
  * @example
  * type T = { name: string; age: number };
@@ -396,7 +396,7 @@ export type MapObjectValues<T, R> = {
  * * Removes properties from object `T` whose type is `never`.
  * * Typically useful after conditional filtering.
  *
- * @template T - The input object type.
+ * @typeParam T - The input object type.
  *
  * @example
  * type T = { a: string; b: never; c: number };
@@ -408,8 +408,8 @@ export type RemoveNever<T> = {
 /**
  * * Renames the keys of `T` using the mapping `R`.
  *
- * @template T - Original object type.
- * @template R - Mapping from original keys to new key names.
+ * @typeParam T - Original object type.
+ * @typeParam R - Mapping from original keys to new key names.
  *
  * @example
  * type Original = { first: string; last: string };
@@ -430,8 +430,8 @@ export type $Forbid<T, K extends keyof T> = {
 /**
  * * Enforces that at least `N` properties of type `T` are required.
  *
- * @template T - The base object type.
- * @template N - The minimum number of required properties.
+ * @typeParam T - The base object type.
+ * @typeParam N - The minimum number of required properties.
  *
  * @example
  * interface User {
@@ -462,8 +462,8 @@ export type RequireAtLeast<T extends GenericObject, N extends number, Keys exten
  * * Enforces that exactly `N` properties of type `T` are required.
  * * All other properties remain forbidden.
  *
- * @template T - The base object type.
- * @template N - The exact number of required properties.
+ * @typeParam T - The base object type.
+ * @typeParam N - The exact number of required properties.
  *
  * @example
  * interface Config {
@@ -492,9 +492,9 @@ export type RequireExactly<T extends GenericObject, N extends number> = {
 /**
  * * Enforces that between `Min` and `Max` properties of type `T` are required.
  *
- * @template T - The base object type.
- * @template Min - The minimum number of required properties.
- * @template Max - The maximum number of required properties.
+ * @typeParam T - The base object type.
+ * @typeParam Min - The minimum number of required properties.
+ * @typeParam Max - The maximum number of required properties.
  *
  * @example
  * interface Settings {

package/dist/esm/date/Chronos.js

@@ -3,7 +3,7 @@ import { isValidArray } from '../guards/non-primitives.js';
 import { isNumber, isString } from '../guards/primitives.js';
 import { DAYS, INTERNALS, MONTHS, MS_PER_DAY } from './constants.js';
 import { isLeapYear } from './guards.js';
-import { _formatDate, _normalizeOffset, _resolveNativeTzName } from './helpers.js';
+import { _dateArgsToDate, _formatDate, _hasChronosProperties, _normalizeOffset, _resolveNativeTzName, } from './helpers.js';
 import { extractMinutesFromUTC, getNativeTimeZoneId } from './utils.js';
 export class Chronos {
     #date;
@@ -101,9 +101,7 @@ export class Chronos {
         return this.#date.getTime();
     }
     #toNewDate(value) {
-        const date = value instanceof _a ?
-            value.toDate()
-            : new Date(isString(value) ? value.replace(/['"]/g, '') : (value ?? Date.now()));
+        const date = value instanceof _a ? value.toDate() : _dateArgsToDate(value);
         if (isNaN(date.getTime())) {
             throw new Error('Provided date is invalid!');
         }
@@ -804,6 +802,20 @@ export class Chronos {
     static isValidChronos(value) {
         return value instanceof _a;
     }
+    static isReconstructable(value) {
+        return _hasChronosProperties(value);
+    }
+    static reconstruct(value) {
+        if (!_hasChronosProperties(value)) {
+            throw new TypeError('Invalid input for reconstruction!');
+        }
+        const { native, origin, utcOffset, timeZoneName, timeZoneId, $tzTracker } = value;
+        const offsetMins = extractMinutesFromUTC(utcOffset);
+        const instance = new _a(native);
+        const diffMins = instance.getTimeZoneOffsetMinutes() - offsetMins;
+        const target = instance.utcOffset === utcOffset ? instance : instance.add(-diffMins, 'minute');
+        return target.#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
+    }
     static use(plugin) {
         if (!_a.#plugins.has(plugin)) {
             _a.#plugins.add(plugin);

package/dist/esm/date/helpers.js

@@ -1,6 +1,9 @@
+import { isDate, isObjectWithKeys, isValidArray } from '../guards/non-primitives.js';
+import { isNonEmptyString, isString } from '../guards/primitives.js';
+import { isDateString } from '../guards/specials.js';
 import { getOrdinal } from '../number/utilities.js';
 import { BN_MONTH_TABLES, BN_SEASONS, BN_YEAR_OFFSET, DAYS, MONTHS, MS_PER_DAY, SORTED_TIME_FORMATS, } from './constants.js';
-import { isLeapYear } from './guards.js';
+import { isLeapYear, isValidUTCOffset } from './guards.js';
 export function _formatDateCore(format, dateComponents) {
     const tokenRegex = new RegExp(`^(${SORTED_TIME_FORMATS.join('|')})`);
     let result = '';
@@ -130,3 +133,20 @@ export function _padZero(value, length = 2) {
 export function _padShunno(str, length = 2) {
     return str.padStart(length, '০');
 }
+export function _dateArgsToDate(value) {
+    return isDate(value) ? value : (new Date(isString(value) ? value.replace(/['"]/g, '') : (value ?? Date.now())));
+}
+export function _hasChronosProperties(value) {
+    return (isObjectWithKeys(value, [
+        'origin',
+        'native',
+        'utcOffset',
+        'timeZoneName',
+        'timeZoneId',
+    ]) &&
+        isNonEmptyString(value.origin) &&
+        (isDate(value.native) || isDateString(value.native)) &&
+        isValidUTCOffset(value.utcOffset) &&
+        isNonEmptyString(value.timeZoneName) &&
+        (isNonEmptyString(value.timeZoneId) || isValidArray(value.timeZoneId)));
+}

package/dist/esm/date/utils.js

@@ -1,6 +1,6 @@
-import { isString } from '../guards/primitives.js';
+import { isObject } from '../guards/non-primitives.js';
 import { isValidUTCOffset } from './guards.js';
-import { _formatDate, _gmtToUtcOffset, _normalizeOffset, _resolveNativeTzName, } from './helpers.js';
+import { _dateArgsToDate, _formatDate, _gmtToUtcOffset, _normalizeOffset, _resolveNativeTzName, } from './helpers.js';
 import { NATIVE_TZ_IDS } from './timezone.js';
 export function extractHourMinute(time) {
     const [hour, minute] = time.split(':').map(Number);
@@ -62,7 +62,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 = date instanceof Date ? date : (new Date(isString(date) ? date.replace(/['"]/g, '') : date));
+    const $date = _dateArgsToDate(date);
     if (isNaN($date.getTime())) {
         return 'Invalid Date!';
     }
@@ -77,3 +77,29 @@ export function formatTimePart(time, format) {
     const timeWithDate = `${formatDate({ format: 'YYYY-MM-DD' })}T${_normalizeOffset(time)}`;
     return formatDate({ date: timeWithDate, format: format || 'hh:mm:ss a' });
 }
+export function getTimestamp(args, format) {
+    let $value;
+    let $format;
+    const _isTsOptions = (opt) => {
+        return isObject(opt) && ('value' in opt || 'format' in opt);
+    };
+    if (_isTsOptions(args)) {
+        $value = args.value || new Date();
+        $format = args.format || 'utc';
+    }
+    else {
+        $value = args || new Date();
+        $format = format || 'utc';
+    }
+    let date = _dateArgsToDate($value);
+    if (isNaN(date.getTime())) {
+        date = new Date();
+    }
+    if ($format === 'local') {
+        const offsetMins = date.getTimezoneOffset();
+        const localDate = new Date(date.getTime() - offsetMins * 60000);
+        const offset = formatUTCOffset(-offsetMins).slice(3);
+        return localDate.toISOString().replace('Z', offset);
+    }
+    return date.toISOString();
+}

package/dist/esm/hash/uuid.js

@@ -31,8 +31,13 @@ export function uuid(options) {
         }
         case 'v4': {
             const bytes = new Uint8Array(16);
-            for (let i = 0; i < 16; i++) {
-                bytes[i] = Math.floor(Math.random() * 256);
+            if (crypto.getRandomValues) {
+                crypto.getRandomValues(bytes);
+            }
+            else {
+                for (let i = 0; i < 16; i++) {
+                    bytes[i] = Math.floor(Math.random() * 256);
+                }
             }
             let hex = '';
             for (let i = 0; i < 16; i++) {
@@ -76,8 +81,13 @@ export function uuid(options) {
                 bytes[i] = Number(temp & 0xffn);
                 temp >>= 8n;
             }
-            for (let i = 6; i < 16; i++) {
-                bytes[i] = Math.floor(Math.random() * 256);
+            if (crypto.getRandomValues) {
+                crypto.getRandomValues(bytes);
+            }
+            else {
+                for (let i = 6; i < 16; i++) {
+                    bytes[i] = Math.floor(Math.random() * 256);
+                }
             }
             let hex = '';
             for (let i = 0; i < 16; i++) {

package/dist/esm/index.js

@@ -30,7 +30,7 @@ export { BanglaCalendar, BnCalendar, Bongabdo } from './date/BanglaCalendar.js';
 export { Chronos, Chronus } from './date/Chronos.js';
 export { INTERNALS } from './date/constants.js';
 export { chronos, chronosjs, chronosts, chronus, chronusjs, chronusts, } from './date/chronos-fn.js';
-export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatTimePart, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, convertMinutesToTime as getHourMinutesFromMinutes, extractMinutesFromUTC as getMinutesFromUTC, getNativeTimeZoneId, convertMinutesToTime as getTimeFromMinutes, extractTimeFromUTC as getTimeStringFromUTC, getTimeZoneDetails, getTimeZoneIds, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils.js';
+export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatTimePart, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getTimestamp, convertMinutesToTime as getHourMinutesFromMinutes, extractMinutesFromUTC as getMinutesFromUTC, getNativeTimeZoneId, convertMinutesToTime as getTimeFromMinutes, extractTimeFromUTC as getTimeStringFromUTC, getTimeZoneDetails, getTimeZoneIds, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils.js';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics.js';
 export { averageByField, averageByField as avgByField, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, sumByField, sumFieldDifference, sumFieldDifference as totalDeltaByField, } from './array/calc.js';
 export { Finder } from './array/Finder.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.66",
+  "version": "4.28.71",
   "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",
@@ -46,21 +46,21 @@
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.9",
-    "@typescript-eslint/eslint-plugin": "^8.53.1",
-    "@typescript-eslint/parser": "^8.53.1",
+    "@types/node": "^25.2.1",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
-    "globals": "^17.0.0",
+    "globals": "^17.3.0",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "lint-staged": "^16.2.7",
     "nhb-scripts": "^1.9.2",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.53.1"
+    "typescript-eslint": "^8.54.0"
   },
   "keywords": [
     "toolbox",