@ehfuse/mui-form-controls 1.3.20 → 1.3.21

package/README.md

@@ -44,6 +44,7 @@ MUI 기반 폼 컨트롤과 텍스트 필드 컴포넌트 모음
 | **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)
 
@@ -93,6 +94,7 @@ import {
   TextField,
   Rating,
   ToggleButton,
+  ToggleButtonGroupField,
   ButtonGroup,
   Stepper,
   NumberField,
@@ -286,6 +288,25 @@ import { Switch, SwitchField } from "@ehfuse/mui-form-controls";
 />
 ```
 
+## 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/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

@@ -16,6 +16,7 @@ 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";
@@ -38,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, 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, 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";