@kalyx/react 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"Root.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/Root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI1F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,qBAAqB;IACrB,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,eAAe;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,cAAc;IACd,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACpC,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,QAAQ,EACR,QAAgB,EAChB,QAAgB,EAChB,YAAgB,EAChB,aAA4B,EAC5B,MAAgB,EAChB,OAAwB,EACxB,QAAQ,GACT,EAAE,mBAAmB,2CA+GrB"}

package/dist/components/DatePicker/Root.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useId, useMemo, useRef, useState } from 'react';
+import { DateFnsAdapter } from '@kalyx/core';
+import { DatePickerContext } from '../../context/DatePickerContext.js';
+export function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled = false, readOnly = false, weekStartsOn = 0, displayFormat = 'yyyy-MM-dd', locale = 'en-US', adapter = DateFnsAdapter, children, }) {
+    const pickerId = useId();
+    const isControlled = useRef(controlledValue !== undefined).current;
+    const referenceRef = useRef(null);
+    // 비제어 모드의 내부 상태
+    const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue ?? null);
+    const currentValue = isControlled ? (controlledValue ?? null) : uncontrolledValue;
+    // 팝오버 상태
+    const [isOpen, setIsOpen] = useState(false);
+    // 뷰 월 (캘린더에서 현재 보고 있는 달)
+    const [viewMonth, setViewMonth] = useState(currentValue ?? adapter.today());
+    // 포커스된 날짜
+    const [focusedDate, setFocusedDate] = useState(currentValue ?? adapter.today());
+    const isDisabled = typeof disabled === 'boolean' ? disabled : false;
+    const disabledRules = Array.isArray(disabled) ? disabled : [];
+    const selectDate = useCallback((iso) => {
+        if (isDisabled || readOnly)
+            return;
+        if (!isControlled) {
+            setUncontrolledValue(iso);
+        }
+        onChange?.(iso);
+        // 날짜 선택 후 팝오버 닫기
+        setIsOpen(false);
+    }, [isControlled, isDisabled, readOnly, onChange]);
+    const open = useCallback(() => {
+        if (isDisabled || readOnly)
+            return;
+        setIsOpen(true);
+        // 팝오버 열 때 현재 값 또는 오늘로 뷰 초기화
+        const target = currentValue ?? adapter.today();
+        setViewMonth(target);
+        setFocusedDate(target);
+    }, [isDisabled, readOnly, currentValue, adapter]);
+    const close = useCallback(() => {
+        setIsOpen(false);
+    }, []);
+    const toggle = useCallback(() => {
+        if (isOpen) {
+            close();
+        }
+        else {
+            open();
+        }
+    }, [isOpen, open, close]);
+    const contextValue = useMemo(() => ({
+        referenceRef,
+        value: currentValue,
+        selectDate,
+        isOpen,
+        open,
+        close,
+        toggle,
+        viewMonth,
+        setViewMonth,
+        focusedDate,
+        setFocusedDate,
+        adapter,
+        disabled: disabledRules,
+        weekStartsOn,
+        displayFormat,
+        locale,
+        isDisabled,
+        isReadOnly: readOnly,
+        pickerId,
+    }), [
+        currentValue,
+        selectDate,
+        isOpen,
+        open,
+        close,
+        toggle,
+        viewMonth,
+        focusedDate,
+        adapter,
+        disabledRules,
+        weekStartsOn,
+        displayFormat,
+        locale,
+        isDisabled,
+        readOnly,
+        pickerId,
+    ]);
+    return (_jsx(DatePickerContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=Root.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+export interface DatePickerTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'type'> {
+    children?: ReactNode;
+}
+export declare const DatePickerTrigger: import("react").ForwardRefExoticComponent<DatePickerTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=Trigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Trigger.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/Trigger.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG7D,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC7D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,sHAqD7B,CAAC"}

package/dist/components/DatePicker/Trigger.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback } from 'react';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+export const DatePickerTrigger = forwardRef(function DatePickerTrigger({ onClick, children, ...props }, ref) {
+    const ctx = useDatePickerContext('DatePicker.Trigger');
+    const handleClick = useCallback((e) => {
+        ctx.toggle();
+        onClick?.(e);
+    }, [ctx, onClick]);
+    const calendarId = `${ctx.pickerId}-calendar`;
+    return (_jsx("button", { ref: (node) => {
+            // Input이 없으면 Trigger가 reference
+            if (!ctx.referenceRef.current)
+                ctx.referenceRef.current = node;
+            if (typeof ref === 'function')
+                ref(node);
+            else if (ref)
+                ref.current = node;
+        }, type: "button", tabIndex: 0, "aria-label": ctx.isOpen ? '캘린더 닫기' : '캘린더 열기', "aria-expanded": ctx.isOpen, "aria-controls": ctx.isOpen ? calendarId : undefined, disabled: ctx.isDisabled || props.disabled, onClick: handleClick, ...props, children: children ?? (_jsx("svg", { "aria-hidden": "true", focusable: "false", width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: _jsx("path", { d: "M5 1v2M11 1v2M1 6h14M3 3h10a2 2 0 012 2v8a2 2 0 01-2 2H3a2 2 0 01-2-2V5a2 2 0 012-2z", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) })) }));
+});
+//# sourceMappingURL=Trigger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Trigger.js","sourceRoot":"","sources":["../../../src/components/DatePicker/Trigger.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAO1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CACzC,SAAS,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG;IAC7D,MAAM,GAAG,GAAG,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAEvD,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,CAAsC,EAAE,EAAE;QACzC,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,EACD,CAAC,GAAG,EAAE,OAAO,CAAC,CACf,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,GAAG,CAAC,QAAQ,WAAW,CAAC;IAE9C,OAAO,CACL,iBACE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,gCAAgC;YAChC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO;gBAAE,GAAG,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/D,IAAI,OAAO,GAAG,KAAK,UAAU;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC;iBACpC,IAAI,GAAG;gBAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;QACnC,CAAC,EACD,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,gBACC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,mBAC7B,GAAG,CAAC,MAAM,mBACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAClD,QAAQ,EAAE,GAAG,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,EAC1C,OAAO,EAAE,WAAW,KAChB,KAAK,YAER,QAAQ,IAAI,CACX,6BACc,MAAM,EAClB,SAAS,EAAC,OAAO,EACjB,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,KAAK,EAAC,4BAA4B,YAElC,eACE,CAAC,EAAC,sFAAsF,EACxF,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,GACtB,GACE,CACP,GACM,CACV,CAAC;AACJ,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { HTMLAttributes } from 'react';
+export interface DatePickerYearGridClassNames {
+    root?: string;
+    header?: string;
+    title?: string;
+    navButton?: string;
+    grid?: string;
+    year?: string;
+    yearSelected?: string;
+    yearCurrent?: string;
+}
+export interface DatePickerYearGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
+    classNames?: DatePickerYearGridClassNames;
+    /** 년 선택 시 콜백. 일반적으로 month 뷰로 전환한다. */
+    onSelect?: () => void;
+}
+/**
+ * DatePicker.YearGrid — 12년 단위 그리드에서 년도를 빠르게 선택.
+ * MonthGrid 타이틀 클릭 → YearGrid 표시 → 년 클릭 → MonthGrid로 복귀.
+ *
+ * @example
+ * ```tsx
+ * {view === 'years' && (
+ *   <DatePicker.YearGrid onSelect={() => setView('months')} />
+ * )}
+ * ```
+ */
+export declare function DatePickerYearGrid({ classNames, onSelect, ...props }: DatePickerYearGridProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=YearGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"YearGrid.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/YearGrid.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,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,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC3F,UAAU,CAAC,EAAE,4BAA4B,CAAC;IAC1C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,uBAAuB,2CAoGzB"}

package/dist/components/DatePicker/YearGrid.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo } from 'react';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+/**
+ * DatePicker.YearGrid — 12년 단위 그리드에서 년도를 빠르게 선택.
+ * MonthGrid 타이틀 클릭 → YearGrid 표시 → 년 클릭 → MonthGrid로 복귀.
+ *
+ * @example
+ * ```tsx
+ * {view === 'years' && (
+ *   <DatePicker.YearGrid onSelect={() => setView('months')} />
+ * )}
+ * ```
+ */
+export function DatePickerYearGrid({ classNames, onSelect, ...props }) {
+    const ctx = useDatePickerContext('DatePicker.YearGrid');
+    const { adapter, viewMonth } = ctx;
+    const currentYear = adapter.getYear(viewMonth);
+    const todayYear = adapter.getYear(adapter.today());
+    // 12년 단위 범위 (현재 년도를 포함하는 decade)
+    const decadeStart = currentYear - (currentYear % 12);
+    const navigateDecade = useCallback((direction) => {
+        const newDate = adapter.addYears(viewMonth, direction * 12);
+        ctx.setViewMonth(newDate);
+    }, [adapter, viewMonth, ctx]);
+    const handleYearSelect = useCallback((year) => {
+        const currentMonth = adapter.getMonth(viewMonth);
+        const target = new Date(Date.UTC(year, currentMonth, 1)).toISOString();
+        ctx.setViewMonth(target);
+        ctx.setFocusedDate(target);
+        onSelect?.();
+    }, [adapter, viewMonth, ctx, onSelect]);
+    const years = useMemo(() => Array.from({ length: 12 }, (_, i) => {
+        const year = decadeStart + i;
+        return {
+            value: year,
+            isSelected: year === currentYear,
+            isCurrent: year === todayYear,
+        };
+    }), [decadeStart, currentYear, todayYear]);
+    const rangeLabel = `${decadeStart}–${decadeStart + 11}`;
+    return (_jsxs("div", { className: classNames?.root, ...props, children: [_jsxs("div", { className: classNames?.header, children: [_jsx("button", { type: "button", className: classNames?.navButton, onClick: () => navigateDecade(-1), "aria-label": "\uC774\uC804 12\uB144", children: "<" }), _jsx("span", { className: classNames?.title, children: rangeLabel }), _jsx("button", { type: "button", className: classNames?.navButton, onClick: () => navigateDecade(1), "aria-label": "\uB2E4\uC74C 12\uB144", children: ">" })] }), _jsx("div", { role: "grid", "aria-label": rangeLabel, className: classNames?.grid, style: { display: 'grid', gridTemplateColumns: 'repeat(3, 1fr)' }, children: years.map((y) => {
+                    const yearClass = [
+                        classNames?.year,
+                        y.isSelected && classNames?.yearSelected,
+                        y.isCurrent && classNames?.yearCurrent,
+                    ]
+                        .filter(Boolean)
+                        .join(' ') || undefined;
+                    return (_jsx("button", { type: "button", role: "gridcell", "aria-selected": y.isSelected || undefined, "aria-current": y.isCurrent ? 'date' : undefined, "data-selected": y.isSelected || undefined, "data-current": y.isCurrent || undefined, className: yearClass, onClick: () => handleYearSelect(y.value), children: y.value }, y.value));
+                }) })] }));
+}
+//# sourceMappingURL=YearGrid.js.map

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

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

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

@@ -0,0 +1,48 @@
+import { DatePickerRoot } from './Root.js';
+import { DatePickerPopover } from './Popover.js';
+import { DatePickerCalendar } from './Calendar.js';
+import { DatePickerMonthGrid } from './MonthGrid.js';
+import { DatePickerYearGrid } from './YearGrid.js';
+import type { DatePickerRootProps } from './Root.js';
+import type { DatePickerInputProps } from './Input.js';
+import type { DatePickerTriggerProps } from './Trigger.js';
+import type { DatePickerPopoverProps } from './Popover.js';
+import type { DatePickerCalendarProps, DatePickerCalendarClassNames } from './Calendar.js';
+import type { DatePickerMonthGridProps, DatePickerMonthGridClassNames } from './MonthGrid.js';
+import type { DatePickerYearGridProps, DatePickerYearGridClassNames } from './YearGrid.js';
+/**
+ * DatePicker — Headless, SSR-safe React DatePicker
+ *
+ * @example 기본
+ * ```tsx
+ * <DatePicker value={date} onChange={setDate}>
+ *   <DatePicker.Input placeholder="날짜 선택" />
+ *   <DatePicker.Popover>
+ *     <DatePicker.Calendar />
+ *   </DatePicker.Popover>
+ * </DatePicker>
+ * ```
+ *
+ * @example Month/Year 빠른 네비게이션
+ * ```tsx
+ * const [view, setView] = useState('days');
+ * <DatePicker value={date} onChange={setDate}>
+ *   <DatePicker.Input />
+ *   <DatePicker.Popover>
+ *     {view === 'days' && <DatePicker.Calendar onTitleClick={() => setView('months')} />}
+ *     {view === 'months' && <DatePicker.MonthGrid onSelect={() => setView('days')} onTitleClick={() => setView('years')} />}
+ *     {view === 'years' && <DatePicker.YearGrid onSelect={() => setView('months')} />}
+ *   </DatePicker.Popover>
+ * </DatePicker>
+ * ```
+ */
+export declare const DatePicker: typeof DatePickerRoot & {
+    Input: import("react").ForwardRefExoticComponent<DatePickerInputProps & import("react").RefAttributes<HTMLInputElement>>;
+    Trigger: import("react").ForwardRefExoticComponent<DatePickerTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+    Popover: typeof DatePickerPopover;
+    Calendar: typeof DatePickerCalendar;
+    MonthGrid: typeof DatePickerMonthGrid;
+    YearGrid: typeof DatePickerYearGrid;
+};
+export type { DatePickerRootProps, DatePickerInputProps, DatePickerTriggerProps, DatePickerPopoverProps, DatePickerCalendarProps, DatePickerCalendarClassNames, DatePickerMonthGridProps, DatePickerMonthGridClassNames, DatePickerYearGridProps, DatePickerYearGridClassNames, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,KAAK,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOrB,CAAC;AAEH,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,GAC7B,CAAC"}

package/dist/components/DatePicker/index.js

@@ -0,0 +1,42 @@
+import { DatePickerRoot } from './Root.js';
+import { DatePickerInput } from './Input.js';
+import { DatePickerTrigger } from './Trigger.js';
+import { DatePickerPopover } from './Popover.js';
+import { DatePickerCalendar } from './Calendar.js';
+import { DatePickerMonthGrid } from './MonthGrid.js';
+import { DatePickerYearGrid } from './YearGrid.js';
+/**
+ * DatePicker — Headless, SSR-safe React DatePicker
+ *
+ * @example 기본
+ * ```tsx
+ * <DatePicker value={date} onChange={setDate}>
+ *   <DatePicker.Input placeholder="날짜 선택" />
+ *   <DatePicker.Popover>
+ *     <DatePicker.Calendar />
+ *   </DatePicker.Popover>
+ * </DatePicker>
+ * ```
+ *
+ * @example Month/Year 빠른 네비게이션
+ * ```tsx
+ * const [view, setView] = useState('days');
+ * <DatePicker value={date} onChange={setDate}>
+ *   <DatePicker.Input />
+ *   <DatePicker.Popover>
+ *     {view === 'days' && <DatePicker.Calendar onTitleClick={() => setView('months')} />}
+ *     {view === 'months' && <DatePicker.MonthGrid onSelect={() => setView('days')} onTitleClick={() => setView('years')} />}
+ *     {view === 'years' && <DatePicker.YearGrid onSelect={() => setView('months')} />}
+ *   </DatePicker.Popover>
+ * </DatePicker>
+ * ```
+ */
+export const DatePicker = Object.assign(DatePickerRoot, {
+    Input: DatePickerInput,
+    Trigger: DatePickerTrigger,
+    Popover: DatePickerPopover,
+    Calendar: DatePickerCalendar,
+    MonthGrid: DatePickerMonthGrid,
+    YearGrid: DatePickerYearGrid,
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/DatePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE;IACtD,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,kBAAkB;CAC7B,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { InputHTMLAttributes } from 'react';
+export interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
+}
+/**
+ * DateTimePicker.Input — 날짜와 시간을 결합한 형식으로 표시.
+ * 예: "2026-01-15 14:30"
+ *
+ * v0.3에서는 readOnly로 동작한다 (Calendar/TimePicker로 선택).
+ * 직접 타이핑 파싱은 v0.4에서 지원 예정.
+ */
+export declare const DateTimePickerInput: import("react").ForwardRefExoticComponent<DateTimePickerInputProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=Input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/components/DateTimePicker/Input.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAIjD,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;CAAG;AAEvF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,uHAwD/B,CAAC"}

package/dist/components/DateTimePicker/Input.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback } from 'react';
+import { formatTimeString, getTime } from '@kalyx/core';
+import { useDatePickerContext } from '../../context/DatePickerContext.js';
+/**
+ * DateTimePicker.Input — 날짜와 시간을 결합한 형식으로 표시.
+ * 예: "2026-01-15 14:30"
+ *
+ * v0.3에서는 readOnly로 동작한다 (Calendar/TimePicker로 선택).
+ * 직접 타이핑 파싱은 v0.4에서 지원 예정.
+ */
+export const DateTimePickerInput = forwardRef(function DateTimePickerInput({ onFocus, onKeyDown, ...props }, ref) {
+    const ctx = useDatePickerContext('DateTimePicker.Input');
+    // 날짜 부분 (yyyy-MM-dd) + 시간 부분 (HH:mm) 결합
+    const displayValue = ctx.value
+        ? `${ctx.adapter.format(ctx.value, 'yyyy-MM-dd')} ${formatTimeString(getTime(ctx.value))}`
+        : '';
+    const handleFocus = useCallback((e) => {
+        ctx.open();
+        onFocus?.(e);
+    }, [ctx, onFocus]);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === 'Escape') {
+            ctx.close();
+        }
+        else if (e.key === 'ArrowDown' && !ctx.isOpen) {
+            e.preventDefault();
+            ctx.open();
+        }
+        onKeyDown?.(e);
+    }, [ctx, onKeyDown]);
+    const calendarId = `${ctx.pickerId}-calendar`;
+    return (_jsx("input", { ref: (node) => {
+            ctx.referenceRef.current = node;
+            if (typeof ref === 'function')
+                ref(node);
+            else if (ref)
+                ref.current = node;
+        }, type: "text", role: "combobox", readOnly: true, "aria-label": "\uB0A0\uC9DC \uBC0F \uC2DC\uAC04", "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, onFocus: handleFocus, onKeyDown: handleKeyDown, ...props }));
+});
+//# sourceMappingURL=Input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Input.js","sourceRoot":"","sources":["../../../src/components/DateTimePicker/Input.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAK1E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAC3C,SAAS,mBAAmB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG;IAChE,MAAM,GAAG,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IAEzD,wCAAwC;IACxC,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK;QAC5B,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE;QAC1F,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,CAAqC,EAAE,EAAE;QACxC,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,EACD,CAAC,GAAG,EAAE,OAAO,CAAC,CACf,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,CAAwC,EAAE,EAAE;QAC3C,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChD,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,CAAC;QACD,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,EACD,CAAC,GAAG,EAAE,SAAS,CAAC,CACjB,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,GAAG,CAAC,QAAQ,WAAW,CAAC;IAE9C,OAAO,CACL,gBACE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,GAAG,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAChC,IAAI,OAAO,GAAG,KAAK,UAAU;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC;iBACpC,IAAI,GAAG;gBAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;QACnC,CAAC,EACD,IAAI,EAAC,MAAM,EACX,IAAI,EAAC,UAAU,EACf,QAAQ,sBACG,kCAAS,mBACL,GAAG,CAAC,MAAM,mBACX,QAAQ,mBACP,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,uBAChC,MAAM,EACxB,YAAY,EAAC,KAAK,EAClB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,GAAG,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,EAC1C,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,aAAa,KACpB,KAAK,GACT,CACH,CAAC;AACJ,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,60 @@
+import type { ReactNode } from 'react';
+import type { DateAdapter, DisabledRule, ISODateString, WeekStartsOn } from '@kalyx/core';
+import type { TimePickerFormat } from '../../context/TimePickerContext.js';
+/**
+ * DateTimePicker의 Root 컴포넌트 props.
+ * 내부적으로 DatePickerContext + TimePickerContext를 동시에 제공 (Context Bridging).
+ *
+ * @example
+ * ```tsx
+ * <DateTimePicker value={dt} onChange={setDt} format="24h" step={15}>
+ *   <DateTimePicker.Input />
+ *   <DateTimePicker.Popover>
+ *     <DateTimePicker.Calendar />
+ *     <DateTimePicker.HourList />
+ *     <DateTimePicker.MinuteList />
+ *   </DateTimePicker.Popover>
+ * </DateTimePicker>
+ * ```
+ */
+export interface DateTimePickerRootProps {
+    /** 선택된 datetime (제어 모드, ISO 8601 UTC). 날짜+시간 모두 포함. */
+    value?: ISODateString | null;
+    /** 초기 datetime (비제어 모드) */
+    defaultValue?: ISODateString;
+    /** datetime 변경 콜백 */
+    onChange?: (value: ISODateString | null) => void;
+    /** 12/24시간제 */
+    format?: TimePickerFormat;
+    /** 분 step (1, 5, 15, 30 등) */
+    step?: number;
+    /** 비활성화 규칙 (날짜) */
+    disabled?: DisabledRule[] | boolean;
+    /** 읽기 전용 */
+    readOnly?: boolean;
+    /** 주 시작 요일 */
+    weekStartsOn?: WeekStartsOn;
+    /** 날짜·시간 표시 포맷 (Input용) */
+    displayFormat?: string;
+    /** BCP 47 locale */
+    locale?: string;
+    /** 날짜 어댑터 */
+    adapter?: DateAdapter;
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+}
+/**
+ * DateTimePicker.Root — DatePicker + TimePicker 통합 컴포넌트.
+ *
+ * 단일 ISO datetime을 source of truth로 관리하고, 내부적으로
+ * DatePickerContext와 TimePickerContext를 동시에 제공한다.
+ * 따라서 DatePicker.Calendar, TimePicker.HourList 등 기존 컴포넌트를
+ * 그대로 재사용할 수 있다.
+ *
+ * 핵심 동작:
+ * - Calendar에서 날짜 클릭 → 날짜 부분만 변경, 시간 부분 보존, 팝오버 유지
+ * - TimePicker에서 시간 변경 → 시간 부분만 변경, 날짜 부분 보존
+ * - Escape / 바깥 클릭 → 팝오버 닫기 (확정)
+ */
+export declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, children, }: DateTimePickerRootProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Root.d.ts.map

package/dist/components/DateTimePicker/Root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Root.d.ts","sourceRoot":"","sources":["../../../src/components/DateTimePicker/Root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EAEb,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,eAAe;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACpC,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,QAAQ,EACR,MAAc,EACd,IAAQ,EACR,QAAgB,EAChB,QAAgB,EAChB,YAAgB,EAChB,aAAkC,EAClC,MAAgB,EAChB,OAAwB,EACxB,QAAQ,GACT,EAAE,uBAAuB,2CAwJzB"}

package/dist/components/DateTimePicker/Root.js

@@ -0,0 +1,140 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useId, useMemo, useRef, useState } from 'react';
+import { DateFnsAdapter, getTime, setTime as setTimeOnIso, } from '@kalyx/core';
+import { DatePickerContext } from '../../context/DatePickerContext.js';
+import { TimePickerContext } from '../../context/TimePickerContext.js';
+/** value=null 시 fallback ISO (오늘 00:00:00 UTC) */
+function getDefaultIso() {
+    const now = new Date();
+    return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())).toISOString();
+}
+/**
+ * DateTimePicker.Root — DatePicker + TimePicker 통합 컴포넌트.
+ *
+ * 단일 ISO datetime을 source of truth로 관리하고, 내부적으로
+ * DatePickerContext와 TimePickerContext를 동시에 제공한다.
+ * 따라서 DatePicker.Calendar, TimePicker.HourList 등 기존 컴포넌트를
+ * 그대로 재사용할 수 있다.
+ *
+ * 핵심 동작:
+ * - Calendar에서 날짜 클릭 → 날짜 부분만 변경, 시간 부분 보존, 팝오버 유지
+ * - TimePicker에서 시간 변경 → 시간 부분만 변경, 날짜 부분 보존
+ * - Escape / 바깥 클릭 → 팝오버 닫기 (확정)
+ */
+export function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format = '24h', step = 1, disabled = false, readOnly = false, weekStartsOn = 0, displayFormat = 'yyyy-MM-dd HH:mm', locale = 'en-US', adapter = DateFnsAdapter, children, }) {
+    const pickerId = useId();
+    const isControlled = useRef(controlledValue !== undefined).current;
+    const referenceRef = useRef(null);
+    const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue ?? null);
+    const currentValue = isControlled ? (controlledValue ?? null) : uncontrolledValue;
+    // 팝오버 / 캘린더 상태
+    const [isOpen, setIsOpen] = useState(false);
+    const [viewMonth, setViewMonth] = useState(currentValue ?? adapter.today());
+    const [focusedDate, setFocusedDate] = useState(currentValue ?? adapter.today());
+    const isDisabled = typeof disabled === 'boolean' ? disabled : false;
+    const disabledRules = Array.isArray(disabled) ? disabled : [];
+    // value가 null이면 시간 추출용 fallback 사용
+    const baseIso = currentValue ?? getDefaultIso();
+    const currentTime = useMemo(() => getTime(baseIso), [baseIso]);
+    const updateValue = useCallback((next) => {
+        if (isDisabled || readOnly)
+            return;
+        if (!isControlled) {
+            setUncontrolledValue(next);
+        }
+        onChange?.(next);
+    }, [isControlled, isDisabled, readOnly, onChange]);
+    /**
+     * 날짜 선택: 시간 부분을 보존한다.
+     * DatePicker.Root와 달리 팝오버를 자동으로 닫지 않는다.
+     */
+    const selectDate = useCallback((newDateIso) => {
+        if (newDateIso === null) {
+            updateValue(null);
+            return;
+        }
+        // 현재 시간 부분을 보존하여 새 날짜에 적용
+        const time = currentValue ? getTime(currentValue) : currentTime;
+        const merged = setTimeOnIso(newDateIso, time);
+        updateValue(merged);
+    }, [currentValue, currentTime, updateValue]);
+    /**
+     * 시간 변경: 날짜 부분을 보존한다.
+     */
+    const setTime = useCallback((partial) => {
+        // 날짜가 없으면 오늘 자정으로 시작
+        const base = currentValue ?? getDefaultIso();
+        const merged = setTimeOnIso(base, partial);
+        updateValue(merged);
+    }, [currentValue, updateValue]);
+    const open = useCallback(() => {
+        if (isDisabled || readOnly)
+            return;
+        setIsOpen(true);
+        const target = currentValue ?? adapter.today();
+        setViewMonth(target);
+        setFocusedDate(target);
+    }, [isDisabled, readOnly, currentValue, adapter]);
+    const close = useCallback(() => {
+        setIsOpen(false);
+    }, []);
+    const toggle = useCallback(() => {
+        if (isOpen)
+            close();
+        else
+            open();
+    }, [isOpen, open, close]);
+    // ─── DatePickerContext (Calendar, Popover 재사용용) ───
+    const dateContext = useMemo(() => ({
+        referenceRef,
+        value: currentValue,
+        selectDate,
+        isOpen,
+        open,
+        close,
+        toggle,
+        viewMonth,
+        setViewMonth,
+        focusedDate,
+        setFocusedDate,
+        adapter,
+        disabled: disabledRules,
+        weekStartsOn,
+        displayFormat,
+        locale,
+        isDisabled,
+        isReadOnly: readOnly,
+        pickerId,
+    }), [
+        currentValue,
+        selectDate,
+        isOpen,
+        open,
+        close,
+        toggle,
+        viewMonth,
+        focusedDate,
+        adapter,
+        disabledRules,
+        weekStartsOn,
+        displayFormat,
+        locale,
+        isDisabled,
+        readOnly,
+        pickerId,
+    ]);
+    // ─── TimePickerContext (HourList, MinuteList, AmPmToggle 재사용용) ───
+    const timeContext = useMemo(() => ({
+        value: currentValue,
+        setTime,
+        format,
+        step,
+        withSeconds: false,
+        isDisabled,
+        isReadOnly: readOnly,
+        currentTime,
+        pickerId,
+    }), [currentValue, setTime, format, step, isDisabled, readOnly, currentTime, pickerId]);
+    return (_jsx(DatePickerContext.Provider, { value: dateContext, children: _jsx(TimePickerContext.Provider, { value: timeContext, children: children }) }));
+}
+//# sourceMappingURL=Root.js.map

package/dist/components/DateTimePicker/Root.js.map

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