@kalyx/react 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# @kalyx/react
+
+## 0.2.0
+
+### Minor Changes
+
+- e9bb9e8: Initial release of Kalyx — headless, SSR-safe React DatePicker library.
+
+  Features:
+
+  - DatePicker: single date selection with Calendar, Input, Trigger, Popover
+  - RangePicker: date range selection with auto-swap and hover preview
+  - TimePicker: 12h/24h mode, minute step, HourList/MinuteList/AmPmToggle
+  - DateTimePicker: combined date+time via context bridging (reuses existing components)
+  - useDatePicker, useRangePicker, useTimePicker hooks for custom UIs
+  - WAI-ARIA compliant: grid, dialog, combobox, listbox, radiogroup patterns
+  - SSR safe: verified with Next.js 15 App Router
+  - Zero CSS: style with classNames prop and data-\* attributes
+  - ISO 8601 UTC strings only (no native Date objects)
+  - Bundle: 7.71KB gzip (target ≤12KB)
+  - 185 unit/integration tests passing
+
+### Patch Changes
+
+- Updated dependencies [e9bb9e8]
+  - @kalyx/core@0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jihoon Lee (jiji-hoon96)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @kalyx/react
+
+> Headless, SSR-safe React DatePicker. Zero CSS. Composition API. < 8KB gzip.
+
+## Install
+
+```bash
+pnpm add @kalyx/react
+```
+
+**Peer dependencies:** `react >= 19.0.0`, `react-dom >= 19.0.0`
+
+## Components
+
+### DatePicker
+
+```tsx
+import { DatePicker } from '@kalyx/react';
+
+<DatePicker value={date} onChange={setDate}>
+  <DatePicker.Input placeholder="Select date" />
+  <DatePicker.Popover>
+    <DatePicker.Calendar />
+  </DatePicker.Popover>
+</DatePicker>
+```
+
+### RangePicker
+
+```tsx
+import { RangePicker } from '@kalyx/react';
+
+<RangePicker value={range} onChange={setRange}>
+  <RangePicker.Input part="start" />
+  <RangePicker.Input part="end" />
+  <RangePicker.Popover>
+    <RangePicker.Calendar />
+  </RangePicker.Popover>
+</RangePicker>
+```
+
+### TimePicker
+
+```tsx
+import { TimePicker } from '@kalyx/react';
+
+<TimePicker value={time} onChange={setTime} format="24h" step={15}>
+  <TimePicker.Input />
+  <TimePicker.HourList />
+  <TimePicker.MinuteList />
+  <TimePicker.AmPmToggle />
+</TimePicker>
+```
+
+### DateTimePicker
+
+```tsx
+import { DateTimePicker } from '@kalyx/react';
+
+<DateTimePicker value={dt} onChange={setDt} format="24h" step={15}>
+  <DateTimePicker.Input />
+  <DateTimePicker.Popover>
+    <DateTimePicker.Calendar />
+    <DateTimePicker.HourList />
+    <DateTimePicker.MinuteList />
+  </DateTimePicker.Popover>
+</DateTimePicker>
+```
+
+## Hooks
+
+For fully custom UIs, use the equivalent hooks:
+
+```tsx
+import { useDatePicker, useRangePicker, useTimePicker } from '@kalyx/react';
+```
+
+## Key Features
+
+- **Zero CSS** — Style with `classNames` prop or `data-*` attributes
+- **ISO 8601 UTC** — All values are UTC strings, no native Date objects
+- **SSR Safe** — Verified with Next.js 15 App Router
+- **Accessible** — WAI-ARIA patterns, keyboard navigation, axe tested
+- **7.71KB gzip** — DatePicker + RangePicker + TimePicker + DateTimePicker
+
+## License
+
+MIT

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

@@ -0,0 +1,23 @@
+import type { HTMLAttributes } from 'react';
+export interface DatePickerCalendarClassNames {
+    root?: string;
+    header?: string;
+    title?: string;
+    navButton?: string;
+    grid?: string;
+    gridRow?: string;
+    gridCell?: string;
+    day?: string;
+    daySelected?: string;
+    dayToday?: string;
+    dayDisabled?: string;
+    dayOutsideMonth?: string;
+    weekdayHeader?: string;
+}
+export interface DatePickerCalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
+    classNames?: DatePickerCalendarClassNames;
+    /** 타이틀("January 2026") 클릭 시 콜백. Month/Year 뷰 전환에 사용. */
+    onTitleClick?: () => void;
+}
+export declare function DatePickerCalendar({ classNames, onTitleClick, ...props }: DatePickerCalendarProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Calendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/Calendar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAK5C,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC3F,UAAU,CAAC,EAAE,4BAA4B,CAAC;IAC1C,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAeD,wBAAgB,kBAAkB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,EAAE,uBAAuB,2CAiOjG"}

package/dist/components/DatePicker/Calendar.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getCalendarDays, isDateDisabled, getWeekdayNames, formatMonthYear, formatFullDate } from '@kalyx/core';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+/** 스크린리더 전용 숨김 스타일 */
+const srOnly = {
+    position: 'absolute',
+    width: '1px',
+    height: '1px',
+    padding: 0,
+    margin: '-1px',
+    overflow: 'hidden',
+    clip: 'rect(0, 0, 0, 0)',
+    whiteSpace: 'nowrap',
+    border: 0,
+};
+export function DatePickerCalendar({ classNames, onTitleClick, ...props }) {
+    const ctx = useDatePickerContext('DatePicker.Calendar');
+    const gridRef = useRef(null);
+    const [announcement, setAnnouncement] = useState('');
+    const { adapter, viewMonth, focusedDate, weekStartsOn, disabled, locale } = ctx;
+    const weekdays = getWeekdayNames(locale, weekStartsOn);
+    const weeks = getCalendarDays(viewMonth, adapter, {
+        weekStartsOn,
+        selected: ctx.value,
+        focusedDate,
+        disabled,
+    });
+    const year = adapter.getYear(viewMonth);
+    const month = adapter.getMonth(viewMonth);
+    const title = formatMonthYear(year, month, locale);
+    // 포커스된 날짜 셀에 포커스 이동
+    useEffect(() => {
+        if (!ctx.isOpen || !gridRef.current)
+            return;
+        const focusedButton = gridRef.current.querySelector('[data-focused="true"]');
+        focusedButton?.focus();
+    }, [focusedDate, ctx.isOpen]);
+    const navigateMonth = useCallback((direction) => {
+        const newMonth = adapter.addMonths(viewMonth, direction);
+        ctx.setViewMonth(newMonth);
+        ctx.setFocusedDate(adapter.startOfMonth(newMonth));
+        const y = adapter.getYear(newMonth);
+        const m = adapter.getMonth(newMonth);
+        setAnnouncement(formatMonthYear(y, m, locale));
+    }, [adapter, viewMonth, ctx, locale]);
+    const handleDayClick = useCallback((day) => {
+        if (day.isDisabled)
+            return;
+        ctx.selectDate(day.isoString);
+        setAnnouncement(formatFullDate(day.isoString, locale));
+    }, [ctx, locale]);
+    const handleKeyDown = useCallback((e) => {
+        let newFocused = null;
+        switch (e.key) {
+            case 'ArrowLeft':
+                newFocused = adapter.addDays(focusedDate, -1);
+                break;
+            case 'ArrowRight':
+                newFocused = adapter.addDays(focusedDate, 1);
+                break;
+            case 'ArrowUp':
+                newFocused = adapter.addDays(focusedDate, -7);
+                break;
+            case 'ArrowDown':
+                newFocused = adapter.addDays(focusedDate, 7);
+                break;
+            case 'PageUp':
+                if (e.shiftKey) {
+                    newFocused = adapter.addYears(focusedDate, -1);
+                }
+                else {
+                    newFocused = adapter.addMonths(focusedDate, -1);
+                }
+                break;
+            case 'PageDown':
+                if (e.shiftKey) {
+                    newFocused = adapter.addYears(focusedDate, 1);
+                }
+                else {
+                    newFocused = adapter.addMonths(focusedDate, 1);
+                }
+                break;
+            case 'Home':
+                newFocused = adapter.startOfWeek(focusedDate, weekStartsOn);
+                break;
+            case 'End':
+                newFocused = adapter.endOfWeek(focusedDate, weekStartsOn);
+                // endOfWeek는 23:59:59 반환하므로 startOfDay로 정규화
+                newFocused = adapter.startOfDay(newFocused);
+                break;
+            case 'Enter':
+            case ' ':
+                e.preventDefault();
+                if (!isDateDisabled(focusedDate, disabled, adapter)) {
+                    ctx.selectDate(focusedDate);
+                }
+                return;
+            case 'Escape':
+                ctx.close();
+                return;
+            default:
+                return;
+        }
+        if (newFocused) {
+            e.preventDefault();
+            ctx.setFocusedDate(newFocused);
+            // 포커스가 현재 뷰 월을 벗어나면 뷰도 업데이트
+            if (!adapter.isSameMonth(newFocused, viewMonth)) {
+                ctx.setViewMonth(newFocused);
+            }
+        }
+    }, [adapter, focusedDate, viewMonth, weekStartsOn, disabled, ctx]);
+    return (_jsxs("div", { className: classNames?.root, ...props, children: [_jsxs("div", { className: classNames?.header, children: [_jsx("button", { type: "button", className: classNames?.navButton, onClick: () => navigateMonth(-1), "aria-label": "\uC774\uC804 \uB2EC", children: "<" }), onTitleClick ? (_jsx("button", { type: "button", className: classNames?.title, onClick: onTitleClick, "aria-live": "polite", children: title })) : (_jsx("span", { className: classNames?.title, "aria-live": "polite", children: title })), _jsx("button", { type: "button", className: classNames?.navButton, onClick: () => navigateMonth(1), "aria-label": "\uB2E4\uC74C \uB2EC", children: ">" })] }), _jsxs("table", { ref: gridRef, role: "grid", "aria-label": title, className: classNames?.grid, onKeyDown: handleKeyDown, children: [_jsx("thead", { children: _jsx("tr", { role: "row", children: weekdays.map((day) => (_jsx("th", { role: "columnheader", abbr: day.full, scope: "col", className: classNames?.weekdayHeader, children: day.short }, day.short))) }) }), _jsx("tbody", { children: weeks.map((week, weekIndex) => (_jsx("tr", { role: "row", className: classNames?.gridRow, children: week.map((day) => {
+                                const dayClasses = [
+                                    classNames?.day,
+                                    day.isSelected && classNames?.daySelected,
+                                    day.isToday && classNames?.dayToday,
+                                    day.isDisabled && classNames?.dayDisabled,
+                                    !day.isCurrentMonth && classNames?.dayOutsideMonth,
+                                ]
+                                    .filter(Boolean)
+                                    .join(' ') || undefined;
+                                return (_jsx("td", { role: "gridcell", "aria-selected": day.isSelected || undefined, "aria-disabled": day.isDisabled || undefined, "aria-current": day.isToday ? 'date' : undefined, className: classNames?.gridCell, children: _jsx("button", { type: "button", tabIndex: day.isFocused ? 0 : -1, disabled: day.isDisabled, "data-focused": day.isFocused || undefined, "data-selected": day.isSelected || undefined, "data-today": day.isToday || undefined, "data-outside-month": !day.isCurrentMonth || undefined, className: dayClasses, onClick: () => handleDayClick(day), "aria-label": formatFullDate(day.isoString, locale), children: day.dayNumber }) }, day.isoString));
+                            }) }, weekIndex))) })] }), _jsx("div", { role: "status", "aria-live": "polite", "aria-atomic": "true", style: srOnly, children: announcement })] }));
+}
+//# sourceMappingURL=Calendar.js.map

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

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

package/dist/components/DatePicker/Input.d.ts

@@ -0,0 +1,7 @@
+import type { InputHTMLAttributes } from 'react';
+export interface DatePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
+    /** 날짜 표시 포맷 (기본: 부모의 displayFormat) */
+    format?: string;
+}
+export declare const DatePickerInput: import("react").ForwardRefExoticComponent<DatePickerInputProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=Input.d.ts.map

package/dist/components/DatePicker/Input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/Input.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAIjD,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAClF,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,mHA2G3B,CAAC"}

package/dist/components/DatePicker/Input.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback, useState } from 'react';
+import { parseInputValue } from '@kalyx/core';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+export const DatePickerInput = forwardRef(function DatePickerInput({ format: formatProp, onFocus, onBlur, onKeyDown, ...props }, ref) {
+    const ctx = useDatePickerContext('DatePicker.Input');
+    const displayFormat = formatProp ?? ctx.displayFormat;
+    // 입력 중인 텍스트 (편집 모드)
+    const [inputText, setInputText] = useState(null);
+    const displayValue = inputText !== null
+        ? inputText
+        : ctx.value
+            ? ctx.adapter.format(ctx.value, displayFormat)
+            : '';
+    const handleFocus = useCallback((e) => {
+        ctx.open();
+        onFocus?.(e);
+    }, [ctx, onFocus]);
+    const handleBlur = useCallback((e) => {
+        if (inputText !== null) {
+            const parsed = parseInputValue(inputText, displayFormat, ctx.adapter);
+            if (parsed) {
+                ctx.selectDate(parsed);
+            }
+            setInputText(null);
+        }
+        onBlur?.(e);
+    }, [inputText, displayFormat, ctx, onBlur]);
+    const handleChange = useCallback((e) => {
+        const text = e.target.value;
+        setInputText(text);
+        if (!text) {
+            ctx.selectDate(null);
+            setInputText(null);
+            return;
+        }
+        const parsed = parseInputValue(text, displayFormat, ctx.adapter);
+        if (parsed) {
+            ctx.selectDate(parsed);
+            setInputText(null);
+        }
+    }, [displayFormat, ctx]);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === 'Escape') {
+            ctx.close();
+        }
+        else if (e.key === 'Enter') {
+            if (inputText !== null) {
+                const parsed = parseInputValue(inputText, displayFormat, ctx.adapter);
+                if (parsed) {
+                    ctx.selectDate(parsed);
+                    setInputText(null);
+                }
+            }
+        }
+        else if (e.key === 'ArrowDown' && !ctx.isOpen) {
+            e.preventDefault();
+            ctx.open();
+        }
+        onKeyDown?.(e);
+    }, [ctx, inputText, displayFormat, onKeyDown]);
+    const calendarId = `${ctx.pickerId}-calendar`;
+    return (_jsx("input", { ref: (node) => {
+            // Floating UI reference 등록
+            ctx.referenceRef.current = node;
+            // forwardRef 전달
+            if (typeof ref === 'function')
+                ref(node);
+            else if (ref)
+                ref.current = node;
+        }, type: "text", role: "combobox", "aria-expanded": ctx.isOpen, "aria-haspopup": "dialog", "aria-controls": ctx.isOpen ? calendarId : undefined, "aria-autocomplete": "none", autoComplete: "off", value: displayValue, disabled: ctx.isDisabled || props.disabled, readOnly: ctx.isReadOnly, onChange: handleChange, onFocus: handleFocus, onBlur: handleBlur, onKeyDown: handleKeyDown, ...props }));
+});
+//# sourceMappingURL=Input.js.map

package/dist/components/DatePicker/Input.js.map

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

package/dist/components/DatePicker/MonthGrid.d.ts

@@ -0,0 +1,34 @@
+import type { HTMLAttributes } from 'react';
+export interface DatePickerMonthGridClassNames {
+    root?: string;
+    header?: string;
+    title?: string;
+    navButton?: string;
+    grid?: string;
+    month?: string;
+    monthSelected?: string;
+    monthCurrent?: string;
+}
+export interface DatePickerMonthGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
+    classNames?: DatePickerMonthGridClassNames;
+    /** 월 선택 시 콜백. 일반적으로 day 뷰로 전환한다. */
+    onSelect?: () => void;
+    /** 타이틀(년도) 클릭 시 콜백. Year 뷰로 전환할 때 사용. */
+    onTitleClick?: () => void;
+}
+/**
+ * DatePicker.MonthGrid — 12개월 그리드에서 월을 빠르게 선택.
+ * Calendar 타이틀 클릭 → MonthGrid 표시 → 월 클릭 → Calendar로 복귀.
+ *
+ * @example
+ * ```tsx
+ * {view === 'months' && (
+ *   <DatePicker.MonthGrid
+ *     onSelect={() => setView('days')}
+ *     onTitleClick={() => setView('years')}
+ *   />
+ * )}
+ * ```
+ */
+export declare function DatePickerMonthGrid({ classNames, onSelect, onTitleClick, ...props }: DatePickerMonthGridProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MonthGrid.d.ts.map

package/dist/components/DatePicker/MonthGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthGrid.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/MonthGrid.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAI5C,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC5F,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,wBAAwB,2CAqG1B"}

package/dist/components/DatePicker/MonthGrid.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback } from 'react';
+import { getMonthName } from '@kalyx/core';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+/**
+ * DatePicker.MonthGrid — 12개월 그리드에서 월을 빠르게 선택.
+ * Calendar 타이틀 클릭 → MonthGrid 표시 → 월 클릭 → Calendar로 복귀.
+ *
+ * @example
+ * ```tsx
+ * {view === 'months' && (
+ *   <DatePicker.MonthGrid
+ *     onSelect={() => setView('days')}
+ *     onTitleClick={() => setView('years')}
+ *   />
+ * )}
+ * ```
+ */
+export function DatePickerMonthGrid({ classNames, onSelect, onTitleClick, ...props }) {
+    const ctx = useDatePickerContext('DatePicker.MonthGrid');
+    const { adapter, viewMonth, locale } = ctx;
+    const currentYear = adapter.getYear(viewMonth);
+    const currentMonth = adapter.getMonth(viewMonth);
+    const todayMonth = adapter.getMonth(adapter.today());
+    const todayYear = adapter.getYear(adapter.today());
+    const navigateYear = useCallback((direction) => {
+        const newDate = adapter.addYears(viewMonth, direction);
+        ctx.setViewMonth(newDate);
+    }, [adapter, viewMonth, ctx]);
+    const handleMonthSelect = useCallback((monthIndex) => {
+        // 현재 년도 + 선택된 월의 1일로 viewMonth 설정
+        const target = new Date(Date.UTC(currentYear, monthIndex, 1)).toISOString();
+        ctx.setViewMonth(target);
+        ctx.setFocusedDate(target);
+        onSelect?.();
+    }, [currentYear, ctx, onSelect]);
+    const months = Array.from({ length: 12 }, (_, i) => ({
+        index: i,
+        name: getMonthName(i, locale),
+        isSelected: i === currentMonth,
+        isCurrent: i === todayMonth && currentYear === todayYear,
+    }));
+    return (_jsxs("div", { className: classNames?.root, ...props, children: [_jsxs("div", { className: classNames?.header, children: [_jsx("button", { type: "button", className: classNames?.navButton, onClick: () => navigateYear(-1), "aria-label": "\uC774\uC804 \uB144", children: "<" }), onTitleClick ? (_jsx("button", { type: "button", className: classNames?.title, onClick: onTitleClick, children: currentYear })) : (_jsx("span", { className: classNames?.title, children: currentYear })), _jsx("button", { type: "button", className: classNames?.navButton, onClick: () => navigateYear(1), "aria-label": "\uB2E4\uC74C \uB144", children: ">" })] }), _jsx("div", { role: "grid", "aria-label": `${currentYear} months`, className: classNames?.grid, style: { display: 'grid', gridTemplateColumns: 'repeat(3, 1fr)' }, children: months.map((m) => {
+                    const monthClass = [
+                        classNames?.month,
+                        m.isSelected && classNames?.monthSelected,
+                        m.isCurrent && classNames?.monthCurrent,
+                    ]
+                        .filter(Boolean)
+                        .join(' ') || undefined;
+                    return (_jsx("button", { type: "button", role: "gridcell", "aria-selected": m.isSelected || undefined, "aria-current": m.isCurrent ? 'date' : undefined, "data-selected": m.isSelected || undefined, "data-current": m.isCurrent || undefined, className: monthClass, onClick: () => handleMonthSelect(m.index), children: m.name }, m.index));
+                }) })] }));
+}
+//# sourceMappingURL=MonthGrid.js.map

package/dist/components/DatePicker/MonthGrid.js.map

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

package/dist/components/DatePicker/Popover.d.ts

@@ -0,0 +1,6 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface DatePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
+    children?: ReactNode;
+}
+export declare function DatePickerPopover({ children, ...props }: DatePickerPopoverProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=Popover.d.ts.map

package/dist/components/DatePicker/Popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/Popover.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvD,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC1F,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,kDAuF/E"}

package/dist/components/DatePicker/Popover.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { useFloating, autoUpdate, offset, flip, shift, } from '@floating-ui/react';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+export function DatePickerPopover({ children, ...props }) {
+    const ctx = useDatePickerContext('DatePicker.Popover');
+    const calendarId = `${ctx.pickerId}-calendar`;
+    const floatingRef = useRef(null);
+    const { refs, floatingStyles } = useFloating({
+        open: ctx.isOpen,
+        placement: 'bottom-start',
+        middleware: [offset(4), flip(), shift({ padding: 8 })],
+        whileElementsMounted: autoUpdate,
+    });
+    // Context의 referenceRef를 Floating UI에 연결
+    useEffect(() => {
+        if (ctx.referenceRef.current) {
+            refs.setReference(ctx.referenceRef.current);
+        }
+    }, [ctx.referenceRef, refs, ctx.isOpen]);
+    // 포커스 복원: 닫힐 때 이전 포커스 요소로 복원
+    const previousFocusRef = useRef(null);
+    useEffect(() => {
+        if (ctx.isOpen) {
+            previousFocusRef.current = document.activeElement;
+        }
+        else if (previousFocusRef.current) {
+            previousFocusRef.current.focus();
+            previousFocusRef.current = null;
+        }
+    }, [ctx.isOpen]);
+    // 바깥 클릭 감지
+    useEffect(() => {
+        if (!ctx.isOpen)
+            return;
+        function handleClickOutside(e) {
+            const floating = floatingRef.current;
+            const reference = ctx.referenceRef.current;
+            const target = e.target;
+            if (floating && !floating.contains(target) && (!reference || !reference.contains(target))) {
+                ctx.close();
+            }
+        }
+        // 다음 틱에 등록해서 현재 클릭 이벤트는 무시
+        const timer = setTimeout(() => {
+            document.addEventListener('mousedown', handleClickOutside);
+        }, 0);
+        return () => {
+            clearTimeout(timer);
+            document.removeEventListener('mousedown', handleClickOutside);
+        };
+    }, [ctx.isOpen, ctx]);
+    // Escape 키 처리
+    useEffect(() => {
+        if (!ctx.isOpen)
+            return;
+        function handleKeyDown(e) {
+            if (e.key === 'Escape') {
+                ctx.close();
+            }
+        }
+        document.addEventListener('keydown', handleKeyDown);
+        return () => document.removeEventListener('keydown', handleKeyDown);
+    }, [ctx.isOpen, ctx]);
+    if (!ctx.isOpen)
+        return null;
+    return (_jsx("div", { ref: (node) => {
+            floatingRef.current = node;
+            refs.setFloating(node);
+        }, id: calendarId, role: "dialog", "aria-label": "\uB0A0\uC9DC \uC120\uD0DD", "aria-modal": "false", style: floatingStyles, ...props, children: children }));
+}
+//# sourceMappingURL=Popover.js.map

package/dist/components/DatePicker/Popover.js.map

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

package/dist/components/DatePicker/Root.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from 'react';
+import type { DateAdapter, DisabledRule, ISODateString, WeekStartsOn } from '@kalyx/core';
+/**
+ * DatePicker의 Root 컴포넌트 props.
+ *
+ * @example 제어 모드
+ * ```tsx
+ * <DatePicker value={date} onChange={setDate}>
+ *   <DatePicker.Input />
+ *   <DatePicker.Popover>
+ *     <DatePicker.Calendar />
+ *   </DatePicker.Popover>
+ * </DatePicker>
+ * ```
+ *
+ * @example 비제어 모드
+ * ```tsx
+ * <DatePicker defaultValue="2026-01-15T00:00:00.000Z">
+ *   <DatePicker.Input />
+ * </DatePicker>
+ * ```
+ */
+export interface DatePickerRootProps {
+    /** 선택된 날짜 (제어 모드, ISO 8601 UTC). `null`이면 빈 상태. */
+    value?: ISODateString | null;
+    /** 초기 날짜 (비제어 모드) */
+    defaultValue?: ISODateString;
+    /** 날짜 변경 콜백 */
+    onChange?: (value: ISODateString | null) => void;
+    /** 비활성화 규칙 */
+    disabled?: DisabledRule[] | boolean;
+    /** 읽기 전용 */
+    readOnly?: boolean;
+    /** 주 시작 요일 */
+    weekStartsOn?: WeekStartsOn;
+    /** 날짜 표시 포맷 */
+    displayFormat?: string;
+    /** BCP 47 locale (예: "en-US", "ko-KR", "ja-JP") */
+    locale?: string;
+    /** 날짜 어댑터 */
+    adapter?: DateAdapter;
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+}
+export declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, children, }: DatePickerRootProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Root.d.ts.map