chronos-date 1.1.1 → 1.2.0

package/README.md

@@ -1,31 +1,79 @@
 # Chronos Date
 
-> A comprehensive date and time library for any JavaScript and TypeScript environment.
+A lightweight, immutable, and plugin-based date-time manipulation library for JavaScript and TypeScript.
 
-## Install
+![Chronos Date](https://raw.githubusercontent.com/nazmul-nhb/chronos-date/refs/heads/main/chronos.png)
 
-### NPM
+## Why Chronos?
 
-```bash
-npm i chronos-date
-```
+In ancient Greek mythology, **Chronos** is the primordial embodiment of time — not merely tracking moments, but **defining their very existence**. Like its mythological namesake, the `Chronos` class offers **precise, immutable, and expressive control** over time within your application.
+
+Designed to go beyond the native `Date` object, it empowers you to manipulate, format, compare, and traverse time with **clarity, reliability, and confidence** — all while staying _immutable_ and _framework-agnostic_.
+
+## Key Features
 
-### PNPM
+- **Immutability:** Every modification returns a new `Chronos` instance. Your original dates remain intact.
+- **Rich API:** From formatting to comparison, calculation, and detailed part extraction.
+- **Plugin System:** Extend core capabilities seamlessly using `Chronos.use(plugin)`. Over a dozen official plugins exist for advanced operations like business hours, seasons, zodiacs, relative times, and more.
+- **Time Zone Support:** Advanced formatting and tracking of UTC offsets and Native time zone properties.
+- **Date Utilities:** Extra utilities, type guards, types and constants for light weight date operations without the need of core class.
+- **Comprehensive TypeScript IntelliSense:** Built with first-class TypeScript types and granular tracking for strict date formatting tokens.
+- **Cross-environment compatibility:** Works anywhere JS runs (Node.js, Browser, Deno, Bun).
 
-```bash
+## Installation
+
+```sh
+npm install chronos-date
+# or
+yarn add chronos-date
+# or
 pnpm add chronos-date
 ```
 
-### YARN
+## Quick Start
 
-```bash
-yarn add chronos-date
+```ts
+import { Chronos, chronos } from 'chronos-date';
+
+// Using the constructor
+const now = new Chronos();
+console.log(now.format('dd, mmm DD, YYYY')); 
+
+// Using the function wrapper
+const tomorrow = chronos().addDays(1);
+console.log(tomorrow.formatStrict('YYYY-MM-DD'));
+
+// Calculate differences
+const eventDate = new Chronos('2025-12-31');
+console.log(now.diff(eventDate, 'day')); // Days until event
 ```
 
----
+## Modular Imports
+
+You can import specific submodules for better tree-shaking:
+
+```ts
+// Guards
+import { isValidDateInput } from "chronos-date/guards";
+
+// Utility functions
+import { formatDate } from "chronos-date/utils";
+
+// Type definitions
+import type { ChronosInput } from "chronos-date/types";
+
+// Constants
+import { MONTHS } from "chronos-date/constants";
+
+// Plugins (imported individually)
+import { timeZonePlugin } from "chronos-date/plugins/timeZonePlugin";
+import { seasonPlugin } from "chronos-date/plugins/seasonPlugin";
+```
+
+## Documentation
+
+For full documentation, API reference, and interactive playgrounds, visit the [**Documentation Site**](https://chronos.nazmul-nhb.dev/).
 
-## Features
+## License
 
->[!INFO]
->
-> Full Docs Coming Soon...
+This project is licensed under the [Apache License 2.0](LICENSE).

package/dist/guards.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { Dt as TimeWithUnit, Lt as UTCOffset, Sn as Numeric, X as $TimeZoneIdentifier, jt as TimeZoneIdNative, ot as DateLike, rt as ClockTime } from "./types-CdmsXbU_.cjs";
+import { Dt as TimeWithUnit, Lt as UTCOffset, Sn as Numeric, X as $TimeZoneIdentifier, jt as TimeZoneIdNative, ot as DateLike, rt as ClockTime } from "./types-CaVuY1_4.cjs";
 
 //#region src/guards.d.ts
 /**

package/dist/guards.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { Dt as TimeWithUnit, Lt as UTCOffset, Sn as Numeric, X as $TimeZoneIdentifier, jt as TimeZoneIdNative, ot as DateLike, rt as ClockTime } from "./types-Cb4gxrgJ.mjs";
+import { Dt as TimeWithUnit, Lt as UTCOffset, Sn as Numeric, X as $TimeZoneIdentifier, jt as TimeZoneIdNative, ot as DateLike, rt as ClockTime } from "./types-Bs_rfkka.mjs";
 
 //#region src/guards.d.ts
 /**

package/dist/index.cjs

@@ -216,24 +216,24 @@ var Chronos = class Chronos {
 	* Represents the current timezone name (e.g., `"Bangladesh Standard Time"`), or falls back to the corresponding timezone identifier (e.g., `"Asia/Dhaka"`) if no name can be resolved.
 	*
 	* @remarks
-	* - Invoking the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method sets the timezone name that corresponds to the specified UTC offset, or the UTC offset itself if no name exists. For more details on this behavior, see {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/names#gettimezonename getTimeZoneName}.
+	* - Invoking the {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method sets the timezone name that corresponds to the specified UTC offset, or the UTC offset itself if no name exists. For more details on this behavior, see {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/names#gettimezonename getTimeZoneName}.
 	* - To retrieve the local system's native timezone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZoneName} instance method.
 	*/
 	timeZoneName;
 	/**
 	* Represents the current timezone context, which can be a single identifier, an array of equivalent identifiers, or a UTC offset.
 	*
-	* - **{@link $TimeZoneIdentifier}** — e.g., `"Asia/Dhaka"`. Returned when the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method has not been invoked. It is default behavior.
+	* - **{@link $TimeZoneIdentifier}** — e.g., `"Asia/Dhaka"`. Returned when the {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method has not been invoked. It is default behavior.
 	* - **Array of {@link $TimeZoneIdentifier}** — 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.
 	*
 	* @remarks
-	* - By default, when {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} is not applied, a single {@link $TimeZoneIdentifier} string is provided.
+	* - By default, when {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} is not applied, a single {@link $TimeZoneIdentifier} string is provided.
 	* - When applied, it may instead return a single identifier string, an array of equivalent identifiers or a UTC offset string.
 	* - To retrieve the local system's native timezone identifier, use the {@link $getNativeTimeZoneId} instance method.
 	*/
 	timeZoneId;
-	/** Tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method */
+	/** Tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method */
 	$tzTracker;
 	/**
 	* * Creates a new immutable `Chronos` instance.
@@ -310,7 +310,7 @@ var Chronos = class Chronos {
 	*
 	* @remarks
 	* - This method always reflects the local machine's time zone if `tzId` is parameter is omitted.
-	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
+	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
 	* - To access the time zone name of a modified or converted instance, use the {@link timeZoneName} public property instead.
 	*
 	* @param tzId Optional time zone identifier to get time zone name for that specific identifier if available.
@@ -326,7 +326,7 @@ var Chronos = class Chronos {
 	*
 	* @remarks
 	* - This method always returns the identifier of the local machine's time zone.
-	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
+	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
 	* - To obtain the identifier(s) of a modified or converted instance, use the {@link timeZoneId} public property instead.
 	*
 	* @returns The local system's IANA time zone identifier.
@@ -355,7 +355,7 @@ var Chronos = class Chronos {
 	* @param offset Optional UTC offset in `UTC±HH:mm` format.
 	* @param tzName Optional time zone name to set.
 	* @param tzId Optional time zone identifier(s) to set.
-	* @param tzTracker Optional tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method.
+	* @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(origin, offset, tzName, tzId, tzTracker) {
@@ -516,7 +516,7 @@ var Chronos = class Chronos {
 	*
 	* - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, `ZZ` and `Z`.
 	* - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
-	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#format-tokens format tokens} for details.
 	*
 	* @param useUTC - Optional boolean to format the date using UTC time.
 	* When `true`, it behaves like `formatUTC()` and outputs time based on UTC offset. Defaults to `false`.
@@ -534,7 +534,7 @@ var Chronos = class Chronos {
 	*
 	* @param format - The desired format string. Defaults to `'dd, mmm DD, YYYY HH:mm:ss'`
 	*                 (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
-	*	- Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+	*	- Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#format-tokens format tokens} for details.
 	*
 	* @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`).
 	*                 Defaults to `false` (local time).
@@ -553,7 +553,7 @@ var Chronos = class Chronos {
 	*
 	* - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, `ZZ` and `Z`.
 	* - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
-	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#format-tokens format tokens} for details.
 	*
 	* @returns Formatted date string in desired format (UTC time).
 	*/
@@ -1286,7 +1286,7 @@ var Chronos = class Chronos {
 	* @param options - Relative range (e.g., 7 days, 4 weeks) or date range (from/to) and output format.
 	* @returns Array of ISO date strings in the specified format.
 	*
-	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/statics#getdatesforday docs} for details.
+	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/statics#getdatesforday docs} for details.
 	*/
 	static getDatesForDay(day, options) {
 		let startDate = new Chronos(), endDate = startDate.addWeeks(4);
@@ -1442,7 +1442,7 @@ var Chronos = class Chronos {
 	* 	- To prevent this incorrect *linter error* in `React` projects, prefer using {@link register} method (alias `use` method).
 	*
 	* - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
-	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
+	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static use(plugin) {
 		if (!Chronos.#plugins.has(plugin)) {
@@ -1460,7 +1460,7 @@ var Chronos = class Chronos {
 	* 	- To prevent this incorrect *linter error* in `React` projects, prefer using this (`register`) method over {@link use} method.
 	*
 	* - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
-	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
+	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static register(plugin) {
 		Chronos.use(plugin);

package/dist/index.d.cts

@@ -15,5 +15,5 @@
  */
 
 import { D as INTERNALS } from "./seasons-CpUn45n6.cjs";
-import { Bt as Chronos, Vt as chronos } from "./types-CdmsXbU_.cjs";
+import { Bt as Chronos, Vt as chronos } from "./types-CaVuY1_4.cjs";
 export { Chronos, INTERNALS, chronos };

package/dist/index.d.mts

@@ -15,5 +15,5 @@
  */
 
 import { D as INTERNALS } from "./seasons-B_kjFWIX.mjs";
-import { Bt as Chronos, Vt as chronos } from "./types-Cb4gxrgJ.mjs";
+import { Bt as Chronos, Vt as chronos } from "./types-Bs_rfkka.mjs";
 export { Chronos, INTERNALS, chronos };

package/dist/index.mjs

@@ -215,24 +215,24 @@ var Chronos = class Chronos {
 	* Represents the current timezone name (e.g., `"Bangladesh Standard Time"`), or falls back to the corresponding timezone identifier (e.g., `"Asia/Dhaka"`) if no name can be resolved.
 	*
 	* @remarks
-	* - Invoking the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method sets the timezone name that corresponds to the specified UTC offset, or the UTC offset itself if no name exists. For more details on this behavior, see {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/names#gettimezonename getTimeZoneName}.
+	* - Invoking the {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method sets the timezone name that corresponds to the specified UTC offset, or the UTC offset itself if no name exists. For more details on this behavior, see {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/names#gettimezonename getTimeZoneName}.
 	* - To retrieve the local system's native timezone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZoneName} instance method.
 	*/
 	timeZoneName;
 	/**
 	* Represents the current timezone context, which can be a single identifier, an array of equivalent identifiers, or a UTC offset.
 	*
-	* - **{@link $TimeZoneIdentifier}** — e.g., `"Asia/Dhaka"`. Returned when the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method has not been invoked. It is default behavior.
+	* - **{@link $TimeZoneIdentifier}** — e.g., `"Asia/Dhaka"`. Returned when the {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method has not been invoked. It is default behavior.
 	* - **Array of {@link $TimeZoneIdentifier}** — 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.
 	*
 	* @remarks
-	* - By default, when {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} is not applied, a single {@link $TimeZoneIdentifier} string is provided.
+	* - By default, when {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} is not applied, a single {@link $TimeZoneIdentifier} string is provided.
 	* - When applied, it may instead return a single identifier string, an array of equivalent identifiers or a UTC offset string.
 	* - To retrieve the local system's native timezone identifier, use the {@link $getNativeTimeZoneId} instance method.
 	*/
 	timeZoneId;
-	/** Tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method */
+	/** Tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone} method */
 	$tzTracker;
 	/**
 	* * Creates a new immutable `Chronos` instance.
@@ -309,7 +309,7 @@ var Chronos = class Chronos {
 	*
 	* @remarks
 	* - This method always reflects the local machine's time zone if `tzId` is parameter is omitted.
-	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
+	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
 	* - To access the time zone name of a modified or converted instance, use the {@link timeZoneName} public property instead.
 	*
 	* @param tzId Optional time zone identifier to get time zone name for that specific identifier if available.
@@ -325,7 +325,7 @@ var Chronos = class Chronos {
 	*
 	* @remarks
 	* - This method always returns the identifier of the local machine's time zone.
-	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
+	* - {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/conversion#timezone timeZone}, {@link utc}, or {@link toUTC} methods have no effects on this method.
 	* - To obtain the identifier(s) of a modified or converted instance, use the {@link timeZoneId} public property instead.
 	*
 	* @returns The local system's IANA time zone identifier.
@@ -354,7 +354,7 @@ var Chronos = class Chronos {
 	* @param offset Optional UTC offset in `UTC±HH:mm` format.
 	* @param tzName Optional time zone name to set.
 	* @param tzId Optional time zone identifier(s) to set.
-	* @param tzTracker Optional tracker to identify the instance created by {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/conversion#timezone timeZone} method.
+	* @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(origin, offset, tzName, tzId, tzTracker) {
@@ -515,7 +515,7 @@ var Chronos = class Chronos {
 	*
 	* - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, `ZZ` and `Z`.
 	* - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
-	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#format-tokens format tokens} for details.
 	*
 	* @param useUTC - Optional boolean to format the date using UTC time.
 	* When `true`, it behaves like `formatUTC()` and outputs time based on UTC offset. Defaults to `false`.
@@ -533,7 +533,7 @@ var Chronos = class Chronos {
 	*
 	* @param format - The desired format string. Defaults to `'dd, mmm DD, YYYY HH:mm:ss'`
 	*                 (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
-	*	- Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+	*	- Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#format-tokens format tokens} for details.
 	*
 	* @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`).
 	*                 Defaults to `false` (local time).
@@ -552,7 +552,7 @@ var Chronos = class Chronos {
 	*
 	* - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, `ZZ` and `Z`.
 	* - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
-	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#format-tokens format tokens} for details.
 	*
 	* @returns Formatted date string in desired format (UTC time).
 	*/
@@ -1285,7 +1285,7 @@ var Chronos = class Chronos {
 	* @param options - Relative range (e.g., 7 days, 4 weeks) or date range (from/to) and output format.
 	* @returns Array of ISO date strings in the specified format.
 	*
-	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/statics#getdatesforday docs} for details.
+	* - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/statics#getdatesforday docs} for details.
 	*/
 	static getDatesForDay(day, options) {
 		let startDate = new Chronos(), endDate = startDate.addWeeks(4);
@@ -1441,7 +1441,7 @@ var Chronos = class Chronos {
 	* 	- To prevent this incorrect *linter error* in `React` projects, prefer using {@link register} method (alias `use` method).
 	*
 	* - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
-	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
+	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static use(plugin) {
 		if (!Chronos.#plugins.has(plugin)) {
@@ -1459,7 +1459,7 @@ var Chronos = class Chronos {
 	* 	- To prevent this incorrect *linter error* in `React` projects, prefer using this (`register`) method over {@link use} method.
 	*
 	* - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
-	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
+	* - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static register(plugin) {
 		Chronos.use(plugin);

package/dist/plugins/banglaPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { $t as BanglaDayName, C as $Chronos, Ht as $BanglaMonth, Kt as $BnEn, Qt as BanglaDateOptions, Ut as $BanglaMonthDate, Wt as $BanglaYear, Zt as BanglaDateObject, gn as StrictFormat, in as BnCalendarConfig, nn as BanglaSeasonName, tn as BanglaMonthName } from "../types-CdmsXbU_.cjs";
+import { $t as BanglaDayName, C as $Chronos, Ht as $BanglaMonth, Kt as $BnEn, Qt as BanglaDateOptions, Ut as $BanglaMonthDate, Wt as $BanglaYear, Zt as BanglaDateObject, gn as StrictFormat, in as BnCalendarConfig, nn as BanglaSeasonName, tn as BanglaMonthName } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/banglaPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/banglaPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { $t as BanglaDayName, C as $Chronos, Ht as $BanglaMonth, Kt as $BnEn, Qt as BanglaDateOptions, Ut as $BanglaMonthDate, Wt as $BanglaYear, Zt as BanglaDateObject, gn as StrictFormat, in as BnCalendarConfig, nn as BanglaSeasonName, tn as BanglaMonthName } from "../types-Cb4gxrgJ.mjs";
+import { $t as BanglaDayName, C as $Chronos, Ht as $BanglaMonth, Kt as $BnEn, Qt as BanglaDateOptions, Ut as $BanglaMonthDate, Wt as $BanglaYear, Zt as BanglaDateObject, gn as StrictFormat, in as BnCalendarConfig, nn as BanglaSeasonName, tn as BanglaMonthName } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/banglaPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/businessPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, Cn as Enumerate, D as ChronosInput, En as RangeTuple, a as BusinessOptionsWeekends, i as BusinessOptionsBasic, r as AcademicYear, wn as NumberRange, wt as Quarter } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, Cn as Enumerate, D as ChronosInput, En as RangeTuple, a as BusinessOptionsWeekends, i as BusinessOptionsBasic, r as AcademicYear, wn as NumberRange, wt as Quarter } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/businessPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/businessPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, Cn as Enumerate, D as ChronosInput, En as RangeTuple, a as BusinessOptionsWeekends, i as BusinessOptionsBasic, r as AcademicYear, wn as NumberRange, wt as Quarter } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, Cn as Enumerate, D as ChronosInput, En as RangeTuple, a as BusinessOptionsWeekends, i as BusinessOptionsBasic, r as AcademicYear, wn as NumberRange, wt as Quarter } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/businessPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/dateRangePlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, I as RangeWithDates, L as RelativeDateRange, mt as ISODateTimeString } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, I as RangeWithDates, L as RelativeDateRange, mt as ISODateTimeString } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/dateRangePlugin.d.ts
 declare module 'chronos-date' {
@@ -29,7 +29,7 @@ declare module 'chronos-date' {
      * @param options - Configuration for the date range. Accepts a fixed (`RangeWithDates`) format.
      * @returns Array of ISO date-time strings in either local or UTC format, excluding any skipped weekdays if specified.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/calculation#getdatesinrange docs} for details.
      *
      * @remarks
      * - When using `Chronos` instances for `from` and/or `to`, ensure both are created in the **same time zone** to avoid mismatched boundaries.
@@ -61,7 +61,7 @@ declare module 'chronos-date' {
      * @param options - Configuration for the date range. Accepts a relative (`RelativeDateRange`) format.
      * @returns Array of ISO date-time strings in either local or UTC format, excluding any skipped weekdays if specified.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/calculation#getdatesinrange docs} for details.
      *
      * @example
      * // Using a relative date range with skipDays:

package/dist/plugins/dateRangePlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, I as RangeWithDates, L as RelativeDateRange, mt as ISODateTimeString } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, I as RangeWithDates, L as RelativeDateRange, mt as ISODateTimeString } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/dateRangePlugin.d.ts
 declare module 'chronos-date' {
@@ -29,7 +29,7 @@ declare module 'chronos-date' {
      * @param options - Configuration for the date range. Accepts a fixed (`RangeWithDates`) format.
      * @returns Array of ISO date-time strings in either local or UTC format, excluding any skipped weekdays if specified.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/calculation#getdatesinrange docs} for details.
      *
      * @remarks
      * - When using `Chronos` instances for `from` and/or `to`, ensure both are created in the **same time zone** to avoid mismatched boundaries.
@@ -61,7 +61,7 @@ declare module 'chronos-date' {
      * @param options - Configuration for the date range. Accepts a relative (`RelativeDateRange`) format.
      * @returns Array of ISO date-time strings in either local or UTC format, excluding any skipped weekdays if specified.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/calculation#getdatesinrange docs} for details.
      *
      * @example
      * // Using a relative date range with skipDays:

package/dist/plugins/dayPartPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, c as DayPart, l as DayPartConfig } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, c as DayPart, l as DayPartConfig } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/dayPartPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/dayPartPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, c as DayPart, l as DayPartConfig } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, c as DayPart, l as DayPartConfig } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/dayPartPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/durationPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, D as ChronosInput, d as DurationOptions, g as TimeDuration } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, D as ChronosInput, d as DurationOptions, g as TimeDuration } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/durationPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/durationPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, D as ChronosInput, d as DurationOptions, g as TimeDuration } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, D as ChronosInput, d as DurationOptions, g as TimeDuration } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/durationPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/fromNowPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, D as ChronosInput, ut as FromNowUnit } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, D as ChronosInput, ut as FromNowUnit } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/fromNowPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/fromNowPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, D as ChronosInput, ut as FromNowUnit } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, D as ChronosInput, ut as FromNowUnit } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/fromNowPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/greetingPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, dt as GreetingConfigs } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, dt as GreetingConfigs } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/greetingPlugin.d.ts
 declare module 'chronos-date' {
@@ -31,7 +31,7 @@ declare module 'chronos-date' {
     /**
      * @instance Returns a greeting message based on current instance of `Chronos` time or provided time in the `configs`.
      *
-     * @remarks This method is an alias for {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#getgreeting getGreeting} method.
+     * @remarks This method is an alias for {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#getgreeting getGreeting} method.
      *
      * @param configs - Configuration options for greeting times and messages.
      * @returns The appropriate greeting message.

package/dist/plugins/greetingPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, dt as GreetingConfigs } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, dt as GreetingConfigs } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/greetingPlugin.d.ts
 declare module 'chronos-date' {
@@ -31,7 +31,7 @@ declare module 'chronos-date' {
     /**
      * @instance Returns a greeting message based on current instance of `Chronos` time or provided time in the `configs`.
      *
-     * @remarks This method is an alias for {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#getgreeting getGreeting} method.
+     * @remarks This method is an alias for {@link https://toolbox.nazmul-nhb.dev/docs/classes/chronos/format#getgreeting getGreeting} method.
      *
      * @param configs - Configuration options for greeting times and messages.
      * @returns The appropriate greeting message.

package/dist/plugins/palindromePlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/palindromePlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/palindromePlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/palindromePlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/relativeTimePlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, D as ChronosInput, Tt as TimeUnit } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, D as ChronosInput, Tt as TimeUnit } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/relativeTimePlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/relativeTimePlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, D as ChronosInput, Tt as TimeUnit } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, D as ChronosInput, Tt as TimeUnit } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/relativeTimePlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/roundPlugin.cjs

@@ -59,7 +59,7 @@ const roundPlugin = ($Chronos) => {
 				const endOfWeek = new Date(startOfWeek);
 				endOfWeek.setDate(endOfWeek.getDate() + 7);
 				const diffToStart = Math.abs(date.getTime() - startOfWeek.getTime());
-				return withOrigin(new $Chronos(Math.abs(endOfWeek.getTime() - date.getTime()) < diffToStart ? endOfWeek : startOfWeek), "round");
+				return withOrigin(new $Chronos(Math.abs(endOfWeek.getTime() - date.getTime()) < diffToStart ? endOfWeek : startOfWeek), "round", offset(this), this.timeZoneName, this.timeZoneId, this.$tzTracker);
 			}
 			case "month": {
 				const roundedMonth = require_utilities.roundToNearest(date.getMonth() + date.getDate() / this.lastDateOfMonth, nearest);

package/dist/plugins/roundPlugin.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, Tt as TimeUnit } from "../types-CdmsXbU_.cjs";
+import { C as $Chronos, Tt as TimeUnit } from "../types-CaVuY1_4.cjs";
 
 //#region src/plugins/roundPlugin.d.ts
 declare module 'chronos-date' {

package/dist/plugins/roundPlugin.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { C as $Chronos, Tt as TimeUnit } from "../types-Cb4gxrgJ.mjs";
+import { C as $Chronos, Tt as TimeUnit } from "../types-Bs_rfkka.mjs";
 
 //#region src/plugins/roundPlugin.d.ts
 declare module 'chronos-date' {