chronos-date 1.2.1 → 1.3.0

package/dist/plugins/timeZonePlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, Lt as UTCOffset, Mt as TimeZoneIdentifier, Nt as TimeZoneName, Ot as TimeZone, Tn as LooseLiteral } from "../types-CaVuY1_4.cjs";
+import { En as LooseLiteral, Nt as TimeZoneIdentifier, Pt as TimeZoneName, Rt as UTCOffset, kt as TimeZone, o as ChronosPlugin } from "../types-DgRC-2cA.cjs";
 
 //#region src/plugins/timeZonePlugin.d.ts
 declare module 'chronos-date' {
@@ -27,7 +27,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends TimeZoneIdentifier>(tzId: Tz): Chronos<Tz>;
     /**
      * @instance Creates a new instance of `Chronos` for the specified abbreviated time zone name.
      *
@@ -36,7 +36,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends TimeZone>(zone: Tz): Chronos<Tz>;
     /**
      * @instance Creates a new instance of `Chronos` for the specified UTC offset.
      *
@@ -45,7 +45,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends UTCOffset>(utc: Tz): Chronos<Tz>;
     /**
      * @instance Creates a new instance of `Chronos` for the specified time zone id, abbreviation or UTC offset.
      *
@@ -57,7 +57,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends TimeZoneIdentifier | TimeZone | UTCOffset>(tz: Tz): Chronos<Tz>;
     /**
      * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
      *
@@ -99,6 +99,6 @@ declare module 'chronos-date' {
   }
 }
 /** * Plugin to inject `timeZone` related methods */
-declare const timeZonePlugin: ($Chronos: $Chronos) => void;
+declare const timeZonePlugin: ChronosPlugin;
 //#endregion
 export { timeZonePlugin };

package/dist/plugins/timeZonePlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, Lt as UTCOffset, Mt as TimeZoneIdentifier, Nt as TimeZoneName, Ot as TimeZone, Tn as LooseLiteral } from "../types-Bs_rfkka.mjs";
+import { En as LooseLiteral, Nt as TimeZoneIdentifier, Pt as TimeZoneName, Rt as UTCOffset, kt as TimeZone, o as ChronosPlugin } from "../types-Nd89nk1B.mjs";
 
 //#region src/plugins/timeZonePlugin.d.ts
 declare module 'chronos-date' {
@@ -27,7 +27,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends TimeZoneIdentifier>(tzId: Tz): Chronos<Tz>;
     /**
      * @instance Creates a new instance of `Chronos` for the specified abbreviated time zone name.
      *
@@ -36,7 +36,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends TimeZone>(zone: Tz): Chronos<Tz>;
     /**
      * @instance Creates a new instance of `Chronos` for the specified UTC offset.
      *
@@ -45,7 +45,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends UTCOffset>(utc: Tz): Chronos<Tz>;
     /**
      * @instance Creates a new instance of `Chronos` for the specified time zone id, abbreviation or UTC offset.
      *
@@ -57,7 +57,7 @@ declare module 'chronos-date' {
      * @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): Chronos;
+    timeZone<Tz extends TimeZoneIdentifier | TimeZone | UTCOffset>(tz: Tz): Chronos<Tz>;
     /**
      * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
      *
@@ -99,6 +99,6 @@ declare module 'chronos-date' {
   }
 }
 /** * Plugin to inject `timeZone` related methods */
-declare const timeZonePlugin: ($Chronos: $Chronos) => void;
+declare const timeZonePlugin: ChronosPlugin;
 //#endregion
 export { timeZonePlugin };

package/dist/plugins/timeZonePlugin.mjs

@@ -17,8 +17,8 @@
 import { s as INTERNALS } from "../basic-DqKyujoj.mjs";
 import { n as NATIVE_TZ_IDS, o as TIME_ZONE_LABELS, r as TIME_ZONES } from "../timezone-Db2CeL32.mjs";
 import { isValidUTCOffset } from "../guards.mjs";
-import { p as _resolveNativeTzName, s as _gmtToUtcOffset } from "../helpers-DEf4sevD.mjs";
-import { r as extractMinutesFromUTC } from "../utilities-BGX8dviZ.mjs";
+import { p as _resolveNativeTzName, s as _gmtToUtcOffset } from "../helpers-eVQCueAC.mjs";
+import { r as extractMinutesFromUTC } from "../utilities-C_cYlUNI.mjs";
 
 //#region src/plugins/timeZonePlugin.ts
 /** * Plugin to inject `timeZone` related methods */
@@ -64,7 +64,7 @@ const timeZonePlugin = ($Chronos) => {
 	const TZ_ID_MAP = new Map(NATIVE_TZ_IDS.reduce((tzIds, id) => {
 		const { offset } = _getTimeZoneDetails(id);
 		if (offset) {
-			const arr = tzIds.get(offset) ?? [];
+			const arr = tzIds.get(offset) || [];
 			arr.push(id);
 			tzIds.set(offset, arr);
 		}
@@ -114,13 +114,13 @@ const timeZonePlugin = ($Chronos) => {
 			tzId = zone;
 		}
 		const $zone = zone || offset;
-		const tzName = _getTimeZoneName($zone, $Date(this)) ?? offset;
+		const tzName = _getTimeZoneName($zone, $Date(this)) || offset;
 		const relativeOffset = extractMinutesFromUTC(offset) - this.getTimeZoneOffsetMinutes();
 		return withOrigin(new $Chronos(new Date($Date(this).getTime() + relativeOffset * 60 * 1e3)), `timeZone`, offset, tzName, tzId, $zone);
 	};
 	$Chronos.prototype.getTimeZoneName = function(utc) {
 		const UTC = utc || offset(this);
-		return _getTimeZoneName(utc || this?.$tzTracker || offset(this), $Date(this)) ?? UTC;
+		return _getTimeZoneName(utc || this?.$tzTracker || offset(this), $Date(this)) || UTC;
 	};
 	/** Cache to store abbreviated time zone names */
 	const TZ_ABBR_CACHE = /* @__PURE__ */ new Map();
@@ -144,7 +144,7 @@ const timeZonePlugin = ($Chronos) => {
 				return tzAbbr;
 			}
 		}
-		const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? UTC;
+		const zone = _getTimeZoneName(tzMapKey, $Date(this)) || UTC;
 		const fallbackKey = `name-${zone}`;
 		if (TZ_ABBR_CACHE.has(fallbackKey)) return TZ_ABBR_CACHE.get(fallbackKey);
 		const customAbbr = isValidUTCOffset(zone) ? zone : _abbreviate(zone);

package/dist/plugins/zodiacPlugin.cjs

@@ -16,7 +16,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_basic = require('../basic-DsQqC5nZ.cjs');
-const require_helpers = require('../helpers-CQzi908i.cjs');
+const require_helpers = require('../helpers-D8yAKOsC.cjs');
 
 //#region src/plugins/zodiacPlugin.ts
 /** * Plugin to inject `zodiac` related methods */

package/dist/plugins/zodiacPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, S as ZodiacSign, b as ZodiacOptions, v as ZodiacMeta, y as ZodiacMetaOptions } from "../types-CaVuY1_4.cjs";
+import { S as ZodiacSign, b as ZodiacOptions, o as ChronosPlugin, v as ZodiacMeta, y as ZodiacMetaOptions } from "../types-DgRC-2cA.cjs";
 
 //#region src/plugins/zodiacPlugin.d.ts
 declare module 'chronos-date' {
@@ -52,6 +52,6 @@ declare module 'chronos-date' {
   }
 }
 /** * Plugin to inject `zodiac` related methods */
-declare const zodiacPlugin: ($Chronos: $Chronos) => void;
+declare const zodiacPlugin: ChronosPlugin;
 //#endregion
 export { zodiacPlugin };

package/dist/plugins/zodiacPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, S as ZodiacSign, b as ZodiacOptions, v as ZodiacMeta, y as ZodiacMetaOptions } from "../types-Bs_rfkka.mjs";
+import { S as ZodiacSign, b as ZodiacOptions, o as ChronosPlugin, v as ZodiacMeta, y as ZodiacMetaOptions } from "../types-Nd89nk1B.mjs";
 
 //#region src/plugins/zodiacPlugin.d.ts
 declare module 'chronos-date' {
@@ -52,6 +52,6 @@ declare module 'chronos-date' {
   }
 }
 /** * Plugin to inject `zodiac` related methods */
-declare const zodiacPlugin: ($Chronos: $Chronos) => void;
+declare const zodiacPlugin: ChronosPlugin;
 //#endregion
 export { zodiacPlugin };

package/dist/plugins/zodiacPlugin.mjs

@@ -15,7 +15,7 @@
  */
 
 import { m as ZODIAC_PRESETS } from "../basic-DqKyujoj.mjs";
-import { f as _padZero } from "../helpers-DEf4sevD.mjs";
+import { f as _padZero } from "../helpers-eVQCueAC.mjs";
 
 //#region src/plugins/zodiacPlugin.ts
 /** * Plugin to inject `zodiac` related methods */

package/dist/{primitives-dXzXlzJw.mjs → primitives-DpMa2dS2.mjs}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/guards/primitives.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.10/node_modules/nhb-toolbox/dist/esm/guards/primitives.js
 function isNumber(value) {
 	return typeof value === "number" && Number.isFinite(value);
 }

package/dist/{primitives-CtuSNmV7.cjs → primitives-DutXlR0D.cjs}

@@ -15,7 +15,7 @@
  */
 
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/guards/primitives.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.10/node_modules/nhb-toolbox/dist/esm/guards/primitives.js
 function isNumber(value) {
 	return typeof value === "number" && Number.isFinite(value);
 }

package/dist/{types-CaVuY1_4.d.cts → types-DgRC-2cA.d.cts}

@@ -16,7 +16,7 @@
 
 import { A as MILLISECOND_FORMATS, B as ZODIAC_PRESETS, C as DATE_PARTS, D as INTERNALS, E as HOUR_FORMATS, F as TIME_FORMATS, I as TIME_UNIT_VARIANTS, M as MONTHS, N as MONTH_FORMATS, O as LOCALE_CALENDARS, P as SECOND_FORMATS, R as WESTERN_ZODIAC_SIGNS, S as DATE_FORMATS, T as DAY_FORMATS, _ as TIME_ZONE_LABELS, b as BN_MONTH_TABLES, g as TIME_ZONE_IDS, h as TIME_ZONES_NATIVE, j as MINUTE_FORMATS, k as LOCALE_NUMBERING_SYSTEMS, m as TIME_ZONES, u as SEASON_PRESETS, v as BN_DAYS, w as DAYS, x as BN_SEASONS, y as BN_MONTHS, z as YEAR_FORMATS } from "./seasons-CpUn45n6.cjs";
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/dts/utils/types.d.ts
+//#region node_modules/.pnpm/nhb-toolbox@4.30.10/node_modules/nhb-toolbox/dist/dts/utils/types.d.ts
 /**
  * * Broadens a literal union (typically `string` or `number`) to also accept any other value of the base type, without losing IntelliSense autocomplete for the provided literals.
  *
@@ -136,7 +136,7 @@ type $JoinRepeat<S extends string, A extends unknown[]> = A extends [unknown, ..
  */
 type Repeat<S extends string, N extends number> = $JoinRepeat<S, $BuildTuple<N>>;
 //#endregion
-//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/dts/number/constants.d.ts
+//#region node_modules/.pnpm/nhb-toolbox@4.30.10/node_modules/nhb-toolbox/dist/dts/number/constants.d.ts
 /** List of all supported BCP 47 locales */
 declare const LOCALE_CODES: readonly ["af-ZA", "am-ET", "ar-AE", "ar-BH", "ar-DZ", "ar-EG", "ar-IQ", "ar-JO", "ar-KW", "ar-LB", "ar-LY", "ar-MA", "ar-OM", "ar-QA", "ar-SA", "ar-SD", "ar-SY", "ar-TN", "ar-YE", "az-AZ", "be-BY", "bg-BG", "bn-BD", "bn-IN", "bs-BA", "ca-ES", "cs-CZ", "cy-GB", "da-DK", "de-AT", "de-CH", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-IE", "en-IN", "en-NZ", "en-PH", "en-SG", "en-US", "en-ZA", "es-AR", "es-BO", "es-CL", "es-CO", "es-CR", "es-DO", "es-EC", "es-ES", "es-GT", "es-HN", "es-MX", "es-NI", "es-PA", "es-PE", "es-PR", "es-PY", "es-SV", "es-US", "es-UY", "es-VE", "et-EE", "eu-ES", "fa-IR", "fi-FI", "fil-PH", "fr-BE", "fr-CA", "fr-CH", "fr-FR", "ga-IE", "gl-ES", "gu-IN", "he-IL", "hi-IN", "hr-HR", "hu-HU", "hy-AM", "id-ID", "is-IS", "it-CH", "it-IT", "ja-JP", "ka-GE", "kk-KZ", "km-KH", "kn-IN", "ko-KR", "ky-KG", "lt-LT", "lv-LV", "mk-MK", "ml-IN", "mn-MN", "mr-IN", "ms-MY", "mt-MT", "nb-NO", "ne-NP", "nl-BE", "nl-NL", "pl-PL", "pt-BR", "pt-PT", "ro-RO", "ru-RU", "sk-SK", "sl-SI", "sq-AL", "sr-Latn", "sv-SE", "sw-KE", "ta-IN", "te-IN", "th-TH", "tr-TR", "uk-UA", "ur-PK", "uz-UZ", "vi-VN", "zh-CN", "zh-HK", "zh-TW"];
 /** Mapping of CurrencyCodes to `LocaleCodes` */
@@ -312,7 +312,7 @@ declare const BN_DIGITS: Readonly<{
   readonly '\u09EF': 9;
 }>;
 //#endregion
-//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/dts/number/types.d.ts
+//#region node_modules/.pnpm/nhb-toolbox@4.30.10/node_modules/nhb-toolbox/dist/dts/number/types.d.ts
 /** Enumerate & Enumerate Internal: builds a union of all numbers from 0 to N - 1 */
 type $EnumerateInternal<N extends number, Acc extends number[] = []> = Acc['length'] extends N ? Acc[number] : $EnumerateInternal<N, [...Acc, Acc['length']]>;
 /**
@@ -352,7 +352,7 @@ type BanglaDigit = keyof typeof BN_DIGITS;
 /** Bangla digits from `১-৯` */
 type $BnOnes = Exclude<BanglaDigit, '০'>;
 //#endregion
-//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/dts/types/index.d.ts
+//#region node_modules/.pnpm/nhb-toolbox@4.30.10/node_modules/nhb-toolbox/dist/dts/types/index.d.ts
 /** Represents a value that may or may not be present. */
 type Maybe<T> = T | undefined;
 /** Union of `number` and numeric string */
@@ -403,7 +403,13 @@ type TimeOnlyFormat = LooseLiteral<TimeFormatToken>;
 type StrictFormat = LooseLiteral<DateTimeISO | DateFormatToken | TimeFormatToken | `${DateFormatToken}${TokenConnector}${TimeFormatToken}`>;
 //#endregion
 //#region src/types/bangla-date.d.ts
+/**
+ * Type representing the two possible locales for Bangla date: Bangla or English.
+ * - `'bn'` for Bangla (default)
+ * - `'en'` for English
+ */
 type $BnEn = 'bn' | 'en';
+/** Type representing ০ padded Bangla digits from '০০' to '০৯'. */
 type $BnOnesPadded = `০${$BnOnes}`;
 /** Bangla month from `১-১২` */
 type BanglaMonth = $BnOnes | $BnOnesPadded | '১০' | '১১' | '১২';
@@ -532,7 +538,7 @@ declare const chronos: ChronosStatics;
  *
  * @returns Instance of `Chronos` with all methods and properties.
  */
-declare class Chronos {
+declare class Chronos<Tz extends ChronosTimeZone = 'System'> {
   #private;
   /** Use `readonly and/or private` methods outside `Chronos`. Purpose: Plugin creation. */
   protected static [INTERNALS]: ChronosInternals;
@@ -708,7 +714,7 @@ declare class Chronos {
   /** @instance Enables arithmetic and comparison operations (e.g., `+new Chronos()`). Calls {@link getTimeStamp} method. */
   valueOf(): number;
   /** @instance Clones and returns exactly same `Chronos` instance. */
-  clone(): Chronos;
+  clone(): Chronos<Tz>;
   /** @instance Gets the native `Date` instance of the current `Chronos`. */
   toDate(): Date;
   /** @instance Returns a string representation of a date. */
@@ -780,43 +786,43 @@ declare class Chronos {
    * @param seconds - Number of seconds to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addSeconds(seconds: number): Chronos;
+  addSeconds(seconds: number): Chronos<Tz>;
   /**
    * @instance Adds minutes and returns a new immutable instance.
    * @param minutes - Number of minutes to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addMinutes(minutes: number): Chronos;
+  addMinutes(minutes: number): Chronos<Tz>;
   /**
    * @instance Adds hours and returns a new immutable instance.
    * @param hours - Number of hours to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addHours(hours: number): Chronos;
+  addHours(hours: number): Chronos<Tz>;
   /**
    * @instance Adds days and returns a new immutable instance.
    * @param days - Number of days to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addDays(days: number): Chronos;
+  addDays(days: number): Chronos<Tz>;
   /**
    * @instance Adds weeks and returns a new immutable instance.
    * @param weeks - Number of weeks to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addWeeks(weeks: number): Chronos;
+  addWeeks(weeks: number): Chronos<Tz>;
   /**
    * @instance Adds months and returns a new immutable instance.
    * @param months - Number of months to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addMonths(months: number): Chronos;
+  addMonths(months: number): Chronos<Tz>;
   /**
    * @instance Adds years and returns a new immutable instance.
    * @param years - Number of years to add.
    * @returns A new `Chronos` instance with the updated date.
    */
-  addYears(years: number): Chronos;
+  addYears(years: number): Chronos<Tz>;
   /**
    * @instance Checks if the current year is a leap year.
    * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
@@ -834,38 +840,38 @@ declare class Chronos {
   /**
    * @instance Checks if another date is the same as this one in a specific unit.
    * @param other The other date to compare.
-   * @param unit The unit to compare.
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param unit The unit to compare. Default is `'millisecond'`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  isSame(other: ChronosInput, unit: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
+  isSame(other: ChronosInput, unit?: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
   /**
    * @instance Checks if this date is before another date in a specific unit.
    * @param other The other date to compare.
-   * @param unit The unit to compare.
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param unit The unit to compare. Default is ``millisecond``.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  isBefore(other: ChronosInput, unit: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
+  isBefore(other: ChronosInput, unit?: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
   /**
    * @instance Checks if this date is after another date in a specific unit.
    * @param other The other date to compare.
-   * @param unit The unit to compare.
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param unit The unit to compare. Default is `'millisecond'`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  isAfter(other: ChronosInput, unit: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
+  isAfter(other: ChronosInput, unit?: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
   /**
    * @instance Checks if this date is the same or before another date in a specific unit.
    * @param other The other date to compare.
-   * @param unit The unit to compare.
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param unit The unit to compare. Default is `'millisecond'`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  isSameOrBefore(other: ChronosInput, unit: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
+  isSameOrBefore(other: ChronosInput, unit?: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
   /**
    * @instance Checks if this date is the same or after another date in a specific unit.
    * @param other The other date to compare.
-   * @param unit The unit to compare.
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param unit The unit to compare. Default is `'millisecond'`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  isSameOrAfter(other: ChronosInput, unit: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
+  isSameOrAfter(other: ChronosInput, unit?: TimeUnit, weekStartsOn?: Enumerate<7>): boolean;
   /**
    * @instance Checks if the current date is between the given start and end dates.
    *
@@ -890,33 +896,33 @@ declare class Chronos {
   /** @instance Checks if current day is the last day of the current month. */
   isLastDayOfMonth(): boolean;
   /** @instance Returns a new `Chronos` instance set to the first day of the current month. */
-  firstDayOfMonth(): Chronos;
+  firstDayOfMonth(): Chronos<Tz>;
   /** @instance Returns a new `Chronos` instance set to the last day of the current month. */
-  lastDayOfMonth(): Chronos;
+  lastDayOfMonth(): Chronos<Tz>;
   /**
    * @instance Returns a new `Chronos` instance at the start of a given unit.
    * @param unit The unit to reset (e.g., year, month, day).
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  startOf(unit: TimeUnit, weekStartsOn?: Enumerate<7>): Chronos;
+  startOf(unit: TimeUnit, weekStartsOn?: Enumerate<7>): Chronos<Tz>;
   /**
    * @instance Returns a new `Chronos` instance at the end of a given unit.
    * @param unit The unit to adjust (e.g., year, month, day).
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    */
-  endOf(unit: TimeUnit, weekStartsOn?: Enumerate<7>): Chronos;
+  endOf(unit: TimeUnit, weekStartsOn?: Enumerate<7>): Chronos<Tz>;
   /**
    * @instance Returns a new `Chronos` instance with the specified unit added.
    * @param number The number of time unit to add (can be negative).
    * @param unit The time unit to add.
    */
-  add(number: number, unit: TimeUnit): Chronos;
+  add(number: number, unit: TimeUnit): Chronos<Tz>;
   /**
    * @instance Returns a new `Chronos` instance with the specified unit subtracted.
    * @param number The number of time unit to subtract (can be negative).
    * @param unit The time unit to add.
    */
-  subtract(number: number, unit: TimeUnit): Chronos;
+  subtract(number: number, unit: TimeUnit): Chronos<Tz>;
   /**
    * @instance Gets the value of a specific time unit from the date.
    * @param unit The unit to retrieve. Type of return value is determined by `unit`.
@@ -927,7 +933,7 @@ declare class Chronos {
    * @param unit The unit to modify. Type of `value` is determined by `unit`.
    * @param value The value to set for the unit. Type of `value` is determined by `unit`.
    */
-  set<Unit extends TimeUnit>(unit: Unit, value: TimeUnitValue<Unit>): Chronos;
+  set<Unit extends TimeUnit>(unit: Unit, value: TimeUnitValue<Unit>): Chronos<Tz>;
   /**
    * @instance Returns the difference between current and another date in the given unit.
    * @param other The other date to compare.
@@ -949,7 +955,7 @@ declare class Chronos {
    * @param week The ISO week number (1–53) to set the date to.
    * @returns A new `Chronos` instance set to the start (Monday) of the specified week.
    */
-  setWeek(week: NumberRange<1, 53>): Chronos;
+  setWeek(week: NumberRange<1, 53>): Chronos<Tz>;
   /**
    * @instance Calculates the ISO 8601 week number of the year.
    *
@@ -960,7 +966,7 @@ declare class Chronos {
   getWeek(): NumberRange<1, 53>;
   /**
    * @instance Calculates the week number of the year based on custom week start.
-   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Applicable if week day is required. Default is `0`.
+   * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`. Applicable when {@link unit} is `'week'`.
    * @returns Week number (1-53).
    */
   getWeekOfYear(weekStartsOn?: Enumerate<7>): NumberRange<1, 53>;
@@ -1039,9 +1045,9 @@ declare class Chronos {
    */
   getTimeZoneOffsetMinutes(): number;
   /** @instance Returns new `Chronos` instance in UTC time */
-  toUTC(): Chronos;
+  toUTC(): Chronos<'UTC'>;
   /** @instance Returns new `Chronos` instance in local time */
-  toLocal(): Chronos;
+  toLocal(): Chronos<'System'>;
   /**
    * @instance Returns the name of the current day or optional day index.
    * @param index Optional day index (`0–6`, where `0` is `Sunday`) to override current day.
@@ -1137,7 +1143,7 @@ declare class Chronos {
    * If omitted, the current system date/time is used.
    * @returns A new `Chronos` instance representing the UTC equivalent of the input.
    */
-  static utc(dateLike?: ChronosInput): Chronos;
+  static utc(dateLike?: ChronosInput): Chronos<'UTC'>;
   /**
    * @static Formats a time-only string into a formatted time string.
    *
@@ -1215,7 +1221,7 @@ declare class Chronos {
    * @param dates A list of Chronos-compatible inputs (`string`, `number`, `Date` or `Chronos`).
    * @returns A new `Chronos` instance representing the earliest moment.
    */
-  static min(...dates: ChronosInput[]): Chronos;
+  static min(...dates: ChronosInput[]): Chronos<ChronosTimeZone>;
   /**
    * @static Returns the latest `Chronos` instance based on the underlying universal {@link timestamp}.
    *
@@ -1228,7 +1234,7 @@ declare class Chronos {
    * @param dates A list of Chronos-compatible inputs (`string`, `number`, `Date` or `Chronos`).
    * @returns A new `Chronos` instance representing the latest moment.
    */
-  static max(...dates: ChronosInput[]): Chronos;
+  static max(...dates: ChronosInput[]): Chronos<ChronosTimeZone>;
   /**
    * @static Checks if the year in the date string or year (from 0 - 9999) is a leap year.
    * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
@@ -1284,7 +1290,7 @@ declare class Chronos {
    * @returns A new `Chronos` instance created from the provided properties.
    * @throws `TypeError` if the input value does not have the necessary properties for reconstruction.
    */
-  static reconstruct(value: ChronosProperties): Chronos;
+  static reconstruct(value: ChronosProperties): Chronos<ChronosTimeZone>;
   /**
    * @static Injects a plugin into the `Chronos` system.
    * @param plugin The plugin to inject.
@@ -1824,6 +1830,15 @@ type LocaleCalendar = (typeof LOCALE_CALENDARS)[number];
 type NumberingSystem = (typeof LOCALE_NUMBERING_SYSTEMS)[number];
 //#endregion
 //#region src/types/chronos-specific.d.ts
+/**
+ * * Timezone identifier type for `Chronos`
+ *
+ *  - {@link $TimeZoneIdentifier} — e.g., `"Asia/Dhaka"`.
+ *  - {@link TimeZone} — e.g., `[ 'Asia/Calcutta', 'Asia/Colombo' ]`, used when multiple timezones share the same UTC offset such as `"UTC+05:30"`.
+ *  - {@link UTCOffset} — e.g., `"UTC+06:45"` or `"UTC+02:15"`, returned when no named timezone corresponds to a given offset.
+ *  - `'System'` — The current system timezone.
+ */
+type ChronosTimeZone = TimeZoneIdentifier | TimeZone | UTCOffset | 'System';
 /**
  * * Options for `Chronos` _static_ method `with()`
  *
@@ -1852,7 +1867,7 @@ interface ChronosInternals {
    * @param tzTracker Optional tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method.
    * @returns The `Chronos` instance with the specified origin and other properties.
    */
-  withOrigin(instance: Chronos, method: PluginMethods, offset?: UTCOffset, tzName?: LooseLiteral<TimeZoneName>, tzId?: TimeZoneId, tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset): Chronos;
+  withOrigin<Tz extends ChronosTimeZone>(instance: Chronos, method: PluginMethods, offset?: UTCOffset, tzName?: LooseLiteral<TimeZoneName>, tzId?: TimeZoneId, tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset): Chronos<Tz>;
   /**
    * * Access to `#toNewDate` private method
    * * Creates a new `Date` object from a `Chronos` input
@@ -1874,7 +1889,7 @@ interface ChronosInternals {
    */
   offset(instance: Chronos): UTCOffset;
   /** * Ensures the input is a `Chronos` instance, creating one if necessary. */
-  cast(date: ChronosInput): Chronos;
+  cast<Tz extends ChronosTimeZone>(date: ChronosInput): Chronos<Tz>;
 }
 /** @internal Helper type to assign instance origin when creating new `Chronos` instance. */
 type WithoutOrigin = Omit<Chronos, '#ORIGIN' | 'origin'>;
@@ -2134,4 +2149,4 @@ interface DurationOptions {
   showZero?: boolean;
 }
 //#endregion
-export { ChronosStaticKey as $, BanglaDayName as $t, ChronosObject as A, TimeZoneId as At, WithoutOrigin as B, Chronos as Bt, $Chronos as C, Enumerate as Cn, PositiveUTCHour as Ct, ChronosInput as D, TimeWithUnit as Dt, $StaticMethods as E, RangeTuple as En, TimeUnitValue as Et, PluginMethods as F, TimestampOptions as Ft, $NativeTzNameOrId as G, $BnDatePadded as Gt, $GMTOffset as H, $BanglaMonth as Ht, RangeWithDates as I, UTCMinute as It, $TimeUnitVar as J, $BnYearPadded as Jt, $TZLabelKey as K, $BnEn as Kt, RelativeDateRange as L, UTCOffset as Lt, ChronosWithOptions as M, TimeZoneIdentifier as Mt, DateRangeOptions as N, TimeZoneName as Nt, ChronosInternals as O, TimeZone as Ot, DatesInRangeOptions as P, TimeZoneNameNative as Pt, $UnitAnyCase as Q, BanglaDateOptions as Qt, RelativeRangeOptions as R, WeekDay as Rt, ZodiacSign as S, Numeric as Sn, NumberingSystem as St, $PluginMethods as T, LooseLiteral as Tn, TimeUnit as Tt, $ISOTimeString as U, $BanglaMonthDate as Ut, $DateUnit as V, chronos as Vt, $LocalArguments as W, $BanglaYear as Wt, $TimeZoneIdentifier as X, BanglaDateFormat as Xt, $TimeUnitVarMap as Y, BanglaDate as Yt, $UTCOffset as Z, BanglaDateObject as Zt, ZodiacArray as _, TimeFormatToken as _n, Milliseconds as _t, BusinessOptionsWeekends as a, BnCalendarVariant as an, DateFormatOptions as at, ZodiacOptions as b, YearToken as bn, MonthString as bt, DayPart as c, DateToken as cn, DateTimeFormatOptions as ct, DurationOptions as d, HourToken as dn, GreetingConfigs as dt, BanglaMonth as en, ClockHour as et, MonthBoundary as f, MSToken as fn, HourMinutes as ft, TimeDuration as g, StrictFormat as gn, LocalesArguments as gt, SeasonPreset as h, SecondToken as hn, LocaleCalendar as ht, BusinessOptionsBasic as i, BnCalendarConfig as in, DateArgs as it, ChronosProperties as j, TimeZoneIdNative as jt, ChronosMethods as k, TimeZoneDetails as kt, DayPartConfig as l, DayToken as ln, FormatOptions as lt, SeasonOptions as m, MonthToken as mn, ISODateTimeString as mt, $BusinessHourOptions as n, BanglaSeasonName as nn, ClockSecond as nt, ChronosPlugin as o, DateWithSeasonToken as on, DateLike as ot, SeasonDefinition as p, MinuteToken as pn, ISODateFormat as pt, $TimeUnitKey as q, $BnMonthPadded as qt, AcademicYear as r, BanglaYear as rn, ClockTime as rt, DateBoundary as s, DateFormatToken as sn, DateString as st, $BusinessHourBaseOptions as t, BanglaMonthName as tn, ClockMinute as tt, DurationKey as u, FormatToken as un, FromNowUnit as ut, ZodiacMeta as v, TimeOnlyFormat as vn, MonthDateString as vt, $InstanceMethods as w, NumberRange as wn, Quarter as wt, ZodiacPreset as x, Maybe as xn, NegativeUTCHour as xt, ZodiacMetaOptions as y, TimeToken as yn, MonthName as yt, WeekdayOptions as z, ChronosStatics as zt };
+export { $UnitAnyCase as $, BanglaDateOptions as $t, ChronosObject as A, TimeZoneDetails as At, WeekdayOptions as B, ChronosStatics as Bt, $Chronos as C, Numeric as Cn, NumberingSystem as Ct, ChronosInput as D, RangeTuple as Dn, TimeUnitValue as Dt, $StaticMethods as E, LooseLiteral as En, TimeUnit as Et, DatesInRangeOptions as F, TimeZoneNameNative as Ft, $LocalArguments as G, $BanglaYear as Gt, $DateUnit as H, chronos as Ht, PluginMethods as I, TimestampOptions as It, $TimeUnitKey as J, $BnMonthPadded as Jt, $NativeTzNameOrId as K, $BnDatePadded as Kt, RangeWithDates as L, UTCMinute as Lt, ChronosTimeZone as M, TimeZoneIdNative as Mt, ChronosWithOptions as N, TimeZoneIdentifier as Nt, ChronosInternals as O, TimeWithUnit as Ot, DateRangeOptions as P, TimeZoneName as Pt, $UTCOffset as Q, BanglaDateObject as Qt, RelativeDateRange as R, UTCOffset as Rt, ZodiacSign as S, Maybe as Sn, NegativeUTCHour as St, $PluginMethods as T, NumberRange as Tn, Quarter as Tt, $GMTOffset as U, $BanglaMonth as Ut, WithoutOrigin as V, Chronos as Vt, $ISOTimeString as W, $BanglaMonthDate as Wt, $TimeUnitVarMap as X, BanglaDate as Xt, $TimeUnitVar as Y, $BnYearPadded as Yt, $TimeZoneIdentifier as Z, BanglaDateFormat as Zt, ZodiacArray as _, StrictFormat as _n, LocalesArguments as _t, BusinessOptionsWeekends as a, BnCalendarConfig as an, DateArgs as at, ZodiacOptions as b, TimeToken as bn, MonthName as bt, DayPart as c, DateFormatToken as cn, DateString as ct, DurationOptions as d, FormatToken as dn, FromNowUnit as dt, BanglaDayName as en, ChronosStaticKey as et, MonthBoundary as f, HourToken as fn, GreetingConfigs as ft, TimeDuration as g, SecondToken as gn, LocaleCalendar as gt, SeasonPreset as h, MonthToken as hn, ISODateTimeString as ht, BusinessOptionsBasic as i, BanglaYear as in, ClockTime as it, ChronosProperties as j, TimeZoneId as jt, ChronosMethods as k, TimeZone as kt, DayPartConfig as l, DateToken as ln, DateTimeFormatOptions as lt, SeasonOptions as m, MinuteToken as mn, ISODateFormat as mt, $BusinessHourOptions as n, BanglaMonthName as nn, ClockMinute as nt, ChronosPlugin as o, BnCalendarVariant as on, DateFormatOptions as ot, SeasonDefinition as p, MSToken as pn, HourMinutes as pt, $TZLabelKey as q, $BnEn as qt, AcademicYear as r, BanglaSeasonName as rn, ClockSecond as rt, DateBoundary as s, DateWithSeasonToken as sn, DateLike as st, $BusinessHourBaseOptions as t, BanglaMonth as tn, ClockHour as tt, DurationKey as u, DayToken as un, FormatOptions as ut, ZodiacMeta as v, TimeFormatToken as vn, Milliseconds as vt, $InstanceMethods as w, Enumerate as wn, PositiveUTCHour as wt, ZodiacPreset as x, YearToken as xn, MonthString as xt, ZodiacMetaOptions as y, TimeOnlyFormat as yn, MonthDateString as yt, RelativeRangeOptions as z, WeekDay as zt };