chronos-date 1.3.4 → 2.0.0

package/README.md

@@ -88,7 +88,7 @@ console.log(now.format('dd, mmm DD, YYYY'));
 
 // Using the function wrapper
 const tomorrow = chronos().addDays(1);
-console.log(tomorrow.formatStrict('YYYY-MM-DD'));
+console.log(tomorrow.formatSafe('YYYY-MM-DD'));
 
 // Calculate differences
 const eventDate = new Chronos('2025-12-31');

package/dist/{convert-C58su2-2.cjs → convert-BDQBTK5P.cjs}

@@ -14,9 +14,9 @@
  * limitations under the License.
  */
 
-const require_primitives = require('./primitives-Ce8vYVxN.cjs');
+const require_primitives = require('./primitives-DfO90c3G.cjs');
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.11/node_modules/nhb-toolbox/dist/esm/string/basics.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.14/node_modules/nhb-toolbox/dist/esm/string/basics.js
 function trimString(input) {
 	if (!input) return "";
 	if (require_primitives.isNonEmptyString(input)) return input.trim().replace(/\s+/g, " ");
@@ -25,7 +25,7 @@ function trimString(input) {
 }
 
 //#endregion
-//#region node_modules/.pnpm/nhb-toolbox@4.30.11/node_modules/nhb-toolbox/dist/esm/string/convert.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.14/node_modules/nhb-toolbox/dist/esm/string/convert.js
 const reverseString = (input) => {
 	return trimString(input)?.split("")?.reverse()?.join("");
 };

package/dist/{convert-CWh7zZ5Q.mjs → convert-D5Cd0cCg.mjs}

@@ -14,9 +14,9 @@
  * limitations under the License.
  */
 
-import { n as isNonEmptyString } from "./primitives-Csc-jgx0.mjs";
+import { n as isNonEmptyString } from "./primitives-BXhrgs9R.mjs";
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.11/node_modules/nhb-toolbox/dist/esm/string/basics.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.14/node_modules/nhb-toolbox/dist/esm/string/basics.js
 function trimString(input) {
 	if (!input) return "";
 	if (isNonEmptyString(input)) return input.trim().replace(/\s+/g, " ");
@@ -25,7 +25,7 @@ function trimString(input) {
 }
 
 //#endregion
-//#region node_modules/.pnpm/nhb-toolbox@4.30.11/node_modules/nhb-toolbox/dist/esm/string/convert.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.14/node_modules/nhb-toolbox/dist/esm/string/convert.js
 const reverseString = (input) => {
 	return trimString(input)?.split("")?.reverse()?.join("");
 };

package/dist/{greet-DMVrEM6l.cjs → greet-CMkwXJ7o.cjs}

@@ -15,7 +15,7 @@
  */
 
 const require_guards = require('./guards.cjs');
-const require_utilities = require('./utilities-GTSjQweZ.cjs');
+const require_utilities = require('./utilities-CCnKWAsS.cjs');
 
 //#region src/utils/greet.ts
 /**

package/dist/{greet-BBVGLAlA.mjs → greet-DNGvP7nm.mjs}

@@ -15,7 +15,7 @@
  */
 
 import { isValidTime } from "./guards.mjs";
-import { n as extractHourMinute, p as getTotalMinutes } from "./utilities-CW4F3wFp.mjs";
+import { n as extractHourMinute, p as getTotalMinutes } from "./utilities-C6NiChRE.mjs";
 
 //#region src/utils/greet.ts
 /**

package/dist/guards.cjs

@@ -16,9 +16,9 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_timezone = require('./timezone-BNnHFgki.cjs');
-const require_primitives = require('./primitives-Ce8vYVxN.cjs');
-const require_non_primitives = require('./non-primitives-D3EcMaah.cjs');
-const require_utilities = require('./utilities-BnJa8S6A.cjs');
+const require_primitives = require('./primitives-DfO90c3G.cjs');
+const require_non_primitives = require('./non-primitives-BqjRwK2B.cjs');
+const require_utilities = require('./utilities-C_KmjIRK.cjs');
 
 //#region src/guards.ts
 /**

package/dist/guards.d.cts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { Cn as Numeric, Mt as TimeZoneIdNative, Ot as TimeWithUnit, Rt as UTCOffset, Z as $TimeZoneIdentifier, it as ClockTime, st as DateLike } from "./types-DKMN8UeN.cjs";
+import { Cn as Numeric, Mt as TimeZoneIdNative, Ot as TimeWithUnit, Rt as UTCOffset, Z as $TimeZoneIdentifier, it as ClockTime, st as DateLike } from "./types-dNpvroNQ.cjs";
 
 //#region src/guards.d.ts
 /**

package/dist/guards.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { Cn as Numeric, Mt as TimeZoneIdNative, Ot as TimeWithUnit, Rt as UTCOffset, Z as $TimeZoneIdentifier, it as ClockTime, st as DateLike } from "./types-36vIWjN1.mjs";
+import { Cn as Numeric, Mt as TimeZoneIdNative, Ot as TimeWithUnit, Rt as UTCOffset, Z as $TimeZoneIdentifier, it as ClockTime, st as DateLike } from "./types-Be4ZMpOV.mjs";
 
 //#region src/guards.d.ts
 /**

package/dist/guards.mjs

@@ -15,9 +15,9 @@
  */
 
 import { n as NATIVE_TZ_IDS, t as IANA_TZ_IDS } from "./timezone-Db2CeL32.mjs";
-import { n as isNonEmptyString, t as isBoolean } from "./primitives-Csc-jgx0.mjs";
-import { r as isObject, t as isFunction } from "./non-primitives-BG-R5eUB.mjs";
-import { a as isNumericString, n as normalizeNumber } from "./utilities-CQORzytW.mjs";
+import { n as isNonEmptyString, t as isBoolean } from "./primitives-BXhrgs9R.mjs";
+import { r as isObject, t as isFunction } from "./non-primitives-CbAOB6lb.mjs";
+import { a as isNumericString, n as normalizeNumber } from "./utilities-BnHD2hHf.mjs";
 
 //#region src/guards.ts
 /**

package/dist/{helpers-CoVvHHs7.cjs → helpers-Bq7Hczoa.cjs}

@@ -15,9 +15,9 @@
  */
 
 const require_basic = require('./basic-DsQqC5nZ.cjs');
-const require_primitives = require('./primitives-Ce8vYVxN.cjs');
-const require_non_primitives = require('./non-primitives-D3EcMaah.cjs');
-const require_utilities = require('./utilities-BnJa8S6A.cjs');
+const require_primitives = require('./primitives-DfO90c3G.cjs');
+const require_non_primitives = require('./non-primitives-BqjRwK2B.cjs');
+const require_utilities = require('./utilities-C_KmjIRK.cjs');
 const require_guards = require('./guards.cjs');
 
 //#region src/utils/helpers.ts

package/dist/{helpers-X5e54orr.mjs → helpers-C2spzGZ-.mjs}

@@ -15,9 +15,9 @@
  */
 
 import { c as MONTHS, d as SORTED_TIME_FORMATS, i as BN_SEASONS, o as DAYS, r as BN_MONTH_TABLES, u as MS_PER_DAY } from "./basic-DqKyujoj.mjs";
-import { i as isString, n as isNonEmptyString } from "./primitives-Csc-jgx0.mjs";
-import { a as isValidArray, i as isObjectWithKeys } from "./non-primitives-BG-R5eUB.mjs";
-import { t as getOrdinal } from "./utilities-CQORzytW.mjs";
+import { i as isString, n as isNonEmptyString } from "./primitives-BXhrgs9R.mjs";
+import { a as isValidArray, i as isObjectWithKeys } from "./non-primitives-CbAOB6lb.mjs";
+import { t as getOrdinal } from "./utilities-BnHD2hHf.mjs";
 import { isDate, isDateString, isLeapYear, isValidUTCOffset } from "./guards.mjs";
 
 //#region src/utils/helpers.ts

package/dist/index.cjs

@@ -16,11 +16,11 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_basic = require('./basic-DsQqC5nZ.cjs');
-const require_primitives = require('./primitives-Ce8vYVxN.cjs');
-const require_non_primitives = require('./non-primitives-D3EcMaah.cjs');
+const require_primitives = require('./primitives-DfO90c3G.cjs');
+const require_non_primitives = require('./non-primitives-BqjRwK2B.cjs');
 const require_guards = require('./guards.cjs');
-const require_helpers = require('./helpers-CoVvHHs7.cjs');
-const require_utilities = require('./utilities-GTSjQweZ.cjs');
+const require_helpers = require('./helpers-Bq7Hczoa.cjs');
+const require_utilities = require('./utilities-CCnKWAsS.cjs');
 
 //#region src/utils/chronos-fn.ts
 /**
@@ -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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/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,13 +534,13 @@ 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://chronos.nazmul-nhb.dev/docs/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).
 	* @returns A formatted date string in the specified format.
 	*/
-	formatStrict(format, useUTC = false) {
+	formatSafe(format, useUTC = false) {
 		return this.#format(format || "dd, mmm DD, YYYY HH:mm:ss", useUTC);
 	}
 	/**
@@ -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://chronos.nazmul-nhb.dev/docs/chronos/format#format-tokens format tokens} for details.
 	*
 	* @returns Formatted date string in desired format (UTC time).
 	*/
@@ -878,14 +878,13 @@ var Chronos = class Chronos {
 	/**
 	* @instance Returns the difference between current and another date in the given unit.
 	* @param other The other date to compare.
-	* @param unit The unit in which to return the difference.
+	* @param unit The unit in which to return the difference. Defaults to `'millisecond'`.
 	* @returns Difference in number (either `integer` or `float`).
 	*/
-	diff(other, unit) {
+	diff(other, unit = "millisecond") {
 		const time = Chronos.#cast(other);
 		const msDiff = this.#timestamp - time.#timestamp;
 		switch (unit) {
-			case "millisecond": return msDiff;
 			case "second": return msDiff / 1e3;
 			case "minute": return msDiff / 6e4;
 			case "hour": return msDiff / 36e5;
@@ -897,6 +896,7 @@ var Chronos = class Chronos {
 				return yearDiff * 12 + monthDiff + (this.date - time.date) / this.daysInMonth();
 			}
 			case "year": return this.diff(time, "month") / 12;
+			default: return msDiff;
 		}
 	}
 	/**
@@ -1019,15 +1019,15 @@ var Chronos = class Chronos {
 	* - `Q3`: July to September
 	* - `Q4`: October to December
 	*
-	* This method strictly uses the **calendar year**. For fiscal quarters, use {@link toFiscalQuarter} instead.
+	* This method strictly uses the **calendar year**. For fiscal quarters, use {@link https://chronos.nazmul-nhb.dev/docs/plugins/business-plugin#getfiscalquarter getFiscalQuarter} instead.
 	*
 	* @example
-	* new Chronos('2025-02-14').toQuarter(); // 1
-	* new Chronos('2025-08-09').toQuarter(); // 3
+	* new Chronos('2025-02-14').getQuarter(); // 1
+	* new Chronos('2025-08-09').getQuarter(); // 3
 	*
 	* @returns The calendar quarter number (1–4).
 	*/
-	toQuarter() {
+	getQuarter() {
 		const month = this.#date.getMonth();
 		return Math.floor(month / 3) + 1;
 	}
@@ -1047,7 +1047,7 @@ var Chronos = class Chronos {
 	/**
 	* @instance Returns the timezone offset of this `Chronos` instance in `±HH:mm` format maintaining current timezone.
 	*
-	* - *Unlike JavaScript's {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset `Date.prototype.getTimezoneOffset()`}, which returns the offset in minutes **behind** UTC (positive for locations west of UTC and negative for east), this method returns the more intuitive sign format used in timezone representations (e.g., `+06:00` means 6 hours **ahead** of UTC).*
+	* @remarks *Unlike JavaScript's {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset `Date.prototype.getTimezoneOffset()`}, which returns the offset in minutes **behind** UTC (positive for locations west of UTC and negative for east), this method returns the more intuitive sign format used in timezone representations (e.g., `+06:00` means 6 hours **ahead** of UTC).*
 	*
 	* @returns The timezone offset string in `±HH:mm` format maintaining the current timezone regardless of system having different one.
 	*/
@@ -1055,7 +1055,7 @@ var Chronos = class Chronos {
 		return this.#offset.replace("UTC", "");
 	}
 	/**
-	* @instance Gets the difference in minutes between Universal Coordinated Time (UTC) and the time on the local computer.
+	* @instance Gets the difference in minutes between Universal Coordinated Time (UTC) and the time on the local system.
 	*
 	* - *Unlike JavaScript's {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset `Date.prototype.getTimezoneOffset()`}, this method returns a positive value if the local time is ahead of UTC, and negative if behind UTC.*
 	*
@@ -1067,12 +1067,11 @@ var Chronos = class Chronos {
 		return -this.#date.getTimezoneOffset();
 	}
 	/**
-	* @instance Returns the current `Chronos` instance's UTC offset in minutes.
+	* @instance Returns the current `Chronos` instance's timezone offset in minutes.
 	*
-	* This reflects the parsed or stored offset used internally by `Chronos` and follows the same
-	* sign convention: positive for timezones ahead of UTC, negative for behind.
+	* @remarks This reflects the parsed or stored offset used internally by `Chronos` and follows sign convention: positive for timezones ahead of UTC, negative for behind.
 	*
-	* @returns The UTC offset in minutes maintaining the current timezone regardless of system having different one.
+	* @returns The timezone offset in minutes maintaining the current timezone regardless of system having different one.
 	*/
 	getTimeZoneOffsetMinutes() {
 		return require_utilities.extractMinutesFromUTC(this.#offset);
@@ -1272,7 +1271,7 @@ var Chronos = class Chronos {
 	*
 	* - *Input will default to today's date and assume local timezone if no offset is provided.*
 	*
-	* @param format - Format tokens accepted by {@link formatStrict()} method ({@link TimeOnlyFormat}) for time part only.
+	* @param format - Format tokens accepted by {@link formatSafe()} method ({@link TimeOnlyFormat}) for time part only.
 	*                 Default: `hh:mm:ss a` → 02:33:36 pm.
 	* @returns Formatted time string in local (System) time.
 	*/
@@ -1286,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://chronos.nazmul-nhb.dev/docs/chronos/static/get-dates-for-day docs} for details.
 	*/
 	static getDatesForDay(day, options) {
 		let startDate = new Chronos(), endDate = startDate.addWeeks(4);
@@ -1442,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://chronos.nazmul-nhb.dev/docs/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static use(plugin) {
 		if (!Chronos.#plugins.has(plugin)) {
@@ -1460,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://chronos.nazmul-nhb.dev/docs/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 { Ht as chronos, Vt as Chronos } from "./types-DKMN8UeN.cjs";
+import { Ht as chronos, Vt as Chronos } from "./types-dNpvroNQ.cjs";
 export { Chronos, INTERNALS, chronos };

package/dist/index.d.mts

@@ -15,5 +15,5 @@
  */
 
 import { D as INTERNALS } from "./seasons-B_kjFWIX.mjs";
-import { Ht as chronos, Vt as Chronos } from "./types-36vIWjN1.mjs";
+import { Ht as chronos, Vt as Chronos } from "./types-Be4ZMpOV.mjs";
 export { Chronos, INTERNALS, chronos };

package/dist/index.mjs

@@ -15,11 +15,11 @@
  */
 
 import { c as MONTHS, o as DAYS, s as INTERNALS, u as MS_PER_DAY } from "./basic-DqKyujoj.mjs";
-import { r as isNumber } from "./primitives-Csc-jgx0.mjs";
-import { t as isFunction } from "./non-primitives-BG-R5eUB.mjs";
+import { r as isNumber } from "./primitives-BXhrgs9R.mjs";
+import { t as isFunction } from "./non-primitives-CbAOB6lb.mjs";
 import { isDateString, isLeapYear } from "./guards.mjs";
-import { c as _hasChronosProperties, n as _dateArgsToDate, p as _resolveNativeTzName, r as _formatDate, u as _normalizeOffset } from "./helpers-X5e54orr.mjs";
-import { l as getNativeTimeZoneId, r as extractMinutesFromUTC } from "./utilities-CW4F3wFp.mjs";
+import { c as _hasChronosProperties, n as _dateArgsToDate, p as _resolveNativeTzName, r as _formatDate, u as _normalizeOffset } from "./helpers-C2spzGZ-.mjs";
+import { l as getNativeTimeZoneId, r as extractMinutesFromUTC } from "./utilities-C6NiChRE.mjs";
 
 //#region src/utils/chronos-fn.ts
 /**
@@ -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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/plugins/timezone-plugin#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://chronos.nazmul-nhb.dev/docs/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,13 +533,13 @@ 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://chronos.nazmul-nhb.dev/docs/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).
 	* @returns A formatted date string in the specified format.
 	*/
-	formatStrict(format, useUTC = false) {
+	formatSafe(format, useUTC = false) {
 		return this.#format(format || "dd, mmm DD, YYYY HH:mm:ss", useUTC);
 	}
 	/**
@@ -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://chronos.nazmul-nhb.dev/docs/chronos/format#format-tokens format tokens} for details.
 	*
 	* @returns Formatted date string in desired format (UTC time).
 	*/
@@ -877,14 +877,13 @@ var Chronos = class Chronos {
 	/**
 	* @instance Returns the difference between current and another date in the given unit.
 	* @param other The other date to compare.
-	* @param unit The unit in which to return the difference.
+	* @param unit The unit in which to return the difference. Defaults to `'millisecond'`.
 	* @returns Difference in number (either `integer` or `float`).
 	*/
-	diff(other, unit) {
+	diff(other, unit = "millisecond") {
 		const time = Chronos.#cast(other);
 		const msDiff = this.#timestamp - time.#timestamp;
 		switch (unit) {
-			case "millisecond": return msDiff;
 			case "second": return msDiff / 1e3;
 			case "minute": return msDiff / 6e4;
 			case "hour": return msDiff / 36e5;
@@ -896,6 +895,7 @@ var Chronos = class Chronos {
 				return yearDiff * 12 + monthDiff + (this.date - time.date) / this.daysInMonth();
 			}
 			case "year": return this.diff(time, "month") / 12;
+			default: return msDiff;
 		}
 	}
 	/**
@@ -1018,15 +1018,15 @@ var Chronos = class Chronos {
 	* - `Q3`: July to September
 	* - `Q4`: October to December
 	*
-	* This method strictly uses the **calendar year**. For fiscal quarters, use {@link toFiscalQuarter} instead.
+	* This method strictly uses the **calendar year**. For fiscal quarters, use {@link https://chronos.nazmul-nhb.dev/docs/plugins/business-plugin#getfiscalquarter getFiscalQuarter} instead.
 	*
 	* @example
-	* new Chronos('2025-02-14').toQuarter(); // 1
-	* new Chronos('2025-08-09').toQuarter(); // 3
+	* new Chronos('2025-02-14').getQuarter(); // 1
+	* new Chronos('2025-08-09').getQuarter(); // 3
 	*
 	* @returns The calendar quarter number (1–4).
 	*/
-	toQuarter() {
+	getQuarter() {
 		const month = this.#date.getMonth();
 		return Math.floor(month / 3) + 1;
 	}
@@ -1046,7 +1046,7 @@ var Chronos = class Chronos {
 	/**
 	* @instance Returns the timezone offset of this `Chronos` instance in `±HH:mm` format maintaining current timezone.
 	*
-	* - *Unlike JavaScript's {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset `Date.prototype.getTimezoneOffset()`}, which returns the offset in minutes **behind** UTC (positive for locations west of UTC and negative for east), this method returns the more intuitive sign format used in timezone representations (e.g., `+06:00` means 6 hours **ahead** of UTC).*
+	* @remarks *Unlike JavaScript's {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset `Date.prototype.getTimezoneOffset()`}, which returns the offset in minutes **behind** UTC (positive for locations west of UTC and negative for east), this method returns the more intuitive sign format used in timezone representations (e.g., `+06:00` means 6 hours **ahead** of UTC).*
 	*
 	* @returns The timezone offset string in `±HH:mm` format maintaining the current timezone regardless of system having different one.
 	*/
@@ -1054,7 +1054,7 @@ var Chronos = class Chronos {
 		return this.#offset.replace("UTC", "");
 	}
 	/**
-	* @instance Gets the difference in minutes between Universal Coordinated Time (UTC) and the time on the local computer.
+	* @instance Gets the difference in minutes between Universal Coordinated Time (UTC) and the time on the local system.
 	*
 	* - *Unlike JavaScript's {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset `Date.prototype.getTimezoneOffset()`}, this method returns a positive value if the local time is ahead of UTC, and negative if behind UTC.*
 	*
@@ -1066,12 +1066,11 @@ var Chronos = class Chronos {
 		return -this.#date.getTimezoneOffset();
 	}
 	/**
-	* @instance Returns the current `Chronos` instance's UTC offset in minutes.
+	* @instance Returns the current `Chronos` instance's timezone offset in minutes.
 	*
-	* This reflects the parsed or stored offset used internally by `Chronos` and follows the same
-	* sign convention: positive for timezones ahead of UTC, negative for behind.
+	* @remarks This reflects the parsed or stored offset used internally by `Chronos` and follows sign convention: positive for timezones ahead of UTC, negative for behind.
 	*
-	* @returns The UTC offset in minutes maintaining the current timezone regardless of system having different one.
+	* @returns The timezone offset in minutes maintaining the current timezone regardless of system having different one.
 	*/
 	getTimeZoneOffsetMinutes() {
 		return extractMinutesFromUTC(this.#offset);
@@ -1271,7 +1270,7 @@ var Chronos = class Chronos {
 	*
 	* - *Input will default to today's date and assume local timezone if no offset is provided.*
 	*
-	* @param format - Format tokens accepted by {@link formatStrict()} method ({@link TimeOnlyFormat}) for time part only.
+	* @param format - Format tokens accepted by {@link formatSafe()} method ({@link TimeOnlyFormat}) for time part only.
 	*                 Default: `hh:mm:ss a` → 02:33:36 pm.
 	* @returns Formatted time string in local (System) time.
 	*/
@@ -1285,7 +1284,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://chronos.nazmul-nhb.dev/docs/chronos/static/get-dates-for-day docs} for details.
 	*/
 	static getDatesForDay(day, options) {
 		let startDate = new Chronos(), endDate = startDate.addWeeks(4);
@@ -1441,7 +1440,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://chronos.nazmul-nhb.dev/docs/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static use(plugin) {
 		if (!Chronos.#plugins.has(plugin)) {
@@ -1459,7 +1458,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://chronos.nazmul-nhb.dev/docs/plugins#-official-plugins full list of plugins and the methods they register}.
 	*/
 	static register(plugin) {
 		Chronos.use(plugin);

package/dist/{non-primitives-D3EcMaah.cjs → non-primitives-BqjRwK2B.cjs}

@@ -15,7 +15,7 @@
  */
 
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.11/node_modules/nhb-toolbox/dist/esm/guards/non-primitives.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.14/node_modules/nhb-toolbox/dist/esm/guards/non-primitives.js
 function isArray(value) {
 	return Array.isArray(value);
 }

package/dist/{non-primitives-BG-R5eUB.mjs → non-primitives-CbAOB6lb.mjs}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-//#region node_modules/.pnpm/nhb-toolbox@4.30.11/node_modules/nhb-toolbox/dist/esm/guards/non-primitives.js
+//#region node_modules/.pnpm/nhb-toolbox@4.30.14/node_modules/nhb-toolbox/dist/esm/guards/non-primitives.js
 function isArray(value) {
 	return Array.isArray(value);
 }