@ehfuse/mui-form-controls 1.0.0

package/dist/label-select/LabelSelect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LabelSelect.tsx
+ *
+ * @license Proprietary License (독점 라이선스)
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import { LabelSelectProps } from "./types";
+export declare function LabelSelect(props: LabelSelectProps): import("react/jsx-runtime").JSX.Element;

package/dist/label-select/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * mui-label-select
+ *
+ * @license Proprietary License (독점 라이선스)
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export { LabelSelect } from "./LabelSelect";
+export type { LabelSelectProps, LabelSelectOption, SelectChangeEvent, } from "./types";

package/dist/label-select/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * types.ts
+ *
+ * @license Proprietary License (독점 라이선스)
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { SxProps, Theme, FormControlProps } from "@mui/material";
+import { SelectProps, SelectChangeEvent } from "@mui/material";
+import { InputBaseComponentProps } from "@mui/material/InputBase";
+import type { CSSProperties } from "react";
+import type { FormLike } from "../types";
+export interface LabelSelectOption {
+    value: string | number;
+    label: string;
+}
+export interface LabelSelectProps extends Omit<SelectProps, "value" | "onChange" | "defaultValue" | "form"> {
+    size?: "small" | "medium";
+    label: string;
+    value?: string | number;
+    onChange?: (event: SelectChangeEvent<string | number>) => void;
+    options: LabelSelectOption[];
+    form?: FormLike | null;
+    inputProps?: InputBaseComponentProps;
+    enableWheel?: boolean;
+    showLabel?: boolean;
+    emptyLabel?: string;
+    defaultValue?: string | number;
+    readOnly?: boolean;
+    readonly?: boolean;
+    showEmptyOption?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    sx?: SxProps<Theme>;
+    formControlProps?: Omit<FormControlProps, "children">;
+    name?: string;
+}
+export type { SelectChangeEvent };

package/dist/types.d.ts

@@ -0,0 +1,406 @@
+/**
+ * types.ts
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import * as React from "react";
+import type { TextFieldProps as MuiTextFieldProps } from "@mui/material/TextField";
+import type { SxProps, Theme } from "@mui/material/styles";
+import type { CheckboxProps as MuiCheckboxProps } from "@mui/material/Checkbox";
+import type { SwitchProps as MuiSwitchProps } from "@mui/material/Switch";
+import type { RadioGroupProps as MuiRadioGroupProps } from "@mui/material/RadioGroup";
+import type { SliderProps as MuiSliderProps } from "@mui/material/Slider";
+import type { AutocompleteProps as MuiAutocompleteProps } from "@mui/material/Autocomplete";
+import type { SelectProps as MuiSelectProps, SelectChangeEvent } from "@mui/material/Select";
+import type { FormControlProps } from "@mui/material/FormControl";
+import type { InputBaseComponentProps } from "@mui/material/InputBase";
+export type TextFieldProps = MuiTextFieldProps;
+export type PopoverOrigin = {
+    vertical: "top" | "center" | "bottom";
+    horizontal: "left" | "center" | "right";
+};
+/**
+ * 모든 TextField 공통 Props
+ */
+export type FormLike = {
+    useFormValue: (name: string) => unknown;
+    handleFormChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+};
+export type BaseTextFieldProps = {
+    readonly?: boolean;
+    debounce?: number;
+    form?: FormLike | null;
+};
+export type TextAreaProps = 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?: SxProps<Theme>;
+    inputProps?: React.TextareaHTMLAttributes<HTMLTextAreaElement>;
+    inputRef?: React.Ref<HTMLTextAreaElement>;
+};
+export type CheckboxProps = Omit<MuiCheckboxProps, "checked" | "onChange" | "form"> & BaseTextFieldProps & {
+    name?: string;
+    checked?: boolean;
+    label?: React.ReactNode;
+    onChange?: (event: React.ChangeEvent<HTMLInputElement>, checked: boolean) => void;
+};
+export type SwitchProps = Omit<MuiSwitchProps, "checked" | "onChange" | "form"> & BaseTextFieldProps & {
+    name?: string;
+    checked?: boolean;
+    label?: React.ReactNode;
+    onChange?: (event: React.ChangeEvent<HTMLInputElement>, checked: boolean) => void;
+};
+export type RadioOption = {
+    value: string;
+    label: React.ReactNode;
+    disabled?: boolean;
+};
+export type RadioGroupProps = Omit<MuiRadioGroupProps, "onChange" | "form"> & BaseTextFieldProps & {
+    name?: string;
+    value?: string;
+    label?: React.ReactNode;
+    options: RadioOption[];
+    disabled?: boolean;
+    onChange?: (event: React.ChangeEvent<HTMLInputElement>, value: string) => void;
+};
+export type DateRangeProps = BaseTextFieldProps & {
+    startName?: string;
+    endName?: string;
+    startLabel?: string;
+    endLabel?: string;
+    startValue?: string;
+    endValue?: string;
+    onStartChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    onEndChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    fullWidth?: boolean;
+    size?: "small" | "medium";
+    readonly?: boolean;
+    gap?: number;
+    startProps?: Omit<DateTextFieldProps, "name" | "value" | "onChange" | "form">;
+    endProps?: Omit<DateTextFieldProps, "name" | "value" | "onChange" | "form">;
+};
+export type SliderProps = Omit<MuiSliderProps, "value" | "onChange" | "form"> & BaseTextFieldProps & {
+    name?: string;
+    label?: React.ReactNode;
+    value?: number | number[];
+    onChange?: (event: Event, value: number | number[]) => void;
+};
+export type AutocompleteOption = {
+    value: string | number;
+    label: string;
+};
+export type AutocompleteProps = Omit<MuiAutocompleteProps<AutocompleteOption, false, false, false>, "renderInput" | "options" | "value" | "onChange"> & BaseTextFieldProps & {
+    name?: string;
+    label?: string;
+    options: AutocompleteOption[];
+    value?: string | number | null;
+    onChange?: (value: string | number | null) => void;
+    fullWidth?: boolean;
+    size?: "small" | "medium";
+    readonly?: boolean;
+    textFieldProps?: Omit<TextFieldProps, "label" | "value" | "onChange">;
+};
+export type LabelSelectOption = {
+    value: string | number;
+    label: string;
+};
+export type SelectOption = {
+    value: string | number;
+    label: string;
+};
+export type LabelSelectProps = Omit<MuiSelectProps, "value" | "onChange" | "defaultValue" | "form"> & BaseTextFieldProps & {
+    label: string;
+    value?: string | number;
+    onChange?: (event: SelectChangeEvent<string | number>) => void;
+    options: LabelSelectOption[];
+    inputProps?: InputBaseComponentProps;
+    enableWheel?: boolean;
+    showLabel?: boolean;
+    emptyLabel?: string;
+    readOnly?: boolean;
+    showEmptyOption?: boolean;
+    fullWidth?: boolean;
+    formControlProps?: Omit<FormControlProps, "children">;
+    name?: string;
+};
+export type SelectProps = Omit<MuiSelectProps, "value" | "onChange" | "defaultValue" | "form"> & BaseTextFieldProps & {
+    value?: string | number;
+    onChange?: (event: SelectChangeEvent<string | number>) => void;
+    options: SelectOption[];
+    inputProps?: InputBaseComponentProps;
+    enableWheel?: boolean;
+    emptyLabel?: string;
+    readOnly?: boolean;
+    showEmptyOption?: boolean;
+    fullWidth?: boolean;
+    formControlProps?: Omit<FormControlProps, "children">;
+    name?: string;
+};
+export type { SelectChangeEvent };
+/**
+ * 유효성 검사 기능을 가진 TextField 공통 Props
+ */
+export type ValidatableTextFieldProps = {
+    onValidationChange?: (isValid: boolean) => void;
+    invalidBorderColor?: string;
+};
+export type SearchTextFieldProps = TextFieldProps & BaseTextFieldProps & {
+    loading?: boolean;
+    searchIcon?: boolean;
+    searchIconColor?: string;
+    clearIcon?: boolean;
+    clearIconColor?: string;
+    spellCheck?: boolean;
+    onClear?: () => void;
+};
+export type ClearTextFieldProps = TextFieldProps & BaseTextFieldProps & {
+    clearIcon?: boolean;
+    spellCheck?: boolean;
+    onClear?: () => void;
+};
+/**
+ * 비밀번호 유효성 검사 규칙
+ */
+export type PasswordValidationRules = {
+    minLength?: number;
+    maxLength?: number;
+    requireUppercase?: boolean;
+    requireLowercase?: boolean;
+    requireNumber?: boolean;
+    requireSpecialChar?: boolean;
+    specialChars?: string;
+};
+/**
+ * 유효성 검사 결과
+ */
+export type PasswordValidationResult = {
+    isValid: boolean;
+    errors: {
+        minLength?: boolean;
+        maxLength?: boolean;
+        requireUppercase?: boolean;
+        requireLowercase?: boolean;
+        requireNumber?: boolean;
+        requireSpecialChar?: boolean;
+    };
+};
+export type PasswordTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & Omit<ValidatableTextFieldProps, "onValidationChange"> & {
+    showToggle?: boolean;
+    validationRules?: PasswordValidationRules;
+    onValidationChange?: (result: PasswordValidationResult) => void;
+};
+/**
+ * 전화번호 포맷 타입
+ */
+export type PhoneFormat = "010-0000-0000" | "010-000-0000" | "02-000-0000" | "02-0000-0000" | "000-000-0000" | "000-0000-0000" | "0000-0000";
+export type PhoneTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & ValidatableTextFieldProps & {
+    autoFormat?: boolean;
+    includeDash?: boolean;
+    prefix?: string;
+    format?: PhoneFormat;
+};
+/**
+ * 숫자 텍스트 필드 타입
+ */
+export type NumberTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & {
+    thousandSeparator?: boolean;
+    decimalLength?: number;
+    decimalFixed?: boolean;
+    textAlign?: "left" | "center" | "right";
+    min?: number;
+    max?: number;
+    negative?: boolean;
+    negativeStyles?: React.CSSProperties;
+    prefix?: string;
+    suffix?: string;
+    showSuffix?: "always" | "hasValue";
+    selectOnFocus?: boolean;
+};
+export interface AddressTextFieldProps extends Omit<TextFieldProps, "type">, BaseTextFieldProps {
+    spellCheck?: boolean;
+}
+/** Daum 우편번호 API 응답 데이터 타입 */
+export interface DaumPostcodeData {
+    address: string;
+    addressType: "R" | "J";
+    bname: string;
+    buildingName: string;
+    apartment: "Y" | "N";
+    zonecode: string;
+    jibunAddress: string;
+    roadAddress: string;
+    autoJibunAddress: string;
+    autoRoadAddress: string;
+    sido: string;
+    sigungu: string;
+    sigunguCode: string;
+    roadnameCode: string;
+    bcode: string;
+    roadname: string;
+    bname1: string;
+    bname2: string;
+    hname: string;
+    query: string;
+    userLanguageType: "K" | "E";
+    userSelectedType: "R" | "J";
+    noSelected: "Y" | "N";
+}
+/**
+ * 주민등록번호에서 추출한 정보
+ */
+export type JuminInfo = {
+    value: string;
+    isValid: boolean;
+    birthDate: string | null;
+    gender: "male" | "female" | null;
+    isForeigner: boolean | null;
+    region: string | null;
+};
+/**
+ * 주민등록번호 텍스트 필드 타입
+ */
+export type JuminTextFieldProps = Omit<TextFieldProps, "type" | "onChange" | "value"> & BaseTextFieldProps & ValidatableTextFieldProps & {
+    value?: string;
+    mask?: boolean;
+    maskColor?: string;
+    validateChecksum?: boolean;
+    fontSize?: string | number;
+    fontColor?: string;
+    fontFamily?: string;
+    onChange?: (info: JuminInfo) => void;
+};
+/**
+ * 커스텀 도메인 정의 (아이콘 포함)
+ */
+export type CustomDomain = {
+    domain: string;
+    icon?: React.ReactNode;
+};
+/**
+ * 이메일 텍스트 필드 타입
+ */
+export type EmailTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & ValidatableTextFieldProps & {
+    domains?: string[];
+    extraDomains?: (string | CustomDomain)[];
+    suggestions?: boolean;
+    showLogos?: boolean;
+};
+/**
+ * 인증번호 입력 타입
+ */
+export type VerificationCodeType = "numeric" | "alpha" | "alphanumeric";
+/**
+ * 시간 포맷 타입
+ */
+export type TimeFormat = "HH:mm" | "HH:mm:ss" | "hh:mm" | "hh:mm:ss";
+/**
+ * 시간 텍스트 필드 타입
+ */
+export type TimeTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & Pick<ValidatableTextFieldProps, "invalidBorderColor"> & {
+    format?: TimeFormat;
+    minTime?: string;
+    maxTime?: string;
+    clockIcon?: boolean;
+    minuteStep?: number;
+    secondStep?: number;
+    hideDisabledTime?: boolean;
+    fontSize?: string | number;
+    fontColor?: string;
+    fontFamily?: string;
+};
+/**
+ * 날짜 포맷 타입
+ */
+export type DateFormat = "YYYY-MM-DD" | "YYYY.MM.DD" | "YYYY/MM/DD" | "YYYY-MM" | "YYYY.MM" | "YYYY/MM" | "MM-DD-YYYY" | "MM.DD.YYYY" | "MM/DD/YYYY" | "MM-DD" | "MM.DD" | "MM/DD" | "DD-MM-YYYY" | "DD.MM.YYYY" | "DD/MM/YYYY" | "DD-MM" | "DD.MM" | "DD/MM" | "YY-MM-DD" | "YY.MM.DD" | "YY/MM/DD" | "YY-MM" | "YY.MM" | "YY/MM";
+/**
+ * 날짜 텍스트 필드 타입
+ */
+export type DateTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & Pick<ValidatableTextFieldProps, "invalidBorderColor"> & {
+    format?: DateFormat;
+    separator?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    holidays?: Date[];
+    holidayColor?: string;
+    calendarIcon?: boolean;
+    selectedColor?: string;
+    showToday?: boolean;
+    calendarAnchorOrigin?: PopoverOrigin;
+    calendarTransformOrigin?: PopoverOrigin;
+    calendarContainer?: HTMLElement;
+    onCalendarDismiss?: () => void;
+    onCalendarOpen?: () => void;
+    onCalendarClose?: () => void;
+};
+/**
+ * 인증번호 텍스트 필드 타입
+ */
+export type VerificationCodeTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & Pick<ValidatableTextFieldProps, "invalidBorderColor"> & {
+    length?: number;
+    type?: VerificationCodeType;
+    fontSize?: number;
+    fontColor?: string;
+    fontFamily?: string;
+    dotSize?: number;
+    caretColor?: string;
+    onComplete?: (value: string) => void;
+};
+/**
+ * 사업자등록번호 텍스트 필드 타입
+ */
+export type BizNumTextFieldProps = Omit<TextFieldProps, "type" | "value"> & BaseTextFieldProps & ValidatableTextFieldProps & {
+    value?: string;
+    includeDash?: boolean;
+    validate?: boolean;
+    copyIcon?: boolean;
+    fontSize?: string | number;
+    fontColor?: string;
+    fontFamily?: string;
+};
+/**
+ * 카드번호 텍스트 필드 타입
+ */
+export type CardNumTextFieldProps = Omit<TextFieldProps, "type" | "value"> & BaseTextFieldProps & ValidatableTextFieldProps & {
+    value?: string;
+    maskColor?: string;
+    fontSize?: string | number;
+    fontColor?: string;
+    fontFamily?: string;
+    validate?: boolean;
+    onCardBrandChange?: (brand: string | null) => void;
+    logoIcon?: boolean;
+};
+/**
+ * 날짜시간 포맷 타입
+ */
+export type DateTimeFormat = "YYYY-MM-DD HH:mm" | "YYYY-MM-DD HH:mm:ss" | "YYYY-MM-DD hh:mm" | "YYYY-MM-DD hh:mm:ss" | "YYYY.MM.DD HH:mm" | "YYYY.MM.DD HH:mm:ss" | "YYYY.MM.DD hh:mm" | "YYYY.MM.DD hh:mm:ss" | "YYYY/MM/DD HH:mm" | "YYYY/MM/DD HH:mm:ss" | "YYYY/MM/DD hh:mm" | "YYYY/MM/DD hh:mm:ss";
+/**
+ * 날짜시간 텍스트 필드 타입
+ */
+export type DateTimeTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & Pick<ValidatableTextFieldProps, "invalidBorderColor"> & {
+    format?: DateTimeFormat;
+    dateSeparator?: string;
+    minDateTime?: Date;
+    maxDateTime?: Date;
+    minTime?: string;
+    maxTime?: string;
+    holidays?: Date[];
+    holidayColor?: string;
+    calendarIcon?: boolean;
+    selectedColor?: string;
+    showToday?: boolean;
+    minuteStep?: number;
+    secondStep?: number;
+    hideDisabledTime?: boolean;
+};

package/dist/utils/biznum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * biznum.ts - 사업자번호 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+/**
+ * 사업자번호 유효성 검사 (검증 알고리즘)
+ * 사업자등록번호는 10자리 숫자이며, 마지막 자리가 검증번호입니다.
+ */
+export declare function validateBusinessNumber(value: string): boolean;

package/dist/utils/card.d.ts

@@ -0,0 +1,17 @@
+/**
+ * card.ts - 카드번호 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+/** 카드 브랜드 타입 */
+export type CardBrand = "visa" | "mastercard" | "amex" | "jcb" | "diners" | "discover" | "unionpay" | "bc" | null;
+/**
+ * 카드번호 유효성 검사 (Luhn 알고리즘)
+ */
+export declare function validateCardNumber(value: string): boolean;
+/**
+ * 카드 브랜드 감지 (국제 브랜드 기준)
+ */
+export declare function detectCardBrand(value: string): CardBrand;

package/dist/utils/date.d.ts

@@ -0,0 +1,114 @@
+/**
+ * date.ts - 날짜 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { DateFormat, DateTimeFormat } from "../types";
+/**
+ * 윤년 체크
+ */
+export declare function isLeapYear(year: number): boolean;
+/**
+ * 해당 월의 말일 계산
+ */
+export declare function getDaysInMonth(year: number, month: number): number;
+/**
+ * 날짜 포맷에 따른 구분자 가져오기
+ */
+export declare function getSeparator(format: DateFormat): string;
+/**
+ * 날짜 자동 포맷팅 함수
+ */
+export declare function formatDate(value: string, format: DateFormat): string;
+/**
+ * 포맷에 따른 최대 길이 계산
+ */
+export declare function getMaxLength(format: DateFormat): number;
+/**
+ * 포맷에 따른 완성 숫자 길이
+ */
+export declare function getCompleteLength(format: DateFormat): number;
+/**
+ * 날짜 문자열에서 연/월/일 추출
+ */
+export declare function parseDateParts(value: string, format: DateFormat): {
+    year: number;
+    month: number;
+    day: number;
+} | null;
+/**
+ * 날짜 유효성 검사
+ */
+export declare function validateDate(value: string, format: DateFormat, minDate?: Date, maxDate?: Date): boolean;
+/**
+ * 날짜 문자열을 Date 객체로 변환
+ */
+export declare function parseToDate(value: string, format: DateFormat): Date | null;
+/**
+ * 날짜 값 제한 (년/월/일)
+ */
+export declare function clampDateValue(value: string, type: "year" | "month" | "day", yearValue?: string, monthValue?: string): string;
+/**
+ * DateTimeFormat에서 DateFormat 부분 추출
+ */
+export declare function extractDateFormat(format: DateTimeFormat): DateFormat;
+/**
+ * 초 필드가 있는지 확인
+ */
+export declare function hasSecondField(format: DateTimeFormat): boolean;
+/**
+ * 입력된 숫자를 유효한 범위로 보정 (날짜용)
+ */
+export declare function constrainDateNumbers(numbers: string, format: DateFormat): string;
+/**
+ * 날짜 자동 포맷팅 함수 (DateTimeTextField용)
+ */
+export declare function formatDateValue(value: string, format: DateFormat): string;
+/**
+ * 날짜 포맷을 밑줄 placeholder로 변환
+ */
+export declare function formatToPlaceholder(format: DateFormat): string;
+/**
+ * 클릭 위치에 따라 선택할 영역의 시작/끝 인덱스 반환
+ */
+export declare function getSegmentRange(cursorPos: number, format: DateFormat): {
+    start: number;
+    end: number;
+};
+/**
+ * 포맷에 연도가 포함되어 있는지 확인
+ * - YYYY 또는 YY가 포함되어 있으면 연도가 있는 포맷
+ */
+export declare function hasYearInFormat(format: DateFormat): boolean;
+/**
+ * 포맷이 2자리 연도(YY)를 사용하는지 확인
+ */
+export declare function has2DigitYear(format: DateFormat): boolean;
+/**
+ * 2자리 연도를 4자리 연도로 변환
+ * - 50 이상이면 1900년대, 50 미만이면 2000년대
+ */
+export declare function convertYY2YYYY(yy: number): number;
+/**
+ * 포맷에서 날짜 파싱 (연도 없는 포맷 지원, internalYear 활용)
+ */
+export declare function parseDateWithInternalYear(formattedValue: string, format: DateFormat, internalYear?: number | null): {
+    year: number;
+    month: number;
+    day: number;
+} | null;
+/**
+ * 달력 선택 또는 입력값을 출력용 문자열로 변환 (연도가 없는 포맷이어도 연도 포함)
+ * @param formattedValue - 포맷된 날짜 문자열 (예: "12-25")
+ * @param format - 날짜 포맷
+ * @param separator - 출력 구분자
+ * @param internalYear - 내부적으로 관리하는 연도 (연도 없는 포맷용)
+ * @returns 출력용 날짜 문자열 (항상 연도 포함, 예: "2024-12-25")
+ */
+export declare function buildDateOutputValue(formattedValue: string, format: DateFormat, separator: string, internalYear?: number | null): string;
+/**
+ * Date 객체에서 포맷에 맞는 숫자 문자열 생성
+ */
+export declare function dateToNumbers(date: Date, format: DateFormat): string;

package/dist/utils/datetime.d.ts

@@ -0,0 +1,37 @@
+/**
+ * datetime.ts - 날짜시간 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import { TimeFormat } from "../types";
+/**
+ * 윤년 체크
+ */
+export declare function isLeapYear(year: number): boolean;
+/**
+ * 해당 월의 말일 계산
+ */
+export declare function getDaysInMonth(year: number, month: number): number;
+/**
+ * 포맷에 따른 필드 개수 (2: 시:분, 3: 시:분:초)
+ */
+export declare function getTimeFieldCount(format: TimeFormat): number;
+/**
+ * 12시간 형식인지 확인
+ */
+export declare function is12HourFormat(format: string): boolean;
+/**
+ * 시간 유효성 검사
+ * @param formatOrIs12Hour - TimeFormat 문자열 또는 12시간제 여부 boolean
+ */
+export declare function validateTime(hour: string, minute: string, second: string, formatOrIs12Hour: TimeFormat | boolean, minTime?: string, maxTime?: string): boolean;
+/**
+ * 날짜 값 제한 (년/월/일)
+ */
+export declare function clampDateValue(value: string, type: "year" | "month" | "day", yearValue?: string, monthValue?: string): string;
+/**
+ * 시간 값 제한 (시/분/초)
+ */
+export declare function clampTimeValue(value: string, type: "hour" | "minute" | "second", is12Hour?: boolean): string;

package/dist/utils/email.d.ts

@@ -0,0 +1,15 @@
+/**
+ * email.ts - 이메일 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+/**
+ * 기본 도메인 제안 목록
+ */
+export declare const DEFAULT_EMAIL_DOMAINS: string[];
+/**
+ * 이메일 유효성 검사
+ */
+export declare function validateEmail(email: string): boolean;

package/dist/utils/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * utils/index.ts
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export { isLeapYear, getDaysInMonth, getSeparator, formatDate, getMaxLength, getCompleteLength, parseDateParts, validateDate, parseToDate, clampDateValue, extractDateFormat, hasSecondField, constrainDateNumbers, formatDateValue, formatToPlaceholder, getSegmentRange, hasYearInFormat, has2DigitYear, convertYY2YYYY, parseDateWithInternalYear, buildDateOutputValue, dateToNumbers, } from "./date";
+export { getTimeFieldCount, is12HourFormat, validateTime, clampTimeValue, } from "./time";
+export { formatNumber, parseNumber } from "./number";
+export { DEFAULT_EMAIL_DOMAINS, validateEmail } from "./email";
+export { formatPhoneNumber, getPhoneMaxLength } from "./phone";
+export { DEFAULT_SPECIAL_CHARS, DEFAULT_PASSWORD_VALIDATION_RULES, validatePassword, } from "./password";
+export { validateBusinessNumber } from "./biznum";
+export { validateCardNumber, detectCardBrand } from "./card";
+export type { CardBrand } from "./card";
+export { REGION_MAP, extractJuminInfo, validateJuminChecksum, validateJuminBirthDate, } from "./jumin";