@ehfuse/mui-form-controls 1.3.18 → 1.3.20

package/dist/types.d.ts

@@ -19,6 +19,7 @@ import type { StepperProps as MuiStepperProps } from "@mui/material/Stepper";
 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 { FormControlLabelProps } from "@mui/material/FormControlLabel";
 import type { InputBaseComponentProps } from "@mui/material/InputBase";
 export type TextFieldProps = MuiTextFieldProps;
 export type ButtonGroupProps = MuiButtonGroupProps;
@@ -66,6 +67,11 @@ export type SwitchProps = Omit<MuiSwitchProps, "checked" | "onChange" | "form">
     label?: React.ReactNode;
     onChange?: (event: React.ChangeEvent<HTMLInputElement>, checked: boolean) => void;
 };
+export type SwitchFieldProps = Omit<SwitchProps, "label"> & {
+    label: React.ReactNode;
+    labelPlacement?: FormControlLabelProps["labelPlacement"];
+    sx?: SxProps<Theme>;
+};
 export type RadioOption = {
     value: string;
     label: React.ReactNode;

package/package.json

@@ -1,85 +1,85 @@
-{
-    "name": "@ehfuse/mui-form-controls",
-    "version": "1.3.18",
-    "description": "Material-UI form controls and text fields for complex forms",
-    "private": false,
-    "publishConfig": {
-        "access": "public"
-    },
-    "main": "dist/index.js",
-    "module": "dist/index.mjs",
-    "types": "dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.mjs",
-            "require": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "node build.mjs",
-        "build:types": "tsc --emitDeclarationOnly",
-        "prepublishOnly": "npm run build"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/ehfuse/mui-form-controls.git"
-    },
-    "keywords": [
-        "react",
-        "mui",
-        "material-ui",
-        "form",
-        "controls",
-        "textfield",
-        "textarea",
-        "select",
-        "autocomplete",
-        "checkbox",
-        "switch",
-        "radio",
-        "slider",
-        "search",
-        "password",
-        "clear-button",
-        "input"
-    ],
-    "author": "김영진 (Kim Young Jin) <ehfuse@gmail.com>",
-    "license": "MIT",
-    "bugs": {
-        "url": "https://github.com/ehfuse/mui-form-controls/issues"
-    },
-    "homepage": "https://github.com/ehfuse/mui-form-controls#readme",
-    "devDependencies": {
-        "@ehfuse/alerts": "^1.1.2",
-        "@ehfuse/overlay-scrollbar": "^1.6.9",
-        "@types/react": "^19.2.7",
-        "@types/react-daum-postcode": "^1.3.4",
-        "@types/react-dom": "^19.2.3",
-        "esbuild": "^0.27.0",
-        "react-daum-postcode": "^4.0.0",
-        "typescript": "^5.9.3"
-    },
-    "peerDependencies": {
-        "@base-ui/react": "^1.1.0",
-        "@ehfuse/alerts": ">=1.1.0",
-        "@ehfuse/forma": ">=3.1.0",
-        "@ehfuse/mui-datetime-picker": ">=1.0.8",
-        "@ehfuse/overlay-scrollbar": ">=1.6.9",
-        "@emotion/react": "^11.0.0",
-        "@emotion/styled": "^11.0.0",
-        "@mui/icons-material": "^5.0.0 || ^6.0.0 || ^7.0.0",
-        "@mui/material": "^5.0.0 || ^6.0.0 || ^7.0.0",
-        "react": "^18.0.0 || ^19.0.0",
-        "react-daum-postcode": "^3.0.0 || ^4.0.0",
-        "react-dom": "^18.0.0 || ^19.0.0"
-    },
-    "peerDependenciesMeta": {
-        "react-daum-postcode": {
-            "optional": true
-        }
-    }
-}
+{
+    "name": "@ehfuse/mui-form-controls",
+    "version": "1.3.20",
+    "description": "Material-UI form controls and text fields for complex forms",
+    "private": false,
+    "publishConfig": {
+        "access": "public"
+    },
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "node build.mjs",
+        "build:types": "tsc --emitDeclarationOnly",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ehfuse/mui-form-controls.git"
+    },
+    "keywords": [
+        "react",
+        "mui",
+        "material-ui",
+        "form",
+        "controls",
+        "textfield",
+        "textarea",
+        "select",
+        "autocomplete",
+        "checkbox",
+        "switch",
+        "radio",
+        "slider",
+        "search",
+        "password",
+        "clear-button",
+        "input"
+    ],
+    "author": "김영진 (Kim Young Jin) <ehfuse@gmail.com>",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/ehfuse/mui-form-controls/issues"
+    },
+    "homepage": "https://github.com/ehfuse/mui-form-controls#readme",
+    "devDependencies": {
+        "@ehfuse/alerts": "^1.1.2",
+        "@ehfuse/overlay-scrollbar": "^1.6.9",
+        "@types/react": "^19.2.7",
+        "@types/react-daum-postcode": "^1.3.4",
+        "@types/react-dom": "^19.2.3",
+        "esbuild": "^0.27.0",
+        "react-daum-postcode": "^4.0.0",
+        "typescript": "^5.9.3"
+    },
+    "peerDependencies": {
+        "@base-ui/react": "^1.1.0",
+        "@ehfuse/alerts": ">=1.1.0",
+        "@ehfuse/forma": ">=3.1.0",
+        "@ehfuse/mui-datetime-picker": "^1.0.13",
+        "@ehfuse/overlay-scrollbar": ">=1.6.9",
+        "@emotion/react": "^11.0.0",
+        "@emotion/styled": "^11.0.0",
+        "@mui/icons-material": "^5.0.0 || ^6.0.0 || ^7.0.0",
+        "@mui/material": "^5.0.0 || ^6.0.0 || ^7.0.0",
+        "react": "^18.0.0 || ^19.0.0",
+        "react-daum-postcode": "^3.0.0 || ^4.0.0",
+        "react-dom": "^18.0.0 || ^19.0.0"
+    },
+    "peerDependenciesMeta": {
+        "react-daum-postcode": {
+            "optional": true
+        }
+    }
+}

package/dist/TextAreaTextField.d.ts

@@ -1,24 +0,0 @@
-/**
- * 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/components/SimpleCalendar.d.ts

@@ -1,45 +0,0 @@
-/**
- * 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;

package/dist/components/TimePicker.d.ts

@@ -1,26 +0,0 @@
-/**
- * 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

@@ -1,24 +0,0 @@
-/**
- * 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/label-select/LabelSelect.d.ts

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,38 +0,0 @@
-/**
- * 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/utils/datetime.d.ts

@@ -1,37 +0,0 @@
-/**
- * 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;