@kalyx/react 0.2.0

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

@@ -0,0 +1,38 @@
+import type { ReactNode } from 'react';
+import type { ISODateString } from '@kalyx/core';
+import type { TimePickerFormat } from '../../context/TimePickerContext.js';
+/**
+ * TimePicker의 Root 컴포넌트 props.
+ *
+ * @example
+ * ```tsx
+ * <TimePicker value={time} onChange={setTime} format="24h" step={15}>
+ *   <TimePicker.Input />
+ *   <TimePicker.HourList />
+ *   <TimePicker.MinuteList />
+ *   <TimePicker.AmPmToggle />
+ * </TimePicker>
+ * ```
+ */
+export interface TimePickerRootProps {
+    /** 선택된 시간 (제어 모드, ISO 8601 UTC). 날짜 부분은 무시되고 시간만 사용. */
+    value?: ISODateString | null;
+    /** 초기 시간 (비제어 모드) */
+    defaultValue?: ISODateString;
+    /** 시간 변경 콜백 */
+    onChange?: (value: ISODateString | null) => void;
+    /** 12시간제 또는 24시간제 */
+    format?: TimePickerFormat;
+    /** 분 step (1, 5, 10, 15, 30 등) */
+    step?: number;
+    /** 초 표시 여부 */
+    withSeconds?: boolean;
+    /** 전체 비활성화 */
+    disabled?: boolean;
+    /** 읽기 전용 */
+    readOnly?: boolean;
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+}
+export declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, disabled, readOnly, children, }: TimePickerRootProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Root.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Root.d.ts","sourceRoot":"","sources":["../../../src/components/TimePicker/Root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,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,qBAAqB;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB;AAUD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,QAAQ,EACR,MAAc,EACd,IAAQ,EACR,WAAmB,EACnB,QAAgB,EAChB,QAAgB,EAChB,QAAQ,GACT,EAAE,mBAAmB,2CA8CrB"}

package/dist/components/TimePicker/Root.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useId, useMemo, useRef, useState } from 'react';
+import { getTime, setTime as setTimeOnIso } from '@kalyx/core';
+import { TimePickerContext } from '../../context/TimePickerContext.js';
+/** value가 null일 때 사용할 기본 ISO (오늘 00:00:00 UTC) */
+function getDefaultIso() {
+    const now = new Date();
+    return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())).toISOString();
+}
+export function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format = '24h', step = 1, withSeconds = false, disabled = false, readOnly = false, children, }) {
+    const pickerId = useId();
+    const isControlled = useRef(controlledValue !== undefined).current;
+    const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue ?? null);
+    const currentValue = isControlled ? (controlledValue ?? null) : uncontrolledValue;
+    // value가 null이어도 시간 선택은 가능해야 함 → fallback
+    const baseIso = currentValue ?? getDefaultIso();
+    const currentTime = useMemo(() => getTime(baseIso), [baseIso]);
+    const setTime = useCallback((partial) => {
+        if (disabled || readOnly)
+            return;
+        const newIso = setTimeOnIso(baseIso, partial);
+        if (!isControlled) {
+            setUncontrolledValue(newIso);
+        }
+        onChange?.(newIso);
+    }, [disabled, readOnly, baseIso, isControlled, onChange]);
+    const contextValue = useMemo(() => ({
+        value: currentValue,
+        setTime,
+        format,
+        step,
+        withSeconds,
+        isDisabled: disabled,
+        isReadOnly: readOnly,
+        currentTime,
+        pickerId,
+    }), [currentValue, setTime, format, step, withSeconds, disabled, readOnly, currentTime, pickerId]);
+    return (_jsx(TimePickerContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=Root.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Root.js","sourceRoot":"","sources":["../../../src/components/TimePicker/Root.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAwCvE,kDAAkD;AAClD,SAAS,aAAa;IACpB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,IAAI,IAAI,CACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CACpE,CAAC,WAAW,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,QAAQ,EACR,MAAM,GAAG,KAAK,EACd,IAAI,GAAG,CAAC,EACR,WAAW,GAAG,KAAK,EACnB,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,KAAK,EAChB,QAAQ,GACY;IACpB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;IACzB,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,OAAO,CAAC;IAEnE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CACxD,YAAY,IAAI,IAAI,CACrB,CAAC;IAEF,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAElF,0CAA0C;IAC1C,MAAM,OAAO,GAAG,YAAY,IAAI,aAAa,EAAE,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,OAA2B,EAAE,EAAE;QAC9B,IAAI,QAAQ,IAAI,QAAQ;YAAE,OAAO;QACjC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC,EACD,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CACtD,CAAC;IAEF,MAAM,YAAY,GAA2B,OAAO,CAClD,GAAG,EAAE,CAAC,CAAC;QACL,KAAK,EAAE,YAAY;QACnB,OAAO;QACP,MAAM;QACN,IAAI;QACJ,WAAW;QACX,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,QAAQ;QACpB,WAAW;QACX,QAAQ;KACT,CAAC,EACF,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAC9F,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC5C,QAAQ,GACkB,CAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,32 @@
+import { TimePickerRoot } from './Root.js';
+import { TimePickerHourList } from './HourList.js';
+import { TimePickerMinuteList } from './MinuteList.js';
+import { TimePickerAmPmToggle } from './AmPmToggle.js';
+import type { TimePickerRootProps } from './Root.js';
+import type { TimePickerInputProps } from './Input.js';
+import type { TimePickerHourListProps, TimePickerHourListClassNames } from './HourList.js';
+import type { TimePickerMinuteListProps, TimePickerMinuteListClassNames } from './MinuteList.js';
+import type { TimePickerAmPmToggleProps, TimePickerAmPmToggleClassNames } from './AmPmToggle.js';
+/**
+ * TimePicker — Headless 시간 선택 컴포넌트
+ *
+ * @example
+ * ```tsx
+ * <TimePicker value={time} onChange={setTime} format="24h" step={15}>
+ *   <TimePicker.Input />
+ *   <div>
+ *     <TimePicker.HourList />
+ *     <TimePicker.MinuteList />
+ *     <TimePicker.AmPmToggle />
+ *   </div>
+ * </TimePicker>
+ * ```
+ */
+export declare const TimePicker: typeof TimePickerRoot & {
+    Input: import("react").ForwardRefExoticComponent<TimePickerInputProps & import("react").RefAttributes<HTMLInputElement>>;
+    HourList: typeof TimePickerHourList;
+    MinuteList: typeof TimePickerMinuteList;
+    AmPmToggle: typeof TimePickerAmPmToggle;
+};
+export type { TimePickerRootProps, TimePickerInputProps, TimePickerHourListProps, TimePickerHourListClassNames, TimePickerMinuteListProps, TimePickerMinuteListClassNames, TimePickerAmPmToggleProps, TimePickerAmPmToggleClassNames, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TimePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU;;;;;CAKrB,CAAC;AAEH,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,yBAAyB,EACzB,8BAA8B,GAC/B,CAAC"}

package/dist/components/TimePicker/index.js

@@ -0,0 +1,27 @@
+import { TimePickerRoot } from './Root.js';
+import { TimePickerInput } from './Input.js';
+import { TimePickerHourList } from './HourList.js';
+import { TimePickerMinuteList } from './MinuteList.js';
+import { TimePickerAmPmToggle } from './AmPmToggle.js';
+/**
+ * TimePicker — Headless 시간 선택 컴포넌트
+ *
+ * @example
+ * ```tsx
+ * <TimePicker value={time} onChange={setTime} format="24h" step={15}>
+ *   <TimePicker.Input />
+ *   <div>
+ *     <TimePicker.HourList />
+ *     <TimePicker.MinuteList />
+ *     <TimePicker.AmPmToggle />
+ *   </div>
+ * </TimePicker>
+ * ```
+ */
+export const TimePicker = Object.assign(TimePickerRoot, {
+    Input: TimePickerInput,
+    HourList: TimePickerHourList,
+    MinuteList: TimePickerMinuteList,
+    AmPmToggle: TimePickerAmPmToggle,
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/TimePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAiBvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE;IACtD,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,kBAAkB;IAC5B,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE,oBAAoB;CACjC,CAAC,CAAC"}

package/dist/context/DatePickerContext.d.ts

@@ -0,0 +1,49 @@
+import type { MutableRefObject } from 'react';
+import type { DateAdapter, DisabledRule, ISODateString, WeekStartsOn } from '@kalyx/core';
+export interface DatePickerContextValue {
+    /** Floating UI reference 요소 (Input/Trigger가 설정, Popover가 읽음) */
+    referenceRef: MutableRefObject<HTMLElement | null>;
+    /** 현재 선택된 날짜 (ISO 8601 UTC) */
+    value: ISODateString | null;
+    /** 날짜 선택 핸들러 */
+    selectDate: (iso: ISODateString | null) => void;
+    /** 팝오버 열림 상태 */
+    isOpen: boolean;
+    /** 팝오버 열기 */
+    open: () => void;
+    /** 팝오버 닫기 */
+    close: () => void;
+    /** 팝오버 토글 */
+    toggle: () => void;
+    /** 현재 표시 중인 월 (ISO string) */
+    viewMonth: ISODateString;
+    /** 표시 월 변경 */
+    setViewMonth: (iso: ISODateString) => void;
+    /** 캘린더에서 포커스된 날짜 */
+    focusedDate: ISODateString;
+    /** 포커스 날짜 변경 */
+    setFocusedDate: (iso: ISODateString) => void;
+    /** 날짜 어댑터 */
+    adapter: DateAdapter;
+    /** 비활성화 규칙 */
+    disabled: DisabledRule[];
+    /** 주 시작 요일 */
+    weekStartsOn: WeekStartsOn;
+    /** 날짜 표시 포맷 */
+    displayFormat: string;
+    /** BCP 47 locale (예: "en-US", "ko-KR") */
+    locale: string;
+    /** 전체 비활성화 */
+    isDisabled: boolean;
+    /** 읽기 전용 */
+    isReadOnly: boolean;
+    /** 고유 ID (useId 기반) */
+    pickerId: string;
+}
+export declare const DatePickerContext: import("react").Context<DatePickerContextValue | null>;
+/**
+ * DatePickerContext를 소비한다.
+ * DatePicker.Root 외부에서 호출하면 명확한 에러를 던진다.
+ */
+export declare function useDatePickerContext(componentName: string): DatePickerContextValue;
+//# sourceMappingURL=DatePickerContext.d.ts.map

package/dist/context/DatePickerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePickerContext.d.ts","sourceRoot":"","sources":["../../src/context/DatePickerContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,YAAY,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnD,+BAA+B;IAC/B,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,gBAAgB;IAChB,UAAU,EAAE,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa;IACb,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,aAAa;IACb,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc;IACd,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,oBAAoB;IACpB,WAAW,EAAE,aAAa,CAAC;IAC3B,gBAAgB;IAChB,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,aAAa;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,cAAc;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,wDAAqD,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,sBAAsB,CAYlF"}

package/dist/context/DatePickerContext.js

@@ -0,0 +1,18 @@
+import { createContext, useContext } from 'react';
+export const DatePickerContext = createContext(null);
+/**
+ * DatePickerContext를 소비한다.
+ * DatePicker.Root 외부에서 호출하면 명확한 에러를 던진다.
+ */
+export function useDatePickerContext(componentName) {
+    const context = useContext(DatePickerContext);
+    if (!context) {
+        throw new Error(`[${componentName}] DatePicker.Root 내부에서 사용해야 합니다.\n\n` +
+            '올바른 사용법:\n' +
+            '  <DatePicker>\n' +
+            `    <DatePicker.${componentName.replace('DatePicker.', '')} />\n` +
+            '  </DatePicker>');
+    }
+    return context;
+}
+//# sourceMappingURL=DatePickerContext.js.map

package/dist/context/DatePickerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePickerContext.js","sourceRoot":"","sources":["../../src/context/DatePickerContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA6ClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAgC,IAAI,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,IAAI,aAAa,sCAAsC;YACvD,YAAY;YACZ,kBAAkB;YAClB,mBAAmB,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,OAAO;YAClE,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/context/RangePickerContext.d.ts

@@ -0,0 +1,53 @@
+import type { MutableRefObject } from 'react';
+import type { DateAdapter, DateRange, DisabledRule, ISODateString, WeekStartsOn } from '@kalyx/core';
+/** 다음에 선택할 부분 (start | end) */
+export type RangeSelectingTarget = 'start' | 'end';
+export interface RangePickerContextValue {
+    /** Floating UI reference 요소 */
+    referenceRef: MutableRefObject<HTMLElement | null>;
+    /** 현재 선택된 범위 */
+    value: DateRange;
+    /** 범위 변경 (Range 객체 전체 갱신) */
+    setRange: (range: DateRange) => void;
+    /** 단일 날짜 클릭 → 자동으로 start/end 결정 */
+    selectDate: (iso: ISODateString) => void;
+    /** 다음에 선택될 부분 (start 먼저 → end 다음) */
+    selectingTarget: RangeSelectingTarget;
+    /** hover 중인 날짜 (범위 미리보기용) */
+    hoverDate: ISODateString | null;
+    setHoverDate: (iso: ISODateString | null) => void;
+    /** 팝오버 열림 상태 */
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    /** 현재 표시 중인 월 */
+    viewMonth: ISODateString;
+    setViewMonth: (iso: ISODateString) => void;
+    /** 캘린더에서 포커스된 날짜 */
+    focusedDate: ISODateString;
+    setFocusedDate: (iso: ISODateString) => void;
+    /** 날짜 어댑터 */
+    adapter: DateAdapter;
+    /** 비활성화 규칙 */
+    disabled: DisabledRule[];
+    /** 주 시작 요일 */
+    weekStartsOn: WeekStartsOn;
+    /** 날짜 표시 포맷 */
+    displayFormat: string;
+    /** BCP 47 locale */
+    locale: string;
+    /** 전체 비활성화 */
+    isDisabled: boolean;
+    /** 읽기 전용 */
+    isReadOnly: boolean;
+    /** 고유 ID */
+    pickerId: string;
+}
+export declare const RangePickerContext: import("react").Context<RangePickerContextValue | null>;
+/**
+ * RangePickerContext를 소비한다.
+ * RangePicker.Root 외부에서 호출하면 명확한 에러를 던진다.
+ */
+export declare function useRangePickerContext(componentName: string): RangePickerContextValue;
+//# sourceMappingURL=RangePickerContext.d.ts.map

package/dist/context/RangePickerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RangePickerContext.d.ts","sourceRoot":"","sources":["../../src/context/RangePickerContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,+BAA+B;AAC/B,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,YAAY,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnD,gBAAgB;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,mCAAmC;IACnC,UAAU,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,qCAAqC;IACrC,eAAe,EAAE,oBAAoB,CAAC;IACtC,6BAA6B;IAC7B,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iBAAiB;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,oBAAoB;IACpB,WAAW,EAAE,aAAa,CAAC;IAC3B,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,aAAa;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,cAAc;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB,yDAAsD,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,uBAAuB,CAYpF"}

package/dist/context/RangePickerContext.js

@@ -0,0 +1,18 @@
+import { createContext, useContext } from 'react';
+export const RangePickerContext = createContext(null);
+/**
+ * RangePickerContext를 소비한다.
+ * RangePicker.Root 외부에서 호출하면 명확한 에러를 던진다.
+ */
+export function useRangePickerContext(componentName) {
+    const context = useContext(RangePickerContext);
+    if (!context) {
+        throw new Error(`[${componentName}] RangePicker.Root 내부에서 사용해야 합니다.\n\n` +
+            '올바른 사용법:\n' +
+            '  <RangePicker>\n' +
+            `    <RangePicker.${componentName.replace('RangePicker.', '')} />\n` +
+            '  </RangePicker>');
+    }
+    return context;
+}
+//# sourceMappingURL=RangePickerContext.js.map

package/dist/context/RangePickerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RangePickerContext.js","sourceRoot":"","sources":["../../src/context/RangePickerContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAwDlD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAiC,IAAI,CAAC,CAAC;AAEtF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,aAAqB;IACzD,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,IAAI,aAAa,uCAAuC;YACtD,YAAY;YACZ,mBAAmB;YACnB,oBAAoB,aAAa,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO;YACpE,kBAAkB,CACrB,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/context/TimePickerContext.d.ts

@@ -0,0 +1,29 @@
+import type { ISODateString, TimeValue } from '@kalyx/core';
+export type TimePickerFormat = '12h' | '24h';
+export interface TimePickerContextValue {
+    /** 현재 선택된 ISO datetime (시간 부분만 의미 있음) */
+    value: ISODateString | null;
+    /** 시간 변경 (TimeValue 부분만 갱신) */
+    setTime: (partial: Partial<TimeValue>) => void;
+    /** 12/24시간제 모드 */
+    format: TimePickerFormat;
+    /** 분 step (예: 15면 0,15,30,45) */
+    step: number;
+    /** 초 표시 여부 */
+    withSeconds: boolean;
+    /** 전체 비활성화 */
+    isDisabled: boolean;
+    /** 읽기 전용 */
+    isReadOnly: boolean;
+    /** 현재 시간 (TimeValue) */
+    currentTime: TimeValue;
+    /** 고유 ID */
+    pickerId: string;
+}
+export declare const TimePickerContext: import("react").Context<TimePickerContextValue | null>;
+/**
+ * TimePickerContext를 소비한다.
+ * TimePicker.Root 외부에서 호출하면 명확한 에러를 던진다.
+ */
+export declare function useTimePickerContext(componentName: string): TimePickerContextValue;
+//# sourceMappingURL=TimePickerContext.d.ts.map

package/dist/context/TimePickerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimePickerContext.d.ts","sourceRoot":"","sources":["../../src/context/TimePickerContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC/C,kBAAkB;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,WAAW,EAAE,SAAS,CAAC;IACvB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,wDAAqD,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,sBAAsB,CAYlF"}

package/dist/context/TimePickerContext.js

@@ -0,0 +1,18 @@
+import { createContext, useContext } from 'react';
+export const TimePickerContext = createContext(null);
+/**
+ * TimePickerContext를 소비한다.
+ * TimePicker.Root 외부에서 호출하면 명확한 에러를 던진다.
+ */
+export function useTimePickerContext(componentName) {
+    const context = useContext(TimePickerContext);
+    if (!context) {
+        throw new Error(`[${componentName}] TimePicker.Root 내부에서 사용해야 합니다.\n\n` +
+            '올바른 사용법:\n' +
+            '  <TimePicker>\n' +
+            `    <TimePicker.${componentName.replace('TimePicker.', '')} />\n` +
+            '  </TimePicker>');
+    }
+    return context;
+}
+//# sourceMappingURL=TimePickerContext.js.map

package/dist/context/TimePickerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimePickerContext.js","sourceRoot":"","sources":["../../src/context/TimePickerContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA0BlD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAgC,IAAI,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,IAAI,aAAa,sCAAsC;YACrD,YAAY;YACZ,kBAAkB;YAClB,mBAAmB,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,OAAO;YAClE,iBAAiB,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/hooks/useDatePicker.d.ts

@@ -0,0 +1,63 @@
+import type { CalendarGrid, DateAdapter, DisabledRule, ISODateString, WeekStartsOn } from '@kalyx/core';
+export interface UseDatePickerOptions {
+    /** 선택된 날짜 (제어 모드) */
+    value?: ISODateString | null;
+    /** 초기 날짜 (비제어 모드) */
+    defaultValue?: ISODateString;
+    /** 날짜 변경 콜백 */
+    onChange?: (value: ISODateString | null) => void;
+    /** 비활성화 규칙 */
+    disabled?: DisabledRule[];
+    /** 주 시작 요일 */
+    weekStartsOn?: WeekStartsOn;
+    /** 날짜 어댑터 */
+    adapter?: DateAdapter;
+}
+export interface UseDatePickerReturn {
+    /** 현재 선택된 날짜 (ISO string) */
+    value: ISODateString | null;
+    /** 팝오버 열림 상태 */
+    isOpen: boolean;
+    /** 팝오버 열기 */
+    open: () => void;
+    /** 팝오버 닫기 */
+    close: () => void;
+    /** 팝오버 토글 */
+    toggle: () => void;
+    /** 날짜 선택 */
+    selectDate: (iso: ISODateString | null) => void;
+    /** 현재 표시 중인 월 (ISO string) */
+    viewMonth: ISODateString;
+    /** 표시 월 변경 */
+    setViewMonth: (iso: ISODateString) => void;
+    /** 캘린더 그리드 데이터 */
+    calendar: CalendarGrid;
+    /** 포커스된 날짜 */
+    focusedDate: ISODateString;
+    /** 포커스 날짜 변경 */
+    setFocusedDate: (iso: ISODateString) => void;
+    /** 이전 달로 이동 */
+    previousMonth: () => void;
+    /** 다음 달로 이동 */
+    nextMonth: () => void;
+    /** 고유 ID */
+    pickerId: string;
+    /** 날짜 어댑터 */
+    adapter: DateAdapter;
+}
+/**
+ * DatePicker의 상태를 관리하는 Hook.
+ * 컴포넌트를 사용하지 않고 완전 커스텀 UI를 구현할 때 사용한다.
+ *
+ * @example
+ * ```tsx
+ * function MyDatePicker() {
+ *   const { value, isOpen, calendar, open, selectDate } = useDatePicker({
+ *     onChange: (iso) => console.log(iso),
+ *   });
+ *   // ... 커스텀 렌더링
+ * }
+ * ```
+ */
+export declare function useDatePicker(options?: UseDatePickerOptions): UseDatePickerReturn;
+//# sourceMappingURL=useDatePicker.d.ts.map

package/dist/hooks/useDatePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatePicker.d.ts","sourceRoot":"","sources":["../../src/hooks/useDatePicker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,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,CAAC;IAC1B,cAAc;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa;IACb,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,aAAa;IACb,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY;IACZ,UAAU,EAAE,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,8BAA8B;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc;IACd,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,kBAAkB;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc;IACd,WAAW,EAAE,aAAa,CAAC;IAC3B,gBAAgB;IAChB,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,eAAe;IACf,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,eAAe;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAsFrF"}

package/dist/hooks/useDatePicker.js

@@ -0,0 +1,82 @@
+import { useCallback, useId, useRef, useState } from 'react';
+import { DateFnsAdapter, getCalendarDays } from '@kalyx/core';
+/**
+ * DatePicker의 상태를 관리하는 Hook.
+ * 컴포넌트를 사용하지 않고 완전 커스텀 UI를 구현할 때 사용한다.
+ *
+ * @example
+ * ```tsx
+ * function MyDatePicker() {
+ *   const { value, isOpen, calendar, open, selectDate } = useDatePicker({
+ *     onChange: (iso) => console.log(iso),
+ *   });
+ *   // ... 커스텀 렌더링
+ * }
+ * ```
+ */
+export function useDatePicker(options = {}) {
+    const { value: controlledValue, defaultValue, onChange, disabled = [], weekStartsOn = 0, adapter = DateFnsAdapter, } = options;
+    const pickerId = useId();
+    const isControlled = useRef(controlledValue !== undefined).current;
+    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 selectDate = useCallback((iso) => {
+        if (!isControlled) {
+            setUncontrolledValue(iso);
+        }
+        onChange?.(iso);
+        setIsOpen(false);
+    }, [isControlled, onChange]);
+    const open = useCallback(() => {
+        setIsOpen(true);
+        const target = currentValue ?? adapter.today();
+        setViewMonth(target);
+        setFocusedDate(target);
+    }, [currentValue, adapter]);
+    const close = useCallback(() => {
+        setIsOpen(false);
+    }, []);
+    const toggle = useCallback(() => {
+        if (isOpen)
+            close();
+        else
+            open();
+    }, [isOpen, open, close]);
+    const previousMonth = useCallback(() => {
+        const newMonth = adapter.addMonths(viewMonth, -1);
+        setViewMonth(newMonth);
+        setFocusedDate(adapter.startOfMonth(newMonth));
+    }, [adapter, viewMonth]);
+    const nextMonth = useCallback(() => {
+        const newMonth = adapter.addMonths(viewMonth, 1);
+        setViewMonth(newMonth);
+        setFocusedDate(adapter.startOfMonth(newMonth));
+    }, [adapter, viewMonth]);
+    const calendar = getCalendarDays(viewMonth, adapter, {
+        weekStartsOn,
+        selected: currentValue,
+        focusedDate,
+        disabled,
+    });
+    return {
+        value: currentValue,
+        isOpen,
+        open,
+        close,
+        toggle,
+        selectDate,
+        viewMonth,
+        setViewMonth,
+        calendar,
+        focusedDate,
+        setFocusedDate,
+        previousMonth,
+        nextMonth,
+        pickerId,
+        adapter,
+    };
+}
+//# sourceMappingURL=useDatePicker.js.map

package/dist/hooks/useDatePicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatePicker.js","sourceRoot":"","sources":["../../src/hooks/useDatePicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAyD9D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,EACJ,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,QAAQ,EACR,QAAQ,GAAG,EAAE,EACb,YAAY,GAAG,CAAC,EAChB,OAAO,GAAG,cAAc,GACzB,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;IACzB,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,OAAO,CAAC;IAEnE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CACxD,YAAY,IAAI,IAAI,CACrB,CAAC;IAEF,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAElF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAgB,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE/F,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,GAAyB,EAAE,EAAE;QAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QACD,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QAChB,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,EACD,CAAC,YAAY,EAAE,QAAQ,CAAC,CACzB,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/C,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,cAAc,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,MAAM;YAAE,KAAK,EAAE,CAAC;;YACf,IAAI,EAAE,CAAC;IACd,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1B,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAEzB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACjD,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAEzB,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE;QACnD,YAAY;QACZ,QAAQ,EAAE,YAAY;QACtB,WAAW;QACX,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,MAAM;QACN,IAAI;QACJ,KAAK;QACL,MAAM;QACN,UAAU;QACV,SAAS;QACT,YAAY;QACZ,QAAQ;QACR,WAAW;QACX,cAAc;QACd,aAAa;QACb,SAAS;QACT,QAAQ;QACR,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/hooks/useRangePicker.d.ts

@@ -0,0 +1,67 @@
+import type { CalendarGrid, DateAdapter, DateRange, DisabledRule, ISODateString, WeekStartsOn } from '@kalyx/core';
+import type { RangeSelectingTarget } from '../context/RangePickerContext.js';
+export interface UseRangePickerOptions {
+    /** 선택된 범위 (제어 모드) */
+    value?: DateRange;
+    /** 초기 범위 (비제어 모드) */
+    defaultValue?: DateRange;
+    /** 범위 변경 콜백 */
+    onChange?: (range: DateRange) => void;
+    /** 비활성화 규칙 */
+    disabled?: DisabledRule[];
+    /** 주 시작 요일 */
+    weekStartsOn?: WeekStartsOn;
+    /** 날짜 어댑터 */
+    adapter?: DateAdapter;
+}
+export interface UseRangePickerReturn {
+    /** 현재 선택된 범위 */
+    value: DateRange;
+    /** 다음에 선택될 부분 */
+    selectingTarget: RangeSelectingTarget;
+    /** 단일 날짜 클릭 핸들러 */
+    selectDate: (iso: ISODateString) => void;
+    /** 범위 직접 설정 */
+    setRange: (range: DateRange) => void;
+    /** 팝오버 열림 상태 */
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    /** hover 날짜 (미리보기용) */
+    hoverDate: ISODateString | null;
+    setHoverDate: (iso: ISODateString | null) => void;
+    /** 현재 표시 중인 월 */
+    viewMonth: ISODateString;
+    setViewMonth: (iso: ISODateString) => void;
+    /** 캘린더 그리드 */
+    calendar: CalendarGrid;
+    /** 포커스된 날짜 */
+    focusedDate: ISODateString;
+    setFocusedDate: (iso: ISODateString) => void;
+    /** 이전 달로 이동 */
+    previousMonth: () => void;
+    /** 다음 달로 이동 */
+    nextMonth: () => void;
+    /** 고유 ID */
+    pickerId: string;
+    /** 어댑터 */
+    adapter: DateAdapter;
+}
+/**
+ * RangePicker 상태 관리 Hook.
+ * 컴포넌트 없이 완전 커스텀 UI를 만들 때 사용한다.
+ *
+ * @example
+ * ```tsx
+ * function MyRangePicker() {
+ *   const { value, calendar, selectDate, selectingTarget } = useRangePicker({
+ *     onChange: (range) => console.log(range.start, range.end),
+ *   });
+ *   // selectingTarget === 'start' → 시작일 선택 대기
+ *   // selectingTarget === 'end' → 종료일 선택 대기
+ * }
+ * ```
+ */
+export declare function useRangePicker(options?: UseRangePickerOptions): UseRangePickerReturn;
+//# sourceMappingURL=useRangePicker.d.ts.map

package/dist/hooks/useRangePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRangePicker.d.ts","sourceRoot":"","sources":["../../src/hooks/useRangePicker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAI7E,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qBAAqB;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,eAAe;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,cAAc;IACd,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,cAAc;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,iBAAiB;IACjB,eAAe,EAAE,oBAAoB,CAAC;IACtC,mBAAmB;IACnB,UAAU,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,eAAe;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,uBAAuB;IACvB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,iBAAiB;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,cAAc;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc;IACd,WAAW,EAAE,aAAa,CAAC;IAC3B,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,eAAe;IACf,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,eAAe;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CA+HxF"}