@ehfuse/mui-form-controls 1.3.19 → 1.3.21

package/README.md

@@ -42,7 +42,9 @@ 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) |
+| **ToggleButtonGroupField** | 옵션 기반 토글 그룹 필드 (`ToggleButtonGroup` + form 바인딩) | [API](./docs/ko/api.md#togglebuttongroupfield) |
 
 ## 훅 (Hooks)
 
@@ -92,6 +94,7 @@ import {
   TextField,
   Rating,
   ToggleButton,
+  ToggleButtonGroupField,
   ButtonGroup,
   Stepper,
   NumberField,
@@ -102,6 +105,7 @@ import {
   Checkbox,
   RadioGroup,
   Switch,
+  SwitchField,
   Slider,
   DateRange,
   TextArea,
@@ -252,6 +256,57 @@ 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
+/>
+```
+
+## Toggle 그룹 표준 패턴
+
+```tsx
+import { ToggleButtonGroupField } from "@ehfuse/mui-form-controls";
+
+<ToggleButtonGroupField
+  form={form}
+  name="contractor_gender"
+  exclusive
+  options={[
+    { label: "남성", value: "M" },
+    { label: "여성", value: "F" },
+  ]}
+  onDeselect="clear"
+  fullWidth
+  size="small"
+/>
+```
+
 ## 문서 / 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/ToggleButtonGroupField.d.ts

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

package/dist/index.d.ts

@@ -13,8 +13,10 @@ 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 { ToggleButtonGroupField } from "./ToggleButtonGroupField";
 export { ButtonGroup } from "./ButtonGroup";
 export { DateRange } from "./DateRange";
 export { Slider } from "./Slider";
@@ -37,4 +39,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, ToggleButtonGroupFieldProps, ToggleButtonGroupFieldOption, 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";