@ehfuse/mui-form-controls 1.3.19 → 1.3.20

package/README.md

@@ -42,6 +42,7 @@ MUI 기반 폼 컨트롤과 텍스트 필드 컴포넌트 모음
 | **Slider**       | MUI Slider 래퍼 (폼 통합)                                 | [API](./docs/ko/api.md#slider)       |
 | **Stepper**      | 스텝 진행 표시 컴포넌트                                   | [API](./docs/ko/api.md#stepper)      |
 | **Switch**       | MUI Switch 래퍼 (폼 통합)                                 | [API](./docs/ko/api.md#switch)       |
+| **SwitchField**  | 라벨 포함 Switch 필드 (`FormControlLabel` + `Switch`)     | [API](./docs/ko/api.md#switchfield)  |
 | **ToggleButton** | 토글 버튼 컴포넌트                                        | [API](./docs/ko/api.md#togglebutton) |
 
 ## 훅 (Hooks)
@@ -102,6 +103,7 @@ import {
   Checkbox,
   RadioGroup,
   Switch,
+  SwitchField,
   Slider,
   DateRange,
   TextArea,
@@ -252,6 +254,38 @@ import {
 />
 ```
 
+## Boolean 필드 표준 패턴
+
+`Switch`를 boolean 입력의 기본 form-binding 컴포넌트로 사용합니다.
+
+```tsx
+import { Switch, SwitchField } from "@ehfuse/mui-form-controls";
+
+// 1) 단일 스위치 (라벨 없음)
+<Switch form={form} name="deceased_disability_certificate" />
+
+// 2) 라벨 포함 스위치 (권장)
+<SwitchField
+  form={form}
+  name="deceased_disability_certificate"
+  label="장애인 증명서 제출"
+/>
+
+// 3) readOnly / disabled
+<SwitchField
+  form={form}
+  name="deceased_disability_certificate"
+  label="수정 불가 항목"
+  readonly
+/>
+<SwitchField
+  form={form}
+  name="deceased_disability_certificate"
+  label="비활성 항목"
+  disabled
+/>
+```
+
 ## 문서 / Documentation
 
 - [한국어 문서](./docs/ko/getting-started.md)

package/dist/SwitchField.d.ts

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

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export { TextArea } from "./TextArea";
 export { Checkbox } from "./Checkbox";
 export { RadioGroup } from "./RadioGroup";
 export { Switch } from "./Switch";
+export { SwitchField } from "./SwitchField";
 export { Rating } from "./Rating";
 export { ToggleButton } from "./ToggleButton";
 export { ButtonGroup } from "./ButtonGroup";
@@ -37,4 +38,4 @@ 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, TextFieldProps, TextAreaProps, CheckboxProps, SwitchProps, RadioGroupProps, RadioOption, DateRangeProps, SliderProps, RatingProps, ToggleButtonProps, ButtonGroupProps, StepperProps, 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";
+export type { SearchTextFieldProps, ClearTextFieldProps, PasswordTextFieldProps, TextFieldProps, TextAreaProps, CheckboxProps, SwitchProps, SwitchFieldProps, RadioGroupProps, RadioOption, DateRangeProps, SliderProps, RatingProps, ToggleButtonProps, ButtonGroupProps, StepperProps, 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";