@ehfuse/mui-form-controls 1.3.20 → 2.0.0

package/README.md

@@ -42,8 +42,8 @@ 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) |
+| **ToggleButtonGroup** | 옵션 기반 토글 그룹 필드 (`ToggleButtonGroup` + form 바인딩) | [API](./docs/ko/api.md#togglebuttongroup) |
 
 ## 훅 (Hooks)
 
@@ -93,6 +93,7 @@ import {
   TextField,
   Rating,
   ToggleButton,
+  ToggleButtonGroup,
   ButtonGroup,
   Stepper,
   NumberField,
@@ -103,7 +104,7 @@ import {
   Checkbox,
   RadioGroup,
   Switch,
-  SwitchField,
+  ToggleButtonGroup,
   Slider,
   DateRange,
   TextArea,
@@ -259,26 +260,26 @@ import {
 `Switch`를 boolean 입력의 기본 form-binding 컴포넌트로 사용합니다.
 
 ```tsx
-import { Switch, SwitchField } from "@ehfuse/mui-form-controls";
+import { Switch } from "@ehfuse/mui-form-controls";
 
 // 1) 단일 스위치 (라벨 없음)
 <Switch form={form} name="deceased_disability_certificate" />
 
 // 2) 라벨 포함 스위치 (권장)
-<SwitchField
+<Switch
   form={form}
   name="deceased_disability_certificate"
   label="장애인 증명서 제출"
 />
 
 // 3) readOnly / disabled
-<SwitchField
+<Switch
   form={form}
   name="deceased_disability_certificate"
   label="수정 불가 항목"
   readonly
 />
-<SwitchField
+<Switch
   form={form}
   name="deceased_disability_certificate"
   label="비활성 항목"
@@ -286,6 +287,25 @@ import { Switch, SwitchField } from "@ehfuse/mui-form-controls";
 />
 ```
 
+## Toggle 그룹 표준 패턴
+
+```tsx
+import { ToggleButtonGroup } from "@ehfuse/mui-form-controls";
+
+<ToggleButtonGroup
+  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/ToggleButtonGroup.d.ts

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

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,9 +13,9 @@ 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 { ToggleButtonGroup } from "./ToggleButtonGroup";
 export { ButtonGroup } from "./ButtonGroup";
 export { DateRange } from "./DateRange";
 export { Slider } from "./Slider";
@@ -38,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, 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";
+export type { SearchTextFieldProps, ClearTextFieldProps, PasswordTextFieldProps, TextFieldProps, TextAreaProps, CheckboxProps, SwitchProps, RadioGroupProps, RadioOption, DateRangeProps, SliderProps, RatingProps, ToggleButtonProps, ToggleButtonGroupProps, ToggleButtonGroupOption, 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";