@ehfuse/mui-form-controls 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# @ehfuse/mui-form-controls
+
+MUI 기반 폼 컨트롤과 텍스트 필드 컴포넌트 모음
+
+## 컴포넌트
+
+| 컴포넌트                      | 설명                                                             | 문서                                              |
+| ----------------------------- | ---------------------------------------------------------------- | ------------------------------------------------- |
+| **SearchTextField**           | 클리어 버튼, 로딩 상태, 디바운스 기능이 있는 검색 필드           | [API](./docs/ko/api.md#searchtextfield)           |
+| **PasswordTextField**         | 비밀번호 보기/숨기기 토글, 유효성 검사 기능이 있는 비밀번호 필드 | [API](./docs/ko/api.md#passwordtextfield)         |
+| **PhoneTextField**            | 자동 포맷팅, prefix 고정 기능이 있는 전화번호 필드               | [API](./docs/ko/api.md#phonetextfield)            |
+| **EmailTextField**            | 도메인 자동완성, 유효성 검사 기능이 있는 이메일 필드             | [API](./docs/ko/api.md#emailtextfield)            |
+| **NumberTextField**           | 천 단위 구분자, 소수점, 음수 지원하는 숫자 필드                  | [API](./docs/ko/api.md#numbertextfield)           |
+| **AddressTextField**          | 다음 우편번호 API 연동 주소 검색 필드                            | [API](./docs/ko/api.md#addresstextfield)          |
+| **JuminTextField**            | 주민등록번호 입력 필드 (마스킹, 정보 추출)                       | [API](./docs/ko/api.md#jumintextfield)            |
+| **BizNumTextField**           | 사업자등록번호 입력 필드 (검증, 복사 기능)                       | [API](./docs/ko/api.md#biznumtextfield)           |
+| **CardNumTextField**          | 카드번호 입력 필드 (마스킹, 브랜드 감지, 로고 아이콘)            | [API](./docs/ko/api.md#cardnumtextfield)          |
+| **VerificationCodeTextField** | 인증번호 입력 필드 (숫자/영문/혼합)                              | [API](./docs/ko/api.md#verificationcodetextfield) |
+| **DateTextField**             | 달력 팝업, 다양한 날짜 포맷, 공휴일 표시 지원 날짜 필드          | [API](./docs/ko/api.md#datetextfield)             |
+| **TimeTextField**             | 시간 입력 필드 (자동 포맷팅, 시간 범위 제한)                     | [API](./docs/ko/api.md#timetextfield)             |
+
+## 훅 (Hooks)
+
+| 훅                         | 설명                                                | 문서                                           |
+| -------------------------- | --------------------------------------------------- | ---------------------------------------------- |
+| **useKoreanHolidays**      | 단일 연도의 한국 공휴일을 조회하는 커스텀 훅        | [API](./docs/ko/api.md#usekoreanholidays)      |
+| **useKoreanHolidaysRange** | 여러 연도의 한국 공휴일을 한번에 조회하는 커스텀 훅 | [API](./docs/ko/api.md#usekoreanholidaysrange) |
+
+## 설치
+
+```bash
+npm install @ehfuse/mui-form-controls
+```
+
+## 필수 의존성
+
+```json
+{
+    "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@mui/material": "^5.0.0 || ^6.0.0 || ^7.0.0",
+    "@mui/icons-material": "^5.0.0 || ^6.0.0 || ^7.0.0",
+    "@emotion/react": "^11.0.0",
+    "@emotion/styled": "^11.0.0",
+    "@ehfuse/overlay-scrollbar": "^1.0.0"
+}
+```
+
+## 빠른 시작
+
+```tsx
+import {
+  SearchTextField,
+  PasswordTextField,
+  PhoneTextField,
+  EmailTextField,
+  NumberTextField,
+  AddressTextField,
+  JuminTextField,
+  BizNumTextField,
+  CardNumTextField,
+  VerificationCodeTextField,
+  DateTextField,
+  TimeTextField,
+  useKoreanHolidays,
+  useKoreanHolidaysRange,
+} from '@ehfuse/mui-form-controls';
+
+// 검색 필드
+<SearchTextField
+  value={search}
+  onChange={(e) => setSearch(e.target.value)}
+  searchIcon
+  loading={isSearching}
+/>
+
+// 비밀번호 필드
+<PasswordTextField
+  value={password}
+  onChange={(e) => setPassword(e.target.value)}
+  showToggle
+/>
+
+// 전화번호 필드
+<PhoneTextField
+  value={phone}
+  onChange={(e) => setPhone(e.target.value)}
+  prefix="010"
+/>
+
+// 이메일 필드 (forma 호환)
+<EmailTextField
+  name="email"
+  value={email}
+  onChange={handleFormChange}
+  extraDomains={["mycompany.com"]}
+/>
+
+// 숫자 필드
+<NumberTextField
+  value={amount}
+  onChange={(e) => setAmount(e.target.value)}
+  prefix="₩"
+  suffix="원"
+/>
+
+// 날짜 필드
+<DateTextField
+  value={date}
+  onChange={(e) => setDate(e.target.value)}
+  format="YYYY.MM.DD"
+  selectedColor="secondary.main"
+/>
+
+// 주소 필드
+<AddressTextField
+  value={address}
+  onChange={setAddress}
+/>
+
+// 주민등록번호 필드
+<JuminTextField
+  value={jumin}
+  onChange={setJumin}
+  mask
+/>
+
+// 사업자등록번호 필드
+<BizNumTextField
+  value={bizNum}
+  onChange={setBizNum}
+  validate
+  copyIcon
+/>
+
+// 카드번호 필드
+<CardNumTextField
+  value={cardNum}
+  onChange={(e) => setCardNum(e.target.value)}
+  onCardBrandChange={(brand) => console.log('카드 브랜드:', brand)}
+/>
+
+// 인증번호 필드
+<VerificationCodeTextField
+  value={code}
+  onChange={setCode}
+  length={6}
+  type="numeric"
+  onComplete={(code) => console.log('완료:', code)}
+/>
+
+// 시간 필드
+<TimeTextField
+  value={time}
+  onChange={(e) => setTime(e.target.value)}
+  format="HH:mm"
+  minTime="09:00"
+  maxTime="18:00"
+/>
+```
+
+## 문서 / Documentation
+
+- [한국어 문서](./docs/ko/getting-started.md)
+- [English Documentation](./docs/en/getting-started.md)
+
+## 라이선스 / License
+
+MIT © 김영진 (Kim Young Jin)

package/dist/AddressTextField.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AddressTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { AddressTextFieldProps } from "./types";
+export declare const AddressTextField: import("react").ForwardRefExoticComponent<Omit<AddressTextFieldProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/Autocomplete.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Autocomplete.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { AutocompleteProps } from "./types";
+export declare const Autocomplete: React.ForwardRefExoticComponent<Omit<AutocompleteProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/BizNumTextField.d.ts

@@ -0,0 +1,10 @@
+/**
+ * BizNumTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { BizNumTextFieldProps } from "./types";
+export declare const BizNumTextField: import("react").ForwardRefExoticComponent<Omit<BizNumTextFieldProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/CardNumTextField.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CardNumTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { CardNumTextFieldProps } from "./types";
+export declare const CardNumTextField: React.ForwardRefExoticComponent<Omit<CardNumTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/Checkbox.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Checkbox.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { CheckboxProps } from "./types";
+export declare const Checkbox: React.ForwardRefExoticComponent<Omit<CheckboxProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/ClearTextField.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ClearTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+export declare const ClearTextField: React.ForwardRefExoticComponent<(Omit<import("@mui/material").FilledTextFieldProps & import("./types").BaseTextFieldProps & {
+    clearIcon?: boolean;
+    spellCheck?: boolean;
+    onClear?: () => void;
+}, "ref"> | Omit<import("@mui/material").OutlinedTextFieldProps & import("./types").BaseTextFieldProps & {
+    clearIcon?: boolean;
+    spellCheck?: boolean;
+    onClear?: () => void;
+}, "ref"> | Omit<import("@mui/material").StandardTextFieldProps & import("./types").BaseTextFieldProps & {
+    clearIcon?: boolean;
+    spellCheck?: boolean;
+    onClear?: () => void;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

package/dist/DateRange.d.ts

@@ -0,0 +1,9 @@
+/**
+ * DateRange.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { DateRangeProps } from "./types";
+export declare function DateRange({ form, startName, endName, startLabel, endLabel, startValue, endValue, onStartChange, onEndChange, fullWidth, size, readonly, gap, startProps, endProps, }: DateRangeProps): import("react/jsx-runtime").JSX.Element;

package/dist/DateTextField.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DateTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { DateTextFieldProps } from "./types";
+export declare const DateTextField: React.ForwardRefExoticComponent<Omit<DateTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/DateTimeTextField.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DateTimeTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { DateTimeTextFieldProps } from "./types";
+export declare const DateTimeTextField: React.ForwardRefExoticComponent<Omit<DateTimeTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/EmailTextField.d.ts

@@ -0,0 +1,10 @@
+/**
+ * EmailTextField.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { EmailTextFieldProps } from "./types";
+export declare const EmailTextField: React.ForwardRefExoticComponent<Omit<EmailTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/JuminTextField.d.ts

@@ -0,0 +1,10 @@
+/**
+ * JuminTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { JuminTextFieldProps } from "./types";
+export declare const JuminTextField: import("react").ForwardRefExoticComponent<Omit<JuminTextFieldProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/LabelSelect.d.ts

@@ -0,0 +1,10 @@
+/**
+ * LabelSelect.tsx
+ *
+ * @license MIT
+ * @copyright 2025 Kim Young Jin
+ * @author Kim Young Jin (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { LabelSelectProps } from "./types";
+export declare const LabelSelect: React.ForwardRefExoticComponent<Omit<LabelSelectProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/NumberTextField.d.ts

@@ -0,0 +1,11 @@
+/**
+ * NumberTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { NumberTextFieldProps } from "./types";
+export declare const NumberTextField: React.ForwardRefExoticComponent<Omit<NumberTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/PasswordTextField.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PasswordTextField.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { PasswordTextFieldProps } from "./types";
+export declare const PasswordTextField: React.ForwardRefExoticComponent<Omit<PasswordTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/PhoneTextField.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PhoneTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { PhoneTextFieldProps } from "./types";
+export declare const PhoneTextField: React.ForwardRefExoticComponent<Omit<PhoneTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/RadioGroup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * RadioGroup.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { RadioGroupProps } from "./types";
+export declare const RadioGroup: React.ForwardRefExoticComponent<Omit<RadioGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/SearchTextField.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SearchTextField.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+export declare const SearchTextField: React.ForwardRefExoticComponent<(Omit<import("@mui/material").FilledTextFieldProps & import("./types").BaseTextFieldProps & {
+    loading?: boolean;
+    searchIcon?: boolean;
+    searchIconColor?: string;
+    clearIcon?: boolean;
+    clearIconColor?: string;
+    spellCheck?: boolean;
+    onClear?: () => void;
+}, "ref"> | Omit<import("@mui/material").OutlinedTextFieldProps & import("./types").BaseTextFieldProps & {
+    loading?: boolean;
+    searchIcon?: boolean;
+    searchIconColor?: string;
+    clearIcon?: boolean;
+    clearIconColor?: string;
+    spellCheck?: boolean;
+    onClear?: () => void;
+}, "ref"> | Omit<import("@mui/material").StandardTextFieldProps & import("./types").BaseTextFieldProps & {
+    loading?: boolean;
+    searchIcon?: boolean;
+    searchIconColor?: string;
+    clearIcon?: boolean;
+    clearIconColor?: string;
+    spellCheck?: boolean;
+    onClear?: () => void;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

package/dist/Select.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Select.tsx
+ *
+ * @license MIT
+ * @copyright 2025 Kim Young Jin
+ * @author Kim Young Jin (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { SelectProps } from "./types";
+export declare const Select: React.ForwardRefExoticComponent<Omit<SelectProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/Slider.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Slider.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { SliderProps } from "./types";
+export declare const Slider: React.ForwardRefExoticComponent<Omit<SliderProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/Switch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Switch.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { SwitchProps } from "./types";
+export declare const Switch: React.ForwardRefExoticComponent<Omit<SwitchProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/TextArea.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TextArea.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+export declare const TextArea: React.ForwardRefExoticComponent<import("./types").BaseTextFieldProps & {
+    label?: string;
+    value?: string;
+    name?: string;
+    onChange?: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    onBlur?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    onFocus?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    minRows?: number;
+    maxRows?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    fullWidth?: boolean;
+    sx?: import("@mui/material").SxProps<import("@mui/material").Theme>;
+    inputProps?: React.TextareaHTMLAttributes<HTMLTextAreaElement>;
+    inputRef?: React.Ref<HTMLTextAreaElement>;
+} & React.RefAttributes<HTMLTextAreaElement>>;

package/dist/TextAreaTextField.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TextArea.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+export declare const TextArea: React.ForwardRefExoticComponent<import("./types").BaseTextFieldProps & {
+    label?: string;
+    value?: string;
+    name?: string;
+    onChange?: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    onBlur?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    onFocus?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    minRows?: number;
+    maxRows?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    fullWidth?: boolean;
+    sx?: import("@mui/material").SxProps<import("@mui/material").Theme>;
+    inputProps?: React.TextareaHTMLAttributes<HTMLTextAreaElement>;
+    inputRef?: React.Ref<HTMLTextAreaElement>;
+} & React.RefAttributes<HTMLTextAreaElement>>;

package/dist/TimeTextField.d.ts

@@ -0,0 +1,11 @@
+/**
+ * TimeTextField.tsx
+ *
+ * @license MIT
+            form,
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { TimeTextFieldProps } from "./types";
+export declare const TimeTextField: React.ForwardRefExoticComponent<Omit<TimeTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/VerificationCodeTextField.d.ts

@@ -0,0 +1,10 @@
+/**
+ * VerificationCodeTextField.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+import type { VerificationCodeTextFieldProps } from "./types";
+export declare const VerificationCodeTextField: React.ForwardRefExoticComponent<Omit<VerificationCodeTextFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/components/ColonBox.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ColonBox.tsx - 시간 필드 사이의 콜론 아이콘 컴포넌트
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { SxProps, Theme } from "@mui/material/styles";
+export interface ColonBoxProps {
+    /** 크기 (small | medium) */
+    size?: "small" | "medium";
+    /** 가로 마진 */
+    mx?: number;
+    /** 콜론 표시 여부 */
+    visible?: boolean;
+    /** 추가 스타일 */
+    sx?: SxProps<Theme>;
+}
+/**
+ * 콜론 아이콘을 감싸는 박스 컴포넌트
+ * TimeTextField와 DateTimeTextField에서 공통으로 사용
+ */
+export declare function ColonBox({ size, mx, visible, sx }: ColonBoxProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/GroupedInputWrapper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GroupedInputWrapper.tsx
+ *
+ * 그룹화된 입력 컴포넌트(사업자번호, 주민번호, 카드번호, 시간 등)를 위한
+ * FormControl + OutlinedInput 래퍼 컴포넌트
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React, { RefObject } from "react";
+import type { SxProps, Theme } from "@mui/material/styles";
+export interface GroupedInputWrapperProps {
+    label?: React.ReactNode;
+    size?: "small" | "medium";
+    disabled?: boolean;
+    readonly?: boolean;
+    focusedGroup: number | null;
+    setFocusedGroup: (group: number | null) => void;
+    hasValue: boolean;
+    isInvalid?: boolean;
+    invalidBorderColor?: string;
+    inputRefs: RefObject<HTMLInputElement | null>[];
+    getTargetRefOnClick: () => {
+        ref: RefObject<HTMLInputElement | null>;
+        groupIndex: number;
+    };
+    sx?: SxProps<Theme>;
+    className?: string;
+    id?: string;
+    fullWidth?: boolean;
+    children: React.ReactNode;
+    contentSx?: SxProps<Theme>;
+    endAdornment?: React.ReactNode;
+}
+export declare function GroupedInputWrapper({ label, size, disabled, readonly, focusedGroup, setFocusedGroup, hasValue, isInvalid, invalidBorderColor, inputRefs, getTargetRefOnClick, sx, className, id, fullWidth, children, contentSx, endAdornment, }: GroupedInputWrapperProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SimpleCalendar.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SimpleCalendar.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export type SimpleCalendarProps = {
+    selectedDate: Date | null;
+    onSelect: (date: Date) => void;
+    minDate?: Date;
+    maxDate?: Date;
+    holidays?: Date[];
+    selectedColor?: string;
+    onClose: () => void;
+    showToday?: boolean;
+    showTimePicker?: boolean;
+    timeValue?: {
+        hour: string;
+        minute: string;
+        second?: string;
+    };
+    onTimeChange?: (hour: number, minute: number, second?: number) => void;
+    timeFormat?: "HH:mm" | "HH:mm:ss" | "hh:mm" | "hh:mm:ss";
+    minTime?: string;
+    maxTime?: string;
+    minuteStep?: number;
+    secondStep?: number;
+    hideDisabledTime?: boolean;
+};
+/**
+ * 간단한 MUI 스타일 달력 컴포넌트
+ *
+ * 구조:
+ * calendar-root (flex column, 100% height)
+ * ├── calendar-header (공통, 고정 높이 40px)
+ * │   - viewMode에 따라 내용 변경
+ * ├── calendar-content (flex: 1)
+ * │   - [calendar] 요일 헤더 + 날짜 그리드
+ * │   - [year] 연도 그리드 (OverlayScrollbar)
+ * │   - [month] 월 그리드
+ * └── calendar-footer (공통, 고정 높이 40px)
+ *     - viewMode에 따라 버튼 변경
+ */
+export declare function SimpleCalendar({ selectedDate, onSelect, minDate, maxDate, holidays, selectedColor, onClose, showToday, showTimePicker, timeValue, onTimeChange, timeFormat, minTime, maxTime, minuteStep, secondStep, hideDisabledTime, }: SimpleCalendarProps): import("react/jsx-runtime").JSX.Element;