chronos-date 1.0.0

package/dist/plugins/dayPartPlugin.d.mts

@@ -0,0 +1,45 @@
+import { C as $Chronos, c as DayPart, l as DayPartConfig } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/dayPartPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns the part of day (`'midnight', 'lateNight', 'night', 'morning', 'afternoon', 'evening'`) based on the current hour.
+     *
+     * *Supports both normal and wraparound (overnight) ranges.*
+     *
+     * @param config - Optional custom hour ranges for each part of day.
+     *                 Each range must be a tuple of strings as `[startHour, endHour]` in 24-hour format (e.g., `['06', '11']`).
+     *                 Supports wraparound ranges like `['22', '04']` that cross midnight.
+     *
+     *                 **Default Ranges:**
+     *                 - night: ['21', '23']
+     *                 - midnight: ['00', '01']
+     *                 - lateNight: ['02', '04']
+     *                 - morning: ['05', '11']
+     *                 - afternoon: ['12', '16']
+     *                 - evening: ['17', '20']
+     *
+     * @returns The current part of the day as a string.
+     *
+     * @example
+     * chronosInstance.getPartOfDay(); // e.g., 'morning'
+     *
+     * @example
+     * // Example with custom ranges
+     * chronosInstance.getPartOfDay({
+     *   night: ['22', '04'],
+     *   morning: ['05', '11'],
+     *   afternoon: ['12', '16'],
+     *   evening: ['17', '21'],
+     *   lateNight: ['01', '03'],
+     *   midnight: ['00', '00'],
+     * });
+     */
+    getPartOfDay(config?: DayPartConfig): DayPart;
+  }
+}
+/** * Plugin to inject `getPartOfDay` method */
+declare const dayPartPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { dayPartPlugin };

package/dist/plugins/dayPartPlugin.mjs

@@ -0,0 +1 @@
+import{a as e}from"../basic-e46DaNAi.mjs";import{n as t}from"../non-primitives-B2EE6D6s.mjs";const n=n=>{n.prototype.getPartOfDay=function(n){let r=this.hour,i={...e,...t(n)&&n};for(let[e,[t,n]]of Object.entries(i)){let i=Number(t),a=Number(n);if(i<=a){if(r>=i&&r<=a)return e}else if(r>=i||r<=a)return e}return`night`}};export{n as dayPartPlugin};

package/dist/plugins/durationPlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../basic-CKxaRSHQ.cjs`),t=t=>{let{toNewDate:n}=t[e.s],r=(e,t,n)=>{let r=Object.entries(e),i={...e};if(!t&&!n)for(let[e,t]of r)t!==0&&(i[e]=t*-1);else if(t)for(let[e,t]of r)i[e]=Math.abs(t);return i};t.prototype.duration=function(e,t=!0){let i=this.toDate(),a=n(this,e),o=a>i,s=o?i:a,c=o?a:i,l=e=>c[`get${e}`]()-s[`get${e}`](),u=l(`FullYear`),d=l(`Month`),f=l(`Date`),p=l(`Hours`),m=l(`Minutes`),h=l(`Seconds`),g=l(`Milliseconds`);if(g<0&&(g+=1e3,h--),h<0&&(h+=60,m--),m<0&&(m+=60,p--),p<0&&(p+=24,f--),f<0){let e=new Date(c.getFullYear(),c.getMonth(),0);f+=e.getDate(),d--}return d<0&&(d+=12,u--),r({years:u,months:d,days:f,hours:p,minutes:m,seconds:h,milliseconds:g},t,o)},t.prototype.durationString=function(e){let{toTime:t,absolute:n=!0,maxUnits:r=7,separator:i=`, `,style:a=`full`,showZero:o=!1}=e??{},s=this.duration(t,n),c={years:`y`,months:`mo`,days:`d`,hours:`h`,minutes:`m`,seconds:`s`,milliseconds:`ms`},l=(e,t)=>a===`short`?`${t}${c[e]}`:`${t} ${Math.abs(t)===1?e.slice(0,-1):e}`,u=Object.entries(s).filter(([e,t])=>o||Math.abs(t)>0).slice(0,r).map(([e,t])=>l(e,t));return u.length?u.join(i):a===`short`?`0s`:`0 seconds`}};exports.durationPlugin=t;

package/dist/plugins/durationPlugin.d.cts

@@ -0,0 +1,30 @@
+import { C as $Chronos, D as ChronosInput, d as DurationOptions, g as TimeDuration } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/durationPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns the full time duration breakdown between current input (start) and another time (to) as {@link TimeDuration} object.
+     *
+     * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `duration()`.
+     *
+     * @param toTime The time to compare with. Defaults to `now`.
+     * @param absolute If true, returns all values as positive numbers. Defaults to `true`.
+     * @returns An object of time units: `years`, `months`, `days`, `hours`, `minutes`, `seconds`, `milliseconds` ({@link TimeDuration}).
+     */
+    duration(toTime?: ChronosInput, absolute?: boolean): TimeDuration;
+    /**
+     * @instance Returns a human-readable formatted duration string between the current instance (start) and another time (to).
+     *
+     * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `durationString()`.
+     *
+     * @param options {@link DurationOptions} to format duration string, including the time to compare with.
+     * @returns A formatted duration string, e.g. `"2 hours, 5 minutes"` or `"2h 5m"`.
+     */
+    durationString(options?: DurationOptions): string;
+  }
+}
+/** * Plugin to inject `duration` related methods */
+declare const durationPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { durationPlugin };

package/dist/plugins/durationPlugin.d.mts

@@ -0,0 +1,30 @@
+import { C as $Chronos, D as ChronosInput, d as DurationOptions, g as TimeDuration } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/durationPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns the full time duration breakdown between current input (start) and another time (to) as {@link TimeDuration} object.
+     *
+     * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `duration()`.
+     *
+     * @param toTime The time to compare with. Defaults to `now`.
+     * @param absolute If true, returns all values as positive numbers. Defaults to `true`.
+     * @returns An object of time units: `years`, `months`, `days`, `hours`, `minutes`, `seconds`, `milliseconds` ({@link TimeDuration}).
+     */
+    duration(toTime?: ChronosInput, absolute?: boolean): TimeDuration;
+    /**
+     * @instance Returns a human-readable formatted duration string between the current instance (start) and another time (to).
+     *
+     * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `durationString()`.
+     *
+     * @param options {@link DurationOptions} to format duration string, including the time to compare with.
+     * @returns A formatted duration string, e.g. `"2 hours, 5 minutes"` or `"2h 5m"`.
+     */
+    durationString(options?: DurationOptions): string;
+  }
+}
+/** * Plugin to inject `duration` related methods */
+declare const durationPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { durationPlugin };

package/dist/plugins/durationPlugin.mjs

@@ -0,0 +1 @@
+import{s as e}from"../basic-e46DaNAi.mjs";const t=t=>{let{toNewDate:n}=t[e],r=(e,t,n)=>{let r=Object.entries(e),i={...e};if(!t&&!n)for(let[e,t]of r)t!==0&&(i[e]=t*-1);else if(t)for(let[e,t]of r)i[e]=Math.abs(t);return i};t.prototype.duration=function(e,t=!0){let i=this.toDate(),a=n(this,e),o=a>i,s=o?i:a,c=o?a:i,l=e=>c[`get${e}`]()-s[`get${e}`](),u=l(`FullYear`),d=l(`Month`),f=l(`Date`),p=l(`Hours`),m=l(`Minutes`),h=l(`Seconds`),g=l(`Milliseconds`);if(g<0&&(g+=1e3,h--),h<0&&(h+=60,m--),m<0&&(m+=60,p--),p<0&&(p+=24,f--),f<0){let e=new Date(c.getFullYear(),c.getMonth(),0);f+=e.getDate(),d--}return d<0&&(d+=12,u--),r({years:u,months:d,days:f,hours:p,minutes:m,seconds:h,milliseconds:g},t,o)},t.prototype.durationString=function(e){let{toTime:t,absolute:n=!0,maxUnits:r=7,separator:i=`, `,style:a=`full`,showZero:o=!1}=e??{},s=this.duration(t,n),c={years:`y`,months:`mo`,days:`d`,hours:`h`,minutes:`m`,seconds:`s`,milliseconds:`ms`},l=(e,t)=>a===`short`?`${t}${c[e]}`:`${t} ${Math.abs(t)===1?e.slice(0,-1):e}`,u=Object.entries(s).filter(([e,t])=>o||Math.abs(t)>0).slice(0,r).map(([e,t])=>l(e,t));return u.length?u.join(i):a===`short`?`0s`:`0 seconds`}};export{t as durationPlugin};

package/dist/plugins/fromNowPlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../basic-CKxaRSHQ.cjs`),t=require(`../convert-DrLrcgqz.cjs`),n=n=>{let{toNewDate:r}=n[e.s];n.prototype.fromNow=function(e=`second`,n=!0,i){let a=r(this,i),o=this.toDate(),s=o>a,c=s?a:o,l=s?o:a,u=e=>l[`get${e}`]()-c[`get${e}`](),d=u(`FullYear`),f=u(`Month`),p=u(`Date`),m=u(`Hours`),h=u(`Minutes`),g=u(`Seconds`),_=u(`Milliseconds`);if(_<0&&(_+=1e3,g--),g<0&&(g+=60,h--),h<0&&(h+=60,m--),m<0&&(m+=24,p--),p<0){let e=new Date(l.getFullYear(),l.getMonth(),0);p+=e.getDate(),f--}f<0&&(f+=12,d--);let v=[`year`,`month`,`day`,`hour`,`minute`,`second`,`millisecond`],y=v.indexOf(e),b=[],x=(e,n)=>{b.push(t.t(e,n))},S=e=>y>=v.indexOf(e);d>0&&x(d,`year`),S(`month`)&&f>0&&x(f,`month`),S(`day`)&&p>0&&x(p,`day`),S(`hour`)&&m>0&&x(m,`hour`),S(`minute`)&&h>0&&x(h,`minute`),S(`second`)&&g>0&&x(g,`second`),S(`millisecond`)&&(_>0||b?.length===0)&&x(_,`millisecond`);let C=``,w=``;return n&&(s?C=`in `:w=` ago`),`${C}${b.length?b?.join(` `):`0 ${e}s`}${w}`}};exports.fromNowPlugin=n;

package/dist/plugins/fromNowPlugin.d.cts

@@ -0,0 +1,24 @@
+import { C as $Chronos, D as ChronosInput, ut as FromNowUnit } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/fromNowPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns full time difference from now (or a specified time) down to a given level.
+     *
+     * @param level Determines the smallest unit to include in the output (e.g., 'minute' will show up to minutes, ignoring seconds). Defaults to `second`.
+     * @param withSuffixPrefix If `true`, adds `"in"` or `"ago"` depending on whether the time is in the future or past. Defaults to `true`.
+     * @param time An optional time value to compare with (`string`, `number`, `Date`, or `Chronos` instance). Defaults to `now`.
+     * @returns The difference as a human-readable string, e.g., `2 years 1 month 9 days 18 hours 56 minutes ago`.
+     *
+     *  @remarks
+     * - This method calculates the **elapsed time difference** (exclusive of the end day), consistent with libraries like `Day.js` and `Luxon`.
+     * - If you need an *inclusive calendar-style* difference (counting both start and end days), adjust one day manually before calling `fromNow()`.
+     */
+    fromNow(level?: FromNowUnit, withSuffixPrefix?: boolean, time?: ChronosInput): string;
+  }
+}
+/** * Plugin to inject `fromNow` method */
+declare const fromNowPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { fromNowPlugin };

package/dist/plugins/fromNowPlugin.d.mts

@@ -0,0 +1,24 @@
+import { C as $Chronos, D as ChronosInput, ut as FromNowUnit } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/fromNowPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns full time difference from now (or a specified time) down to a given level.
+     *
+     * @param level Determines the smallest unit to include in the output (e.g., 'minute' will show up to minutes, ignoring seconds). Defaults to `second`.
+     * @param withSuffixPrefix If `true`, adds `"in"` or `"ago"` depending on whether the time is in the future or past. Defaults to `true`.
+     * @param time An optional time value to compare with (`string`, `number`, `Date`, or `Chronos` instance). Defaults to `now`.
+     * @returns The difference as a human-readable string, e.g., `2 years 1 month 9 days 18 hours 56 minutes ago`.
+     *
+     *  @remarks
+     * - This method calculates the **elapsed time difference** (exclusive of the end day), consistent with libraries like `Day.js` and `Luxon`.
+     * - If you need an *inclusive calendar-style* difference (counting both start and end days), adjust one day manually before calling `fromNow()`.
+     */
+    fromNow(level?: FromNowUnit, withSuffixPrefix?: boolean, time?: ChronosInput): string;
+  }
+}
+/** * Plugin to inject `fromNow` method */
+declare const fromNowPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { fromNowPlugin };

package/dist/plugins/fromNowPlugin.mjs

@@ -0,0 +1 @@
+import{s as e}from"../basic-e46DaNAi.mjs";import{t}from"../convert-Bmp63ats.mjs";const n=n=>{let{toNewDate:r}=n[e];n.prototype.fromNow=function(e=`second`,n=!0,i){let a=r(this,i),o=this.toDate(),s=o>a,c=s?a:o,l=s?o:a,u=e=>l[`get${e}`]()-c[`get${e}`](),d=u(`FullYear`),f=u(`Month`),p=u(`Date`),m=u(`Hours`),h=u(`Minutes`),g=u(`Seconds`),_=u(`Milliseconds`);if(_<0&&(_+=1e3,g--),g<0&&(g+=60,h--),h<0&&(h+=60,m--),m<0&&(m+=24,p--),p<0){let e=new Date(l.getFullYear(),l.getMonth(),0);p+=e.getDate(),f--}f<0&&(f+=12,d--);let v=[`year`,`month`,`day`,`hour`,`minute`,`second`,`millisecond`],y=v.indexOf(e),b=[],x=(e,n)=>{b.push(t(e,n))},S=e=>y>=v.indexOf(e);d>0&&x(d,`year`),S(`month`)&&f>0&&x(f,`month`),S(`day`)&&p>0&&x(p,`day`),S(`hour`)&&m>0&&x(m,`hour`),S(`minute`)&&h>0&&x(h,`minute`),S(`second`)&&g>0&&x(g,`second`),S(`millisecond`)&&(_>0||b?.length===0)&&x(_,`millisecond`);let C=``,w=``;return n&&(s?C=`in `:w=` ago`),`${C}${b.length?b?.join(` `):`0 ${e}s`}${w}`}};export{n as fromNowPlugin};

package/dist/plugins/greetingPlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../greet-C-6mruI9.cjs`),t=t=>{t.prototype.getGreeting=function(t){return e.t({currentTime:this.formatStrict(`HH:mm`),...t})},t.prototype.greet=function(e){return this.getGreeting(e)}};exports.greetingPlugin=t;

package/dist/plugins/greetingPlugin.d.cts

@@ -0,0 +1,29 @@
+import { C as $Chronos, dt as GreetingConfigs } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/greetingPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns a greeting message based on current instance of `Chronos` time or provided time in the `configs`.
+     *
+     * @remarks This method internally uses {@link https://toolbox.nazmul-nhb.dev/docs/utilities/date/getGreeting getGreeting} function.
+     *
+     * @param configs - Configuration options for greeting times and messages.
+     * @returns The appropriate greeting message.
+     */
+    getGreeting(configs?: GreetingConfigs): string;
+    /**
+     * @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.
+     *
+     * @param configs - Configuration options for greeting times and messages.
+     * @returns The appropriate greeting message.
+     */
+    greet(configs?: GreetingConfigs): string;
+  }
+}
+/** * Plugin to inject `getGreeting`/`greet` method */
+declare const greetingPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { greetingPlugin };

package/dist/plugins/greetingPlugin.d.mts

@@ -0,0 +1,29 @@
+import { C as $Chronos, dt as GreetingConfigs } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/greetingPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns a greeting message based on current instance of `Chronos` time or provided time in the `configs`.
+     *
+     * @remarks This method internally uses {@link https://toolbox.nazmul-nhb.dev/docs/utilities/date/getGreeting getGreeting} function.
+     *
+     * @param configs - Configuration options for greeting times and messages.
+     * @returns The appropriate greeting message.
+     */
+    getGreeting(configs?: GreetingConfigs): string;
+    /**
+     * @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.
+     *
+     * @param configs - Configuration options for greeting times and messages.
+     * @returns The appropriate greeting message.
+     */
+    greet(configs?: GreetingConfigs): string;
+  }
+}
+/** * Plugin to inject `getGreeting`/`greet` method */
+declare const greetingPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { greetingPlugin };

package/dist/plugins/greetingPlugin.mjs

@@ -0,0 +1 @@
+import{t as e}from"../greet-BBsrvmkn.mjs";const t=t=>{t.prototype.getGreeting=function(t){return e({currentTime:this.formatStrict(`HH:mm`),...t})},t.prototype.greet=function(e){return this.getGreeting(e)}};export{t as greetingPlugin};

package/dist/plugins/palindromePlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../convert-DrLrcgqz.cjs`),t=t=>{let n=t.toLowerCase().replace(/[^a-z0-9]/g,``);return n===e.n(n)},n=e=>{e.prototype.isPalindromeDate=function(e=!1){let n=this.formatStrict(e?`YY-MM-DD`:`YYYY-MM-DD`),r=this.formatStrict(e?`YY-M-D`:`YYYY-M-D`);return t(n)||t(r)}};exports.palindromePlugin=n;

package/dist/plugins/palindromePlugin.d.cts

@@ -0,0 +1,38 @@
+import { C as $Chronos } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/palindromePlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Checks if the current date is a palindrome in either padded or non-padded format.
+     *
+     * @remarks
+     * A palindrome date reads the same forward and backward, excluding delimiters.
+     * This method checks both zero-padded (`MM-DD`) and non-padded (`M-D`) formats for flexibility.
+     *
+     * Examples of palindromes:
+     * - `'2020-02-02'` → `'20200202'` ✅
+     * - `'2112-11-12'` → `'21121112'` ❌
+     * - `'2011-01-11'` (from `'YY-M-D'`) → `'11111'` ✅
+     * - `'2011-01-11'` (from `'YYYY-M-D'`) → `'11111'` ❌
+     *
+     * @param shortYear - If `true`, uses `'YY-MM-DD'` and `'YY-M-D'` formats.
+     *                    If `false`, uses `'YYYY-MM-DD'` and `'YYYY-M-D'` formats.
+     *                    Defaults to `false`.
+     *
+     * @returns `true` if either padded or non-padded formatted date is a palindrome, otherwise `false`.
+     *
+     * @example
+     * new Chronos('2020-02-02').isPalindromeDate(); // true
+     * new Chronos('2112-11-12').isPalindromeDate(); // false
+     * new Chronos('2011-1-11').isPalindromeDate(); // false (from '2011111')
+     * new Chronos('2011-1-11').isPalindromeDate(true); // true (from '11111')
+     * new Chronos('2024-04-11').isPalindromeDate(); // false
+     */
+    isPalindromeDate(shortYear: boolean): boolean;
+  }
+}
+/** * Plugin to inject `isPalindromeDate` method */
+declare const palindromePlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { palindromePlugin };

package/dist/plugins/palindromePlugin.d.mts

@@ -0,0 +1,38 @@
+import { C as $Chronos } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/palindromePlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Checks if the current date is a palindrome in either padded or non-padded format.
+     *
+     * @remarks
+     * A palindrome date reads the same forward and backward, excluding delimiters.
+     * This method checks both zero-padded (`MM-DD`) and non-padded (`M-D`) formats for flexibility.
+     *
+     * Examples of palindromes:
+     * - `'2020-02-02'` → `'20200202'` ✅
+     * - `'2112-11-12'` → `'21121112'` ❌
+     * - `'2011-01-11'` (from `'YY-M-D'`) → `'11111'` ✅
+     * - `'2011-01-11'` (from `'YYYY-M-D'`) → `'11111'` ❌
+     *
+     * @param shortYear - If `true`, uses `'YY-MM-DD'` and `'YY-M-D'` formats.
+     *                    If `false`, uses `'YYYY-MM-DD'` and `'YYYY-M-D'` formats.
+     *                    Defaults to `false`.
+     *
+     * @returns `true` if either padded or non-padded formatted date is a palindrome, otherwise `false`.
+     *
+     * @example
+     * new Chronos('2020-02-02').isPalindromeDate(); // true
+     * new Chronos('2112-11-12').isPalindromeDate(); // false
+     * new Chronos('2011-1-11').isPalindromeDate(); // false (from '2011111')
+     * new Chronos('2011-1-11').isPalindromeDate(true); // true (from '11111')
+     * new Chronos('2024-04-11').isPalindromeDate(); // false
+     */
+    isPalindromeDate(shortYear: boolean): boolean;
+  }
+}
+/** * Plugin to inject `isPalindromeDate` method */
+declare const palindromePlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { palindromePlugin };

package/dist/plugins/palindromePlugin.mjs

@@ -0,0 +1 @@
+import{n as e}from"../convert-Bmp63ats.mjs";const t=t=>{let n=t.toLowerCase().replace(/[^a-z0-9]/g,``);return n===e(n)},n=e=>{e.prototype.isPalindromeDate=function(e=!1){let n=this.formatStrict(e?`YY-MM-DD`:`YYYY-MM-DD`),r=this.formatStrict(e?`YY-M-D`:`YYYY-M-D`);return t(n)||t(r)}};export{n as palindromePlugin};

package/dist/plugins/relativeTimePlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../basic-CKxaRSHQ.cjs`),t=t=>{let{toNewDate:n}=t[e.s];t.prototype.getRelativeYear=function(e){let t=this.toDate(),r=n(this,e),i=t.getFullYear()-r.getFullYear();return(r.getMonth()<t.getMonth()||r.getMonth()===t.getMonth()&&r.getDate()<t.getDate())&&i--,i},t.prototype.getRelativeMonth=function(e){let t=this.toDate(),r=n(this,e),i=(t.getFullYear()-r.getFullYear())*12+(t.getMonth()-r.getMonth());return r.getDate()<t.getDate()&&i--,i},t.prototype.getRelativeWeek=function(e){let t=this.getRelativeDay(e);return Math.floor(t/7)},t.prototype.getRelativeDay=function(e){let t=n(this,e);t.setHours(0,0,0,0);let r=new Date(this.toDate());r.setHours(0,0,0,0);let i=r.getTime()-t.getTime();return Math.floor(i/(1e3*60*60*24))},t.prototype.getRelativeHour=function(e){let t=this.getTimeStamp()-n(this,e).getTime();return Math.floor(t/(1e3*60*60))},t.prototype.getRelativeMinute=function(e){let t=this.getTimeStamp()-n(this,e).getTime();return Math.floor(t/(1e3*60))},t.prototype.getRelativeSecond=function(e){let t=this.getTimeStamp()-n(this,e).getTime();return Math.floor(t/1e3)},t.prototype.getRelativeMilliSecond=function(e){return this.getTimeStamp()-n(this,e).getTime()},t.prototype.compare=function(e=`minute`,t){switch(e){case`year`:return this.getRelativeYear(t);case`month`:return this.getRelativeMonth(t);case`day`:return this.getRelativeDay(t);case`week`:return this.getRelativeWeek(t);case`hour`:return this.getRelativeHour(t);case`minute`:return this.getRelativeMinute(t);case`second`:return this.getRelativeSecond(t);case`millisecond`:return this.getRelativeMilliSecond(t);default:throw RangeError(`Unsupported time unit: ${e}`)}},t.prototype.isToday=function(){return this.getRelativeDay()===0},t.prototype.isTomorrow=function(){return this.getRelativeDay()===1},t.prototype.isYesterday=function(){return this.getRelativeDay()===-1}};exports.relativeTimePlugin=t;

package/dist/plugins/relativeTimePlugin.d.cts

@@ -0,0 +1,82 @@
+import { C as $Chronos, D as ChronosInput, Et as TimeUnit } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/relativeTimePlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns the number of full years between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeYear(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full months between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeMonth(time?: ChronosInput): number;
+    /**
+     * @instance Determines if the given date is today, tomorrow, yesterday or any relative day.
+     * @param date - The date to compare (Date object).
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns
+     *  - `-1` if the date is yesterday.
+     *  - `0` if the date is today.
+     *  - `1` if the date is tomorrow.
+     *  - Other positive or negative numbers for other relative days (e.g., `-2` for two days ago, `2` for two days ahead).
+     */
+    getRelativeWeek(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full hours between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeDay(time?: ChronosInput): number;
+    /**
+     * @instance Determines how many full weeks apart the input date is from the `Chronos` instance.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns Difference in weeks; negative if past, positive if future.
+     */
+    getRelativeHour(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full minutes between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeMinute(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full seconds between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeSecond(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of milliseconds between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeMilliSecond(time?: ChronosInput): number;
+    /**
+     * @instance Compares the stored date with now, returning the relative difference in the specified unit.
+     *
+     * @remarks
+     * - Internally uses {@link getRelativeYear}, {@link getRelativeMonth}, {@link getRelativeWeek}, {@link getRelativeDay}, {@link getRelativeHour}, {@link getRelativeMinute}, {@link getRelativeSecond} and {@link getRelativeMilliSecond} and rounds the result.
+     * - To calculate accurate difference use {@link diff} method.
+     *
+     * @param unit The time unit to compare by. Defaults to `'minute'`.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    compare(unit?: TimeUnit, time?: ChronosInput): number;
+    /** @instance Checks if the current date is today. */
+    isToday(): boolean;
+    /** @instance Checks if the current date is tomorrow. */
+    isTomorrow(): boolean;
+    /** @instance Checks if the current date is yesterday. */
+    isYesterday(): boolean;
+  }
+}
+/** * Plugin to inject `relative time` related methods */
+declare const relativeTimePlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { relativeTimePlugin };

package/dist/plugins/relativeTimePlugin.d.mts

@@ -0,0 +1,82 @@
+import { C as $Chronos, D as ChronosInput, Et as TimeUnit } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/relativeTimePlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns the number of full years between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeYear(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full months between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeMonth(time?: ChronosInput): number;
+    /**
+     * @instance Determines if the given date is today, tomorrow, yesterday or any relative day.
+     * @param date - The date to compare (Date object).
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns
+     *  - `-1` if the date is yesterday.
+     *  - `0` if the date is today.
+     *  - `1` if the date is tomorrow.
+     *  - Other positive or negative numbers for other relative days (e.g., `-2` for two days ago, `2` for two days ahead).
+     */
+    getRelativeWeek(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full hours between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeDay(time?: ChronosInput): number;
+    /**
+     * @instance Determines how many full weeks apart the input date is from the `Chronos` instance.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns Difference in weeks; negative if past, positive if future.
+     */
+    getRelativeHour(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full minutes between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeMinute(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of full seconds between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeSecond(time?: ChronosInput): number;
+    /**
+     * @instance Returns the number of milliseconds between the input date and now.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    getRelativeMilliSecond(time?: ChronosInput): number;
+    /**
+     * @instance Compares the stored date with now, returning the relative difference in the specified unit.
+     *
+     * @remarks
+     * - Internally uses {@link getRelativeYear}, {@link getRelativeMonth}, {@link getRelativeWeek}, {@link getRelativeDay}, {@link getRelativeHour}, {@link getRelativeMinute}, {@link getRelativeSecond} and {@link getRelativeMilliSecond} and rounds the result.
+     * - To calculate accurate difference use {@link diff} method.
+     *
+     * @param unit The time unit to compare by. Defaults to `'minute'`.
+     * @param time Optional time to compare with the `Chronos` date/time. Defaults to current time.
+     * @returns The difference in number, negative when `Chronos` time is a past time else positive.
+     */
+    compare(unit?: TimeUnit, time?: ChronosInput): number;
+    /** @instance Checks if the current date is today. */
+    isToday(): boolean;
+    /** @instance Checks if the current date is tomorrow. */
+    isTomorrow(): boolean;
+    /** @instance Checks if the current date is yesterday. */
+    isYesterday(): boolean;
+  }
+}
+/** * Plugin to inject `relative time` related methods */
+declare const relativeTimePlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { relativeTimePlugin };

package/dist/plugins/relativeTimePlugin.mjs

@@ -0,0 +1 @@
+import{s as e}from"../basic-e46DaNAi.mjs";const t=t=>{let{toNewDate:n}=t[e];t.prototype.getRelativeYear=function(e){let t=this.toDate(),r=n(this,e),i=t.getFullYear()-r.getFullYear();return(r.getMonth()<t.getMonth()||r.getMonth()===t.getMonth()&&r.getDate()<t.getDate())&&i--,i},t.prototype.getRelativeMonth=function(e){let t=this.toDate(),r=n(this,e),i=(t.getFullYear()-r.getFullYear())*12+(t.getMonth()-r.getMonth());return r.getDate()<t.getDate()&&i--,i},t.prototype.getRelativeWeek=function(e){let t=this.getRelativeDay(e);return Math.floor(t/7)},t.prototype.getRelativeDay=function(e){let t=n(this,e);t.setHours(0,0,0,0);let r=new Date(this.toDate());r.setHours(0,0,0,0);let i=r.getTime()-t.getTime();return Math.floor(i/(1e3*60*60*24))},t.prototype.getRelativeHour=function(e){let t=this.getTimeStamp()-n(this,e).getTime();return Math.floor(t/(1e3*60*60))},t.prototype.getRelativeMinute=function(e){let t=this.getTimeStamp()-n(this,e).getTime();return Math.floor(t/(1e3*60))},t.prototype.getRelativeSecond=function(e){let t=this.getTimeStamp()-n(this,e).getTime();return Math.floor(t/1e3)},t.prototype.getRelativeMilliSecond=function(e){return this.getTimeStamp()-n(this,e).getTime()},t.prototype.compare=function(e=`minute`,t){switch(e){case`year`:return this.getRelativeYear(t);case`month`:return this.getRelativeMonth(t);case`day`:return this.getRelativeDay(t);case`week`:return this.getRelativeWeek(t);case`hour`:return this.getRelativeHour(t);case`minute`:return this.getRelativeMinute(t);case`second`:return this.getRelativeSecond(t);case`millisecond`:return this.getRelativeMilliSecond(t);default:throw RangeError(`Unsupported time unit: ${e}`)}},t.prototype.isToday=function(){return this.getRelativeDay()===0},t.prototype.isTomorrow=function(){return this.getRelativeDay()===1},t.prototype.isYesterday=function(){return this.getRelativeDay()===-1}};export{t as relativeTimePlugin};

package/dist/plugins/roundPlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../basic-CKxaRSHQ.cjs`),t=require(`../utilities-D2-p26DX.cjs`),n=n=>{let{internalDate:r,withOrigin:i,offset:a}=n[e.s];n.prototype.round=function(o,s=1){let c=new Date(r(this));switch(o){case`millisecond`:{let e=t.r(c.getMilliseconds(),s);c.setMilliseconds(e);break}case`second`:{let e=t.r(c.getSeconds()+c.getMilliseconds()/1e3,s);c.setSeconds(e,0);break}case`minute`:{let e=t.r(c.getMinutes()+c.getSeconds()/60+c.getMilliseconds()/6e4,s);c.setMinutes(e,0,0);break}case`hour`:{let e=t.r(c.getHours()+c.getMinutes()/60+c.getSeconds()/3600+c.getMilliseconds()/36e5,s);c.setHours(e,0,0,0);break}case`day`:{let n=t.r(c.getDate()+(c.getHours()/24+c.getMinutes()/1440+c.getSeconds()/86400+c.getMilliseconds()/e.u),s);c.setDate(n),c.setHours(0,0,0,0);break}case`week`:{let e=(c.getDay()+6)%7,t=new Date(c);t.setDate(t.getDate()-e),t.setHours(0,0,0,0);let r=new Date(t);r.setDate(r.getDate()+7);let a=Math.abs(c.getTime()-t.getTime());return i(new n(Math.abs(r.getTime()-c.getTime())<a?r:t),`round`)}case`month`:{let e=t.r(c.getMonth()+c.getDate()/this.lastDateOfMonth,s);c.setMonth(e,1),c.setHours(0,0,0,0);break}case`year`:{let n=Math.floor((c.getTime()-new Date(c.getFullYear(),0,1).getTime())/e.u),r=new Date(c.getFullYear(),1,29).getDate()===29?366:365,i=t.r(c.getFullYear()+n/r,s);c.setFullYear(i,0,1),c.setHours(0,0,0,0);break}default:return this}return i(new n(c),`round`,a(this),this.timeZoneName,this.timeZoneId,this.$tzTracker)}};exports.roundPlugin=n;

package/dist/plugins/roundPlugin.d.cts

@@ -0,0 +1,29 @@
+import { C as $Chronos, Et as TimeUnit } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/roundPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Rounds the current date-time to the nearest specified unit and interval.
+     *
+     * - *Rounding is based on proximity to the start or end of the specified unit.*
+     * - *For example, rounding `2025-05-23` by 'day' returns either midnight of May 23 or May 24, depending on the time of day.*
+     *
+     * @param unit - The time unit to round to (`year`, `month`, `week`, `day`, `hour`, `minute`, `second`, `millisecond`).
+     * @param nearest - Optional granularity of rounding. (Defaults to `1`).
+     *
+     * @returns A new `Chronos` instance at the nearest rounded point in time. For wrong unit returns current instance.
+     *
+     * @remarks
+     * - Rounding for `'month'` is based on how far into the month the date is. If past the midpoint, it rounds to the next month.
+     *   - Month indices are 0-based internally (January = 0), but the resulting date reflects the correct calendar month.
+     * - For `'week'` unit, rounding is performed by comparing proximity to the start and end of the ISO week (Monday to Sunday).
+     *   - If the date is closer to the next Monday, it rounds forward; otherwise, it rounds back to the previous Monday.
+     */
+    round(unit: TimeUnit, nearest?: number): Chronos;
+  }
+}
+/** * Plugin to inject `round` method */
+declare const roundPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { roundPlugin };

package/dist/plugins/roundPlugin.d.mts

@@ -0,0 +1,29 @@
+import { C as $Chronos, Et as TimeUnit } from "../types-B2fgrJ86.mjs";
+
+//#region src/plugins/roundPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Rounds the current date-time to the nearest specified unit and interval.
+     *
+     * - *Rounding is based on proximity to the start or end of the specified unit.*
+     * - *For example, rounding `2025-05-23` by 'day' returns either midnight of May 23 or May 24, depending on the time of day.*
+     *
+     * @param unit - The time unit to round to (`year`, `month`, `week`, `day`, `hour`, `minute`, `second`, `millisecond`).
+     * @param nearest - Optional granularity of rounding. (Defaults to `1`).
+     *
+     * @returns A new `Chronos` instance at the nearest rounded point in time. For wrong unit returns current instance.
+     *
+     * @remarks
+     * - Rounding for `'month'` is based on how far into the month the date is. If past the midpoint, it rounds to the next month.
+     *   - Month indices are 0-based internally (January = 0), but the resulting date reflects the correct calendar month.
+     * - For `'week'` unit, rounding is performed by comparing proximity to the start and end of the ISO week (Monday to Sunday).
+     *   - If the date is closer to the next Monday, it rounds forward; otherwise, it rounds back to the previous Monday.
+     */
+    round(unit: TimeUnit, nearest?: number): Chronos;
+  }
+}
+/** * Plugin to inject `round` method */
+declare const roundPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { roundPlugin };

package/dist/plugins/roundPlugin.mjs

@@ -0,0 +1 @@
+import{s as e,u as t}from"../basic-e46DaNAi.mjs";import{r as n}from"../utilities-BJE06bms.mjs";const r=r=>{let{internalDate:i,withOrigin:a,offset:o}=r[e];r.prototype.round=function(e,s=1){let c=new Date(i(this));switch(e){case`millisecond`:{let e=n(c.getMilliseconds(),s);c.setMilliseconds(e);break}case`second`:{let e=n(c.getSeconds()+c.getMilliseconds()/1e3,s);c.setSeconds(e,0);break}case`minute`:{let e=n(c.getMinutes()+c.getSeconds()/60+c.getMilliseconds()/6e4,s);c.setMinutes(e,0,0);break}case`hour`:{let e=n(c.getHours()+c.getMinutes()/60+c.getSeconds()/3600+c.getMilliseconds()/36e5,s);c.setHours(e,0,0,0);break}case`day`:{let e=n(c.getDate()+(c.getHours()/24+c.getMinutes()/1440+c.getSeconds()/86400+c.getMilliseconds()/t),s);c.setDate(e),c.setHours(0,0,0,0);break}case`week`:{let e=(c.getDay()+6)%7,t=new Date(c);t.setDate(t.getDate()-e),t.setHours(0,0,0,0);let n=new Date(t);n.setDate(n.getDate()+7);let i=Math.abs(c.getTime()-t.getTime());return a(new r(Math.abs(n.getTime()-c.getTime())<i?n:t),`round`)}case`month`:{let e=n(c.getMonth()+c.getDate()/this.lastDateOfMonth,s);c.setMonth(e,1),c.setHours(0,0,0,0);break}case`year`:{let e=Math.floor((c.getTime()-new Date(c.getFullYear(),0,1).getTime())/t),r=new Date(c.getFullYear(),1,29).getDate()===29?366:365,i=n(c.getFullYear()+e/r,s);c.setFullYear(i,0,1),c.setHours(0,0,0,0);break}default:return this}return a(new r(c),`round`,o(this),this.timeZoneName,this.timeZoneId,this.$tzTracker)}};export{r as roundPlugin};

package/dist/plugins/seasonPlugin.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../seasons-oABOhHcX.cjs`),t=t=>{t.prototype.season=function(t){let{preset:n=`default`}=t??{},r=t?.seasons??e.u[n],i=this.format(`MM-DD`);for(let{name:e,boundary:t}of r)if(`startDate`in t&&`endDate`in t){let n=t.startDate,r=t.endDate;if(n<=r){if(i>=n&&i<=r)return e}else if(i>=n||i<=r)return e}else if(`startMonth`in t&&`endMonth`in t){let{startMonth:n,endMonth:r}=t;if(n<=r){if(this.month>=n&&this.month<=r)return e}else if(this.month>=n||this.month<=r)return e}return`Unknown`},t.prototype.getSeasonName=function(e){return this.season(e)}};exports.seasonPlugin=t;

package/dist/plugins/seasonPlugin.d.cts

@@ -0,0 +1,26 @@
+import { C as $Chronos, m as SeasonOptions } from "../types-DPTQ_yLx.cjs";
+
+//#region src/plugins/seasonPlugin.d.ts
+declare module '../' {
+  interface Chronos {
+    /**
+     * @instance Returns the current season name based on optional season rules or presets.
+     * @param options Configuration with optional custom seasons or preset name.
+     * @returns The name of the season the current date falls under.
+     */
+    season(options?: SeasonOptions): string;
+    /**
+     * @instance Returns the current season name based on optional season rules or presets.
+     *
+     * @remarks This method is an alias for {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/names#season season} method.
+     *
+     * @param options Configuration with optional custom seasons or preset name.
+     * @returns The name of the season the current date falls under.
+     */
+    getSeasonName(options?: SeasonOptions): string;
+  }
+}
+/** * Plugin to inject `season`/`getSeasonName` method */
+declare const seasonPlugin: ($Chronos: $Chronos) => void;
+//#endregion
+export { seasonPlugin };