nhb-toolbox 4.26.69 → 4.26.71

package/CHANGELOG.md

@@ -6,6 +6,15 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.71] - 2025-11-21
+
+- **Fixed** type issues regarding *array inputs* for `sanitizeData` by swapping the *overload signatures*.
+
+## [4.26.70] - 2025-11-21
+
+- **Added** new `formatDate` utility with alias `formatDateTime` and *core date formatter (private)* to be shared with both `Chronos` class and `formatDate` utility.
+- **Fixed** issues raised from misplacement of *internal* `#date` in `Chronos` class.
+
 ## [4.26.69] - 2025-11-18
 
 - **Updated** *return type* of `sanitizeData` utility:

package/dist/cjs/date/Chronos.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.chronos = exports.Chronos = void 0;
 const non_primitives_1 = require("../guards/non-primitives");
 const primitives_1 = require("../guards/primitives");
-const utilities_1 = require("../number/utilities");
 const constants_1 = require("./constants");
 const guards_1 = require("./guards");
 const utils_1 = require("./utils");
@@ -146,66 +145,9 @@ class Chronos {
         const _getUnitValue = (suffix) => {
             return useUTC ? $utcDate[`getUTC${suffix}`]() : $date[`get${suffix}`]();
         };
-        const year = _getUnitValue('FullYear');
-        const month = _getUnitValue('Month');
-        const day = _getUnitValue('Day');
-        const date = _getUnitValue('Date');
-        const hours = _getUnitValue('Hours');
-        const minutes = _getUnitValue('Minutes');
-        const seconds = _getUnitValue('Seconds');
-        const milliseconds = _getUnitValue('Milliseconds');
-        const dateComponents = {
-            YYYY: String(year),
-            YY: String(year).slice(-2),
-            yyyy: String(year),
-            yy: String(year).slice(-2),
-            M: String(month + 1),
-            MM: String(month + 1).padStart(2, '0'),
-            mmm: constants_1.MONTHS[month].slice(0, 3),
-            mmmm: constants_1.MONTHS[month],
-            d: constants_1.DAYS[day].slice(0, 2),
-            dd: constants_1.DAYS[day].slice(0, 3),
-            ddd: constants_1.DAYS[day],
-            D: String(date),
-            DD: String(date).padStart(2, '0'),
-            Do: (0, utilities_1.getOrdinal)(date),
-            H: String(hours),
-            HH: String(hours).padStart(2, '0'),
-            h: String(hours % 12 || 12),
-            hh: String(hours % 12 || 12).padStart(2, '0'),
-            m: String(minutes),
-            mm: String(minutes).padStart(2, '0'),
-            s: String(seconds),
-            ss: String(seconds).padStart(2, '0'),
-            ms: String(milliseconds),
-            mss: String(milliseconds).padStart(3, '0'),
-            a: hours < 12 ? 'am' : 'pm',
-            A: hours < 12 ? 'AM' : 'PM',
-            ZZ: useUTC ? 'Z' : this.getTimeZoneOffset(),
-        };
-        const tokenRegex = new RegExp(`^(${constants_1.SORTED_TIME_FORMATS.join('|')})`);
-        let result = '';
-        let i = 0;
-        while (i < format.length) {
-            if (format[i] === '[') {
-                const end = format.indexOf(']', i);
-                if (end !== -1) {
-                    result += format.slice(i + 1, end);
-                    i = end + 1;
-                    continue;
-                }
-            }
-            const match = tokenRegex.exec(format.slice(i));
-            if (match) {
-                result += dateComponents[match[0]];
-                i += match[0].length;
-            }
-            else {
-                result += format[i];
-                i++;
-            }
-        }
-        return result;
+        const y = _getUnitValue('FullYear'), mo = _getUnitValue('Month'), d = _getUnitValue('Day'), dt = _getUnitValue('Date'), h = _getUnitValue('Hours'), m = _getUnitValue('Minutes'), s = _getUnitValue('Seconds'), ms = _getUnitValue('Milliseconds');
+        const offset = useUTC ? 'Z' : this.getTimeZoneOffset();
+        return (0, utils_1._formatDateCore)(format, y, mo, d, dt, h, m, s, ms, offset);
     }
     #removeUTCFromISO(local = true) {
         const search = /\.\d+(Z|[+-]\d{2}:\d{2})?$/;
@@ -561,25 +503,25 @@ class Chronos {
         const now = new _a();
         const diffInSeconds = this.diff(now, 'second');
         const abs = Math.abs(diffInSeconds);
-        const suffix = diffInSeconds >= 0 ? 'in ' : '';
-        const postfix = diffInSeconds < 0 ? ' ago' : '';
+        const prefix = diffInSeconds >= 0 ? 'in ' : '';
+        const suffix = diffInSeconds < 0 ? ' ago' : '';
         if (abs < 60) {
-            return `${suffix}${Math.floor(abs)}s${postfix}`;
+            return `${prefix}${Math.floor(abs)}s${suffix}`;
         }
         else if (abs < 3600) {
-            return `${suffix}${Math.floor(abs / 60)}m${postfix}`;
+            return `${prefix}${Math.floor(abs / 60)}m${suffix}`;
         }
         else if (abs < 86400) {
-            return `${suffix}${Math.floor(abs / 3600)}h${postfix}`;
+            return `${prefix}${Math.floor(abs / 3600)}h${suffix}`;
         }
         else if (abs < 2592000) {
-            return `${suffix}${Math.floor(abs / 86400)}d${postfix}`;
+            return `${prefix}${Math.floor(abs / 86400)}d${suffix}`;
         }
         else if (abs < 31536000) {
-            return `${suffix}${Math.floor(abs / 2592000)}mo${postfix}`;
+            return `${prefix}${Math.floor(abs / 2592000)}mo${suffix}`;
         }
         else {
-            return `${suffix}${Math.floor(abs / 31536000)}y${postfix}`;
+            return `${prefix}${Math.floor(abs / 31536000)}y${suffix}`;
         }
     }
     setWeek(week) {

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

@@ -6,20 +6,20 @@ const primitives_1 = require("../../guards/primitives");
 const constants_1 = require("../constants");
 const businessPlugin = (ChronosClass) => {
     const { internalDate: $Date } = ChronosClass[constants_1.INTERNALS];
-    ChronosClass.prototype.isWeekend = function (determiner = 0, weekendLength = 2) {
+    ChronosClass.prototype.isWeekend = function (wDef = 0, wLen = 2) {
         const day = $Date(this).getDay();
-        if ((0, non_primitives_1.isValidArray)(determiner)) {
-            return determiner.includes(day);
+        if ((0, non_primitives_1.isValidArray)(wDef)) {
+            return wDef.includes(day);
         }
-        const lastDayOfWeek = (determiner + 6) % 7;
-        const computedWeekendDays = Array.from({ length: weekendLength }, (_, i) => (lastDayOfWeek - i + 7) % 7);
+        const lastDayOfWeek = (wDef + 6) % 7;
+        const computedWeekendDays = Array.from({ length: wLen }, (_, i) => (lastDayOfWeek - i + 7) % 7);
         return computedWeekendDays.includes(day);
     };
-    ChronosClass.prototype.isWorkday = function (determiner = 0, weekendLength = 2) {
-        if ((0, non_primitives_1.isValidArray)(determiner)) {
-            return !this.isWeekend(determiner);
+    ChronosClass.prototype.isWorkday = function (wDef = 0, wLen = 2) {
+        if ((0, non_primitives_1.isValidArray)(wDef)) {
+            return !this.isWeekend(wDef);
         }
-        return !this.isWeekend(determiner, weekendLength);
+        return !this.isWeekend(wDef, wLen);
     };
     ChronosClass.prototype.isBusinessHour = function (options) {
         const _isBusinessHour = () => {

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

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.durationPlugin = void 0;
 const constants_1 = require("../constants");
 const durationPlugin = (ChronosClass) => {
-    const { internalDate, toNewDate } = ChronosClass[constants_1.INTERNALS];
+    const { toNewDate } = ChronosClass[constants_1.INTERNALS];
     const _normalizeDuration = (result, absolute, isFuture) => {
         const entries = Object.entries(result);
         const updated = { ...result };
@@ -22,7 +22,7 @@ const durationPlugin = (ChronosClass) => {
         return updated;
     };
     ChronosClass.prototype.duration = function (toTime, absolute = true) {
-        const now = internalDate(this);
+        const now = this.toDate();
         const target = toNewDate(this, toTime);
         const isFuture = target > now;
         const from = isFuture ? now : target;
@@ -30,46 +30,40 @@ const durationPlugin = (ChronosClass) => {
         const _getDiff = (suffix) => {
             return to[`get${suffix}`]() - from[`get${suffix}`]();
         };
-        let years = _getDiff('FullYear');
-        let months = _getDiff('Month');
-        let days = _getDiff('Date');
-        let hours = _getDiff('Hours');
-        let minutes = _getDiff('Minutes');
-        let seconds = _getDiff('Seconds');
-        let milliseconds = _getDiff('Milliseconds');
-        if (milliseconds < 0) {
-            milliseconds += 1000;
-            seconds--;
+        let y = _getDiff('FullYear'), mo = _getDiff('Month'), d = _getDiff('Date'), h = _getDiff('Hours'), m = _getDiff('Minutes'), s = _getDiff('Seconds'), ms = _getDiff('Milliseconds');
+        if (ms < 0) {
+            ms += 1000;
+            s--;
         }
-        if (seconds < 0) {
-            seconds += 60;
-            minutes--;
+        if (s < 0) {
+            s += 60;
+            m--;
         }
-        if (minutes < 0) {
-            minutes += 60;
-            hours--;
+        if (m < 0) {
+            m += 60;
+            h--;
         }
-        if (hours < 0) {
-            hours += 24;
-            days--;
+        if (h < 0) {
+            h += 24;
+            d--;
         }
-        if (days < 0) {
+        if (d < 0) {
             const prevMonth = new Date(to.getFullYear(), to.getMonth(), 0);
-            days += prevMonth.getDate();
-            months--;
+            d += prevMonth.getDate();
+            mo--;
         }
-        if (months < 0) {
-            months += 12;
-            years--;
+        if (mo < 0) {
+            mo += 12;
+            y--;
         }
         const result = {
-            years,
-            months,
-            days,
-            hours,
-            minutes,
-            seconds,
-            milliseconds,
+            years: y,
+            months: mo,
+            days: d,
+            hours: h,
+            minutes: m,
+            seconds: s,
+            milliseconds: ms,
         };
         return _normalizeDuration(result, absolute, isFuture);
     };

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

@@ -4,44 +4,41 @@ exports.fromNowPlugin = void 0;
 const convert_1 = require("../../string/convert");
 const constants_1 = require("../constants");
 const fromNowPlugin = (ChronosClass) => {
-    const { internalDate, toNewDate } = ChronosClass[constants_1.INTERNALS];
-    ChronosClass.prototype.fromNow = function (level = 'second', withSuffixPrefix = true, time) {
+    const { toNewDate } = ChronosClass[constants_1.INTERNALS];
+    ChronosClass.prototype.fromNow = function (level = 'second', wSP = true, time) {
         const now = toNewDate(this, time);
-        const target = internalDate(this);
+        const target = this.toDate();
         const isFuture = target > now;
         const from = isFuture ? now : target;
         const to = isFuture ? target : now;
-        let years = to.getFullYear() - from.getFullYear();
-        let months = to.getMonth() - from.getMonth();
-        let days = to.getDate() - from.getDate();
-        let hours = to.getHours() - from.getHours();
-        let minutes = to.getMinutes() - from.getMinutes();
-        let seconds = to.getSeconds() - from.getSeconds();
-        let milliseconds = to.getMilliseconds() - from.getMilliseconds();
-        if (milliseconds < 0) {
-            milliseconds += 1000;
-            seconds--;
+        const _getDiff = (suffix) => {
+            return to[`get${suffix}`]() - from[`get${suffix}`]();
+        };
+        let y = _getDiff('FullYear'), mo = _getDiff('Month'), d = _getDiff('Date'), h = _getDiff('Hours'), m = _getDiff('Minutes'), s = _getDiff('Seconds'), ms = _getDiff('Milliseconds');
+        if (ms < 0) {
+            ms += 1000;
+            s--;
         }
-        if (seconds < 0) {
-            seconds += 60;
-            minutes--;
+        if (s < 0) {
+            s += 60;
+            m--;
         }
-        if (minutes < 0) {
-            minutes += 60;
-            hours--;
+        if (m < 0) {
+            m += 60;
+            h--;
         }
-        if (hours < 0) {
-            hours += 24;
-            days--;
+        if (h < 0) {
+            h += 24;
+            d--;
         }
-        if (days < 0) {
+        if (d < 0) {
             const prevMonth = new Date(to.getFullYear(), to.getMonth(), 0);
-            days += prevMonth.getDate();
-            months--;
+            d += prevMonth.getDate();
+            mo--;
         }
-        if (months < 0) {
-            months += 12;
-            years--;
+        if (mo < 0) {
+            mo += 12;
+            y--;
         }
         const unitOrder = [
             'year',
@@ -60,30 +57,30 @@ const fromNowPlugin = (ChronosClass) => {
         const _isLevelRequired = (unit) => {
             return lvlIdx >= unitOrder.indexOf(unit);
         };
-        if (years > 0) {
-            _pushToParts(years, 'year');
+        if (y > 0) {
+            _pushToParts(y, 'year');
         }
-        if (_isLevelRequired('month') && months > 0) {
-            _pushToParts(months, 'month');
+        if (_isLevelRequired('month') && mo > 0) {
+            _pushToParts(mo, 'month');
         }
-        if (_isLevelRequired('day') && days > 0) {
-            _pushToParts(days, 'day');
+        if (_isLevelRequired('day') && d > 0) {
+            _pushToParts(d, 'day');
         }
-        if (_isLevelRequired('hour') && hours > 0) {
-            _pushToParts(hours, 'hour');
+        if (_isLevelRequired('hour') && h > 0) {
+            _pushToParts(h, 'hour');
         }
-        if (_isLevelRequired('minute') && minutes > 0) {
-            _pushToParts(minutes, 'minute');
+        if (_isLevelRequired('minute') && m > 0) {
+            _pushToParts(m, 'minute');
         }
-        if (_isLevelRequired('second') && seconds > 0) {
-            _pushToParts(seconds, 'second');
+        if (_isLevelRequired('second') && s > 0) {
+            _pushToParts(s, 'second');
         }
-        if (_isLevelRequired('millisecond') && (milliseconds > 0 || parts?.length === 0)) {
-            _pushToParts(milliseconds, 'millisecond');
+        if (_isLevelRequired('millisecond') && (ms > 0 || parts?.length === 0)) {
+            _pushToParts(ms, 'millisecond');
         }
         let prefix = '';
         let suffix = '';
-        if (withSuffixPrefix) {
+        if (wSP) {
             if (isFuture) {
                 prefix = 'in ';
             }

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

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.relativeTimePlugin = void 0;
 const constants_1 = require("../constants");
 const relativeTimePlugin = (ChronosClass) => {
-    const { internalDate: $Date, toNewDate } = ChronosClass[constants_1.INTERNALS];
+    const { toNewDate } = ChronosClass[constants_1.INTERNALS];
     ChronosClass.prototype.getRelativeYear = function (time) {
-        const $date = $Date(this);
+        const $date = this.toDate();
         const now = toNewDate(this, time);
         let years = $date.getFullYear() - now.getFullYear();
         const noYearMonthDay = now.getMonth() < $date.getMonth() ||
@@ -16,7 +16,7 @@ const relativeTimePlugin = (ChronosClass) => {
         return years;
     };
     ChronosClass.prototype.getRelativeMonth = function (time) {
-        const $date = $Date(this);
+        const $date = this.toDate();
         const now = toNewDate(this, time);
         let months = ($date.getFullYear() - now.getFullYear()) * 12 +
             ($date.getMonth() - now.getMonth());
@@ -33,26 +33,26 @@ const relativeTimePlugin = (ChronosClass) => {
     ChronosClass.prototype.getRelativeDay = function (time) {
         const now = toNewDate(this, time);
         now.setHours(0, 0, 0, 0);
-        const $date = $Date(this);
+        const $date = new Date(this.toDate());
         $date.setHours(0, 0, 0, 0);
         const diffTime = $date.getTime() - now.getTime();
         const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
         return diffDays;
     };
     ChronosClass.prototype.getRelativeHour = function (time) {
-        const diff = $Date(this).getTime() - toNewDate(this, time).getTime();
+        const diff = this.getTimeStamp() - toNewDate(this, time).getTime();
         return Math.floor(diff / (1000 * 60 * 60));
     };
     ChronosClass.prototype.getRelativeMinute = function (time) {
-        const diff = $Date(this).getTime() - toNewDate(this, time).getTime();
+        const diff = this.getTimeStamp() - toNewDate(this, time).getTime();
         return Math.floor(diff / (1000 * 60));
     };
     ChronosClass.prototype.getRelativeSecond = function (time) {
-        const diff = $Date(this).getTime() - toNewDate(this, time).getTime();
+        const diff = this.getTimeStamp() - toNewDate(this, time).getTime();
         return Math.floor(diff / 1000);
     };
     ChronosClass.prototype.getRelativeMilliSecond = function (time) {
-        return $Date(this).getTime() - toNewDate(this, time).getTime();
+        return this.getTimeStamp() - toNewDate(this, time).getTime();
     };
     ChronosClass.prototype.compare = function (unit = 'minute', time) {
         switch (unit) {

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

@@ -4,9 +4,9 @@ exports.roundPlugin = void 0;
 const utilities_1 = require("../../number/utilities");
 const constants_1 = require("../constants");
 const roundPlugin = (ChronosClass) => {
-    const { withOrigin } = ChronosClass[constants_1.INTERNALS];
+    const { internalDate, withOrigin } = ChronosClass[constants_1.INTERNALS];
     ChronosClass.prototype.round = function (unit, nearest = 1) {
-        const date = new Date(this.toDate());
+        const date = new Date(internalDate(this));
         switch (unit) {
             case 'millisecond': {
                 const rounded = (0, utilities_1.roundToNearest)(date.getMilliseconds(), nearest);

package/dist/cjs/date/utils.js

@@ -8,6 +8,10 @@ exports.extractMinutesFromUTC = extractMinutesFromUTC;
 exports.convertMinutesToTime = convertMinutesToTime;
 exports.formatUTCOffset = formatUTCOffset;
 exports.getTimeZoneDetails = getTimeZoneDetails;
+exports._formatDateCore = _formatDateCore;
+exports.formatDate = formatDate;
+const utilities_1 = require("../number/utilities");
+const constants_1 = require("./constants");
 function extractHourMinute(time) {
     const [hour, minute] = time.split(':').map(Number);
     return [hour, minute];
@@ -59,3 +63,70 @@ function getTimeZoneDetails(tzId, date) {
     }
     return obj;
 }
+function _formatDateCore(format, year, month, day, date, hours, minutes, seconds, milliseconds, offset) {
+    const dateComponents = {
+        YYYY: String(year),
+        YY: String(year).slice(-2),
+        yyyy: String(year),
+        yy: String(year).slice(-2),
+        M: String(month + 1),
+        MM: String(month + 1).padStart(2, '0'),
+        mmm: constants_1.MONTHS[month].slice(0, 3),
+        mmmm: constants_1.MONTHS[month],
+        d: constants_1.DAYS[day].slice(0, 2),
+        dd: constants_1.DAYS[day].slice(0, 3),
+        ddd: constants_1.DAYS[day],
+        D: String(date),
+        DD: String(date).padStart(2, '0'),
+        Do: (0, utilities_1.getOrdinal)(date),
+        H: String(hours),
+        HH: String(hours).padStart(2, '0'),
+        h: String(hours % 12 || 12),
+        hh: String(hours % 12 || 12).padStart(2, '0'),
+        m: String(minutes),
+        mm: String(minutes).padStart(2, '0'),
+        s: String(seconds),
+        ss: String(seconds).padStart(2, '0'),
+        ms: String(milliseconds),
+        mss: String(milliseconds).padStart(3, '0'),
+        a: hours < 12 ? 'am' : 'pm',
+        A: hours < 12 ? 'AM' : 'PM',
+        ZZ: offset,
+    };
+    const tokenRegex = new RegExp(`^(${constants_1.SORTED_TIME_FORMATS.join('|')})`);
+    let result = '';
+    let i = 0;
+    while (i < format.length) {
+        if (format[i] === '[') {
+            const end = format.indexOf(']', i);
+            if (end !== -1) {
+                result += format.slice(i + 1, end);
+                i = end + 1;
+                continue;
+            }
+        }
+        const match = tokenRegex.exec(format.slice(i));
+        if (match) {
+            result += dateComponents[match[0]];
+            i += match[0].length;
+        }
+        else {
+            result += format[i];
+            i++;
+        }
+    }
+    return result;
+}
+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(date);
+    if (isNaN($date.getTime())) {
+        return 'Invalid Date!';
+    }
+    const _getUnitValue = (suffix) => {
+        return useUTC ? $date[`getUTC${suffix}`]() : $date[`get${suffix}`]();
+    };
+    const y = _getUnitValue('FullYear'), mo = _getUnitValue('Month'), d = _getUnitValue('Day'), dt = _getUnitValue('Date'), h = _getUnitValue('Hours'), m = _getUnitValue('Minutes'), s = _getUnitValue('Seconds'), ms = _getUnitValue('Milliseconds');
+    const offset = useUTC ? 'Z' : formatUTCOffset(-$date.getTimezoneOffset()).slice(3);
+    return _formatDateCore(format, y, mo, d, dt, h, m, s, ms, offset);
+}

package/dist/cjs/index.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateFactorial = exports.calculateAverage = exports.verbalizer = exports.Verbalizer = exports.pluralizer = exports.Pluralizer = exports.VolumeConverter = exports.TimeConverter = exports.TemperatureConverter = exports.MassConverter = exports.LengthConverter = exports.DataConverter = exports.converter = exports.Converter = exports.AreaConverter = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 exports.convertRomanToNumeric = exports.convertRomanToInteger = exports.convertRomanToArabic = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = 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.convertHslToHex = exports.convertHslaToRgba = 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.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = void 0;
-exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = 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.isValidUTCOffSet = exports.isValidUTCOffset = exports.isValidUTC = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isNativeTimeZoneId = exports.isLeapYear = exports.isDateLike = 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 = void 0;
-exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = 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.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.getTimeZoneDetails = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = void 0;
-exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = 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 = void 0;
-exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = 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 = void 0;
+exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.formatDateTime = exports.formatDate = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = 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.isValidUTCOffSet = exports.isValidUTCOffset = exports.isValidUTC = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isNativeTimeZoneId = exports.isLeapYear = exports.isDateLike = 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 = void 0;
+exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = 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.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.getTimeZoneDetails = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = void 0;
+exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = 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 = void 0;
+exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = 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 = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
@@ -234,6 +234,8 @@ Object.defineProperty(exports, "extractMinutesFromUTC", { enumerable: true, get:
 Object.defineProperty(exports, "extractTimeFromUTC", { enumerable: true, get: function () { return utils_2.extractTimeFromUTC; } });
 Object.defineProperty(exports, "extractTimeStringFromUTC", { enumerable: true, get: function () { return utils_2.extractTimeFromUTC; } });
 Object.defineProperty(exports, "extractTotalMinutesFromTime", { enumerable: true, get: function () { return utils_2.getTotalMinutes; } });
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return utils_2.formatDate; } });
+Object.defineProperty(exports, "formatDateTime", { enumerable: true, get: function () { return utils_2.formatDate; } });
 Object.defineProperty(exports, "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; } });

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

@@ -13,7 +13,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 ("m" | "h" | "d" | "a" | "M" | "DD" | "D" | "Do" | "MM" | "mmm" | "mmmm" | "dd" | "ddd" | "YYYY" | "YY" | "yyyy" | "yy" | "H" | "HH" | "hh" | "mm" | "A" | "ss" | "s" | "ms" | "mss" | "ZZ")[];
+export declare const SORTED_TIME_FORMATS: readonly ("m" | "h" | "d" | "a" | "M" | "YYYY" | "YY" | "yyyy" | "yy" | "MM" | "mmm" | "mmmm" | "dd" | "ddd" | "DD" | "D" | "Do" | "H" | "HH" | "hh" | "mm" | "ss" | "s" | "ms" | "mss" | "A" | "ZZ")[];
 /** Ranges for day parts. */
 export declare const DATE_PART_RANGES: Readonly<Record<DayPart, [ClockHour, ClockHour]>>;
 /** Western Zodiac Signs */

package/dist/dts/date/plugins/roundPlugin.d.ts

@@ -1,5 +1,4 @@
 import type { TimeUnit } from '../types';
-type ChronosConstructor = import('../Chronos').Chronos;
 type MainChronos = typeof import('../Chronos').Chronos;
 declare module '../Chronos' {
     interface Chronos {
@@ -20,7 +19,7 @@ declare module '../Chronos' {
          * - For `'week'` unit, rounding is performed by comparing proximity to the start and end of the ISO week (Monday to Sunday).
          *   - If the date is closer to the next Monday, it rounds forward; otherwise, it rounds back to the previous Monday.
          */
-        round(unit: TimeUnit, nearest?: number): ChronosConstructor;
+        round(unit: TimeUnit, nearest?: number): Chronos;
     }
 }
 /** * Plugin to inject `round` method */

package/dist/dts/date/plugins/timeZonePlugin.d.ts

@@ -1,6 +1,5 @@
 import type { LooseLiteral } from '../../utils/types';
 import type { TimeZone, TimeZoneIdentifier, TimeZoneName, UTCOffset } from '../types';
-type ChronosConstructor = import('../Chronos').Chronos;
 type MainChronos = typeof import('../Chronos').Chronos;
 declare module '../Chronos' {
     interface Chronos {
@@ -12,7 +11,7 @@ declare module '../Chronos' {
          * @param tzId - Time zone identifier (e.g., `'Africa/Harare'`). See: {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}.
          * @returns A new instance of `Chronos` with time in the given time zone identifier. Invalid input sets time-zone to `UTC`.
          */
-        timeZone(tzId: TimeZoneIdentifier): ChronosConstructor;
+        timeZone(tzId: TimeZoneIdentifier): Chronos;
         /**
          * @instance Creates a new instance of `Chronos` for the specified abbreviated time zone name.
          *
@@ -21,7 +20,7 @@ declare module '../Chronos' {
          * @param zone - Standard time zone abbreviation (e.g., `'IST'`, `'UTC'`, `'EST'` etc.). See: {@link https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations Time zone abbreviations on Wikipedia}.
          * @returns A new instance of `Chronos` with time in the given time zone abbreviation. Invalid input sets time-zone to `UTC`.
          */
-        timeZone(zone: TimeZone): ChronosConstructor;
+        timeZone(zone: TimeZone): Chronos;
         /**
          * @instance Creates a new instance of `Chronos` for the specified UTC offset.
          *
@@ -30,7 +29,7 @@ declare module '../Chronos' {
          * @param utc - UTC Offset in `UTC±HH:mm` format for fictional or unlisted time zone (e.g., `'UTC+06:15'`).
          * @returns A new instance of `Chronos` with time in the given utc offset. Invalid input sets time-zone to `UTC`.
          */
-        timeZone(utc: UTCOffset): ChronosConstructor;
+        timeZone(utc: UTCOffset): Chronos;
         /**
          * @instance Creates a new instance of `Chronos` for the specified time zone id, abbreviation or UTC offset.
          *
@@ -42,7 +41,7 @@ declare module '../Chronos' {
          * @param tz - A time zone identifier ({@link TimeZoneIdentifier}), time zone abbreviation ({@link TimeZone}), or UTC offset ({@link UTCOffset}).
          * @returns A new instance of `Chronos` with time in the given parameter. Invalid input sets time zone to `UTC`.
          */
-        timeZone(tz: TimeZoneIdentifier | TimeZone | UTCOffset): ChronosConstructor;
+        timeZone(tz: TimeZoneIdentifier | TimeZone | UTCOffset): Chronos;
         /**
          * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
          *