foldkit 0.159.0 → 0.160.0-canary.41f95ced5e07

package/dist/calendar/calendarDate.js

@@ -178,7 +178,7 @@ const isoPattern = /^(\d{4})-(\d{2})-(\d{2})$/;
  * encode(Calendar.make(2026, 4, 13)) // "2026-04-13"
  * ```
  */
-export const CalendarDateFromIsoString = Schema.String.pipe(Schema.decodeTo(CalendarDate, SchemaTransformation.transformOrFail({
+export const CalendarDateFromIsoString = Schema.String.pipe(Schema.decodeTo(CalendarDate, SchemaTransformation.transformEffect({
     decode: input => {
         const match = input.match(isoPattern);
         if (match === null) {

package/dist/calendar/index.d.ts

@@ -3,5 +3,5 @@ export { addDays, addMonths, addYears, daysSince, daysUntil, subtractDays, subtr
 export { between, clamp, Equivalence, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isEqual, max, min, Order, } from './comparison.js';
 export { DayOfWeek, dayOfWeek, endOfWeek, firstOfMonth, lastOfMonth, startOfWeek, } from './info.js';
 export { today } from './today.js';
-export { defaultEnglishLocale, formatAriaLabel, formatLong, formatShort, LocaleConfig, } from './locale.js';
+export { DateFormat, DatePart, defaultEnglishLocale, format, formatAriaLabel, formatLong, formatMonthYear, formatShort, LocaleConfig, MonthYearFormat, } from './locale.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,mBAAmB,CAAA;AAE1B,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAA;AAExB,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,iBAAiB,CAAA;AAExB,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAA"}
+{"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,mBAAmB,CAAA;AAE1B,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAA;AAExB,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,iBAAiB,CAAA;AAExB,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,MAAM,EACN,eAAe,EACf,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAA"}

package/dist/calendar/index.js

@@ -3,4 +3,4 @@ export { addDays, addMonths, addYears, daysSince, daysUntil, subtractDays, subtr
 export { between, clamp, Equivalence, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isEqual, max, min, Order, } from './comparison.js';
 export { DayOfWeek, dayOfWeek, endOfWeek, firstOfMonth, lastOfMonth, startOfWeek, } from './info.js';
 export { today } from './today.js';
-export { defaultEnglishLocale, formatAriaLabel, formatLong, formatShort, LocaleConfig, } from './locale.js';
+export { DateFormat, DatePart, defaultEnglishLocale, format, formatAriaLabel, formatLong, formatMonthYear, formatShort, LocaleConfig, MonthYearFormat, } from './locale.js';

package/dist/calendar/locale.d.ts

@@ -1,10 +1,101 @@
 import { Schema } from 'effect';
 import type { CalendarDate } from './calendarDate.js';
 /**
- * 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.
+ * One part of a `DateFormat`. Name parts draw from the `LocaleConfig`, number
+ * parts draw from the date, and `LiteralText` supplies separators,
+ * punctuation, or suffixes such as `年`.
+ *
+ * `MonthName`, `DayName`, and their `Short*` counterparts select from the
+ * corresponding locale name arrays. `MonthNumber` and `DayNumber` render
+ * unpadded numbers; their `Padded*` counterparts render two digits.
+ * `YearNumber` renders the full year.
+ */
+export declare const DatePart: import("../schema/index.js").TaggedUnion<{
+    readonly MonthName: {};
+    readonly ShortMonthName: {};
+    readonly MonthNumber: {};
+    readonly PaddedMonthNumber: {};
+    readonly DayNumber: {};
+    readonly PaddedDayNumber: {};
+    readonly DayName: {};
+    readonly ShortDayName: {};
+    readonly YearNumber: {};
+    readonly LiteralText: {
+        text: Schema.String;
+    };
+}>;
+export type DatePart = typeof DatePart.Type;
+/**
+ * A non-empty ordered list of parts rendered left to right. Because ordering
+ * lives in the data rather than in the formatting functions, a locale whose
+ * dates read day-first or year-first renders correctly without a code change.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * // "15. Januar 2026"
+ * const germanLong: Calendar.DateFormat = [
+ *   Calendar.DatePart.DayNumber(),
+ *   Calendar.DatePart.LiteralText({ text: '. ' }),
+ *   Calendar.DatePart.MonthName(),
+ *   Calendar.DatePart.LiteralText({ text: ' ' }),
+ *   Calendar.DatePart.YearNumber(),
+ * ]
+ * ```
+ */
+export declare const DateFormat: Schema.NonEmptyArray<import("../schema/index.js").TaggedUnion<{
+    readonly MonthName: {};
+    readonly ShortMonthName: {};
+    readonly MonthNumber: {};
+    readonly PaddedMonthNumber: {};
+    readonly DayNumber: {};
+    readonly PaddedDayNumber: {};
+    readonly DayName: {};
+    readonly ShortDayName: {};
+    readonly YearNumber: {};
+    readonly LiteralText: {
+        text: Schema.String;
+    };
+}>>;
+export type DateFormat = typeof DateFormat.Type;
+/** A non-empty format restricted to month and year parts. */
+export declare const MonthYearFormat: Schema.NonEmptyArray<Schema.Union<readonly [Schema.TaggedStruct<"MonthName", {}> & ((value?: void | {
+    readonly _tag?: "MonthName";
+} | undefined) => {
+    readonly _tag: "MonthName";
+}), Schema.TaggedStruct<"ShortMonthName", {}> & ((value?: void | {
+    readonly _tag?: "ShortMonthName";
+} | undefined) => {
+    readonly _tag: "ShortMonthName";
+}), Schema.TaggedStruct<"MonthNumber", {}> & ((value?: void | {
+    readonly _tag?: "MonthNumber";
+} | undefined) => {
+    readonly _tag: "MonthNumber";
+}), Schema.TaggedStruct<"PaddedMonthNumber", {}> & ((value?: void | {
+    readonly _tag?: "PaddedMonthNumber";
+} | undefined) => {
+    readonly _tag: "PaddedMonthNumber";
+}), Schema.TaggedStruct<"YearNumber", {}> & ((value?: void | {
+    readonly _tag?: "YearNumber";
+} | undefined) => {
+    readonly _tag: "YearNumber";
+}), Schema.TaggedStruct<"LiteralText", {
+    readonly text: Schema.String;
+}> & ((value: {
+    readonly _tag?: "LiteralText";
+    readonly text: string;
+}) => {
+    readonly _tag: "LiteralText";
+    readonly text: string;
+})]>>;
+export type MonthYearFormat = typeof MonthYearFormat.Type;
+/**
+ * Locale configuration for rendering calendar dates. Contains only data: the
+ * month and day names, the first day of the week, and the `DateFormat` for
+ * each of the four shapes the formatters produce. Formatting functions
+ * (`formatLong`, `formatShort`, `formatAriaLabel`, `formatMonthYear`) 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.
@@ -15,16 +106,112 @@ export declare const LocaleConfig: Schema.Struct<{
     readonly shortMonthNames: Schema.Tuple<readonly [Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String]>;
     readonly dayNames: Schema.Tuple<readonly [Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String]>;
     readonly shortDayNames: Schema.Tuple<readonly [Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String]>;
+    readonly longFormat: Schema.NonEmptyArray<import("../schema/index.js").TaggedUnion<{
+        readonly MonthName: {};
+        readonly ShortMonthName: {};
+        readonly MonthNumber: {};
+        readonly PaddedMonthNumber: {};
+        readonly DayNumber: {};
+        readonly PaddedDayNumber: {};
+        readonly DayName: {};
+        readonly ShortDayName: {};
+        readonly YearNumber: {};
+        readonly LiteralText: {
+            text: Schema.String;
+        };
+    }>>;
+    readonly shortFormat: Schema.NonEmptyArray<import("../schema/index.js").TaggedUnion<{
+        readonly MonthName: {};
+        readonly ShortMonthName: {};
+        readonly MonthNumber: {};
+        readonly PaddedMonthNumber: {};
+        readonly DayNumber: {};
+        readonly PaddedDayNumber: {};
+        readonly DayName: {};
+        readonly ShortDayName: {};
+        readonly YearNumber: {};
+        readonly LiteralText: {
+            text: Schema.String;
+        };
+    }>>;
+    readonly ariaLabelFormat: Schema.NonEmptyArray<import("../schema/index.js").TaggedUnion<{
+        readonly MonthName: {};
+        readonly ShortMonthName: {};
+        readonly MonthNumber: {};
+        readonly PaddedMonthNumber: {};
+        readonly DayNumber: {};
+        readonly PaddedDayNumber: {};
+        readonly DayName: {};
+        readonly ShortDayName: {};
+        readonly YearNumber: {};
+        readonly LiteralText: {
+            text: Schema.String;
+        };
+    }>>;
+    readonly monthYearFormat: Schema.NonEmptyArray<Schema.Union<readonly [Schema.TaggedStruct<"MonthName", {}> & ((value?: void | {
+        readonly _tag?: "MonthName";
+    } | undefined) => {
+        readonly _tag: "MonthName";
+    }), Schema.TaggedStruct<"ShortMonthName", {}> & ((value?: void | {
+        readonly _tag?: "ShortMonthName";
+    } | undefined) => {
+        readonly _tag: "ShortMonthName";
+    }), Schema.TaggedStruct<"MonthNumber", {}> & ((value?: void | {
+        readonly _tag?: "MonthNumber";
+    } | undefined) => {
+        readonly _tag: "MonthNumber";
+    }), Schema.TaggedStruct<"PaddedMonthNumber", {}> & ((value?: void | {
+        readonly _tag?: "PaddedMonthNumber";
+    } | undefined) => {
+        readonly _tag: "PaddedMonthNumber";
+    }), Schema.TaggedStruct<"YearNumber", {}> & ((value?: void | {
+        readonly _tag?: "YearNumber";
+    } | undefined) => {
+        readonly _tag: "YearNumber";
+    }), Schema.TaggedStruct<"LiteralText", {
+        readonly text: Schema.String;
+    }> & ((value: {
+        readonly _tag?: "LiteralText";
+        readonly text: string;
+    }) => {
+        readonly _tag: "LiteralText";
+        readonly text: 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
+ * Default English (United States) locale. Calendar components default to this
+ * when initialization receives no locale. 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"`.
+ * Renders a calendar date through an arbitrary `DateFormat`. The four named
+ * formatters below are this function applied to the matching field of the
+ * `LocaleConfig`; reach for it directly when a view needs a shape the locale
+ * does not carry.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.format(Calendar.make(2026, 1, 15), Calendar.defaultEnglishLocale, [
+ *   Calendar.DatePart.YearNumber(),
+ *   Calendar.DatePart.LiteralText({ text: '-' }),
+ *   Calendar.DatePart.PaddedMonthNumber(),
+ *   Calendar.DatePart.LiteralText({ text: '-' }),
+ *   Calendar.DatePart.PaddedDayNumber(),
+ * ])
+ * // "2026-01-15"
+ * ```
+ */
+export declare const format: {
+    (locale: LocaleConfig, dateFormat: DateFormat): (self: CalendarDate) => string;
+    (self: CalendarDate, locale: LocaleConfig, dateFormat: DateFormat): string;
+};
+/**
+ * Renders a calendar date through the locale's `longFormat`. Under
+ * `defaultEnglishLocale`: `"January 15, 2026"`.
  *
  * @example
  * ```ts
@@ -46,15 +233,17 @@ export declare const formatLong: {
     (self: CalendarDate, locale: LocaleConfig): string;
 };
 /**
- * Renders a calendar date in short form. Example: `"Jan 15, 2026"`.
+ * Renders a calendar date through the locale's `shortFormat`. Under
+ * `defaultEnglishLocale`: `"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"`.
+ * Renders a calendar date through the locale's `ariaLabelFormat`, suitable
+ * for `aria-label` on a grid cell. Under `defaultEnglishLocale`:
+ * `"Thursday, January 15, 2026"`.
  *
  * @example
  * ```ts
@@ -68,4 +257,24 @@ export declare const formatAriaLabel: {
     (locale: LocaleConfig): (self: CalendarDate) => string;
     (self: CalendarDate, locale: LocaleConfig): string;
 };
+/**
+ * Renders the month and year of a calendar date through the locale's
+ * `monthYearFormat`, for calendar headings and month-cell labels. Under
+ * `defaultEnglishLocale`: `"January 2026"`.
+ *
+ * The day of `self` is ignored, so callers with only a year and month can pass
+ * any valid day.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.formatMonthYear(Calendar.make(2026, 1, 1), Calendar.defaultEnglishLocale)
+ * // "January 2026"
+ * ```
+ */
+export declare const formatMonthYear: {
+    (locale: LocaleConfig): (self: CalendarDate) => string;
+    (self: CalendarDate, locale: LocaleConfig): string;
+};
 //# sourceMappingURL=locale.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/calendar/locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA4BrD;;;;;;;;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"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/calendar/locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,MAAM,EAAQ,MAAM,QAAQ,CAAA;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA8BrD;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;QAUJ,IAAI;;EACnB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;QAxBN,IAAI;;GAwBmC,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAS3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;YApDR,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8DnB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAoElC,CAAA;AAkDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAA;IAC9E,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAAA;CAS3E,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;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;CAGnD,CAAA;AAED;;;GAGG;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;CAGnD,CAAA;AAED;;;;;;;;;;;;GAYG;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;CAGnD,CAAA;AAED;;;;;;;;;;;;;;;GAeG;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;CAGnD,CAAA"}

package/dist/calendar/locale.js

@@ -1,4 +1,5 @@
-import { Function, Schema } from 'effect';
+import { Array, Function, Option, Schema, pipe } from 'effect';
+import { defineTaggedUnion } from '../schema/index.js';
 import { DayOfWeek, dayOfWeek } from './info.js';
 const twelveStrings = Schema.Tuple([
     Schema.String,
@@ -23,11 +24,64 @@ const sevenStrings = Schema.Tuple([
     Schema.String,
     Schema.String,
 ]);
+// DATE FORMAT
 /**
- * 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.
+ * One part of a `DateFormat`. Name parts draw from the `LocaleConfig`, number
+ * parts draw from the date, and `LiteralText` supplies separators,
+ * punctuation, or suffixes such as `年`.
+ *
+ * `MonthName`, `DayName`, and their `Short*` counterparts select from the
+ * corresponding locale name arrays. `MonthNumber` and `DayNumber` render
+ * unpadded numbers; their `Padded*` counterparts render two digits.
+ * `YearNumber` renders the full year.
+ */
+export const DatePart = defineTaggedUnion({
+    MonthName: {},
+    ShortMonthName: {},
+    MonthNumber: {},
+    PaddedMonthNumber: {},
+    DayNumber: {},
+    PaddedDayNumber: {},
+    DayName: {},
+    ShortDayName: {},
+    YearNumber: {},
+    LiteralText: { text: Schema.String },
+});
+/**
+ * A non-empty ordered list of parts rendered left to right. Because ordering
+ * lives in the data rather than in the formatting functions, a locale whose
+ * dates read day-first or year-first renders correctly without a code change.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * // "15. Januar 2026"
+ * const germanLong: Calendar.DateFormat = [
+ *   Calendar.DatePart.DayNumber(),
+ *   Calendar.DatePart.LiteralText({ text: '. ' }),
+ *   Calendar.DatePart.MonthName(),
+ *   Calendar.DatePart.LiteralText({ text: ' ' }),
+ *   Calendar.DatePart.YearNumber(),
+ * ]
+ * ```
+ */
+export const DateFormat = Schema.NonEmptyArray(DatePart);
+/** A non-empty format restricted to month and year parts. */
+export const MonthYearFormat = Schema.NonEmptyArray(DatePart.subset([
+    'MonthName',
+    'ShortMonthName',
+    'MonthNumber',
+    'PaddedMonthNumber',
+    'YearNumber',
+    'LiteralText',
+]));
+/**
+ * Locale configuration for rendering calendar dates. Contains only data: the
+ * month and day names, the first day of the week, and the `DateFormat` for
+ * each of the four shapes the formatters produce. Formatting functions
+ * (`formatLong`, `formatShort`, `formatAriaLabel`, `formatMonthYear`) 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.
@@ -38,10 +92,14 @@ export const LocaleConfig = Schema.Struct({
     shortMonthNames: twelveStrings,
     dayNames: sevenStrings,
     shortDayNames: sevenStrings,
+    longFormat: DateFormat,
+    shortFormat: DateFormat,
+    ariaLabelFormat: DateFormat,
+    monthYearFormat: MonthYearFormat,
 });
 /**
- * Default English (United States) locale. Picker components default to this
- * when no locale is passed via ViewConfig. Consumers who want a different
+ * Default English (United States) locale. Calendar components default to this
+ * when initialization receives no locale. Consumers who want a different
  * locale pass their own `LocaleConfig`.
  */
 export const defaultEnglishLocale = {
@@ -84,74 +142,85 @@ export const defaultEnglishLocale = {
         'Saturday',
     ],
     shortDayNames: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
+    longFormat: [
+        DatePart.MonthName(),
+        DatePart.LiteralText({ text: ' ' }),
+        DatePart.DayNumber(),
+        DatePart.LiteralText({ text: ', ' }),
+        DatePart.YearNumber(),
+    ],
+    shortFormat: [
+        DatePart.ShortMonthName(),
+        DatePart.LiteralText({ text: ' ' }),
+        DatePart.DayNumber(),
+        DatePart.LiteralText({ text: ', ' }),
+        DatePart.YearNumber(),
+    ],
+    ariaLabelFormat: [
+        DatePart.DayName(),
+        DatePart.LiteralText({ text: ', ' }),
+        DatePart.MonthName(),
+        DatePart.LiteralText({ text: ' ' }),
+        DatePart.DayNumber(),
+        DatePart.LiteralText({ text: ', ' }),
+        DatePart.YearNumber(),
+    ],
+    monthYearFormat: [
+        DatePart.MonthName(),
+        DatePart.LiteralText({ text: ' ' }),
+        DatePart.YearNumber(),
+    ],
 };
-const pickMonthName = (locale, month) => {
-    if (month === 1)
-        return locale.monthNames[0];
-    if (month === 2)
-        return locale.monthNames[1];
-    if (month === 3)
-        return locale.monthNames[2];
-    if (month === 4)
-        return locale.monthNames[3];
-    if (month === 5)
-        return locale.monthNames[4];
-    if (month === 6)
-        return locale.monthNames[5];
-    if (month === 7)
-        return locale.monthNames[6];
-    if (month === 8)
-        return locale.monthNames[7];
-    if (month === 9)
-        return locale.monthNames[8];
-    if (month === 10)
-        return locale.monthNames[9];
-    if (month === 11)
-        return locale.monthNames[10];
-    return locale.monthNames[11];
-};
-const pickShortMonthName = (locale, month) => {
-    if (month === 1)
-        return locale.shortMonthNames[0];
-    if (month === 2)
-        return locale.shortMonthNames[1];
-    if (month === 3)
-        return locale.shortMonthNames[2];
-    if (month === 4)
-        return locale.shortMonthNames[3];
-    if (month === 5)
-        return locale.shortMonthNames[4];
-    if (month === 6)
-        return locale.shortMonthNames[5];
-    if (month === 7)
-        return locale.shortMonthNames[6];
-    if (month === 8)
-        return locale.shortMonthNames[7];
-    if (month === 9)
-        return locale.shortMonthNames[8];
-    if (month === 10)
-        return locale.shortMonthNames[9];
-    if (month === 11)
-        return locale.shortMonthNames[10];
-    return locale.shortMonthNames[11];
-};
-const pickDayName = (locale, day) => {
-    if (day === 'Sunday')
-        return locale.dayNames[0];
-    if (day === 'Monday')
-        return locale.dayNames[1];
-    if (day === 'Tuesday')
-        return locale.dayNames[2];
-    if (day === 'Wednesday')
-        return locale.dayNames[3];
-    if (day === 'Thursday')
-        return locale.dayNames[4];
-    if (day === 'Friday')
-        return locale.dayNames[5];
-    return locale.dayNames[6];
+const pickByMonth = (names, month) => pipe(names, Array.get(month - 1), Option.getOrElse(() => Array.lastNonEmpty(names)));
+const DAY_OF_WEEK_INDEX = {
+    Sunday: 0,
+    Monday: 1,
+    Tuesday: 2,
+    Wednesday: 3,
+    Thursday: 4,
+    Friday: 5,
+    Saturday: 6,
 };
+const pickByDay = (names, day) => pipe(names, Array.get(DAY_OF_WEEK_INDEX[day]), Option.getOrElse(() => Array.lastNonEmpty(names)));
+const PAD_WIDTH = 2;
+const PAD_CHARACTER = '0';
+const toPaddedNumber = (value) => String(value).padStart(PAD_WIDTH, PAD_CHARACTER);
+const renderPart = (self, locale, part) => DatePart.match(part, {
+    MonthName: () => pickByMonth(locale.monthNames, self.month),
+    ShortMonthName: () => pickByMonth(locale.shortMonthNames, self.month),
+    MonthNumber: () => String(self.month),
+    PaddedMonthNumber: () => toPaddedNumber(self.month),
+    DayNumber: () => String(self.day),
+    PaddedDayNumber: () => toPaddedNumber(self.day),
+    DayName: () => pickByDay(locale.dayNames, dayOfWeek(self)),
+    ShortDayName: () => pickByDay(locale.shortDayNames, dayOfWeek(self)),
+    YearNumber: () => String(self.year),
+    LiteralText: ({ text }) => text,
+});
 /**
- * Renders a calendar date in long form. Example: `"January 15, 2026"`.
+ * Renders a calendar date through an arbitrary `DateFormat`. The four named
+ * formatters below are this function applied to the matching field of the
+ * `LocaleConfig`; reach for it directly when a view needs a shape the locale
+ * does not carry.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.format(Calendar.make(2026, 1, 15), Calendar.defaultEnglishLocale, [
+ *   Calendar.DatePart.YearNumber(),
+ *   Calendar.DatePart.LiteralText({ text: '-' }),
+ *   Calendar.DatePart.PaddedMonthNumber(),
+ *   Calendar.DatePart.LiteralText({ text: '-' }),
+ *   Calendar.DatePart.PaddedDayNumber(),
+ * ])
+ * // "2026-01-15"
+ * ```
+ */
+export const format = Function.dual(3, (self, locale, dateFormat) => pipe(dateFormat, Array.map(part => renderPart(self, locale, part)), Array.join('')));
+/**
+ * Renders a calendar date through the locale's `longFormat`. Under
+ * `defaultEnglishLocale`: `"January 15, 2026"`.
  *
  * @example
  * ```ts
@@ -168,14 +237,16 @@ const pickDayName = (locale, day) => {
  * // "January 15, 2026"
  * ```
  */
-export const formatLong = Function.dual(2, (self, locale) => `${pickMonthName(locale, self.month)} ${self.day}, ${self.year}`);
+export const formatLong = Function.dual(2, (self, locale) => format(self, locale, locale.longFormat));
 /**
- * Renders a calendar date in short form. Example: `"Jan 15, 2026"`.
+ * Renders a calendar date through the locale's `shortFormat`. Under
+ * `defaultEnglishLocale`: `"Jan 15, 2026"`.
  */
-export const formatShort = Function.dual(2, (self, locale) => `${pickShortMonthName(locale, self.month)} ${self.day}, ${self.year}`);
+export const formatShort = Function.dual(2, (self, locale) => format(self, locale, locale.shortFormat));
 /**
- * Renders an accessibility label for a calendar date, suitable for
- * `aria-label` on a grid cell. Example: `"Monday, January 15, 2026"`.
+ * Renders a calendar date through the locale's `ariaLabelFormat`, suitable
+ * for `aria-label` on a grid cell. Under `defaultEnglishLocale`:
+ * `"Thursday, January 15, 2026"`.
  *
  * @example
  * ```ts
@@ -185,8 +256,21 @@ export const formatShort = Function.dual(2, (self, locale) => `${pickShortMonthN
  * // "Thursday, January 15, 2026"
  * ```
  */
-export const formatAriaLabel = Function.dual(2, (self, locale) => {
-    const dayName = pickDayName(locale, dayOfWeek(self));
-    const monthName = pickMonthName(locale, self.month);
-    return `${dayName}, ${monthName} ${self.day}, ${self.year}`;
-});
+export const formatAriaLabel = Function.dual(2, (self, locale) => format(self, locale, locale.ariaLabelFormat));
+/**
+ * Renders the month and year of a calendar date through the locale's
+ * `monthYearFormat`, for calendar headings and month-cell labels. Under
+ * `defaultEnglishLocale`: `"January 2026"`.
+ *
+ * The day of `self` is ignored, so callers with only a year and month can pass
+ * any valid day.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ *
+ * Calendar.formatMonthYear(Calendar.make(2026, 1, 1), Calendar.defaultEnglishLocale)
+ * // "January 2026"
+ * ```
+ */
+export const formatMonthYear = Function.dual(2, (self, locale) => format(self, locale, locale.monthYearFormat));

package/dist/calendar/public.d.ts

@@ -1,2 +1,2 @@
-export { addDays, addMonths, addYears, between, CalendarDate, CalendarDateFromIsoString, clamp, DayOfWeek, dayOfWeek, daysInMonth, daysSince, daysUntil, defaultEnglishLocale, endOfWeek, Equivalence, firstOfMonth, formatAriaLabel, formatLong, formatShort, fromDateInZone, fromDateLocal, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isCalendarDate, isEqual, isLeapYear, lastOfMonth, LocaleConfig, make, max, min, Order, startOfWeek, subtractDays, subtractMonths, subtractYears, toDateLocal, today, } from './index.js';
+export { addDays, addMonths, addYears, between, CalendarDate, CalendarDateFromIsoString, clamp, DateFormat, DatePart, DayOfWeek, dayOfWeek, daysInMonth, daysSince, daysUntil, defaultEnglishLocale, endOfWeek, Equivalence, firstOfMonth, format, formatAriaLabel, formatLong, formatMonthYear, formatShort, fromDateInZone, fromDateLocal, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isCalendarDate, isEqual, isLeapYear, lastOfMonth, LocaleConfig, make, max, min, MonthYearFormat, Order, startOfWeek, subtractDays, subtractMonths, subtractYears, toDateLocal, today, } from './index.js';
 //# sourceMappingURL=public.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/calendar/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,yBAAyB,EACzB,KAAK,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,OAAO,EACP,cAAc,EACd,QAAQ,EACR,eAAe,EACf,cAAc,EACd,OAAO,EACP,UAAU,EACV,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,GAAG,EACH,GAAG,EACH,KAAK,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,KAAK,GACN,MAAM,YAAY,CAAA"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/calendar/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,yBAAyB,EACzB,KAAK,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,EACN,eAAe,EACf,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,aAAa,EACb,OAAO,EACP,cAAc,EACd,QAAQ,EACR,eAAe,EACf,cAAc,EACd,OAAO,EACP,UAAU,EACV,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,GAAG,EACH,GAAG,EACH,eAAe,EACf,KAAK,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,KAAK,GACN,MAAM,YAAY,CAAA"}

package/dist/calendar/public.js

@@ -1 +1 @@
-export { addDays, addMonths, addYears, between, CalendarDate, CalendarDateFromIsoString, clamp, DayOfWeek, dayOfWeek, daysInMonth, daysSince, daysUntil, defaultEnglishLocale, endOfWeek, Equivalence, firstOfMonth, formatAriaLabel, formatLong, formatShort, fromDateInZone, fromDateLocal, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isCalendarDate, isEqual, isLeapYear, lastOfMonth, LocaleConfig, make, max, min, Order, startOfWeek, subtractDays, subtractMonths, subtractYears, toDateLocal, today, } from './index.js';
+export { addDays, addMonths, addYears, between, CalendarDate, CalendarDateFromIsoString, clamp, DateFormat, DatePart, DayOfWeek, dayOfWeek, daysInMonth, daysSince, daysUntil, defaultEnglishLocale, endOfWeek, Equivalence, firstOfMonth, format, formatAriaLabel, formatLong, formatMonthYear, formatShort, fromDateInZone, fromDateLocal, isAfter, isAfterOrEqual, isBefore, isBeforeOrEqual, isCalendarDate, isEqual, isLeapYear, lastOfMonth, LocaleConfig, make, max, min, MonthYearFormat, Order, startOfWeek, subtractDays, subtractMonths, subtractYears, toDateLocal, today, } from './index.js';

package/dist/command/index.d.ts

@@ -172,18 +172,20 @@ export declare function define<const Name extends string, const Messages extends
     interrupt?: never;
     execute: Eff;
 }>): CommandDefinitionNoArgs<Name, Eff>;
-/** Transforms the Effect inside a Command while preserving its name, args, and
- *  message-mapping chain. Reach for this to adjust the Effect itself (provide a
- *  service, add a delay or retry), not to lift the result Message. Never use it
- *  to transform the result Message, even via
- *  `Effect.map(childMessage => Parent({ childMessage }))`. That dispatches
+/** Transforms the Effect inside a Command while preserving its result Message,
+ *  name, args, and message-mapping chain. Reach for this to provide a service,
+ *  add a delay or retry, or change the error or requirement channel. Its type
+ *  prevents the transform from changing the result Message. Never use it to
+ *  lift that Message, even via
+ *  `Effect.map(message => Message.GotChildMessage({ message }))`. That dispatches
  *  correctly in production but is invisible to `Story`/`Scene` `resolve`, which
  *  replays only the recorded chain and never runs the Effect, so the test would
  *  see the child's raw Message instead of the wrapped one. Lift result Messages
- *  with {@link mapMessage} / {@link mapMessages}, which record the lift. */
+ *  with {@link mapMessage} / {@link mapMessages}, which record the lift. The
+ *  `foldkit/prefer-command-mapmessage` lint rule flags this misuse. */
 export declare const mapEffect: {
-    <A, E1, R1, B, E2, R2>(f: (effect: Effect.Effect<A, E1, R1>) => Effect.Effect<B, E2, R2>): (command: Command<A, E1, R1>) => Command<B, E2, R2>;
-    <A, E1, R1, B, E2, R2>(command: Command<A, E1, R1>, f: (effect: Effect.Effect<A, E1, R1>) => Effect.Effect<B, E2, R2>): Command<B, E2, R2>;
+    <A, E1, R1, E2, R2>(f: (effect: Effect.Effect<A, E1, R1>) => Effect.Effect<NoInfer<A>, E2, R2>): (command: Command<A, E1, R1>) => Command<A, E2, R2>;
+    <A, E1, R1, E2, R2>(command: Command<A, E1, R1>, f: (effect: Effect.Effect<A, E1, R1>) => Effect.Effect<NoInfer<A>, E2, R2>): Command<A, E2, R2>;
 };
 /** Lifts a single Command's result Message through `f`, transforming
  *  `FromMessage` to `ToMessage`. The singular complement to