filewisee 0.1.0

package/dist/locale.d.ts

@@ -0,0 +1,11 @@
+import type { Locale } from './types.ts';
+/** Default English (US) locale used when none is supplied. */
+export declare const enUS: Locale;
+/**
+ * Sets the locale used by {@link format} and relative-time helpers when no
+ * explicit locale is passed.
+ */
+export declare function setDefaultLocale(locale: Locale): void;
+/** Returns the currently active default locale. */
+export declare function getDefaultLocale(): Locale;
+//# sourceMappingURL=locale.d.ts.map

package/dist/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,8DAA8D;AAC9D,eAAO,MAAM,IAAI,EAAE,MAclB,CAAA;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/locale.js

@@ -0,0 +1,29 @@
+/** Default English (US) locale used when none is supplied. */
+export const enUS = {
+    months: [
+        'January', 'February', 'March', 'April', 'May', 'June',
+        'July', 'August', 'September', 'October', 'November', 'December',
+    ],
+    monthsShort: [
+        'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+        'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
+    ],
+    weekdays: [
+        'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday',
+    ],
+    weekdaysShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
+    meridiem: ['AM', 'PM'],
+};
+let activeLocale = enUS;
+/**
+ * Sets the locale used by {@link format} and relative-time helpers when no
+ * explicit locale is passed.
+ */
+export function setDefaultLocale(locale) {
+    activeLocale = locale;
+}
+/** Returns the currently active default locale. */
+export function getDefaultLocale() {
+    return activeLocale;
+}
+//# sourceMappingURL=locale.js.map

package/dist/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,IAAI,GAAW;IAC1B,MAAM,EAAE;QACN,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;QACtD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU;KACjE;IACD,WAAW,EAAE;QACX,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACxC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;KACzC;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU;KAC7E;IACD,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAChE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;CACvB,CAAA;AAED,IAAI,YAAY,GAAW,IAAI,CAAA;AAE/B;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,YAAY,GAAG,MAAM,CAAA;AACvB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/dist/manipulate.d.ts

@@ -0,0 +1,65 @@
+import type { DateInput, TimeUnit, Weekday } from './types.ts';
+/**
+ * Adds a number of `days` to a date, returning a new `Date`.
+ * Negative values subtract. The input is never mutated.
+ */
+export declare function addDays(input: DateInput, days: number): Date;
+/** Adds `weeks` (×7 days) to a date. */
+export declare function addWeeks(input: DateInput, weeks: number): Date;
+/** Adds `hours` to a date. */
+export declare function addHours(input: DateInput, hours: number): Date;
+/** Adds `minutes` to a date. */
+export declare function addMinutes(input: DateInput, minutes: number): Date;
+/** Adds `seconds` to a date. */
+export declare function addSeconds(input: DateInput, seconds: number): Date;
+/** Adds `milliseconds` to a date. */
+export declare function addMilliseconds(input: DateInput, milliseconds: number): Date;
+/**
+ * Adds `months` to a date.
+ *
+ * Clamps the day-of-month so it never overflows into the next month — e.g.
+ * `addMonths('2024-01-31', 1)` yields `2024-02-29`, not `2024-03-02`.
+ */
+export declare function addMonths(input: DateInput, months: number): Date;
+/** Adds `quarters` (×3 months) to a date, with the same day-clamping as {@link addMonths}. */
+export declare function addQuarters(input: DateInput, quarters: number): Date;
+/** Adds `years` to a date, clamping Feb 29 → Feb 28 on non-leap years. */
+export declare function addYears(input: DateInput, years: number): Date;
+/**
+ * Generic add by {@link TimeUnit}. Negative `amount` subtracts.
+ *
+ * @example add('2024-01-01', 3, 'month') // 2024-04-01
+ */
+export declare function add(input: DateInput, amount: number, unit: TimeUnit): Date;
+/** Subtracts `amount` of `unit` from a date — the inverse of {@link add}. */
+export declare function subtract(input: DateInput, amount: number, unit: TimeUnit): Date;
+/**
+ * Returns a new date snapped to the start of the given unit.
+ *
+ * @param weekStartsOn First day of the week for `unit: 'week'` (default `0` = Sunday).
+ * @example startOf('2024-03-15T13:45', 'month') // 2024-03-01T00:00:00.000
+ */
+export declare function startOf(input: DateInput, unit: TimeUnit, weekStartsOn?: Weekday): Date;
+/**
+ * Returns a new date snapped to the last representable instant of the given
+ * unit (the millisecond before the next unit begins).
+ *
+ * @example endOf('2024-02-10', 'month') // 2024-02-29T23:59:59.999
+ */
+export declare function endOf(input: DateInput, unit: TimeUnit, weekStartsOn?: Weekday): Date;
+/**
+ * Sets specific calendar/clock fields, returning a new `Date`.
+ * Only the provided fields change.
+ *
+ * @example set('2024-01-01', { hour: 9, minute: 30 })
+ */
+export declare function set(input: DateInput, values: Partial<{
+    year: number;
+    month: number;
+    date: number;
+    hour: number;
+    minute: number;
+    second: number;
+    millisecond: number;
+}>): Date;
+//# sourceMappingURL=manipulate.d.ts.map

package/dist/manipulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulate.d.ts","sourceRoot":"","sources":["../src/manipulate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAI9D;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAShE;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAY1E;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,EACd,YAAY,GAAE,OAAW,GACxB,IAAI,CAuCN;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,EACd,YAAY,GAAE,OAAW,GACxB,IAAI,CAYN;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;IACzC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAClE,CAAC,GACD,IAAI,CAUN"}

package/dist/manipulate.js

@@ -0,0 +1,172 @@
+import { MONTHS_PER_YEAR } from "./constants.js";
+import { daysInMonth, toDate } from "./validate.js";
+/**
+ * Adds a number of `days` to a date, returning a new `Date`.
+ * Negative values subtract. The input is never mutated.
+ */
+export function addDays(input, days) {
+    const date = toDate(input);
+    date.setDate(date.getDate() + days);
+    return date;
+}
+/** Adds `weeks` (×7 days) to a date. */
+export function addWeeks(input, weeks) {
+    return addDays(input, weeks * 7);
+}
+/** Adds `hours` to a date. */
+export function addHours(input, hours) {
+    const date = toDate(input);
+    date.setHours(date.getHours() + hours);
+    return date;
+}
+/** Adds `minutes` to a date. */
+export function addMinutes(input, minutes) {
+    const date = toDate(input);
+    date.setMinutes(date.getMinutes() + minutes);
+    return date;
+}
+/** Adds `seconds` to a date. */
+export function addSeconds(input, seconds) {
+    const date = toDate(input);
+    date.setSeconds(date.getSeconds() + seconds);
+    return date;
+}
+/** Adds `milliseconds` to a date. */
+export function addMilliseconds(input, milliseconds) {
+    return new Date(toDate(input).getTime() + milliseconds);
+}
+/**
+ * Adds `months` to a date.
+ *
+ * Clamps the day-of-month so it never overflows into the next month — e.g.
+ * `addMonths('2024-01-31', 1)` yields `2024-02-29`, not `2024-03-02`.
+ */
+export function addMonths(input, months) {
+    const date = toDate(input);
+    const day = date.getDate();
+    // Move to the 1st to avoid intermediate overflow, then re-apply a clamped day.
+    date.setDate(1);
+    date.setMonth(date.getMonth() + months);
+    date.setDate(Math.min(day, daysInMonth(date.getFullYear(), date.getMonth())));
+    return date;
+}
+/** Adds `quarters` (×3 months) to a date, with the same day-clamping as {@link addMonths}. */
+export function addQuarters(input, quarters) {
+    return addMonths(input, quarters * 3);
+}
+/** Adds `years` to a date, clamping Feb 29 → Feb 28 on non-leap years. */
+export function addYears(input, years) {
+    return addMonths(input, years * MONTHS_PER_YEAR);
+}
+/**
+ * Generic add by {@link TimeUnit}. Negative `amount` subtracts.
+ *
+ * @example add('2024-01-01', 3, 'month') // 2024-04-01
+ */
+export function add(input, amount, unit) {
+    switch (unit) {
+        case 'year': return addYears(input, amount);
+        case 'quarter': return addQuarters(input, amount);
+        case 'month': return addMonths(input, amount);
+        case 'week': return addWeeks(input, amount);
+        case 'day': return addDays(input, amount);
+        case 'hour': return addHours(input, amount);
+        case 'minute': return addMinutes(input, amount);
+        case 'second': return addSeconds(input, amount);
+        case 'millisecond': return addMilliseconds(input, amount);
+    }
+}
+/** Subtracts `amount` of `unit` from a date — the inverse of {@link add}. */
+export function subtract(input, amount, unit) {
+    return add(input, -amount, unit);
+}
+/**
+ * Returns a new date snapped to the start of the given unit.
+ *
+ * @param weekStartsOn First day of the week for `unit: 'week'` (default `0` = Sunday).
+ * @example startOf('2024-03-15T13:45', 'month') // 2024-03-01T00:00:00.000
+ */
+export function startOf(input, unit, weekStartsOn = 0) {
+    const date = toDate(input);
+    switch (unit) {
+        case 'year':
+            date.setMonth(0, 1);
+            date.setHours(0, 0, 0, 0);
+            break;
+        case 'quarter': {
+            const q = Math.floor(date.getMonth() / 3);
+            date.setMonth(q * 3, 1);
+            date.setHours(0, 0, 0, 0);
+            break;
+        }
+        case 'month':
+            date.setDate(1);
+            date.setHours(0, 0, 0, 0);
+            break;
+        case 'week': {
+            const diff = (date.getDay() - weekStartsOn + 7) % 7;
+            date.setDate(date.getDate() - diff);
+            date.setHours(0, 0, 0, 0);
+            break;
+        }
+        case 'day':
+            date.setHours(0, 0, 0, 0);
+            break;
+        case 'hour':
+            date.setMinutes(0, 0, 0);
+            break;
+        case 'minute':
+            date.setSeconds(0, 0);
+            break;
+        case 'second':
+            date.setMilliseconds(0);
+            break;
+        case 'millisecond':
+            break;
+    }
+    return date;
+}
+/**
+ * Returns a new date snapped to the last representable instant of the given
+ * unit (the millisecond before the next unit begins).
+ *
+ * @example endOf('2024-02-10', 'month') // 2024-02-29T23:59:59.999
+ */
+export function endOf(input, unit, weekStartsOn = 0) {
+    switch (unit) {
+        case 'year': return new Date(startOf(input, 'year').getFullYear() + 1, 0, 1, 0, 0, 0, -1);
+        case 'quarter': return new Date(addQuarters(startOf(input, 'quarter'), 1).getTime() - 1);
+        case 'month': return new Date(addMonths(startOf(input, 'month'), 1).getTime() - 1);
+        case 'week': return new Date(addDays(startOf(input, 'week', weekStartsOn), 7).getTime() - 1);
+        case 'day': return new Date(addDays(startOf(input, 'day'), 1).getTime() - 1);
+        case 'hour': return new Date(addHours(startOf(input, 'hour'), 1).getTime() - 1);
+        case 'minute': return new Date(addMinutes(startOf(input, 'minute'), 1).getTime() - 1);
+        case 'second': return new Date(addSeconds(startOf(input, 'second'), 1).getTime() - 1);
+        case 'millisecond': return toDate(input);
+    }
+}
+/**
+ * Sets specific calendar/clock fields, returning a new `Date`.
+ * Only the provided fields change.
+ *
+ * @example set('2024-01-01', { hour: 9, minute: 30 })
+ */
+export function set(input, values) {
+    const d = toDate(input);
+    if (values.year !== undefined)
+        d.setFullYear(values.year);
+    if (values.month !== undefined)
+        d.setMonth(values.month);
+    if (values.date !== undefined)
+        d.setDate(values.date);
+    if (values.hour !== undefined)
+        d.setHours(values.hour);
+    if (values.minute !== undefined)
+        d.setMinutes(values.minute);
+    if (values.second !== undefined)
+        d.setSeconds(values.second);
+    if (values.millisecond !== undefined)
+        d.setMilliseconds(values.millisecond);
+    return d;
+}
+//# sourceMappingURL=manipulate.js.map

package/dist/manipulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulate.js","sourceRoot":"","sources":["../src/manipulate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEnD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAgB,EAAE,IAAY;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACnC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,KAAa;IACtD,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;AAClC,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,KAAa;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAA;IACtC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,OAAe;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,OAAe;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,YAAoB;IACpE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,MAAc;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IAE1B,+EAA+E;IAC/E,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACf,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAA;IACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7E,OAAO,IAAI,CAAA;AACb,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,QAAgB;IAC5D,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAA;AACvC,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,KAAa;IACtD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAAC,CAAA;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,KAAgB,EAAE,MAAc,EAAE,IAAc;IAClE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC3C,KAAK,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACjD,KAAK,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC7C,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC3C,KAAK,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACzC,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC3C,KAAK,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC/C,KAAK,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC/C,KAAK,aAAa,CAAC,CAAC,OAAO,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,MAAc,EAAE,IAAc;IACvE,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,KAAgB,EAChB,IAAc,EACd,eAAwB,CAAC;IAEzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,MAAK;QACP,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAA;YACzC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YACvB,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,MAAK;QACP,CAAC;QACD,KAAK,OAAO;YACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YACf,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,MAAK;QACP,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;YACnC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,MAAK;QACP,CAAC;QACD,KAAK,KAAK;YACR,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACzB,MAAK;QACP,KAAK,MAAM;YACT,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACxB,MAAK;QACP,KAAK,QAAQ;YACX,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACrB,MAAK;QACP,KAAK,QAAQ;YACX,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;YACvB,MAAK;QACP,KAAK,aAAa;YAChB,MAAK;IACT,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CACnB,KAAgB,EAChB,IAAc,EACd,eAAwB,CAAC;IAEzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACzF,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QACxF,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAClF,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAC5F,KAAK,KAAK,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAC5E,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAC/E,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QACrF,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QACrF,KAAK,aAAa,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CACjB,KAAgB,EAChB,MAGE;IAEF,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACvB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACxD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACrD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5D,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC3E,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,24 @@
+import type { Locale } from './types.ts';
+/**
+ * Parses an ISO-8601 string into a `Date`, returning `null` if it is not a
+ * valid, real instant. Thin, safe wrapper over the native parser.
+ *
+ * @example parseISO('2024-03-09T14:05:00Z') // Date
+ * @example parseISO('not a date')           // null
+ */
+export declare function parseISO(value: string): Date | null;
+/**
+ * Parses a date string against an explicit token pattern (the inverse of
+ * {@link format}). Returns `null` if the string doesn't match or yields an
+ * invalid date.
+ *
+ * Unmatched clock fields default to zero; an unmatched year defaults to 1970.
+ * Literal text may be wrapped in `[...]`, mirroring {@link format}.
+ *
+ * @example
+ * parse('09/03/2024', 'DD/MM/YYYY')          // 2024-03-09T00:00 local
+ * parse('March 9, 2024', 'MMMM D, YYYY')     // 2024-03-09T00:00 local
+ * parse('2:05 pm', 'h:mm a')                 // today at 14:05
+ */
+export declare function parse(value: string, pattern: string, locale?: Locale): Date | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,MAAM,EAAE,MAAM,YAAY,CAAA;AAInD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEnD;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAA2B,GAClC,IAAI,GAAG,IAAI,CA6Db"}

package/dist/parse.js

@@ -0,0 +1,135 @@
+import { getDefaultLocale } from "./locale.js";
+import { tryToDate } from "./validate.js";
+/**
+ * Parses an ISO-8601 string into a `Date`, returning `null` if it is not a
+ * valid, real instant. Thin, safe wrapper over the native parser.
+ *
+ * @example parseISO('2024-03-09T14:05:00Z') // Date
+ * @example parseISO('not a date')           // null
+ */
+export function parseISO(value) {
+    return tryToDate(value);
+}
+/** Tokens understood by {@link parse}, mapped to a capturing regex fragment. */
+const PARSE_TOKENS = {
+    YYYY: '(\\d{4})',
+    YY: '(\\d{2})',
+    MM: '(\\d{2})',
+    M: '(\\d{1,2})',
+    DD: '(\\d{2})',
+    D: '(\\d{1,2})',
+    HH: '(\\d{2})',
+    H: '(\\d{1,2})',
+    hh: '(\\d{2})',
+    h: '(\\d{1,2})',
+    mm: '(\\d{2})',
+    m: '(\\d{1,2})',
+    ss: '(\\d{2})',
+    s: '(\\d{1,2})',
+    SSS: '(\\d{3})',
+    MMMM: '([A-Za-z\\u00C0-\\u024F]+)',
+    MMM: '([A-Za-z\\u00C0-\\u024F]+)',
+    A: '([AaPp][Mm])',
+    a: '([AaPp][Mm])',
+};
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Parses a date string against an explicit token pattern (the inverse of
+ * {@link format}). Returns `null` if the string doesn't match or yields an
+ * invalid date.
+ *
+ * Unmatched clock fields default to zero; an unmatched year defaults to 1970.
+ * Literal text may be wrapped in `[...]`, mirroring {@link format}.
+ *
+ * @example
+ * parse('09/03/2024', 'DD/MM/YYYY')          // 2024-03-09T00:00 local
+ * parse('March 9, 2024', 'MMMM D, YYYY')     // 2024-03-09T00:00 local
+ * parse('2:05 pm', 'h:mm a')                 // today at 14:05
+ */
+export function parse(value, pattern, locale = getDefaultLocale()) {
+    const order = [];
+    const tokenNames = Object.keys(PARSE_TOKENS).sort((a, b) => b.length - a.length);
+    const tokenRe = new RegExp(`\\[([^\\]]*)\\]|${tokenNames.join('|')}`, 'g');
+    // Build a regex from the pattern, recording the token order for later mapping.
+    const source = pattern.replace(tokenRe, (match, literal) => {
+        if (literal !== undefined)
+            return escapeRegExp(literal);
+        order.push(match);
+        return PARSE_TOKENS[match];
+    });
+    const m = new RegExp(`^${source}$`).exec(value);
+    if (!m)
+        return null;
+    const parts = {
+        year: 1970, month: 0, day: 1,
+        hour: 0, minute: 0, second: 0, ms: 0,
+        meridiem: null,
+    };
+    for (let i = 0; i < order.length; i++) {
+        const token = order[i];
+        const raw = m[i + 1];
+        switch (token) {
+            case 'YYYY':
+                parts.year = Number(raw);
+                break;
+            case 'YY':
+                parts.year = 2000 + Number(raw);
+                break;
+            case 'MM':
+            case 'M':
+                parts.month = Number(raw) - 1;
+                break;
+            case 'DD':
+            case 'D':
+                parts.day = Number(raw);
+                break;
+            case 'HH':
+            case 'H':
+            case 'hh':
+            case 'h':
+                parts.hour = Number(raw);
+                break;
+            case 'mm':
+            case 'm':
+                parts.minute = Number(raw);
+                break;
+            case 'ss':
+            case 's':
+                parts.second = Number(raw);
+                break;
+            case 'SSS':
+                parts.ms = Number(raw);
+                break;
+            case 'A':
+            case 'a':
+                parts.meridiem = raw.toLowerCase();
+                break;
+            case 'MMMM': {
+                const idx = locale.months.findIndex((mm) => mm.toLowerCase() === raw.toLowerCase());
+                if (idx === -1)
+                    return null;
+                parts.month = idx;
+                break;
+            }
+            case 'MMM': {
+                const idx = locale.monthsShort.findIndex((mm) => mm.toLowerCase() === raw.toLowerCase());
+                if (idx === -1)
+                    return null;
+                parts.month = idx;
+                break;
+            }
+        }
+    }
+    if (parts.meridiem === 'pm' && parts.hour < 12)
+        parts.hour += 12;
+    if (parts.meridiem === 'am' && parts.hour === 12)
+        parts.hour = 0;
+    const date = new Date(parts.year, parts.month, parts.day, parts.hour, parts.minute, parts.second, parts.ms);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    // Reject overflow (e.g. day 31 in a 30-day month silently rolling over).
+    if (date.getMonth() !== parts.month || date.getDate() !== parts.day)
+        return null;
+    return date;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;AACzB,CAAC;AAED,gFAAgF;AAChF,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,YAAY;IACf,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,YAAY;IACf,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,YAAY;IACf,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,YAAY;IACf,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,YAAY;IACf,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,YAAY;IACf,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,4BAA4B;IAClC,GAAG,EAAE,4BAA4B;IACjC,CAAC,EAAE,cAAc;IACjB,CAAC,EAAE,cAAc;CAClB,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AAEpF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,KAAK,CACnB,KAAa,EACb,OAAe,EACf,SAAiB,gBAAgB,EAAE;IAEnC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;IAChF,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,mBAAmB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAE1E,+EAA+E;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACzD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAA;QACvD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,OAAO,YAAY,CAAC,KAAK,CAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnB,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACpC,QAAQ,EAAE,IAA0B;KACrC,CAAA;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAA;QACrB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YAC5C,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACjD,KAAK,IAAI,CAAC;YAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACzD,KAAK,IAAI,CAAC;YAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACnD,KAAK,IAAI,CAAC;YAAC,KAAK,GAAG,CAAC;YAAC,KAAK,IAAI,CAAC;YAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACzE,KAAK,IAAI,CAAC;YAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACtD,KAAK,IAAI,CAAC;YAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACtD,KAAK,KAAK;gBAAE,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAK;YACzC,KAAK,GAAG,CAAC;YAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAiB,CAAC;gBAAC,MAAK;YAC5E,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;gBACnF,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAA;gBAC3B,KAAK,CAAC,KAAK,GAAG,GAAG,CAAA;gBACjB,MAAK;YACP,CAAC;YACD,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;gBACxF,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAA;gBAC3B,KAAK,CAAC,KAAK,GAAG,GAAG,CAAA;gBACjB,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;IAChE,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAA;IAEhE,MAAM,IAAI,GAAG,IAAI,IAAI,CACnB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAClC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CACjD,CAAA;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAE7C,yEAAyE;IACzE,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IAChF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/range.d.ts

@@ -0,0 +1,25 @@
+import type { DateInput, Interval, TimeUnit } from './types.ts';
+/**
+ * Generates dates from `start` up to and including `end`, stepping by `step`
+ * units of `unit`. Yields lazily, so it is safe over very large ranges.
+ *
+ * Direction is inferred from the bounds — pass a positive `step` regardless of
+ * whether `start` is before or after `end`.
+ *
+ * @example [...eachOf('2024-01-01', '2024-01-03', 'day')] // 3 dates
+ */
+export declare function eachOf(start: DateInput, end: DateInput, unit: TimeUnit, step?: number): Generator<Date>;
+/** Collects {@link eachOf} into an array of days between two dates (inclusive). */
+export declare function eachDayOfInterval(start: DateInput, end: DateInput): Date[];
+/** Collects each month start between two dates (inclusive). */
+export declare function eachMonthOfInterval(start: DateInput, end: DateInput): Date[];
+/** Returns `true` if two intervals share at least one instant. */
+export declare function overlaps(a: Interval, b: Interval): boolean;
+/**
+ * Returns the overlapping interval shared by `a` and `b`, or `null` if they
+ * don't intersect.
+ */
+export declare function intersection(a: Interval, b: Interval): Interval | null;
+/** Total number of whole days an interval spans (inclusive of both ends). */
+export declare function durationDays(interval: Interval): number;
+//# sourceMappingURL=range.d.ts.map

package/dist/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAK/D;;;;;;;;GAQG;AACH,wBAAiB,MAAM,CACrB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,QAAQ,EACd,IAAI,SAAI,GACP,SAAS,CAAC,IAAI,CAAC,CAajB;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,EAAE,CAE1E;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,EAAE,CAE5E;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAM1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAKtE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEvD"}

package/dist/range.js

@@ -0,0 +1,57 @@
+import { add, startOf } from "./manipulate.js";
+import { isAfter, isBefore } from "./compare.js";
+import { toDate } from "./validate.js";
+/**
+ * Generates dates from `start` up to and including `end`, stepping by `step`
+ * units of `unit`. Yields lazily, so it is safe over very large ranges.
+ *
+ * Direction is inferred from the bounds — pass a positive `step` regardless of
+ * whether `start` is before or after `end`.
+ *
+ * @example [...eachOf('2024-01-01', '2024-01-03', 'day')] // 3 dates
+ */
+export function* eachOf(start, end, unit, step = 1) {
+    if (step <= 0)
+        throw new RangeError('step must be a positive number');
+    const from = toDate(start);
+    const to = toDate(end);
+    const ascending = !isAfter(from, to);
+    const signedStep = ascending ? step : -step;
+    let cursor = from;
+    while (ascending ? !isAfter(cursor, to) : !isBefore(cursor, to)) {
+        yield new Date(cursor.getTime());
+        cursor = add(cursor, signedStep, unit);
+    }
+}
+/** Collects {@link eachOf} into an array of days between two dates (inclusive). */
+export function eachDayOfInterval(start, end) {
+    return [...eachOf(start, end, 'day')];
+}
+/** Collects each month start between two dates (inclusive). */
+export function eachMonthOfInterval(start, end) {
+    return [...eachOf(startOf(start, 'month'), startOf(end, 'month'), 'month')];
+}
+/** Returns `true` if two intervals share at least one instant. */
+export function overlaps(a, b) {
+    const aStart = toDate(a.start).getTime();
+    const aEnd = toDate(a.end).getTime();
+    const bStart = toDate(b.start).getTime();
+    const bEnd = toDate(b.end).getTime();
+    return Math.max(aStart, bStart) <= Math.min(aEnd, bEnd);
+}
+/**
+ * Returns the overlapping interval shared by `a` and `b`, or `null` if they
+ * don't intersect.
+ */
+export function intersection(a, b) {
+    if (!overlaps(a, b))
+        return null;
+    const start = Math.max(toDate(a.start).getTime(), toDate(b.start).getTime());
+    const end = Math.min(toDate(a.end).getTime(), toDate(b.end).getTime());
+    return { start: new Date(start), end: new Date(end) };
+}
+/** Total number of whole days an interval spans (inclusive of both ends). */
+export function durationDays(interval) {
+    return eachDayOfInterval(interval.start, interval.end).length;
+}
+//# sourceMappingURL=range.js.map

package/dist/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"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"}

package/dist/relative.d.ts

@@ -0,0 +1,25 @@
+import type { DateInput } from './types.ts';
+/**
+ * Human-friendly relative time, localised via the platform `Intl` API.
+ *
+ * @param input  The date to describe.
+ * @param base   The reference point (default: now).
+ * @param locale BCP-47 locale tag(s) for `Intl.RelativeTimeFormat` (default: runtime).
+ *
+ * @example
+ * formatRelative(addDays(new Date(), -3)) // "3 days ago"
+ * formatRelative(addHours(new Date(), 2)) // "in 2 hours"
+ */
+export declare function formatRelative(input: DateInput, base?: DateInput, locale?: string | string[]): string;
+/** Alias for {@link formatRelative} reading the other way: time from `base` to `input`. */
+export declare const fromNow: (input: DateInput, locale?: string | string[]) => string;
+/**
+ * Formats a millisecond duration compactly, largest unit first.
+ *
+ * @param ms      Duration in milliseconds (sign is ignored).
+ * @param maxUnits How many units to show (default `2`), e.g. `"1h 30m"`.
+ *
+ * @example formatDuration(90_061_000) // "1d 1h" (maxUnits: 2)
+ */
+export declare function formatDuration(ms: number, maxUnits?: number): string;
+//# sourceMappingURL=relative.d.ts.map

package/dist/relative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../src/relative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAwB3C;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,SAAsB,EAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GACzB,MAAM,CAQR;AAED,2FAA2F;AAC3F,eAAO,MAAM,OAAO,GAAI,OAAO,SAAS,EAAE,SAAS,MAAM,GAAG,MAAM,EAAE,KAAG,MAC5B,CAAA;AAE3C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAgB/D"}