@kikiutils/shared 20.0.1 → 20.1.1

package/dist/buffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.js","names":[],"sources":["../src/buffer.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nimport type { BinaryInput } from './types';\n\n/**\n * Converts binary input to a Node.js `Buffer`.\n *\n * @remarks\n * An existing `Buffer` is returned unchanged. `ArrayBuffer` and `Uint8Array` inputs share their backing memory\n * with the result, so changes are visible through both views. `Blob` and `File` inputs are read asynchronously.\n *\n * @param input - The binary data to convert.\n *\n * @returns A promise resolving to the original buffer or a new buffer view after the input is available.\n *\n * @throws TypeError through promise rejection if the input is unsupported.\n *\n * @example\n *\n * ```ts\n * import { toBuffer } from '@kikiutils/shared/buffer';\n *\n * const bytes = new Uint8Array([\n *     10,\n *     20,\n *     30,\n * ]);\n *\n * const buffer = await toBuffer(bytes);\n * bytes[0] = 40;\n * console.log(buffer[0]); // => 40\n * ```\n */\nexport async function toBuffer(input: BinaryInput) {\n    if (Buffer.isBuffer(input)) return input;\n    if (input instanceof ArrayBuffer) return Buffer.from(input);\n    if (input instanceof Uint8Array) return Buffer.from(input.buffer, input.byteOffset, input.byteLength);\n    if (typeof input.arrayBuffer === 'function') return Buffer.from(await input.arrayBuffer());\n    // eslint-disable-next-line style/max-len\n    throw new TypeError('The provided input is not a supported binary type (Blob, Buffer, File, ArrayBuffer, or Uint8Array).');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,eAAsB,SAAS,OAAoB;CAC/C,IAAI,OAAO,SAAS,KAAK,GAAG,OAAO;CACnC,IAAI,iBAAiB,aAAa,OAAO,OAAO,KAAK,KAAK;CAC1D,IAAI,iBAAiB,YAAY,OAAO,OAAO,KAAK,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU;CACpG,IAAI,OAAO,MAAM,gBAAgB,YAAY,OAAO,OAAO,KAAK,MAAM,MAAM,YAAY,CAAC;CAEzF,MAAM,IAAI,UAAU,qGAAqG;AAC7H"}
+{"version":3,"file":"buffer.js","names":[],"sources":["../src/buffer.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nimport type { BinaryInput } from './types';\n\n/**\n * Converts binary input to a Node.js `Buffer`.\n *\n * @remarks\n * An existing `Buffer` is returned unchanged. `ArrayBuffer` and `Uint8Array` inputs share their backing memory\n * with the result, so changes are visible through both views. `Blob` and `File` inputs are read asynchronously.\n *\n * @param input - The binary data to convert.\n *\n * @returns A promise resolving to the original buffer or a new buffer view after the input is available.\n *\n * @throws TypeError through promise rejection if the input is unsupported.\n *\n * @example\n *\n * ```ts\n * import { toBuffer } from '@kikiutils/shared/buffer';\n *\n * const bytes = new Uint8Array([\n *     10,\n *     20,\n *     30,\n * ]);\n *\n * const buffer = await toBuffer(bytes);\n * bytes[0] = 40;\n * console.log(buffer[0]); // => 40\n * ```\n */\nexport async function toBuffer(input: BinaryInput) {\n    if (Buffer.isBuffer(input)) return input;\n    if (input instanceof ArrayBuffer) return Buffer.from(input);\n    if (input instanceof Uint8Array) return Buffer.from(input.buffer, input.byteOffset, input.byteLength);\n    if (typeof input.arrayBuffer === 'function') return Buffer.from(await input.arrayBuffer());\n    throw new TypeError('The provided input is not a supported binary type (Blob, Buffer, File, ArrayBuffer, or Uint8Array).');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,eAAsB,SAAS,OAAoB;CAC/C,IAAI,OAAO,SAAS,KAAK,GAAG,OAAO;CACnC,IAAI,iBAAiB,aAAa,OAAO,OAAO,KAAK,KAAK;CAC1D,IAAI,iBAAiB,YAAY,OAAO,OAAO,KAAK,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU;CACpG,IAAI,OAAO,MAAM,gBAAgB,YAAY,OAAO,OAAO,KAAK,MAAM,MAAM,YAAY,CAAC;CACzF,MAAM,IAAI,UAAU,qGAAqG;AAC7H"}

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

@@ -74,7 +74,7 @@ export declare class EnhancedDate extends Date {
    *
    * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
    */
-  static max(dates: (Date | number)[]): EnhancedDate;
+  static max(dates: Array<Date | number>): EnhancedDate;
   /**
    * Returns the earliest date as a new independent instance.
    *
@@ -82,7 +82,7 @@ export declare class EnhancedDate extends Date {
    *
    * @returns A new `EnhancedDate`, or `Invalid Date` if the array is empty or contains an invalid date.
    */
-  static min(dates: (Date | number)[]): EnhancedDate;
+  static min(dates: Array<Date | number>): EnhancedDate;
   /**
    * Returns a new instance at the start of today in the system time zone.
    */

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;;;;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"}
+{"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,OAAO,MAAM,iBAAc;;;;;;;;SAW/B,IAAI,OAAO,MAAM,iBAAc;;;;SAO/B,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.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     * 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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"}
+{"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: Array<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: Array<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

@@ -252,7 +252,7 @@ export declare class Path {
     encoding: 'buffer';
     recursive?: boolean;
     withFileTypes: true;
-  }): Promise<fs.Dirent<Buffer>[]>;
+  }): Promise<Array<fs.Dirent<Buffer>>>;
   /**
    * Reads the entire file at the stored path.
    *

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;;;;;;;;;EAwBzD,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;;;;;;;;;EAYM,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;;;;;;;;;;EAahE,MAAM,SAAS,GAAG;IAAyB;MAAoB;EAC/D,MACI,WACK,GAAG;IAAyB;OAC7B,GAAG,cAER;EACH,MAAM,UAAU,GAAG,uBAAuB,GAAG,cAAc;;;;;;;;;EAarD,QAAQ,MAAM,2BAA2B,IAAI,QAAK,QAAA,GAAA,SAAA;;;;;;;;;EAYxD,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,MAAM,GAAG,OAAO;;;;;;;;;EAa3B,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;;;;;;;;;;;EAeL,OAAO,SAAS,WAAQ;;;;;;;;;EAYxB,MAAM,MAAM,2BAA2B,IAAI,MAAG;;;;;;;;;EAY9C,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;;EAa1D,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;;;;;;;;;EAwBnD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;EAY1D,UAAM;;;;;;;;;EAYN,aAAa,MAAM,2BAA2B,IAAI,aAAU"}

package/dist/classes/path.js

@@ -200,8 +200,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.access}
 	*/
-	access(...args) {
-		return fsp.access(this.#value, ...args);
+	async access(...args) {
+		return await fsp.access(this.#value, ...args);
 	}
 	/**
 	* Appends data to the file at the stored path.
@@ -211,8 +211,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.appendFile}
 	*/
-	appendFile(...args) {
-		return fsp.appendFile(this.#value, ...args);
+	async appendFile(...args) {
+		return await fsp.appendFile(this.#value, ...args);
 	}
 	/**
 	* Changes the permissions of the stored path.
@@ -222,8 +222,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chmod}
 	*/
-	chmod(...args) {
-		return fsp.chmod(this.#value, ...args);
+	async chmod(...args) {
+		return await fsp.chmod(this.#value, ...args);
 	}
 	/**
 	* Changes the owner and group of the stored path.
@@ -233,8 +233,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chown}
 	*/
-	chown(...args) {
-		return fsp.chown(this.#value, ...args);
+	async chown(...args) {
+		return await fsp.chown(this.#value, ...args);
 	}
 	/**
 	* Copies the file at the stored path to a destination.
@@ -244,11 +244,11 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.copyFile}
 	*/
-	copyFile(...args) {
-		return fsp.copyFile(this.#value, ...args);
+	async copyFile(...args) {
+		return await fsp.copyFile(this.#value, ...args);
 	}
-	mkdir(...args) {
-		return fsp.mkdir(this.#value, ...args);
+	async mkdir(...args) {
+		return await fsp.mkdir(this.#value, ...args);
 	}
 	/**
 	* Opens the file at the stored path.
@@ -258,14 +258,14 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.open}
 	*/
-	open(...args) {
-		return fsp.open(this.#value, ...args);
+	async open(...args) {
+		return await fsp.open(this.#value, ...args);
 	}
-	readdir(...args) {
-		return fsp.readdir(this.#value, ...args);
+	async readdir(...args) {
+		return await fsp.readdir(this.#value, ...args);
 	}
-	readFile(...args) {
-		return fsp.readFile(this.#value, ...args);
+	async readFile(...args) {
+		return await fsp.readFile(this.#value, ...args);
 	}
 	/**
 	* Renames or moves the file or directory at the stored path.
@@ -277,8 +277,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rename}
 	*/
-	rename(newPath) {
-		return fsp.rename(this.#value, newPath.toString());
+	async rename(newPath) {
+		return await fsp.rename(this.#value, newPath.toString());
 	}
 	/**
 	* Removes the file or directory at the stored path.
@@ -288,8 +288,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rm}
 	*/
-	rm(...args) {
-		return fsp.rm(this.#value, ...args);
+	async rm(...args) {
+		return await fsp.rm(this.#value, ...args);
 	}
 	/**
 	* Removes the directory at the stored path.
@@ -299,8 +299,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rmdir}
 	*/
-	rmdir(...args) {
-		return fsp.rmdir(this.#value, ...args);
+	async rmdir(...args) {
+		return await fsp.rmdir(this.#value, ...args);
 	}
 	async stat(opts) {
 		try {
@@ -318,8 +318,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.truncate}
 	*/
-	truncate(...args) {
-		return fsp.truncate(this.#value, ...args);
+	async truncate(...args) {
+		return await fsp.truncate(this.#value, ...args);
 	}
 	/**
 	* Deletes the file or symbolic link at the stored path.
@@ -329,8 +329,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.unlink}
 	*/
-	unlink() {
-		return fsp.unlink(this.#value);
+	async unlink() {
+		return await fsp.unlink(this.#value);
 	}
 	/**
 	* Writes data to the file at the stored path.
@@ -340,8 +340,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.writeFile}
 	*/
-	writeFile(...args) {
-		return fsp.writeFile(this.#value, ...args);
+	async writeFile(...args) {
+		return await fsp.writeFile(this.#value, ...args);
 	}
 };
 export { 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    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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"}
+{"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    async access(...args: DropFirstParameters<typeof fsp.access>) {\n        return await 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    async appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n        return await 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    async chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n        return await 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    async chown(...args: DropFirstParameters<typeof fsp.chown>) {\n        return await 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    async copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n        return await 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    async mkdir(...args: any): Promise<any> {\n        return await 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    async open(...args: DropFirstParameters<typeof fsp.open>) {\n        return await 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<Array<fs.Dirent<Buffer>>>;\n    async readdir(...args: any): Promise<any> {\n        return await 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    async readFile(...args: any): Promise<any> {\n        return await 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    async rename(newPath: PathLike) {\n        return await 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    async rm(...args: DropFirstParameters<typeof fsp.rm>) {\n        return await 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    async rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n        return await 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    async truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n        return await 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    async unlink() {\n        return await 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    async writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n        return await fsp.writeFile(this.#value, ...args);\n    }\n}\n"],"mappings":"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"}

package/dist/enum.d.ts

@@ -1,3 +1,4 @@
+import { ValueOf } from "type-fest";
 /**
  * Extracts only the numeric values from an enumeration-like object.
  *
@@ -22,7 +23,7 @@
  * console.log(getEnumNumberValues(RecordType)); // => [0, 1]
  * ```
  */
-export declare function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Extract<T[keyof T], number>[];
+export declare function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, number>>;
 /**
  * Extracts only the string values from an enumeration-like object.
  *
@@ -47,7 +48,7 @@ export declare function getEnumNumberValues<T extends Record<string, any>>(enumO
  * console.log(getEnumStringValues(RecordType)); // => ['unknown']
  * ```
  */
-export declare function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Extract<T[keyof T], string>[];
+export declare function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, string>>;
 /**
  * Extracts all values from an enumeration-like object.
  *
@@ -96,5 +97,5 @@ export declare function getEnumStringValues<T extends Record<string, any>>(enumO
  * console.log(getEnumValues(RecordType)); // => [0, 1, 'unknown']
  * ```
  */
-export declare function getEnumValues<T extends Record<string, any>>(enumObject: T): (T[keyof T])[];
+export declare function getEnumValues<T extends Record<string, any>>(enumObject: T): Array<ValueOf<T>>;
 //# sourceMappingURL=enum.d.ts.map

package/dist/enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enum.d.ts","names":[],"sources":["../src/enum.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBAwBgB,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;wBA4BnF,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoDnF,cAAc,UAAU,qBAAqB,YAAY,KAAK,QAAQ"}
+{"version":3,"file":"enum.d.ts","names":[],"sources":["../src/enum.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;wBA8BgB,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;wBA4BzF,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoDzF,cAAc,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ"}

package/dist/enum.js

@@ -1,3 +1,4 @@
+import { objectKeys, objectValues } from "ts-extras";
 // src/enum.ts
 /**
 * Extracts only the numeric values from an enumeration-like object.
@@ -102,9 +103,9 @@ function getEnumStringValues(enumObject) {
 * ```
 */
 function getEnumValues(enumObject) {
-	const values = Object.values(enumObject);
+	const values = objectValues(enumObject);
 	if (!values.some((value) => typeof value === "number")) return values;
-	return Object.keys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);
+	return objectKeys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);
 }
 export { getEnumNumberValues, getEnumStringValues, getEnumValues };
 

package/dist/enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.js","names":[],"sources":["../src/enum.ts"],"sourcesContent":["/**\n * Extracts only the numeric values from an enumeration-like object.\n *\n * @typeParam T - The type of the enum object.\n *\n * @param enumObject - The enumeration-like object to extract numeric values from,\n * the object can contain numeric values, string values, or both.\n *\n * @returns An array of numeric values extracted from the enum object.\n *\n * @example\n *\n * ```ts\n * import { getEnumNumberValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *     Receive = 0,\n *     Send = 1,\n *     Unknown = 'unknown',\n * }\n *\n * console.log(getEnumNumberValues(RecordType)); // => [0, 1]\n * ```\n */\nexport function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Extract<T[keyof T], number>[] {\n    return getEnumValues(enumObject).filter((value) => typeof value === 'number');\n}\n\n/**\n * Extracts only the string values from an enumeration-like object.\n *\n * @typeParam T - The type of the enum object.\n *\n * @param enumObject - The enumeration-like object to extract string values from,\n * the object can contain numeric values, string values, or both.\n *\n * @returns An array of string values extracted from the enum object.\n *\n * @example\n *\n * ```ts\n * import { getEnumStringValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *     Receive = 0,\n *     Send = 1,\n *     Unknown = 'unknown',\n * }\n *\n * console.log(getEnumStringValues(RecordType)); // => ['unknown']\n * ```\n */\nexport function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Extract<T[keyof T], string>[] {\n    return getEnumValues(enumObject).filter((value) => typeof value === 'string');\n}\n\n/**\n * Extracts all values from an enumeration-like object.\n *\n * @remarks\n * This function handles TypeScript enums correctly by accounting for the reverse mapping\n * that occurs with numeric enums. It works with pure numeric enums, pure string enums,\n * and mixed enums.\n *\n * @typeParam T - The type of the enum object.\n *\n * @param enumObject - The enumeration-like object to extract values from,\n * the object can contain numeric values, string values, or both.\n *\n * @returns An array containing all the values from the enum object.\n *\n * @example\n *\n * ```ts\n * import { getEnumValues } from '@kikiutils/shared/enum';\n *\n * // Numeric enum\n * enum Status {\n *     Active = 0,\n *     Inactive = 1,\n *     Pending = 2,\n * }\n *\n * console.log(getEnumValues(Status)); // => [0, 1, 2]\n *\n * // String enum\n * enum Color {\n *     Red = 'RED',\n *     Green = 'GREEN',\n *     Blue = 'BLUE',\n * }\n *\n * console.log(getEnumValues(Color)); // => ['RED', 'GREEN', 'BLUE']\n *\n * // Mixed enum\n * enum RecordType {\n *     Receive = 0,\n *     Send = 1,\n *     Unknown = 'unknown',\n * }\n *\n * console.log(getEnumValues(RecordType)); // => [0, 1, 'unknown']\n * ```\n */\nexport function getEnumValues<T extends Record<string, any>>(enumObject: T): (T[keyof T])[] {\n    const values = Object.values(enumObject);\n    const hasNumberValues = values.some((value) => typeof value === 'number');\n    if (!hasNumberValues) return values;\n    return Object.keys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,oBAAmD,YAA8C;CAC7G,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAmD,YAA8C;CAC7G,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,cAA6C,YAA+B;CACxF,MAAM,SAAS,OAAO,OAAO,UAAU;CAEvC,IAAI,CADoB,OAAO,MAAM,UAAU,OAAO,UAAU,QAC7C,GAAG,OAAO;CAC7B,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,QAAQ,QAAQ,OAAO,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,WAAW,IAAI;AAC1G"}
+{"version":3,"file":"enum.js","names":[],"sources":["../src/enum.ts"],"sourcesContent":["import {\n    objectKeys,\n    objectValues,\n} from 'ts-extras';\nimport type { ValueOf } from 'type-fest';\n\n/**\n * Extracts only the numeric values from an enumeration-like object.\n *\n * @typeParam T - The type of the enum object.\n *\n * @param enumObject - The enumeration-like object to extract numeric values from,\n * the object can contain numeric values, string values, or both.\n *\n * @returns An array of numeric values extracted from the enum object.\n *\n * @example\n *\n * ```ts\n * import { getEnumNumberValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *     Receive = 0,\n *     Send = 1,\n *     Unknown = 'unknown',\n * }\n *\n * console.log(getEnumNumberValues(RecordType)); // => [0, 1]\n * ```\n */\nexport function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, number>> {\n    return getEnumValues(enumObject).filter((value) => typeof value === 'number');\n}\n\n/**\n * Extracts only the string values from an enumeration-like object.\n *\n * @typeParam T - The type of the enum object.\n *\n * @param enumObject - The enumeration-like object to extract string values from,\n * the object can contain numeric values, string values, or both.\n *\n * @returns An array of string values extracted from the enum object.\n *\n * @example\n *\n * ```ts\n * import { getEnumStringValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *     Receive = 0,\n *     Send = 1,\n *     Unknown = 'unknown',\n * }\n *\n * console.log(getEnumStringValues(RecordType)); // => ['unknown']\n * ```\n */\nexport function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, string>> {\n    return getEnumValues(enumObject).filter((value) => typeof value === 'string');\n}\n\n/**\n * Extracts all values from an enumeration-like object.\n *\n * @remarks\n * This function handles TypeScript enums correctly by accounting for the reverse mapping\n * that occurs with numeric enums. It works with pure numeric enums, pure string enums,\n * and mixed enums.\n *\n * @typeParam T - The type of the enum object.\n *\n * @param enumObject - The enumeration-like object to extract values from,\n * the object can contain numeric values, string values, or both.\n *\n * @returns An array containing all the values from the enum object.\n *\n * @example\n *\n * ```ts\n * import { getEnumValues } from '@kikiutils/shared/enum';\n *\n * // Numeric enum\n * enum Status {\n *     Active = 0,\n *     Inactive = 1,\n *     Pending = 2,\n * }\n *\n * console.log(getEnumValues(Status)); // => [0, 1, 2]\n *\n * // String enum\n * enum Color {\n *     Red = 'RED',\n *     Green = 'GREEN',\n *     Blue = 'BLUE',\n * }\n *\n * console.log(getEnumValues(Color)); // => ['RED', 'GREEN', 'BLUE']\n *\n * // Mixed enum\n * enum RecordType {\n *     Receive = 0,\n *     Send = 1,\n *     Unknown = 'unknown',\n * }\n *\n * console.log(getEnumValues(RecordType)); // => [0, 1, 'unknown']\n * ```\n */\nexport function getEnumValues<T extends Record<string, any>>(enumObject: T): Array<ValueOf<T>> {\n    const values = objectValues(enumObject);\n    const hasNumberValues = values.some((value) => typeof value === 'number');\n    if (!hasNumberValues) return values;\n    return objectKeys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,oBAAmD,YAAmD;CAClH,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAmD,YAAmD;CAClH,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,cAA6C,YAAkC;CAC3F,MAAM,SAAS,aAAa,UAAU;CAEtC,IAAI,CADoB,OAAO,MAAM,UAAU,OAAO,UAAU,QAC7C,GAAG,OAAO;CAC7B,OAAO,WAAW,UAAU,CAAC,CAAC,QAAQ,QAAQ,OAAO,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,WAAW,IAAI;AACzG"}

package/dist/event-awaiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-awaiter.d.ts","names":[],"sources":["../src/event-awaiter.ts"],"mappings":";;;;;;;;;;;qBAWa,aAAa;;;;;;;;EAYtB,QAAQ,aAAa,OAAO;;;;;;EAa5B,WAAW,QAAO;;;;;;;;;;;;;;;;;;;;EAwBlB,KAAK,aAAa,oBAAoB,8BAA8B,SAAS,cAAW,QAAA;;;;;;;;;;;;;;EA8DxF,cAAc,aAAa,oBAAoB,SAAS,cAAW,QAAA;;;;;;;;;;;;;;;EAkBnE,WAAW,aAAa,oBAAoB,SAAS,cAAW,QAAA"}
+{"version":3,"file":"event-awaiter.d.ts","names":[],"sources":["../src/event-awaiter.ts"],"mappings":";;;;;;;;;;;qBAWa,aAAa;;;;;;;;EAYtB,QAAQ,aAAa,OAAO;;;;;;EAa5B,WAAW,QAAO;;;;;;;;;;;;;;;;;;;;EAwBZ,KAAK,aAAa,oBAAoB,8BAA8B,SAAS,cAAW,QAAA;;;;;;;;;;;;;;EAgExF,cAAc,aAAa,oBAAoB,SAAS,cAAW,QAAA;;;;;;;;;;;;;;;EAkBnE,WAAW,aAAa,oBAAoB,SAAS,cAAW,QAAA"}

package/dist/event-awaiter.js

@@ -53,8 +53,8 @@ var EventAwaiter = class {
 	*
 	* @throws Error through promise rejection if `strict` mode encounters an existing waiter.
 	*/
-	wait(key, timeoutMs, mode, signal) {
-		return new Promise((resolve) => {
+	async wait(key, timeoutMs, mode, signal) {
+		return await new Promise((resolve) => {
 			const resolvers = this.#promiseResolvers.get(key) || [];
 			if (resolvers.length) switch (mode) {
 				case "override":
@@ -62,6 +62,7 @@ var EventAwaiter = class {
 					resolvers.length = 0;
 					break;
 				case "strict": throw new Error(`Duplicate wait detected for key: ${key}`);
+				case void 0:
 			}
 			resolvers.push(resolve);
 			this.#promiseResolvers.set(key, resolvers);
@@ -98,8 +99,8 @@ var EventAwaiter = class {
 	*
 	* @see {@link EventAwaiter.wait}
 	*/
-	waitExclusive(key, timeoutMs, signal) {
-		return this.wait(key, timeoutMs, "strict", signal);
+	async waitExclusive(key, timeoutMs, signal) {
+		return await this.wait(key, timeoutMs, "strict", signal);
 	}
 	/**
 	* Replaces existing waiters for a key and waits for its next trigger.
@@ -115,8 +116,8 @@ var EventAwaiter = class {
 	*
 	* @see {@link EventAwaiter.wait}
 	*/
-	waitLatest(key, timeoutMs, signal) {
-		return this.wait(key, timeoutMs, "override", signal);
+	async waitLatest(key, timeoutMs, signal) {
+		return await this.wait(key, timeoutMs, "override", signal);
 	}
 };
 export { EventAwaiter };

package/dist/event-awaiter.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-awaiter.js","names":[],"sources":["../src/event-awaiter.ts"],"sourcesContent":["/**\n * An asynchronous keyed event rendezvous for one or more waiting consumers.\n *\n * @remarks\n * Triggers resolve the currently registered waiters; values are not retained for future waits.\n * Timeouts and subsequent abort events resolve affected waiters with `undefined`.\n * Use `triggerAll` to resolve pending waits during cleanup. Timers and abort listeners are not proactively\n * removed by triggers, so they may remain until their timeout or abort event occurs.\n *\n * @typeParam T - The value delivered to waiting consumers.\n */\nexport class EventAwaiter<T> {\n    // Private instance properties\n    #promiseResolvers = new Map<string, ((value: PromiseLike<T | undefined> | T | undefined) => void)[]>();\n\n    // Public instance methods\n\n    /**\n     * Resolves all currently pending waits for a key with the supplied value.\n     *\n     * @param key - The event identifier; a key without pending waits has no effect.\n     * @param value - The delivered value; `undefined` indicates no result.\n     */\n    trigger(key: string, value: T | undefined) {\n        const resolvers = this.#promiseResolvers.get(key);\n        if (resolvers) {\n            this.#promiseResolvers.delete(key);\n            resolvers?.forEach((resolve) => resolve(value));\n        }\n    }\n\n    /**\n     * Resolves all currently pending waits and clears their registrations.\n     *\n     * @param value - The delivered value; omission resolves all pending waits with `undefined`.\n     */\n    triggerAll(value: T | undefined = undefined) {\n        for (const [_, resolvers] of this.#promiseResolvers.entries()) resolvers.forEach((resolve) => resolve(value));\n        this.#promiseResolvers.clear();\n    }\n\n    /**\n     * Waits for a trigger associated with a key.\n     *\n     * @remarks\n     * By default, multiple waiters share a key and all receive the next trigger value.\n     * `strict` mode rejects duplicate waits; `override` mode resolves existing waits with `undefined` before\n     * registering the new wait. Timeout and abort remove only the affected waiter's registration.\n     * An already aborted signal is not checked; only an abort event emitted after registration ends the wait.\n     * Without a timeout or subsequent abort, the wait remains pending until a trigger arrives.\n     *\n     * @param key - The event identifier to wait for.\n     * @param timeoutMs - The optional timeout in milliseconds, using native `setTimeout` timing rules.\n     * @param mode - The policy for existing waiters; omission allows multiple waiters.\n     * @param signal - A signal whose subsequent abort event ends this wait.\n     *\n     * @returns A promise resolving to the triggered value, or `undefined` after timeout, abort, or replacement.\n     *\n     * @throws Error through promise rejection if `strict` mode encounters an existing waiter.\n     */\n    wait(key: string, timeoutMs?: number, mode?: 'override' | 'strict', signal?: AbortSignal) {\n        return new Promise<T | undefined>((resolve) => {\n            const resolvers = this.#promiseResolvers.get(key) || [];\n            if (resolvers.length) {\n                switch (mode) {\n                    case 'override':\n                        resolvers.forEach((r) => r(undefined));\n                        resolvers.length = 0;\n                        break;\n                    case 'strict':\n                        throw new Error(`Duplicate wait detected for key: ${key}`);\n                }\n            }\n\n            resolvers.push(resolve);\n            this.#promiseResolvers.set(key, resolvers);\n            if (timeoutMs != null) {\n                setTimeout(\n                    () => {\n                        const resolvers = this.#promiseResolvers.get(key);\n                        if (resolvers?.includes(resolve)) {\n                            resolve(undefined);\n                            const newResolvers = resolvers.filter((r) => r !== resolve);\n                            if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n                            else this.#promiseResolvers.delete(key);\n                        }\n                    },\n                    timeoutMs,\n                );\n            }\n\n            if (signal) {\n                signal.addEventListener(\n                    'abort',\n                    () => {\n                        const resolvers = this.#promiseResolvers.get(key);\n                        if (resolvers?.includes(resolve)) {\n                            resolve(undefined);\n                            const newResolvers = resolvers.filter((r) => r !== resolve);\n                            if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n                            else this.#promiseResolvers.delete(key);\n                        }\n                    },\n                    { once: true },\n                );\n            }\n        });\n    }\n\n    /**\n     * Waits for a key while rejecting duplicate registrations.\n     *\n     * @param key - The event identifier to wait for.\n     * @param timeoutMs - The optional timeout in milliseconds.\n     * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n     *\n     * @returns A promise resolving to the triggered value, or `undefined` on timeout or subsequent abort.\n     *\n     * @throws Error through promise rejection if the key already has a pending waiter.\n     *\n     * @see {@link EventAwaiter.wait}\n     */\n    waitExclusive(key: string, timeoutMs?: number, signal?: AbortSignal) {\n        return this.wait(key, timeoutMs, 'strict', signal);\n    }\n\n    /**\n     * Replaces existing waiters for a key and waits for its next trigger.\n     *\n     * @remarks\n     * Existing waiters resolve with `undefined` before the new waiter is registered.\n     *\n     * @param key - The event identifier to wait for.\n     * @param timeoutMs - The optional timeout in milliseconds.\n     * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n     *\n     * @returns A promise resolving to the triggered value, or `undefined` on timeout, subsequent abort, or replacement.\n     *\n     * @see {@link EventAwaiter.wait}\n     */\n    waitLatest(key: string, timeoutMs?: number, signal?: AbortSignal) {\n        return this.wait(key, timeoutMs, 'override', signal);\n    }\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,eAAb,MAA6B;CAEzB,oCAAoB,IAAI,IAA6E;;;;;;;CAUrG,QAAQ,KAAa,OAAsB;EACvC,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;EAChD,IAAI,WAAW;GACX,KAAK,kBAAkB,OAAO,GAAG;GACjC,WAAW,SAAS,YAAY,QAAQ,KAAK,CAAC;EAClD;CACJ;;;;;;CAOA,WAAW,QAAuB,KAAA,GAAW;EACzC,KAAK,MAAM,CAAC,GAAG,cAAc,KAAK,kBAAkB,QAAQ,GAAG,UAAU,SAAS,YAAY,QAAQ,KAAK,CAAC;EAC5G,KAAK,kBAAkB,MAAM;CACjC;;;;;;;;;;;;;;;;;;;;CAqBA,KAAK,KAAa,WAAoB,MAA8B,QAAsB;EACtF,OAAO,IAAI,SAAwB,YAAY;GAC3C,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG,KAAK,CAAC;GACtD,IAAI,UAAU,QACV,QAAQ,MAAR;IACI,KAAK;KACD,UAAU,SAAS,MAAM,EAAE,KAAA,CAAS,CAAC;KACrC,UAAU,SAAS;KACnB;IACJ,KAAK,UACD,MAAM,IAAI,MAAM,oCAAoC,KAAK;GACjE;GAGJ,UAAU,KAAK,OAAO;GACtB,KAAK,kBAAkB,IAAI,KAAK,SAAS;GACzC,IAAI,aAAa,MACb,iBACU;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,SACJ;GAGJ,IAAI,QACA,OAAO,iBACH,eACM;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,EAAE,MAAM,KAAK,CACjB;EAER,CAAC;CACL;;;;;;;;;;;;;;CAeA,cAAc,KAAa,WAAoB,QAAsB;EACjE,OAAO,KAAK,KAAK,KAAK,WAAW,UAAU,MAAM;CACrD;;;;;;;;;;;;;;;CAgBA,WAAW,KAAa,WAAoB,QAAsB;EAC9D,OAAO,KAAK,KAAK,KAAK,WAAW,YAAY,MAAM;CACvD;AACJ"}
+{"version":3,"file":"event-awaiter.js","names":[],"sources":["../src/event-awaiter.ts"],"sourcesContent":["/**\n * An asynchronous keyed event rendezvous for one or more waiting consumers.\n *\n * @remarks\n * Triggers resolve the currently registered waiters; values are not retained for future waits.\n * Timeouts and subsequent abort events resolve affected waiters with `undefined`.\n * Use `triggerAll` to resolve pending waits during cleanup. Timers and abort listeners are not proactively\n * removed by triggers, so they may remain until their timeout or abort event occurs.\n *\n * @typeParam T - The value delivered to waiting consumers.\n */\nexport class EventAwaiter<T> {\n    // Private instance properties\n    #promiseResolvers = new Map<string, Array<(value: PromiseLike<T | undefined> | T | undefined) => void>>();\n\n    // Public instance methods\n\n    /**\n     * Resolves all currently pending waits for a key with the supplied value.\n     *\n     * @param key - The event identifier; a key without pending waits has no effect.\n     * @param value - The delivered value; `undefined` indicates no result.\n     */\n    trigger(key: string, value: T | undefined) {\n        const resolvers = this.#promiseResolvers.get(key);\n        if (resolvers) {\n            this.#promiseResolvers.delete(key);\n            resolvers?.forEach((resolve) => resolve(value));\n        }\n    }\n\n    /**\n     * Resolves all currently pending waits and clears their registrations.\n     *\n     * @param value - The delivered value; omission resolves all pending waits with `undefined`.\n     */\n    triggerAll(value: T | undefined = undefined) {\n        for (const [_, resolvers] of this.#promiseResolvers.entries()) resolvers.forEach((resolve) => resolve(value));\n        this.#promiseResolvers.clear();\n    }\n\n    /**\n     * Waits for a trigger associated with a key.\n     *\n     * @remarks\n     * By default, multiple waiters share a key and all receive the next trigger value.\n     * `strict` mode rejects duplicate waits; `override` mode resolves existing waits with `undefined` before\n     * registering the new wait. Timeout and abort remove only the affected waiter's registration.\n     * An already aborted signal is not checked; only an abort event emitted after registration ends the wait.\n     * Without a timeout or subsequent abort, the wait remains pending until a trigger arrives.\n     *\n     * @param key - The event identifier to wait for.\n     * @param timeoutMs - The optional timeout in milliseconds, using native `setTimeout` timing rules.\n     * @param mode - The policy for existing waiters; omission allows multiple waiters.\n     * @param signal - A signal whose subsequent abort event ends this wait.\n     *\n     * @returns A promise resolving to the triggered value, or `undefined` after timeout, abort, or replacement.\n     *\n     * @throws Error through promise rejection if `strict` mode encounters an existing waiter.\n     */\n    async wait(key: string, timeoutMs?: number, mode?: 'override' | 'strict', signal?: AbortSignal) {\n        return await new Promise<T | undefined>((resolve) => {\n            const resolvers = this.#promiseResolvers.get(key) || [];\n            if (resolvers.length) {\n                switch (mode) {\n                    case 'override':\n                        resolvers.forEach((r) => r(undefined));\n                        resolvers.length = 0;\n                        break;\n                    case 'strict':\n                        throw new Error(`Duplicate wait detected for key: ${key}`);\n                    case undefined:\n                        break;\n                }\n            }\n\n            resolvers.push(resolve);\n            this.#promiseResolvers.set(key, resolvers);\n            if (timeoutMs != null) {\n                setTimeout(\n                    () => {\n                        const resolvers = this.#promiseResolvers.get(key);\n                        if (resolvers?.includes(resolve)) {\n                            resolve(undefined);\n                            const newResolvers = resolvers.filter((r) => r !== resolve);\n                            if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n                            else this.#promiseResolvers.delete(key);\n                        }\n                    },\n                    timeoutMs,\n                );\n            }\n\n            if (signal) {\n                signal.addEventListener(\n                    'abort',\n                    () => {\n                        const resolvers = this.#promiseResolvers.get(key);\n                        if (resolvers?.includes(resolve)) {\n                            resolve(undefined);\n                            const newResolvers = resolvers.filter((r) => r !== resolve);\n                            if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n                            else this.#promiseResolvers.delete(key);\n                        }\n                    },\n                    { once: true },\n                );\n            }\n        });\n    }\n\n    /**\n     * Waits for a key while rejecting duplicate registrations.\n     *\n     * @param key - The event identifier to wait for.\n     * @param timeoutMs - The optional timeout in milliseconds.\n     * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n     *\n     * @returns A promise resolving to the triggered value, or `undefined` on timeout or subsequent abort.\n     *\n     * @throws Error through promise rejection if the key already has a pending waiter.\n     *\n     * @see {@link EventAwaiter.wait}\n     */\n    async waitExclusive(key: string, timeoutMs?: number, signal?: AbortSignal) {\n        return await this.wait(key, timeoutMs, 'strict', signal);\n    }\n\n    /**\n     * Replaces existing waiters for a key and waits for its next trigger.\n     *\n     * @remarks\n     * Existing waiters resolve with `undefined` before the new waiter is registered.\n     *\n     * @param key - The event identifier to wait for.\n     * @param timeoutMs - The optional timeout in milliseconds.\n     * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n     *\n     * @returns A promise resolving to the triggered value, or `undefined` on timeout, subsequent abort, or replacement.\n     *\n     * @see {@link EventAwaiter.wait}\n     */\n    async waitLatest(key: string, timeoutMs?: number, signal?: AbortSignal) {\n        return await this.wait(key, timeoutMs, 'override', signal);\n    }\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,eAAb,MAA6B;CAEzB,oCAAoB,IAAI,IAAgF;;;;;;;CAUxG,QAAQ,KAAa,OAAsB;EACvC,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;EAChD,IAAI,WAAW;GACX,KAAK,kBAAkB,OAAO,GAAG;GACjC,WAAW,SAAS,YAAY,QAAQ,KAAK,CAAC;EAClD;CACJ;;;;;;CAOA,WAAW,QAAuB,KAAA,GAAW;EACzC,KAAK,MAAM,CAAC,GAAG,cAAc,KAAK,kBAAkB,QAAQ,GAAG,UAAU,SAAS,YAAY,QAAQ,KAAK,CAAC;EAC5G,KAAK,kBAAkB,MAAM;CACjC;;;;;;;;;;;;;;;;;;;;CAqBA,MAAM,KAAK,KAAa,WAAoB,MAA8B,QAAsB;EAC5F,OAAO,MAAM,IAAI,SAAwB,YAAY;GACjD,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG,KAAK,CAAC;GACtD,IAAI,UAAU,QACV,QAAQ,MAAR;IACI,KAAK;KACD,UAAU,SAAS,MAAM,EAAE,KAAA,CAAS,CAAC;KACrC,UAAU,SAAS;KACnB;IACJ,KAAK,UACD,MAAM,IAAI,MAAM,oCAAoC,KAAK;IAC7D,KAAK,KAAA;GAET;GAGJ,UAAU,KAAK,OAAO;GACtB,KAAK,kBAAkB,IAAI,KAAK,SAAS;GACzC,IAAI,aAAa,MACb,iBACU;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,SACJ;GAGJ,IAAI,QACA,OAAO,iBACH,eACM;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,EAAE,MAAM,KAAK,CACjB;EAER,CAAC;CACL;;;;;;;;;;;;;;CAeA,MAAM,cAAc,KAAa,WAAoB,QAAsB;EACvE,OAAO,MAAM,KAAK,KAAK,KAAK,WAAW,UAAU,MAAM;CAC3D;;;;;;;;;;;;;;;CAgBA,MAAM,WAAW,KAAa,WAAoB,QAAsB;EACpE,OAAO,MAAM,KAAK,KAAK,KAAK,WAAW,YAAY,MAAM;CAC7D;AACJ"}

package/dist/general.d.ts

@@ -1,3 +1,4 @@
+import { Arrayable } from "type-fest";
 /**
  * Returns the first array element or the input value, with a nullish fallback.
  *
@@ -29,6 +30,6 @@
  * console.log(extractFirstValue(undefined, 'fallback')); // => 'fallback'
  * ```
  */
-export declare function extractFirstValue<T>(value: T | T[]): T | undefined;
-export declare function extractFirstValue<T, D>(value: T | T[], defaultValue: D): D | NonNullable<T>;
+export declare function extractFirstValue<T>(value: Arrayable<T>): T | undefined;
+export declare function extractFirstValue<T, D>(value: Arrayable<T>, defaultValue: D): D | NonNullable<T>;
 //# sourceMappingURL=general.d.ts.map