@uniai-fe/uds-primitives 0.12.12 → 0.12.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/uds-primitives",
-  "version": "0.12.12",
+  "version": "0.12.14",
   "description": "UNIAI Design System; Primitives Components Package",
   "type": "module",
   "private": false,
@@ -88,10 +88,10 @@
     "sass": "^1.102.0",
     "typescript": "6.0.3",
     "@uniai-fe/eslint-config": "0.4.4",
-    "@uniai-fe/util-functions": "0.4.3",
-    "@uniai-fe/tsconfig": "0.2.0",
     "@uniai-fe/next-devkit": "0.4.1",
-    "@uniai-fe/uds-foundation": "0.6.0"
+    "@uniai-fe/tsconfig": "0.2.0",
+    "@uniai-fe/uds-foundation": "0.6.0",
+    "@uniai-fe/util-functions": "0.4.3"
   },
   "scripts": {
     "check:pre-commit": "pnpm --dir ../../.. run check:pre-commit",

package/src/components/select/markup/Default.tsx

@@ -187,6 +187,13 @@ export function SelectDefault<OptionData = unknown>({
   const shouldForceCustomFromInput = Boolean(
     customOptions && !selectedOption && forcedCustomLabelValue,
   );
+  // 명시된 외부 선택을 우선하고, 복원된 직접입력은 값을 비워도 입력창과 포커스를 유지한다.
+  if (shouldForceCustomFromInput && selectedValueFromItems === undefined) {
+    setSelectionState(previousState => ({
+      ...previousState,
+      selectedValue: SELECT_CUSTOM_OPTION_VALUE,
+    }));
+  }
   const resolvedSelectedOption = useMemo(
     () =>
       shouldForceCustomFromInput
@@ -319,11 +326,10 @@ export function SelectDefault<OptionData = unknown>({
     setOpen(false);
   };
 
-  // 16) label input 값은 custom mode에서만 사용자 입력값/controlled inputProps.value를 사용한다.
+  // 16) 명시된 native value는 빈 문자열과 0도 controlled 값으로 사용하고, undefined일 때만 내부 입력값을 유지한다.
   const labelInputValue = isCustomInputActive
-    ? typeof inputProps?.value === "string" ||
-      typeof inputProps?.value === "number"
-      ? String(inputProps.value) || customInputState.value
+    ? inputProps?.value !== undefined
+      ? String(inputProps.value)
       : customInputState.value
     : toSelectInputText(resolvedDisplayLabel);
 

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

@@ -144,9 +144,18 @@ export interface SelectCustomOptions {
 
 /**
  * Select custom input props
- * @property {ComponentPropsWithoutRef<"input">} [native] label input native 속성
+ * @property {string | number | readonly string[]} [value] 빈 문자열과 0을 포함한 controlled 표시값; undefined면 내부 입력값 유지
+ * @property {never} [placeholder] customOptions.placeholder를 사용하므로 전달 불가
+ * @desc label input native 속성에서 placeholder를 제외한 직접입력 계약
  */
 export interface SelectCustomInputProps extends ComponentPropsWithoutRef<"input"> {
+  /**
+   * 빈 문자열과 0을 포함한 controlled 표시값; undefined면 내부 입력값 유지
+   */
+  value?: string | number | readonly string[];
+  /**
+   * customOptions.placeholder를 사용하므로 전달 불가
+   */
   placeholder?: never;
 }