@ehfuse/mui-form-controls 1.0.0

package/dist/components/TimePicker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TimePicker.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+interface TimePickerProps {
+    anchorEl: HTMLElement | null;
+    open: boolean;
+    onClose: () => void;
+    value: {
+        hour: string;
+        minute: string;
+        second?: string;
+    };
+    onChange: (hour: string, minute: string, second?: string) => void;
+    format: "HH:mm" | "HH:mm:ss" | "hh:mm" | "hh:mm:ss";
+    minTime?: string;
+    maxTime?: string;
+    minuteStep?: number;
+    secondStep?: number;
+    hideDisabledTime?: boolean;
+}
+export declare function TimePicker({ anchorEl, open, onClose, value, onChange, format, minTime, maxTime, minuteStep, secondStep, hideDisabledTime, }: TimePickerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/TimeSelector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TimeSelector.tsx
+ * 시간 선택 UI 컴포넌트 (재사용 가능)
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export interface TimeSelectorProps {
+    value: {
+        hour: string;
+        minute: string;
+        second?: string;
+    };
+    onChange: (hour: number, minute: number, second?: number) => void;
+    format: "HH:mm" | "HH:mm:ss" | "hh:mm" | "hh:mm:ss";
+    minTime?: string;
+    maxTime?: string;
+    minuteStep?: number;
+    secondStep?: number;
+    showHeader?: boolean;
+    hideDisabledTime?: boolean;
+}
+export declare function TimeSelector({ value, onChange, format, minTime, maxTime, minuteStep, secondStep, showHeader, hideDisabledTime, }: TimeSelectorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/index.d.ts

@@ -0,0 +1,4 @@
+export { GroupedInputWrapper } from "./GroupedInputWrapper";
+export type { GroupedInputWrapperProps } from "./GroupedInputWrapper";
+export { ColonBox } from "./ColonBox";
+export type { ColonBoxProps } from "./ColonBox";

package/dist/hooks/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * hooks/index.ts
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export { useTextFieldBase, useDebouncedEmit } from "./useTextFieldBase";
+export type { UseTextFieldBaseOptions, UseTextFieldBaseReturn, UseDebouncedEmitOptions, UseDebouncedEmitReturn, } from "./useTextFieldBase";
+export { useKoreanHolidays, useKoreanHolidaysRange } from "./useKoreanHolidays";
+export { useGroupedInput } from "./useGroupedInput";
+export type { GroupConfig, UseGroupedInputOptions, UseGroupedInputReturn, } from "./useGroupedInput";

package/dist/hooks/useGroupedInput.d.ts

@@ -0,0 +1,48 @@
+/**
+ * useGroupedInput.ts
+ *
+ * 그룹화된 입력 필드(주민번호, 사업자번호, 시간 등)에서 공통으로 사용하는
+ * 커서 관리, 포커스 관리, 키보드 핸들링 로직을 제공하는 훅
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import { RefObject } from "react";
+export interface GroupConfig {
+    maxLength: number;
+    ref: RefObject<HTMLInputElement | null>;
+    value: string;
+    setValue: (value: string) => void;
+}
+export interface UseGroupedInputOptions {
+    groups: GroupConfig[];
+    fontFamily?: string;
+    fontSize: number;
+    onComplete?: () => void;
+    disabled?: boolean;
+    readonly?: boolean;
+}
+export interface UseGroupedInputReturn {
+    focusedGroup: number | null;
+    setFocusedGroup: (group: number | null) => void;
+    cursorVisible: boolean;
+    setCursorVisible: (visible: boolean) => void;
+    cursorPosRef: RefObject<number>;
+    isClickFocusRef: RefObject<boolean>;
+    inputComplete: boolean;
+    setInputComplete: (complete: boolean) => void;
+    renderTrigger: number;
+    measureTextWidth: (text: string) => number;
+    getCursorLeft: (groupIndex: number) => number;
+    createMouseDownHandler: (groupIndex: number) => (e: React.MouseEvent) => void;
+    createClickHandler: (groupIndex: number) => (e: React.MouseEvent) => void;
+    createContainerClickHandler: () => (e: React.MouseEvent) => void;
+    createFocusHandler: (groupIndex: number) => () => void;
+    createBlurHandler: () => () => void;
+    createKeyDownHandler: (groupIndex: number, onValueChange?: (newValue: string, groupIndex: number) => void) => (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    createChangeHandler: (groupIndex: number, onAfterChange?: (newValue: string, groupIndex: number, isComplete: boolean) => void) => (e: React.ChangeEvent<HTMLInputElement>) => void;
+    getCursorPosFromClick: (e: React.MouseEvent, value: string, inputRef: RefObject<HTMLInputElement | null>) => number;
+    forceRender: () => void;
+}
+export declare function useGroupedInput({ groups, fontFamily, fontSize, onComplete, disabled, readonly, }: UseGroupedInputOptions): UseGroupedInputReturn;

package/dist/hooks/useKoreanHolidays.d.ts

@@ -0,0 +1,29 @@
+/**
+ * useKoreanHolidays.ts
+ *
+ * 한국천문연구원 특일 정보 API를 이용하여 공휴일을 조회하는 커스텀 훅
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+/**
+ * 한국 공휴일을 조회하는 커스텀 훅
+ *
+ * @param apiKey - 공공데이터포털 API 인증키 (Encoding)
+ * @param year - 조회할 연도 (기본값: 현재 연도)
+ * @returns { holidays: Date[], loading: boolean, error: string | null }
+ */
+export declare function useKoreanHolidays(apiKey?: string, year?: number): {
+    holidays: Date[];
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * 여러 연도의 공휴일을 한번에 조회하는 훅
+ */
+export declare function useKoreanHolidaysRange(apiKey?: string, startYear?: number, endYear?: number): {
+    holidays: Date[];
+    loading: boolean;
+    error: string | null;
+};

package/dist/hooks/useTextFieldBase.d.ts

@@ -0,0 +1,47 @@
+/**
+ * useTextFieldBase.ts
+ *
+ * TextField 컴포넌트들의 공통 로직을 담당하는 훅
+ * - 디바운스 처리
+ * - 내부 상태 관리
+ * - blur 시 flush
+ * - 외부 value 동기화
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import { ChangeEvent } from "react";
+export interface UseTextFieldBaseOptions {
+    value: string;
+    name?: string;
+    debounce?: number;
+    onChange?: (e: ChangeEvent<HTMLInputElement>) => void;
+    onBlur?: (e: React.FocusEvent<HTMLInputElement>) => void;
+    transformValue?: (inputValue: string, currentDisplayValue: string) => {
+        displayValue: string;
+        emitValue: string;
+    };
+}
+export interface UseTextFieldBaseReturn {
+    internalValue: string;
+    setInternalValue: (value: string) => void;
+    handleChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    handleBlur: (e: React.FocusEvent<HTMLInputElement>) => void;
+    emitChange: (e: ChangeEvent<HTMLInputElement> | React.FocusEvent<HTMLInputElement>, newValue: string, immediate?: boolean) => void;
+    lastEmittedValue: React.MutableRefObject<string>;
+    debounceTimer: React.MutableRefObject<ReturnType<typeof setTimeout> | null>;
+}
+export declare function useTextFieldBase({ value, name, debounce, onChange, onBlur, transformValue, }: UseTextFieldBaseOptions): UseTextFieldBaseReturn;
+export interface UseDebouncedEmitOptions {
+    name?: string;
+    debounce?: number;
+    onChange?: (e: ChangeEvent<HTMLInputElement>) => void;
+}
+export interface UseDebouncedEmitReturn {
+    emitChange: (e: ChangeEvent<HTMLInputElement> | React.FocusEvent<HTMLInputElement> | null, newValue: string, immediate?: boolean) => void;
+    flushOnBlur: (e: React.FocusEvent<HTMLInputElement>, currentValue: string) => void;
+    lastEmittedValue: React.MutableRefObject<string>;
+    debounceTimer: React.MutableRefObject<ReturnType<typeof setTimeout> | null>;
+}
+export declare function useDebouncedEmit({ name, debounce, onChange, }: UseDebouncedEmitOptions): UseDebouncedEmitReturn;

package/dist/icons/CalendarIcon.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CalendarIcon.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export declare const CalendarIcon: ({ size }: {
+    size?: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/icons/ChevronLeft.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ChevronLeft.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export declare const ChevronLeft: () => import("react/jsx-runtime").JSX.Element;

package/dist/icons/ChevronRight.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ChevronRight.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export declare const ChevronRight: () => import("react/jsx-runtime").JSX.Element;

package/dist/icons/ClockIcon.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ClockIcon.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+interface ClockIconProps {
+    size?: number;
+    color?: string;
+}
+export declare function ClockIcon({ size, color, }: ClockIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/icons/ColonIcon.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ColonIcon.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+interface ColonIconProps {
+    size?: "small" | "medium";
+    color?: string;
+}
+export declare function ColonIcon({ size, color, }: ColonIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/icons/CopyIcon.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CopyIcon.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+interface CopyIconProps {
+    size?: "small" | "medium";
+}
+export declare function CopyIcon({ size }: CopyIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/icons/DashIcon.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DashIcon.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+interface DashIconProps {
+    size?: "small" | "medium";
+}
+export declare function DashIcon({ size }: DashIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/icons/card-icons.d.ts

@@ -0,0 +1,21 @@
+/**
+ * card-icons.tsx
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+interface CardIconProps {
+    size?: number;
+    color?: string;
+}
+export declare function CardIcon({ size, color }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function VisaIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function MastercardIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function AmexIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function JcbIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function DinersIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function DiscoverIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function UnionPayIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function BcIcon({ size }: CardIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/icons/email-icons.d.ts

@@ -0,0 +1,27 @@
+/**
+ * email-icons.tsx
+ *
+ * 이메일 도메인 아이콘 컴포넌트
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+interface IconProps {
+    size?: number;
+}
+export declare const GmailIcon: React.FC<IconProps>;
+export declare const NaverIcon: React.FC<IconProps>;
+export declare const DaumIcon: React.FC<IconProps>;
+export declare const KakaoIcon: React.FC<IconProps>;
+export declare const NateIcon: React.FC<IconProps>;
+export declare const OutlookIcon: React.FC<IconProps>;
+export declare const YahooIcon: React.FC<IconProps>;
+export declare const ICloudIcon: React.FC<IconProps>;
+export declare const DefaultEmailIcon: React.FC<IconProps>;
+/**
+ * 도메인에 해당하는 아이콘 컴포넌트 반환
+ */
+export declare function getEmailIcon(domain: string, size?: number): React.ReactNode;
+export {};

package/dist/icons/index.d.ts

@@ -0,0 +1,8 @@
+export { CalendarIcon } from "./CalendarIcon";
+export { ChevronLeft } from "./ChevronLeft";
+export { ChevronRight } from "./ChevronRight";
+export { ClockIcon } from "./ClockIcon";
+export { ColonIcon } from "./ColonIcon";
+export { DashIcon } from "./DashIcon";
+export { CopyIcon } from "./CopyIcon";
+export { CardIcon, VisaIcon, MastercardIcon, AmexIcon, JcbIcon, DinersIcon, DiscoverIcon, UnionPayIcon, BcIcon, } from "./card-icons";

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @ehfuse/mui-form-controls
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export { SearchTextField } from "./SearchTextField";
+export { ClearTextField } from "./ClearTextField";
+export { PasswordTextField } from "./PasswordTextField";
+export { TextArea } from "./TextArea";
+export { Checkbox } from "./Checkbox";
+export { RadioGroup } from "./RadioGroup";
+export { Switch } from "./Switch";
+export { DateRange } from "./DateRange";
+export { Slider } from "./Slider";
+export { Autocomplete } from "./Autocomplete";
+export { Select } from "./Select";
+export { LabelSelect } from "./LabelSelect";
+export { PhoneTextField } from "./PhoneTextField";
+export { AddressTextField } from "./AddressTextField";
+export { NumberTextField } from "./NumberTextField";
+export { JuminTextField } from "./JuminTextField";
+export { VerificationCodeTextField } from "./VerificationCodeTextField";
+export { EmailTextField } from "./EmailTextField";
+export { DateTextField } from "./DateTextField";
+export { TimeTextField } from "./TimeTextField";
+export { DateTimeTextField } from "./DateTimeTextField";
+export { BizNumTextField } from "./BizNumTextField";
+export { CardNumTextField } from "./CardNumTextField";
+export { useKoreanHolidays, useKoreanHolidaysRange } from "./hooks";
+export { CardIcon, VisaIcon, MastercardIcon, AmexIcon, JcbIcon, DinersIcon, DiscoverIcon, UnionPayIcon, BcIcon, } from "./icons";
+export type { SearchTextFieldProps, ClearTextFieldProps, PasswordTextFieldProps, TextAreaProps, CheckboxProps, SwitchProps, RadioGroupProps, RadioOption, DateRangeProps, SliderProps, AutocompleteProps, AutocompleteOption, SelectProps, SelectOption, LabelSelectProps, LabelSelectOption, PasswordValidationRules, PasswordValidationResult, PhoneTextFieldProps, PhoneFormat, AddressTextFieldProps, DaumPostcodeData, NumberTextFieldProps, JuminTextFieldProps, JuminInfo, VerificationCodeTextFieldProps, VerificationCodeType, EmailTextFieldProps, CustomDomain, DateTextFieldProps, DateFormat, TimeTextFieldProps, TimeFormat, DateTimeTextFieldProps, DateTimeFormat, BizNumTextFieldProps, CardNumTextFieldProps, SelectChangeEvent, } from "./types";