@kikiutils/shared 18.1.0 → 18.3.0

package/dist/classes/enhanced-date.d.ts

@@ -34,6 +34,14 @@ export declare class EnhancedDate extends Date {
    * Returns a new instance at the end of today in the system time zone.
    */
   static endOfToday(): EnhancedDate;
+  /**
+   * Returns a new instance at the end of tomorrow in the system time zone.
+   */
+  static endOfTomorrow(): EnhancedDate;
+  /**
+   * Returns a new instance at the end of yesterday in the system time zone.
+   */
+  static endOfYesterday(): EnhancedDate;
   /**
    * Parses a date using date-fns and an explicit reference for missing fields.
    *
@@ -60,10 +68,34 @@ export declare class EnhancedDate extends Date {
    * @param seconds - Seconds since the Unix epoch.
    */
   static fromUnixSeconds(seconds: number): EnhancedDate;
+  /**
+   * Returns the latest date as a new independent instance.
+   *
+   * @param dates - Dates or millisecond timestamps to compare.
+   *
+   * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
+   */
+  static max(dates: (Date | number)[]): EnhancedDate;
+  /**
+   * Returns the earliest date as a new independent instance.
+   *
+   * @param dates - Dates or millisecond timestamps to compare.
+   *
+   * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
+   */
+  static min(dates: (Date | number)[]): EnhancedDate;
   /**
    * Returns a new instance at the start of today in the system time zone.
    */
   static startOfToday(): EnhancedDate;
+  /**
+   * Returns a new instance at the start of tomorrow in the system time zone.
+   */
+  static startOfTomorrow(): EnhancedDate;
+  /**
+   * Returns a new instance at the start of yesterday in the system time zone.
+   */
+  static startOfYesterday(): EnhancedDate;
   /**
    * Adds the specified number of days in place using date-fns.
    *

package/dist/classes/enhanced-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enhanced-date.d.ts","names":[],"sources":["../../src/classes/enhanced-date.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA+Ba,qBAAqB;;;;SAMvB,cAAU;;;;;;;;;;;SAcV,WACH,eACA,iBACA,eAAe,QAAQ,QAAQ,OAC/B,UAAU,QAAQ,eAAY;;;;;;;;;SAa3B,QAAQ,eAAe,UAAU,QAAQ,kBAAe;;;;;;SASxD,gBAAgB,kBAAe;;;;SAO/B,gBAAY;;;;;;;;EAanB,QAAQ;;;;;;;;EAYR,SAAS;;;;;;;;EAYT,gBAAgB;;;;;;;;EAYhB,WAAW;;;;;;;;EAYX,UAAU;;;;;;;;EAYV,WAAW;;;;;;;;EAYX,SAAS;;;;;;;;EAYT,SAAS;;;;EAQT,SAAK;;;;;;;EAUL,yBAAyB,OAAO,QAAQ,QAAQ;;;;;;;EAUhD,0BAA0B,OAAO,QAAQ,QAAQ,OAAO,UAAU,QAAQ;;;;;;;EAU1E,oBAAoB,OAAO,QAAQ,QAAQ,OAAO,UAAU,QAAQ;;;;;;EASpE;;;;;;EAUA;;;;;;EAUA;;;;;;;;EAYA,UAAU,UAAU,QAAQ;;;;;;;EAW5B,OAAO,kBAAyC,UAAU,QAAQ;;;;EAOlE,oBAAoB,UAAU,QAAQ;;;;EAOtC;;;;EAOA,QAAQ,OAAO,QAAQ,QAAQ;;;;EAO/B,SAAS,OAAO,QAAQ,QAAQ;;;;EAOhC,QAAQ,OAAO,QAAQ,QAAQ;;;;EAO/B;;;;EAOA,UAAU,OAAO,QAAQ,QAAQ;;;;EAOjC,aAAa,OAAO,QAAQ,QAAQ;;;;EAOpC;;;;EAOA;;;;EAOA;;;;;;EASA;;;;;;EAUA;;;;;;EAUA;;;;;;;;EAYA,YAAY,UAAU,QAAQ;;;;;;;;EAY9B,QAAQ;;;;;;;;EAYR,SAAS;;;;;;;;EAYT,gBAAgB;;;;;;;;EAYhB,WAAW;;;;;;;;EAYX,UAAU;;;;;;;;EAYV,WAAW;;;;;;;;EAYX,SAAS;;;;;;;;EAYT,SAAS;;;;EAQT,UAAU,iBAAc;;;;EAOxB,WAAW,iBAAc;;;;EAOzB,kBAAkB,iBAAc;;;;EAOhC,aAAa,iBAAc;;;;EAO3B,YAAY,iBAAc;;;;EAO1B,aAAa,iBAAc;;;;EAO3B,WAAW,iBAAc;;;;EAOzB,WAAW,iBAAc;;;;EAOzB,UAAM;;;;EAON,cAAU;;;;EAOV,iBAAa;;;;EAOb,gBAAY;;;;EAOZ,YAAY,UAAU,QAAQ,mBAAgB;;;;EAO9C,gBAAY;;;;EAOZ,mBAAe;;;;EAOf,kBAAc;;;;EAOd,cAAc,UAAU,QAAQ,qBAAkB;;;;EAOlD,UAAU,iBAAc;;;;EAOxB,WAAW,iBAAc;;;;EAOzB,kBAAkB,iBAAc;;;;EAOhC,aAAa,iBAAc;;;;EAO3B,YAAY,iBAAc;;;;EAO1B,aAAa,iBAAc;;;;EAO3B,WAAW,iBAAc;;;;EAOzB,WAAW,iBAAc"}
+{"version":3,"file":"enhanced-date.d.ts","names":[],"sources":["../../src/classes/enhanced-date.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA+Ba,qBAAqB;;;;SAMvB,cAAU;;;;SAOV,iBAAa;;;;SAOb,kBAAc;;;;;;;;;;;SAcd,WACH,eACA,iBACA,eAAe,QAAQ,QAAQ,OAC/B,UAAU,QAAQ,eAAY;;;;;;;;;SAa3B,QAAQ,eAAe,UAAU,QAAQ,kBAAe;;;;;;SASxD,gBAAgB,kBAAe;;;;;;;;SAW/B,IAAI,QAAQ,mBAAgB;;;;;;;;SAW5B,IAAI,QAAQ,mBAAgB;;;;SAO5B,gBAAY;;;;SAOZ,mBAAe;;;;SAOf,oBAAgB;;;;;;;;EAavB,QAAQ;;;;;;;;EAYR,SAAS;;;;;;;;EAYT,gBAAgB;;;;;;;;EAYhB,WAAW;;;;;;;;EAYX,UAAU;;;;;;;;EAYV,WAAW;;;;;;;;EAYX,SAAS;;;;;;;;EAYT,SAAS;;;;EAQT,SAAK;;;;;;;EAUL,yBAAyB,OAAO,QAAQ,QAAQ;;;;;;;EAUhD,0BAA0B,OAAO,QAAQ,QAAQ,OAAO,UAAU,QAAQ;;;;;;;EAU1E,oBAAoB,OAAO,QAAQ,QAAQ,OAAO,UAAU,QAAQ;;;;;;EASpE;;;;;;EAUA;;;;;;EAUA;;;;;;;;EAYA,UAAU,UAAU,QAAQ;;;;;;;EAW5B,OAAO,kBAAyC,UAAU,QAAQ;;;;EAOlE,oBAAoB,UAAU,QAAQ;;;;EAOtC;;;;EAOA,QAAQ,OAAO,QAAQ,QAAQ;;;;EAO/B,SAAS,OAAO,QAAQ,QAAQ;;;;EAOhC,QAAQ,OAAO,QAAQ,QAAQ;;;;EAO/B;;;;EAOA,UAAU,OAAO,QAAQ,QAAQ;;;;EAOjC,aAAa,OAAO,QAAQ,QAAQ;;;;EAOpC;;;;EAOA;;;;EAOA;;;;;;EASA;;;;;;EAUA;;;;;;EAUA;;;;;;;;EAYA,YAAY,UAAU,QAAQ;;;;;;;;EAY9B,QAAQ;;;;;;;;EAYR,SAAS;;;;;;;;EAYT,gBAAgB;;;;;;;;EAYhB,WAAW;;;;;;;;EAYX,UAAU;;;;;;;;EAYV,WAAW;;;;;;;;EAYX,SAAS;;;;;;;;EAYT,SAAS;;;;EAQT,UAAU,iBAAc;;;;EAOxB,WAAW,iBAAc;;;;EAOzB,kBAAkB,iBAAc;;;;EAOhC,aAAa,iBAAc;;;;EAO3B,YAAY,iBAAc;;;;EAO1B,aAAa,iBAAc;;;;EAO3B,WAAW,iBAAc;;;;EAOzB,WAAW,iBAAc;;;;EAOzB,UAAM;;;;EAON,cAAU;;;;EAOV,iBAAa;;;;EAOb,gBAAY;;;;EAOZ,YAAY,UAAU,QAAQ,mBAAgB;;;;EAO9C,gBAAY;;;;EAOZ,mBAAe;;;;EAOf,kBAAc;;;;EAOd,cAAc,UAAU,QAAQ,qBAAkB;;;;EAOlD,UAAU,iBAAc;;;;EAOxB,WAAW,iBAAc;;;;EAOzB,kBAAkB,iBAAc;;;;EAOhC,aAAa,iBAAc;;;;EAO3B,YAAY,iBAAc;;;;EAO1B,aAAa,iBAAc;;;;EAO3B,WAAW,iBAAc;;;;EAOzB,WAAW,iBAAc"}

package/dist/classes/enhanced-date.js

@@ -37,6 +37,18 @@ var EnhancedDate = class EnhancedDate extends Date {
 		return new EnhancedDate(dateFns.endOfToday());
 	}
 	/**
+	* Returns a new instance at the end of tomorrow in the system time zone.
+	*/
+	static endOfTomorrow() {
+		return new EnhancedDate(dateFns.endOfTomorrow());
+	}
+	/**
+	* Returns a new instance at the end of yesterday in the system time zone.
+	*/
+	static endOfYesterday() {
+		return new EnhancedDate(dateFns.endOfYesterday());
+	}
+	/**
 	* Parses a date using date-fns and an explicit reference for missing fields.
 	*
 	* @param value - Date string to parse.
@@ -69,12 +81,44 @@ var EnhancedDate = class EnhancedDate extends Date {
 		return new EnhancedDate(seconds * 1e3);
 	}
 	/**
+	* Returns the latest date as a new independent instance.
+	*
+	* @param dates - Dates or millisecond timestamps to compare.
+	*
+	* @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
+	*/
+	static max(dates) {
+		return new EnhancedDate(dateFns.max(dates));
+	}
+	/**
+	* Returns the earliest date as a new independent instance.
+	*
+	* @param dates - Dates or millisecond timestamps to compare.
+	*
+	* @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
+	*/
+	static min(dates) {
+		return new EnhancedDate(dateFns.min(dates));
+	}
+	/**
 	* Returns a new instance at the start of today in the system time zone.
 	*/
 	static startOfToday() {
 		return new EnhancedDate(dateFns.startOfToday());
 	}
 	/**
+	* Returns a new instance at the start of tomorrow in the system time zone.
+	*/
+	static startOfTomorrow() {
+		return new EnhancedDate(dateFns.startOfTomorrow());
+	}
+	/**
+	* Returns a new instance at the start of yesterday in the system time zone.
+	*/
+	static startOfYesterday() {
+		return new EnhancedDate(dateFns.startOfYesterday());
+	}
+	/**
 	* Adds the specified number of days in place using date-fns.
 	*
 	* @param amount - Number of days.

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

@@ -1 +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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"}
+{"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     * Returns a new instance at the end of tomorrow in the system time zone.\n     */\n    static endOfTomorrow() {\n        return new EnhancedDate(dateFns.endOfTomorrow());\n    }\n\n    /**\n     * Returns a new instance at the end of yesterday in the system time zone.\n     */\n    static endOfYesterday() {\n        return new EnhancedDate(dateFns.endOfYesterday());\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 the latest date as a new independent instance.\n     *\n     * @param dates - Dates or millisecond timestamps to compare.\n     *\n     * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.\n     */\n    static max(dates: (Date | number)[]) {\n        return new EnhancedDate(dateFns.max(dates));\n    }\n\n    /**\n     * Returns the earliest date as a new independent instance.\n     *\n     * @param dates - Dates or millisecond timestamps to compare.\n     *\n     * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.\n     */\n    static min(dates: (Date | number)[]) {\n        return new EnhancedDate(dateFns.min(dates));\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    /**\n     * Returns a new instance at the start of tomorrow in the system time zone.\n     */\n    static startOfTomorrow() {\n        return new EnhancedDate(dateFns.startOfTomorrow());\n    }\n\n    /**\n     * Returns a new instance at the start of yesterday in the system time zone.\n     */\n    static startOfYesterday() {\n        return new EnhancedDate(dateFns.startOfYesterday());\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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"}

package/dist/classes/path.d.ts

@@ -360,4 +360,5 @@ export declare class Path {
   writeFile(...args: DropFirstParameters<typeof fsp.writeFile>): Promise<void>;
 }
 //#endregion
+export {};
 //# sourceMappingURL=path.d.ts.map

package/dist/classes/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"mappings":";;;;;;KAMK,oBAAoB,cAAc,qBAAqB,WAAW,0BAA0B,KAAK;;;;YAK1F,WAAW,GAAG,WAAW;;;;;;;;;;qBAWxB;;;;;;;EAWG,eAAG,OAAO;;;;;;MAoBlB,UAAM;;;;MAON;;;;;;;;;;SAeG,OAAO,YAAY,SAAS,wBAAqB;;;;;;;;;;;;;;SAiBjD,WAAW,OAAO,aAAU;GASlC,OAAO,aAAa;;;;;;;;EAYrB,SAAS;;;;;;;;EAWT,WAAO;;;;;;;;EAWP;;;;;;;;EAWA;;;;;;;;EAWA,aAAS;;;;;;;;;;EAaT,QAAQ,OAAO,aAAU;;;;;;;;EAWzB,SAAK,SAAA;;;;;;;;;;EAaL,SAAS,IAAI,WAAQ;;;;;;;;;;;EAcrB,WAAO;EAIP;;;;;;;;;EAYA;;;;EAOA;;;;;;;;;EAYA,UAAU,MAAM,2BAA2B,IAAI,UAAO;;;;;;;;;EAYtD,cAAc,MAAM,2BAA2B,IAAI,cAAW;;;;;;;;;EAY9D,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;;EAa1D,MAAM,SAAS,GAAG;IAAyB;MAAoB;EAC/D,MACI,WACK,GAAG;IAAyB;OAC7B,GAAG,cAER;EACH,MAAM,UAAU,GAAG,uBAAuB,GAAG,cAAc;;;;;;;;;EAa3D,QAAQ,MAAM,2BAA2B,IAAI,QAAK,QAAA,GAAA,SAAA;;;;;;;;;EAYlD,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP;EACH,QACI;IAGM;IACA;IACA;MAEP,QAAQ;EACX,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP,QAAQ;EACX,QACI,SAAS,GAAG;IACR;IACA;MAEL,QAAQ,GAAG;EACd,QACI;IACI;IACA;IACA;MAEL,QAAQ,GAAG,OAAO;;;;;;;;;EAarB,SACI,WACK;IACC;IACA,OAAO,GAAG;cAGjB,QAAQ;EACX,SACI,UACK;IACC,UAAU;IACV,OAAO,GAAG;OAEZ,iBACL;EACH,SACI,WAEQ,YACA,GAAG;IACD,OAAO,GAAG;OAEd,wBAEP,QAAQ;;;;;;;;;;;EAeX,OAAO,SAAS,WAAQ;;;;;;;;;EAYxB,MAAM,MAAM,2BAA2B,IAAI,MAAG;;;;;;;;;EAY9C,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;;EAapD,KACI,OAAO,GAAG;IACN;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KAAK,MAAM,GAAG;IAAgB;MAA0B,QAAQ,GAAG,cAAc,GAAG;EACpF,KAAK,OAAO,GAAG,cAAc,QAAQ,GAAG,cAAc,GAAG;;;;;;;;;EAazD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;EAY1D,UAAM;;;;;;;;;EAYN,aAAa,MAAM,2BAA2B,IAAI,aAAU"}
+{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"mappings":";;;;;;KAMK,oBAAoB,cAAc,qBAAqB,WAAW,0BAA0B,KAAK;;;;YAK1F,WAAW,GAAG,WAAW;;;;;;;;;;qBAWxB;;;;;;;EAWG,eAAG,OAAO;;;;;;MAoBlB,UAAM;;;;MAON;;;;;;;;;;SAeG,OAAO,YAAY,SAAS,wBAAqB;;;;;;;;;;;;;;SAiBjD,WAAW,OAAO,aAAU;GASlC,OAAO,aAAa;;;;;;;;EAYrB,SAAS;;;;;;;;EAWT,WAAO;;;;;;;;EAWP;;;;;;;;EAWA;;;;;;;;EAWA,aAAS;;;;;;;;;;EAaT,QAAQ,OAAO,aAAU;;;;;;;;EAWzB,SAAK,SAAA;;;;;;;;;;EAaL,SAAS,IAAI,WAAQ;;;;;;;;;;;EAcrB,WAAO;EAIP;;;;;;;;;EAYA;;;;EAOA;;;;;;;;;EAYA,UAAU,MAAM,2BAA2B,IAAI,UAAO;;;;;;;;;EAYtD,cAAc,MAAM,2BAA2B,IAAI,cAAW;;;;;;;;;EAY9D,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;;EAa1D,MAAM,SAAS,GAAG;IAAyB;MAAoB;EAC/D,MACI,WACK,GAAG;IAAyB;OAC7B,GAAG,cAER;EACH,MAAM,UAAU,GAAG,uBAAuB,GAAG,cAAc;;;;;;;;;EAa3D,QAAQ,MAAM,2BAA2B,IAAI,QAAK,QAAA,GAAA,SAAA;;;;;;;;;EAYlD,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP;EACH,QACI;IAGM;IACA;IACA;MAEP,QAAQ;EACX,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP,QAAQ;EACX,QACI,SAAS,GAAG;IACR;IACA;MAEL,QAAQ,GAAG;EACd,QACI;IACI;IACA;IACA;MAEL,QAAQ,GAAG,OAAO;;;;;;;;;EAarB,SACI,WACK;IACC;IACA,OAAO,GAAG;cAGjB,QAAQ;EACX,SACI,UACK;IACC,UAAU;IACV,OAAO,GAAG;OAEZ,iBACL;EACH,SACI,WAEQ,YACA,GAAG;IACD,OAAO,GAAG;OAEd,wBAEP,QAAQ;;;;;;;;;;;EAeX,OAAO,SAAS,WAAQ;;;;;;;;;EAYxB,MAAM,MAAM,2BAA2B,IAAI,MAAG;;;;;;;;;EAY9C,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;;EAapD,KACI,OAAO,GAAG;IACN;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KAAK,MAAM,GAAG;IAAgB;MAA0B,QAAQ,GAAG,cAAc,GAAG;EACpF,KAAK,OAAO,GAAG,cAAc,QAAQ,GAAG,cAAc,GAAG;;;;;;;;;EAwBzD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;EAY1D,UAAM;;;;;;;;;EAYN,aAAa,MAAM,2BAA2B,IAAI,aAAU"}

package/dist/classes/path.js

@@ -302,8 +302,13 @@ var Path = class Path {
 	rmdir(...args) {
 		return fsp.rmdir(this.#value, ...args);
 	}
-	stat(...args) {
-		return fsp.stat(this.#value, ...args);
+	async stat(opts) {
+		try {
+			return await fsp.stat(this.#value, opts);
+		} catch (error) {
+			if (opts?.throwIfNoEntry === false && error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
+			throw error;
+		}
 	}
 	/**
 	* Truncates or extends the file at the stored path.

package/dist/classes/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","names":[],"sources":["../../src/classes/path.ts"],"sourcesContent":["import type { Buffer } from 'node:buffer';\nimport type { Abortable } from 'node:events';\nimport type * as fs from 'node:fs';\nimport * as fsp from 'node:fs/promises';\nimport * as nodePath from 'node:path';\n\ntype DropFirstParameters<T extends (...args: any) => any> = Parameters<T> extends [any, ...infer R] ? R : never;\n\n/**\n * Values accepted by the `Path` constructor and path-composition methods.\n */\nexport type PathLike = fs.PathLike | Path;\n\n/**\n * An immutable file system path with Node.js path and file operations.\n *\n * @remarks\n * Path-composition methods return new instances and leave this instance unchanged.\n * File operations act on the stored path and forward Node.js defaults and promise rejections.\n * They do not update the stored path, including after a successful rename.\n * The constructor joins stringified inputs using the platform-specific Node.js path rules.\n */\nexport class Path {\n    // Private instance properties\n    readonly #value: string;\n\n    // Constructor\n\n    /**\n     * Creates a normalized path value by joining the provided path segments.\n     *\n     * @param paths - Path segments accepted by Node.js `path.join` or another `Path` instance.\n     */\n    constructor(...paths: PathLike[]) {\n        this.#value = nodePath.join(...this.#toStrings(paths));\n    }\n\n    // Private instance methods\n    #newInstance(...paths: PathLike[]) {\n        return new Path(...paths);\n    }\n\n    #toStrings(paths: PathLike[]) {\n        return paths.map((path) => path.toString());\n    }\n\n    // Public instance accessors\n\n    /**\n     * The parent directory as a new `Path`; this instance is unchanged.\n     *\n     * @see {@link Path.dirname}\n     */\n    get parent() {\n        return this.dirname();\n    }\n\n    /**\n     * The normalized path string stored by this instance.\n     */\n    get value() {\n        return this.#value;\n    }\n\n    // Public static methods\n\n    /**\n     * Creates a new path from a Node.js path object.\n     *\n     * @param pathObject - The path components to format.\n     *\n     * @returns A new normalized `Path`.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.format}\n     */\n    static format(pathObject: nodePath.FormatInputPathObject) {\n        return new Path(nodePath.format(pathObject));\n    }\n\n    /**\n     * Resolves joined path segments to an absolute path.\n     *\n     * @remarks\n     * Inputs are joined before resolution; unlike Node.js `path.resolve`,\n     * later absolute segments do not reset the path.\n     *\n     * @param paths - The stringified path segments to join.\n     *\n     * @returns A new absolute `Path`.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.resolve}\n     */\n    static resolve(...paths: PathLike[]) {\n        return new this(...paths).resolve();\n    }\n\n    // Public instance methods\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.#value;\n    }\n\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') throw new TypeError('Cannot convert a Path to a number');\n        return this.#value;\n    }\n\n    /**\n     * Returns the final component of this path.\n     *\n     * @param suffix - An optional exact suffix to remove.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.basename}\n     */\n    basename(suffix?: string) {\n        return nodePath.basename(this.#value, suffix);\n    }\n\n    /**\n     * Returns the parent directory of this path.\n     *\n     * @returns A new `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.dirname}\n     */\n    dirname() {\n        return this.#newInstance(nodePath.dirname(this.#value));\n    }\n\n    /**\n     * Returns the extension of the final path component.\n     *\n     * @returns The extension including its leading dot, or an empty string when absent.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.extname}\n     */\n    extname() {\n        return nodePath.extname(this.#value);\n    }\n\n    /**\n     * Checks whether this path is absolute on the current platform.\n     *\n     * @returns Whether this path is absolute.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.isAbsolute}\n     */\n    isAbsolute() {\n        return nodePath.isAbsolute(this.#value);\n    }\n\n    /**\n     * Normalizes separators and relative segments in this path.\n     *\n     * @returns A new `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.normalize}\n     */\n    normalize() {\n        return this.#newInstance(nodePath.normalize(this.#value));\n    }\n\n    /**\n     * Joins additional segments onto this path.\n     *\n     * @param paths - The stringified path segments to append.\n     *\n     * @returns A new normalized `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.join}\n     */\n    join(...paths: PathLike[]) {\n        return this.#newInstance(this.#value, ...this.#toStrings(paths));\n    }\n\n    /**\n     * Parses this path into its root, directory, basename, extension, and name.\n     *\n     * @returns A new object containing the path components.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.parse}\n     */\n    parse() {\n        return nodePath.parse(this.#value);\n    }\n\n    /**\n     * Computes a relative path from this path to the destination.\n     *\n     * @param to - The destination path.\n     *\n     * @returns A new `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.relative}\n     */\n    relative(to: PathLike) {\n        return this.#newInstance(nodePath.relative(this.#value, to.toString()));\n    }\n\n    /**\n     * Resolves this path to an absolute path using the current working directory.\n     *\n     * @remarks\n     * Relative paths use the current working directory. This instance is unchanged.\n     *\n     * @returns A new absolute `Path`.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.resolve}\n     */\n    resolve() {\n        return this.#newInstance(nodePath.resolve(this.#value));\n    }\n\n    toJSON() {\n        return this.#value;\n    }\n\n    /**\n     * Converts this path to the Windows namespace form when applicable.\n     *\n     * @returns The namespace-converted path string; this instance is unchanged.\n     * On non-Windows platforms, the path text is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.toNamespacedPath}\n     */\n    toNamespacedPath() {\n        return nodePath.toNamespacedPath(this.#value);\n    }\n\n    /**\n     * Returns the stored path as a string.\n     */\n    toString() {\n        return this.#value;\n    }\n\n    /**\n     * Checks access permissions for the stored path.\n     *\n     * @remarks\n     * The promise resolves when the access check succeeds and rejects if access is denied or the path is missing.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.access}\n     */\n    access(...args: DropFirstParameters<typeof fsp.access>) {\n        return fsp.access(this.#value, ...args);\n    }\n\n    /**\n     * Appends data to the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves when appending completes; a missing file is created according to the supplied options.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.appendFile}\n     */\n    appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n        return fsp.appendFile(this.#value, ...args);\n    }\n\n    /**\n     * Changes the permissions of the stored path.\n     *\n     * @remarks\n     * The promise resolves when the permissions are changed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chmod}\n     */\n    chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n        return fsp.chmod(this.#value, ...args);\n    }\n\n    /**\n     * Changes the owner and group of the stored path.\n     *\n     * @remarks\n     * The promise resolves when the ownership is changed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chown}\n     */\n    chown(...args: DropFirstParameters<typeof fsp.chown>) {\n        return fsp.chown(this.#value, ...args);\n    }\n\n    /**\n     * Copies the file at the stored path to a destination.\n     *\n     * @remarks\n     * The promise resolves when copying completes. The stored path remains the source path.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.copyFile}\n     */\n    copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n        return fsp.copyFile(this.#value, ...args);\n    }\n\n    /**\n     * Creates a directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves after creation. Recursive mode resolves to the first created directory path, or\n     * `undefined` if no directory is created; nonrecursive mode resolves without a value.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.mkdir}\n     */\n    mkdir(options: fs.MakeDirectoryOptions & { recursive: true }): Promise<string | undefined>;\n    mkdir(\n        options?:\n          | (fs.MakeDirectoryOptions & { recursive?: false })\n          | fs.Mode\n          | null,\n    ): Promise<void>;\n    mkdir(options?: fs.MakeDirectoryOptions | fs.Mode | null): Promise<string | undefined>;\n    mkdir(...args: any): any {\n        return fsp.mkdir(this.#value, ...args);\n    }\n\n    /**\n     * Opens the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves to a new file handle. The caller must close the handle when it is no longer needed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.open}\n     */\n    open(...args: DropFirstParameters<typeof fsp.open>) {\n        return fsp.open(this.#value, ...args);\n    }\n\n    /**\n     * Reads the entries of the directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves to names, buffers, or directory entries according to the options.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.readdir}\n     */\n    readdir(\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<string[]>;\n    readdir(\n        options:\n          | 'buffer'\n          | {\n              encoding: 'buffer';\n              recursive?: boolean;\n              withFileTypes?: false;\n          },\n    ): Promise<Buffer[]>;\n    readdir(\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<Buffer[] | string[]>;\n    readdir(\n        options: fs.ObjectEncodingOptions & {\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent[]>;\n    readdir(\n        options: {\n            encoding: 'buffer';\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent<Buffer>[]>;\n    readdir(...args: any): any {\n        return fsp.readdir(this.#value, ...args);\n    }\n\n    /**\n     * Reads the entire file at the stored path.\n     *\n     * @remarks\n     * The promise resolves to a string when a text encoding is supplied, or a `Buffer` otherwise.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.readFile}\n     */\n    readFile(\n        options?:\n          | (Abortable & {\n              encoding?: null;\n              flag?: fs.OpenMode;\n          })\n          | null,\n    ): Promise<Buffer>;\n    readFile(\n        options:\n          | (Abortable & {\n              encoding: BufferEncoding;\n              flag?: fs.OpenMode;\n          })\n          | BufferEncoding,\n    ): Promise<string>;\n    readFile(\n        options?:\n            | (\n              & Abortable\n              & fs.ObjectEncodingOptions\n              & { flag?: fs.OpenMode }\n            )\n            | BufferEncoding\n            | null,\n    ): Promise<Buffer | string>;\n    readFile(...args: any): any {\n        return fsp.readFile(this.#value, ...args);\n    }\n\n    /**\n     * Renames or moves the file or directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves when the rename completes. This instance retains its original stored path.\n     *\n     * @param newPath - The destination path; this instance retains its original value.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rename}\n     */\n    rename(newPath: PathLike) {\n        return fsp.rename(this.#value, newPath.toString());\n    }\n\n    /**\n     * Removes the file or directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves after removal according to the supplied options.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rm}\n     */\n    rm(...args: DropFirstParameters<typeof fsp.rm>) {\n        return fsp.rm(this.#value, ...args);\n    }\n\n    /**\n     * Removes the directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves after directory removal.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rmdir}\n     */\n    rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n        return fsp.rmdir(this.#value, ...args);\n    }\n\n    /**\n     * Reads file system metadata for the stored path.\n     *\n     * @remarks\n     * The promise resolves to `Stats`, or `BigIntStats` when `bigint` is enabled.\n     * If `throwIfNoEntry` is `false`, a missing path resolves to `undefined` instead of rejecting.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.stat}\n     */\n    stat(\n        opts?: fs.StatOptions & {\n            bigint?: false;\n            throwIfNoEntry?: true;\n        },\n    ): Promise<fs.Stats>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint: true;\n            throwIfNoEntry?: true;\n        },\n    ): Promise<fs.BigIntStats>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint?: false;\n            throwIfNoEntry: false;\n        },\n    ): Promise<fs.Stats | undefined>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint: true;\n            throwIfNoEntry: false;\n        },\n    ): Promise<fs.BigIntStats | undefined>;\n    stat(opts: fs.StatOptions & { throwIfNoEntry?: true }): Promise<fs.BigIntStats | fs.Stats>;\n    stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats | undefined>;\n    stat(...args: any): any {\n        return fsp.stat(this.#value, ...args);\n    }\n\n    /**\n     * Truncates or extends the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves when the file reaches the requested length in bytes; the default length is `0`.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.truncate}\n     */\n    truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n        return fsp.truncate(this.#value, ...args);\n    }\n\n    /**\n     * Deletes the file or symbolic link at the stored path.\n     *\n     * @remarks\n     * The promise resolves after deletion; directories are not removed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.unlink}\n     */\n    unlink() {\n        return fsp.unlink(this.#value);\n    }\n\n    /**\n     * Writes data to the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves when writing completes; the default flag replaces existing file contents.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.writeFile}\n     */\n    writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n        return fsp.writeFile(this.#value, ...args);\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"path.js","names":[],"sources":["../../src/classes/path.ts"],"sourcesContent":["import type { Buffer } from 'node:buffer';\nimport type { Abortable } from 'node:events';\nimport type * as fs from 'node:fs';\nimport * as fsp from 'node:fs/promises';\nimport * as nodePath from 'node:path';\n\ntype DropFirstParameters<T extends (...args: any) => any> = Parameters<T> extends [any, ...infer R] ? R : never;\n\n/**\n * Values accepted by the `Path` constructor and path-composition methods.\n */\nexport type PathLike = fs.PathLike | Path;\n\n/**\n * An immutable file system path with Node.js path and file operations.\n *\n * @remarks\n * Path-composition methods return new instances and leave this instance unchanged.\n * File operations act on the stored path and forward Node.js defaults and promise rejections.\n * They do not update the stored path, including after a successful rename.\n * The constructor joins stringified inputs using the platform-specific Node.js path rules.\n */\nexport class Path {\n    // Private instance properties\n    readonly #value: string;\n\n    // Constructor\n\n    /**\n     * Creates a normalized path value by joining the provided path segments.\n     *\n     * @param paths - Path segments accepted by Node.js `path.join` or another `Path` instance.\n     */\n    constructor(...paths: PathLike[]) {\n        this.#value = nodePath.join(...this.#toStrings(paths));\n    }\n\n    // Private instance methods\n    #newInstance(...paths: PathLike[]) {\n        return new Path(...paths);\n    }\n\n    #toStrings(paths: PathLike[]) {\n        return paths.map((path) => path.toString());\n    }\n\n    // Public instance accessors\n\n    /**\n     * The parent directory as a new `Path`; this instance is unchanged.\n     *\n     * @see {@link Path.dirname}\n     */\n    get parent() {\n        return this.dirname();\n    }\n\n    /**\n     * The normalized path string stored by this instance.\n     */\n    get value() {\n        return this.#value;\n    }\n\n    // Public static methods\n\n    /**\n     * Creates a new path from a Node.js path object.\n     *\n     * @param pathObject - The path components to format.\n     *\n     * @returns A new normalized `Path`.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.format}\n     */\n    static format(pathObject: nodePath.FormatInputPathObject) {\n        return new Path(nodePath.format(pathObject));\n    }\n\n    /**\n     * Resolves joined path segments to an absolute path.\n     *\n     * @remarks\n     * Inputs are joined before resolution; unlike Node.js `path.resolve`,\n     * later absolute segments do not reset the path.\n     *\n     * @param paths - The stringified path segments to join.\n     *\n     * @returns A new absolute `Path`.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.resolve}\n     */\n    static resolve(...paths: PathLike[]) {\n        return new this(...paths).resolve();\n    }\n\n    // Public instance methods\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.#value;\n    }\n\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') throw new TypeError('Cannot convert a Path to a number');\n        return this.#value;\n    }\n\n    /**\n     * Returns the final component of this path.\n     *\n     * @param suffix - An optional exact suffix to remove.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.basename}\n     */\n    basename(suffix?: string) {\n        return nodePath.basename(this.#value, suffix);\n    }\n\n    /**\n     * Returns the parent directory of this path.\n     *\n     * @returns A new `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.dirname}\n     */\n    dirname() {\n        return this.#newInstance(nodePath.dirname(this.#value));\n    }\n\n    /**\n     * Returns the extension of the final path component.\n     *\n     * @returns The extension including its leading dot, or an empty string when absent.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.extname}\n     */\n    extname() {\n        return nodePath.extname(this.#value);\n    }\n\n    /**\n     * Checks whether this path is absolute on the current platform.\n     *\n     * @returns Whether this path is absolute.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.isAbsolute}\n     */\n    isAbsolute() {\n        return nodePath.isAbsolute(this.#value);\n    }\n\n    /**\n     * Normalizes separators and relative segments in this path.\n     *\n     * @returns A new `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.normalize}\n     */\n    normalize() {\n        return this.#newInstance(nodePath.normalize(this.#value));\n    }\n\n    /**\n     * Joins additional segments onto this path.\n     *\n     * @param paths - The stringified path segments to append.\n     *\n     * @returns A new normalized `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.join}\n     */\n    join(...paths: PathLike[]) {\n        return this.#newInstance(this.#value, ...this.#toStrings(paths));\n    }\n\n    /**\n     * Parses this path into its root, directory, basename, extension, and name.\n     *\n     * @returns A new object containing the path components.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.parse}\n     */\n    parse() {\n        return nodePath.parse(this.#value);\n    }\n\n    /**\n     * Computes a relative path from this path to the destination.\n     *\n     * @param to - The destination path.\n     *\n     * @returns A new `Path`; this instance is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.relative}\n     */\n    relative(to: PathLike) {\n        return this.#newInstance(nodePath.relative(this.#value, to.toString()));\n    }\n\n    /**\n     * Resolves this path to an absolute path using the current working directory.\n     *\n     * @remarks\n     * Relative paths use the current working directory. This instance is unchanged.\n     *\n     * @returns A new absolute `Path`.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.resolve}\n     */\n    resolve() {\n        return this.#newInstance(nodePath.resolve(this.#value));\n    }\n\n    toJSON() {\n        return this.#value;\n    }\n\n    /**\n     * Converts this path to the Windows namespace form when applicable.\n     *\n     * @returns The namespace-converted path string; this instance is unchanged.\n     * On non-Windows platforms, the path text is unchanged.\n     *\n     * @see {@link https://nodejs.org/api/path.html | Node.js path.toNamespacedPath}\n     */\n    toNamespacedPath() {\n        return nodePath.toNamespacedPath(this.#value);\n    }\n\n    /**\n     * Returns the stored path as a string.\n     */\n    toString() {\n        return this.#value;\n    }\n\n    /**\n     * Checks access permissions for the stored path.\n     *\n     * @remarks\n     * The promise resolves when the access check succeeds and rejects if access is denied or the path is missing.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.access}\n     */\n    access(...args: DropFirstParameters<typeof fsp.access>) {\n        return fsp.access(this.#value, ...args);\n    }\n\n    /**\n     * Appends data to the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves when appending completes; a missing file is created according to the supplied options.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.appendFile}\n     */\n    appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n        return fsp.appendFile(this.#value, ...args);\n    }\n\n    /**\n     * Changes the permissions of the stored path.\n     *\n     * @remarks\n     * The promise resolves when the permissions are changed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chmod}\n     */\n    chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n        return fsp.chmod(this.#value, ...args);\n    }\n\n    /**\n     * Changes the owner and group of the stored path.\n     *\n     * @remarks\n     * The promise resolves when the ownership is changed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chown}\n     */\n    chown(...args: DropFirstParameters<typeof fsp.chown>) {\n        return fsp.chown(this.#value, ...args);\n    }\n\n    /**\n     * Copies the file at the stored path to a destination.\n     *\n     * @remarks\n     * The promise resolves when copying completes. The stored path remains the source path.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.copyFile}\n     */\n    copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n        return fsp.copyFile(this.#value, ...args);\n    }\n\n    /**\n     * Creates a directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves after creation. Recursive mode resolves to the first created directory path, or\n     * `undefined` if no directory is created; nonrecursive mode resolves without a value.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.mkdir}\n     */\n    mkdir(options: fs.MakeDirectoryOptions & { recursive: true }): Promise<string | undefined>;\n    mkdir(\n        options?:\n          | (fs.MakeDirectoryOptions & { recursive?: false })\n          | fs.Mode\n          | null,\n    ): Promise<void>;\n    mkdir(options?: fs.MakeDirectoryOptions | fs.Mode | null): Promise<string | undefined>;\n    mkdir(...args: any): any {\n        return fsp.mkdir(this.#value, ...args);\n    }\n\n    /**\n     * Opens the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves to a new file handle. The caller must close the handle when it is no longer needed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.open}\n     */\n    open(...args: DropFirstParameters<typeof fsp.open>) {\n        return fsp.open(this.#value, ...args);\n    }\n\n    /**\n     * Reads the entries of the directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves to names, buffers, or directory entries according to the options.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.readdir}\n     */\n    readdir(\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<string[]>;\n    readdir(\n        options:\n          | 'buffer'\n          | {\n              encoding: 'buffer';\n              recursive?: boolean;\n              withFileTypes?: false;\n          },\n    ): Promise<Buffer[]>;\n    readdir(\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<Buffer[] | string[]>;\n    readdir(\n        options: fs.ObjectEncodingOptions & {\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent[]>;\n    readdir(\n        options: {\n            encoding: 'buffer';\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent<Buffer>[]>;\n    readdir(...args: any): any {\n        return fsp.readdir(this.#value, ...args);\n    }\n\n    /**\n     * Reads the entire file at the stored path.\n     *\n     * @remarks\n     * The promise resolves to a string when a text encoding is supplied, or a `Buffer` otherwise.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.readFile}\n     */\n    readFile(\n        options?:\n          | (Abortable & {\n              encoding?: null;\n              flag?: fs.OpenMode;\n          })\n          | null,\n    ): Promise<Buffer>;\n    readFile(\n        options:\n          | (Abortable & {\n              encoding: BufferEncoding;\n              flag?: fs.OpenMode;\n          })\n          | BufferEncoding,\n    ): Promise<string>;\n    readFile(\n        options?:\n            | (\n              & Abortable\n              & fs.ObjectEncodingOptions\n              & { flag?: fs.OpenMode }\n            )\n            | BufferEncoding\n            | null,\n    ): Promise<Buffer | string>;\n    readFile(...args: any): any {\n        return fsp.readFile(this.#value, ...args);\n    }\n\n    /**\n     * Renames or moves the file or directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves when the rename completes. This instance retains its original stored path.\n     *\n     * @param newPath - The destination path; this instance retains its original value.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rename}\n     */\n    rename(newPath: PathLike) {\n        return fsp.rename(this.#value, newPath.toString());\n    }\n\n    /**\n     * Removes the file or directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves after removal according to the supplied options.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rm}\n     */\n    rm(...args: DropFirstParameters<typeof fsp.rm>) {\n        return fsp.rm(this.#value, ...args);\n    }\n\n    /**\n     * Removes the directory at the stored path.\n     *\n     * @remarks\n     * The promise resolves after directory removal.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rmdir}\n     */\n    rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n        return fsp.rmdir(this.#value, ...args);\n    }\n\n    /**\n     * Reads file system metadata for the stored path.\n     *\n     * @remarks\n     * The promise resolves to `Stats`, or `BigIntStats` when `bigint` is enabled.\n     * If `throwIfNoEntry` is `false`, a missing path resolves to `undefined` instead of rejecting.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.stat}\n     */\n    stat(\n        opts?: fs.StatOptions & {\n            bigint?: false;\n            throwIfNoEntry?: true;\n        },\n    ): Promise<fs.Stats>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint: true;\n            throwIfNoEntry?: true;\n        },\n    ): Promise<fs.BigIntStats>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint?: false;\n            throwIfNoEntry: false;\n        },\n    ): Promise<fs.Stats | undefined>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint: true;\n            throwIfNoEntry: false;\n        },\n    ): Promise<fs.BigIntStats | undefined>;\n    stat(opts: fs.StatOptions & { throwIfNoEntry?: true }): Promise<fs.BigIntStats | fs.Stats>;\n    stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats | undefined>;\n    async stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats | undefined> {\n        try {\n            return await fsp.stat(this.#value, opts);\n        } catch (error) {\n            if (\n                opts?.throwIfNoEntry === false\n                && error instanceof Error\n                && 'code' in error\n                && error.code === 'ENOENT'\n            ) return undefined;\n\n            throw error;\n        }\n    }\n\n    /**\n     * Truncates or extends the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves when the file reaches the requested length in bytes; the default length is `0`.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.truncate}\n     */\n    truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n        return fsp.truncate(this.#value, ...args);\n    }\n\n    /**\n     * Deletes the file or symbolic link at the stored path.\n     *\n     * @remarks\n     * The promise resolves after deletion; directories are not removed.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.unlink}\n     */\n    unlink() {\n        return fsp.unlink(this.#value);\n    }\n\n    /**\n     * Writes data to the file at the stored path.\n     *\n     * @remarks\n     * The promise resolves when writing completes; the default flag replaces existing file contents.\n     *\n     * @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.writeFile}\n     */\n    writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n        return fsp.writeFile(this.#value, ...args);\n    }\n}\n"],"mappings":"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"}

package/dist/classes/ssh-client.d.ts

@@ -36,4 +36,5 @@ export declare class SshClient {
   setLoggerLevel(level: keyof typeof loggerLevelStringToConsolaLogLevelMap): void;
 }
 //#endregion
+export {};
 //# sourceMappingURL=ssh-client.d.ts.map

package/dist/clipboard.d.ts

@@ -62,4 +62,5 @@ export declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemO
  */
 export declare function copyTextToClipboard(text: string): Promise<CopyResult>;
 //#endregion
+export {};
 //# sourceMappingURL=clipboard.d.ts.map

package/dist/file.d.ts

@@ -0,0 +1,27 @@
+import { BinaryInput } from "./types/index.js";
+//#region src/file.d.ts
+/**
+ * Detects a lowercase MIME type from binary content rather than its name or declared type.
+ *
+ * @remarks
+ * Requires the optional `file-type` peer dependency. Only formats supported by its binary detection
+ * are recognized; this is not a general text-file detector or a guarantee that a file is safe.
+ * Blob and File inputs are read through the detector's tokenizer instead of being fully buffered up front.
+ * The amount of content inspected depends on its format; this does not impose a fixed read limit.
+ * Detection and input-reading errors propagate to the caller.
+ *
+ * @param input - The binary content to inspect.
+ *
+ * @returns The detected lowercase MIME type, or `undefined` when the content is not recognized.
+ *
+ * @example
+ *
+ * ```ts
+ * import { getFileMimeType } from '@kikiutils/shared/file';
+ *
+ * const mimeType = await getFileMimeType(file);
+ * ```
+ */
+export declare function getFileMimeType(input: BinaryInput): Promise<string | undefined>;
+//#endregion
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","names":[],"sources":["../src/file.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBA6BsB,gBAAgB,OAAO,cAAW"}

package/dist/file.js

@@ -0,0 +1,31 @@
+import { fileTypeFromBlob, fileTypeFromBuffer } from "file-type";
+//#region src/file.ts
+/**
+* Detects a lowercase MIME type from binary content rather than its name or declared type.
+*
+* @remarks
+* Requires the optional `file-type` peer dependency. Only formats supported by its binary detection
+* are recognized; this is not a general text-file detector or a guarantee that a file is safe.
+* Blob and File inputs are read through the detector's tokenizer instead of being fully buffered up front.
+* The amount of content inspected depends on its format; this does not impose a fixed read limit.
+* Detection and input-reading errors propagate to the caller.
+*
+* @param input - The binary content to inspect.
+*
+* @returns The detected lowercase MIME type, or `undefined` when the content is not recognized.
+*
+* @example
+*
+* ```ts
+* import { getFileMimeType } from '@kikiutils/shared/file';
+*
+* const mimeType = await getFileMimeType(file);
+* ```
+*/
+async function getFileMimeType(input) {
+	return (input instanceof ArrayBuffer || input instanceof Uint8Array ? await fileTypeFromBuffer(input) : await fileTypeFromBlob(input))?.mime.toLowerCase();
+}
+//#endregion
+export { getFileMimeType };
+
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","names":[],"sources":["../src/file.ts"],"sourcesContent":["import {\n    fileTypeFromBlob,\n    fileTypeFromBuffer,\n} from 'file-type';\n\nimport type { BinaryInput } from './types';\n\n/**\n * Detects a lowercase MIME type from binary content rather than its name or declared type.\n *\n * @remarks\n * Requires the optional `file-type` peer dependency. Only formats supported by its binary detection\n * are recognized; this is not a general text-file detector or a guarantee that a file is safe.\n * Blob and File inputs are read through the detector's tokenizer instead of being fully buffered up front.\n * The amount of content inspected depends on its format; this does not impose a fixed read limit.\n * Detection and input-reading errors propagate to the caller.\n *\n * @param input - The binary content to inspect.\n *\n * @returns The detected lowercase MIME type, or `undefined` when the content is not recognized.\n *\n * @example\n *\n * ```ts\n * import { getFileMimeType } from '@kikiutils/shared/file';\n *\n * const mimeType = await getFileMimeType(file);\n * ```\n */\nexport async function getFileMimeType(input: BinaryInput) {\n    // The tokenizer only uses size, slice, and arrayBuffer; Node/DOM Blob stream typings differ.\n    const result = input instanceof ArrayBuffer || input instanceof Uint8Array\n        ? await fileTypeFromBuffer(input)\n        : await fileTypeFromBlob(input as Blob);\n\n    return result?.mime.toLowerCase();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA6BA,eAAsB,gBAAgB,OAAoB;CAMtD,QAJe,iBAAiB,eAAe,iBAAiB,aAC1D,MAAM,mBAAmB,KAAK,IAC9B,MAAM,iBAAiB,KAAa,EAAA,EAE3B,KAAK,YAAY;AACpC"}

package/dist/math.d.ts

@@ -46,4 +46,5 @@ export interface ToPercentageStringOptions {
  */
 export declare function toPercentageString(molecular: CalculableValue, denominator: CalculableValue, options?: ToPercentageStringOptions): string;
 //#endregion
+export {};
 //# sourceMappingURL=math.d.ts.map

package/dist/pino.d.ts

@@ -1,3 +1,4 @@
+import { pino } from "pino";
 //#region src/pino.d.ts
 /**
  * A pino logger with environment-controlled verbosity.
@@ -18,7 +19,7 @@
  *
  * @see {@link https://getpino.io/#/docs/api?id=level-string | Pino log levels}
  */
-export declare const pinoLogger: import("pino").Logger<never, boolean>;
-export declare const logger: import("pino").Logger<never, boolean>;
+export declare const pinoLogger: pino.Logger<never, boolean>;
+export declare const logger: pino.Logger<never, boolean>;
 //#endregion
 //# sourceMappingURL=pino.d.ts.map

package/dist/pino.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pino.d.ts","names":[],"sources":["../src/pino.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;qBA6Ba,2BAAU;qBACV,uBAAM"}
+{"version":3,"file":"pino.d.ts","names":[],"sources":["../src/pino.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBA6Ba,YAAU,KAAA;qBACV,QAAM,KAAA"}

package/dist/storages/lru/keyed-store.d.ts

@@ -7,6 +7,7 @@ import { LRUCache } from "lru-cache";
  * The key resolver is called synchronously once per operation, and its exceptions propagate.
  * Reads return the cached value without copying it, or `null` for missing or nullish values.
  * `getItemTtl` exposes the underlying remaining TTL in milliseconds; `setItem` returns the underlying cache.
+ * `setItemWithTtl` accepts its TTL in milliseconds before the value and key arguments and returns the cache.
  * The facade does not dispose the supplied cache, and LRU defaults remain those of the supplied instance.
  *
  * @typeParam D - The stored value type used by reads and writes.
@@ -42,6 +43,7 @@ export declare function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<a
    */
   resolveKey: (...args: P) => string;
   setItem: (value: D, ...args: P) => LRUCache<any, any, any>;
+  setItemWithTtl(ttlMilliseconds: number, value: D, ...args: P): LRUCache<any, any, any>;
 }>;
 //#endregion
 //# sourceMappingURL=keyed-store.d.ts.map

package/dist/storages/lru/keyed-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyed-store.d.ts","names":[],"sources":["../../../src/storages/lru/keyed-store.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6BgB,oBAAoB,aAAa,aAAa,2BAClD,iBAAiB,WAAW,MAAM,iBAAY;;;;;;EAMjC,WAAA,MAAA,IAAC,YAAA;EAII,gBAAA,MAAA;EACH,aAAA,MAAA;EACG,gBAAA,MAAA;;;;EAIA,gBAAA,MAAA;EACL,UAAA,OAAA,MAAC,MAAW,MAAC"}
+{"version":3,"file":"keyed-store.d.ts","names":[],"sources":["../../../src/storages/lru/keyed-store.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BgB,oBAAoB,aAAa,aAAa,2BAClD,iBAAiB,WAAW,MAAM,iBAAY;;;;;;EAMjC,WAAA,MAAA,IAAC,YAAA;EAII,gBAAA,MAAA;EACH,aAAA,MAAA;EACG,gBAAA,MAAA;;;;EAIA,gBAAA,MAAA;EACL,UAAA,OAAA,MAAC,MAAW,MAAC;EACE,eAAA,yBAAM,OAAS,MAAC,MAAW,IAAC"}

package/dist/storages/lru/keyed-store.js

@@ -6,6 +6,7 @@
 * The key resolver is called synchronously once per operation, and its exceptions propagate.
 * Reads return the cached value without copying it, or `null` for missing or nullish values.
 * `getItemTtl` exposes the underlying remaining TTL in milliseconds; `setItem` returns the underlying cache.
+* `setItemWithTtl` accepts its TTL in milliseconds before the value and key arguments and returns the cache.
 * The facade does not dispose the supplied cache, and LRU defaults remain those of the supplied instance.
 *
 * @typeParam D - The stored value type used by reads and writes.
@@ -43,7 +44,10 @@ function createLruKeyedStore(lruInstance) {
 		* Resolves the full cache key from the given arguments.
 		*/
 		resolveKey: (...args) => keyFn(...args),
-		setItem: (value, ...args) => lruInstance.set(keyFn(...args), value)
+		setItem: (value, ...args) => lruInstance.set(keyFn(...args), value),
+		setItemWithTtl(ttlMilliseconds, value, ...args) {
+			return lruInstance.set(keyFn(...args), value, { ttl: ttlMilliseconds });
+		}
 	});
 }
 //#endregion

package/dist/storages/lru/keyed-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyed-store.js","names":[],"sources":["../../../src/storages/lru/keyed-store.ts"],"sourcesContent":["import type { LRUCache } from 'lru-cache';\n\n/**\n * Creates a keyed cache factory sharing a caller-owned LRU cache.\n *\n * @remarks\n * The key resolver is called synchronously once per operation, and its exceptions propagate.\n * Reads return the cached value without copying it, or `null` for missing or nullish values.\n * `getItemTtl` exposes the underlying remaining TTL in milliseconds; `setItem` returns the underlying cache.\n * The facade does not dispose the supplied cache, and LRU defaults remain those of the supplied instance.\n *\n * @typeParam D - The stored value type used by reads and writes.\n *\n * @param lruInstance - The shared LRU cache instance.\n *\n * @returns A factory accepting a key resolver and returning a new frozen keyed facade sharing the cache.\n *\n * @example\n *\n * ```ts\n * import { createLruKeyedStore } from '@kikiutils/shared/storages/lru/keyed-store';\n * import { LRUCache } from 'lru-cache';\n *\n * const cache = new LRUCache<string, { name: string }>({ max: 100 });\n * const keyedStore = createLruKeyedStore<{ name: string }>(cache)((userId: string) => `user:${userId}`);\n * keyedStore.setItem({ name: 'Alice' }, 'user-123');\n * console.log(keyedStore.getItem('user-123')); // => { name: 'Alice' }\n * ```\n */\nexport function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<any, any, any>) {\n    return <P extends any[]>(keyFn: (...args: P) => string) => Object.freeze({\n        /**\n         * Returns the cached value and applies the underlying cache's read-recency policy.\n         *\n         * @returns The cached value without copying it, or `null` when absent or nullish.\n         */\n        getItem(...args: P) {\n            const rawValue = lruInstance.get(keyFn(...args));\n            return rawValue as D ?? null;\n        },\n        getItemTtl: (...args: P) => lruInstance.getRemainingTTL(keyFn(...args)),\n        hasItem: (...args: P) => lruInstance.has(keyFn(...args)),\n        removeItem: (...args: P) => lruInstance.delete(keyFn(...args)),\n        /**\n         * Resolves the full cache key from the given arguments.\n         */\n        resolveKey: (...args: P) => keyFn(...args),\n        setItem: (value: D, ...args: P) => lruInstance.set(keyFn(...args), value),\n    });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,oBAAiC,aAAsC;CACnF,QAAyB,UAAkC,OAAO,OAAO;;;;;;EAMrE,QAAQ,GAAG,MAAS;GAEhB,OADiB,YAAY,IAAI,MAAM,GAAG,IAAI,CAChC,KAAU;EAC5B;EACA,aAAa,GAAG,SAAY,YAAY,gBAAgB,MAAM,GAAG,IAAI,CAAC;EACtE,UAAU,GAAG,SAAY,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;EACvD,aAAa,GAAG,SAAY,YAAY,OAAO,MAAM,GAAG,IAAI,CAAC;;;;EAI7D,aAAa,GAAG,SAAY,MAAM,GAAG,IAAI;EACzC,UAAU,OAAU,GAAG,SAAY,YAAY,IAAI,MAAM,GAAG,IAAI,GAAG,KAAK;CAC5E,CAAC;AACL"}
+{"version":3,"file":"keyed-store.js","names":[],"sources":["../../../src/storages/lru/keyed-store.ts"],"sourcesContent":["import type { LRUCache } from 'lru-cache';\n\n/**\n * Creates a keyed cache factory sharing a caller-owned LRU cache.\n *\n * @remarks\n * The key resolver is called synchronously once per operation, and its exceptions propagate.\n * Reads return the cached value without copying it, or `null` for missing or nullish values.\n * `getItemTtl` exposes the underlying remaining TTL in milliseconds; `setItem` returns the underlying cache.\n * `setItemWithTtl` accepts its TTL in milliseconds before the value and key arguments and returns the cache.\n * The facade does not dispose the supplied cache, and LRU defaults remain those of the supplied instance.\n *\n * @typeParam D - The stored value type used by reads and writes.\n *\n * @param lruInstance - The shared LRU cache instance.\n *\n * @returns A factory accepting a key resolver and returning a new frozen keyed facade sharing the cache.\n *\n * @example\n *\n * ```ts\n * import { createLruKeyedStore } from '@kikiutils/shared/storages/lru/keyed-store';\n * import { LRUCache } from 'lru-cache';\n *\n * const cache = new LRUCache<string, { name: string }>({ max: 100 });\n * const keyedStore = createLruKeyedStore<{ name: string }>(cache)((userId: string) => `user:${userId}`);\n * keyedStore.setItem({ name: 'Alice' }, 'user-123');\n * console.log(keyedStore.getItem('user-123')); // => { name: 'Alice' }\n * ```\n */\nexport function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<any, any, any>) {\n    return <P extends any[]>(keyFn: (...args: P) => string) => Object.freeze({\n        /**\n         * Returns the cached value and applies the underlying cache's read-recency policy.\n         *\n         * @returns The cached value without copying it, or `null` when absent or nullish.\n         */\n        getItem(...args: P) {\n            const rawValue = lruInstance.get(keyFn(...args));\n            return rawValue as D ?? null;\n        },\n        getItemTtl: (...args: P) => lruInstance.getRemainingTTL(keyFn(...args)),\n        hasItem: (...args: P) => lruInstance.has(keyFn(...args)),\n        removeItem: (...args: P) => lruInstance.delete(keyFn(...args)),\n        /**\n         * Resolves the full cache key from the given arguments.\n         */\n        resolveKey: (...args: P) => keyFn(...args),\n        setItem: (value: D, ...args: P) => lruInstance.set(keyFn(...args), value),\n        setItemWithTtl(ttlMilliseconds: number, value: D, ...args: P) {\n            return lruInstance.set(keyFn(...args), value, { ttl: ttlMilliseconds });\n        },\n    });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,oBAAiC,aAAsC;CACnF,QAAyB,UAAkC,OAAO,OAAO;;;;;;EAMrE,QAAQ,GAAG,MAAS;GAEhB,OADiB,YAAY,IAAI,MAAM,GAAG,IAAI,CAChC,KAAU;EAC5B;EACA,aAAa,GAAG,SAAY,YAAY,gBAAgB,MAAM,GAAG,IAAI,CAAC;EACtE,UAAU,GAAG,SAAY,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;EACvD,aAAa,GAAG,SAAY,YAAY,OAAO,MAAM,GAAG,IAAI,CAAC;;;;EAI7D,aAAa,GAAG,SAAY,MAAM,GAAG,IAAI;EACzC,UAAU,OAAU,GAAG,SAAY,YAAY,IAAI,MAAM,GAAG,IAAI,GAAG,KAAK;EACxE,eAAe,iBAAyB,OAAU,GAAG,MAAS;GAC1D,OAAO,YAAY,IAAI,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,KAAK,gBAAgB,CAAC;EAC1E;CACJ,CAAC;AACL"}

package/dist/types/filtered-key-path.d.ts

@@ -14,4 +14,5 @@ type PathImpl<K extends number | string, V, U> = [U] extends [never] ? DefaultPa
 type TerminalType = bigint | Blob | boolean | Date | File | null | number | ObjectId | RegExp | string | symbol | undefined;
 type TupleKey<T extends ReadonlyArray<any>> = Exclude<keyof T, keyof any[]>;
 //#endregion
+export {};
 //# sourceMappingURL=filtered-key-path.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kikiutils/shared",
   "type": "module",
-  "version": "18.1.0",
+  "version": "18.3.0",
   "description": "A lightweight and modular utility library for modern JavaScript and TypeScript — includes secure hashing, flexible logging, datetime tools, Vue/web helpers, storage abstraction, and more.",
   "author": "kiki-kanri",
   "license": "MIT",
@@ -75,6 +75,7 @@
     "date-fns": "^4.4.0",
     "decimal.js": "^10.6.0",
     "element-plus": "^2.14.4",
+    "file-type": "^22.1.1",
     "lru-cache": "^11.5.2",
     "millify": "^6.1.0",
     "msgpackr": "^2.0.5",
@@ -109,6 +110,9 @@
     "element-plus": {
       "optional": true
     },
+    "file-type": {
+      "optional": true
+    },
     "lru-cache": {
       "optional": true
     },
@@ -136,12 +140,12 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.5.1",
-    "@kikiutils/eslint-config": "^9.2.1",
+    "@kikiutils/eslint-config": "^9.3.0",
     "@kikiutils/tsconfigs": "^7.0.0",
     "@noble/hashes": "^2.4.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.5",
     "@types/ssh2": "^1.15.6",
-    "@vitest/coverage-v8": "^5.0.3",
+    "@vitest/coverage-v8": "^5.0.4",
     "async-validator": "^4.2.5",
     "bson": "^7.3.3",
     "changelogen": "^0.6.2",
@@ -150,21 +154,22 @@
     "date-fns": "^4.4.0",
     "decimal.js": "^10.6.0",
     "element-plus": "^2.14.7",
-    "eslint": "^10.11.0",
-    "jsdom": "^30.1.1",
-    "knip": "^6.39.0",
+    "eslint": "^10.12.0",
+    "file-type": "^22.1.1",
+    "jsdom": "^30.1.2",
+    "knip": "^6.41.0",
     "lru-cache": "^11.5.3",
     "millify": "^6.1.0",
     "msgpackr": "^2.1.0",
     "node-ssh": "^13.2.1",
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
+    "pino": "^10.4.0",
+    "pino-pretty": "^13.2.0",
     "publint": "^0.3.25",
-    "tsdown": "^0.23.0",
+    "tsdown": "^0.23.1",
     "typescript": "^6.0.3",
     "unplugin-unused": "^0.6.0",
-    "vitest": "^5.0.3",
+    "vitest": "^5.0.4",
     "vue": "^3.5.43",
-    "vue-router": "^5.3.1"
+    "vue-router": "^5.4.0"
   }
 }

package/src/classes/enhanced-date.ts

@@ -39,6 +39,20 @@ export class EnhancedDate extends Date {
         return new EnhancedDate(dateFns.endOfToday());
     }
 
+    /**
+     * Returns a new instance at the end of tomorrow in the system time zone.
+     */
+    static endOfTomorrow() {
+        return new EnhancedDate(dateFns.endOfTomorrow());
+    }
+
+    /**
+     * Returns a new instance at the end of yesterday in the system time zone.
+     */
+    static endOfYesterday() {
+        return new EnhancedDate(dateFns.endOfYesterday());
+    }
+
     /**
      * Parses a date using date-fns and an explicit reference for missing fields.
      *
@@ -79,6 +93,28 @@ export class EnhancedDate extends Date {
         return new EnhancedDate(seconds * 1000);
     }
 
+    /**
+     * Returns the latest date as a new independent instance.
+     *
+     * @param dates - Dates or millisecond timestamps to compare.
+     *
+     * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
+     */
+    static max(dates: (Date | number)[]) {
+        return new EnhancedDate(dateFns.max(dates));
+    }
+
+    /**
+     * Returns the earliest date as a new independent instance.
+     *
+     * @param dates - Dates or millisecond timestamps to compare.
+     *
+     * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
+     */
+    static min(dates: (Date | number)[]) {
+        return new EnhancedDate(dateFns.min(dates));
+    }
+
     /**
      * Returns a new instance at the start of today in the system time zone.
      */
@@ -86,6 +122,20 @@ export class EnhancedDate extends Date {
         return new EnhancedDate(dateFns.startOfToday());
     }
 
+    /**
+     * Returns a new instance at the start of tomorrow in the system time zone.
+     */
+    static startOfTomorrow() {
+        return new EnhancedDate(dateFns.startOfTomorrow());
+    }
+
+    /**
+     * Returns a new instance at the start of yesterday in the system time zone.
+     */
+    static startOfYesterday() {
+        return new EnhancedDate(dateFns.startOfYesterday());
+    }
+
     // Public instance methods
 
     /**

package/src/classes/path.ts

@@ -489,8 +489,19 @@ export class Path {
     ): Promise<fs.BigIntStats | undefined>;
     stat(opts: fs.StatOptions & { throwIfNoEntry?: true }): Promise<fs.BigIntStats | fs.Stats>;
     stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats | undefined>;
-    stat(...args: any): any {
-        return fsp.stat(this.#value, ...args);
+    async stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats | undefined> {
+        try {
+            return await fsp.stat(this.#value, opts);
+        } catch (error) {
+            if (
+                opts?.throwIfNoEntry === false
+                && error instanceof Error
+                && 'code' in error
+                && error.code === 'ENOENT'
+            ) return undefined;
+
+            throw error;
+        }
     }
 
     /**

package/src/file.ts

@@ -0,0 +1,37 @@
+import {
+    fileTypeFromBlob,
+    fileTypeFromBuffer,
+} from 'file-type';
+
+import type { BinaryInput } from './types';
+
+/**
+ * Detects a lowercase MIME type from binary content rather than its name or declared type.
+ *
+ * @remarks
+ * Requires the optional `file-type` peer dependency. Only formats supported by its binary detection
+ * are recognized; this is not a general text-file detector or a guarantee that a file is safe.
+ * Blob and File inputs are read through the detector's tokenizer instead of being fully buffered up front.
+ * The amount of content inspected depends on its format; this does not impose a fixed read limit.
+ * Detection and input-reading errors propagate to the caller.
+ *
+ * @param input - The binary content to inspect.
+ *
+ * @returns The detected lowercase MIME type, or `undefined` when the content is not recognized.
+ *
+ * @example
+ *
+ * ```ts
+ * import { getFileMimeType } from '@kikiutils/shared/file';
+ *
+ * const mimeType = await getFileMimeType(file);
+ * ```
+ */
+export async function getFileMimeType(input: BinaryInput) {
+    // The tokenizer only uses size, slice, and arrayBuffer; Node/DOM Blob stream typings differ.
+    const result = input instanceof ArrayBuffer || input instanceof Uint8Array
+        ? await fileTypeFromBuffer(input)
+        : await fileTypeFromBlob(input as Blob);
+
+    return result?.mime.toLowerCase();
+}

package/src/storages/lru/keyed-store.ts

@@ -7,6 +7,7 @@ import type { LRUCache } from 'lru-cache';
  * The key resolver is called synchronously once per operation, and its exceptions propagate.
  * Reads return the cached value without copying it, or `null` for missing or nullish values.
  * `getItemTtl` exposes the underlying remaining TTL in milliseconds; `setItem` returns the underlying cache.
+ * `setItemWithTtl` accepts its TTL in milliseconds before the value and key arguments and returns the cache.
  * The facade does not dispose the supplied cache, and LRU defaults remain those of the supplied instance.
  *
  * @typeParam D - The stored value type used by reads and writes.
@@ -46,5 +47,8 @@ export function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<any, any,
          */
         resolveKey: (...args: P) => keyFn(...args),
         setItem: (value: D, ...args: P) => lruInstance.set(keyFn(...args), value),
+        setItemWithTtl(ttlMilliseconds: number, value: D, ...args: P) {
+            return lruInstance.set(keyFn(...args), value, { ttl: ttlMilliseconds });
+        },
     });
 }