@uniai-fe/uds-primitives 0.2.2 → 0.2.4

package/src/components/input/types/calendar.ts

@@ -1,208 +0,0 @@
-import type {
-  DatePickerProps as MantineDatePickerProps,
-  DatePickerType,
-  DatePickerValue,
-} from "@mantine/dates";
-import type { ComponentPropsWithoutRef, ReactNode } from "react";
-import type { UseFormRegisterReturn } from "react-hook-form";
-
-/**
- * Calendar 모드; 날짜/시간 조합을 구분한다.
- */
-export type InputCalendarMode = "date" | "date-time" | "time";
-
-/**
- * Calendar가 한 번에 렌더링할 열 개수.
- * 단일/듀얼 달력을 명시적으로 구분한다.
- */
-export type InputCalendarColumns = 1 | 2;
-
-/**
- * Mantine DatePicker 값 타입을 문자열 기반으로 재정의한다.
- */
-export type InputCalendarValue<Type extends DatePickerType = "default"> =
-  DatePickerValue<Type, string>;
-
-/**
- * Calendar 값 변경 핸들러 시그니처.
- * @template Type Mantine DatePickerType string literal
- * @property {InputCalendarValue<Type>} value 현재 선택된 값
- */
-export type InputCalendarOnChange<Type extends DatePickerType = "default"> = (
-  value: InputCalendarValue<Type>,
-) => void;
-
-/**
- * footer 버튼 기본 속성.
- * 공통 disabled/label 정책을 공유한다.
- * @property {ReactNode} [label] 버튼 라벨
- * @property {boolean} [disabled] 버튼 disabled 상태
- * @property {boolean} [visible] 버튼 노출 여부. false면 숨김
- */
-export interface InputCalendarActionButtonProps {
-  /**
-   * 버튼 라벨
-   */
-  label?: ReactNode;
-  /**
-   * 버튼 disabled 상태
-   */
-  disabled?: boolean;
-  /**
-   * 버튼 노출 여부. false면 숨김
-   */
-  visible?: boolean;
-}
-
-/**
- * footer 액션 핸들러 묶음.
- * @property {() => void} [onClear] 삭제 버튼 클릭 시 호출
- * @property {() => void} [onToday] 오늘 버튼 클릭 시 호출
- * @property {(value: InputCalendarValue) => void} [onApply] 적용 버튼 클릭 시 호출
- */
-export interface InputCalendarActionHandlers<
-  Type extends DatePickerType = "default",
-> {
-  /**
-   * 삭제/초기화 버튼 핸들러
-   */
-  onClear?: () => void;
-  /**
-   * 오늘 버튼 핸들러
-   */
-  onToday?: () => void;
-  /**
-   * 적용 버튼 핸들러 (현재 값 전달)
-   */
-  onApply?: InputCalendarOnChange<Type>;
-}
-
-/**
- * footer 액션 구성을 선언한다.
- * @property {InputCalendarActionButtonProps} [clear] 삭제 버튼 옵션
- * @property {InputCalendarActionButtonProps} [today] 오늘 버튼 옵션
- * @property {InputCalendarActionButtonProps} [apply] 적용 버튼 옵션
- */
-export interface InputCalendarActionOptions {
-  /**
-   * 삭제/초기화 버튼 옵션
-   */
-  clear?: InputCalendarActionButtonProps;
-  /**
-   * 오늘 버튼 옵션
-   */
-  today?: InputCalendarActionButtonProps;
-  /**
-   * 적용 버튼 옵션
-   */
-  apply?: InputCalendarActionButtonProps;
-}
-
-/**
- * Mantine DatePicker props 중 Input 레이어에서 그대로 노출하지 않을 항목을 제외한 타입.
- */
-export type InputCalendarMantineProps<Type extends DatePickerType = "default"> =
-  Partial<
-    Omit<
-      MantineDatePickerProps<Type>,
-      "value" | "defaultValue" | "onChange" | "type" | "classNames" | "styles"
-    >
-  >;
-
-/**
- * Calendar trigger(Input) 영역에서 필요한 속성 묶음.
- * FormField와의 조합을 고려해 label/helper 등을 상위 Template에 위임한다.
- * @property {string} [id] trigger id (label htmlFor 연동)
- * @property {string} [name] form name; register 미사용 시 수동 지정
- * @property {UseFormRegisterReturn} [register] react-hook-form register 결과
- * @property {ReactNode} [placeholder] trigger 내부 placeholder
- * @property {string} [triggerClassName] trigger className (예: InputFoundation box)
- */
-export interface InputCalendarTriggerProps extends Pick<
-  ComponentPropsWithoutRef<"button">,
-  "onClick" | "disabled"
-> {
-  /**
-   * trigger id (label htmlFor 연동)
-   */
-  id?: string;
-  /**
-   * form name; register 미사용 시 수동 지정
-   */
-  name?: string;
-  /**
-   * react-hook-form register 결과
-   */
-  register?: UseFormRegisterReturn;
-  /**
-   * trigger 내부 placeholder
-   */
-  placeholder?: ReactNode;
-  /**
-   * trigger className (예: InputFoundation box)
-   */
-  triggerClassName?: string;
-}
-
-/**
- * Input Calendar core props.
- * @property {InputCalendarMode} [mode="date"] 날짜/시간 모드
- * @property {DatePickerType} [type="default"] Mantine range/multiple 모드
- * @property {InputCalendarColumns} [columns=1] 동시에 노출할 달력 열 수
- * @property {InputCalendarValue} [value] 제어형 값
- * @property {InputCalendarValue} [defaultValue] 비제어 초기값
- * @property {InputCalendarOnChange} [onChange] 값 변경 핸들러(직렬화 문자열 기준)
- * @property {InputCalendarOnChange} [onValueChange] onChange 별칭(추가 파이프라인용)
- * @property {boolean} [readOnly] 읽기 전용 여부
- * @property {boolean} [disabled] disabled 여부
- * @property {InputCalendarMantineProps} [datePickerProps] Mantine DatePicker 직접 옵션
- * @property {InputCalendarActionOptions} [actions] footer 액션 옵션
- * @property {InputCalendarActionHandlers} [actionHandlers] footer 버튼 핸들러
- */
-export interface InputCalendarProps<Type extends DatePickerType = "default">
-  extends InputCalendarActionHandlers<Type>, InputCalendarTriggerProps {
-  /**
-   * 날짜/시간 모드
-   */
-  mode?: InputCalendarMode;
-  /**
-   * Mantine DatePicker type
-   */
-  type?: Type;
-  /**
-   * 동시에 노출할 달력 열 수
-   */
-  columns?: InputCalendarColumns;
-  /**
-   * 제어형 값
-   */
-  value?: InputCalendarValue<Type>;
-  /**
-   * 비제어 초기값
-   */
-  defaultValue?: InputCalendarValue<Type>;
-  /**
-   * 값 변경 핸들러
-   */
-  onChange?: InputCalendarOnChange<Type>;
-  /**
-   * onChange 별칭; 외부 파이프라인 시 사용
-   */
-  onValueChange?: InputCalendarOnChange<Type>;
-  /**
-   * 읽기 전용 여부
-   */
-  readOnly?: boolean;
-  /**
-   * disabled 여부
-   */
-  disabled?: boolean;
-  /**
-   * Mantine DatePicker 옵션
-   */
-  datePickerProps?: InputCalendarMantineProps<Type>;
-  /**
-   * footer 버튼 옵션
-   */
-  actions?: InputCalendarActionOptions;
-}