@checkdigit/time 4.0.0 → 5.0.0-PR.21-7813

package/dist-types/date-fns/lastDayOfDecade/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link lastDayOfDecade} function options.
+ */
+export interface LastDayOfDecadeOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name lastDayOfDecade
  * @category Decade Helpers
@@ -6,9 +12,11 @@
  * @description
  * Return the last day of a decade for the given date.
  *
- * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows using extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type; inferred from arguments or specified by context.
  *
  * @param date - The original date
+ * @param options - The options
  *
  * @returns The last day of a decade
  *
@@ -17,4 +25,4 @@
  * const result = lastDayOfDecade(new Date(2012, 11, 21, 21, 12, 00))
  * //=> Wed Dec 31 2019 00:00:00
  */
-export declare function lastDayOfDecade<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function lastDayOfDecade<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfDecadeOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/lastDayOfISOWeek/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link lastDayOfISOWeek} function options.
+ */
+export interface LastDayOfISOWeekOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name lastDayOfISOWeek
  * @category ISO Week Helpers
@@ -9,9 +15,11 @@
  *
  * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
  *
- * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam DateType - The Date type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [UTCDate](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The original date
+ * @param options - An object with options
  *
  * @returns The last day of an ISO week
  *
@@ -20,4 +28,4 @@
  * const result = lastDayOfISOWeek(new Date(2014, 8, 2, 11, 55, 0))
  * //=> Sun Sep 07 2014 00:00:00
  */
-export declare function lastDayOfISOWeek<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function lastDayOfISOWeek<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfISOWeekOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/lastDayOfISOWeekYear/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link lastDayOfISOWeekYear} function options.
+ */
+export interface LastDayOfISOWeekYearOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name lastDayOfISOWeekYear
  * @category ISO Week-Numbering Year Helpers
@@ -11,8 +17,10 @@
  * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The original date
+ * @param options - An object with options
  *
  * @returns The end of an ISO week-numbering year
  *
@@ -21,4 +29,4 @@
  * const result = lastDayOfISOWeekYear(new Date(2005, 6, 2))
  * //=> Sun Jan 01 2006 00:00:00
  */
-export declare function lastDayOfISOWeekYear<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function lastDayOfISOWeekYear<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfISOWeekYearOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/lastDayOfMonth/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link lastDayOfMonth} function options.
+ */
+export interface LastDayOfMonthOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name lastDayOfMonth
  * @category Month Helpers
@@ -8,8 +14,10 @@
  * The result will be in the local timezone.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The original date
+ * @param options - An object with options
  *
  * @returns The last day of a month
  *
@@ -18,4 +26,4 @@
  * const result = lastDayOfMonth(new Date(2014, 8, 2, 11, 55, 0))
  * //=> Tue Sep 30 2014 00:00:00
  */
-export declare function lastDayOfMonth<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function lastDayOfMonth<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfMonthOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/lastDayOfQuarter/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link lastDayOfQuarter} function options.
+ */
+export interface LastDayOfQuarterOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name lastDayOfQuarter
  * @category Quarter Helpers
@@ -8,8 +14,10 @@
  * The result will be in the local timezone.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The original date
+ * @param options - The options
  *
  * @returns The last day of a quarter
  *
@@ -18,4 +26,4 @@
  * const result = lastDayOfQuarter(new Date(2014, 8, 2, 11, 55, 0))
  * //=> Tue Sep 30 2014 00:00:00
  */
-export declare function lastDayOfQuarter<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function lastDayOfQuarter<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfQuarterOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/lastDayOfWeek/index.d.ts

@@ -1,8 +1,8 @@
-import type { LocalizedOptions, WeekOptions } from '../types';
+import type { ContextOptions, DateArg, LocalizedOptions, WeekOptions } from '../types.ts';
 /**
  * The {@link lastDayOfWeek} function options.
  */
-export interface LastDayOfWeekOptions extends LocalizedOptions<'options'>, WeekOptions {
+export interface LastDayOfWeekOptions<DateType extends Date = Date> extends LocalizedOptions<'options'>, WeekOptions, ContextOptions<DateType> {
 }
 /**
  * @name lastDayOfWeek
@@ -11,23 +11,14 @@ export interface LastDayOfWeekOptions extends LocalizedOptions<'options'>, WeekO
  *
  * @description
  * Return the last day of a week for the given date.
- * The result will be in the local timezone.
+ * The result will be in the local timezone unless a context is specified.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The original date
  * @param options - An object with options
  *
  * @returns The last day of a week
- *
- * @example
- * // The last day of a week for 2 September 2014 11:55:00:
- * const result = lastDayOfWeek(new Date(2014, 8, 2, 11, 55, 0))
- * //=> Sat Sep 06 2014 00:00:00
- *
- * @example
- * // If the week starts on Monday, the last day of the week for 2 September 2014 11:55:00:
- * const result = lastDayOfWeek(new Date(2014, 8, 2, 11, 55, 0), { weekStartsOn: 1 })
- * //=> Sun Sep 07 2014 00:00:00
  */
-export declare function lastDayOfWeek<DateType extends Date>(date: DateType | number | string, options?: LastDayOfWeekOptions): DateType;
+export declare function lastDayOfWeek<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfWeekOptions<ResultDate>): ResultDate;

package/dist-types/date-fns/lastDayOfYear/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link lastDayOfYear} function options.
+ */
+export interface LastDayOfYearOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name lastDayOfYear
  * @category Year Helpers
@@ -8,8 +14,10 @@
  * The result will be in the local timezone.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The original date
+ * @param options - An object with options
  *
  * @returns The last day of a year
  *
@@ -18,4 +26,4 @@
  * const result = lastDayOfYear(new Date(2014, 8, 2, 11, 55, 00))
  * //=> Wed Dec 31 2014 00:00:00
  */
-export declare function lastDayOfYear<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function lastDayOfYear<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: LastDayOfYearOptions<ResultDate>): ResultDate;

package/dist-types/date-fns/lightFormat/index.d.ts

@@ -1,4 +1,5 @@
-import { lightFormatters } from '../_lib/format/lightFormatters/index';
+import { lightFormatters } from '../_lib/format/lightFormatters/index.ts';
+import type { DateArg } from '../types.ts';
 export { lightFormatters };
 /**
  * @name lightFormat
@@ -45,8 +46,6 @@ export { lightFormatters };
  * |                                 | SSS     | 000, 001, ..., 999                |
  * |                                 | SSSS    | ...                               |
  *
- * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
- *
  * @param date - The original date
  * @param format - The string of tokens
  *
@@ -59,4 +58,4 @@ export { lightFormatters };
  * const result = lightFormat(new Date(2014, 1, 11), 'yyyy-MM-dd')
  * //=> '2014-02-11'
  */
-export declare function lightFormat<DateType extends Date>(date: DateType | number | string, formatStr: string): string;
+export declare function lightFormat(date: DateArg<Date> & {}, formatStr: string): string;

package/dist-types/date-fns/locale/_lib/buildFormatLongFn/index.d.ts

@@ -1,4 +1,4 @@
-import type { FormatLongFn, FormatLongWidth } from '../../types';
+import type { FormatLongFn, FormatLongWidth } from '../../types.ts';
 export interface BuildFormatLongFnArgs<DefaultMatchWidth extends FormatLongWidth> {
     formats: Partial<{
         [format in FormatLongWidth]: string;

package/dist-types/date-fns/locale/_lib/buildLocalizeFn/index.d.ts

@@ -1,5 +1,5 @@
-import type { Day, Era, Month, Quarter } from '../../../types';
-import type { LocaleDayPeriod, LocaleUnitValue, LocaleWidth, LocalizeFn } from '../../types';
+import type { Day, Era, Month, Quarter } from '../../../types.ts';
+import type { LocaleDayPeriod, LocaleUnitValue, LocaleWidth, LocalizeFn } from '../../types.ts';
 export type BuildLocalizeFnArgs<Value extends LocaleUnitValue, ArgCallback extends LocalizeFnArgCallback<Value> | undefined> = {
     values: LocalizePeriodValuesMap<Value>;
     defaultWidth: LocaleWidth;

package/dist-types/date-fns/locale/_lib/buildMatchFn/index.d.ts

@@ -1,5 +1,5 @@
-import type { Quarter, Era, Day, Month } from '../../../types';
-import type { LocaleUnitValue, LocaleWidth, LocaleDayPeriod, MatchFn, MatchValueCallback } from '../../types';
+import type { Quarter, Era, Day, Month } from '../../../types.ts';
+import type { LocaleUnitValue, LocaleWidth, LocaleDayPeriod, MatchFn, MatchValueCallback } from '../../types.ts';
 export interface BuildMatchFnArgs<Result extends LocaleUnitValue, DefaultMatchWidth extends LocaleWidth, DefaultParseWidth extends LocaleWidth> {
     matchPatterns: BuildMatchFnMatchPatterns<DefaultMatchWidth>;
     defaultMatchWidth: DefaultMatchWidth;

package/dist-types/date-fns/locale/_lib/buildMatchPatternFn/index.d.ts

@@ -1,4 +1,4 @@
-import type { MatchFn, MatchValueCallback } from '../../types';
+import type { MatchFn, MatchValueCallback } from '../../types.ts';
 export interface BuildMatchPatternFnArgs<Result> {
     matchPattern: RegExp;
     parsePattern: RegExp;

package/dist-types/date-fns/locale/en-US/_lib/formatDistance/index.d.ts

@@ -1,2 +1,2 @@
-import type { FormatDistanceFn } from '../../../types';
+import type { FormatDistanceFn } from '../../../types.ts';
 export declare const formatDistance: FormatDistanceFn;

package/dist-types/date-fns/locale/en-US/_lib/formatLong/index.d.ts

@@ -1,2 +1,2 @@
-import type { FormatLong } from '../../../types';
+import type { FormatLong } from '../../../types.ts';
 export declare const formatLong: FormatLong;

package/dist-types/date-fns/locale/en-US/_lib/formatRelative/index.d.ts

@@ -1,2 +1,2 @@
-import type { FormatRelativeFn } from '../../../types';
+import type { FormatRelativeFn } from '../../../types.ts';
 export declare const formatRelative: FormatRelativeFn;

package/dist-types/date-fns/locale/en-US/_lib/localize/index.d.ts

@@ -1,2 +1,2 @@
-import type { Localize } from '../../../types';
+import type { Localize } from '../../../types.ts';
 export declare const localize: Localize;

package/dist-types/date-fns/locale/en-US/_lib/match/index.d.ts

@@ -1,2 +1,2 @@
-import type { Match } from '../../../types';
+import type { Match } from '../../../types.ts';
 export declare const match: Match;

package/dist-types/date-fns/locale/en-US/index.d.ts

@@ -1,4 +1,4 @@
-import type { Locale } from '../types';
+import type { Locale } from '../types.ts';
 /**
  * @category Locales
  * @summary English locale (United States).

package/dist-types/date-fns/locale/index.d.ts

@@ -1,2 +1,2 @@
-export * from './en-US/index';
-export type * from './types';
+export * from './en-US/index.ts';
+export type * from './types.ts';

package/dist-types/date-fns/locale/types.d.ts

@@ -1,4 +1,4 @@
-import type { Day, Era, FirstWeekContainsDateOptions, LocalizedOptions, Month, Quarter, WeekOptions } from '../types';
+import type { DateArg, Day, Era, FirstWeekContainsDateOptions, LocalizedOptions, Month, Quarter, WeekOptions } from '../types.ts';
 /**
  * The locale object with all functions and data needed to parse and format
  * dates. This is what each locale implements and exports.
@@ -102,7 +102,7 @@ export interface FormatRelativeFnOptions extends WeekOptions, LocalizedOptions<'
  * @param baseDate - The date to compare with
  * @param options - The object with options
  */
-export type FormatRelativeTokenFn = <DateType extends Date>(date: DateType | number | string, baseDate: DateType | number | string, options?: FormatRelativeTokenFnOptions) => string;
+export type FormatRelativeTokenFn = <DateType extends Date>(date: DateArg<DateType>, baseDate: DateArg<DateType>, options?: FormatRelativeTokenFnOptions) => string;
 /**
  * The {@link FormatRelativeTokenFn} function options.
  */
@@ -278,7 +278,7 @@ export type FormatLongWidth = 'full' | 'long' | 'medium' | 'short' | 'any';
 export type LocaleUnitValue = Era | Quarter | Month | Day | LocaleDayPeriod;
 /**
  * The format width. Defines how short or long the formatted string might be.
- * The actaul result length depends on the locale.
+ * The actual result length depends on the locale.
  */
 export type LocaleWidth = 'narrow' | 'short' | 'abbreviated' | 'wide' | 'any';
 /**

package/dist-types/date-fns/max/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link max} function options.
+ */
+export interface MaxOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name max
  * @category Common Helpers
@@ -7,6 +13,7 @@
  * Return the latest of the given dates.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param dates - The dates to compare
  *
@@ -22,4 +29,4 @@
  * ])
  * //=> Sun Jul 02 1995 00:00:00
  */
-export declare function max<DateType extends Date>(dates: Array<DateType | number | string>): DateType | Date;
+export declare function max<DateType extends Date, ResultDate extends Date = DateType>(dates: DateArg<DateType>[], options?: MaxOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/milliseconds/index.d.ts

@@ -1,4 +1,4 @@
-import type { Duration } from '../types';
+import type { Duration } from '../types.ts';
 /**
  * @name milliseconds
  * @category Millisecond Helpers
@@ -10,7 +10,7 @@ import type { Duration } from '../types';
  *
  * One years equals 365.2425 days according to the formula:
  *
- * > Leap year occures every 4 years, except for years that are divisable by 100 and not divisable by 400.
+ * > Leap year occurs every 4 years, except for years that are divisible by 100 and not divisible by 400.
  * > 1 mean year = (365+1/4-1/100+1/400) days = 365.2425 days
  *
  * One month is a year divided by 12.

package/dist-types/date-fns/millisecondsToSeconds/index.d.ts

@@ -11,7 +11,7 @@
  * @returns The number of milliseconds converted in seconds
  *
  * @example
- * // Convert 1000 miliseconds to seconds:
+ * // Convert 1000 milliseconds to seconds:
  * const result = millisecondsToSeconds(1000)
  * //=> 1
  *

package/dist-types/date-fns/min/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link min} function options.
+ */
+export interface MinOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name min
  * @category Common Helpers
@@ -7,6 +13,7 @@
  * Returns the earliest of the given dates.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param dates - The dates to compare
  *
@@ -22,4 +29,4 @@
  * ])
  * //=> Wed Feb 11 1987 00:00:00
  */
-export declare function min<DateType extends Date>(dates: Array<DateType | number | string>): DateType | Date;
+export declare function min<DateType extends Date, ResultDate extends Date = DateType>(dates: Array<DateArg<DateType>>, options?: MinOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/nextDay/index.d.ts

@@ -1,18 +1,22 @@
-import type { Day } from '../types';
+import type { ContextOptions, DateArg, Day } from '../types.ts';
+/**
+ * The {@link nextDay} function options.
+ */
+export interface NextDayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextDay
  * @category Weekday Helpers
- * @summary When is the next day of the week?
- *
- * @description
- * When is the next day of the week? 0-6 the day of the week, 0 represents Sunday.
+ * @summary When is the next day of the week? 0-6 the day of the week, 0 represents Sunday.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to check
- * @param day - day of the week
+ * @param day - Day of the week
+ * @param options - An object with options
  *
- * @returns The date is the next day of week
+ * @returns The date is the next day of the week
  *
  * @example
  * // When is the next Monday after Mar, 20, 2020?
@@ -24,4 +28,4 @@ import type { Day } from '../types';
  * const result = nextDay(new Date(2020, 2, 21), 2)
  * //=> Tue Mar 24 2020 00:00:00
  */
-export declare function nextDay<DateType extends Date>(date: DateType | number | string, day: Day): DateType;
+export declare function nextDay<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, day: Day, options?: NextDayOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/nextFriday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextFriday} function options.
+ */
+export interface NextFridayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextFriday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the next Friday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Friday
  *
@@ -17,4 +25,4 @@
  * const result = nextFriday(new Date(2020, 2, 22))
  * //=> Fri Mar 27 2020 00:00:00
  */
-export declare function nextFriday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextFriday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextFridayOptions<ResultDate>): ResultDate;

package/dist-types/date-fns/nextMonday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextMonday} function options.
+ */
+export interface NextMondayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextMonday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the next Monday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, returned from the context function if passed, or inferred from the arguments.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Monday
  *
@@ -17,4 +25,4 @@
  * const result = nextMonday(new Date(2020, 2, 22))
  * //=> Mon Mar 23 2020 00:00:00
  */
-export declare function nextMonday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextMonday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextMondayOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/nextSaturday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextSaturday} function options.
+ */
+export interface NextSaturdayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextSaturday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the next Saturday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Saturday
  *
@@ -17,4 +25,4 @@
  * const result = nextSaturday(new Date(2020, 2, 22))
  * //=> Sat Mar 28 2020 00:00:00
  */
-export declare function nextSaturday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextSaturday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextSaturdayOptions<ResultDate>): ResultDate;

package/dist-types/date-fns/nextSunday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextSunday} function options.
+ */
+export interface NextSundayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextSunday
  * @category Weekday Helpers
@@ -7,14 +13,16 @@
  * When is the next Sunday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned if a context is provided.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Sunday
  *
  * @example
- * // When is the next Sunday after Mar, 22, 2020?
+ * // When is the next Sunday after March 22, 2020?
  * const result = nextSunday(new Date(2020, 2, 22))
  * //=> Sun Mar 29 2020 00:00:00
  */
-export declare function nextSunday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextSunday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextSundayOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/nextThursday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextThursday} function options.
+ */
+export interface NextThursdayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextThursday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the next Thursday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Thursday
  *
@@ -17,4 +25,4 @@
  * const result = nextThursday(new Date(2020, 2, 22))
  * //=> Thur Mar 26 2020 00:00:00
  */
-export declare function nextThursday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextThursday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextThursdayOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/nextTuesday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextTuesday} function options.
+ */
+export interface NextTuesdayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextTuesday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the next Tuesday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Tuesday
  *
@@ -17,4 +25,4 @@
  * const result = nextTuesday(new Date(2020, 2, 22))
  * //=> Tue Mar 24 2020 00:00:00
  */
-export declare function nextTuesday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextTuesday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextTuesdayOptions<ResultDate>): ResultDate;

package/dist-types/date-fns/nextWednesday/index.d.ts

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link nextWednesday} function options.
+ */
+export interface NextWednesdayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name nextWednesday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the next Wednesday?
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to start counting from
+ * @param options - An object with options
  *
  * @returns The next Wednesday
  *
@@ -17,4 +25,4 @@
  * const result = nextWednesday(new Date(2020, 2, 22))
  * //=> Wed Mar 25 2020 00:00:00
  */
-export declare function nextWednesday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function nextWednesday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: NextWednesdayOptions<ResultDate> | undefined): ResultDate;

package/dist-types/date-fns/parse/_lib/Parser.d.ts

@@ -1,6 +1,6 @@
-import type { Match } from '../../locale/types';
-import { ValueSetter } from './Setter';
-import type { ParseFlags, ParseResult, ParserOptions } from './types';
+import type { Match } from '../../locale/types.ts';
+import { ValueSetter } from './Setter.ts';
+import type { ParseFlags, ParseResult, ParserOptions } from './types.ts';
 export declare abstract class Parser<Value> {
     abstract incompatibleTokens: string[] | '*';
     abstract priority: number;