foldkit 0.60.0 → 0.62.0

package/dist/calendar/locale.js

@@ -0,0 +1,171 @@
+import { Function, Schema as S } from 'effect';
+import { DayOfWeek, dayOfWeek } from './info';
+const twelveStrings = S.Tuple(S.String, S.String, S.String, S.String, S.String, S.String, S.String, S.String, S.String, S.String, S.String, S.String);
+const sevenStrings = S.Tuple(S.String, S.String, S.String, S.String, S.String, S.String, S.String);
+/**
+ * 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 const LocaleConfig = S.Struct({
+    firstDayOfWeek: DayOfWeek,
+    monthNames: twelveStrings,
+    shortMonthNames: twelveStrings,
+    dayNames: sevenStrings,
+    shortDayNames: sevenStrings,
+});
+/**
+ * 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 const defaultEnglishLocale = {
+    firstDayOfWeek: 'Sunday',
+    monthNames: [
+        'January',
+        'February',
+        'March',
+        'April',
+        'May',
+        'June',
+        'July',
+        'August',
+        'September',
+        'October',
+        'November',
+        'December',
+    ],
+    shortMonthNames: [
+        'Jan',
+        'Feb',
+        'Mar',
+        'Apr',
+        'May',
+        'Jun',
+        'Jul',
+        'Aug',
+        'Sep',
+        'Oct',
+        'Nov',
+        'Dec',
+    ],
+    dayNames: [
+        'Sunday',
+        'Monday',
+        'Tuesday',
+        'Wednesday',
+        'Thursday',
+        'Friday',
+        'Saturday',
+    ],
+    shortDayNames: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
+};
+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];
+};
+/**
+ * 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 const formatLong = Function.dual(2, (self, locale) => `${pickMonthName(locale, self.month)} ${self.day}, ${self.year}`);
+/**
+ * Renders a calendar date in short form. Example: `"Jan 15, 2026"`.
+ */
+export const formatShort = Function.dual(2, (self, locale) => `${pickShortMonthName(locale, self.month)} ${self.day}, ${self.year}`);
+/**
+ * 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 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}`;
+});

package/dist/calendar/public.d.ts

@@ -0,0 +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';
+//# sourceMappingURL=public.d.ts.map

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

@@ -0,0 +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,SAAS,CAAA"}

package/dist/calendar/public.js

@@ -0,0 +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';

package/dist/calendar/today.d.ts

@@ -0,0 +1,41 @@
+import { Effect } from 'effect';
+/**
+ * Effect-based accessors for the current calendar date. Uses Effect's `Clock`
+ * service under the hood, so tests can freeze time with `TestClock` and
+ * production uses the real system clock.
+ *
+ * This is the **only** impurity boundary in the calendar module — every
+ * other function in this module is referentially transparent.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { Effect } from 'effect'
+ *
+ * const program = Effect.gen(function* () {
+ *   const today = yield* Calendar.today.local
+ *   const nycToday = yield* Calendar.today.inZone('America/New_York')
+ *   return { today, nycToday }
+ * })
+ * ```
+ */
+export declare const today: {
+    /**
+     * The current calendar date in the browser's local timezone.
+     */
+    local: Effect.Effect<{
+        readonly year: number;
+        readonly month: number;
+        readonly day: number;
+    }, never, never>;
+    /**
+     * The current calendar date in a specific IANA timezone
+     * (e.g. `"America/New_York"`, `"Europe/London"`, `"Asia/Tokyo"`).
+     */
+    inZone: (timeZone: string) => Effect.Effect<{
+        readonly year: number;
+        readonly month: number;
+        readonly day: number;
+    }, never, never>;
+};
+//# sourceMappingURL=today.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"today.d.ts","sourceRoot":"","sources":["../../src/calendar/today.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAA;AAQtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK;IAChB;;OAEG;;;;;;IAMH;;;OAGG;uBACgB,MAAM;;;;;CAK1B,CAAA"}

package/dist/calendar/today.js

@@ -0,0 +1,33 @@
+import { Clock, Effect } from 'effect';
+import { fromDateInZone, fromDateLocal, } from './calendarDate';
+/**
+ * Effect-based accessors for the current calendar date. Uses Effect's `Clock`
+ * service under the hood, so tests can freeze time with `TestClock` and
+ * production uses the real system clock.
+ *
+ * This is the **only** impurity boundary in the calendar module — every
+ * other function in this module is referentially transparent.
+ *
+ * @example
+ * ```ts
+ * import { Calendar } from 'foldkit'
+ * import { Effect } from 'effect'
+ *
+ * const program = Effect.gen(function* () {
+ *   const today = yield* Calendar.today.local
+ *   const nycToday = yield* Calendar.today.inZone('America/New_York')
+ *   return { today, nycToday }
+ * })
+ * ```
+ */
+export const today = {
+    /**
+     * The current calendar date in the browser's local timezone.
+     */
+    local: Effect.map(Clock.currentTimeMillis, (millis) => fromDateLocal(new Date(millis))),
+    /**
+     * The current calendar date in a specific IANA timezone
+     * (e.g. `"America/New_York"`, `"Europe/London"`, `"Asia/Tokyo"`).
+     */
+    inZone: (timeZone) => Effect.map(Clock.currentTimeMillis, (millis) => fromDateInZone(new Date(millis), timeZone)),
+};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * as Calendar from './calendar/public';
 export * as Command from './command/public';
 export * as ManagedResource from './managedResource/public';
 export * as FieldValidation from './fieldValidation/public';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,MAAM,CAAA;AAC1B,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,MAAM,CAAA;AAC1B,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export * as Calendar from './calendar/public';
 export * as Command from './command/public';
 export * as ManagedResource from './managedResource/public';
 export * as FieldValidation from './fieldValidation/public';

package/dist/ui/anchor.d.ts

@@ -7,12 +7,13 @@ export type AnchorConfig = Readonly<{
     padding?: number;
     portal?: boolean;
 }>;
-/** Returns insert/destroy hook callbacks that position a floating element relative to its button using Floating UI. When `interceptTab` is true (default), Tab key in portal mode refocuses the button — set to false for components like Popover where Tab should navigate naturally within the panel. When `focusAfterPosition` is true, the element is focused after the first position computation clears visibility — necessary because `visibility: hidden` elements cannot receive focus synchronously. */
+/** Returns insert/destroy hook callbacks that position a floating element relative to its button using Floating UI. When `interceptTab` is true (default), Tab key in portal mode refocuses the button — set to false for components like Popover where Tab should navigate naturally within the panel. When `focusAfterPosition` is true, the element is focused after the first position computation clears visibility — deferred via requestAnimationFrame so the element is painted before focus fires. `focusSelector` optionally targets a descendant (e.g. a calendar grid inside a popover panel) instead of the panel itself. */
 export declare const anchorHooks: (config: {
     buttonId: string;
     anchor: AnchorConfig;
     interceptTab?: boolean;
     focusAfterPosition?: boolean;
+    focusSelector?: string;
 }) => Readonly<{
     onInsert: (items: Element) => void;
     onDestroy: (items: Element) => void;

package/dist/ui/anchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../src/ui/anchor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAC,CAAA;AAmBF,kfAAkf;AAClf,eAAO,MAAM,WAAW,GAAI,QAAQ;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,KAAG,QAAQ,CAAC;IACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC,CA+EC,CAAA"}
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../src/ui/anchor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAC,CAAA;AAmBF,0mBAA0mB;AAC1mB,eAAO,MAAM,WAAW,GAAI,QAAQ;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,KAAG,QAAQ,CAAC;IACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC,CAoGC,CAAA"}

package/dist/ui/anchor.js

@@ -10,7 +10,7 @@ const getOrCreatePortalRoot = () => {
     return document.body.appendChild(root);
 };
 const anchorCleanups = new WeakMap();
-/** Returns insert/destroy hook callbacks that position a floating element relative to its button using Floating UI. When `interceptTab` is true (default), Tab key in portal mode refocuses the button — set to false for components like Popover where Tab should navigate naturally within the panel. When `focusAfterPosition` is true, the element is focused after the first position computation clears visibility — necessary because `visibility: hidden` elements cannot receive focus synchronously. */
+/** Returns insert/destroy hook callbacks that position a floating element relative to its button using Floating UI. When `interceptTab` is true (default), Tab key in portal mode refocuses the button — set to false for components like Popover where Tab should navigate naturally within the panel. When `focusAfterPosition` is true, the element is focused after the first position computation clears visibility — deferred via requestAnimationFrame so the element is painted before focus fires. `focusSelector` optionally targets a descendant (e.g. a calendar grid inside a popover panel) instead of the panel itself. */
 export const anchorHooks = (config) => ({
     onInsert: (items) => {
         const button = document.getElementById(config.buttonId);
@@ -52,11 +52,28 @@ export const anchorHooks = (config) => ({
                     isFirstUpdate = false;
                     items.style.visibility = '';
                     if (config.focusAfterPosition ?? false) {
-                        items.focus();
+                        requestAnimationFrame(() => {
+                            const target = config.focusSelector
+                                ? document.querySelector(config.focusSelector)
+                                : items;
+                            if (target instanceof HTMLElement) {
+                                target.focus();
+                            }
+                        });
                     }
                 }
             });
         });
+        const portalCleanup = isPortal
+            ? () => {
+                try {
+                    items.remove();
+                }
+                catch {
+                    // Element was already removed by a blur-triggered re-render.
+                }
+            }
+            : undefined;
         if (isPortal && shouldInterceptTab) {
             const handleTabKey = (event) => {
                 if (event instanceof KeyboardEvent && event.key === 'Tab') {
@@ -67,10 +84,14 @@ export const anchorHooks = (config) => ({
             anchorCleanups.set(items, () => {
                 floatingCleanup();
                 items.removeEventListener('keydown', handleTabKey);
+                portalCleanup?.();
             });
         }
         else {
-            anchorCleanups.set(items, floatingCleanup);
+            anchorCleanups.set(items, () => {
+                floatingCleanup();
+                portalCleanup?.();
+            });
         }
     },
     onDestroy: (items) => {

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

@@ -0,0 +1,242 @@
+import { Option, Schema as S } from 'effect';
+import * as Calendar from '../../calendar';
+import type { CalendarDate } from '../../calendar';
+import * as Command from '../../command';
+import { type Attribute, type Html } from '../../html';
+/** Schema for the calendar component's state. Tracks the visible month/year,
+ * the keyboard-focused and user-selected dates, and the configuration that
+ * governs navigation (locale, min/max, disabled days). */
+export declare const Model: S.Struct<{
+    id: typeof S.String;
+    today: S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>;
+    viewYear: typeof S.Int;
+    viewMonth: S.filter<typeof S.Int>;
+    maybeFocusedDate: S.OptionFromSelf<S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>>;
+    maybeSelectedDate: S.OptionFromSelf<S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>>;
+    isGridFocused: typeof S.Boolean;
+    locale: 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]>;
+    }>;
+    maybeMinDate: S.OptionFromSelf<S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>>;
+    maybeMaxDate: S.OptionFromSelf<S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>>;
+    disabledDaysOfWeek: S.Array$<S.Literal<["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]>>;
+    disabledDates: S.Array$<S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>>;
+}>;
+export type Model = typeof Model.Type;
+/** Sent when the user clicks a day cell in the grid. */
+export declare const ClickedDay: import("../../schema").CallableTaggedStruct<"ClickedDay", {
+    date: S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>;
+}>;
+/** Sent when the user presses a key on the grid container. The update maps
+ * the key to a navigation or selection action. */
+export declare const PressedKeyOnGrid: import("../../schema").CallableTaggedStruct<"PressedKeyOnGrid", {
+    key: typeof S.String;
+    isShift: typeof S.Boolean;
+}>;
+/** Sent when the user clicks the previous-month navigation button. */
+export declare const ClickedPreviousMonthButton: import("../../schema").CallableTaggedStruct<"ClickedPreviousMonthButton", {}>;
+/** Sent when the user clicks the next-month navigation button. */
+export declare const ClickedNextMonthButton: import("../../schema").CallableTaggedStruct<"ClickedNextMonthButton", {}>;
+/** Sent when the user picks a month from the month dropdown. */
+export declare const SelectedMonthFromDropdown: import("../../schema").CallableTaggedStruct<"SelectedMonthFromDropdown", {
+    month: typeof S.Int;
+}>;
+/** Sent when the user picks a year from the year dropdown. */
+export declare const SelectedYearFromDropdown: import("../../schema").CallableTaggedStruct<"SelectedYearFromDropdown", {
+    year: typeof S.Int;
+}>;
+/** Sent when the grid container receives DOM focus. */
+export declare const FocusedGrid: import("../../schema").CallableTaggedStruct<"FocusedGrid", {}>;
+/** Sent when the grid container loses DOM focus. */
+export declare const BlurredGrid: import("../../schema").CallableTaggedStruct<"BlurredGrid", {}>;
+/** Sent when a long-lived session's "today" reference should be refreshed. */
+export declare const RefreshedToday: import("../../schema").CallableTaggedStruct<"RefreshedToday", {
+    today: S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>;
+}>;
+/** Sent when a FocusGrid command completes. */
+export declare const CompletedFocusGrid: import("../../schema").CallableTaggedStruct<"CompletedFocusGrid", {}>;
+/** Union of all messages the calendar component can produce. */
+export declare const Message: S.Union<[import("../../schema").CallableTaggedStruct<"ClickedDay", {
+    date: S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>;
+}>, import("../../schema").CallableTaggedStruct<"PressedKeyOnGrid", {
+    key: typeof S.String;
+    isShift: typeof S.Boolean;
+}>, import("../../schema").CallableTaggedStruct<"ClickedPreviousMonthButton", {}>, import("../../schema").CallableTaggedStruct<"ClickedNextMonthButton", {}>, import("../../schema").CallableTaggedStruct<"SelectedMonthFromDropdown", {
+    month: typeof S.Int;
+}>, import("../../schema").CallableTaggedStruct<"SelectedYearFromDropdown", {
+    year: typeof S.Int;
+}>, import("../../schema").CallableTaggedStruct<"FocusedGrid", {}>, import("../../schema").CallableTaggedStruct<"BlurredGrid", {}>, import("../../schema").CallableTaggedStruct<"RefreshedToday", {
+    today: S.filter<S.Struct<{
+        year: typeof S.Int;
+        month: S.filter<typeof S.Int>;
+        day: S.filter<typeof S.Int>;
+    }>>;
+}>, import("../../schema").CallableTaggedStruct<"CompletedFocusGrid", {}>]>;
+export type Message = typeof Message.Type;
+/** Emitted when the visible month changes due to navigation. Consumers of an
+ * inline calendar may use this to load month-scoped data (holidays, events).
+ *
+ * Date selection does NOT use OutMessage — consumers subscribe via the
+ * `onSelectedDate` callback in `ViewConfig`, matching the Listbox/Popover
+ * controlled-component pattern. Use `Calendar.selectDate(model, date)` to
+ * write back when handling the callback. */
+export declare const ChangedViewMonth: import("../../schema").CallableTaggedStruct<"ChangedViewMonth", {
+    year: typeof S.Int;
+    month: typeof S.Int;
+}>;
+/** The calendar's OutMessage. Only one variant — `ChangedViewMonth` — which
+ * fires when navigation shifts the visible month. Date selection goes through
+ * the `onSelectedDate` ViewConfig callback, not OutMessage. */
+export declare const OutMessage: import("../../schema").CallableTaggedStruct<"ChangedViewMonth", {
+    year: typeof S.Int;
+    month: typeof S.Int;
+}>;
+export type OutMessage = typeof OutMessage.Type;
+/** Configuration for creating a calendar model with `init`. */
+export type InitConfig = Readonly<{
+    id: string;
+    today: CalendarDate;
+    initialSelectedDate?: CalendarDate;
+    locale?: Calendar.LocaleConfig;
+    minDate?: CalendarDate;
+    maxDate?: CalendarDate;
+    disabledDaysOfWeek?: ReadonlyArray<Calendar.DayOfWeek>;
+    disabledDates?: ReadonlyArray<CalendarDate>;
+}>;
+/** Creates an initial calendar model. The view month defaults to the month
+ * of the initial selected date, or today if no date is pre-selected. */
+export declare const init: (config: InitConfig) => Model;
+type UpdateReturn = readonly [
+    Model,
+    ReadonlyArray<Command.Command<Message>>,
+    Option.Option<OutMessage>
+];
+/** Focuses the calendar grid container. */
+export declare const FocusGrid: Command.CommandDefinition<"FocusGrid", {
+    readonly _tag: "CompletedFocusGrid";
+}>;
+/** Builds a command that focuses the calendar grid container. Parent
+ * components like DatePicker dispatch this after opening to hand focus to
+ * the grid's keyboard layer. */
+export declare const focusGrid: (modelId: string) => Command.Command<Message>;
+/** Programmatically selects a date on the calendar, committing it as the
+ * chosen value and moving the cursor onto it. Use this in controlled-mode
+ * handlers (when the view's `onSelectedDate` callback is provided) to write
+ * the selection back to the calendar's internal state.
+ *
+ * Equivalent to dispatching `ClickedDay({ date })` through `update`. */
+export declare const selectDate: (model: Model, date: CalendarDate) => UpdateReturn;
+/** Processes a calendar message and returns the next model, commands, and
+ * optional OutMessage. */
+export declare const update: (model: Model, message: Message) => UpdateReturn;
+/** Information about a single day cell in the rendered calendar grid. */
+export type DayCell<ParentMessage> = Readonly<{
+    date: CalendarDate;
+    label: string;
+    cellAttributes: ReadonlyArray<Attribute<ParentMessage>>;
+    buttonAttributes: ReadonlyArray<Attribute<ParentMessage>>;
+    isSelected: boolean;
+    isFocused: boolean;
+    isToday: boolean;
+    isInViewMonth: boolean;
+    isDisabled: boolean;
+}>;
+/** A column header for the grid's first row (day-of-week labels). */
+export type ColumnHeader<ParentMessage> = Readonly<{
+    name: string;
+    attributes: ReadonlyArray<Attribute<ParentMessage>>;
+}>;
+/** A single week row in the calendar grid, carrying its own row attributes
+ * (role, aria-rowindex) alongside its 7 day cells. */
+export type Week<ParentMessage> = Readonly<{
+    attributes: ReadonlyArray<Attribute<ParentMessage>>;
+    cells: ReadonlyArray<DayCell<ParentMessage>>;
+}>;
+/** Attribute groups and derived data the calendar component provides to the
+ * consumer's `toView` callback. */
+export type CalendarAttributes<ParentMessage> = Readonly<{
+    root: ReadonlyArray<Attribute<ParentMessage>>;
+    previousMonthButton: ReadonlyArray<Attribute<ParentMessage>>;
+    nextMonthButton: ReadonlyArray<Attribute<ParentMessage>>;
+    heading: Readonly<{
+        id: string;
+        text: string;
+    }>;
+    monthSelect: ReadonlyArray<Attribute<ParentMessage>>;
+    monthOptions: ReadonlyArray<Readonly<{
+        value: number;
+        label: string;
+    }>>;
+    yearSelect: ReadonlyArray<Attribute<ParentMessage>>;
+    yearOptions: ReadonlyArray<number>;
+    grid: ReadonlyArray<Attribute<ParentMessage>>;
+    headerRow: ReadonlyArray<Attribute<ParentMessage>>;
+    columnHeaders: ReadonlyArray<ColumnHeader<ParentMessage>>;
+    weeks: ReadonlyArray<Week<ParentMessage>>;
+}>;
+/** Configuration for rendering a calendar with `view`. */
+export type ViewConfig<ParentMessage> = Readonly<{
+    model: Model;
+    toParentMessage: (message: Message) => ParentMessage;
+    toView: (attributes: CalendarAttributes<ParentMessage>) => Html;
+    /** Optional callback invoked when the user commits a date via click, Enter,
+     * or Space. When provided, the view dispatches the callback directly (the
+     * controlled pattern — parent owns the event). When omitted, the calendar
+     * manages its own `maybeSelectedDate` state automatically (uncontrolled).
+     * In controlled mode, use `Calendar.selectDate(model, date)` to write the
+     * selection back to the calendar's internal state. */
+    onSelectedDate?: (date: CalendarDate) => ParentMessage;
+    previousMonthLabel?: string;
+    nextMonthLabel?: string;
+    monthSelectLabel?: string;
+    yearSelectLabel?: string;
+}>;
+/** Renders an accessible calendar grid. Builds ARIA attribute groups (grid,
+ * row, gridcell, column header) plus the derived month grid, then delegates
+ * layout to the consumer's `toView` callback. */
+export declare const view: <ParentMessage>(config: ViewConfig<ParentMessage>) => Html;
+/** Creates a memoized calendar view. Static config is captured in a closure;
+ *  only `model` and `toParentMessage` are compared per render via `createLazy`. */
+export declare const lazy: <ParentMessage>(staticConfig: Omit<ViewConfig<ParentMessage>, "model" | "toParentMessage">) => ((model: Model, toParentMessage: ViewConfig<ParentMessage>["toParentMessage"]) => Html);
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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