@sixthshift/design-system 0.2.1 → 0.4.0

package/dist/components/Calendar/CalendarView.js

@@ -0,0 +1,263 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * CalendarView — the Temporal-typed calendar grid.
+ *
+ * Internal. Not reachable through the package's `exports` map: `./calendar`
+ * resolves to this directory's `index.ts`, which deliberately does not re-export
+ * it. Every picker composes this directly so that values cross the ISO boundary
+ * exactly once, at the picker's own edge, rather than being serialised and
+ * re-parsed on the way down to the grid.
+ *
+ * The public, ISO-typed `Calendar` is a thin wrapper in ./Calendar.tsx.
+ */
+import { cn } from "@sixthshift/design-system/utils";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import * as React from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { addDays, addMonths, endOfWeek, formatMonthYear, isPlainDate, isSameMonth, parseDate, startOfMonth, startOfWeek, today, } from "../../date-time/index.js";
+import { Button } from "../Button/index.js";
+import { Separator } from "../Separator/index.js";
+import { defaultFormatDisplay, getDateSelectionState, isBeforeTemporal, isDateDisabled, isSameDateTemporal, temporalToISO, useCalendarDays, } from "./calendar.hooks.js";
+const DAY_LABELS = ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"];
+function getDayLabels(weekStartsOn) {
+    return [...DAY_LABELS.slice(weekStartsOn), ...DAY_LABELS.slice(0, weekStartsOn)];
+}
+function getRangePositionClasses(rangePosition, isSelected) {
+    if (!isSelected)
+        return "";
+    switch (rangePosition) {
+        case "start":
+            return "rounded-l-full rounded-r-none bg-bg-brand text-fg-on-brand";
+        case "end":
+            return "rounded-r-full rounded-l-none bg-bg-brand text-fg-on-brand";
+        case "middle":
+            return "rounded-none bg-bg-brand-subtle text-fg-normal";
+        case "single":
+            return "bg-bg-brand text-fg-on-brand";
+        default:
+            return "";
+    }
+}
+export const CalendarView = React.forwardRef((props, ref) => {
+    const { mode, month, onMonthChange, minDate, maxDate, disabled, weekStartsOn = 0, autoFocusDay = false, showFooter = false, showToday = true, onApply, onCancel, className, } = props;
+    // Get mode-specific props
+    const value = "value" in props ? props.value : undefined;
+    const onSelect = "onSelect" in props ? props.onSelect : undefined;
+    const presets = "presets" in props ? props.presets : undefined;
+    const max = mode === "multiple" && "max" in props ? props.max : undefined;
+    // Selection handler
+    const handleSelect = useCallback((temporalDate) => {
+        if (!onSelect)
+            return;
+        if (mode === "single") {
+            const currentValue = value;
+            if (currentValue && isSameDateTemporal(temporalDate, currentValue)) {
+                onSelect(undefined);
+            }
+            else {
+                onSelect(temporalDate);
+            }
+            return;
+        }
+        if (mode === "multiple") {
+            const currentValue = value || [];
+            const existingIndex = currentValue.findIndex((d) => isSameDateTemporal(temporalDate, d));
+            if (existingIndex >= 0) {
+                onSelect(currentValue.filter((_, i) => i !== existingIndex));
+            }
+            else if (!max || currentValue.length < max) {
+                onSelect([...currentValue, temporalDate]);
+            }
+            return;
+        }
+        // Range mode
+        const currentRange = value || {
+            from: undefined,
+            to: undefined,
+        };
+        if (!currentRange.from) {
+            onSelect({ from: temporalDate, to: undefined });
+            return;
+        }
+        if (!currentRange.to) {
+            if (isBeforeTemporal(temporalDate, currentRange.from)) {
+                onSelect({ from: temporalDate, to: currentRange.from });
+            }
+            else {
+                onSelect({ from: currentRange.from, to: temporalDate });
+            }
+            return;
+        }
+        onSelect({ from: temporalDate, to: undefined });
+    }, [mode, value, onSelect, max]);
+    // Today button
+    const handleToday = useCallback(() => {
+        if (!onSelect)
+            return;
+        const todayDate = today();
+        if (mode === "single") {
+            onSelect(todayDate);
+        }
+        else if (mode === "multiple") {
+            const current = value || [];
+            if (!current.some((d) => isSameDateTemporal(d, todayDate))) {
+                if (!max || current.length < max) {
+                    onSelect([...current, todayDate]);
+                }
+            }
+        }
+        onMonthChange(todayDate);
+    }, [mode, value, onSelect, max, onMonthChange]);
+    // Preset selection
+    const handlePresetClick = useCallback((preset) => {
+        if (!onSelect)
+            return;
+        if (mode === "single" && isPlainDate(preset.value)) {
+            onSelect(preset.value);
+        }
+        else if (mode === "range" && typeof preset.value === "object" && preset.value !== null && "from" in preset.value) {
+            onSelect(preset.value);
+        }
+        else if (mode === "multiple" && Array.isArray(preset.value)) {
+            onSelect(preset.value);
+        }
+    }, [mode, onSelect]);
+    // Calendar navigation
+    const handlePrevMonth = () => onMonthChange(addMonths(month, -1));
+    const handleNextMonth = () => onMonthChange(addMonths(month, 1));
+    const days = useCalendarDays(month, weekStartsOn);
+    const dayLabels = getDayLabels(weekStartsOn);
+    const handleDayClick = (date) => {
+        if (!isDateDisabled(date, disabled, minDate, maxDate)) {
+            handleSelect(date);
+        }
+    };
+    // ---------------------------------------------------------------------------
+    // Roving focus
+    //
+    // A grid is a single tab stop: exactly one cell carries tabIndex={0} and the
+    // arrow keys move between cells. `focusedDate` is null until the user actually
+    // navigates, so we never steal focus on mount.
+    // ---------------------------------------------------------------------------
+    const [focusedDate, setFocusedDate] = useState(null);
+    const gridRef = useRef(null);
+    const firstSelected = useMemo(() => {
+        if (mode === "single")
+            return isPlainDate(value) ? value : undefined;
+        if (mode === "multiple")
+            return value?.[0];
+        return value?.from;
+    }, [mode, value]);
+    const activeDate = useMemo(() => {
+        const isUsable = (date) => isSameMonth(date, month) && !isDateDisabled(date, disabled, minDate, maxDate);
+        // Prefer where the user last was, then their selection, then today.
+        for (const candidate of [focusedDate, firstSelected, today()]) {
+            if (candidate && isUsable(candidate))
+                return candidate;
+        }
+        // Otherwise the first day of the month that can actually take focus, so the
+        // grid never ends up with zero tab stops.
+        const first = startOfMonth(month);
+        for (let i = 0; i < first.daysInMonth; i++) {
+            const candidate = addDays(first, i);
+            if (isUsable(candidate))
+                return candidate;
+        }
+        return first;
+    }, [focusedDate, firstSelected, month, disabled, minDate, maxDate]);
+    const moveFocus = useCallback((next) => {
+        setFocusedDate(next);
+        if (!isSameMonth(next, month))
+            onMonthChange(next);
+    }, [month, onMonthChange]);
+    const handleGridKeyDown = useCallback((event) => {
+        // Navigate from the cell that actually has focus, not from the derived
+        // tab stop — otherwise focusing a day without selecting it would make the
+        // arrow keys jump back to today.
+        const focusedIso = event.target?.closest?.("[data-date]")?.getAttribute("data-date");
+        const origin = focusedIso ? parseDate(focusedIso) : activeDate;
+        const dayStep = { ArrowLeft: -1, ArrowRight: 1, ArrowUp: -7, ArrowDown: 7 };
+        const step = dayStep[event.key];
+        if (step !== undefined) {
+            event.preventDefault();
+            moveFocus(addDays(origin, step));
+            return;
+        }
+        switch (event.key) {
+            case "Home":
+                event.preventDefault();
+                moveFocus(startOfWeek(origin, weekStartsOn));
+                break;
+            case "End":
+                event.preventDefault();
+                moveFocus(endOfWeek(origin, weekStartsOn));
+                break;
+            case "PageUp":
+                event.preventDefault();
+                moveFocus(addMonths(origin, -1));
+                break;
+            case "PageDown":
+                event.preventDefault();
+                moveFocus(addMonths(origin, 1));
+                break;
+            default:
+                break;
+        }
+    }, [activeDate, moveFocus, weekStartsOn]);
+    // Follow the roving tabIndex with real DOM focus, but only once the user has
+    // started navigating.
+    useEffect(() => {
+        if (!focusedDate)
+            return;
+        gridRef.current?.querySelector(`[data-date="${temporalToISO(focusedDate)}"]`)?.focus();
+    }, [focusedDate]);
+    // Seed that focus once when the caller asked for it. Deliberately keyed on
+    // `autoFocusDay` alone: `activeDate` changes as the user navigates, and
+    // re-running then would drag focus back to where it started.
+    // biome-ignore lint/correctness/useExhaustiveDependencies: see above
+    useEffect(() => {
+        if (autoFocusDay)
+            setFocusedDate((current) => current ?? activeDate);
+    }, [autoFocusDay]);
+    // useCalendarDays always returns 42 days, so this is always 6 rows of 7.
+    const weeks = useMemo(() => {
+        const chunked = [];
+        for (let i = 0; i < days.length; i += 7)
+            chunked.push(days.slice(i, i + 7));
+        return chunked;
+    }, [days]);
+    // Check if a preset is currently active
+    const isPresetActive = useCallback((preset) => {
+        if (mode === "single" && isPlainDate(preset.value)) {
+            return isPlainDate(value) && isSameDateTemporal(value, preset.value);
+        }
+        if (mode === "range" && typeof preset.value === "object" && preset.value !== null && "from" in preset.value) {
+            const draft = value;
+            const presetVal = preset.value;
+            const fromMatch = (!draft?.from && !presetVal.from) || (draft?.from && presetVal.from && isSameDateTemporal(draft.from, presetVal.from));
+            const toMatch = (!draft?.to && !presetVal.to) || (draft?.to && presetVal.to && isSameDateTemporal(draft.to, presetVal.to));
+            return Boolean(fromMatch && toMatch);
+        }
+        if (mode === "multiple" && Array.isArray(preset.value)) {
+            const draft = value || [];
+            const presetVal = preset.value;
+            return draft.length === presetVal.length && draft.every((d) => presetVal.some((p) => isSameDateTemporal(d, p)));
+        }
+        return false;
+    }, [mode, value]);
+    return (_jsxs("div", { ref: ref, className: cn("flex", className), children: [presets && presets.length > 0 && (_jsx("div", { className: "mr-3 flex flex-col gap-1 border-border-normal border-r pr-3", children: presets.map((preset) => (_jsx("button", { type: "button", onClick: () => handlePresetClick(preset), className: cn(`rounded-md px-3 py-1.5 text-left text-sm transition-colors`, `hover:bg-bg-subtle focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-focus-ring focus-visible:ring-inset`, isPresetActive(preset) && "bg-bg-brand-subtle text-fg-brand"), children: preset.label }, preset.label))) })), _jsxs("div", { className: "flex flex-col gap-3", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("button", { type: "button", onClick: handlePrevMonth, className: "rounded-lg p-2 text-fg-subtle hover:bg-bg-subtle hover:text-fg-normal focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-focus-ring", "aria-label": "Previous month", children: _jsx(ChevronLeft, { className: "h-5 w-5" }) }), _jsx("span", { className: "font-semibold text-sm", children: formatMonthYear(month) }), _jsx("button", { type: "button", onClick: handleNextMonth, className: "rounded-lg p-2 text-fg-subtle hover:bg-bg-subtle hover:text-fg-normal focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-focus-ring", "aria-label": "Next month", children: _jsx(ChevronRight, { className: "h-5 w-5" }) })] }), _jsxs("table", { ref: gridRef, role: "grid", "aria-label": formatMonthYear(month), className: "border-separate border-spacing-1", onKeyDown: handleGridKeyDown, children: [_jsx("thead", { children: _jsx("tr", { children: dayLabels.map((label) => (_jsx("th", { scope: "col", className: "h-10 w-10 font-medium text-fg-subtle text-sm", children: label }, label))) }) }), _jsx("tbody", { children: weeks.map((week) => (_jsx("tr", { children: week.map((day) => {
+                                        const isDisabledDay = isDateDisabled(day.date, disabled, minDate, maxDate);
+                                        const selectionState = getDateSelectionState(day.date, mode, value);
+                                        if (!day.isCurrentMonth) {
+                                            return _jsx("td", { className: "h-10 w-10" }, temporalToISO(day.date));
+                                        }
+                                        return (
+                                        // Biome resolves <td> to role "cell" because it does not track the
+                                        // ancestor role="grid", under which a <td> is a gridcell and
+                                        // aria-selected is valid. axe, which does track it, passes.
+                                        // biome-ignore lint/a11y/useAriaPropsSupportedByRole: <td> in a grid is a gridcell
+                                        _jsx("td", { "aria-selected": selectionState.isSelected, className: "p-0", children: _jsx("button", { type: "button", "data-date": temporalToISO(day.date), onClick: () => handleDayClick(day.date), disabled: isDisabledDay, tabIndex: isSameDateTemporal(day.date, activeDate) ? 0 : -1, className: cn(`flex h-10 w-10 cursor-pointer items-center justify-center rounded-full text-sm transition-colors`, `hover:bg-bg-brand-strong hover:text-fg-on-brand-strong focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-focus-ring focus-visible:ring-inset`, day.isToday && !selectionState.isSelected && "font-medium ring-1 ring-border-normal ring-inset", isDisabledDay && "cursor-not-allowed opacity-50", getRangePositionClasses(selectionState.rangePosition, selectionState.isSelected)), "aria-label": defaultFormatDisplay(day.date), children: day.date.day }) }, temporalToISO(day.date)));
+                                    }) }, temporalToISO(week[0].date)))) })] }), showFooter && (_jsxs(_Fragment, { children: [_jsx(Separator, {}), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("div", { children: showToday && mode !== "range" && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: handleToday, children: "Today" })) }), _jsxs("div", { className: "flex gap-2", children: [onCancel && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: onCancel, children: "Cancel" })), onApply && (_jsx(Button, { type: "button", variant: "solid", intent: "brand", size: "sm", onClick: onApply, children: "Apply" }))] })] })] }))] })] }));
+});
+CalendarView.displayName = "CalendarView";
+//# sourceMappingURL=CalendarView.js.map

package/dist/components/Calendar/CalendarView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalendarView.js","sourceRoot":"","sources":["../../../src/components/Calendar/CalendarView.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,iCAAiC,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EACL,OAAO,EACP,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EAEX,KAAK,GACN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAEvE,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,uBAAuB,CAAC,aAA4B,EAAE,UAAmB;IAChF,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAE3B,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,4DAA4D,CAAC;QACtE,KAAK,KAAK;YACR,OAAO,4DAA4D,CAAC;QACtE,KAAK,QAAQ;YACX,OAAO,gDAAgD,CAAC;QAC1D,KAAK,QAAQ;YACX,OAAO,8BAA8B,CAAC;QACxC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAoC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC7F,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,aAAa,EACb,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,GAAG,CAAC,EAChB,YAAY,GAAG,KAAK,EACpB,UAAU,GAAG,KAAK,EAClB,SAAS,GAAG,IAAI,EAChB,OAAO,EACP,QAAQ,EACR,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,0BAA0B;IAC1B,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,QAAQ,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,OAAO,GAAG,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAI,KAAK,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1E,oBAAoB;IACpB,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,YAAgC,EAAE,EAAE;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,KAAuC,CAAC;YAC7D,IAAI,YAAY,IAAI,kBAAkB,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;gBAClE,QAA2D,CAAC,SAAS,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACL,QAA2D,CAAC,YAAY,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,YAAY,GAAI,KAA8B,IAAI,EAAE,CAAC;YAC3D,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;YAEzF,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;gBACtB,QAAkD,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC;YAC1G,CAAC;iBAAM,IAAI,CAAC,GAAG,IAAI,YAAY,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC5C,QAAkD,CAAC,CAAC,GAAG,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;YACvF,CAAC;YACD,OAAO;QACT,CAAC;QAED,aAAa;QACb,MAAM,YAAY,GAAI,KAAwB,IAAI;YAChD,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,SAAS;SACd,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACtB,QAAwD,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACjG,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YACrB,IAAI,gBAAgB,CAAC,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrD,QAAwD,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3G,CAAC;iBAAM,CAAC;gBACL,QAAwD,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3G,CAAC;YACD,OAAO;QACT,CAAC;QAEA,QAAwD,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACnG,CAAC,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAC7B,CAAC;IAEF,eAAe;IACf,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrB,QAA2D,CAAC,SAAS,CAAC,CAAC;QAC1E,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAI,KAA8B,IAAI,EAAE,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;gBAC3D,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBAChC,QAAkD,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC/E,CAAC;YACH,CAAC;QACH,CAAC;QACD,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IAEhD,mBAAmB;IACnB,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,MAA6B,EAAE,EAAE;QAChC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,QAA2D,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClH,QAAwD,CAAC,MAAM,CAAC,KAAuB,CAAC,CAAC;QAC5F,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,QAAkD,CAAC,MAAM,CAAC,KAA6B,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC,EACD,CAAC,IAAI,EAAE,QAAQ,CAAC,CACjB,CAAC;IAEF,sBAAsB;IACtB,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjE,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,YAAyC,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE7C,MAAM,cAAc,GAAG,CAAC,IAAwB,EAAE,EAAE;QAClD,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YACtD,YAAY,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,8EAA8E;IAC9E,eAAe;IACf,EAAE;IACF,6EAA6E;IAC7E,+EAA+E;IAC/E,+CAA+C;IAC/C,8EAA8E;IAC9E,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAA4B,IAAI,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,MAAM,CAAmB,IAAI,CAAC,CAAC;IAE/C,MAAM,aAAa,GAAG,OAAO,CAAC,GAAmC,EAAE;QACjE,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,IAAI,IAAI,KAAK,UAAU;YAAE,OAAQ,KAA0C,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,OAAQ,KAAoC,EAAE,IAAI,CAAC;IACrD,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAElB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,MAAM,QAAQ,GAAG,CAAC,IAAwB,EAAE,EAAE,CAC5C,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAmE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE3I,oEAAoE;QACpE,KAAK,MAAM,SAAS,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;QACzD,CAAC;QACD,4EAA4E;QAC5E,0CAA0C;QAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACpC,IAAI,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,IAAwB,EAAE,EAAE;QAC3B,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,EACD,CAAC,KAAK,EAAE,aAAa,CAAC,CACvB,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,KAA4C,EAAE,EAAE;QAC/C,uEAAuE;QACvE,0EAA0E;QAC1E,iCAAiC;QACjC,MAAM,UAAU,GAAI,KAAK,CAAC,MAA6B,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;QAC7G,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAE/D,MAAM,OAAO,GAA2B,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACpG,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAED,QAAQ,KAAK,CAAC,GAAG,EAAE,CAAC;YAClB,KAAK,MAAM;gBACT,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,KAAK;gBACR,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;gBAC3C,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjC,MAAM;YACR,KAAK,UAAU;gBACb,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC,EACD,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CACtC,CAAC;IAEF,6EAA6E;IAC7E,sBAAsB;IACtB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,OAAO,CAAC,OAAO,EAAE,aAAa,CAAoB,eAAe,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5G,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,2EAA2E;IAC3E,wEAAwE;IACxE,6DAA6D;IAC7D,qEAAqE;IACrE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY;YAAE,cAAc,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,yEAAyE;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,wCAAwC;IACxC,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,MAA6B,EAAW,EAAE;QACzC,IAAI,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5G,MAAM,KAAK,GAAG,KAAmC,CAAC;YAClD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAuB,CAAC;YACjD,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACzI,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,SAAS,CAAC,EAAE,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3H,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,KAAK,GAAI,KAA8B,IAAI,EAAE,CAAC;YACpD,MAAM,SAAS,GAAG,MAAM,CAAC,KAA6B,CAAC;YACvD,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,CAAC,IAAI,EAAE,KAAK,CAAC,CACd,CAAC;IAEF,OAAO,CACL,eAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,aAE5C,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAChC,cAAK,SAAS,EAAC,6DAA6D,YACzE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,iBAEE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,EACxC,SAAS,EAAE,EAAE,CACX,4DAA4D,EAC5D,6HAA6H,EAC7H,cAAc,CAAC,MAAM,CAAC,IAAI,kCAAkC,CAC7D,YAEA,MAAM,CAAC,KAAK,IATR,MAAM,CAAC,KAAK,CAUV,CACV,CAAC,GACE,CACP,EAGD,eAAK,SAAS,EAAC,qBAAqB,aAElC,eAAK,SAAS,EAAC,mCAAmC,aAChD,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,eAAe,EACxB,SAAS,EAAC,uJAAuJ,gBACtJ,gBAAgB,YAE3B,KAAC,WAAW,IAAC,SAAS,EAAC,SAAS,GAAG,GAC5B,EAET,eAAM,SAAS,EAAC,uBAAuB,YAAE,eAAe,CAAC,KAAK,CAAC,GAAQ,EAEvE,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,eAAe,EACxB,SAAS,EAAC,uJAAuJ,gBACtJ,YAAY,YAEvB,KAAC,YAAY,IAAC,SAAS,EAAC,SAAS,GAAG,GAC7B,IACL,EAUN,iBAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,gBAAa,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,EAAC,kCAAkC,EAAC,SAAS,EAAE,iBAAiB,aAC5I,0BACE,uBACG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACxB,aAAgB,KAAK,EAAC,KAAK,EAAC,SAAS,EAAC,8CAA8C,YACjF,KAAK,IADC,KAAK,CAET,CACN,CAAC,GACC,GACC,EACR,0BACG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,uBACG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;wCAChB,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAmE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;wCACtI,MAAM,cAAc,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;wCAEpE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;4CACxB,OAAO,aAAkC,SAAS,EAAC,WAAW,IAA9C,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAA0B,CAAC;wCACpE,CAAC;wCAED,OAAO;wCACL,mEAAmE;wCACnE,6DAA6D;wCAC7D,4DAA4D;wCAC5D,mFAAmF;wCACnF,8BAAiD,cAAc,CAAC,UAAU,EAAE,SAAS,EAAC,KAAK,YACzF,iBACE,IAAI,EAAC,QAAQ,eACF,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAClC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EACvC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC3D,SAAS,EAAE,EAAE,CACX,kGAAkG,EAClG,iKAAiK,EACjK,GAAG,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,IAAI,kDAAkD,EAC/F,aAAa,IAAI,+BAA+B,EAChD,uBAAuB,CAAC,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,UAAU,CAAC,CACjF,gBACW,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,YAEzC,GAAG,CAAC,IAAI,CAAC,GAAG,GACN,IAjBF,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAkB3B,CACN,CAAC;oCACJ,CAAC,CAAC,IAlCK,aAAa,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAmChC,CACN,CAAC,GACI,IACF,EAGP,UAAU,IAAI,CACb,8BACE,KAAC,SAAS,KAAG,EACb,eAAK,SAAS,EAAC,mCAAmC,aAChD,wBACG,SAAS,IAAI,IAAI,KAAK,OAAO,IAAI,CAChC,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,WAAW,sBAE3D,CACV,GACG,EACN,eAAK,SAAS,EAAC,YAAY,aACxB,QAAQ,IAAI,CACX,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,QAAQ,uBAExD,CACV,EACA,OAAO,IAAI,CACV,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,OAAO,sBAEtE,CACV,IACG,IACF,IACL,CACJ,IACG,IACF,CACP,CAAC;AACJ,CAAC,CAAC,CAAC;AACH,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC"}

package/dist/components/Calendar/calendar.types.d.ts

@@ -1,32 +1,21 @@
 /**
- * Calendar types for the generic date picker calendar component
+ * Calendar types.
  *
- * This component is used by DatePicker, DateTimePicker, and DateTimeRangePicker
- * for consistent date selection UI.
+ * Two layers live here, and the distinction is the whole point:
+ *
+ * - **Public (`Calendar*`)** — ISO strings. This is what a consumer writes, and
+ *   what `@sixthshift/design-system/calendar` exports.
+ * - **Internal (`CalendarView*`)** — Temporal objects. This is what the grid and
+ *   `calendar.hooks` work in, and what every picker composes directly.
+ *
+ * The `CalendarView*` types are not exported from `./index.ts`, so they are
+ * unreachable through the package's `exports` map.
  */
-import type { Temporal, WeekStartsOn } from "../../date-time/index.js";
-/**
- * Date range value
- */
-export type DateRangeValue = {
-    from: Temporal.PlainDate | undefined;
-    to: Temporal.PlainDate | undefined;
-};
+import type { DisabledDates, ISODate, ISODateRange, Temporal, TemporalDisabledMatcher, WeekStartsOn } from "../../date-time/index.js";
 /**
  * Selection mode
  */
 export type SelectionMode = "single" | "range" | "multiple";
-/**
- * Disabled date matchers
- */
-export type DisabledDateMatcher = Temporal.PlainDate | Temporal.PlainDate[] | ((date: Temporal.PlainDate) => boolean) | {
-    before: Temporal.PlainDate;
-} | {
-    after: Temporal.PlainDate;
-} | {
-    from: Temporal.PlainDate;
-    to: Temporal.PlainDate;
-};
 /**
  * Preset option (generic over value type)
  */
@@ -35,6 +24,68 @@ export type PresetOption<T> = {
     value: T;
 };
 type CalendarBaseProps = {
+    /** Month being displayed. Any date within the month; the day is ignored. */
+    month: ISODate;
+    /** Called when the displayed month should change. */
+    onMonthChange: (month: ISODate) => void;
+    /** Earliest selectable date, inclusive. */
+    minDate?: ISODate | undefined;
+    /** Latest selectable date, inclusive. */
+    maxDate?: ISODate | undefined;
+    /** Which dates to refuse. See {@link DisabledDates}. */
+    disabled?: DisabledDates | DisabledDates[] | undefined;
+    /** First day of week (0 = Sunday, 1 = Monday) */
+    weekStartsOn?: WeekStartsOn | undefined;
+    /** Show footer with Today/Cancel/Apply buttons */
+    showFooter?: boolean | undefined;
+    /** Show Today button (only if showFooter=true) */
+    showToday?: boolean | undefined;
+    /** Called when Apply is clicked */
+    onApply?: (() => void) | undefined;
+    /** Called when Cancel is clicked */
+    onCancel?: (() => void) | undefined;
+    /** Additional CSS class */
+    className?: string | undefined;
+};
+export type CalendarSingleProps = CalendarBaseProps & {
+    mode: "single";
+    value: ISODate | undefined;
+    onSelect: (date: ISODate | undefined) => void;
+    presets?: PresetOption<ISODate>[] | undefined;
+};
+export type CalendarRangeProps = CalendarBaseProps & {
+    mode: "range";
+    value: ISODateRange | undefined;
+    onSelect: (range: ISODateRange | undefined) => void;
+    presets?: PresetOption<ISODateRange>[] | undefined;
+};
+export type CalendarMultipleProps = CalendarBaseProps & {
+    mode: "multiple";
+    value: ISODate[];
+    onSelect: (dates: ISODate[]) => void;
+    max?: number | undefined;
+    presets?: PresetOption<ISODate[]>[] | undefined;
+};
+/**
+ * Calendar props — discriminated union based on mode
+ */
+export type CalendarProps = CalendarSingleProps | CalendarRangeProps | CalendarMultipleProps;
+/**
+ * Date range value in Temporal terms.
+ *
+ * The public equivalent is `ISODateRange` from `../../date-time`.
+ */
+export type DateRangeValue = {
+    from: Temporal.PlainDate | undefined;
+    to: Temporal.PlainDate | undefined;
+};
+/**
+ * Disabled date matchers, Temporal-shaped.
+ *
+ * Produced from the public {@link DisabledDates} by `adaptDisabledDates`.
+ */
+export type DisabledDateMatcher = TemporalDisabledMatcher;
+type CalendarViewBaseProps = {
     /** Current month being displayed */
     month: Temporal.PlainDate;
     /** Called when month should change */
@@ -47,6 +98,15 @@ type CalendarBaseProps = {
     disabled?: DisabledDateMatcher | DisabledDateMatcher[] | undefined;
     /** First day of week (0 = Sunday, 1 = Monday) */
     weekStartsOn?: WeekStartsOn | undefined;
+    /**
+     * Move DOM focus into the day grid on mount.
+     *
+     * Off by default: a grid that grabs focus when it appears is wrong for a
+     * pointer user who clicked a trigger. `DatePicker` turns it on only when the
+     * popover was opened from the keyboard (`Alt+ArrowDown`), where the whole
+     * point of opening it was to navigate days.
+     */
+    autoFocusDay?: boolean | undefined;
     /** Show footer with Today/Cancel/Apply buttons */
     showFooter?: boolean | undefined;
     /** Show Today button (only if showFooter=true) */
@@ -58,19 +118,19 @@ type CalendarBaseProps = {
     /** Additional CSS class */
     className?: string | undefined;
 };
-export type CalendarSingleProps = CalendarBaseProps & {
+export type CalendarViewSingleProps = CalendarViewBaseProps & {
     mode: "single";
     value: Temporal.PlainDate | undefined;
     onSelect: (date: Temporal.PlainDate | undefined) => void;
     presets?: PresetOption<Temporal.PlainDate>[] | undefined;
 };
-export type CalendarRangeProps = CalendarBaseProps & {
+export type CalendarViewRangeProps = CalendarViewBaseProps & {
     mode: "range";
     value: DateRangeValue | undefined;
     onSelect: (range: DateRangeValue | undefined) => void;
     presets?: PresetOption<DateRangeValue>[] | undefined;
 };
-export type CalendarMultipleProps = CalendarBaseProps & {
+export type CalendarViewMultipleProps = CalendarViewBaseProps & {
     mode: "multiple";
     value: Temporal.PlainDate[];
     onSelect: (dates: Temporal.PlainDate[]) => void;
@@ -78,9 +138,9 @@ export type CalendarMultipleProps = CalendarBaseProps & {
     presets?: PresetOption<Temporal.PlainDate[]>[] | undefined;
 };
 /**
- * Calendar props - discriminated union based on mode
+ * CalendarView props — discriminated union based on mode
  */
-export type CalendarProps = CalendarSingleProps | CalendarRangeProps | CalendarMultipleProps;
+export type CalendarViewProps = CalendarViewSingleProps | CalendarViewRangeProps | CalendarViewMultipleProps;
 /**
  * Position of a date within a range selection
  */

package/dist/components/Calendar/calendar.types.d.ts.map

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

package/dist/components/Calendar/calendar.types.js

@@ -1,8 +1,15 @@
 /**
- * Calendar types for the generic date picker calendar component
+ * Calendar types.
  *
- * This component is used by DatePicker, DateTimePicker, and DateTimeRangePicker
- * for consistent date selection UI.
+ * Two layers live here, and the distinction is the whole point:
+ *
+ * - **Public (`Calendar*`)** — ISO strings. This is what a consumer writes, and
+ *   what `@sixthshift/design-system/calendar` exports.
+ * - **Internal (`CalendarView*`)** — Temporal objects. This is what the grid and
+ *   `calendar.hooks` work in, and what every picker composes directly.
+ *
+ * The `CalendarView*` types are not exported from `./index.ts`, so they are
+ * unreachable through the package's `exports` map.
  */
 export {};
 //# sourceMappingURL=calendar.types.js.map

package/dist/components/Calendar/calendar.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.types.js","sourceRoot":"","sources":["../../../src/components/Calendar/calendar.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"calendar.types.js","sourceRoot":"","sources":["../../../src/components/Calendar/calendar.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/components/Calendar/index.d.ts

@@ -1,4 +1,18 @@
+/**
+ * Public surface of `@sixthshift/design-system/calendar`.
+ *
+ * `CalendarView`, the `CalendarView*` prop types, and everything in
+ * `calendar.hooks` are intentionally absent. The `exports` map resolves
+ * `./calendar` to this file, so anything not re-exported here cannot be imported
+ * by a consumer — which is what keeps Temporal out of the package's public API.
+ *
+ * Those helpers were previously re-exported from here, which leaked
+ * `Temporal.PlainDate` into the public API through their signatures. Pickers
+ * inside this package import `./CalendarView` and `./calendar.hooks` directly.
+ * Consumers who want date arithmetic use
+ * `@sixthshift/design-system/date-time`, whose ISO-native helpers cover the
+ * cases these were reachable for.
+ */
 export { Calendar } from "./Calendar.js";
-export { defaultFormatDisplay, formatMultipleDisplay, formatRangeDisplay, getDateSelectionState, getDisplayValue, isAfterTemporal, isBeforeTemporal, isBetweenTemporal, isDateDisabled, isSameDateTemporal, temporalToISO, useIsDateDisabled, useSelectionState, } from "./calendar.hooks.js";
-export type { CalendarMultipleProps, CalendarProps, CalendarRangeProps, CalendarSingleProps, DateRangeValue, DateSelectionState, DisabledDateMatcher, PresetOption, RangePosition, SelectionMode, } from "./calendar.types.js";
+export type { CalendarMultipleProps, CalendarProps, CalendarRangeProps, CalendarSingleProps, DateSelectionState, PresetOption, RangePosition, SelectionMode, } from "./calendar.types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Calendar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Calendar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Calendar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/components/Calendar/index.js

@@ -1,3 +1,17 @@
+/**
+ * Public surface of `@sixthshift/design-system/calendar`.
+ *
+ * `CalendarView`, the `CalendarView*` prop types, and everything in
+ * `calendar.hooks` are intentionally absent. The `exports` map resolves
+ * `./calendar` to this file, so anything not re-exported here cannot be imported
+ * by a consumer — which is what keeps Temporal out of the package's public API.
+ *
+ * Those helpers were previously re-exported from here, which leaked
+ * `Temporal.PlainDate` into the public API through their signatures. Pickers
+ * inside this package import `./CalendarView` and `./calendar.hooks` directly.
+ * Consumers who want date arithmetic use
+ * `@sixthshift/design-system/date-time`, whose ISO-native helpers cover the
+ * cases these were reachable for.
+ */
 export { Calendar } from "./Calendar.js";
-export { defaultFormatDisplay, formatMultipleDisplay, formatRangeDisplay, getDateSelectionState, getDisplayValue, isAfterTemporal, isBeforeTemporal, isBetweenTemporal, isDateDisabled, isSameDateTemporal, temporalToISO, useIsDateDisabled, useSelectionState, } from "./calendar.hooks.js";
 //# sourceMappingURL=index.js.map

package/dist/components/Calendar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Calendar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Calendar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/Card/Card.d.ts

@@ -5,6 +5,19 @@ export type CardProps = Omit<React.HTMLAttributes<HTMLDivElement>, "title"> & {
     /** Optional action element displayed on the right side of the header */
     headerAction?: React.ReactNode;
 };
+/**
+ * Bordered, elevated container — the "this contains data" building block
+ * (see docs/visual-hierarchy.md's Elevated tier). Renders a `<div>`, with an
+ * optional `<header>` when `title` and/or `headerAction` is passed.
+ *
+ * Passing `onClick` turns the whole card into a button: it gets
+ * `role="button"`, `tabIndex={0}`, and both Enter and Space activate it, not
+ * just a pointer click. Omit `onClick` for a purely presentational card.
+ *
+ * Colour reads `--card-*` component tokens (src/theme/recipes/card.css) —
+ * the same seam Button and Badge use — so a consumer can re-point them
+ * without a release.
+ */
 export declare const Card: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "title"> & {
     /** Optional header title - string or ReactNode */
     title?: React.ReactNode;

package/dist/components/Card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5E,kDAAkD;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,wEAAwE;IACxE,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,IAAI;IANf,kDAAkD;YAC1C,KAAK,CAAC,SAAS;IACvB,wEAAwE;mBACzD,KAAK,CAAC,SAAS;wCAsC9B,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5E,kDAAkD;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,wEAAwE;IACxE,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI;IAnBf,kDAAkD;YAC1C,KAAK,CAAC,SAAS;IACvB,wEAAwE;mBACzD,KAAK,CAAC,SAAS;wCAmD9B,CAAC"}

package/dist/components/Card/Card.js

@@ -1,6 +1,19 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "@sixthshift/design-system/utils";
 import * as React from "react";
+/**
+ * Bordered, elevated container — the "this contains data" building block
+ * (see docs/visual-hierarchy.md's Elevated tier). Renders a `<div>`, with an
+ * optional `<header>` when `title` and/or `headerAction` is passed.
+ *
+ * Passing `onClick` turns the whole card into a button: it gets
+ * `role="button"`, `tabIndex={0}`, and both Enter and Space activate it, not
+ * just a pointer click. Omit `onClick` for a purely presentational card.
+ *
+ * Colour reads `--card-*` component tokens (src/theme/recipes/card.css) —
+ * the same seam Button and Badge use — so a consumer can re-point them
+ * without a release.
+ */
 export const Card = React.forwardRef(({ className, title, headerAction, children, onClick, onKeyDown, ...props }, ref) => {
     const isInteractive = !!onClick;
     const handleKeyDown = (e) => {
@@ -12,8 +25,8 @@ export const Card = React.forwardRef(({ className, title, headerAction, children
     };
     return (
     // biome-ignore lint/a11y/noStaticElementInteractions: role="button" + tabIndex are added dynamically when onClick is present
-    _jsxs("div", { ref: ref, className: cn("rounded-xl border border-border-normal bg-bg-normal p-6 text-fg-normal shadow", isInteractive &&
-            "cursor-pointer transition-colors hover:border-border-strong focus-visible:outline-2 focus-visible:outline-border-strong focus-visible:outline-offset-2", className), onClick: onClick, onKeyDown: handleKeyDown, ...(isInteractive && { role: "button", tabIndex: 0 }), ...props, children: [(title || headerAction) && (_jsxs("header", { className: "mb-4 flex items-start justify-between gap-4", children: [title && _jsx("div", { className: "font-semibold", children: title }), headerAction && _jsx("div", { className: "shrink-0", children: headerAction })] })), children] }));
+    _jsxs("div", { ref: ref, className: cn("card border-(color:--card-border) rounded-xl border bg-(--card-bg) p-6 text-(--card-fg) shadow", isInteractive &&
+            "hover:border-(color:--card-border-hovered) focus-visible:outline-(color:--card-ring) cursor-pointer transition-colors focus-visible:outline-2 focus-visible:outline-offset-2", className), onClick: onClick, onKeyDown: handleKeyDown, ...(isInteractive && { role: "button", tabIndex: 0 }), ...props, children: [(title || headerAction) && (_jsxs("header", { className: "mb-4 flex items-start justify-between gap-4", children: [title && _jsx("div", { className: "font-semibold", children: title }), headerAction && _jsx("div", { className: "shrink-0", children: headerAction })] })), children] }));
 });
 Card.displayName = "Card";
 //# sourceMappingURL=Card.js.map

package/dist/components/Card/Card.js.map

@@ -1 +1 @@
-{"version":3,"file":"Card.js","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,iCAAiC,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAA4B,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IAClJ,MAAM,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC;IAEhC,MAAM,aAAa,GAAG,CAAC,CAAsC,EAAE,EAAE;QAC/D,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1D,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC,CAAgD,CAAC,CAAC;QAC9D,CAAC;QACD,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;IACL,6HAA6H;IAC7H,eACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,EAAE,CACX,+EAA+E,EAC/E,aAAa;YACX,wJAAwJ,EAC1J,SAAS,CACV,EACD,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,KACpB,CAAC,aAAa,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,KAClD,KAAK,aAER,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAC1B,kBAAQ,SAAS,EAAC,6CAA6C,aAC5D,KAAK,IAAI,cAAK,SAAS,EAAC,eAAe,YAAE,KAAK,GAAO,EACrD,YAAY,IAAI,cAAK,SAAS,EAAC,UAAU,YAAE,YAAY,GAAO,IACxD,CACV,EACA,QAAQ,IACL,CACP,CAAC;AACJ,CAAC,CAAC,CAAC;AACH,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC"}
+{"version":3,"file":"Card.js","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,iCAAiC,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAA4B,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IAClJ,MAAM,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC;IAEhC,MAAM,aAAa,GAAG,CAAC,CAAsC,EAAE,EAAE;QAC/D,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1D,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC,CAAgD,CAAC,CAAC;QAC9D,CAAC;QACD,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;IACL,6HAA6H;IAC7H,eACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,EAAE,CACX,gGAAgG,EAChG,aAAa;YACX,8KAA8K,EAChL,SAAS,CACV,EACD,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,KACpB,CAAC,aAAa,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,KAClD,KAAK,aAER,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAC1B,kBAAQ,SAAS,EAAC,6CAA6C,aAC5D,KAAK,IAAI,cAAK,SAAS,EAAC,eAAe,YAAE,KAAK,GAAO,EACrD,YAAY,IAAI,cAAK,SAAS,EAAC,UAAU,YAAE,YAAY,GAAO,IACxD,CACV,EACA,QAAQ,IACL,CACP,CAAC;AACJ,CAAC,CAAC,CAAC;AACH,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC"}