foldkit 0.59.0 → 0.61.0

package/dist/calendar/comparison.d.ts

@@ -0,0 +1,163 @@
+import { type Equivalence as equivalence, Order as order } from 'effect';
+import type { CalendarDate } from './calendarDate';
+/**
+ * Total ordering over calendar dates. Uses lexicographic comparison on
+ * `year`, then `month`, then `day` — which matches calendar chronology
+ * because the struct fields are already in the right order.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { Array } from 'effect'
+ *
+ * const dates = [
+ *   Calendar.make(2026, 5, 1),
+ *   Calendar.make(2026, 4, 30),
+ *   Calendar.make(2026, 4, 13),
+ * ]
+ * Array.sort(dates, Calendar.Order)
+ * ```
+ */
+export declare const Order: order.Order<CalendarDate>;
+/**
+ * Value-based equivalence for calendar dates.
+ */
+export declare const Equivalence: equivalence.Equivalence<CalendarDate>;
+/**
+ * Returns `true` when two calendar dates represent the same day.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.isEqual(Calendar.make(2026, 4, 13), Calendar.make(2026, 4, 13)) // true
+ * pipe(Calendar.make(2026, 4, 13), Calendar.isEqual(Calendar.make(2026, 4, 14))) // false
+ * ```
+ */
+export declare const isEqual: {
+    (that: CalendarDate): (self: CalendarDate) => boolean;
+    (self: CalendarDate, that: CalendarDate): boolean;
+};
+/**
+ * Returns `true` when `self` is strictly before `that`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.isBefore(Calendar.make(2026, 4, 12), Calendar.make(2026, 4, 13)) // true
+ * pipe(Calendar.make(2026, 4, 14), Calendar.isBefore(Calendar.make(2026, 4, 13))) // false
+ * ```
+ */
+export declare const isBefore: {
+    (that: CalendarDate): (self: CalendarDate) => boolean;
+    (self: CalendarDate, that: CalendarDate): boolean;
+};
+/**
+ * Returns `true` when `self` is strictly after `that`.
+ */
+export declare const isAfter: {
+    (that: CalendarDate): (self: CalendarDate) => boolean;
+    (self: CalendarDate, that: CalendarDate): boolean;
+};
+/**
+ * Returns `true` when `self` is before or equal to `that`.
+ */
+export declare const isBeforeOrEqual: {
+    (that: CalendarDate): (self: CalendarDate) => boolean;
+    (self: CalendarDate, that: CalendarDate): boolean;
+};
+/**
+ * Returns `true` when `self` is after or equal to `that`.
+ */
+export declare const isAfterOrEqual: {
+    (that: CalendarDate): (self: CalendarDate) => boolean;
+    (self: CalendarDate, that: CalendarDate): boolean;
+};
+/**
+ * Returns the earlier of two calendar dates.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.min(Calendar.make(2026, 4, 13), Calendar.make(2026, 4, 14))
+ * // { year: 2026, month: 4, day: 13 }
+ *
+ * pipe(Calendar.make(2026, 4, 14), Calendar.min(Calendar.make(2026, 4, 13)))
+ * // { year: 2026, month: 4, day: 13 }
+ * ```
+ */
+export declare const min: {
+    (that: CalendarDate): (self: CalendarDate) => CalendarDate;
+    (self: CalendarDate, that: CalendarDate): CalendarDate;
+};
+/**
+ * Returns the later of two calendar dates.
+ */
+export declare const max: {
+    (that: CalendarDate): (self: CalendarDate) => CalendarDate;
+    (self: CalendarDate, that: CalendarDate): CalendarDate;
+};
+/**
+ * Returns `true` when `self` is within the inclusive range `[minimum, maximum]`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.between(Calendar.make(2026, 4, 13), {
+ *   minimum: Calendar.make(2026, 1, 1),
+ *   maximum: Calendar.make(2026, 12, 31),
+ * }) // true
+ *
+ * pipe(
+ *   Calendar.make(2026, 4, 13),
+ *   Calendar.between({
+ *     minimum: Calendar.make(2027, 1, 1),
+ *     maximum: Calendar.make(2027, 12, 31),
+ *   }),
+ * ) // false
+ * ```
+ */
+export declare const between: {
+    (options: {
+        readonly minimum: CalendarDate;
+        readonly maximum: CalendarDate;
+    }): (self: CalendarDate) => boolean;
+    (self: CalendarDate, options: {
+        readonly minimum: CalendarDate;
+        readonly maximum: CalendarDate;
+    }): boolean;
+};
+/**
+ * Clamps `self` to the inclusive range `[minimum, maximum]`. Returns
+ * `minimum` when `self` is before it, `maximum` when `self` is after it,
+ * and `self` itself otherwise.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.clamp(Calendar.make(2025, 12, 31), {
+ *   minimum: Calendar.make(2026, 1, 1),
+ *   maximum: Calendar.make(2026, 12, 31),
+ * })
+ * // { year: 2026, month: 1, day: 1 }
+ * ```
+ */
+export declare const clamp: {
+    (options: {
+        readonly minimum: CalendarDate;
+        readonly maximum: CalendarDate;
+    }): (self: CalendarDate) => CalendarDate;
+    (self: CalendarDate, options: {
+        readonly minimum: CalendarDate;
+        readonly maximum: CalendarDate;
+    }): CalendarDate;
+};
+//# sourceMappingURL=comparison.d.ts.map

package/dist/calendar/comparison.d.ts.map

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

package/dist/calendar/comparison.js

@@ -0,0 +1,134 @@
+import { Function, Order as order, } from 'effect';
+/**
+ * Total ordering over calendar dates. Uses lexicographic comparison on
+ * `year`, then `month`, then `day` — which matches calendar chronology
+ * because the struct fields are already in the right order.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { Array } from 'effect'
+ *
+ * const dates = [
+ *   Calendar.make(2026, 5, 1),
+ *   Calendar.make(2026, 4, 30),
+ *   Calendar.make(2026, 4, 13),
+ * ]
+ * Array.sort(dates, Calendar.Order)
+ * ```
+ */
+export const Order = order.struct({
+    year: order.number,
+    month: order.number,
+    day: order.number,
+});
+/**
+ * Value-based equivalence for calendar dates.
+ */
+export const Equivalence = (a, b) => a.year === b.year && a.month === b.month && a.day === b.day;
+/**
+ * Returns `true` when two calendar dates represent the same day.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.isEqual(Calendar.make(2026, 4, 13), Calendar.make(2026, 4, 13)) // true
+ * pipe(Calendar.make(2026, 4, 13), Calendar.isEqual(Calendar.make(2026, 4, 14))) // false
+ * ```
+ */
+export const isEqual = Function.dual(2, (self, that) => Equivalence(self, that));
+/**
+ * Returns `true` when `self` is strictly before `that`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.isBefore(Calendar.make(2026, 4, 12), Calendar.make(2026, 4, 13)) // true
+ * pipe(Calendar.make(2026, 4, 14), Calendar.isBefore(Calendar.make(2026, 4, 13))) // false
+ * ```
+ */
+export const isBefore = Function.dual(2, (self, that) => Order(self, that) < 0);
+/**
+ * Returns `true` when `self` is strictly after `that`.
+ */
+export const isAfter = Function.dual(2, (self, that) => Order(self, that) > 0);
+/**
+ * Returns `true` when `self` is before or equal to `that`.
+ */
+export const isBeforeOrEqual = Function.dual(2, (self, that) => Order(self, that) <= 0);
+/**
+ * Returns `true` when `self` is after or equal to `that`.
+ */
+export const isAfterOrEqual = Function.dual(2, (self, that) => Order(self, that) >= 0);
+/**
+ * Returns the earlier of two calendar dates.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.min(Calendar.make(2026, 4, 13), Calendar.make(2026, 4, 14))
+ * // { year: 2026, month: 4, day: 13 }
+ *
+ * pipe(Calendar.make(2026, 4, 14), Calendar.min(Calendar.make(2026, 4, 13)))
+ * // { year: 2026, month: 4, day: 13 }
+ * ```
+ */
+export const min = Function.dual(2, (self, that) => Order(self, that) <= 0 ? self : that);
+/**
+ * Returns the later of two calendar dates.
+ */
+export const max = Function.dual(2, (self, that) => Order(self, that) >= 0 ? self : that);
+/**
+ * Returns `true` when `self` is within the inclusive range `[minimum, maximum]`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.between(Calendar.make(2026, 4, 13), {
+ *   minimum: Calendar.make(2026, 1, 1),
+ *   maximum: Calendar.make(2026, 12, 31),
+ * }) // true
+ *
+ * pipe(
+ *   Calendar.make(2026, 4, 13),
+ *   Calendar.between({
+ *     minimum: Calendar.make(2027, 1, 1),
+ *     maximum: Calendar.make(2027, 12, 31),
+ *   }),
+ * ) // false
+ * ```
+ */
+export const between = Function.dual(2, (self, options) => Order(self, options.minimum) >= 0 && Order(self, options.maximum) <= 0);
+/**
+ * Clamps `self` to the inclusive range `[minimum, maximum]`. Returns
+ * `minimum` when `self` is before it, `maximum` when `self` is after it,
+ * and `self` itself otherwise.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.clamp(Calendar.make(2025, 12, 31), {
+ *   minimum: Calendar.make(2026, 1, 1),
+ *   maximum: Calendar.make(2026, 12, 31),
+ * })
+ * // { year: 2026, month: 1, day: 1 }
+ * ```
+ */
+export const clamp = Function.dual(2, (self, options) => {
+    if (Order(self, options.minimum) < 0) {
+        return options.minimum;
+    }
+    if (Order(self, options.maximum) > 0) {
+        return options.maximum;
+    }
+    return self;
+});

package/dist/calendar/index.d.ts

@@ -0,0 +1,7 @@
+export { CalendarDate, CalendarDateFromIsoString, daysInMonth, fromDateInZone, fromDateLocal, isCalendarDate, isLeapYear, make, toDateLocal, unsafeMake, } from './calendarDate';
+export { addDays, addMonths, addYears, daysSince, daysUntil, subtractDays, subtractMonths, subtractYears, } from './arithmetic';
+export { between, clamp, Equivalence, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isEqual, max, min, Order, } from './comparison';
+export { DayOfWeek, dayOfWeek, endOfWeek, firstOfMonth, lastOfMonth, startOfWeek, } from './info';
+export { today } from './today';
+export { defaultEnglishLocale, formatAriaLabel, formatLong, formatShort, LocaleConfig, } from './locale';
+//# sourceMappingURL=index.d.ts.map

package/dist/calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/calendar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,IAAI,EACJ,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAO,EACP,cAAc,EACd,QAAQ,EACR,eAAe,EACf,OAAO,EACP,GAAG,EACH,GAAG,EACH,KAAK,GACN,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,QAAQ,CAAA;AAEf,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAA"}

package/dist/calendar/index.js

@@ -0,0 +1,6 @@
+export { CalendarDate, CalendarDateFromIsoString, daysInMonth, fromDateInZone, fromDateLocal, isCalendarDate, isLeapYear, make, toDateLocal, unsafeMake, } from './calendarDate';
+export { addDays, addMonths, addYears, daysSince, daysUntil, subtractDays, subtractMonths, subtractYears, } from './arithmetic';
+export { between, clamp, Equivalence, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isEqual, max, min, Order, } from './comparison';
+export { DayOfWeek, dayOfWeek, endOfWeek, firstOfMonth, lastOfMonth, startOfWeek, } from './info';
+export { today } from './today';
+export { defaultEnglishLocale, formatAriaLabel, formatLong, formatShort, LocaleConfig, } from './locale';

package/dist/calendar/info.d.ts

@@ -0,0 +1,76 @@
+import { Schema as S } from 'effect';
+import { type CalendarDate } from './calendarDate';
+/**
+ * Schema for days of the week, Sunday through Saturday. Tagged union preferred
+ * over 0-6 numeric indices to avoid magic numbers at call sites.
+ */
+export declare const DayOfWeek: S.Literal<["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]>;
+export type DayOfWeek = typeof DayOfWeek.Type;
+/**
+ * Returns the day of the week for a calendar date.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.dayOfWeek(Calendar.make(2026, 1, 1)) // "Thursday"
+ * Calendar.dayOfWeek(Calendar.make(2000, 1, 1)) // "Saturday"
+ * ```
+ */
+export declare const dayOfWeek: (self: CalendarDate) => DayOfWeek;
+/**
+ * Returns the first day of the month containing `self`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.firstOfMonth(Calendar.make(2026, 4, 13))
+ * // { year: 2026, month: 4, day: 1 }
+ * ```
+ */
+export declare const firstOfMonth: (self: CalendarDate) => CalendarDate;
+/**
+ * Returns the last day of the month containing `self`. Leap-year aware
+ * for February.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.lastOfMonth(Calendar.make(2024, 2, 10))
+ * // { year: 2024, month: 2, day: 29 } — leap year
+ *
+ * Calendar.lastOfMonth(Calendar.make(2026, 2, 10))
+ * // { year: 2026, month: 2, day: 28 }
+ * ```
+ */
+export declare const lastOfMonth: (self: CalendarDate) => CalendarDate;
+/**
+ * Returns the start-of-week date for the week containing `self`, where
+ * `firstDayOfWeek` specifies which day begins the week. Returns `self`
+ * itself when it already falls on `firstDayOfWeek`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.startOfWeek(Calendar.make(2026, 4, 15), 'Sunday')
+ * // The Sunday that begins the week containing April 15, 2026
+ *
+ * pipe(Calendar.make(2026, 4, 15), Calendar.startOfWeek('Monday'))
+ * ```
+ */
+export declare const startOfWeek: {
+    (firstDayOfWeek: DayOfWeek): (self: CalendarDate) => CalendarDate;
+    (self: CalendarDate, firstDayOfWeek: DayOfWeek): CalendarDate;
+};
+/**
+ * Returns the end-of-week date — six days after the start of the week.
+ */
+export declare const endOfWeek: {
+    (firstDayOfWeek: DayOfWeek): (self: CalendarDate) => CalendarDate;
+    (self: CalendarDate, firstDayOfWeek: DayOfWeek): CalendarDate;
+};
+//# sourceMappingURL=info.d.ts.map

package/dist/calendar/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/calendar/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG9C,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,gBAAgB,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,SAAS,2FAQrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AA6B7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,YAAY,KAAG,SAgB9C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,YAAY,KAAG,YACZ,CAAA;AAEtC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,KAAG,YACsB,CAAA;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,EAAE;IACxB,CAAC,cAAc,EAAE,SAAS,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAA;IACjE,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,GAAG,YAAY,CAAA;CAS9D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE;IACtB,CAAC,cAAc,EAAE,SAAS,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAA;IACjE,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,GAAG,YAAY,CAAA;CAK9D,CAAA"}

package/dist/calendar/info.js

@@ -0,0 +1,125 @@
+import { Function, Schema as S } from 'effect';
+import { addDays, subtractDays } from './arithmetic';
+import { daysInMonth, unsafeMake } from './calendarDate';
+/**
+ * Schema for days of the week, Sunday through Saturday. Tagged union preferred
+ * over 0-6 numeric indices to avoid magic numbers at call sites.
+ */
+export const DayOfWeek = S.Literal('Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday');
+const dayOfWeekFromIndex = (index) => {
+    if (index === 0)
+        return 'Sunday';
+    if (index === 1)
+        return 'Monday';
+    if (index === 2)
+        return 'Tuesday';
+    if (index === 3)
+        return 'Wednesday';
+    if (index === 4)
+        return 'Thursday';
+    if (index === 5)
+        return 'Friday';
+    return 'Saturday';
+};
+const dayOfWeekToIndex = (day) => {
+    if (day === 'Sunday')
+        return 0;
+    if (day === 'Monday')
+        return 1;
+    if (day === 'Tuesday')
+        return 2;
+    if (day === 'Wednesday')
+        return 3;
+    if (day === 'Thursday')
+        return 4;
+    if (day === 'Friday')
+        return 5;
+    return 6;
+};
+// NOTE: Sakamoto's algorithm for day-of-week. The offsets array is a
+// precomputed lookup table that makes the formula branch-free.
+// See https://en.wikipedia.org/wiki/Determination_of_the_day_of_the_week#Sakamoto's_methods
+const sakamotoOffsets = [
+    0, 3, 2, 5, 0, 3, 5, 1, 4, 6, 2, 4,
+];
+/**
+ * Returns the day of the week for a calendar date.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.dayOfWeek(Calendar.make(2026, 1, 1)) // "Thursday"
+ * Calendar.dayOfWeek(Calendar.make(2000, 1, 1)) // "Saturday"
+ * ```
+ */
+export const dayOfWeek = (self) => {
+    const adjustedYear = self.month < 3 ? self.year - 1 : self.year;
+    const offset = sakamotoOffsets[self.month - 1] ?? 0;
+    // The `+ 7) % 7` trick handles negative results from the modulo operation
+    // on negative years — JS `%` preserves sign, so we wrap back into [0, 6].
+    const index = (((adjustedYear +
+        Math.floor(adjustedYear / 4) -
+        Math.floor(adjustedYear / 100) +
+        Math.floor(adjustedYear / 400) +
+        offset +
+        self.day) %
+        7) +
+        7) %
+        7;
+    return dayOfWeekFromIndex(index);
+};
+/**
+ * Returns the first day of the month containing `self`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.firstOfMonth(Calendar.make(2026, 4, 13))
+ * // { year: 2026, month: 4, day: 1 }
+ * ```
+ */
+export const firstOfMonth = (self) => unsafeMake(self.year, self.month, 1);
+/**
+ * Returns the last day of the month containing `self`. Leap-year aware
+ * for February.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.lastOfMonth(Calendar.make(2024, 2, 10))
+ * // { year: 2024, month: 2, day: 29 } — leap year
+ *
+ * Calendar.lastOfMonth(Calendar.make(2026, 2, 10))
+ * // { year: 2026, month: 2, day: 28 }
+ * ```
+ */
+export const lastOfMonth = (self) => unsafeMake(self.year, self.month, daysInMonth(self.year, self.month));
+/**
+ * Returns the start-of-week date for the week containing `self`, where
+ * `firstDayOfWeek` specifies which day begins the week. Returns `self`
+ * itself when it already falls on `firstDayOfWeek`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.startOfWeek(Calendar.make(2026, 4, 15), 'Sunday')
+ * // The Sunday that begins the week containing April 15, 2026
+ *
+ * pipe(Calendar.make(2026, 4, 15), Calendar.startOfWeek('Monday'))
+ * ```
+ */
+export const startOfWeek = Function.dual(2, (self, firstDayOfWeek) => {
+    const startIndex = dayOfWeekToIndex(firstDayOfWeek);
+    const dateIndex = dayOfWeekToIndex(dayOfWeek(self));
+    const offset = (dateIndex - startIndex + 7) % 7;
+    return subtractDays(self, offset);
+});
+/**
+ * Returns the end-of-week date — six days after the start of the week.
+ */
+export const endOfWeek = Function.dual(2, (self, firstDayOfWeek) => addDays(startOfWeek(self, firstDayOfWeek), 6));

package/dist/calendar/locale.d.ts

@@ -0,0 +1,71 @@
+import { Schema as S } from 'effect';
+import type { CalendarDate } from './calendarDate';
+/**
+ * Locale configuration for rendering calendar dates. Contains only data —
+ * month/day names and the first day of the week. Formatting functions
+ * (`formatLong`, `formatShort`, `formatAriaLabel`) are separate exports that
+ * take a `LocaleConfig` as input.
+ *
+ * Day names are always stored Sunday-first in the config; `firstDayOfWeek`
+ * controls how the view rotates them at render time.
+ */
+export declare const LocaleConfig: S.Struct<{
+    firstDayOfWeek: S.Literal<["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]>;
+    monthNames: S.Tuple<[typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String]>;
+    shortMonthNames: S.Tuple<[typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String]>;
+    dayNames: S.Tuple<[typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String]>;
+    shortDayNames: S.Tuple<[typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String, typeof S.String]>;
+}>;
+export type LocaleConfig = typeof LocaleConfig.Type;
+/**
+ * Default English (United States) locale. Picker components default to this
+ * when no locale is passed via ViewConfig. Consumers who want a different
+ * locale pass their own `LocaleConfig`.
+ */
+export declare const defaultEnglishLocale: LocaleConfig;
+/**
+ * Renders a calendar date in long form. Example: `"January 15, 2026"`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { pipe } from 'effect'
+ *
+ * Calendar.formatLong(Calendar.make(2026, 1, 15), Calendar.defaultEnglishLocale)
+ * // "January 15, 2026"
+ *
+ * pipe(
+ *   Calendar.make(2026, 1, 15),
+ *   Calendar.formatLong(Calendar.defaultEnglishLocale),
+ * )
+ * // "January 15, 2026"
+ * ```
+ */
+export declare const formatLong: {
+    (locale: LocaleConfig): (self: CalendarDate) => string;
+    (self: CalendarDate, locale: LocaleConfig): string;
+};
+/**
+ * Renders a calendar date in short form. Example: `"Jan 15, 2026"`.
+ */
+export declare const formatShort: {
+    (locale: LocaleConfig): (self: CalendarDate) => string;
+    (self: CalendarDate, locale: LocaleConfig): string;
+};
+/**
+ * Renders an accessibility label for a calendar date, suitable for
+ * `aria-label` on a grid cell. Example: `"Monday, January 15, 2026"`.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.formatAriaLabel(Calendar.make(2026, 1, 15), Calendar.defaultEnglishLocale)
+ * // "Thursday, January 15, 2026"
+ * ```
+ */
+export declare const formatAriaLabel: {
+    (locale: LocaleConfig): (self: CalendarDate) => string;
+    (self: CalendarDate, locale: LocaleConfig): string;
+};
+//# sourceMappingURL=locale.d.ts.map

package/dist/calendar/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/calendar/locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA4BlD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;EAMvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAwClC,CAAA;AA0CD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,EAAE;IACvB,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAA;IACtD,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;CAKnD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE;IACxB,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAA;IACtD,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;CAKnD,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE;IAC5B,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAA;IACtD,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;CAKlD,CAAA"}