@uniai-fe/uds-primitives 0.3.27 → 0.3.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/uds-primitives",
-  "version": "0.3.27",
+  "version": "0.3.28",
   "description": "UNIAI Design System; Primitives Components Package",
   "type": "module",
   "private": false,

package/src/components/select/types/props.ts

@@ -336,9 +336,9 @@ export type SelectProps = SelectStyleOptions &
  * @property {boolean} [readOnly] readOnly 여부
  * @property {SelectTriggerButtonType} [buttonType] button type
  * @property {FormFieldWidth} [width] width preset 옵션
- * @property {SelectDropdownOption<OptionData, DataOptionality>[]} [items] dropdown item 리스트
- * @property {SelectCallbackParams<OptionData, DataOptionality>} [onSelectOption] option 선택 액션 콜백
- * @property {SelectCallbackParams<OptionData, DataOptionality>} [onSelectChange] 선택값 변경 콜백
+ * @property {SelectDropdownOption<OptionData>[]} [items] dropdown item 리스트
+ * @property {SelectCallbackParams<OptionData>} [onSelectOption] option 선택 액션 콜백
+ * @property {SelectCallbackParams<OptionData>} [onSelectChange] 선택값 변경 콜백
  * @property {SelectDropdownExtension} [dropdown] dropdown 확장 옵션
  * @property {boolean} [open] dropdown open 상태
  * @property {boolean} [defaultOpen] uncontrolled 초기 open 상태
@@ -349,25 +349,18 @@ export type SelectProps = SelectStyleOptions &
  * @property {UseFormRegisterReturn} [register] source field register
  * @property {UseFormRegisterReturn} [customRegister] custom field register
  * @example
- * type DefaultOptional = SelectDefaultComponentProps<
- *   { metaKey: number },
- *   "optional"
- * >;
- * type DefaultRequired = SelectDefaultComponentProps<
- *   { metaKey: number },
- *   "required"
- * >;
+ * type DefaultProps = SelectDefaultComponentProps<{ metaKey: number }>;
+ * type RequiredChange = SelectCallbackParams<{ metaKey: number }, "required">;
+ * // optionality 제어는 콜백/옵션 타입에서 필요할 때만 명시적으로 사용한다.
  */
-export type SelectDefaultComponentProps<
-  OptionData = unknown,
-  DataOptionality extends SelectOptionDataOptionality = "optional",
-> = SelectTriggerDefaultProps &
-  SelectDropdownConfigProps<OptionData, DataOptionality> &
-  SelectDropdownBehaviorProps &
-  SelectWidthOption &
-  SelectTriggerEventProps &
-  SelectCustomOptionExtension &
-  SelectFormRegisterExtension;
+export type SelectDefaultComponentProps<OptionData = unknown> =
+  SelectTriggerDefaultProps &
+    SelectDropdownConfigProps<OptionData> &
+    SelectDropdownBehaviorProps &
+    SelectWidthOption &
+    SelectTriggerEventProps &
+    SelectCustomOptionExtension &
+    SelectFormRegisterExtension;
 
 /**
  * Select.Multiple 전체 선택 옵션 props
@@ -398,9 +391,9 @@ export interface SelectMultipleAllOptionProps {
  * @property {boolean} [disabled] disabled 여부
  * @property {boolean} [readOnly] readOnly 여부
  * @property {FormFieldWidth} [width] width preset 옵션
- * @property {SelectDropdownOption<OptionData, DataOptionality>[]} [items] dropdown item 리스트
- * @property {SelectCallbackParams<OptionData, DataOptionality>} [onSelectOption] option 선택 액션 콜백
- * @property {SelectCallbackParams<OptionData, DataOptionality>} [onSelectChange] 선택값 변경 콜백
+ * @property {SelectDropdownOption<OptionData>[]} [items] dropdown item 리스트
+ * @property {SelectCallbackParams<OptionData>} [onSelectOption] option 선택 액션 콜백
+ * @property {SelectCallbackParams<OptionData>} [onSelectChange] 선택값 변경 콜백
  * @property {SelectDropdownExtension} [dropdown] dropdown 확장 옵션
  * @property {boolean} [open] dropdown open 상태
  * @property {boolean} [defaultOpen] uncontrolled 초기 open 상태
@@ -409,17 +402,14 @@ export interface SelectMultipleAllOptionProps {
  * @property {boolean} [showSelectAllOption] dropdown 첫 행에 "전체" 옵션 노출 여부
  * @property {ReactNode} [selectAllLabel] "전체" 옵션 라벨 커스터마이징
  * @example
- * type MultipleRequired = SelectMultipleComponentProps<
- *   { metaKey: number },
- *   "required"
- * >;
+ * type MultipleProps = SelectMultipleComponentProps<{ metaKey: number }>;
+ * type RequiredChange = SelectCallbackParams<{ metaKey: number }, "required">;
+ * // optionality 제어는 콜백/옵션 타입에서 필요할 때만 명시적으로 사용한다.
  */
-export type SelectMultipleComponentProps<
-  OptionData = unknown,
-  DataOptionality extends SelectOptionDataOptionality = "optional",
-> = SelectTriggerMultipleProps &
-  SelectDropdownConfigProps<OptionData, DataOptionality> &
-  SelectDropdownBehaviorProps &
-  SelectWidthOption &
-  SelectMultipleAllOptionProps &
-  SelectTriggerEventProps;
+export type SelectMultipleComponentProps<OptionData = unknown> =
+  SelectTriggerMultipleProps &
+    SelectDropdownConfigProps<OptionData> &
+    SelectDropdownBehaviorProps &
+    SelectWidthOption &
+    SelectMultipleAllOptionProps &
+    SelectTriggerEventProps;