@likelion-design/ui 1.0.26 → 1.0.27

package/dist/index.d.mts

@@ -1068,8 +1068,12 @@ interface DatePickerSingleProps {
     type?: "single";
     /** 선택된 날짜 */
     value?: Date | null;
-    /** 날짜 변경 핸들러 */
-    onChange?: (date: Date) => void;
+    /**
+     * 날짜 변경 핸들러 (적용/초기화 시 호출).
+     * 초기화 시 `null`이 전달됩니다.
+     * method syntax로 선언되어 `(d: Date) => ...` 형태의 기존 콜백과도 호환됩니다.
+     */
+    onChange?(date: Date | null): void;
     startDate?: never;
     endDate?: never;
     onRangeChange?: never;
@@ -1082,8 +1086,12 @@ interface DatePickerRangeProps {
     startDate?: Date | null;
     /** 종료 날짜 */
     endDate?: Date | null;
-    /** 기간 변경 핸들러 */
-    onRangeChange?: (start: Date, end: Date | null) => void;
+    /**
+     * 기간 변경 핸들러 (적용/초기화 시 호출).
+     * 초기화 시 `(null, null)`이 전달됩니다.
+     * method syntax로 선언되어 `(s: Date, e: Date | null) => ...` 형태의 기존 콜백과도 호환됩니다.
+     */
+    onRangeChange?(start: Date | null, end: Date | null): void;
 }
 /** DatePicker가 내부적으로 관리하는 Calendar props (사용자가 오버라이드 불가) */
 type ManagedCalendarProps = "year" | "month" | "selectedDate" | "startDate" | "endDate" | "hoverDate" | "rangeMode" | "minDate" | "maxDate" | "onClick" | "onHover" | "onPrev" | "onNext" | "showPrev" | "showNext" | "disablePrev" | "disableNext" | "locale" | "className" | "style" | "children";
@@ -1118,6 +1126,13 @@ type DatePickerBaseProps = {
     disableNext?: boolean;
     /** 초기화 버튼 표시 여부 (기본: true, 날짜가 선택되어 있을 때 표시) */
     reset?: boolean;
+    /**
+     * 캘린더를 열었을 때 기본으로 표시할 월.
+     * 지정하지 않으면 선택된 날짜 → 오늘 순으로 결정됩니다.
+     * @example defaultMonth={new Date(2026, 5)} // 2026년 6월
+     * @example defaultMonth="2026-06"
+     */
+    defaultMonth?: Date | string;
     /** 시간 선택 패널 표시 여부 (기본: false, single 모드에서만 동작) */
     showTimeSelect?: boolean;
     /** 시간 간격 (분 단위, 기본: 30). showTimeSelect 활성화 시 사용 */
@@ -1130,8 +1145,15 @@ type DatePickerBaseProps = {
      * @example "yyyy-MM-dd" → "2026-03-11"
      */
     dateFormat?: string;
-    /** 적용 버튼 클릭 시 호출되는 콜백 */
-    onApply?: () => void;
+    /** 초기화 버튼 클릭 시 호출되는 콜백 (내부 초기화 동작 이후에 호출) */
+    onReset?: () => void;
+    /**
+     * 적용 버튼 클릭 시 호출되는 콜백.
+     * 값이 없을 땐 적용 버튼이 비활성화되어 호출되지 않습니다.
+     * single 모드: (date: Date) => void
+     * range 모드: (startDate: Date, endDate: Date) => void
+     */
+    onApply?: (date: Date, endDate?: Date) => void;
     /** 취소 버튼 클릭 시 호출되는 콜백 */
     onCancel?: () => void;
     /**

package/dist/index.d.ts

@@ -1068,8 +1068,12 @@ interface DatePickerSingleProps {
     type?: "single";
     /** 선택된 날짜 */
     value?: Date | null;
-    /** 날짜 변경 핸들러 */
-    onChange?: (date: Date) => void;
+    /**
+     * 날짜 변경 핸들러 (적용/초기화 시 호출).
+     * 초기화 시 `null`이 전달됩니다.
+     * method syntax로 선언되어 `(d: Date) => ...` 형태의 기존 콜백과도 호환됩니다.
+     */
+    onChange?(date: Date | null): void;
     startDate?: never;
     endDate?: never;
     onRangeChange?: never;
@@ -1082,8 +1086,12 @@ interface DatePickerRangeProps {
     startDate?: Date | null;
     /** 종료 날짜 */
     endDate?: Date | null;
-    /** 기간 변경 핸들러 */
-    onRangeChange?: (start: Date, end: Date | null) => void;
+    /**
+     * 기간 변경 핸들러 (적용/초기화 시 호출).
+     * 초기화 시 `(null, null)`이 전달됩니다.
+     * method syntax로 선언되어 `(s: Date, e: Date | null) => ...` 형태의 기존 콜백과도 호환됩니다.
+     */
+    onRangeChange?(start: Date | null, end: Date | null): void;
 }
 /** DatePicker가 내부적으로 관리하는 Calendar props (사용자가 오버라이드 불가) */
 type ManagedCalendarProps = "year" | "month" | "selectedDate" | "startDate" | "endDate" | "hoverDate" | "rangeMode" | "minDate" | "maxDate" | "onClick" | "onHover" | "onPrev" | "onNext" | "showPrev" | "showNext" | "disablePrev" | "disableNext" | "locale" | "className" | "style" | "children";
@@ -1118,6 +1126,13 @@ type DatePickerBaseProps = {
     disableNext?: boolean;
     /** 초기화 버튼 표시 여부 (기본: true, 날짜가 선택되어 있을 때 표시) */
     reset?: boolean;
+    /**
+     * 캘린더를 열었을 때 기본으로 표시할 월.
+     * 지정하지 않으면 선택된 날짜 → 오늘 순으로 결정됩니다.
+     * @example defaultMonth={new Date(2026, 5)} // 2026년 6월
+     * @example defaultMonth="2026-06"
+     */
+    defaultMonth?: Date | string;
     /** 시간 선택 패널 표시 여부 (기본: false, single 모드에서만 동작) */
     showTimeSelect?: boolean;
     /** 시간 간격 (분 단위, 기본: 30). showTimeSelect 활성화 시 사용 */
@@ -1130,8 +1145,15 @@ type DatePickerBaseProps = {
      * @example "yyyy-MM-dd" → "2026-03-11"
      */
     dateFormat?: string;
-    /** 적용 버튼 클릭 시 호출되는 콜백 */
-    onApply?: () => void;
+    /** 초기화 버튼 클릭 시 호출되는 콜백 (내부 초기화 동작 이후에 호출) */
+    onReset?: () => void;
+    /**
+     * 적용 버튼 클릭 시 호출되는 콜백.
+     * 값이 없을 땐 적용 버튼이 비활성화되어 호출되지 않습니다.
+     * single 모드: (date: Date) => void
+     * range 모드: (startDate: Date, endDate: Date) => void
+     */
+    onApply?: (date: Date, endDate?: Date) => void;
     /** 취소 버튼 클릭 시 호출되는 콜백 */
     onCancel?: () => void;
     /**