@kalyx/react 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -5,9 +5,9 @@ import { ISODateString, DisabledRule, WeekStartsOn, DateAdapter, DateRange, Cale
 export { CalendarDay, DateAdapter, DateFnsAdapter, DateRange, DisabledRule, ISODateString, TimeValue } from '@kalyx/core';
 
 /**
- * DatePicker의 Root 컴포넌트 props.
+ * Props for the DatePicker Root component.
  *
- * @example 제어 모드
+ * @example Controlled
  * ```tsx
  * <DatePicker value={date} onChange={setDate}>
  *   <DatePicker.Input />
@@ -17,7 +17,7 @@ export { CalendarDay, DateAdapter, DateFnsAdapter, DateRange, DisabledRule, ISOD
  * </DatePicker>
  * ```
  *
- * @example 비제어 모드
+ * @example Uncontrolled
  * ```tsx
  * <DatePicker defaultValue="2026-01-15T00:00:00.000Z">
  *   <DatePicker.Input />
@@ -25,25 +25,25 @@ export { CalendarDay, DateAdapter, DateFnsAdapter, DateRange, DisabledRule, ISOD
  * ```
  */
 interface DatePickerRootProps {
-    /** 선택된 날짜 (제어 모드, ISO 8601 UTC). `null`이면 빈 상태. */
+    /** Selected date (controlled, ISO 8601 UTC). `null` means empty. */
     value?: ISODateString | null;
-    /** 초기 날짜 (비제어 모드) */
+    /** Initial date (uncontrolled) */
     defaultValue?: ISODateString;
-    /** 날짜 변경 콜백 */
+    /** Callback fired when the date changes */
     onChange?: (value: ISODateString | null) => void;
-    /** 비활성화 규칙 */
+    /** Disabled rules */
     disabled?: DisabledRule[] | boolean;
-    /** 읽기 전용 */
+    /** Read-only */
     readOnly?: boolean;
-    /** 주 시작 요일 */
+    /** Week start day */
     weekStartsOn?: WeekStartsOn;
-    /** 날짜 표시 포맷 */
+    /** Date display format */
     displayFormat?: string;
-    /** BCP 47 locale (예: "en-US", "ko-KR", "ja-JP") */
+    /** BCP 47 locale (e.g., "en-US", "ko-KR", "ja-JP") */
     locale?: string;
-    /** 날짜 어댑터 */
+    /** Date adapter */
     adapter?: DateAdapter;
-    /** 자식 컴포넌트 */
+    /** Child components */
     children: ReactNode;
 }
 declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
@@ -70,7 +70,7 @@ interface DatePickerCalendarClassNames {
 }
 interface DatePickerCalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     classNames?: DatePickerCalendarClassNames;
-    /** 타이틀("January 2026") 클릭 시 콜백. Month/Year 뷰 전환에 사용. */
+    /** Called when the title ("January 2026") is clicked. Useful for switching to Month/Year views. */
     onTitleClick?: () => void;
 }
 declare function DatePickerCalendar({ classNames, onTitleClick, ...props }: DatePickerCalendarProps): react_jsx_runtime.JSX.Element;
@@ -87,14 +87,14 @@ interface DatePickerMonthGridClassNames {
 }
 interface DatePickerMonthGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     classNames?: DatePickerMonthGridClassNames;
-    /** 월 선택 시 콜백. 일반적으로 day 뷰로 전환한다. */
+    /** Called when a month is selected. Typically used to switch back to the day view. */
     onSelect?: () => void;
-    /** 타이틀(년도) 클릭 시 콜백. Year 뷰로 전환할 때 사용. */
+    /** Called when the title (year) is clicked. Useful for switching to the year view. */
     onTitleClick?: () => void;
 }
 /**
- * DatePicker.MonthGrid — 12개월 그리드에서 월을 빠르게 선택.
- * Calendar 타이틀 클릭 → MonthGrid 표시 → 월 클릭 → Calendar로 복귀.
+ * DatePicker.MonthGrid — Quickly pick a month from a 12-month grid.
+ * Click Calendar title -> MonthGrid -> click a month -> back to Calendar.
  *
  * @example
  * ```tsx
@@ -120,12 +120,12 @@ interface DatePickerYearGridClassNames {
 }
 interface DatePickerYearGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     classNames?: DatePickerYearGridClassNames;
-    /** 년 선택 시 콜백. 일반적으로 month 뷰로 전환한다. */
+    /** Called when a year is selected. Typically used to switch back to the month view. */
     onSelect?: () => void;
 }
 /**
- * DatePicker.YearGrid — 12년 단위 그리드에서 년도를 빠르게 선택.
- * MonthGrid 타이틀 클릭 → YearGrid 표시 → 년 클릭 → MonthGrid로 복귀.
+ * DatePicker.YearGrid — Quickly pick a year from a 12-year grid.
+ * Click MonthGrid title -> YearGrid -> click a year -> back to MonthGrid.
  *
  * @example
  * ```tsx
@@ -137,7 +137,7 @@ interface DatePickerYearGridProps extends Omit<HTMLAttributes<HTMLDivElement>, '
 declare function DatePickerYearGrid({ classNames, onSelect, ...props }: DatePickerYearGridProps): react_jsx_runtime.JSX.Element;
 
 interface DatePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
-    /** 날짜 표시 포맷 (기본: 부모의 displayFormat) */
+    /** Date display format (defaults to parent's displayFormat) */
     format?: string;
 }
 
@@ -148,7 +148,7 @@ interface DatePickerTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonEle
 /**
  * DatePicker — Headless, SSR-safe React DatePicker
  *
- * @example 기본
+ * @example Basic
  * ```tsx
  * <DatePicker value={date} onChange={setDate}>
  *   <DatePicker.Input placeholder="날짜 선택" />
@@ -158,7 +158,7 @@ interface DatePickerTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonEle
  * </DatePicker>
  * ```
  *
- * @example Month/Year 빠른 네비게이션
+ * @example Month/Year quick navigation
  * ```tsx
  * const [view, setView] = useState('days');
  * <DatePicker value={date} onChange={setDate}>
@@ -181,7 +181,7 @@ declare const DatePicker: typeof DatePickerRoot & {
 };
 
 /**
- * RangePicker의 Root 컴포넌트 props.
+ * Props for the RangePicker Root component.
  *
  * @example
  * ```tsx
@@ -195,25 +195,25 @@ declare const DatePicker: typeof DatePickerRoot & {
  * ```
  */
 interface RangePickerRootProps {
-    /** 선택된 범위 (제어 모드). `{ start, end }` 형태의 ISO string 또는 null. */
+    /** Selected range (controlled). `{ start, end }` with ISO strings or null. */
     value?: DateRange;
-    /** 초기 범위 (비제어 모드) */
+    /** Initial range (uncontrolled) */
     defaultValue?: DateRange;
-    /** 범위 변경 콜백 */
+    /** Callback fired when the range changes */
     onChange?: (range: DateRange) => void;
-    /** 비활성화 규칙 */
+    /** Disabled rules */
     disabled?: DisabledRule[] | boolean;
-    /** 읽기 전용 */
+    /** Read-only */
     readOnly?: boolean;
-    /** 주 시작 요일 */
+    /** Week start day */
     weekStartsOn?: WeekStartsOn;
-    /** 날짜 표시 포맷 */
+    /** Date display format */
     displayFormat?: string;
     /** BCP 47 locale */
     locale?: string;
-    /** 날짜 어댑터 */
+    /** Date adapter */
     adapter?: DateAdapter;
-    /** 자식 컴포넌트 */
+    /** Child components */
     children: ReactNode;
 }
 declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
@@ -246,7 +246,7 @@ interface RangePickerCalendarProps extends Omit<HTMLAttributes<HTMLDivElement>,
 }
 declare function RangePickerCalendar({ classNames, ...props }: RangePickerCalendarProps): react_jsx_runtime.JSX.Element;
 
-/** 미리 정의된 프리셋 키. 커스텀 범위도 가능. */
+/** Predefined preset keys. Custom ranges are also supported. */
 type PresetKey = 'today' | 'yesterday' | 'last7days' | 'last30days' | 'thisWeek' | 'lastWeek' | 'thisMonth' | 'lastMonth' | 'thisYear';
 interface RangePickerPresetsClassNames {
     root?: string;
@@ -258,8 +258,8 @@ interface RangePickerPresetsProps extends Omit<HTMLAttributes<HTMLDivElement>, '
     children?: ReactNode;
 }
 /**
- * RangePicker.Presets — 프리셋 버튼들을 감싸는 컨테이너.
- * 내부에 `RangePicker.Preset` 버튼들을 배치한다.
+ * RangePicker.Presets — Container that wraps preset buttons.
+ * Place `RangePicker.Preset` buttons inside.
  *
  * @example
  * ```tsx
@@ -271,17 +271,17 @@ interface RangePickerPresetsProps extends Omit<HTMLAttributes<HTMLDivElement>, '
  */
 declare function RangePickerPresets({ classNames, children, ...props }: RangePickerPresetsProps): react_jsx_runtime.JSX.Element;
 interface RangePickerPresetProps extends Omit<HTMLAttributes<HTMLButtonElement>, 'value'> {
-    /** 미리 정의된 프리셋 키 또는 직접 range 전달 시 생략 */
+    /** Predefined preset key; omit when passing `range` directly */
     value?: PresetKey;
-    /** 직접 범위를 지정할 때 사용 (value 대신) */
+    /** Pass a range directly (alternative to `value`) */
     range?: DateRange;
     children: ReactNode;
     className?: string;
 }
 /**
- * RangePicker.Preset — 한 클릭으로 날짜 범위를 선택하는 프리셋 버튼.
+ * RangePicker.Preset — One-click preset button to select a date range.
  *
- * `value` (프리셋 키) 또는 `range` (직접 범위)를 전달한다.
+ * Pass either `value` (a preset key) or `range` (a direct range).
  *
  * @example
  * ```tsx
@@ -295,16 +295,16 @@ declare function RangePickerPreset({ value: presetKey, range: directRange, child
 
 type RangeInputPart = 'start' | 'end';
 interface RangePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
-    /** 어떤 부분의 입력인지 (start | end) */
+    /** Which part this input represents (start | end) */
     part: RangeInputPart;
-    /** 날짜 표시 포맷 (기본: 부모의 displayFormat) */
+    /** Date display format (defaults to parent's displayFormat) */
     format?: string;
 }
 
 /**
- * RangePicker — Headless 날짜 범위 선택 컴포넌트
+ * RangePicker — Headless date-range picker component
  *
- * @example 기본
+ * @example Basic
  * ```tsx
  * <RangePicker value={range} onChange={setRange}>
  *   <RangePicker.Input part="start" />
@@ -315,7 +315,7 @@ interface RangePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElemen
  * </RangePicker>
  * ```
  *
- * @example Presets (대시보드)
+ * @example Presets (dashboard)
  * ```tsx
  * <RangePicker value={range} onChange={setRange}>
  *   <RangePicker.Input part="start" />
@@ -342,7 +342,7 @@ declare const RangePicker: typeof RangePickerRoot & {
 type TimePickerFormat = '12h' | '24h';
 
 /**
- * TimePicker의 Root 컴포넌트 props.
+ * Props for the TimePicker Root component.
  *
  * @example
  * ```tsx
@@ -355,23 +355,23 @@ type TimePickerFormat = '12h' | '24h';
  * ```
  */
 interface TimePickerRootProps {
-    /** 선택된 시간 (제어 모드, ISO 8601 UTC). 날짜 부분은 무시되고 시간만 사용. */
+    /** Selected time (controlled, ISO 8601 UTC). The date portion is ignored; only the time is used. */
     value?: ISODateString | null;
-    /** 초기 시간 (비제어 모드) */
+    /** Initial time (uncontrolled) */
     defaultValue?: ISODateString;
-    /** 시간 변경 콜백 */
+    /** Callback fired when the time changes */
     onChange?: (value: ISODateString | null) => void;
-    /** 12시간제 또는 24시간제 */
+    /** 12-hour or 24-hour mode */
     format?: TimePickerFormat;
-    /** 분 step (1, 5, 10, 15, 30 등) */
+    /** Minute step (e.g., 1, 5, 10, 15, 30) */
     step?: number;
-    /** 초 표시 여부 */
+    /** Whether to display seconds */
     withSeconds?: boolean;
-    /** 전체 비활성화 */
+    /** Whether entire picker is disabled */
     disabled?: boolean;
-    /** 읽기 전용 */
+    /** Read-only */
     readOnly?: boolean;
-    /** 자식 컴포넌트 */
+    /** Child components */
     children: ReactNode;
 }
 declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, disabled, readOnly, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
@@ -385,11 +385,11 @@ interface TimePickerHourListProps extends Omit<HTMLAttributes<HTMLUListElement>,
     classNames?: TimePickerHourListClassNames;
 }
 /**
- * TimePicker.HourList — `role="listbox"` 패턴의 시간 선택 리스트.
- * 12h/24h 모드에 따라 다르게 렌더링.
+ * TimePicker.HourList — `role="listbox"` pattern for hour selection.
+ * Renders differently depending on 12h/24h mode.
  *
- * ARIA 표준 listbox: <li role="option">이 직접 인터랙티브 요소.
- * 키보드: ↑/↓로 이동, Enter/Space로 선택.
+ * ARIA-standard listbox: the <li role="option"> element itself is interactive.
+ * Keyboard: ArrowUp/ArrowDown to navigate, Enter/Space to select.
  */
 declare function TimePickerHourList({ classNames, ...props }: TimePickerHourListProps): react_jsx_runtime.JSX.Element;
 
@@ -402,8 +402,8 @@ interface TimePickerMinuteListProps extends Omit<HTMLAttributes<HTMLUListElement
     classNames?: TimePickerMinuteListClassNames;
 }
 /**
- * TimePicker.MinuteList — `role="listbox"` 패턴의 분 선택 리스트.
- * step prop에 따라 표시되는 분이 결정된다 (예: step=15 → [0, 15, 30, 45]).
+ * TimePicker.MinuteList — `role="listbox"` pattern for minute selection.
+ * The displayed minutes depend on the `step` prop (e.g., step=15 -> [0, 15, 30, 45]).
  */
 declare function TimePickerMinuteList({ classNames, ...props }: TimePickerMinuteListProps): react_jsx_runtime.JSX.Element;
 
@@ -416,8 +416,8 @@ interface TimePickerAmPmToggleProps extends Omit<HTMLAttributes<HTMLDivElement>,
     classNames?: TimePickerAmPmToggleClassNames;
 }
 /**
- * TimePicker.AmPmToggle — 12시간제 모드에서만 표시되는 AM/PM 전환 버튼.
- * 24시간제에서는 null을 반환한다.
+ * TimePicker.AmPmToggle — AM/PM toggle shown only in 12-hour mode.
+ * Returns null in 24-hour mode.
  */
 declare function TimePickerAmPmToggle({ classNames, ...props }: TimePickerAmPmToggleProps): react_jsx_runtime.JSX.Element | null;
 
@@ -425,7 +425,7 @@ interface TimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement
 }
 
 /**
- * TimePicker — Headless 시간 선택 컴포넌트
+ * TimePicker — Headless time-picker component
  *
  * @example
  * ```tsx
@@ -447,8 +447,8 @@ declare const TimePicker: typeof TimePickerRoot & {
 };
 
 /**
- * DateTimePicker의 Root 컴포넌트 props.
- * 내부적으로 DatePickerContext + TimePickerContext를 동시에 제공 (Context Bridging).
+ * Props for the DateTimePicker Root component.
+ * Internally provides both DatePickerContext and TimePickerContext (context bridging).
  *
  * @example
  * ```tsx
@@ -463,43 +463,42 @@ declare const TimePicker: typeof TimePickerRoot & {
  * ```
  */
 interface DateTimePickerRootProps {
-    /** 선택된 datetime (제어 모드, ISO 8601 UTC). 날짜+시간 모두 포함. */
+    /** Selected datetime (controlled, ISO 8601 UTC). Includes both date and time. */
     value?: ISODateString | null;
-    /** 초기 datetime (비제어 모드) */
+    /** Initial datetime (uncontrolled) */
     defaultValue?: ISODateString;
-    /** datetime 변경 콜백 */
+    /** Callback fired when the datetime changes */
     onChange?: (value: ISODateString | null) => void;
-    /** 12/24시간제 */
+    /** 12-hour or 24-hour mode */
     format?: TimePickerFormat;
-    /** 분 step (1, 5, 15, 30 등) */
+    /** Minute step (e.g., 1, 5, 15, 30) */
     step?: number;
-    /** 비활성화 규칙 (날짜) */
+    /** Disabled rules (applied to dates) */
     disabled?: DisabledRule[] | boolean;
-    /** 읽기 전용 */
+    /** Read-only */
     readOnly?: boolean;
-    /** 주 시작 요일 */
+    /** Week start day */
     weekStartsOn?: WeekStartsOn;
-    /** 날짜·시간 표시 포맷 (Input용) */
+    /** Date+time display format (for Input) */
     displayFormat?: string;
     /** BCP 47 locale */
     locale?: string;
-    /** 날짜 어댑터 */
+    /** Date adapter */
     adapter?: DateAdapter;
-    /** 자식 컴포넌트 */
+    /** Child components */
     children: ReactNode;
 }
 /**
- * DateTimePicker.Root — DatePicker + TimePicker 통합 컴포넌트.
+ * DateTimePicker.Root — Combined DatePicker + TimePicker component.
  *
- * 단일 ISO datetime을 source of truth로 관리하고, 내부적으로
- * DatePickerContext와 TimePickerContext를 동시에 제공한다.
- * 따라서 DatePicker.Calendar, TimePicker.HourList 등 기존 컴포넌트를
- * 그대로 재사용할 수 있다.
+ * Manages a single ISO datetime as the source of truth while providing both
+ * DatePickerContext and TimePickerContext internally. This lets existing
+ * components such as DatePicker.Calendar and TimePicker.HourList be reused as-is.
  *
- * 핵심 동작:
- * - Calendar에서 날짜 클릭 → 날짜 부분만 변경, 시간 부분 보존, 팝오버 유지
- * - TimePicker에서 시간 변경 → 시간 부분만 변경, 날짜 부분 보존
- * - Escape / 바깥 클릭 → 팝오버 닫기 (확정)
+ * Key behavior:
+ * - Clicking a day in Calendar -> changes only the date, preserves the time, keeps popover open
+ * - Changing time in TimePicker -> changes only the time, preserves the date
+ * - Escape / outside click -> close the popover (commit)
  */
 declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
 
@@ -507,12 +506,11 @@ interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputEle
 }
 
 /**
- * DateTimePicker — 날짜와 시간을 함께 선택하는 통합 컴포넌트.
+ * DateTimePicker — Combined component for selecting both date and time.
  *
- * 단일 ISO datetime을 source of truth로 관리하며, 내부적으로
- * DatePickerContext와 TimePickerContext를 동시에 제공한다.
- * 따라서 DatePicker.Calendar, TimePicker.HourList 등 기존 컴포넌트가
- * 그대로 동작한다.
+ * Manages a single ISO datetime as the source of truth while providing both
+ * DatePickerContext and TimePickerContext internally. This lets existing
+ * components such as DatePicker.Calendar and TimePicker.HourList work as-is.
  *
  * @example
  * ```tsx
@@ -526,7 +524,7 @@ interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputEle
  * </DateTimePicker>
  * ```
  *
- * @example 12시간제 모드
+ * @example 12-hour mode
  * ```tsx
  * <DateTimePicker value={dt} onChange={setDt} format="12h" step={15}>
  *   <DateTimePicker.Input />
@@ -551,54 +549,54 @@ declare const DateTimePicker: typeof DateTimePickerRoot & {
 };
 
 interface UseDatePickerOptions {
-    /** 선택된 날짜 (제어 모드) */
+    /** Selected date (controlled mode) */
     value?: ISODateString | null;
-    /** 초기 날짜 (비제어 모드) */
+    /** Initial date (uncontrolled mode) */
     defaultValue?: ISODateString;
-    /** 날짜 변경 콜백 */
+    /** Callback fired when the date changes */
     onChange?: (value: ISODateString | null) => void;
-    /** 비활성화 규칙 */
+    /** Rules that mark days as disabled */
     disabled?: DisabledRule[];
-    /** 주 시작 요일 */
+    /** Day the week starts on */
     weekStartsOn?: WeekStartsOn;
-    /** 날짜 어댑터 */
+    /** Date adapter */
     adapter?: DateAdapter;
 }
 interface UseDatePickerReturn {
-    /** 현재 선택된 날짜 (ISO string) */
+    /** Currently selected date (ISO string) */
     value: ISODateString | null;
-    /** 팝오버 열림 상태 */
+    /** Whether the popover is open */
     isOpen: boolean;
-    /** 팝오버 열기 */
+    /** Open the popover */
     open: () => void;
-    /** 팝오버 닫기 */
+    /** Close the popover */
     close: () => void;
-    /** 팝오버 토글 */
+    /** Toggle the popover */
     toggle: () => void;
-    /** 날짜 선택 */
+    /** Select a date */
     selectDate: (iso: ISODateString | null) => void;
-    /** 현재 표시 중인 월 (ISO string) */
+    /** Month currently displayed (ISO string) */
     viewMonth: ISODateString;
-    /** 표시 월 변경 */
+    /** Change the displayed month */
     setViewMonth: (iso: ISODateString) => void;
-    /** 캘린더 그리드 데이터 */
+    /** Calendar grid data */
     calendar: CalendarGrid;
-    /** 포커스된 날짜 */
+    /** Currently focused date */
     focusedDate: ISODateString;
-    /** 포커스 날짜 변경 */
+    /** Update the focused date */
     setFocusedDate: (iso: ISODateString) => void;
-    /** 이전 달로 이동 */
+    /** Move to the previous month */
     previousMonth: () => void;
-    /** 다음 달로 이동 */
+    /** Move to the next month */
     nextMonth: () => void;
-    /** 고유 ID */
+    /** Unique ID */
     pickerId: string;
-    /** 날짜 어댑터 */
+    /** Date adapter */
     adapter: DateAdapter;
 }
 /**
- * DatePicker의 상태를 관리하는 Hook.
- * 컴포넌트를 사용하지 않고 완전 커스텀 UI를 구현할 때 사용한다.
+ * Hook that manages DatePicker state.
+ * Use this when you want to implement a fully custom UI without the built-in components.
  *
  * @example
  * ```tsx
@@ -606,66 +604,66 @@ interface UseDatePickerReturn {
  *   const { value, isOpen, calendar, open, selectDate } = useDatePicker({
  *     onChange: (iso) => console.log(iso),
  *   });
- *   // ... 커스텀 렌더링
+ *   // ... custom rendering
  * }
  * ```
  */
 declare function useDatePicker(options?: UseDatePickerOptions): UseDatePickerReturn;
 
-/** 다음에 선택할 부분 (start | end) */
+/** Which part to select next (start | end) */
 type RangeSelectingTarget = 'start' | 'end';
 
 interface UseRangePickerOptions {
-    /** 선택된 범위 (제어 모드) */
+    /** Selected range (controlled mode) */
     value?: DateRange;
-    /** 초기 범위 (비제어 모드) */
+    /** Initial range (uncontrolled mode) */
     defaultValue?: DateRange;
-    /** 범위 변경 콜백 */
+    /** Callback fired when the range changes */
     onChange?: (range: DateRange) => void;
-    /** 비활성화 규칙 */
+    /** Rules that mark days as disabled */
     disabled?: DisabledRule[];
-    /** 주 시작 요일 */
+    /** Day the week starts on */
     weekStartsOn?: WeekStartsOn;
-    /** 날짜 어댑터 */
+    /** Date adapter */
     adapter?: DateAdapter;
 }
 interface UseRangePickerReturn {
-    /** 현재 선택된 범위 */
+    /** Currently selected range */
     value: DateRange;
-    /** 다음에 선택될 부분 */
+    /** Which endpoint will be selected next */
     selectingTarget: RangeSelectingTarget;
-    /** 단일 날짜 클릭 핸들러 */
+    /** Handler for clicking a single date */
     selectDate: (iso: ISODateString) => void;
-    /** 범위 직접 설정 */
+    /** Set the range directly */
     setRange: (range: DateRange) => void;
-    /** 팝오버 열림 상태 */
+    /** Whether the popover is open */
     isOpen: boolean;
     open: () => void;
     close: () => void;
     toggle: () => void;
-    /** hover 날짜 (미리보기용) */
+    /** Hovered date (for range preview) */
     hoverDate: ISODateString | null;
     setHoverDate: (iso: ISODateString | null) => void;
-    /** 현재 표시 중인 월 */
+    /** Month currently displayed */
     viewMonth: ISODateString;
     setViewMonth: (iso: ISODateString) => void;
-    /** 캘린더 그리드 */
+    /** Calendar grid */
     calendar: CalendarGrid;
-    /** 포커스된 날짜 */
+    /** Currently focused date */
     focusedDate: ISODateString;
     setFocusedDate: (iso: ISODateString) => void;
-    /** 이전 달로 이동 */
+    /** Move to the previous month */
     previousMonth: () => void;
-    /** 다음 달로 이동 */
+    /** Move to the next month */
     nextMonth: () => void;
-    /** 고유 ID */
+    /** Unique ID */
     pickerId: string;
-    /** 어댑터 */
+    /** Date adapter */
     adapter: DateAdapter;
 }
 /**
- * RangePicker 상태 관리 Hook.
- * 컴포넌트 없이 완전 커스텀 UI를 만들 때 사용한다.
+ * Hook that manages RangePicker state.
+ * Use this when you want to build a fully custom UI without the built-in components.
  *
  * @example
  * ```tsx
@@ -673,58 +671,58 @@ interface UseRangePickerReturn {
  *   const { value, calendar, selectDate, selectingTarget } = useRangePicker({
  *     onChange: (range) => console.log(range.start, range.end),
  *   });
- *   // selectingTarget === 'start' → 시작일 선택 대기
- *   // selectingTarget === 'end' → 종료일 선택 대기
+ *   // selectingTarget === 'start' -> waiting for start date
+ *   // selectingTarget === 'end'   -> waiting for end date
  * }
  * ```
  */
 declare function useRangePicker(options?: UseRangePickerOptions): UseRangePickerReturn;
 
 interface UseTimePickerOptions {
-    /** 선택된 시간 (제어 모드) */
+    /** Selected time (controlled mode) */
     value?: ISODateString | null;
-    /** 초기 시간 (비제어 모드) */
+    /** Initial time (uncontrolled mode) */
     defaultValue?: ISODateString;
-    /** 시간 변경 콜백 */
+    /** Callback fired when the time changes */
     onChange?: (value: ISODateString | null) => void;
-    /** 12/24시간제 */
+    /** 12h or 24h format */
     format?: TimePickerFormat;
-    /** 분 step */
+    /** Minute step */
     step?: number;
-    /** 초 표시 */
+    /** Whether seconds are shown */
     withSeconds?: boolean;
 }
 interface UseTimePickerReturn {
-    /** 현재 ISO datetime 값 */
+    /** Current ISO datetime value */
     value: ISODateString | null;
-    /** 현재 시간 (TimeValue) */
+    /** Current time (TimeValue) */
     currentTime: TimeValue;
-    /** 시간 부분 변경 */
+    /** Update part of the time */
     setTime: (partial: Partial<TimeValue>) => void;
-    /** 시(hour) 직접 설정 (12h 모드면 1-12, 24h 모드면 0-23) */
+    /** Set the hour directly (1-12 in 12h mode, 0-23 in 24h mode) */
     setHour: (hour: number) => void;
-    /** 분 설정 */
+    /** Set the minute */
     setMinute: (minute: number) => void;
-    /** 초 설정 */
+    /** Set the second */
     setSecond: (second: number) => void;
-    /** AM/PM 변경 (12h 모드 전용) */
+    /** Change AM/PM (12h mode only) */
     setPeriod: (period: 'AM' | 'PM') => void;
-    /** 사용 가능한 시 리스트 */
+    /** Available hour list */
     availableHours: number[];
-    /** 사용 가능한 분 리스트 (step 적용) */
+    /** Available minute list (respects step) */
     availableMinutes: number[];
-    /** 12/24h 모드 */
+    /** 12h or 24h mode */
     format: TimePickerFormat;
-    /** 현재 표시용 시 (12h 모드면 1-12) */
+    /** Hour value for display (1-12 in 12h mode) */
     displayHour: number;
-    /** 현재 AM/PM (12h 모드 전용, 24h면 null) */
+    /** Current AM/PM (12h mode only, null in 24h) */
     period: 'AM' | 'PM' | null;
-    /** 고유 ID */
+    /** Unique ID */
     pickerId: string;
 }
 /**
- * TimePicker 상태 관리 Hook.
- * 컴포넌트 없이 완전 커스텀 UI를 구현할 때 사용한다.
+ * Hook that manages TimePicker state.
+ * Use this when you want to build a fully custom UI without the built-in components.
  *
  * @example
  * ```tsx