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

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

@@ -1,21 +1,24 @@
-import type { ParseFlags, ParserOptions } from './types';
+import type { ContextFn, DateArg } from '../../types.ts';
+import type { ParseFlags, ParserOptions } from './types.ts';
 export declare abstract class Setter {
     abstract priority: number;
     subPriority: number;
     validate<DateType extends Date>(_utcDate: DateType, _options?: ParserOptions): boolean;
-    abstract set<DateType extends Date>(utcDate: DateType, flags: ParseFlags, options: ParserOptions): DateType | [DateType, ParseFlags];
+    abstract set<DateType extends Date>(date: DateType, flags: ParseFlags, options: ParserOptions): DateType | [DateType, ParseFlags];
 }
 export declare class ValueSetter<Value> extends Setter {
     private value;
     private validateValue;
     private setValue;
     priority: number;
-    constructor(value: Value, validateValue: <DateType extends Date>(utcDate: DateType, value: Value, options: ParserOptions) => boolean, setValue: <DateType extends Date>(utcDate: DateType, flags: ParseFlags, value: Value, options: ParserOptions) => DateType | [DateType, ParseFlags], priority: number, subPriority?: number);
+    constructor(value: Value, validateValue: <DateType extends Date>(date: DateType, value: Value, options: ParserOptions) => boolean, setValue: <DateType extends Date>(date: DateType, flags: ParseFlags, value: Value, options: ParserOptions) => DateType | [DateType, ParseFlags], priority: number, subPriority?: number);
     validate<DateType extends Date>(date: DateType, options: ParserOptions): boolean;
     set<DateType extends Date>(date: DateType, flags: ParseFlags, options: ParserOptions): DateType | [DateType, ParseFlags];
 }
-export declare class DateToSystemTimezoneSetter extends Setter {
+export declare class DateTimezoneSetter extends Setter {
     priority: number;
     subPriority: number;
+    context: ContextFn<Date>;
+    constructor(context: ContextFn<Date> | undefined, reference: DateArg<Date> & {});
     set<DateType extends Date>(date: DateType, flags: ParseFlags): DateType;
 }

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

@@ -1,6 +1,6 @@
-import type { LocaleDayPeriod, Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { LocaleDayPeriod, Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class AMPMMidnightParser extends Parser<LocaleDayPeriod> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<LocaleDayPeriod>;

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

@@ -1,6 +1,6 @@
-import type { LocaleDayPeriod, Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { LocaleDayPeriod, Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class AMPMParser extends Parser<LocaleDayPeriod> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<LocaleDayPeriod>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class DateParser extends Parser<number> {
     priority: number;
     subPriority: number;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class DayOfYearParser extends Parser<number> {
     priority: number;
     subpriority: number;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult, ParserOptions } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult, ParserOptions } from '../types.ts';
 export declare class DayParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { LocaleDayPeriod, Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { LocaleDayPeriod, Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class DayPeriodParser extends Parser<LocaleDayPeriod> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<LocaleDayPeriod>;

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

@@ -1,7 +1,7 @@
-import type { Match } from '../../../locale/types';
-import type { Era } from '../../../types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import type { Era } from '../../../types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class EraParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<Era>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class ExtendedYearParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string): ParseResult<number>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class FractionOfSecondParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class Hour0To11Parser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class Hour0to23Parser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class Hour1To24Parser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class Hour1to12Parser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class ISODayParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class ISOTimezoneParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string): ParseResult<number>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class ISOTimezoneWithZParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class ISOWeekParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class ISOWeekYearParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult, ParserOptions } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult, ParserOptions } from '../types.ts';
 export declare class LocalDayParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match, options: ParserOptions): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult, ParserOptions } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult, ParserOptions } from '../types.ts';
 export declare class LocalWeekParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,7 +1,7 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult, ParserOptions } from '../types';
-import type { YearParserValue } from './YearParser';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult, ParserOptions } from '../types.ts';
+import type { YearParserValue } from './YearParser.ts';
 export declare class LocalWeekYearParser extends Parser<YearParserValue> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<YearParserValue>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class MinuteParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class MonthParser extends Parser<number> {
     incompatibleTokens: string[];
     priority: number;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class QuarterParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class SecondParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult, ParserOptions } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult, ParserOptions } from '../types.ts';
 export declare class StandAloneLocalDayParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match, options: ParserOptions): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class StandAloneMonthParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class StandAloneQuarterParser extends Parser<number> {
     priority: number;
     parse(dateString: string, token: string, match: Match): ParseResult<number>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class TimestampMillisecondsParser extends Parser<number> {
     priority: number;
     parse(dateString: string): ParseResult<number>;

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

@@ -1,5 +1,5 @@
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export declare class TimestampSecondsParser extends Parser<number> {
     priority: number;
     parse(dateString: string): ParseResult<number>;

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

@@ -1,6 +1,6 @@
-import type { Match } from '../../../locale/types';
-import { Parser } from '../Parser';
-import type { ParseFlags, ParseResult } from '../types';
+import type { Match } from '../../../locale/types.ts';
+import { Parser } from '../Parser.ts';
+import type { ParseFlags, ParseResult } from '../types.ts';
 export interface YearParserValue {
     year: number;
     isTwoDigitYear: boolean;

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

@@ -1,2 +1,2 @@
-import type { Parser } from '../Parser';
+import type { Parser } from '../Parser.ts';
 export declare const parsers: Record<string, Parser<any>>;

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

@@ -1,4 +1,4 @@
-import type { LocalizedOptions, FirstWeekContainsDateOptions, WeekOptions } from '../../types';
+import type { LocalizedOptions, FirstWeekContainsDateOptions, WeekOptions } from '../../types.ts';
 export interface ParseFlags {
     timestampIsSet?: boolean;
     era?: number;

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

@@ -1,5 +1,5 @@
-import type { LocaleDayPeriod } from '../../locale/types';
-import type { ParseResult } from './types';
+import type { LocaleDayPeriod } from '../../locale/types.ts';
+import type { ParseResult } from './types.ts';
 export declare function mapValue<TInput, TResult>(parseFnResult: ParseResult<TInput>, mapFn: (value: TInput) => TResult): ParseResult<TResult>;
 export declare function parseNumericPattern(pattern: RegExp, dateString: string): ParseResult<number>;
 export declare function parseTimezonePattern(pattern: RegExp, dateString: string): ParseResult<number>;

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

@@ -1,11 +1,11 @@
-import type { AdditionalTokensOptions, FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types';
-import { longFormatters } from '../_lib/format/longFormatters/index';
-import { parsers } from './_lib/parsers/index';
+import { longFormatters } from '../_lib/format/longFormatters/index.ts';
+import type { AdditionalTokensOptions, ContextOptions, DateArg, FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types.ts';
+import { parsers } from './_lib/parsers/index.ts';
 export { longFormatters, parsers };
 /**
  * The {@link parse} function options.
  */
-export interface ParseOptions extends LocalizedOptions<'options' | 'match' | 'formatLong'>, FirstWeekContainsDateOptions, WeekOptions, AdditionalTokensOptions {
+export interface ParseOptions<DateType extends Date = Date> extends LocalizedOptions<'options' | 'match' | 'formatLong'>, FirstWeekContainsDateOptions, WeekOptions, AdditionalTokensOptions, ContextOptions<DateType> {
 }
 /**
  * @name parse
@@ -192,7 +192,7 @@ export interface ParseOptions extends LocalizedOptions<'options' | 'match' | 'fo
  *
  *    `format(new Date(2017, 10, 6), 'do MMMM', {locale: cs}) //=> '6. listopadu'`
  *
- *    `parse` will try to match both formatting and stand-alone units interchangably.
+ *    `parse` will try to match both formatting and stand-alone units interchangeably.
  *
  * 2. Any sequence of the identical letters is a pattern, unless it is escaped by
  *    the single quote characters (see below).
@@ -241,7 +241,7 @@ export interface ParseOptions extends LocalizedOptions<'options' | 'match' | 'fo
  * 6. `YY` and `YYYY` tokens represent week-numbering years but they are often confused with years.
  *    You should enable `options.useAdditionalWeekYearTokens` to use them. See: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
  *
- * 7. `D` and `DD` tokens represent days of the year but they are ofthen confused with days of the month.
+ * 7. `D` and `DD` tokens represent days of the year but they are often confused with days of the month.
  *    You should enable `options.useAdditionalDayOfYearTokens` to use them. See: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
  *
  * 8. `P+` tokens do not have a defined priority since they are merely aliases to other tokens based
@@ -274,6 +274,7 @@ export interface ParseOptions extends LocalizedOptions<'options' | 'match' | 'fo
  * Time value of Date: http://es5.github.io/#x15.9.1.1
  *
  * @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 dateStr - The string to parse
  * @param formatStr - The string of tokens
@@ -304,4 +305,4 @@ export interface ParseOptions extends LocalizedOptions<'options' | 'match' | 'fo
  * })
  * //=> Sun Feb 28 2010 00:00:00
  */
-export declare function parse<DateType extends Date>(dateStr: string, formatStr: string, referenceDate: DateType | number | string, options?: ParseOptions): DateType;
+export declare function parse<DateType extends Date, ResultDate extends Date = DateType>(dateStr: string, formatStr: string, referenceDate: DateArg<DateType>, options?: ParseOptions<ResultDate>): ResultDate;

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

@@ -1,7 +1,8 @@
+import type { ContextOptions } from '../types.ts';
 /**
  * The {@link parseISO} function options.
  */
-export interface ParseISOOptions {
+export interface ParseISOOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
     /** The additional number of digits in the extended year format */
     additionalDigits?: 0 | 1 | 2;
 }
@@ -20,6 +21,7 @@ export interface ParseISOOptions {
  * the values are invalid, it returns Invalid 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 argument - The value to convert
  * @param options - An object with options
@@ -37,4 +39,4 @@ export interface ParseISOOptions {
  * const result = parseISO('+02014101', { additionalDigits: 1 })
  * //=> Fri Apr 11 2014 00:00:00
  */
-export declare function parseISO(argument: string, options?: ParseISOOptions): Date;
+export declare function parseISO<DateType extends Date, ResultDate extends Date = DateType>(argument: string, options?: ParseISOOptions<ResultDate>): ResultDate;

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

@@ -1,9 +1,10 @@
+import type { ContextOptions } from '../types.ts';
+/**
+ * The {@link parseJSON} function options.
+ */
+export interface ParseJSONOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
- * @name parseJSON
- * @category Common Helpers
- * @summary Parse a JSON date string
- *
- * @description
  * Converts a complete ISO date string in UTC time, the typical format for transmitting
  * a date in JSON, to a JavaScript `Date` instance.
  *
@@ -28,8 +29,11 @@
  *
  * Any other input type or invalid date strings will return an `Invalid Date`.
  *
+ * @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 dateStr - A fully formed ISO8601 date string to convert
+ * @param options - An object with options
  *
  * @returns The parsed date in the local time zone
  */
-export declare function parseJSON(dateStr: string): Date;
+export declare function parseJSON<ResultDate extends Date = Date>(dateStr: string, options?: ParseJSONOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,4 +1,9 @@
-import type { Day } from '../types';
+import type { ContextOptions, DateArg, Day } from '../types.ts';
+/**
+ * The {@link previousDay} function options.
+ */
+export interface PreviousDayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name previousDay
  * @category Weekday Helpers
@@ -8,9 +13,11 @@ import type { Day } from '../types';
  * When is the previous 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 - The day of the week
+ * @param options - An object with options
  *
  * @returns The date is the previous day of week
  *
@@ -24,4 +31,4 @@ import type { Day } from '../types';
  * const result = previousDay(new Date(2020, 2, 21), 2)
  * //=> Tue Mar 17 2020 00:00:00
  */
-export declare function previousDay<DateType extends Date>(date: DateType | number | string, day: Day): DateType;
+export declare function previousDay<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, day: Day, options?: PreviousDayOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link previousFriday} function options.
+ */
+export interface PreviousFridayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name previousFriday
  * @category Weekday Helpers
@@ -6,9 +12,11 @@
  * @description
  * When is the previous 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 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 - The options
  *
  * @returns The previous Friday
  *
@@ -17,4 +25,4 @@
  * const result = previousFriday(new Date(2021, 5, 19))
  * //=> Fri June 18 2021 00:00:00
  */
-export declare function previousFriday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function previousFriday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: PreviousFridayOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link previousMonday} function options.
+ */
+export interface PreviousMondayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name previousMonday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the previous 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, 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 previous Monday
  *
@@ -17,4 +25,4 @@
  * const result = previousMonday(new Date(2021, 5, 18))
  * //=> Mon June 14 2021 00:00:00
  */
-export declare function previousMonday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function previousMonday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: PreviousMondayOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link previousSaturday} function options.
+ */
+export interface PreviousSaturdayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name previousSaturday
  * @category Weekday Helpers
@@ -7,8 +13,10 @@
  * When is the previous 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 - The options
  *
  * @returns The previous Saturday
  *
@@ -17,4 +25,4 @@
  * const result = previousSaturday(new Date(2021, 5, 20))
  * //=> Sat June 19 2021 00:00:00
  */
-export declare function previousSaturday<DateType extends Date>(date: DateType | number | string): DateType;
+export declare function previousSaturday<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: PreviousSaturdayOptions<ResultDate> | undefined): ResultDate;