@kalyx/react 0.2.1 → 0.3.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createContext, forwardRef, useState, useCallback, useContext, useId, useRef, useMemo, useEffect } from 'react';
-import { parseInputValue, formatTimeString, parseTimeString, getTime, DateFnsAdapter, getMonthName, getWeekdayNames, getCalendarDays, formatMonthYear, formatFullDate, isDateDisabled, setTime, to12Hour, to24Hour, generateMinutes, generateHours } from '@kalyx/core';
+import { parseInputValue, formatTimeString, parseTimeString, getTime, DateFnsAdapter, DEFAULT_DATEPICKER_LABELS, getMonthName, getWeekdayNames, getCalendarDays, formatMonthYear, isDateDisabled, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, setTime, to12Hour, to24Hour, generateMinutes, generateHours, formatFullDate } from '@kalyx/core';
 export { DateFnsAdapter } from '@kalyx/core';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { useFloating, autoUpdate, offset, flip, shift } from '@floating-ui/react';
@@ -30,6 +30,7 @@ function DatePickerRoot({
   displayFormat = "yyyy-MM-dd",
   locale = "en-US",
   adapter = DateFnsAdapter,
+  labels: labelsProp,
   children
 }) {
   const pickerId = useId();
@@ -46,8 +47,15 @@ function DatePickerRoot({
   const [focusedDate, setFocusedDate] = useState(
     currentValue ?? adapter.today()
   );
+  const mergedLabels = useMemo(
+    () => ({ ...DEFAULT_DATEPICKER_LABELS, ...labelsProp }),
+    [labelsProp]
+  );
   const isDisabled = typeof disabled === "boolean" ? disabled : false;
-  const disabledRules = Array.isArray(disabled) ? disabled : [];
+  const disabledRules = useMemo(
+    () => Array.isArray(disabled) ? disabled : [],
+    [disabled]
+  );
   const selectDate = useCallback(
     (iso) => {
       if (isDisabled || readOnly) return;
@@ -96,7 +104,8 @@ function DatePickerRoot({
       locale,
       isDisabled,
       isReadOnly: readOnly,
-      pickerId
+      pickerId,
+      labels: mergedLabels
     }),
     [
       currentValue,
@@ -114,28 +123,37 @@ function DatePickerRoot({
       locale,
       isDisabled,
       readOnly,
-      pickerId
+      pickerId,
+      mergedLabels
     ]
   );
   return /* @__PURE__ */ jsx(DatePickerContext.Provider, { value: contextValue, children });
 }
 var DatePickerInput = forwardRef(
-  function DatePickerInput2({ format: formatProp, onFocus, onBlur, onKeyDown, ...props }, ref) {
+  function DatePickerInput2({ format: formatProp, onClick, onBlur, onKeyDown, ...props }, ref) {
     const ctx = useDatePickerContext("DatePicker.Input");
     const displayFormat = formatProp ?? ctx.displayFormat;
     const [inputText, setInputText] = useState(null);
-    const displayValue = inputText !== null ? inputText : ctx.value ? ctx.adapter.format(ctx.value, displayFormat) : "";
-    const handleFocus = useCallback(
+    let formattedValue = "";
+    if (ctx.value) {
+      try {
+        formattedValue = ctx.adapter.format(ctx.value, displayFormat);
+      } catch {
+        formattedValue = ctx.value;
+      }
+    }
+    const displayValue = inputText !== null ? inputText : formattedValue;
+    const handleClick = useCallback(
       (e) => {
-        ctx.open();
-        onFocus?.(e);
+        if (!ctx.isOpen) ctx.open();
+        onClick?.(e);
       },
-      [ctx, onFocus]
+      [ctx, onClick]
     );
     const handleBlur = useCallback(
       (e) => {
         if (inputText !== null) {
-          const parsed = parseInputValue(inputText, displayFormat, ctx.adapter);
+          const parsed = parseInputValue(inputText, ctx.adapter);
           if (parsed) {
             ctx.selectDate(parsed);
           }
@@ -154,7 +172,7 @@ var DatePickerInput = forwardRef(
           setInputText(null);
           return;
         }
-        const parsed = parseInputValue(text, displayFormat, ctx.adapter);
+        const parsed = parseInputValue(text, ctx.adapter);
         if (parsed) {
           ctx.selectDate(parsed);
           setInputText(null);
@@ -168,7 +186,7 @@ var DatePickerInput = forwardRef(
           ctx.close();
         } else if (e.key === "Enter") {
           if (inputText !== null) {
-            const parsed = parseInputValue(inputText, displayFormat, ctx.adapter);
+            const parsed = parseInputValue(inputText, ctx.adapter);
             if (parsed) {
               ctx.selectDate(parsed);
               setInputText(null);
@@ -202,7 +220,7 @@ var DatePickerInput = forwardRef(
         disabled: ctx.isDisabled || props.disabled,
         readOnly: ctx.isReadOnly,
         onChange: handleChange,
-        onFocus: handleFocus,
+        onClick: handleClick,
         onBlur: handleBlur,
         onKeyDown: handleKeyDown,
         ...props
@@ -231,7 +249,7 @@ var DatePickerTrigger = forwardRef(
         },
         type: "button",
         tabIndex: 0,
-        "aria-label": ctx.isOpen ? "\uCE98\uB9B0\uB354 \uB2EB\uAE30" : "\uCE98\uB9B0\uB354 \uC5F4\uAE30",
+        "aria-label": ctx.isOpen ? ctx.labels.triggerClose : ctx.labels.triggerOpen,
         "aria-expanded": ctx.isOpen,
         "aria-controls": ctx.isOpen ? calendarId : void 0,
         disabled: ctx.isDisabled || props.disabled,
@@ -263,38 +281,39 @@ var DatePickerTrigger = forwardRef(
     );
   }
 );
-function DatePickerPopover({ children, ...props }) {
-  const ctx = useDatePickerContext("DatePicker.Popover");
-  const calendarId = `${ctx.pickerId}-calendar`;
+function usePopover({ isOpen, close, referenceRef, placement = "bottom-start" }) {
   const floatingRef = useRef(null);
+  const previousFocusRef = useRef(null);
   const { refs, floatingStyles } = useFloating({
-    open: ctx.isOpen,
-    placement: "bottom-start",
+    open: isOpen,
+    placement,
     middleware: [offset(4), flip(), shift({ padding: 8 })],
     whileElementsMounted: autoUpdate
   });
   useEffect(() => {
-    if (ctx.referenceRef.current) {
-      refs.setReference(ctx.referenceRef.current);
+    if (referenceRef.current) {
+      refs.setReference(referenceRef.current);
     }
-  }, [ctx.referenceRef, refs, ctx.isOpen]);
-  const previousFocusRef = useRef(null);
+  }, [referenceRef, refs, isOpen]);
   useEffect(() => {
-    if (ctx.isOpen) {
+    if (isOpen) {
       previousFocusRef.current = document.activeElement;
     } else if (previousFocusRef.current) {
-      previousFocusRef.current.focus();
+      const el = previousFocusRef.current;
       previousFocusRef.current = null;
+      if (el !== referenceRef.current && typeof el.focus === "function") {
+        el.focus({ preventScroll: true });
+      }
     }
-  }, [ctx.isOpen]);
+  }, [isOpen, referenceRef]);
   useEffect(() => {
-    if (!ctx.isOpen) return;
+    if (!isOpen) return;
     function handleClickOutside(e) {
       const floating = floatingRef.current;
-      const reference = ctx.referenceRef.current;
+      const reference = referenceRef.current;
       const target = e.target;
       if (floating && !floating.contains(target) && (!reference || !reference.contains(target))) {
-        ctx.close();
+        close();
       }
     }
     const timer = setTimeout(() => {
@@ -304,28 +323,39 @@ function DatePickerPopover({ children, ...props }) {
       clearTimeout(timer);
       document.removeEventListener("mousedown", handleClickOutside);
     };
-  }, [ctx.isOpen, ctx]);
+  }, [isOpen, close, referenceRef]);
   useEffect(() => {
-    if (!ctx.isOpen) return;
+    if (!isOpen) return;
     function handleKeyDown(e) {
       if (e.key === "Escape") {
-        ctx.close();
+        close();
       }
     }
     document.addEventListener("keydown", handleKeyDown);
     return () => document.removeEventListener("keydown", handleKeyDown);
-  }, [ctx.isOpen, ctx]);
+  }, [isOpen, close]);
+  const setFloatingRef = (node) => {
+    floatingRef.current = node;
+    refs.setFloating(node);
+  };
+  return { floatingStyles, setFloatingRef };
+}
+function DatePickerPopover({ children, ...props }) {
+  const ctx = useDatePickerContext("DatePicker.Popover");
+  const calendarId = `${ctx.pickerId}-calendar`;
+  const { floatingStyles, setFloatingRef } = usePopover({
+    isOpen: ctx.isOpen,
+    close: ctx.close,
+    referenceRef: ctx.referenceRef
+  });
   if (!ctx.isOpen) return null;
   return /* @__PURE__ */ jsx(
     "div",
     {
-      ref: (node) => {
-        floatingRef.current = node;
-        refs.setFloating(node);
-      },
+      ref: setFloatingRef,
       id: calendarId,
       role: "dialog",
-      "aria-label": "\uB0A0\uC9DC \uC120\uD0DD",
+      "aria-label": ctx.labels.popoverLabel,
       "aria-modal": "false",
       style: floatingStyles,
       ...props,
@@ -333,6 +363,13 @@ function DatePickerPopover({ children, ...props }) {
     }
   );
 }
+function safeFormatFullDate(iso, locale) {
+  try {
+    return formatFullDate(iso, locale);
+  } catch {
+    return iso;
+  }
+}
 var srOnly = {
   position: "absolute",
   width: "1px",
@@ -364,7 +401,7 @@ function DatePickerCalendar({ classNames, onTitleClick, ...props }) {
     const focusedButton = gridRef.current.querySelector(
       '[data-focused="true"]'
     );
-    focusedButton?.focus();
+    focusedButton?.focus({ preventScroll: true });
   }, [focusedDate, ctx.isOpen]);
   const navigateMonth = useCallback(
     (direction) => {
@@ -381,7 +418,7 @@ function DatePickerCalendar({ classNames, onTitleClick, ...props }) {
     (day) => {
       if (day.isDisabled) return;
       ctx.selectDate(day.isoString);
-      setAnnouncement(formatFullDate(day.isoString, locale));
+      setAnnouncement(safeFormatFullDate(day.isoString, locale));
     },
     [ctx, locale]
   );
@@ -453,7 +490,7 @@ function DatePickerCalendar({ classNames, onTitleClick, ...props }) {
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateMonth(-1),
-          "aria-label": "\uC774\uC804 \uB2EC",
+          "aria-label": ctx.labels.prevMonth,
           children: "<"
         }
       ),
@@ -473,7 +510,7 @@ function DatePickerCalendar({ classNames, onTitleClick, ...props }) {
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateMonth(1),
-          "aria-label": "\uB2E4\uC74C \uB2EC",
+          "aria-label": ctx.labels.nextMonth,
           children: ">"
         }
       )
@@ -526,7 +563,7 @@ function DatePickerCalendar({ classNames, onTitleClick, ...props }) {
                     "data-outside-month": !day.isCurrentMonth || void 0,
                     className: dayClasses,
                     onClick: () => handleDayClick(day),
-                    "aria-label": formatFullDate(day.isoString, locale),
+                    "aria-label": safeFormatFullDate(day.isoString, locale),
                     children: day.dayNumber
                   }
                 )
@@ -582,7 +619,7 @@ function DatePickerMonthGrid({
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateYear(-1),
-          "aria-label": "\uC774\uC804 \uB144",
+          "aria-label": ctx.labels.prevYear,
           children: "<"
         }
       ),
@@ -601,7 +638,7 @@ function DatePickerMonthGrid({
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateYear(1),
-          "aria-label": "\uB2E4\uC74C \uB144",
+          "aria-label": ctx.labels.nextYear,
           children: ">"
         }
       )
@@ -686,7 +723,7 @@ function DatePickerYearGrid({
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateDecade(-1),
-          "aria-label": "\uC774\uC804 12\uB144",
+          "aria-label": ctx.labels.prevDecade,
           children: "<"
         }
       ),
@@ -697,7 +734,7 @@ function DatePickerYearGrid({
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateDecade(1),
-          "aria-label": "\uB2E4\uC74C 12\uB144",
+          "aria-label": ctx.labels.nextDecade,
           children: ">"
         }
       )
@@ -771,6 +808,7 @@ function RangePickerRoot({
   displayFormat = "yyyy-MM-dd",
   locale = "en-US",
   adapter = DateFnsAdapter,
+  labels: labelsProp,
   children
 }) {
   const pickerId = useId();
@@ -789,8 +827,15 @@ function RangePickerRoot({
   const [focusedDate, setFocusedDate] = useState(
     currentValue.start ?? adapter.today()
   );
+  const mergedLabels = useMemo(
+    () => ({ ...DEFAULT_RANGEPICKER_LABELS, ...labelsProp }),
+    [labelsProp]
+  );
   const isDisabled = typeof disabled === "boolean" ? disabled : false;
-  const disabledRules = Array.isArray(disabled) ? disabled : [];
+  const disabledRules = useMemo(
+    () => Array.isArray(disabled) ? disabled : [],
+    [disabled]
+  );
   const setRange = useCallback(
     (range) => {
       if (isDisabled || readOnly) return;
@@ -872,7 +917,8 @@ function RangePickerRoot({
       locale,
       isDisabled,
       isReadOnly: readOnly,
-      pickerId
+      pickerId,
+      labels: mergedLabels
     }),
     [
       currentValue,
@@ -893,23 +939,31 @@ function RangePickerRoot({
       locale,
       isDisabled,
       readOnly,
-      pickerId
+      pickerId,
+      mergedLabels
     ]
   );
   return /* @__PURE__ */ jsx(RangePickerContext.Provider, { value: contextValue, children });
 }
 var RangePickerInput = forwardRef(
-  function RangePickerInput2({ part, format: formatProp, onFocus, onKeyDown, ...props }, ref) {
+  function RangePickerInput2({ part, format: formatProp, onClick, onKeyDown, ...props }, ref) {
     const ctx = useRangePickerContext("RangePicker.Input");
     const displayFormat = formatProp ?? ctx.displayFormat;
     const value = ctx.value[part];
-    const displayValue = value ? ctx.adapter.format(value, displayFormat) : "";
-    const handleFocus = useCallback(
+    let displayValue = "";
+    if (value) {
+      try {
+        displayValue = ctx.adapter.format(value, displayFormat);
+      } catch {
+        displayValue = value;
+      }
+    }
+    const handleClick = useCallback(
       (e) => {
-        ctx.open();
-        onFocus?.(e);
+        if (!ctx.isOpen) ctx.open();
+        onClick?.(e);
       },
-      [ctx, onFocus]
+      [ctx, onClick]
     );
     const handleKeyDown = useCallback(
       (e) => {
@@ -939,11 +993,11 @@ var RangePickerInput = forwardRef(
         "aria-haspopup": "dialog",
         "aria-controls": ctx.isOpen ? calendarId : void 0,
         "aria-autocomplete": "none",
-        "aria-label": part === "start" ? "\uC2DC\uC791\uC77C" : "\uC885\uB8CC\uC77C",
+        "aria-label": part === "start" ? ctx.labels.startInput : ctx.labels.endInput,
         autoComplete: "off",
         value: displayValue,
         disabled: ctx.isDisabled || props.disabled,
-        onFocus: handleFocus,
+        onClick: handleClick,
         onKeyDown: handleKeyDown,
         "data-part": part,
         ...props
@@ -954,66 +1008,19 @@ var RangePickerInput = forwardRef(
 function RangePickerPopover({ children, ...props }) {
   const ctx = useRangePickerContext("RangePicker.Popover");
   const calendarId = `${ctx.pickerId}-calendar`;
-  const floatingRef = useRef(null);
-  const { refs, floatingStyles } = useFloating({
-    open: ctx.isOpen,
-    placement: "bottom-start",
-    middleware: [offset(4), flip(), shift({ padding: 8 })],
-    whileElementsMounted: autoUpdate
+  const { floatingStyles, setFloatingRef } = usePopover({
+    isOpen: ctx.isOpen,
+    close: ctx.close,
+    referenceRef: ctx.referenceRef
   });
-  useEffect(() => {
-    if (ctx.referenceRef.current) {
-      refs.setReference(ctx.referenceRef.current);
-    }
-  }, [ctx.referenceRef, refs, ctx.isOpen]);
-  const previousFocusRef = useRef(null);
-  useEffect(() => {
-    if (ctx.isOpen) {
-      previousFocusRef.current = document.activeElement;
-    } else if (previousFocusRef.current) {
-      previousFocusRef.current.focus();
-      previousFocusRef.current = null;
-    }
-  }, [ctx.isOpen]);
-  useEffect(() => {
-    if (!ctx.isOpen) return;
-    function handleClickOutside(e) {
-      const floating = floatingRef.current;
-      const reference = ctx.referenceRef.current;
-      const target = e.target;
-      if (floating && !floating.contains(target) && (!reference || !reference.contains(target))) {
-        ctx.close();
-      }
-    }
-    const timer = setTimeout(() => {
-      document.addEventListener("mousedown", handleClickOutside);
-    }, 0);
-    return () => {
-      clearTimeout(timer);
-      document.removeEventListener("mousedown", handleClickOutside);
-    };
-  }, [ctx.isOpen, ctx]);
-  useEffect(() => {
-    if (!ctx.isOpen) return;
-    function handleKeyDown(e) {
-      if (e.key === "Escape") {
-        ctx.close();
-      }
-    }
-    document.addEventListener("keydown", handleKeyDown);
-    return () => document.removeEventListener("keydown", handleKeyDown);
-  }, [ctx.isOpen, ctx]);
   if (!ctx.isOpen) return null;
   return /* @__PURE__ */ jsx(
     "div",
     {
-      ref: (node) => {
-        floatingRef.current = node;
-        refs.setFloating(node);
-      },
+      ref: setFloatingRef,
       id: calendarId,
       role: "dialog",
-      "aria-label": "\uB0A0\uC9DC \uBC94\uC704 \uC120\uD0DD",
+      "aria-label": ctx.labels.popoverLabel,
       "aria-modal": "false",
       style: floatingStyles,
       ...props,
@@ -1021,6 +1028,13 @@ function RangePickerPopover({ children, ...props }) {
     }
   );
 }
+function safeFormatFullDate2(iso, locale) {
+  try {
+    return formatFullDate(iso, locale);
+  } catch {
+    return iso;
+  }
+}
 var srOnly2 = {
   position: "absolute",
   width: "1px",
@@ -1063,7 +1077,7 @@ function RangePickerCalendar({ classNames, ...props }) {
     const focusedButton = gridRef.current.querySelector(
       '[data-focused="true"]'
     );
-    focusedButton?.focus();
+    focusedButton?.focus({ preventScroll: true });
   }, [focusedDate, ctx.isOpen]);
   const navigateMonth = useCallback(
     (direction) => {
@@ -1080,7 +1094,7 @@ function RangePickerCalendar({ classNames, ...props }) {
     (day) => {
       if (day.isDisabled) return;
       ctx.selectDate(day.isoString);
-      setAnnouncement(formatFullDate(day.isoString, locale));
+      setAnnouncement(safeFormatFullDate2(day.isoString, locale));
     },
     [ctx, locale]
   );
@@ -1157,7 +1171,7 @@ function RangePickerCalendar({ classNames, ...props }) {
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateMonth(-1),
-          "aria-label": "\uC774\uC804 \uB2EC",
+          "aria-label": ctx.labels.prevMonth,
           children: "<"
         }
       ),
@@ -1168,7 +1182,7 @@ function RangePickerCalendar({ classNames, ...props }) {
           type: "button",
           className: classNames?.navButton,
           onClick: () => navigateMonth(1),
-          "aria-label": "\uB2E4\uC74C \uB2EC",
+          "aria-label": ctx.labels.nextMonth,
           children: ">"
         }
       )
@@ -1228,7 +1242,7 @@ function RangePickerCalendar({ classNames, ...props }) {
                     className: dayClasses,
                     onClick: () => handleDayClick(day),
                     onMouseEnter: () => handleDayMouseEnter(day),
-                    "aria-label": formatFullDate(day.isoString, locale),
+                    "aria-label": safeFormatFullDate2(day.isoString, locale),
                     children: day.dayNumber
                   }
                 )
@@ -1243,7 +1257,8 @@ function RangePickerCalendar({ classNames, ...props }) {
   ] });
 }
 function RangePickerPresets({ classNames, children, ...props }) {
-  return /* @__PURE__ */ jsx("div", { role: "group", "aria-label": "\uB0A0\uC9DC \uBC94\uC704 \uD504\uB9AC\uC14B", className: classNames?.root, ...props, children });
+  const ctx = useRangePickerContext("RangePicker.Presets");
+  return /* @__PURE__ */ jsx("div", { role: "group", "aria-label": ctx.labels.presetsGroup, className: classNames?.root, ...props, children });
 }
 function resolvePreset(key, today, adapter) {
   switch (key) {
@@ -1282,8 +1297,9 @@ function resolvePreset(key, today, adapter) {
       };
     }
     case "thisYear": {
+      const currentMonth = new Date(today).getUTCMonth();
       const yearStart = adapter.startOfMonth(
-        adapter.addMonths(today, -new Date(today).getUTCMonth())
+        adapter.addMonths(today, -currentMonth)
       );
       return { start: yearStart, end: today };
     }
@@ -1365,10 +1381,7 @@ function useTimePickerContext(componentName) {
   return context;
 }
 function getDefaultIso() {
-  const now = /* @__PURE__ */ new Date();
-  return new Date(
-    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())
-  ).toISOString();
+  return DateFnsAdapter.today();
 }
 function TimePickerRoot({
   value: controlledValue,
@@ -1379,9 +1392,14 @@ function TimePickerRoot({
   withSeconds = false,
   disabled = false,
   readOnly = false,
+  labels: labelsProp,
   children
 }) {
   const pickerId = useId();
+  const mergedLabels = useMemo(
+    () => ({ ...DEFAULT_TIMEPICKER_LABELS, ...labelsProp }),
+    [labelsProp]
+  );
   const isControlled = useRef(controlledValue !== void 0).current;
   const [uncontrolledValue, setUncontrolledValue] = useState(
     defaultValue ?? null
@@ -1410,9 +1428,10 @@ function TimePickerRoot({
       isDisabled: disabled,
       isReadOnly: readOnly,
       currentTime,
-      pickerId
+      pickerId,
+      labels: mergedLabels
     }),
-    [currentValue, setTime$1, format, step, withSeconds, disabled, readOnly, currentTime, pickerId]
+    [currentValue, setTime$1, format, step, withSeconds, disabled, readOnly, currentTime, pickerId, mergedLabels]
   );
   return /* @__PURE__ */ jsx(TimePickerContext.Provider, { value: contextValue, children });
 }
@@ -1458,7 +1477,7 @@ var TimePickerInput = forwardRef(
         type: "text",
         inputMode: "numeric",
         autoComplete: "off",
-        "aria-label": "\uC2DC\uAC04 \uC785\uB825",
+        "aria-label": ctx.labels.timeInput,
         placeholder: ctx.withSeconds ? "HH:MM:SS" : "HH:MM",
         value: displayValue,
         disabled: ctx.isDisabled || props.disabled,
@@ -1471,46 +1490,42 @@ var TimePickerInput = forwardRef(
     );
   }
 );
-function TimePickerHourList({ classNames, ...props }) {
-  const ctx = useTimePickerContext("TimePicker.HourList");
-  const { format, currentTime, isDisabled, isReadOnly } = ctx;
+function useListboxNavigation({
+  items,
+  onSelect,
+  disabled = false
+}) {
   const listRef = useRef(null);
-  const hours = generateHours(format);
-  const selectedHourDisplay = format === "12h" ? to12Hour(currentTime.hours).hours12 : currentTime.hours;
-  const currentPeriod = format === "12h" ? to12Hour(currentTime.hours).period : null;
-  const handleSelect = useCallback(
-    (hourDisplay) => {
-      if (isDisabled || isReadOnly) return;
-      const hours24 = format === "12h" && currentPeriod ? to24Hour(hourDisplay, currentPeriod) : hourDisplay;
-      ctx.setTime({ hours: hours24 });
-    },
-    [format, currentPeriod, ctx, isDisabled, isReadOnly]
-  );
+  const rafIdRef = useRef(0);
+  useEffect(() => {
+    return () => cancelAnimationFrame(rafIdRef.current);
+  }, []);
   const handleKeyDown = useCallback(
-    (e, hour) => {
-      if (isDisabled || isReadOnly) return;
-      const currentIndex = hours.indexOf(hour);
+    (e, item) => {
+      if (disabled) return;
+      const currentIndex = items.indexOf(item);
       let newIndex = -1;
       if (e.key === "ArrowDown") {
-        newIndex = Math.min(currentIndex + 1, hours.length - 1);
+        newIndex = Math.min(currentIndex + 1, items.length - 1);
       } else if (e.key === "ArrowUp") {
         newIndex = Math.max(currentIndex - 1, 0);
       } else if (e.key === "Home") {
         newIndex = 0;
       } else if (e.key === "End") {
-        newIndex = hours.length - 1;
+        newIndex = items.length - 1;
       } else if (e.key === "Enter" || e.key === " ") {
         e.preventDefault();
-        handleSelect(hour);
+        onSelect(item);
         return;
       } else {
         return;
       }
       e.preventDefault();
-      const targetHour = hours[newIndex];
-      if (targetHour !== void 0) {
-        handleSelect(targetHour);
-        requestAnimationFrame(() => {
+      const target = items[newIndex];
+      if (target !== void 0) {
+        onSelect(target);
+        cancelAnimationFrame(rafIdRef.current);
+        rafIdRef.current = requestAnimationFrame(() => {
           const next = listRef.current?.querySelector(
             '[data-selected="true"]'
           );
@@ -1518,14 +1533,35 @@ function TimePickerHourList({ classNames, ...props }) {
         });
       }
     },
-    [hours, handleSelect, isDisabled, isReadOnly]
+    [items, onSelect, disabled]
   );
+  return { listRef, handleKeyDown };
+}
+function TimePickerHourList({ classNames, ...props }) {
+  const ctx = useTimePickerContext("TimePicker.HourList");
+  const { format, currentTime, isDisabled, isReadOnly } = ctx;
+  const hours = generateHours(format);
+  const selectedHourDisplay = format === "12h" ? to12Hour(currentTime.hours).hours12 : currentTime.hours;
+  const currentPeriod = format === "12h" ? to12Hour(currentTime.hours).period : null;
+  const handleSelect = useCallback(
+    (hourDisplay) => {
+      if (isDisabled || isReadOnly) return;
+      const hours24 = format === "12h" && currentPeriod ? to24Hour(hourDisplay, currentPeriod) : hourDisplay;
+      ctx.setTime({ hours: hours24 });
+    },
+    [format, currentPeriod, ctx, isDisabled, isReadOnly]
+  );
+  const { listRef, handleKeyDown } = useListboxNavigation({
+    items: hours,
+    onSelect: handleSelect,
+    disabled: isDisabled || isReadOnly
+  });
   return /* @__PURE__ */ jsx(
     "ul",
     {
       ref: listRef,
       role: "listbox",
-      "aria-label": "\uC2DC",
+      "aria-label": ctx.labels.hourList,
       "aria-disabled": isDisabled || void 0,
       className: classNames?.root,
       ...props,
@@ -1538,7 +1574,7 @@ function TimePickerHourList({ classNames, ...props }) {
             role: "option",
             "aria-selected": isSelected,
             "aria-disabled": isDisabled || void 0,
-            "aria-label": `${hour}\uC2DC`,
+            "aria-label": ctx.labels.hourOption(hour),
             "data-selected": isSelected || void 0,
             tabIndex: isSelected ? 0 : -1,
             className: optionClass,
@@ -1555,7 +1591,6 @@ function TimePickerHourList({ classNames, ...props }) {
 function TimePickerMinuteList({ classNames, ...props }) {
   const ctx = useTimePickerContext("TimePicker.MinuteList");
   const { step, currentTime, isDisabled, isReadOnly } = ctx;
-  const listRef = useRef(null);
   const minutes = generateMinutes(step);
   const handleSelect = useCallback(
     (minute) => {
@@ -1564,46 +1599,17 @@ function TimePickerMinuteList({ classNames, ...props }) {
     },
     [ctx, isDisabled, isReadOnly]
   );
-  const handleKeyDown = useCallback(
-    (e, minute) => {
-      if (isDisabled || isReadOnly) return;
-      const currentIndex = minutes.indexOf(minute);
-      let newIndex = -1;
-      if (e.key === "ArrowDown") {
-        newIndex = Math.min(currentIndex + 1, minutes.length - 1);
-      } else if (e.key === "ArrowUp") {
-        newIndex = Math.max(currentIndex - 1, 0);
-      } else if (e.key === "Home") {
-        newIndex = 0;
-      } else if (e.key === "End") {
-        newIndex = minutes.length - 1;
-      } else if (e.key === "Enter" || e.key === " ") {
-        e.preventDefault();
-        handleSelect(minute);
-        return;
-      } else {
-        return;
-      }
-      e.preventDefault();
-      const target = minutes[newIndex];
-      if (target !== void 0) {
-        handleSelect(target);
-        requestAnimationFrame(() => {
-          const next = listRef.current?.querySelector(
-            '[data-selected="true"]'
-          );
-          next?.focus();
-        });
-      }
-    },
-    [minutes, handleSelect, isDisabled, isReadOnly]
-  );
+  const { listRef, handleKeyDown } = useListboxNavigation({
+    items: minutes,
+    onSelect: handleSelect,
+    disabled: isDisabled || isReadOnly
+  });
   return /* @__PURE__ */ jsx(
     "ul",
     {
       ref: listRef,
       role: "listbox",
-      "aria-label": "\uBD84",
+      "aria-label": ctx.labels.minuteList,
       "aria-disabled": isDisabled || void 0,
       className: classNames?.root,
       ...props,
@@ -1616,7 +1622,7 @@ function TimePickerMinuteList({ classNames, ...props }) {
             role: "option",
             "aria-selected": isSelected,
             "aria-disabled": isDisabled || void 0,
-            "aria-label": `${minute}\uBD84`,
+            "aria-label": ctx.labels.minuteOption(minute),
             "data-selected": isSelected || void 0,
             tabIndex: isSelected ? 0 : -1,
             className: optionClass,
@@ -1659,7 +1665,7 @@ function TimePickerAmPmToggle({ classNames, ...props }) {
       }
     );
   };
-  return /* @__PURE__ */ jsxs("div", { role: "radiogroup", "aria-label": "\uC624\uC804/\uC624\uD6C4", className: classNames?.root, ...props, children: [
+  return /* @__PURE__ */ jsxs("div", { role: "radiogroup", "aria-label": ctx.labels.amPmToggle, className: classNames?.root, ...props, children: [
     renderButton("AM"),
     renderButton("PM")
   ] });
@@ -1673,10 +1679,7 @@ var TimePicker = Object.assign(TimePickerRoot, {
   AmPmToggle: TimePickerAmPmToggle
 });
 function getDefaultIso2() {
-  const now = /* @__PURE__ */ new Date();
-  return new Date(
-    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())
-  ).toISOString();
+  return DateFnsAdapter.today();
 }
 function DateTimePickerRoot({
   value: controlledValue,
@@ -1690,9 +1693,18 @@ function DateTimePickerRoot({
   displayFormat = "yyyy-MM-dd HH:mm",
   locale = "en-US",
   adapter = DateFnsAdapter,
+  labels: labelsProp,
   children
 }) {
   const pickerId = useId();
+  const mergedDateLabels = useMemo(
+    () => ({ ...DEFAULT_DATEPICKER_LABELS, ...labelsProp }),
+    [labelsProp]
+  );
+  const mergedTimeLabels = useMemo(
+    () => ({ ...DEFAULT_TIMEPICKER_LABELS, ...labelsProp }),
+    [labelsProp]
+  );
   const isControlled = useRef(controlledValue !== void 0).current;
   const referenceRef = useRef(null);
   const [uncontrolledValue, setUncontrolledValue] = useState(
@@ -1707,7 +1719,10 @@ function DateTimePickerRoot({
     currentValue ?? adapter.today()
   );
   const isDisabled = typeof disabled === "boolean" ? disabled : false;
-  const disabledRules = Array.isArray(disabled) ? disabled : [];
+  const disabledRules = useMemo(
+    () => Array.isArray(disabled) ? disabled : [],
+    [disabled]
+  );
   const baseIso = currentValue ?? getDefaultIso2();
   const currentTime = useMemo(() => getTime(baseIso), [baseIso]);
   const updateValue = useCallback(
@@ -1774,7 +1789,8 @@ function DateTimePickerRoot({
       locale,
       isDisabled,
       isReadOnly: readOnly,
-      pickerId
+      pickerId,
+      labels: mergedDateLabels
     }),
     [
       currentValue,
@@ -1792,7 +1808,8 @@ function DateTimePickerRoot({
       locale,
       isDisabled,
       readOnly,
-      pickerId
+      pickerId,
+      mergedDateLabels
     ]
   );
   const timeContext = useMemo(
@@ -1805,22 +1822,30 @@ function DateTimePickerRoot({
       isDisabled,
       isReadOnly: readOnly,
       currentTime,
-      pickerId
+      pickerId,
+      labels: mergedTimeLabels
     }),
-    [currentValue, setTime$1, format, step, isDisabled, readOnly, currentTime, pickerId]
+    [currentValue, setTime$1, format, step, isDisabled, readOnly, currentTime, pickerId, mergedTimeLabels]
   );
   return /* @__PURE__ */ jsx(DatePickerContext.Provider, { value: dateContext, children: /* @__PURE__ */ jsx(TimePickerContext.Provider, { value: timeContext, children }) });
 }
 var DateTimePickerInput = forwardRef(
-  function DateTimePickerInput2({ onFocus, onKeyDown, ...props }, ref) {
+  function DateTimePickerInput2({ onClick, onKeyDown, ...props }, ref) {
     const ctx = useDatePickerContext("DateTimePicker.Input");
-    const displayValue = ctx.value ? `${ctx.adapter.format(ctx.value, "yyyy-MM-dd")} ${formatTimeString(getTime(ctx.value))}` : "";
-    const handleFocus = useCallback(
+    let displayValue = "";
+    if (ctx.value) {
+      try {
+        displayValue = `${ctx.adapter.format(ctx.value, "yyyy-MM-dd")} ${formatTimeString(getTime(ctx.value))}`;
+      } catch {
+        displayValue = ctx.value;
+      }
+    }
+    const handleClick = useCallback(
       (e) => {
-        ctx.open();
-        onFocus?.(e);
+        if (!ctx.isOpen) ctx.open();
+        onClick?.(e);
       },
-      [ctx, onFocus]
+      [ctx, onClick]
     );
     const handleKeyDown = useCallback(
       (e) => {
@@ -1846,7 +1871,7 @@ var DateTimePickerInput = forwardRef(
         type: "text",
         role: "combobox",
         readOnly: true,
-        "aria-label": "\uB0A0\uC9DC \uBC0F \uC2DC\uAC04",
+        "aria-label": ctx.labels.dateTimeInput ?? "Date and time",
         "aria-expanded": ctx.isOpen,
         "aria-haspopup": "dialog",
         "aria-controls": ctx.isOpen ? calendarId : void 0,
@@ -1854,7 +1879,7 @@ var DateTimePickerInput = forwardRef(
         autoComplete: "off",
         value: displayValue,
         disabled: ctx.isDisabled || props.disabled,
-        onFocus: handleFocus,
+        onClick: handleClick,
         onKeyDown: handleKeyDown,
         ...props
       }
@@ -2061,10 +2086,7 @@ function useRangePicker(options = {}) {
   };
 }
 function getDefaultIso3() {
-  const now = /* @__PURE__ */ new Date();
-  return new Date(
-    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())
-  ).toISOString();
+  return DateFnsAdapter.today();
 }
 function useTimePicker(options = {}) {
   const {