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

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

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

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

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

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

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

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

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

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

@@ -6,8 +6,6 @@
  * @description
  * Convert a number of quarters to a full number of months.
  *
- * @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 quarters - The number of quarters to be converted
  *
  * @returns The number of quarters converted in months

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

@@ -6,8 +6,6 @@
  * @description
  * Convert a number of quarters to a full number of years.
  *
- * @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 quarters - The number of quarters to be converted
  *
  * @returns The number of quarters converted in years

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

@@ -1,8 +1,8 @@
-import type { NearestHours, NearestToUnitOptions, RoundingOptions } from '../types';
+import type { ContextOptions, DateArg, NearestHours, NearestToUnitOptions, RoundingOptions } from '../types.ts';
 /**
  * The {@link roundToNearestHours} function options.
  */
-export interface RoundToNearestHoursOptions extends NearestToUnitOptions<NearestHours>, RoundingOptions {
+export interface RoundToNearestHoursOptions<DateType extends Date = Date> extends NearestToUnitOptions<NearestHours>, RoundingOptions, ContextOptions<DateType> {
 }
 /**
  * @name roundToNearestHours
@@ -14,6 +14,7 @@ export interface RoundToNearestHoursOptions extends NearestToUnitOptions<Nearest
  * Rounds up when the given date is exactly between the nearest round hours.
  *
  * @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 round
  * @param options - An object with options.
@@ -29,13 +30,13 @@ export interface RoundToNearestHoursOptions extends NearestToUnitOptions<Nearest
  * // Round 10 July 2014 12:34:56 to nearest half hour:
  * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56), { nearestTo: 6 })
  * //=> Thu Jul 10 2014 12:00:00
-
+ *
  * @example
  * // Round 10 July 2014 12:34:56 to nearest half hour:
  * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56), { nearestTo: 8 })
  * //=> Thu Jul 10 2014 16:00:00
-
-* @example
+ *
+ * @example
  * // Floor (rounds down) 10 July 2014 12:34:56 to nearest hour:
  * const result = roundToNearestHours(new Date(2014, 6, 10, 1, 23, 45), { roundingMethod: 'ceil' })
  * //=> Thu Jul 10 2014 02:00:00
@@ -45,4 +46,4 @@ export interface RoundToNearestHoursOptions extends NearestToUnitOptions<Nearest
  * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56), { roundingMethod: 'floor', nearestTo: 8 })
  * //=> Thu Jul 10 2014 08:00:00
  */
-export declare function roundToNearestHours<DateType extends Date>(date: DateType | number | string, options?: RoundToNearestHoursOptions): Date;
+export declare function roundToNearestHours<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: RoundToNearestHoursOptions<ResultDate>): ResultDate;

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

@@ -1,8 +1,8 @@
-import type { NearestMinutes, NearestToUnitOptions, RoundingOptions } from '../types';
+import type { ContextOptions, DateArg, NearestMinutes, NearestToUnitOptions, RoundingOptions } from '../types.ts';
 /**
  * The {@link roundToNearestMinutes} function options.
  */
-export interface RoundToNearestMinutesOptions extends NearestToUnitOptions<NearestMinutes>, RoundingOptions {
+export interface RoundToNearestMinutesOptions<DateType extends Date = Date> extends NearestToUnitOptions<NearestMinutes>, RoundingOptions, ContextOptions<DateType> {
 }
 /**
  * @name roundToNearestMinutes
@@ -14,6 +14,7 @@ export interface RoundToNearestMinutesOptions extends NearestToUnitOptions<Neare
  * Rounds up when the given date is exactly between the nearest round minutes.
  *
  * @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 round
  * @param options - An object with options.
@@ -40,4 +41,4 @@ export interface RoundToNearestMinutesOptions extends NearestToUnitOptions<Neare
  * const result = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34), { roundingMethod: 'ceil', nearestTo: 30 })
  * //=> Thu Jul 10 2014 12:30:00
  */
-export declare function roundToNearestMinutes<DateType extends Date>(date: DateType | number | string, options?: RoundToNearestMinutesOptions): DateType;
+export declare function roundToNearestMinutes<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, options?: RoundToNearestMinutesOptions<ResultDate>): ResultDate;

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

@@ -1,4 +1,9 @@
-import type { DateValues } from '../types';
+import type { ContextOptions, DateArg, DateValues } from '../types.ts';
+/**
+ * The {@link set} function options.
+ */
+export interface SetOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name set
  * @category Common Helpers
@@ -15,9 +20,11 @@ import type { DateValues } from '../types';
  * other `setX` functions that date-fns provides if you are concerned about the bundle size.
  *
  * @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 be changed
  * @param values - The date values to be set
+ * @param options - The options
  *
  * @returns The new date with options set
  *
@@ -31,4 +38,4 @@ import type { DateValues } from '../types';
  * const result = set(new Date(2014, 8, 1, 1, 23, 45), { hours: 12 })
  * //=> Mon Sep 01 2014 12:23:45
  */
-export declare function set<DateType extends Date>(date: DateType | number | string, values: DateValues): DateType;
+export declare function set<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, values: DateValues, options?: SetOptions<ResultDate>): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setDate} function options.
+ */
+export interface SetDateOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setDate
  * @category Day Helpers
@@ -6,10 +12,12 @@
  * @description
  * Set the day of the month to 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, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to be changed
  * @param dayOfMonth - The day of the month of the new date
+ * @param options - The options
  *
  * @returns The new date with the day of the month set
  *
@@ -18,4 +26,4 @@
  * const result = setDate(new Date(2014, 8, 1), 30)
  * //=> Tue Sep 30 2014 00:00:00
  */
-export declare function setDate<DateType extends Date>(date: DateType | number | string, dayOfMonth: number): DateType;
+export declare function setDate<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, dayOfMonth: number, options?: SetDateOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,8 +1,8 @@
-import type { LocalizedOptions, WeekOptions } from '../types';
+import type { ContextOptions, DateArg, LocalizedOptions, WeekOptions } from '../types.ts';
 /**
  * The {@link setDay} function options.
  */
-export interface SetDayOptions extends LocalizedOptions<'options'>, WeekOptions {
+export interface SetDayOptions<DateType extends Date = Date> extends LocalizedOptions<'options'>, WeekOptions, ContextOptions<DateType> {
 }
 /**
  * @name setDay
@@ -13,6 +13,7 @@ export interface SetDayOptions extends LocalizedOptions<'options'>, WeekOptions
  * Set the day of the week to 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 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 be changed
  * @param day - The day of the week of the new date
@@ -30,4 +31,4 @@ export interface SetDayOptions extends LocalizedOptions<'options'>, WeekOptions
  * const result = setDay(new Date(2014, 8, 1), 0, { weekStartsOn: 1 })
  * //=> Sun Sep 07 2014 00:00:00
  */
-export declare function setDay<DateType extends Date>(date: DateType | number | string, day: number, options?: SetDayOptions): DateType;
+export declare function setDay<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, day: number, options?: SetDayOptions<ResultDate>): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setDayOfYear} function options.
+ */
+export interface SetDayOfYearOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setDayOfYear
  * @category Day Helpers
@@ -7,9 +13,11 @@
  * Set the day of the year to 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 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 be changed
  * @param dayOfYear - The day of the year of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the day of the year set
  *
@@ -18,4 +26,4 @@
  * const result = setDayOfYear(new Date(2014, 6, 2), 2)
  * //=> Thu Jan 02 2014 00:00:00
  */
-export declare function setDayOfYear<DateType extends Date>(date: DateType | number | string, dayOfYear: number): DateType;
+export declare function setDayOfYear<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, dayOfYear: number, options?: SetDayOfYearOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,4 +1,4 @@
-import type { DefaultOptions } from '../_lib/defaultOptions/index';
+import type { DefaultOptions } from '../_lib/defaultOptions/index.ts';
 /**
  * @name setDefaultOptions
  * @category Common Helpers

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setHours} function options.
+ */
+export interface SetHoursOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setHours
  * @category Hour Helpers
@@ -7,9 +13,11 @@
  * Set the hours to 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 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 be changed
  * @param hours - The hours of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the hours set
  *
@@ -18,4 +26,4 @@
  * const result = setHours(new Date(2014, 8, 1, 11, 30), 4)
  * //=> Mon Sep 01 2014 04:30:00
  */
-export declare function setHours<DateType extends Date>(date: DateType | number | string, hours: number): DateType;
+export declare function setHours<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, hours: number, options?: SetHoursOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setISODay} function options.
+ */
+export interface SetISODayOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setISODay
  * @category Weekday Helpers
@@ -6,12 +12,14 @@
  * @description
  * Set the day of the ISO week to the given date.
  * ISO week starts with Monday.
- * 7 is the index of Sunday, 1 is the index of Monday etc.
+ * 7 is the index of Sunday, 1 is the index of Monday, etc.
  *
  * @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 be changed
  * @param day - The day of the ISO week of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the day of the ISO week set
  *
@@ -20,4 +28,4 @@
  * const result = setISODay(new Date(2014, 8, 1), 7)
  * //=> Sun Sep 07 2014 00:00:00
  */
-export declare function setISODay<DateType extends Date>(date: DateType | number | string, day: number): DateType;
+export declare function setISODay<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, day: number, options?: SetISODayOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setISOWeek} function options.
+ */
+export interface SetISOWeekOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setISOWeek
  * @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 ResultDate - The `Date` type of the context function.
  *
  * @param date - The date to be changed
  * @param week - The ISO week of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the ISO week set
  *
@@ -20,4 +28,4 @@
  * const result = setISOWeek(new Date(2004, 7, 7), 53)
  * //=> Sat Jan 01 2005 00:00:00
  */
-export declare function setISOWeek<DateType extends Date>(date: DateType | number | string, week: number): DateType;
+export declare function setISOWeek<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, week: number, options?: SetISOWeekOptions<ResultDate>): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setISOWeekYear} function options.
+ */
+export interface SetISOWeekYearOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setISOWeekYear
  * @category ISO Week-Numbering Year Helpers
@@ -9,10 +15,12 @@
  *
  * 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 using 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 be changed
  * @param weekYear - The ISO week-numbering year of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the ISO week-numbering year set
  *
@@ -21,4 +29,4 @@
  * const result = setISOWeekYear(new Date(2008, 11, 29), 2007)
  * //=> Mon Jan 01 2007 00:00:00
  */
-export declare function setISOWeekYear<DateType extends Date>(date: DateType | number | string, weekYear: number): DateType;
+export declare function setISOWeekYear<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, weekYear: number, options?: SetISOWeekYearOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setMilliseconds} function options.
+ */
+export interface SetMillisecondsOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setMilliseconds
  * @category Millisecond Helpers
@@ -7,9 +13,11 @@
  * Set the milliseconds to 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 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 be changed
  * @param milliseconds - The milliseconds of the new date
+ * @param options - The options
  *
  * @returns The new date with the milliseconds set
  *
@@ -18,4 +26,4 @@
  * const result = setMilliseconds(new Date(2014, 8, 1, 11, 30, 40, 500), 300)
  * //=> Mon Sep 01 2014 11:30:40.300
  */
-export declare function setMilliseconds<DateType extends Date>(date: DateType | number | string, milliseconds: number): DateType;
+export declare function setMilliseconds<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, milliseconds: number, options?: SetMillisecondsOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setMinutes} function options.
+ */
+export interface SetMinutesOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setMinutes
  * @category Minute Helpers
@@ -6,10 +12,12 @@
  * @description
  * Set the minutes to 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, returned from the context function, or inferred from the arguments.
  *
  * @param date - The date to be changed
  * @param minutes - The minutes of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the minutes set
  *
@@ -18,4 +26,4 @@
  * const result = setMinutes(new Date(2014, 8, 1, 11, 30, 40), 45)
  * //=> Mon Sep 01 2014 11:45:40
  */
-export declare function setMinutes<DateType extends Date>(date: DateType | number | string, minutes: number): DateType;
+export declare function setMinutes<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, minutes: number, options?: SetMinutesOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setMonth} function options.
+ */
+export interface SetMonthOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setMonth
  * @category Month Helpers
@@ -7,9 +13,11 @@
  * Set the month to 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 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 be changed
  * @param month - The month index to set (0-11)
+ * @param options - The options
  *
  * @returns The new date with the month set
  *
@@ -18,4 +26,4 @@
  * const result = setMonth(new Date(2014, 8, 1), 1)
  * //=> Sat Feb 01 2014 00:00:00
  */
-export declare function setMonth<DateType extends Date>(date: DateType | number | string, month: number): DateType;
+export declare function setMonth<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, month: number, options?: SetMonthOptions<ResultDate> | undefined): ResultDate;

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

@@ -1,3 +1,9 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setQuarter} function options.
+ */
+export interface SetQuarterOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setQuarter
  * @category Quarter Helpers
@@ -7,9 +13,11 @@
  * Set the year quarter to 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 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 be changed
  * @param quarter - The quarter of the new date
+ * @param options - The options
  *
  * @returns The new date with the quarter set
  *
@@ -18,4 +26,4 @@
  * const result = setQuarter(new Date(2014, 6, 2), 2)
  * //=> Wed Apr 02 2014 00:00:00
  */
-export declare function setQuarter<DateType extends Date>(date: DateType | number | string, quarter: number): DateType;
+export declare function setQuarter<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, quarter: number, options?: SetQuarterOptions<ResultDate>): ResultDate;

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

@@ -1,15 +1,23 @@
+import type { ContextOptions, DateArg } from '../types.ts';
+/**
+ * The {@link setSeconds} function options.
+ */
+export interface SetSecondsOptions<DateType extends Date = Date> extends ContextOptions<DateType> {
+}
 /**
  * @name setSeconds
  * @category Second Helpers
- * @summary Set the seconds to the given date.
+ * @summary Set the seconds to the given date, with context support.
  *
  * @description
- * Set the seconds to the given date.
+ * Set the seconds to the given date, with an optional context for time zone specification.
  *
  * @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 be changed
  * @param seconds - The seconds of the new date
+ * @param options - An object with options
  *
  * @returns The new date with the seconds set
  *
@@ -18,4 +26,4 @@
  * const result = setSeconds(new Date(2014, 8, 1, 11, 30, 40), 45)
  * //=> Mon Sep 01 2014 11:30:45
  */
-export declare function setSeconds<DateType extends Date>(date: DateType | number | string, seconds: number): DateType;
+export declare function setSeconds<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, seconds: number, options?: SetSecondsOptions<ResultDate>): ResultDate;

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

@@ -1,8 +1,8 @@
-import type { FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types';
+import type { ContextOptions, DateArg, FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types.ts';
 /**
  * The {@link setWeek} function options.
  */
-export interface SetWeekOptions extends LocalizedOptions<'options'>, WeekOptions, FirstWeekContainsDateOptions {
+export interface SetWeekOptions<DateType extends Date = Date> extends LocalizedOptions<'options'>, WeekOptions, FirstWeekContainsDateOptions, ContextOptions<DateType> {
 }
 /**
  * @name setWeek
@@ -19,6 +19,7 @@ export interface SetWeekOptions extends LocalizedOptions<'options'>, WeekOptions
  * Week numbering: https://en.wikipedia.org/wiki/Week#The_ISO_week_date_system
  *
  * @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 be changed
  * @param week - The week of the new date
@@ -41,4 +42,4 @@ export interface SetWeekOptions extends LocalizedOptions<'options'>, WeekOptions
  * })
  * //=> Sun Jan 4 2004 00:00:00
  */
-export declare function setWeek<DateType extends Date>(date: DateType | number | string, week: number, options?: SetWeekOptions): DateType;
+export declare function setWeek<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, week: number, options?: SetWeekOptions<ResultDate>): ResultDate;

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

@@ -1,8 +1,8 @@
-import type { FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types';
+import type { ContextOptions, DateArg, FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types.ts';
 /**
  * The {@link setWeekYear} function options.
  */
-export interface SetWeekYearOptions extends LocalizedOptions<'options'>, WeekOptions, FirstWeekContainsDateOptions {
+export interface SetWeekYearOptions<DateType extends Date = Date> extends LocalizedOptions<'options'>, WeekOptions, FirstWeekContainsDateOptions, ContextOptions<DateType> {
 }
 /**
  * @name setWeekYear
@@ -20,6 +20,7 @@ export interface SetWeekYearOptions extends LocalizedOptions<'options'>, WeekOpt
  * Week numbering: https://en.wikipedia.org/wiki/Week#The_ISO_week_date_system
  *
  * @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 be changed
  * @param weekYear - The local week-numbering year of the new date
@@ -42,4 +43,4 @@ export interface SetWeekYearOptions extends LocalizedOptions<'options'>, WeekOpt
  * })
  * //=> Sat Jan 01 2005 00:00:00
  */
-export declare function setWeekYear<DateType extends Date>(date: DateType | number | string, weekYear: number, options?: SetWeekYearOptions): DateType;
+export declare function setWeekYear<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, weekYear: number, options?: SetWeekYearOptions<ResultDate>): ResultDate;