/* eslint-disable eslint-comments/no-unlimited-disable */ /* eslint-disable */ // @ts-nocheck import { normalizeDates } from '../_lib/normalizeDates/index.ts'; import type { ContextOptions, DateArg, NormalizedInterval } from '../types.ts'; /** * The {@link interval} function options. */ export interface IntervalOptions extends ContextOptions { /** Asserts that the interval is positive (start is after the end). */ assertPositive?: boolean; } /** * The {@link interval} function result type. It resolves the proper data type. * It uses the first argument date object type, starting from the start argument, * then the end interval date. If a context function is passed, it uses the context * function return type. */ export type IntervalResult< StartDate extends DateArg, EndDate extends DateArg, Options extends IntervalOptions | undefined = undefined, > = NormalizedInterval< Options extends IntervalOptions ? DateType : StartDate extends Date ? StartDate : EndDate extends Date ? EndDate : Date >; /** * @name interval * @category Interval Helpers * @summary Creates an interval object and validates its values. * * @description * Creates a normalized interval object and validates its values. If the interval is invalid, an exception is thrown. * * @typeParam StartDate - Start date type. * @typeParam EndDate - End date type. * @typeParam Options - Options type. * * @param start - The start of the interval. * @param end - The end of the interval. * @param options - The options object. * * @throws `Start date is invalid` when `start` is invalid. * @throws `End date is invalid` when `end` is invalid. * @throws `End date must be after start date` when end is before `start` and `options.assertPositive` is true. * * @returns The normalized and validated interval object. */ export function interval< StartDate extends DateArg, EndDate extends DateArg, Options extends IntervalOptions | undefined = undefined, >(start: StartDate, end: EndDate, options?: Options): IntervalResult { const [_start, _end] = normalizeDates(options?.in, start, end); if (isNaN(+_start)) throw new TypeError('Start date is invalid'); if (isNaN(+_end)) throw new TypeError('End date is invalid'); if (options?.assertPositive && +_start > +_end) throw new TypeError('End date must be after start date'); return { start: _start, end: _end } as IntervalResult; } /* eslint-enable */