nhb-toolbox 4.28.51 → 4.28.53

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.53] - 2026-01-01
+
+- **Optimized** *internal utilities* to enhance **runtime performance** and **editor IntelliSense**.
+
+## [4.28.52] - 2025-12-30
+
+- **Added** *new* methods for `BanglaCalendar`: `addDays`, `addWeeks`, `addMonths`, `addYears`, `valueOf` and `[Symbol.toPrimitive]`.
+
 ## [4.28.51] - 2025-12-24
 
 - **Removed** strictness from *format* parameter of `formatTimePart` utility and `Chronos.formatTimePart` static method.

package/dist/cjs/date/BanglaCalendar.js

@@ -1,4 +1,5 @@
 "use strict";
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Bongabdo = exports.BnCalendar = exports.BanglaCalendar = void 0;
 const non_primitives_1 = require("../guards/non-primitives");
@@ -18,33 +19,33 @@ class BanglaCalendar {
     constructor(dateBnYrOrCfg, bnMonthOrCfg, bnDateOrCfg, config) {
         this.variant = this.#processVariants(dateBnYrOrCfg, bnMonthOrCfg, bnDateOrCfg, config);
         let date = dateBnYrOrCfg instanceof Date ? dateBnYrOrCfg : (new Date(((0, specials_1.isDateString)(dateBnYrOrCfg) &&
-            !BanglaCalendar.isBanglaDateString(dateBnYrOrCfg)) ?
+            !_a.isBanglaDateString(dateBnYrOrCfg)) ?
             dateBnYrOrCfg
-            : (0, primitives_1.isNumber)(dateBnYrOrCfg) && !BanglaCalendar.isBanglaYearEn(dateBnYrOrCfg) ?
+            : (0, primitives_1.isNumber)(dateBnYrOrCfg) && !_a.isBanglaYearEn(dateBnYrOrCfg) ?
                 dateBnYrOrCfg
                 : Date.now()));
         if (isNaN(date.getTime())) {
             date = new Date();
         }
         const { year, month, monthDate } = this.#processDate(date);
-        let bnYear = BanglaCalendar.isBanglaYear(dateBnYrOrCfg) ? (0, convert_1.banglaToDigit)(dateBnYrOrCfg)
-            : (0, primitives_1.isNumber)(dateBnYrOrCfg) && BanglaCalendar.isBanglaYearEn(dateBnYrOrCfg) ?
+        let bnYear = _a.isBanglaYear(dateBnYrOrCfg) ? (0, convert_1.banglaToDigit)(dateBnYrOrCfg)
+            : (0, primitives_1.isNumber)(dateBnYrOrCfg) && _a.isBanglaYearEn(dateBnYrOrCfg) ?
                 dateBnYrOrCfg
                 : year;
-        let bnMonth = BanglaCalendar.isBanglaMonth(bnMonthOrCfg) ? (0, convert_1.banglaToDigit)(bnMonthOrCfg)
-            : BanglaCalendar.isBanglaMonthEn(bnMonthOrCfg) ? bnMonthOrCfg
+        let bnMonth = _a.isBanglaMonth(bnMonthOrCfg) ? (0, convert_1.banglaToDigit)(bnMonthOrCfg)
+            : _a.isBanglaMonthEn(bnMonthOrCfg) ? bnMonthOrCfg
                 : month;
-        let bnDate = BanglaCalendar.isBanglaDate(bnDateOrCfg) ? (0, convert_1.banglaToDigit)(bnDateOrCfg)
-            : BanglaCalendar.isBanglaDateEn(bnDateOrCfg) ? bnDateOrCfg
+        let bnDate = _a.isBanglaDate(bnDateOrCfg) ? (0, convert_1.banglaToDigit)(bnDateOrCfg)
+            : _a.isBanglaDateEn(bnDateOrCfg) ? bnDateOrCfg
                 : monthDate;
-        if (BanglaCalendar.isBanglaDateString(dateBnYrOrCfg)) {
+        if (_a.isBanglaDateString(dateBnYrOrCfg)) {
             const parts = dateBnYrOrCfg.replace(/['"]/g, '').split('-');
             bnYear = (0, convert_1.banglaToDigit)(parts[0]);
             bnMonth = (0, convert_1.banglaToDigit)(parts[1]);
             bnDate = (0, convert_1.banglaToDigit)(parts[2]);
         }
         const { gregYear } = this.#processGregYear(bnYear, bnMonth);
-        const { bnMonthTable } = this.#getGregYearBnMonthTable(gregYear, bnYear);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear, bnYear);
         const monthRange = bnMonthTable[bnMonth - 1];
         if (bnDate > monthRange) {
             bnDate -= monthRange;
@@ -73,16 +74,28 @@ class BanglaCalendar {
         this.weekDay = wd;
         this.isoWeekDay = wd === 0 ? 7 : wd;
     }
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'number')
+            return this.valueOf();
+        return this.toJSON();
+    }
     get [Symbol.toStringTag]() {
         return this.toJSON();
     }
+    valueOf() {
+        return this.toDate().getTime();
+    }
+    toJSON() {
+        const { year, month, date } = this;
+        return `${(0, helpers_1._padShunno)(year.bn, 4)}-${(0, helpers_1._padShunno)(month.bn)}-${(0, helpers_1._padShunno)(date.bn)}`;
+    }
     isLeapYear() {
         const { gregYear } = this.#processGregYear();
-        return this.#getGregYearBnMonthTable(gregYear).isBnLeapYear;
+        return this.#getBnMonthTableLeap(gregYear).isBnLeapYear;
     }
     toDate() {
         const { baseGregYear, gregYear } = this.#processGregYear();
-        const { bnMonthTable } = this.#getGregYearBnMonthTable(gregYear);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear);
         const epoch = Date.UTC(baseGregYear, 3, 13);
         let days = this.date.en;
         for (let i = 0; i < this.month.en - 1; i++) {
@@ -101,31 +114,71 @@ class BanglaCalendar {
         const DAY = constants_1.BN_DAYS[this.weekDay];
         return (locale === 'en' ? DAY.en : DAY.bn);
     }
+    addDays(days) {
+        const date = this.toDate();
+        return new _a(date.setDate(date.getDate() + days), {
+            variant: this.variant,
+        });
+    }
+    addWeeks(weeks) {
+        const date = this.toDate();
+        return new _a(date.setDate(date.getDate() + weeks * 7), {
+            variant: this.variant,
+        });
+    }
+    addMonths(months, overflow = true) {
+        if (overflow) {
+            const current = this.toDate();
+            return new _a(current.setMonth(current.getMonth() + months), {
+                variant: this.variant,
+            });
+        }
+        else {
+            const { variant, year, month, date } = this;
+            let targetMonth = month.en + months;
+            let targetYear = year.en;
+            while (targetMonth > 12) {
+                targetMonth -= 12;
+                targetYear += 1;
+            }
+            while (targetMonth < 1) {
+                targetMonth += 12;
+                targetYear -= 1;
+            }
+            return this.#getClampedBnCal(targetYear, targetMonth, date.en, variant);
+        }
+    }
+    addYears(years, overflow = true) {
+        const { variant, year, month, date } = this;
+        const targetYear = year.en + years;
+        if (overflow) {
+            return new _a(targetYear, month.en, date.en, { variant });
+        }
+        else {
+            return this.#getClampedBnCal(targetYear, month.en, date.en, variant);
+        }
+    }
     startOfMonth() {
         const { year, month, variant } = this;
-        return new BanglaCalendar(year.en, month.en, 1, { variant });
+        return new _a(year.en, month.en, 1, { variant });
     }
     endOfMonth() {
         const { year, month, variant } = this;
-        return new BanglaCalendar(year.en, month.en, this.daysInMonth(), { variant });
+        return new _a(year.en, month.en, this.daysInMonth(), { variant });
     }
     startOfYear() {
         const { year, variant } = this;
-        return new BanglaCalendar(year.en, 1, 1, { variant });
+        return new _a(year.en, 1, 1, { variant });
     }
     endOfYear() {
         const { year, variant } = this;
-        return new BanglaCalendar(year.en, 12, 30, { variant });
+        return new _a(year.en, 12, 30, { variant });
     }
     daysInMonth(month) {
         const { gregYear } = this.#processGregYear();
-        const { bnMonthTable } = this.#getGregYearBnMonthTable(gregYear);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear);
         return bnMonthTable[(month ?? this.month.en) - 1];
     }
-    toJSON() {
-        const { year, month, date } = this;
-        return `${year.bn.padStart(4, '০')}-${month.bn.padStart(2, '০')}-${date.bn.padStart(2, '০')}`;
-    }
     toString() {
         return this.#toString('bn');
     }
@@ -137,21 +190,21 @@ class BanglaCalendar {
         const seasonName = this.getSeasonName();
         const M_NAME = constants_1.BN_MONTHS[month.en - 1];
         const D_NAME = constants_1.BN_DAYS[weekDay];
-        const paddedYear = year.bn.padStart(4, '০');
+        const paddedYear = (0, helpers_1._padShunno)(year.bn, 4);
         const dateComponents = {
             YYYY: paddedYear,
             YY: paddedYear.slice(-2),
             yyyy: paddedYear,
             yy: paddedYear.slice(-2),
             M: month.bn,
-            MM: month.bn.padStart(2, '০'),
+            MM: (0, helpers_1._padShunno)(month.bn),
             mmm: M_NAME.short,
             mmmm: M_NAME.bn,
             d: D_NAME.short,
             dd: D_NAME.bn.replace('বার', ''),
             ddd: D_NAME.bn,
             D: date.bn,
-            DD: date.bn.padStart(2, '০'),
+            DD: (0, helpers_1._padShunno)(date.bn),
             Do: date.bn,
             S: seasonName,
             SS: seasonName + 'কাল',
@@ -163,13 +216,19 @@ class BanglaCalendar {
         const gregYear = (bnMonth ?? this.month.en) > 10 ? baseGregYear + 1 : baseGregYear;
         return { baseGregYear, gregYear };
     }
-    #getGregYearBnMonthTable(gregYear, bnYear) {
+    #getBnMonthTableLeap(gregYear, bnYear) {
         const isBnLeapYear = (0, helpers_1._isBnLeapYear)(bnYear ?? this.year.en, gregYear, this.variant);
         const bnMonthTable = isBnLeapYear ?
             constants_1.BN_MONTH_TABLES?.[this.variant].leap
             : constants_1.BN_MONTH_TABLES?.[this.variant].normal;
         return { bnMonthTable, isBnLeapYear };
     }
+    #getClampedBnCal(tyBn, tmBn, cdBn, variant) {
+        const { gregYear } = this.#processGregYear(tyBn, tmBn);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear, tyBn);
+        const tdBn = Math.min(cdBn, bnMonthTable[tmBn - 1]);
+        return new _a(tyBn, tmBn, tdBn, { variant });
+    }
     #processVariants(v1, v2, v3, v4) {
         return (this.$hasVariantConfig(v1) ? v1.variant
             : this.$hasVariantConfig(v2) ? v2.variant
@@ -216,9 +275,9 @@ class BanglaCalendar {
     static isBanglaDateString(value) {
         if ((0, primitives_1.isNonEmptyString)(value) && value.includes('-')) {
             const [year, month, date] = value.replace(/['"]/g, '').split('-');
-            return (BanglaCalendar.isBanglaYear(year) &&
-                BanglaCalendar.isBanglaMonth(month) &&
-                BanglaCalendar.isBanglaDate(date));
+            return (_a.isBanglaYear(year) &&
+                _a.isBanglaMonth(month) &&
+                _a.isBanglaDate(date));
         }
         return false;
     }
@@ -226,3 +285,4 @@ class BanglaCalendar {
 exports.BanglaCalendar = BanglaCalendar;
 exports.BnCalendar = BanglaCalendar;
 exports.Bongabdo = BanglaCalendar;
+_a = BanglaCalendar;

package/dist/cjs/date/helpers.js

@@ -14,6 +14,8 @@ exports._getBnYear = _getBnYear;
 exports._getUtcTs = _getUtcTs;
 exports._getElapsedDays = _getElapsedDays;
 exports._bnDaysMonthIdx = _bnDaysMonthIdx;
+exports._padZero = _padZero;
+exports._padShunno = _padShunno;
 const utilities_1 = require("../number/utilities");
 const constants_1 = require("./constants");
 const guards_1 = require("./guards");
@@ -43,32 +45,32 @@ function _formatDateCore(format, dateComponents) {
     return result;
 }
 function _formatDate(format, year, month, day, date, hours, minutes, seconds, milliseconds, offset) {
-    const paddedYear = String(year).padStart(4, '0');
+    const paddedYear = _padZero(year, 4);
     const dateComponents = {
         YYYY: paddedYear,
         YY: paddedYear.slice(-2),
         yyyy: paddedYear,
         yy: paddedYear.slice(-2),
         M: String(month + 1),
-        MM: String(month + 1).padStart(2, '0'),
+        MM: _padZero(month + 1),
         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'),
+        DD: _padZero(date),
         Do: (0, utilities_1.getOrdinal)(date),
         H: String(hours),
-        HH: String(hours).padStart(2, '0'),
+        HH: _padZero(hours),
         h: String(hours % 12 || 12),
-        hh: String(hours % 12 || 12).padStart(2, '0'),
+        hh: _padZero(hours % 12 || 12),
         m: String(minutes),
-        mm: String(minutes).padStart(2, '0'),
+        mm: _padZero(minutes),
         s: String(seconds),
-        ss: String(seconds).padStart(2, '0'),
+        ss: _padZero(seconds),
         ms: String(milliseconds),
-        mss: String(milliseconds).padStart(3, '0'),
+        mss: _padZero(milliseconds, 3),
         a: hours < 12 ? 'am' : 'pm',
         A: hours < 12 ? 'AM' : 'PM',
         Z: offset,
@@ -142,3 +144,9 @@ function _bnDaysMonthIdx(date, variant) {
     }
     return { days, monthIdx };
 }
+function _padZero(value, length = 2) {
+    return String(value).padStart(length, '0');
+}
+function _padShunno(str, length = 2) {
+    return str.padStart(length, '০');
+}

package/dist/cjs/date/parse.js

@@ -6,16 +6,15 @@ const specials_1 = require("../guards/specials");
 const constants_1 = require("./constants");
 const guards_1 = require("./guards");
 function parseMSec(value, sec = false) {
-    if ((0, specials_1.isNumericString)(value)) {
+    if ((0, primitives_1.isNumber)(value) || (0, specials_1.isNumericString)(value)) {
         return _parse(`${value}s`, sec);
     }
     else if ((0, guards_1.isTimeWithUnit)(value)) {
         return _parse(value, sec);
     }
-    else if ((0, primitives_1.isNumber)(value)) {
-        return _parse(`${value}s`, sec);
+    else {
+        return NaN;
     }
-    return NaN;
 }
 function _parse(str, sec = false) {
     if (!(0, primitives_1.isNonEmptyString)(str) || str.length > 100) {

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

@@ -59,7 +59,7 @@ const banglaPlugin = ($Chronos) => {
         const { monthIdx } = $bnDaysMonthIdx($Date(this), opts?.variant);
         const M_NAME = constants_1.BN_MONTHS[monthIdx];
         const month = this.getBanglaMonth();
-        const year = this.getBanglaYear().padStart(4, '০');
+        const year = (0, helpers_1._padShunno)(this.getBanglaYear(), 4);
         const date = this.getBanglaDay();
         const seasonName = this.getBanglaSeasonName();
         const offset = (0, convert_1.digitToBangla)(this.getTimeZoneOffset());
@@ -69,25 +69,25 @@ const banglaPlugin = ($Chronos) => {
             yyyy: year,
             yy: year.slice(-2),
             M: month,
-            MM: month.padStart(2, '০'),
+            MM: (0, helpers_1._padShunno)(month),
             mmm: M_NAME.short,
             mmmm: M_NAME.bn,
             d: D_NAME.short,
             dd: D_NAME.bn.replace('বার', ''),
             ddd: D_NAME.bn,
             D: date,
-            DD: date.padStart(2, '০'),
+            DD: (0, helpers_1._padShunno)(date),
             Do: date,
             H: (0, convert_1.digitToBangla)(hour),
-            HH: (0, convert_1.digitToBangla)(hour).padStart(2, '০'),
+            HH: (0, helpers_1._padShunno)((0, convert_1.digitToBangla)(hour)),
             h: (0, convert_1.digitToBangla)(hour % 12 || 12),
-            hh: (0, convert_1.digitToBangla)(hour % 12 || 12).padStart(2, '০'),
+            hh: (0, helpers_1._padShunno)((0, convert_1.digitToBangla)(hour % 12 || 12)),
             m: (0, convert_1.digitToBangla)(minute),
-            mm: (0, convert_1.digitToBangla)(minute).padStart(2, '০'),
+            mm: (0, helpers_1._padShunno)((0, convert_1.digitToBangla)(minute)),
             s: (0, convert_1.digitToBangla)(second),
-            ss: (0, convert_1.digitToBangla)(second).padStart(2, '০'),
+            ss: (0, helpers_1._padShunno)((0, convert_1.digitToBangla)(second)),
             ms: (0, convert_1.digitToBangla)(millisecond),
-            mss: (0, convert_1.digitToBangla)(millisecond).padStart(3, '০'),
+            mss: (0, helpers_1._padShunno)((0, convert_1.digitToBangla)(millisecond), 3),
             a: hour < 12 ? 'পূর্বাহ্ণ' : 'অপরাহ্ণ',
             A: hour < 12 ? 'পূর্বাহ্ণ' : 'অপরাহ্ণ',
             Z: offset,

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

@@ -75,9 +75,9 @@ export declare class BanglaCalendar {
      */
     constructor(config?: BnCalendarConfig);
     /**
-     * * Creates a `BanglaCalendar` instance from a **Bangla** or **Gregorian** date string.
+     * * Creates a `BanglaCalendar` instance from a **Gregorian** or **Bangla** date string.
      *
-     * @param date - Bangla or Gregorian (should be parsable by {@link Date} ) date string
+     * @param date - Gregorian (should be parsable by {@link Date}) or Bangla date string
      * @param config - Calendar configuration options
      *
      * @remarks
@@ -174,7 +174,31 @@ export declare class BanglaCalendar {
      * const bnCal = new BanglaCalendar('১৪৩০', '১', '১'); // ১ বৈশাখ ১৪৩০
      */
     constructor(bnYear: BanglaYear, bnMonth: BanglaMonth, bnDate: BanglaDate, config?: BnCalendarConfig);
+    [Symbol.toPrimitive](hint: string): string | number;
     get [Symbol.toStringTag](): string;
+    /**
+     * @instance Get timestamp in milliseconds for the current date.
+     * @remarks
+     * - Converts the current Bangla date to a Gregorian {@link Date} using {@link toDate()}.
+     * - Returns the Unix timestamp (in milliseconds) of the converted date.
+     * - The time component is normalized to midnight UTC during the conversion process.
+     */
+    valueOf(): number;
+    /**
+     * @instance Returns a string representation of the Bangla date in ISO-like format (YYYY-MM-DD with Bangla digits).
+     *
+     * @returns Bangla date string in the format: "YYYY-MM-DD" (e.g., "১৪৩০-০১-০১")
+     *
+     * @example
+     * const bnCal = new BanglaCalendar('2023-04-14');
+     * console.log(bnCal.toJSON()); // "১৪৩০-০১-০১"
+     *
+     * @remarks
+     * - This method is automatically called by {@link JSON.stringify()} method
+     * - Output follows the pattern: `"বছর-মাস-দিন"` with zero-padded Bangla digits
+     * - Month and date are padded to 2 digits, year to 4 digits
+     */
+    toJSON(): string;
     /**
      * * Checks if the current Bangla year is a leap year.
      *
@@ -261,6 +285,133 @@ export declare class BanglaCalendar {
      * - English names are the Latin transliterations of the Bangla names with standard English weekday names.
      */
     getDayName<Locale extends $BnEn = 'bn'>(locale?: Locale): BanglaDayName<Locale>;
+    /**
+     * @instance Adds days to the current Bangla date.
+     *
+     * @param days - Number of days to add (can be negative to subtract days)
+     * @returns New `BanglaCalendar` instance with the adjusted date
+     *
+     * @example
+     * const bnCal = new BanglaCalendar('১৪৩০', '১', '১'); // ১ বৈশাখ ১৪৩০
+     *
+     * // Add days
+     * bnCal.addDays(7); // Returns: ৮ বৈশাখ ১৪৩০
+     *
+     * // Subtract days
+     * bnCal.addDays(-3); // Returns: ২৮ চৈত্র ১৪২৯
+     *
+     * // Add days crossing month boundary
+     * bnCal.addDays(35); // Returns: ৫ জ্যৈষ্ঠ ১৪৩০
+     *
+     * // Add days crossing year boundary
+     * const lateDate = new BanglaCalendar('১৪৩০', '১২', '২৫');
+     * lateDate.addDays(10); // Returns: ৫ বৈশাখ ১৪৩১
+     *
+     * @remarks
+     * - The resulting instance preserves the calendar variant of the original
+     * - Handles month and year transitions automatically
+     * - Accounts for varying month lengths and leap years
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
+     * - Negative values subtract days from the current date
+     */
+    addDays(days: number): BanglaCalendar;
+    /**
+     * @instance Adds weeks to the current Bangla date.
+     *
+     * @param weeks - Number of weeks to add (can be negative to subtract weeks)
+     * @returns New `BanglaCalendar` instance with the adjusted date
+     *
+     * @example
+     * const bnCal = new BanglaCalendar('১৪৩০', '১', '১'); // ১ বৈশাখ ১৪৩০
+     *
+     * // Add weeks
+     * bnCal.addWeeks(2); // Returns: ১৫ বৈশাখ ১৪৩০
+     *
+     * // Subtract weeks
+     * bnCal.addWeeks(-1); // Returns: ২৪ চৈত্র ১৪২৯
+     *
+     * // Add weeks crossing month boundary
+     * bnCal.addWeeks(5); // Returns: ৫ জ্যৈষ্ঠ ১৪৩০
+     *
+     * @remarks
+     * - Each week is treated as 7 days
+     * - The resulting instance preserves the calendar variant of the original
+     * - Handles month and year transitions automatically
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
+     * - Negative values subtract weeks from the current date
+     * - Useful for scheduling recurring weekly events
+     */
+    addWeeks(weeks: number): BanglaCalendar;
+    /**
+     * @instance Adds months to the current Bangla date.
+     *
+     * @param months - Number of months to add (can be negative to subtract months)
+     * @param overflow - If `true`, allows date overflow to next month when day doesn't exist;
+     *                   if `false`, clamps to last day of target month (default: `true`)
+     * @returns New `BanglaCalendar` instance with the adjusted date
+     *
+     * @example
+     * // Normal case: day exists in target month
+     * const normal = new BanglaCalendar('১৪৩০', '২', '১৫');
+     * normal.addMonths(1); // Returns: ১৫ আষাঢ় ১৪৩০
+     * normal.addMonths(1, false); // Returns: ১৫ আষাঢ় ১৪৩০ (same behavior for both)
+     *
+     * // Edge case: day does not exist in target month
+     * const edgeCase = new BanglaCalendar('১৪৩০', '৬', '৩১'); // ৩১ আশ্বিন ১৪৩০
+     *
+     * // With overflow (default): 31st doesn't exist in কার্তিক (30 days)
+     * edgeCase.addMonths(1); // Returns: ১ অগ্রহায়ণ ১৪৩০ (overflows to next month)
+     *
+     * // Without overflow: clamps to last day of target month
+     * edgeCase.addMonths(1, false); // Returns: ৩০ কার্তিক ১৪৩০ (clamped)
+     *
+     * // Subtract months
+     * edgeCase.addMonths(-1); // Returns: ১ আশ্বিন ১৪৩০
+     * edgeCase.addMonths(-1, false); // Returns: ৩১ ভাদ্র ১৪৩০
+     *
+     * @remarks
+     * - When `overflow=true` (default):
+     *   Follows JavaScript {@link Date} behavior where invalid dates overflow to the next month (e.g., ৩১ আশ্বিন + 1 month → ১ অগ্রহায়ণ)
+     * - When `overflow=false`:
+     *   Clamps to the last valid day of the target month (e.g., ৩১ আশ্বিন + 1 month → ৩০ কার্তিক)
+     * - The resulting instance preserves the calendar variant of the original
+     * - Handles year transitions automatically
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
+     * - Negative values subtract months from the current date
+     */
+    addMonths(months: number, overflow?: boolean): BanglaCalendar;
+    /**
+     * @instance Adds years to the current Bangla date.
+     *
+     * @param years - Number of years to add (can be negative to subtract years)
+     * @param overflow - If `true`, allows date overflow when day doesn't exist in target year;
+     *                   if `false`, clamps to last valid day of month (default: `true`)
+     * @returns New `BanglaCalendar` instance with the adjusted date
+     *
+     * @example
+     * const bnCal = new BanglaCalendar('১৪৩০', '১', '১৫'); // ১৫ বৈশাখ ১৪৩০
+     *
+     * // Add years
+     * bnCal.addYears(1); // Returns: ১৫ বৈশাখ ১৪৩১
+     *
+     * // Subtract years
+     * bnCal.addYears(-1); // Returns: ১৫ বৈশাখ ১৪২৯
+     *
+     * // Multiple years
+     * bnCal.addYears(5); // Returns: ১৫ বৈশাখ ১৪৩৫
+     *
+     * // Edge case: day adjustment for ফাল্গুন (accounting leap year)
+     * const leapDay = new BanglaCalendar('১৪৩১', '১১', '৩০'); // ১৪৩১ is a leap year
+     * leapDay.addYears(1, false); // Returns: ২৯ ফাল্গুন ১৪৩২ (non-leap years have 29 days in ফাল্গুন)
+     *
+     * @remarks
+     * - The resulting instance preserves the calendar variant of the original
+     * - Negative values subtract years from the current date
+     * - Year addition follows Bangla calendar years
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
+     * - The month and day generally remain the same unless affected by leap year rules
+     */
+    addYears(years: number, overflow?: boolean): BanglaCalendar;
     /**
      * @instance Gets a new `BanglaCalendar` instance representing the first day of the current month.
      *
@@ -272,8 +423,8 @@ export declare class BanglaCalendar {
      *
      * @remarks
      * - The resulting instance preserves the calendar variant of the original
-     * - Time component is set to midnight UTC in the resulting Gregorian date
      * - Useful for date range calculations and month-based operations
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
      */
     startOfMonth(): BanglaCalendar;
     /**
@@ -288,7 +439,7 @@ export declare class BanglaCalendar {
      * @remarks
      * - The resulting instance preserves the calendar variant of the original
      * - Accounts for month length variations (29/30/31 days) including leap years
-     * - Time component is set to midnight UTC in the resulting Gregorian date
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
      */
     endOfMonth(): BanglaCalendar;
     /**
@@ -303,7 +454,7 @@ export declare class BanglaCalendar {
      * @remarks
      * - The resulting instance preserves the calendar variant of the original
      * - Always returns the 1st day of the 1st month (বৈশাখ)
-     * - Time component is set to midnight UTC in the resulting Gregorian date
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
      */
     startOfYear(): BanglaCalendar;
     /**
@@ -318,7 +469,7 @@ export declare class BanglaCalendar {
      * @remarks
      * - The resulting instance preserves the calendar variant of the original
      * - Always returns the 30th day of the 12th month (চৈত্র)
-     * - Time component is set to midnight UTC in the resulting Gregorian date
+     * - Time component remains at midnight UTC in the Gregorian conversion (using {@link BanglaCalendar.toDate()} method)
      */
     endOfYear(): BanglaCalendar;
     /**
@@ -344,21 +495,6 @@ export declare class BanglaCalendar {
      * - In the 'revised-1966' variant, leap years occur when `bnYear % 4 === 2`
      */
     daysInMonth(month?: NumberRange<1, 12>): NumberRange<29, 31>;
-    /**
-     * @instance Returns a string representation of the Bangla date in ISO-like format (YYYY-MM-DD with Bangla digits).
-     *
-     * @returns Bangla date string in the format: "YYYY-MM-DD" (e.g., "১৪৩০-০১-০১")
-     *
-     * @example
-     * const bnCal = new BanglaCalendar('2023-04-14');
-     * console.log(bnCal.toJSON()); // "১৪৩০-০১-০১"
-     *
-     * @remarks
-     * - This method is automatically called by {@link JSON.stringify()} method
-     * - Output follows the pattern: `"বছর-মাস-দিন"` with zero-padded Bangla digits
-     * - Month and date are padded to 2 digits, year to 4 digits
-     */
-    toJSON(): string;
     /**
      * @instance Returns a string representation of the Bangla date in Bengali format.
      *
@@ -369,7 +505,6 @@ export declare class BanglaCalendar {
      * console.log(bnCal.toString()); // "শুক্রবার, ১ বৈশাখ, ১৪৩০ [গ্রীষ্ম]"
      *
      * @remarks
-     * - This method is automatically called by {@link String.prototype.toString()} method
      * - Equivalent to calling {@link toStringEn()} with 'bn' locale
      * - Format includes day name, date, month name, year, and season in brackets
      * - Uses Bengali digits and Bengali month/day names

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

@@ -1,11 +1,11 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { Maybe } from '../types/index';
 import type { $BnEn, $GMTOffset, $TimeZoneIdentifier, BanglaSeasonName, BnCalendarVariant, TimeZoneNameNative } from './types';
-/** Core formatting logic shared by `formatDate` and `Chronos` class */
+/** 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 */
 export declare function _formatDate(format: string, year: number, month: number, day: number, date: number, hours: number, minutes: number, seconds: number, milliseconds: number, offset: string): string;
-/** Normalize a time string with by adding offset at the end */
+/** Normalize a time string by adding offset at the end */
 export declare function _normalizeOffset(timeStr: string): string;
 /** Converts milliseconds to seconds */
 export declare const _toSeconds: (ms: number) => number;
@@ -18,8 +18,11 @@ type $ResolvedTzName<T extends $TzNameType> = Maybe<T extends 'long' ? TimeZoneN
 export declare function _resolveNativeTzName<T extends $TzNameType>(tzId: $TzId, type: T, date?: Date): $ResolvedTzName<T>;
 /** Convert `GMT±HH:mm` string to `UTC±HH:mm` format*/
 export declare function _gmtToUtcOffset(gmt: Maybe<string>): Maybe<"UTC+00:15" | "UTC+00:30" | "UTC+00:45" | "UTC+00:00" | "UTC+01:15" | "UTC+01:30" | "UTC+01:45" | "UTC+01:00" | "UTC+02:15" | "UTC+02:30" | "UTC+02:45" | "UTC+02:00" | "UTC+03:15" | "UTC+03:30" | "UTC+03:45" | "UTC+03:00" | "UTC+04:15" | "UTC+04:30" | "UTC+04:45" | "UTC+04:00" | "UTC+05:15" | "UTC+05:30" | "UTC+05:45" | "UTC+05:00" | "UTC+06:15" | "UTC+06:30" | "UTC+06:45" | "UTC+06:00" | "UTC+07:15" | "UTC+07:30" | "UTC+07:45" | "UTC+07:00" | "UTC+08:15" | "UTC+08:30" | "UTC+08:45" | "UTC+08:00" | "UTC+09:15" | "UTC+09:30" | "UTC+09:45" | "UTC+09:00" | "UTC+10:15" | "UTC+10:30" | "UTC+10:45" | "UTC+10:00" | "UTC+14:15" | "UTC+14:30" | "UTC+14:45" | "UTC+14:00" | "UTC+11:15" | "UTC+11:30" | "UTC+11:45" | "UTC+11:00" | "UTC+12:15" | "UTC+12:30" | "UTC+12:45" | "UTC+12:00" | "UTC+13:15" | "UTC+13:30" | "UTC+13:45" | "UTC+13:00" | "UTC-00:15" | "UTC-00:30" | "UTC-00:45" | "UTC-00:00" | "UTC-01:15" | "UTC-01:30" | "UTC-01:45" | "UTC-01:00" | "UTC-02:15" | "UTC-02:30" | "UTC-02:45" | "UTC-02:00" | "UTC-03:15" | "UTC-03:30" | "UTC-03:45" | "UTC-03:00" | "UTC-04:15" | "UTC-04:30" | "UTC-04:45" | "UTC-04:00" | "UTC-05:15" | "UTC-05:30" | "UTC-05:45" | "UTC-05:00" | "UTC-06:15" | "UTC-06:30" | "UTC-06:45" | "UTC-06:00" | "UTC-07:15" | "UTC-07:30" | "UTC-07:45" | "UTC-07:00" | "UTC-08:15" | "UTC-08:30" | "UTC-08:45" | "UTC-08:00" | "UTC-09:15" | "UTC-09:30" | "UTC-09:45" | "UTC-09:00" | "UTC-10:15" | "UTC-10:30" | "UTC-10:45" | "UTC-10:00" | "UTC-14:15" | "UTC-14:30" | "UTC-14:45" | "UTC-14:00" | "UTC-11:15" | "UTC-11:30" | "UTC-11:45" | "UTC-11:00" | "UTC-12:15" | "UTC-12:30" | "UTC-12:45" | "UTC-12:00" | "UTC-13:15" | "UTC-13:30" | "UTC-13:45" | "UTC-13:00">;
+/** Get Bangla season name by month index (`0-11`) */
 export declare function _getBnSeason<L extends $BnEn = 'bn'>(month: number, locale?: L | $BnEn): BanglaSeasonName<L>;
+/** Check whether a Bangla year is leap by Gregorian and Bangla years and calendar variant */
 export declare function _isBnLeapYear(by: number, gy: number, v?: BnCalendarVariant): boolean;
+/** Extract selective unit values from {@link Date} object */
 export declare function _extractDateUnits(date: Date): {
     gy: number;
     $gm: Enumerate<12>;
@@ -27,12 +30,31 @@ export declare function _extractDateUnits(date: Date): {
     gd: NumberRange<1, 31>;
     wd: Enumerate<7>;
 };
+/** Get Gregorian base year from {@link Date} object for Bangla year */
 export declare function _getGregBaseYear(date: Date): number;
+/** Get Bangla year from {@link Date} object */
 export declare function _getBnYear(date: Date): number;
+/** Get timestamp in milliseconds between midnight, January 1, 1970 (UTC) and the specified {@link Date} object */
 export declare function _getUtcTs(date: Date): number;
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) for specific {@link Date} */
 export declare function _getElapsedDays(date: Date): number;
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) and month index for specific `Date` and Bangla calendar variant */
 export declare function _bnDaysMonthIdx(date: Date, variant?: BnCalendarVariant): {
     days: number;
     monthIdx: number;
 };
+/**
+ * Convert number to string and pad at the start with zero (`'0'`)
+ * @param value Value to convert and pad with
+ * @param length Maximum length to pad, default is `2`
+ * @returns The padded string
+ */
+export declare function _padZero(value: number, length?: number): string;
+/**
+ * Pad at the start of a string with Bangla zero (`'০'`)
+ * @param str String to pad with
+ * @param length Maximum length to pad, default is `2`
+ * @returns The padded string
+ */
+export declare function _padShunno(str: string, length?: number): string;
 export {};

package/dist/esm/date/BanglaCalendar.js

@@ -1,9 +1,10 @@
+var _a;
 import { isObjectWithKeys } from '../guards/non-primitives.js';
 import { isInteger, isNonEmptyString, isNumber } from '../guards/primitives.js';
 import { isDateString } from '../guards/specials.js';
 import { banglaToDigit, digitToBangla } from '../number/convert.js';
 import { BN_DAYS, BN_MONTH_TABLES, BN_MONTHS, BN_YEAR_OFFSET, MS_PER_DAY } from './constants.js';
-import { _bnDaysMonthIdx, _extractDateUnits, _formatDateCore, _getBnSeason, _getBnYear, _isBnLeapYear, } from './helpers.js';
+import { _bnDaysMonthIdx, _extractDateUnits, _formatDateCore, _getBnSeason, _getBnYear, _isBnLeapYear, _padShunno, } from './helpers.js';
 export class BanglaCalendar {
     variant;
     year;
@@ -15,33 +16,33 @@ export class BanglaCalendar {
     constructor(dateBnYrOrCfg, bnMonthOrCfg, bnDateOrCfg, config) {
         this.variant = this.#processVariants(dateBnYrOrCfg, bnMonthOrCfg, bnDateOrCfg, config);
         let date = dateBnYrOrCfg instanceof Date ? dateBnYrOrCfg : (new Date((isDateString(dateBnYrOrCfg) &&
-            !BanglaCalendar.isBanglaDateString(dateBnYrOrCfg)) ?
+            !_a.isBanglaDateString(dateBnYrOrCfg)) ?
             dateBnYrOrCfg
-            : isNumber(dateBnYrOrCfg) && !BanglaCalendar.isBanglaYearEn(dateBnYrOrCfg) ?
+            : isNumber(dateBnYrOrCfg) && !_a.isBanglaYearEn(dateBnYrOrCfg) ?
                 dateBnYrOrCfg
                 : Date.now()));
         if (isNaN(date.getTime())) {
             date = new Date();
         }
         const { year, month, monthDate } = this.#processDate(date);
-        let bnYear = BanglaCalendar.isBanglaYear(dateBnYrOrCfg) ? banglaToDigit(dateBnYrOrCfg)
-            : isNumber(dateBnYrOrCfg) && BanglaCalendar.isBanglaYearEn(dateBnYrOrCfg) ?
+        let bnYear = _a.isBanglaYear(dateBnYrOrCfg) ? banglaToDigit(dateBnYrOrCfg)
+            : isNumber(dateBnYrOrCfg) && _a.isBanglaYearEn(dateBnYrOrCfg) ?
                 dateBnYrOrCfg
                 : year;
-        let bnMonth = BanglaCalendar.isBanglaMonth(bnMonthOrCfg) ? banglaToDigit(bnMonthOrCfg)
-            : BanglaCalendar.isBanglaMonthEn(bnMonthOrCfg) ? bnMonthOrCfg
+        let bnMonth = _a.isBanglaMonth(bnMonthOrCfg) ? banglaToDigit(bnMonthOrCfg)
+            : _a.isBanglaMonthEn(bnMonthOrCfg) ? bnMonthOrCfg
                 : month;
-        let bnDate = BanglaCalendar.isBanglaDate(bnDateOrCfg) ? banglaToDigit(bnDateOrCfg)
-            : BanglaCalendar.isBanglaDateEn(bnDateOrCfg) ? bnDateOrCfg
+        let bnDate = _a.isBanglaDate(bnDateOrCfg) ? banglaToDigit(bnDateOrCfg)
+            : _a.isBanglaDateEn(bnDateOrCfg) ? bnDateOrCfg
                 : monthDate;
-        if (BanglaCalendar.isBanglaDateString(dateBnYrOrCfg)) {
+        if (_a.isBanglaDateString(dateBnYrOrCfg)) {
             const parts = dateBnYrOrCfg.replace(/['"]/g, '').split('-');
             bnYear = banglaToDigit(parts[0]);
             bnMonth = banglaToDigit(parts[1]);
             bnDate = banglaToDigit(parts[2]);
         }
         const { gregYear } = this.#processGregYear(bnYear, bnMonth);
-        const { bnMonthTable } = this.#getGregYearBnMonthTable(gregYear, bnYear);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear, bnYear);
         const monthRange = bnMonthTable[bnMonth - 1];
         if (bnDate > monthRange) {
             bnDate -= monthRange;
@@ -70,16 +71,28 @@ export class BanglaCalendar {
         this.weekDay = wd;
         this.isoWeekDay = wd === 0 ? 7 : wd;
     }
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'number')
+            return this.valueOf();
+        return this.toJSON();
+    }
     get [Symbol.toStringTag]() {
         return this.toJSON();
     }
+    valueOf() {
+        return this.toDate().getTime();
+    }
+    toJSON() {
+        const { year, month, date } = this;
+        return `${_padShunno(year.bn, 4)}-${_padShunno(month.bn)}-${_padShunno(date.bn)}`;
+    }
     isLeapYear() {
         const { gregYear } = this.#processGregYear();
-        return this.#getGregYearBnMonthTable(gregYear).isBnLeapYear;
+        return this.#getBnMonthTableLeap(gregYear).isBnLeapYear;
     }
     toDate() {
         const { baseGregYear, gregYear } = this.#processGregYear();
-        const { bnMonthTable } = this.#getGregYearBnMonthTable(gregYear);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear);
         const epoch = Date.UTC(baseGregYear, 3, 13);
         let days = this.date.en;
         for (let i = 0; i < this.month.en - 1; i++) {
@@ -98,31 +111,71 @@ export class BanglaCalendar {
         const DAY = BN_DAYS[this.weekDay];
         return (locale === 'en' ? DAY.en : DAY.bn);
     }
+    addDays(days) {
+        const date = this.toDate();
+        return new _a(date.setDate(date.getDate() + days), {
+            variant: this.variant,
+        });
+    }
+    addWeeks(weeks) {
+        const date = this.toDate();
+        return new _a(date.setDate(date.getDate() + weeks * 7), {
+            variant: this.variant,
+        });
+    }
+    addMonths(months, overflow = true) {
+        if (overflow) {
+            const current = this.toDate();
+            return new _a(current.setMonth(current.getMonth() + months), {
+                variant: this.variant,
+            });
+        }
+        else {
+            const { variant, year, month, date } = this;
+            let targetMonth = month.en + months;
+            let targetYear = year.en;
+            while (targetMonth > 12) {
+                targetMonth -= 12;
+                targetYear += 1;
+            }
+            while (targetMonth < 1) {
+                targetMonth += 12;
+                targetYear -= 1;
+            }
+            return this.#getClampedBnCal(targetYear, targetMonth, date.en, variant);
+        }
+    }
+    addYears(years, overflow = true) {
+        const { variant, year, month, date } = this;
+        const targetYear = year.en + years;
+        if (overflow) {
+            return new _a(targetYear, month.en, date.en, { variant });
+        }
+        else {
+            return this.#getClampedBnCal(targetYear, month.en, date.en, variant);
+        }
+    }
     startOfMonth() {
         const { year, month, variant } = this;
-        return new BanglaCalendar(year.en, month.en, 1, { variant });
+        return new _a(year.en, month.en, 1, { variant });
     }
     endOfMonth() {
         const { year, month, variant } = this;
-        return new BanglaCalendar(year.en, month.en, this.daysInMonth(), { variant });
+        return new _a(year.en, month.en, this.daysInMonth(), { variant });
     }
     startOfYear() {
         const { year, variant } = this;
-        return new BanglaCalendar(year.en, 1, 1, { variant });
+        return new _a(year.en, 1, 1, { variant });
     }
     endOfYear() {
         const { year, variant } = this;
-        return new BanglaCalendar(year.en, 12, 30, { variant });
+        return new _a(year.en, 12, 30, { variant });
     }
     daysInMonth(month) {
         const { gregYear } = this.#processGregYear();
-        const { bnMonthTable } = this.#getGregYearBnMonthTable(gregYear);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear);
         return bnMonthTable[(month ?? this.month.en) - 1];
     }
-    toJSON() {
-        const { year, month, date } = this;
-        return `${year.bn.padStart(4, '০')}-${month.bn.padStart(2, '০')}-${date.bn.padStart(2, '০')}`;
-    }
     toString() {
         return this.#toString('bn');
     }
@@ -134,21 +187,21 @@ export class BanglaCalendar {
         const seasonName = this.getSeasonName();
         const M_NAME = BN_MONTHS[month.en - 1];
         const D_NAME = BN_DAYS[weekDay];
-        const paddedYear = year.bn.padStart(4, '০');
+        const paddedYear = _padShunno(year.bn, 4);
         const dateComponents = {
             YYYY: paddedYear,
             YY: paddedYear.slice(-2),
             yyyy: paddedYear,
             yy: paddedYear.slice(-2),
             M: month.bn,
-            MM: month.bn.padStart(2, '০'),
+            MM: _padShunno(month.bn),
             mmm: M_NAME.short,
             mmmm: M_NAME.bn,
             d: D_NAME.short,
             dd: D_NAME.bn.replace('বার', ''),
             ddd: D_NAME.bn,
             D: date.bn,
-            DD: date.bn.padStart(2, '০'),
+            DD: _padShunno(date.bn),
             Do: date.bn,
             S: seasonName,
             SS: seasonName + 'কাল',
@@ -160,13 +213,19 @@ export class BanglaCalendar {
         const gregYear = (bnMonth ?? this.month.en) > 10 ? baseGregYear + 1 : baseGregYear;
         return { baseGregYear, gregYear };
     }
-    #getGregYearBnMonthTable(gregYear, bnYear) {
+    #getBnMonthTableLeap(gregYear, bnYear) {
         const isBnLeapYear = _isBnLeapYear(bnYear ?? this.year.en, gregYear, this.variant);
         const bnMonthTable = isBnLeapYear ?
             BN_MONTH_TABLES?.[this.variant].leap
             : BN_MONTH_TABLES?.[this.variant].normal;
         return { bnMonthTable, isBnLeapYear };
     }
+    #getClampedBnCal(tyBn, tmBn, cdBn, variant) {
+        const { gregYear } = this.#processGregYear(tyBn, tmBn);
+        const { bnMonthTable } = this.#getBnMonthTableLeap(gregYear, tyBn);
+        const tdBn = Math.min(cdBn, bnMonthTable[tmBn - 1]);
+        return new _a(tyBn, tmBn, tdBn, { variant });
+    }
     #processVariants(v1, v2, v3, v4) {
         return (this.$hasVariantConfig(v1) ? v1.variant
             : this.$hasVariantConfig(v2) ? v2.variant
@@ -213,11 +272,12 @@ export class BanglaCalendar {
     static isBanglaDateString(value) {
         if (isNonEmptyString(value) && value.includes('-')) {
             const [year, month, date] = value.replace(/['"]/g, '').split('-');
-            return (BanglaCalendar.isBanglaYear(year) &&
-                BanglaCalendar.isBanglaMonth(month) &&
-                BanglaCalendar.isBanglaDate(date));
+            return (_a.isBanglaYear(year) &&
+                _a.isBanglaMonth(month) &&
+                _a.isBanglaDate(date));
         }
         return false;
     }
 }
+_a = BanglaCalendar;
 export { BanglaCalendar as BnCalendar, BanglaCalendar as Bongabdo };

package/dist/esm/date/helpers.js

@@ -27,32 +27,32 @@ export function _formatDateCore(format, dateComponents) {
     return result;
 }
 export function _formatDate(format, year, month, day, date, hours, minutes, seconds, milliseconds, offset) {
-    const paddedYear = String(year).padStart(4, '0');
+    const paddedYear = _padZero(year, 4);
     const dateComponents = {
         YYYY: paddedYear,
         YY: paddedYear.slice(-2),
         yyyy: paddedYear,
         yy: paddedYear.slice(-2),
         M: String(month + 1),
-        MM: String(month + 1).padStart(2, '0'),
+        MM: _padZero(month + 1),
         mmm: MONTHS[month].slice(0, 3),
         mmmm: MONTHS[month],
         d: DAYS[day].slice(0, 2),
         dd: DAYS[day].slice(0, 3),
         ddd: DAYS[day],
         D: String(date),
-        DD: String(date).padStart(2, '0'),
+        DD: _padZero(date),
         Do: getOrdinal(date),
         H: String(hours),
-        HH: String(hours).padStart(2, '0'),
+        HH: _padZero(hours),
         h: String(hours % 12 || 12),
-        hh: String(hours % 12 || 12).padStart(2, '0'),
+        hh: _padZero(hours % 12 || 12),
         m: String(minutes),
-        mm: String(minutes).padStart(2, '0'),
+        mm: _padZero(minutes),
         s: String(seconds),
-        ss: String(seconds).padStart(2, '0'),
+        ss: _padZero(seconds),
         ms: String(milliseconds),
-        mss: String(milliseconds).padStart(3, '0'),
+        mss: _padZero(milliseconds, 3),
         a: hours < 12 ? 'am' : 'pm',
         A: hours < 12 ? 'AM' : 'PM',
         Z: offset,
@@ -124,3 +124,9 @@ export function _bnDaysMonthIdx(date, variant) {
     }
     return { days, monthIdx };
 }
+export function _padZero(value, length = 2) {
+    return String(value).padStart(length, '0');
+}
+export function _padShunno(str, length = 2) {
+    return str.padStart(length, '০');
+}

package/dist/esm/date/parse.js

@@ -3,16 +3,15 @@ import { isNumericString } from '../guards/specials.js';
 import { MS_MAP } from './constants.js';
 import { isTimeWithUnit } from './guards.js';
 export function parseMSec(value, sec = false) {
-    if (isNumericString(value)) {
+    if (isNumber(value) || isNumericString(value)) {
         return _parse(`${value}s`, sec);
     }
     else if (isTimeWithUnit(value)) {
         return _parse(value, sec);
     }
-    else if (isNumber(value)) {
-        return _parse(`${value}s`, sec);
+    else {
+        return NaN;
     }
-    return NaN;
 }
 function _parse(str, sec = false) {
     if (!isNonEmptyString(str) || str.length > 100) {

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

@@ -1,6 +1,6 @@
 import { digitToBangla } from '../../number/convert.js';
 import { BN_DAYS, BN_MONTHS, INTERNALS } from '../constants.js';
-import { _bnDaysMonthIdx, _formatDateCore, _getBnSeason, _getBnYear, _isBnLeapYear, } from '../helpers.js';
+import { _bnDaysMonthIdx, _formatDateCore, _getBnSeason, _getBnYear, _isBnLeapYear, _padShunno, } from '../helpers.js';
 export const banglaPlugin = ($Chronos) => {
     const { internalDate: $Date } = $Chronos[INTERNALS];
     const DEFAULT_CONFIG = new Map();
@@ -56,7 +56,7 @@ export const banglaPlugin = ($Chronos) => {
         const { monthIdx } = $bnDaysMonthIdx($Date(this), opts?.variant);
         const M_NAME = BN_MONTHS[monthIdx];
         const month = this.getBanglaMonth();
-        const year = this.getBanglaYear().padStart(4, '০');
+        const year = _padShunno(this.getBanglaYear(), 4);
         const date = this.getBanglaDay();
         const seasonName = this.getBanglaSeasonName();
         const offset = digitToBangla(this.getTimeZoneOffset());
@@ -66,25 +66,25 @@ export const banglaPlugin = ($Chronos) => {
             yyyy: year,
             yy: year.slice(-2),
             M: month,
-            MM: month.padStart(2, '০'),
+            MM: _padShunno(month),
             mmm: M_NAME.short,
             mmmm: M_NAME.bn,
             d: D_NAME.short,
             dd: D_NAME.bn.replace('বার', ''),
             ddd: D_NAME.bn,
             D: date,
-            DD: date.padStart(2, '০'),
+            DD: _padShunno(date),
             Do: date,
             H: digitToBangla(hour),
-            HH: digitToBangla(hour).padStart(2, '০'),
+            HH: _padShunno(digitToBangla(hour)),
             h: digitToBangla(hour % 12 || 12),
-            hh: digitToBangla(hour % 12 || 12).padStart(2, '০'),
+            hh: _padShunno(digitToBangla(hour % 12 || 12)),
             m: digitToBangla(minute),
-            mm: digitToBangla(minute).padStart(2, '০'),
+            mm: _padShunno(digitToBangla(minute)),
             s: digitToBangla(second),
-            ss: digitToBangla(second).padStart(2, '০'),
+            ss: _padShunno(digitToBangla(second)),
             ms: digitToBangla(millisecond),
-            mss: digitToBangla(millisecond).padStart(3, '০'),
+            mss: _padShunno(digitToBangla(millisecond), 3),
             a: hour < 12 ? 'পূর্বাহ্ণ' : 'অপরাহ্ণ',
             A: hour < 12 ? 'পূর্বাহ্ণ' : 'অপরাহ্ণ',
             Z: offset,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.51",
+  "version": "4.28.53",
   "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",
@@ -47,8 +47,8 @@
     "@eslint/js": "^9.39.2",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -60,7 +60,7 @@
     "prettier": "^3.7.4",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.1"
+    "typescript-eslint": "^8.51.0"
   },
   "keywords": [
     "toolbox",