@kikiutils/shared 18.0.0 → 18.1.0

package/dist/classes/enhanced-date.js

@@ -0,0 +1,591 @@
+import * as dateFns from "date-fns";
+//#region src/classes/enhanced-date.ts
+/**
+* A mutable calendar date with chainable date-fns operations.
+*
+* @remarks
+* Inherits the native constructor, including zero-based month arguments and millisecond timestamps.
+* Native methods retain their original behavior.
+* Mutating arithmetic and boundary methods update this instance and return `this`;
+* their `to`-prefixed counterparts return a new `EnhancedDate` instead.
+* Invalid dates, parsing, rounding, and week defaults follow date-fns semantics.
+* Operations use the system time zone unless configured through date-fns options.
+* Day and week arithmetic uses calendar days, preserving local wall-clock time across daylight saving changes.
+* Hour, minute, second, and millisecond arithmetic uses elapsed durations. Month and year arithmetic clamps
+* to the last valid day of the destination month. Native setters retain their native overflow behavior.
+* Exceptions from date-fns propagate unchanged, and operations can preserve or produce `Invalid Date`.
+*
+* When used in Vue state, prefer replacing the value with a `to`-prefixed result:
+* mutating a Date's internal timestamp does not trigger reactive updates.
+*
+* @example
+*
+* ```ts
+* import { EnhancedDate } from '@kikiutils/shared/classes/enhanced-date';
+*
+* const date = new EnhancedDate('2026-01-31T12:00:00Z');
+* const nextMonth = date.toAddMonths(1); // Original date is unchanged.
+* date.addDays(1).startOfDay(); // Mutates the original date.
+* nextMonth.isAfter(date);
+* ```
+*/
+var EnhancedDate = class EnhancedDate extends Date {
+	/**
+	* Returns a new instance at the end of today in the system time zone.
+	*/
+	static endOfToday() {
+		return new EnhancedDate(dateFns.endOfToday());
+	}
+	/**
+	* Parses a date using date-fns and an explicit reference for missing fields.
+	*
+	* @param value - Date string to parse.
+	* @param pattern - date-fns parsing pattern.
+	* @param referenceDate - Reference for fields absent from the pattern.
+	* @param options - Options passed to `date-fns/parse`.
+	*
+	* @returns A new `EnhancedDate`, including `Invalid Date` for invalid values.
+	*/
+	static fromFormat(value, pattern, referenceDate, options) {
+		return new EnhancedDate(dateFns.parse(value, pattern, referenceDate, options));
+	}
+	/**
+	* Parses an ISO 8601 string using date-fns, including its partial-date support.
+	*
+	* @param value - ISO date string.
+	* @param options - Options passed to `date-fns/parseISO`.
+	*
+	* @returns A new `EnhancedDate`, or `Invalid Date` when parsing fails.
+	*/
+	static fromISO(value, options) {
+		return new EnhancedDate(dateFns.parseISO(value, options));
+	}
+	/**
+	* Creates a date from Unix seconds; native constructor numbers remain milliseconds.
+	*
+	* @param seconds - Seconds since the Unix epoch.
+	*/
+	static fromUnixSeconds(seconds) {
+		return new EnhancedDate(seconds * 1e3);
+	}
+	/**
+	* Returns a new instance at the start of today in the system time zone.
+	*/
+	static startOfToday() {
+		return new EnhancedDate(dateFns.startOfToday());
+	}
+	/**
+	* Adds the specified number of days in place using date-fns.
+	*
+	* @param amount - Number of days.
+	*
+	* @returns This instance for chaining.
+	*/
+	addDays(amount) {
+		this.setTime(dateFns.addDays(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of hours in place using date-fns.
+	*
+	* @param amount - Number of hours.
+	*
+	* @returns This instance for chaining.
+	*/
+	addHours(amount) {
+		this.setTime(dateFns.addHours(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of milliseconds in place using date-fns.
+	*
+	* @param amount - Number of milliseconds.
+	*
+	* @returns This instance for chaining.
+	*/
+	addMilliseconds(amount) {
+		this.setTime(dateFns.addMilliseconds(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of minutes in place using date-fns.
+	*
+	* @param amount - Number of minutes.
+	*
+	* @returns This instance for chaining.
+	*/
+	addMinutes(amount) {
+		this.setTime(dateFns.addMinutes(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of months in place using date-fns.
+	*
+	* @param amount - Number of months.
+	*
+	* @returns This instance for chaining.
+	*/
+	addMonths(amount) {
+		this.setTime(dateFns.addMonths(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of seconds in place using date-fns.
+	*
+	* @param amount - Number of seconds.
+	*
+	* @returns This instance for chaining.
+	*/
+	addSeconds(amount) {
+		this.setTime(dateFns.addSeconds(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of weeks in place using date-fns.
+	*
+	* @param amount - Number of weeks.
+	*
+	* @returns This instance for chaining.
+	*/
+	addWeeks(amount) {
+		this.setTime(dateFns.addWeeks(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Adds the specified number of years in place using date-fns.
+	*
+	* @param amount - Number of years.
+	*
+	* @returns This instance for chaining.
+	*/
+	addYears(amount) {
+		this.setTime(dateFns.addYears(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Returns a new `EnhancedDate` with the same timestamp, including `Invalid Date`.
+	*/
+	clone() {
+		return new EnhancedDate(this.getTime());
+	}
+	/**
+	* Returns the signed difference in calendar days: this date minus the other date.
+	*
+	* @remarks
+	* Defaults and rounding follow date-fns.
+	*/
+	differenceInCalendarDays(other) {
+		return dateFns.differenceInCalendarDays(this, other);
+	}
+	/**
+	* Returns the signed difference in calendar weeks: this date minus the other date.
+	*
+	* @remarks
+	* Defaults and rounding follow date-fns.
+	*/
+	differenceInCalendarWeeks(other, options) {
+		return dateFns.differenceInCalendarWeeks(this, other, options);
+	}
+	/**
+	* Returns the signed difference in full minutes: this date minus the other date.
+	*
+	* @remarks
+	* Defaults and rounding follow date-fns.
+	*/
+	differenceInMinutes(other, options) {
+		return dateFns.differenceInMinutes(this, other, options);
+	}
+	/**
+	* Moves this date to the end of its day in place.
+	*
+	* @returns This instance for chaining.
+	*/
+	endOfDay() {
+		this.setTime(dateFns.endOfDay(this).getTime());
+		return this;
+	}
+	/**
+	* Moves this date to the end of its minute in place.
+	*
+	* @returns This instance for chaining.
+	*/
+	endOfMinute() {
+		this.setTime(dateFns.endOfMinute(this).getTime());
+		return this;
+	}
+	/**
+	* Moves this date to the end of its month in place.
+	*
+	* @returns This instance for chaining.
+	*/
+	endOfMonth() {
+		this.setTime(dateFns.endOfMonth(this).getTime());
+		return this;
+	}
+	/**
+	* Moves this date to the end of its week in place.
+	*
+	* @param options - date-fns week options; defaults are unchanged.
+	*
+	* @returns This instance for chaining.
+	*/
+	endOfWeek(options) {
+		this.setTime(dateFns.endOfWeek(this, options).getTime());
+		return this;
+	}
+	/**
+	* Formats this date using a date-fns pattern (default: `yyyy-MM-dd HH:mm:ss`) and optional locale/options.
+	*
+	* @remarks
+	* Invalid dates and invalid patterns retain date-fns error behavior.
+	*/
+	format(pattern = "yyyy-MM-dd HH:mm:ss", options) {
+		return dateFns.format(this, pattern, options);
+	}
+	/**
+	* Formats the distance from this date to now using date-fns.
+	*/
+	formatDistanceToNow(options) {
+		return dateFns.formatDistanceToNow(this, options);
+	}
+	/**
+	* Returns Unix seconds using date-fns; `getTime()` returns milliseconds.
+	*/
+	getUnixTime() {
+		return dateFns.getUnixTime(this);
+	}
+	/**
+	* Checks whether this date occurs after the other date.
+	*/
+	isAfter(other) {
+		return dateFns.isAfter(this, other);
+	}
+	/**
+	* Checks whether this date occurs before the other date.
+	*/
+	isBefore(other) {
+		return dateFns.isBefore(this, other);
+	}
+	/**
+	* Checks whether this date has the same timestamp as the other date.
+	*/
+	isEqual(other) {
+		return dateFns.isEqual(this, other);
+	}
+	/**
+	* Checks whether this date is after the current time.
+	*/
+	isFuture() {
+		return dateFns.isFuture(this);
+	}
+	/**
+	* Checks whether this date falls on the same calendar day as the other date.
+	*/
+	isSameDay(other) {
+		return dateFns.isSameDay(this, other);
+	}
+	/**
+	* Checks whether this date falls in the same calendar minute as the other date.
+	*/
+	isSameMinute(other) {
+		return dateFns.isSameMinute(this, other);
+	}
+	/**
+	* Checks whether this date falls on today.
+	*/
+	isToday() {
+		return dateFns.isToday(this);
+	}
+	/**
+	* Checks whether this date falls on tomorrow.
+	*/
+	isTomorrow() {
+		return dateFns.isTomorrow(this);
+	}
+	/**
+	* Checks whether this date has a valid timestamp.
+	*/
+	isValid() {
+		return dateFns.isValid(this);
+	}
+	/**
+	* Moves this date to the start of its day in place.
+	*
+	* @returns This instance for chaining.
+	*/
+	startOfDay() {
+		this.setTime(dateFns.startOfDay(this).getTime());
+		return this;
+	}
+	/**
+	* Moves this date to the start of its minute in place.
+	*
+	* @returns This instance for chaining.
+	*/
+	startOfMinute() {
+		this.setTime(dateFns.startOfMinute(this).getTime());
+		return this;
+	}
+	/**
+	* Moves this date to the start of its month in place.
+	*
+	* @returns This instance for chaining.
+	*/
+	startOfMonth() {
+		this.setTime(dateFns.startOfMonth(this).getTime());
+		return this;
+	}
+	/**
+	* Moves this date to the start of its week in place.
+	*
+	* @param options - date-fns week options; defaults are unchanged.
+	*
+	* @returns This instance for chaining.
+	*/
+	startOfWeek(options) {
+		this.setTime(dateFns.startOfWeek(this, options).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of days in place using date-fns.
+	*
+	* @param amount - Number of days.
+	*
+	* @returns This instance for chaining.
+	*/
+	subDays(amount) {
+		this.setTime(dateFns.subDays(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of hours in place using date-fns.
+	*
+	* @param amount - Number of hours.
+	*
+	* @returns This instance for chaining.
+	*/
+	subHours(amount) {
+		this.setTime(dateFns.subHours(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of milliseconds in place using date-fns.
+	*
+	* @param amount - Number of milliseconds.
+	*
+	* @returns This instance for chaining.
+	*/
+	subMilliseconds(amount) {
+		this.setTime(dateFns.subMilliseconds(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of minutes in place using date-fns.
+	*
+	* @param amount - Number of minutes.
+	*
+	* @returns This instance for chaining.
+	*/
+	subMinutes(amount) {
+		this.setTime(dateFns.subMinutes(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of months in place using date-fns.
+	*
+	* @param amount - Number of months.
+	*
+	* @returns This instance for chaining.
+	*/
+	subMonths(amount) {
+		this.setTime(dateFns.subMonths(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of seconds in place using date-fns.
+	*
+	* @param amount - Number of seconds.
+	*
+	* @returns This instance for chaining.
+	*/
+	subSeconds(amount) {
+		this.setTime(dateFns.subSeconds(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of weeks in place using date-fns.
+	*
+	* @param amount - Number of weeks.
+	*
+	* @returns This instance for chaining.
+	*/
+	subWeeks(amount) {
+		this.setTime(dateFns.subWeeks(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Subtracts the specified number of years in place using date-fns.
+	*
+	* @param amount - Number of years.
+	*
+	* @returns This instance for chaining.
+	*/
+	subYears(amount) {
+		this.setTime(dateFns.subYears(this, amount).getTime());
+		return this;
+	}
+	/**
+	* Returns a new instance with days added, leaving this date unchanged.
+	*/
+	toAddDays(amount) {
+		return this.clone().addDays(amount);
+	}
+	/**
+	* Returns a new instance with hours added, leaving this date unchanged.
+	*/
+	toAddHours(amount) {
+		return this.clone().addHours(amount);
+	}
+	/**
+	* Returns a new instance with milliseconds added, leaving this date unchanged.
+	*/
+	toAddMilliseconds(amount) {
+		return this.clone().addMilliseconds(amount);
+	}
+	/**
+	* Returns a new instance with minutes added, leaving this date unchanged.
+	*/
+	toAddMinutes(amount) {
+		return this.clone().addMinutes(amount);
+	}
+	/**
+	* Returns a new instance with months added, leaving this date unchanged.
+	*/
+	toAddMonths(amount) {
+		return this.clone().addMonths(amount);
+	}
+	/**
+	* Returns a new instance with seconds added, leaving this date unchanged.
+	*/
+	toAddSeconds(amount) {
+		return this.clone().addSeconds(amount);
+	}
+	/**
+	* Returns a new instance with weeks added, leaving this date unchanged.
+	*/
+	toAddWeeks(amount) {
+		return this.clone().addWeeks(amount);
+	}
+	/**
+	* Returns a new instance with years added, leaving this date unchanged.
+	*/
+	toAddYears(amount) {
+		return this.clone().addYears(amount);
+	}
+	/**
+	* Returns a new plain native Date; mutations are not shared with this instance.
+	*/
+	toDate() {
+		return new Date(this.getTime());
+	}
+	/**
+	* Returns a new instance at the end of this day, leaving this date unchanged.
+	*/
+	toEndOfDay() {
+		return this.clone().endOfDay();
+	}
+	/**
+	* Returns a new instance at the end of this minute, leaving this date unchanged.
+	*/
+	toEndOfMinute() {
+		return this.clone().endOfMinute();
+	}
+	/**
+	* Returns a new instance at the end of this month, leaving this date unchanged.
+	*/
+	toEndOfMonth() {
+		return this.clone().endOfMonth();
+	}
+	/**
+	* Returns a new instance at the end of this week, leaving this date unchanged.
+	*/
+	toEndOfWeek(options) {
+		return this.clone().endOfWeek(options);
+	}
+	/**
+	* Returns a new instance at the start of this day, leaving this date unchanged.
+	*/
+	toStartOfDay() {
+		return this.clone().startOfDay();
+	}
+	/**
+	* Returns a new instance at the start of this minute, leaving this date unchanged.
+	*/
+	toStartOfMinute() {
+		return this.clone().startOfMinute();
+	}
+	/**
+	* Returns a new instance at the start of this month, leaving this date unchanged.
+	*/
+	toStartOfMonth() {
+		return this.clone().startOfMonth();
+	}
+	/**
+	* Returns a new instance at the start of this week, leaving this date unchanged.
+	*/
+	toStartOfWeek(options) {
+		return this.clone().startOfWeek(options);
+	}
+	/**
+	* Returns a new instance with days subtracted, leaving this date unchanged.
+	*/
+	toSubDays(amount) {
+		return this.clone().subDays(amount);
+	}
+	/**
+	* Returns a new instance with hours subtracted, leaving this date unchanged.
+	*/
+	toSubHours(amount) {
+		return this.clone().subHours(amount);
+	}
+	/**
+	* Returns a new instance with milliseconds subtracted, leaving this date unchanged.
+	*/
+	toSubMilliseconds(amount) {
+		return this.clone().subMilliseconds(amount);
+	}
+	/**
+	* Returns a new instance with minutes subtracted, leaving this date unchanged.
+	*/
+	toSubMinutes(amount) {
+		return this.clone().subMinutes(amount);
+	}
+	/**
+	* Returns a new instance with months subtracted, leaving this date unchanged.
+	*/
+	toSubMonths(amount) {
+		return this.clone().subMonths(amount);
+	}
+	/**
+	* Returns a new instance with seconds subtracted, leaving this date unchanged.
+	*/
+	toSubSeconds(amount) {
+		return this.clone().subSeconds(amount);
+	}
+	/**
+	* Returns a new instance with weeks subtracted, leaving this date unchanged.
+	*/
+	toSubWeeks(amount) {
+		return this.clone().subWeeks(amount);
+	}
+	/**
+	* Returns a new instance with years subtracted, leaving this date unchanged.
+	*/
+	toSubYears(amount) {
+		return this.clone().subYears(amount);
+	}
+};
+//#endregion
+export { EnhancedDate };
+
+//# sourceMappingURL=enhanced-date.js.map

package/dist/classes/enhanced-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-date.js","names":[],"sources":["../../src/classes/enhanced-date.ts"],"sourcesContent":["import * as dateFns from 'date-fns';\n\n/**\n * A mutable calendar date with chainable date-fns operations.\n *\n * @remarks\n * Inherits the native constructor, including zero-based month arguments and millisecond timestamps.\n * Native methods retain their original behavior.\n * Mutating arithmetic and boundary methods update this instance and return `this`;\n * their `to`-prefixed counterparts return a new `EnhancedDate` instead.\n * Invalid dates, parsing, rounding, and week defaults follow date-fns semantics.\n * Operations use the system time zone unless configured through date-fns options.\n * Day and week arithmetic uses calendar days, preserving local wall-clock time across daylight saving changes.\n * Hour, minute, second, and millisecond arithmetic uses elapsed durations. Month and year arithmetic clamps\n * to the last valid day of the destination month. Native setters retain their native overflow behavior.\n * Exceptions from date-fns propagate unchanged, and operations can preserve or produce `Invalid Date`.\n *\n * When used in Vue state, prefer replacing the value with a `to`-prefixed result:\n * mutating a Date's internal timestamp does not trigger reactive updates.\n *\n * @example\n *\n * ```ts\n * import { EnhancedDate } from '@kikiutils/shared/classes/enhanced-date';\n *\n * const date = new EnhancedDate('2026-01-31T12:00:00Z');\n * const nextMonth = date.toAddMonths(1); // Original date is unchanged.\n * date.addDays(1).startOfDay(); // Mutates the original date.\n * nextMonth.isAfter(date);\n * ```\n */\nexport class EnhancedDate extends Date {\n    // Public static methods\n\n    /**\n     * Returns a new instance at the end of today in the system time zone.\n     */\n    static endOfToday() {\n        return new EnhancedDate(dateFns.endOfToday());\n    }\n\n    /**\n     * Parses a date using date-fns and an explicit reference for missing fields.\n     *\n     * @param value - Date string to parse.\n     * @param pattern - date-fns parsing pattern.\n     * @param referenceDate - Reference for fields absent from the pattern.\n     * @param options - Options passed to `date-fns/parse`.\n     *\n     * @returns A new `EnhancedDate`, including `Invalid Date` for invalid values.\n     */\n    static fromFormat(\n        value: string,\n        pattern: string,\n        referenceDate: dateFns.DateArg<Date>,\n        options?: dateFns.ParseOptions,\n    ) {\n        return new EnhancedDate(dateFns.parse(value, pattern, referenceDate, options));\n    }\n\n    /**\n     * Parses an ISO 8601 string using date-fns, including its partial-date support.\n     *\n     * @param value - ISO date string.\n     * @param options - Options passed to `date-fns/parseISO`.\n     *\n     * @returns A new `EnhancedDate`, or `Invalid Date` when parsing fails.\n     */\n    static fromISO(value: string, options?: dateFns.ParseISOOptions) {\n        return new EnhancedDate(dateFns.parseISO(value, options));\n    }\n\n    /**\n     * Creates a date from Unix seconds; native constructor numbers remain milliseconds.\n     *\n     * @param seconds - Seconds since the Unix epoch.\n     */\n    static fromUnixSeconds(seconds: number) {\n        return new EnhancedDate(seconds * 1000);\n    }\n\n    /**\n     * Returns a new instance at the start of today in the system time zone.\n     */\n    static startOfToday() {\n        return new EnhancedDate(dateFns.startOfToday());\n    }\n\n    // Public instance methods\n\n    /**\n     * Adds the specified number of days in place using date-fns.\n     *\n     * @param amount - Number of days.\n     *\n     * @returns This instance for chaining.\n     */\n    addDays(amount: number) {\n        this.setTime(dateFns.addDays(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of hours in place using date-fns.\n     *\n     * @param amount - Number of hours.\n     *\n     * @returns This instance for chaining.\n     */\n    addHours(amount: number) {\n        this.setTime(dateFns.addHours(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of milliseconds in place using date-fns.\n     *\n     * @param amount - Number of milliseconds.\n     *\n     * @returns This instance for chaining.\n     */\n    addMilliseconds(amount: number) {\n        this.setTime(dateFns.addMilliseconds(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of minutes in place using date-fns.\n     *\n     * @param amount - Number of minutes.\n     *\n     * @returns This instance for chaining.\n     */\n    addMinutes(amount: number) {\n        this.setTime(dateFns.addMinutes(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of months in place using date-fns.\n     *\n     * @param amount - Number of months.\n     *\n     * @returns This instance for chaining.\n     */\n    addMonths(amount: number) {\n        this.setTime(dateFns.addMonths(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of seconds in place using date-fns.\n     *\n     * @param amount - Number of seconds.\n     *\n     * @returns This instance for chaining.\n     */\n    addSeconds(amount: number) {\n        this.setTime(dateFns.addSeconds(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of weeks in place using date-fns.\n     *\n     * @param amount - Number of weeks.\n     *\n     * @returns This instance for chaining.\n     */\n    addWeeks(amount: number) {\n        this.setTime(dateFns.addWeeks(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Adds the specified number of years in place using date-fns.\n     *\n     * @param amount - Number of years.\n     *\n     * @returns This instance for chaining.\n     */\n    addYears(amount: number) {\n        this.setTime(dateFns.addYears(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Returns a new `EnhancedDate` with the same timestamp, including `Invalid Date`.\n     */\n    clone() {\n        return new EnhancedDate(this.getTime());\n    }\n\n    /**\n     * Returns the signed difference in calendar days: this date minus the other date.\n     *\n     * @remarks\n     * Defaults and rounding follow date-fns.\n     */\n    differenceInCalendarDays(other: dateFns.DateArg<Date>) {\n        return dateFns.differenceInCalendarDays(this, other);\n    }\n\n    /**\n     * Returns the signed difference in calendar weeks: this date minus the other date.\n     *\n     * @remarks\n     * Defaults and rounding follow date-fns.\n     */\n    differenceInCalendarWeeks(other: dateFns.DateArg<Date>, options?: dateFns.DifferenceInCalendarWeeksOptions) {\n        return dateFns.differenceInCalendarWeeks(this, other, options);\n    }\n\n    /**\n     * Returns the signed difference in full minutes: this date minus the other date.\n     *\n     * @remarks\n     * Defaults and rounding follow date-fns.\n     */\n    differenceInMinutes(other: dateFns.DateArg<Date>, options?: dateFns.DifferenceInMinutesOptions) {\n        return dateFns.differenceInMinutes(this, other, options);\n    }\n\n    /**\n     * Moves this date to the end of its day in place.\n     *\n     * @returns This instance for chaining.\n     */\n    endOfDay() {\n        this.setTime(dateFns.endOfDay(this).getTime());\n        return this;\n    }\n\n    /**\n     * Moves this date to the end of its minute in place.\n     *\n     * @returns This instance for chaining.\n     */\n    endOfMinute() {\n        this.setTime(dateFns.endOfMinute(this).getTime());\n        return this;\n    }\n\n    /**\n     * Moves this date to the end of its month in place.\n     *\n     * @returns This instance for chaining.\n     */\n    endOfMonth() {\n        this.setTime(dateFns.endOfMonth(this).getTime());\n        return this;\n    }\n\n    /**\n     * Moves this date to the end of its week in place.\n     *\n     * @param options - date-fns week options; defaults are unchanged.\n     *\n     * @returns This instance for chaining.\n     */\n    endOfWeek(options?: dateFns.EndOfWeekOptions) {\n        this.setTime(dateFns.endOfWeek(this, options).getTime());\n        return this;\n    }\n\n    /**\n     * Formats this date using a date-fns pattern (default: `yyyy-MM-dd HH:mm:ss`) and optional locale/options.\n     *\n     * @remarks\n     * Invalid dates and invalid patterns retain date-fns error behavior.\n     */\n    format(pattern: string = 'yyyy-MM-dd HH:mm:ss', options?: dateFns.FormatOptions) {\n        return dateFns.format(this, pattern, options);\n    }\n\n    /**\n     * Formats the distance from this date to now using date-fns.\n     */\n    formatDistanceToNow(options?: dateFns.FormatDistanceToNowOptions) {\n        return dateFns.formatDistanceToNow(this, options);\n    }\n\n    /**\n     * Returns Unix seconds using date-fns; `getTime()` returns milliseconds.\n     */\n    getUnixTime() {\n        return dateFns.getUnixTime(this);\n    }\n\n    /**\n     * Checks whether this date occurs after the other date.\n     */\n    isAfter(other: dateFns.DateArg<Date>) {\n        return dateFns.isAfter(this, other);\n    }\n\n    /**\n     * Checks whether this date occurs before the other date.\n     */\n    isBefore(other: dateFns.DateArg<Date>) {\n        return dateFns.isBefore(this, other);\n    }\n\n    /**\n     * Checks whether this date has the same timestamp as the other date.\n     */\n    isEqual(other: dateFns.DateArg<Date>) {\n        return dateFns.isEqual(this, other);\n    }\n\n    /**\n     * Checks whether this date is after the current time.\n     */\n    isFuture() {\n        return dateFns.isFuture(this);\n    }\n\n    /**\n     * Checks whether this date falls on the same calendar day as the other date.\n     */\n    isSameDay(other: dateFns.DateArg<Date>) {\n        return dateFns.isSameDay(this, other);\n    }\n\n    /**\n     * Checks whether this date falls in the same calendar minute as the other date.\n     */\n    isSameMinute(other: dateFns.DateArg<Date>) {\n        return dateFns.isSameMinute(this, other);\n    }\n\n    /**\n     * Checks whether this date falls on today.\n     */\n    isToday() {\n        return dateFns.isToday(this);\n    }\n\n    /**\n     * Checks whether this date falls on tomorrow.\n     */\n    isTomorrow() {\n        return dateFns.isTomorrow(this);\n    }\n\n    /**\n     * Checks whether this date has a valid timestamp.\n     */\n    isValid() {\n        return dateFns.isValid(this);\n    }\n\n    /**\n     * Moves this date to the start of its day in place.\n     *\n     * @returns This instance for chaining.\n     */\n    startOfDay() {\n        this.setTime(dateFns.startOfDay(this).getTime());\n        return this;\n    }\n\n    /**\n     * Moves this date to the start of its minute in place.\n     *\n     * @returns This instance for chaining.\n     */\n    startOfMinute() {\n        this.setTime(dateFns.startOfMinute(this).getTime());\n        return this;\n    }\n\n    /**\n     * Moves this date to the start of its month in place.\n     *\n     * @returns This instance for chaining.\n     */\n    startOfMonth() {\n        this.setTime(dateFns.startOfMonth(this).getTime());\n        return this;\n    }\n\n    /**\n     * Moves this date to the start of its week in place.\n     *\n     * @param options - date-fns week options; defaults are unchanged.\n     *\n     * @returns This instance for chaining.\n     */\n    startOfWeek(options?: dateFns.StartOfWeekOptions) {\n        this.setTime(dateFns.startOfWeek(this, options).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of days in place using date-fns.\n     *\n     * @param amount - Number of days.\n     *\n     * @returns This instance for chaining.\n     */\n    subDays(amount: number) {\n        this.setTime(dateFns.subDays(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of hours in place using date-fns.\n     *\n     * @param amount - Number of hours.\n     *\n     * @returns This instance for chaining.\n     */\n    subHours(amount: number) {\n        this.setTime(dateFns.subHours(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of milliseconds in place using date-fns.\n     *\n     * @param amount - Number of milliseconds.\n     *\n     * @returns This instance for chaining.\n     */\n    subMilliseconds(amount: number) {\n        this.setTime(dateFns.subMilliseconds(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of minutes in place using date-fns.\n     *\n     * @param amount - Number of minutes.\n     *\n     * @returns This instance for chaining.\n     */\n    subMinutes(amount: number) {\n        this.setTime(dateFns.subMinutes(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of months in place using date-fns.\n     *\n     * @param amount - Number of months.\n     *\n     * @returns This instance for chaining.\n     */\n    subMonths(amount: number) {\n        this.setTime(dateFns.subMonths(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of seconds in place using date-fns.\n     *\n     * @param amount - Number of seconds.\n     *\n     * @returns This instance for chaining.\n     */\n    subSeconds(amount: number) {\n        this.setTime(dateFns.subSeconds(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of weeks in place using date-fns.\n     *\n     * @param amount - Number of weeks.\n     *\n     * @returns This instance for chaining.\n     */\n    subWeeks(amount: number) {\n        this.setTime(dateFns.subWeeks(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Subtracts the specified number of years in place using date-fns.\n     *\n     * @param amount - Number of years.\n     *\n     * @returns This instance for chaining.\n     */\n    subYears(amount: number) {\n        this.setTime(dateFns.subYears(this, amount).getTime());\n        return this;\n    }\n\n    /**\n     * Returns a new instance with days added, leaving this date unchanged.\n     */\n    toAddDays(amount: number) {\n        return this.clone().addDays(amount);\n    }\n\n    /**\n     * Returns a new instance with hours added, leaving this date unchanged.\n     */\n    toAddHours(amount: number) {\n        return this.clone().addHours(amount);\n    }\n\n    /**\n     * Returns a new instance with milliseconds added, leaving this date unchanged.\n     */\n    toAddMilliseconds(amount: number) {\n        return this.clone().addMilliseconds(amount);\n    }\n\n    /**\n     * Returns a new instance with minutes added, leaving this date unchanged.\n     */\n    toAddMinutes(amount: number) {\n        return this.clone().addMinutes(amount);\n    }\n\n    /**\n     * Returns a new instance with months added, leaving this date unchanged.\n     */\n    toAddMonths(amount: number) {\n        return this.clone().addMonths(amount);\n    }\n\n    /**\n     * Returns a new instance with seconds added, leaving this date unchanged.\n     */\n    toAddSeconds(amount: number) {\n        return this.clone().addSeconds(amount);\n    }\n\n    /**\n     * Returns a new instance with weeks added, leaving this date unchanged.\n     */\n    toAddWeeks(amount: number) {\n        return this.clone().addWeeks(amount);\n    }\n\n    /**\n     * Returns a new instance with years added, leaving this date unchanged.\n     */\n    toAddYears(amount: number) {\n        return this.clone().addYears(amount);\n    }\n\n    /**\n     * Returns a new plain native Date; mutations are not shared with this instance.\n     */\n    toDate() {\n        return new Date(this.getTime());\n    }\n\n    /**\n     * Returns a new instance at the end of this day, leaving this date unchanged.\n     */\n    toEndOfDay() {\n        return this.clone().endOfDay();\n    }\n\n    /**\n     * Returns a new instance at the end of this minute, leaving this date unchanged.\n     */\n    toEndOfMinute() {\n        return this.clone().endOfMinute();\n    }\n\n    /**\n     * Returns a new instance at the end of this month, leaving this date unchanged.\n     */\n    toEndOfMonth() {\n        return this.clone().endOfMonth();\n    }\n\n    /**\n     * Returns a new instance at the end of this week, leaving this date unchanged.\n     */\n    toEndOfWeek(options?: dateFns.EndOfWeekOptions) {\n        return this.clone().endOfWeek(options);\n    }\n\n    /**\n     * Returns a new instance at the start of this day, leaving this date unchanged.\n     */\n    toStartOfDay() {\n        return this.clone().startOfDay();\n    }\n\n    /**\n     * Returns a new instance at the start of this minute, leaving this date unchanged.\n     */\n    toStartOfMinute() {\n        return this.clone().startOfMinute();\n    }\n\n    /**\n     * Returns a new instance at the start of this month, leaving this date unchanged.\n     */\n    toStartOfMonth() {\n        return this.clone().startOfMonth();\n    }\n\n    /**\n     * Returns a new instance at the start of this week, leaving this date unchanged.\n     */\n    toStartOfWeek(options?: dateFns.StartOfWeekOptions) {\n        return this.clone().startOfWeek(options);\n    }\n\n    /**\n     * Returns a new instance with days subtracted, leaving this date unchanged.\n     */\n    toSubDays(amount: number) {\n        return this.clone().subDays(amount);\n    }\n\n    /**\n     * Returns a new instance with hours subtracted, leaving this date unchanged.\n     */\n    toSubHours(amount: number) {\n        return this.clone().subHours(amount);\n    }\n\n    /**\n     * Returns a new instance with milliseconds subtracted, leaving this date unchanged.\n     */\n    toSubMilliseconds(amount: number) {\n        return this.clone().subMilliseconds(amount);\n    }\n\n    /**\n     * Returns a new instance with minutes subtracted, leaving this date unchanged.\n     */\n    toSubMinutes(amount: number) {\n        return this.clone().subMinutes(amount);\n    }\n\n    /**\n     * Returns a new instance with months subtracted, leaving this date unchanged.\n     */\n    toSubMonths(amount: number) {\n        return this.clone().subMonths(amount);\n    }\n\n    /**\n     * Returns a new instance with seconds subtracted, leaving this date unchanged.\n     */\n    toSubSeconds(amount: number) {\n        return this.clone().subSeconds(amount);\n    }\n\n    /**\n     * Returns a new instance with weeks subtracted, leaving this date unchanged.\n     */\n    toSubWeeks(amount: number) {\n        return this.clone().subWeeks(amount);\n    }\n\n    /**\n     * Returns a new instance with years subtracted, leaving this date unchanged.\n     */\n    toSubYears(amount: number) {\n        return this.clone().subYears(amount);\n    }\n}\n"],"mappings":"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"}