@ncds/ui-admin-mcp 1.0.0-alpha.2 → 1.0.0-alpha.20

package/data/range-date-picker-with-buttons.json

@@ -3,7 +3,7 @@
   "exportName": "RangeDatePickerWithButtons",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "input",
+  "category": "forms-and-input",
   "description": "기간 옵션 버튼이 내장된 RangeDatePicker 확장 컴포넌트로 빠른 기간 설정을 지원합니다",
   "aliases": [
     "기간 선택 버튼",
@@ -33,6 +33,25 @@
     "range-date-picker",
     "date-picker"
   ],
+  "usageExamples": {
+    "default": {
+      "startDateOptions": {
+        "currentDate": "2026-03-17"
+      },
+      "endDateOptions": {
+        "currentDate": "2026-03-24"
+      },
+      "currentButtonId": "7DAYS",
+      "periodKeys": [
+        "TODAY",
+        "7DAYS",
+        "1MONTHS",
+        "3MONTHS",
+        "1YEAR",
+        "ENTIRE"
+      ]
+    }
+  },
   "props": {
     "currentButtonId": {
       "type": "string",
@@ -40,9 +59,60 @@
       "rawType": "keyof T & string"
     },
     "endDateOptions": {
-      "type": "string",
+      "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps"
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "portal": {
+          "type": "boolean",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
     },
     "onDateValidation": {
       "type": "function",
@@ -54,7 +124,7 @@
       "rawType": "T | undefined"
     },
     "periodKeys": {
-      "type": "string",
+      "type": "object",
       "required": true,
       "rawType": "(keyof T & string)[]"
     },
@@ -72,9 +142,60 @@
       "default": "xs"
     },
     "startDateOptions": {
-      "type": "string",
+      "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps"
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "portal": {
+          "type": "boolean",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
     },
     "useYesterdayAsEndDate": {
       "type": "boolean",
@@ -83,7 +204,66 @@
     },
     "validationOption": {
       "type": "object",
-      "required": false
+      "required": false,
+      "properties": {
+        "initDate": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "startDate": {
+              "type": "string",
+              "required": false
+            },
+            "endDate": {
+              "type": "string",
+              "required": false
+            }
+          }
+        },
+        "setting": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "unit": {
+              "type": "enum",
+              "required": true,
+              "values": [
+                "M",
+                "Q",
+                "d",
+                "day",
+                "days",
+                "h",
+                "hour",
+                "hours",
+                "m",
+                "millisecond",
+                "milliseconds",
+                "minute",
+                "minutes",
+                "month",
+                "months",
+                "ms",
+                "quarter",
+                "quarters",
+                "s",
+                "second",
+                "seconds",
+                "w",
+                "week",
+                "weeks",
+                "y",
+                "year",
+                "years"
+              ]
+            },
+            "period": {
+              "type": "number",
+              "required": true
+            }
+          }
+        }
+      }
     }
   },
   "html": {},

package/data/range-date-picker.json

@@ -3,7 +3,7 @@
   "exportName": "RangeDatePicker",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "input",
+  "category": "forms-and-input",
   "description": "RangeDatePicker는 시작일~종료일 기간 범위를 선택해야 하는 경우 사용하는 복합 선택 위젯입니다. 검색 기간 설정, 노출 기간 설정, 이벤트 기간 설정 등 두 날짜의 쌍(Pair)이 필요한 모든 상황에서 사용합니다.",
   "aliases": [
     "범위날짜선택",
@@ -43,11 +43,81 @@
     "date-picker",
     "button-group"
   ],
+  "usageExamples": {
+    "default": {
+      "startDateOptions": {
+        "currentDate": "2026-03-01"
+      },
+      "endDateOptions": {
+        "currentDate": "2026-03-24"
+      }
+    },
+    "withSize": {
+      "startDateOptions": {
+        "currentDate": "2026-03-01"
+      },
+      "endDateOptions": {
+        "currentDate": "2026-03-24"
+      },
+      "size": "sm"
+    }
+  },
   "props": {
     "endDateOptions": {
-      "type": "string",
+      "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps"
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "portal": {
+          "type": "boolean",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
     },
     "onDateValidation": {
       "type": "function",
@@ -63,13 +133,123 @@
       "default": "xs"
     },
     "startDateOptions": {
-      "type": "string",
+      "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps"
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "portal": {
+          "type": "boolean",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
     },
     "validationOption": {
       "type": "object",
-      "required": false
+      "required": false,
+      "properties": {
+        "initDate": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "startDate": {
+              "type": "string",
+              "required": false
+            },
+            "endDate": {
+              "type": "string",
+              "required": false
+            }
+          }
+        },
+        "setting": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "unit": {
+              "type": "enum",
+              "required": true,
+              "values": [
+                "M",
+                "Q",
+                "d",
+                "day",
+                "days",
+                "h",
+                "hour",
+                "hours",
+                "m",
+                "millisecond",
+                "milliseconds",
+                "minute",
+                "minutes",
+                "month",
+                "months",
+                "ms",
+                "quarter",
+                "quarters",
+                "s",
+                "second",
+                "seconds",
+                "w",
+                "week",
+                "weeks",
+                "y",
+                "year",
+                "years"
+              ]
+            },
+            "period": {
+              "type": "number",
+              "required": true
+            }
+          }
+        }
+      }
     }
   },
   "html": {},

package/data/select-box.json

@@ -3,7 +3,7 @@
   "exportName": "SelectBox",
   "importPath": "@ncds/ui-admin",
   "jsRequired": true,
-  "category": "input",
+  "category": "forms-and-input",
   "description": "Selectbox는 목록(레이어) 중에서 하나 이상의 항목을 선택하는 입력 컴포넌트로, 선택 가능한 옵션이 3~30개 정도이며 공간 효율이 중요한 경우 사용합니다.",
   "aliases": [
     "셀렉트박스",
@@ -18,32 +18,38 @@
     "placeholder",
     "optionItems",
     "multiple",
+    "maxSelection",
+    "최대 선택 개수",
+    "최대선택",
+    "선택 제한",
     "react-hook-form",
     "NCDS"
   ],
   "hasChildren": true,
   "whenToUse": [
-    "옵션 수 6개 이상 또는 공간 제약 시 사용",
-    "옵션 3~30개인 경우",
-    "테이블 내부 컴팩트 영역에서 옵션 선택 필요",
-    "상태/분류/정렬 단일 선택",
-    "팀 멤버/태그/필터 다중 선택"
+    "Selectbox는 옵션 수 6개 이상 또는 공간 제약 시 사용하며, 옵션 2개(180도 반대)는 Switch, 5개 이하+공간 충분은 Radio/Checkbox를 우선한다",
+    "다중 선택 시 '선택 완료' 버튼 필수",
+    "선택 가능한 옵션이 3~30개인 경우",
+    "화면 공간이 제한되어 Radio/Checkbox를 배치하기 어려운 경우",
+    "테이블 내부 등 컴팩트한 영역에서 옵션 선택이 필요한 경우",
+    "상태/분류/정렬 등 단일 선택이 필요한 경우",
+    "팀 멤버/태그/필터 등 다중 선택이 필요한 경우"
   ],
   "forbiddenRules": [
     "옵션 2개(180도 반대 의미)인데 Selectbox 사용 금지",
-    "옵션 수 5개 이하+공간 충분한데 Selectbox 남용 금지",
+    "옵션 수 5개 이하 & 공간 충분한데 Selectbox 남용 금지",
     "30개 이상 옵션을 일반 Selectbox로만 제공 금지",
-    "다중 선택형에서 선택 완료 없이 즉시 확정 UX 혼용 금지",
-    "말줄임 Chips에 Tooltip 미제공 금지",
+    "다중 선택형에서 '선택 완료' 없이 즉시 확정 UX 혼용 금지",
+    "말줄임 처리된 Chips에 Tooltip 미제공 금지",
     "Read only에서 레이어 열림 동작 제공 금지",
-    "Read only를 Disabled로 대체하여 값 가독성 저하 지양",
+    "Read only를 Disabled로 대체하여 값 가독성을 떨어뜨리는 구성 지양",
     "Disabled 상태에서 Tooltip/설명 없이 클릭 시도 유도 금지"
   ],
   "seeAlso": [
     "radio",
     "checkbox",
     "switch",
-    "input",
+    "input-base",
     "tooltip"
   ],
   "htmlElement": "div",
@@ -90,6 +96,10 @@
       "required": false,
       "default": "DEFAULT_MAX_HEIGHT"
     },
+    "maxSelection": {
+      "type": "number",
+      "required": false
+    },
     "multiple": {
       "type": "boolean",
       "required": false,
@@ -104,9 +114,25 @@
       "required": false
     },
     "optionItems": {
-      "type": "string",
+      "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "properties": {
+        "id": {
+          "type": "string",
+          "required": true,
+          "rawType": "string | number"
+        },
+        "label": {
+          "type": "string",
+          "required": true
+        },
+        "icon": {
+          "type": "function",
+          "required": false,
+          "semantic": "icon-component"
+        }
+      },
       "default": "[]"
     },
     "placeholder": {
@@ -116,7 +142,8 @@
     },
     "register": {
       "type": "object",
-      "required": false
+      "required": false,
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
     },
     "size": {
       "type": "enum",
@@ -137,15 +164,20 @@
       ],
       "default": "default"
     },
+    "usePortal": {
+      "type": "boolean",
+      "required": false
+    },
     "value": {
-      "type": "string",
+      "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
     }
   },
   "html": {},
   "bemClasses": [
     "ncua-hint-text",
+    "ncua-select-dropdown--portal",
     "ncua-selectbox",
     "ncua-selectbox--disabled",
     "ncua-selectbox--multiple",

package/data/select.json

@@ -3,31 +3,19 @@
   "exportName": "Select",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "input",
-  "description": "네이티브 HTML select 래퍼로, 간단한 드롭다운 목록에서 하나의 항목을 선택하는 입력 컴포넌트입니다.",
+  "category": "forms-and-input",
+  "description": "네이티브 HTML select 래퍼입니다. 대부분의 경우 select-box를 사용하세요. 네이티브 select가 명시적으로 필요한 경우에만 사용합니다.",
   "aliases": [
-    "셀렉트",
-    "드롭다운 선택",
-    "목록 선택",
-    "dropdown select",
-    "카테고리",
-    "정렬",
-    "필터",
-    "Select",
-    "SelectBox",
-    "셀렉트박스",
-    "Dropdown",
-    "드롭다운",
-    "옵션선택",
-    "placeholder",
-    "react-hook-form",
-    "Single Select"
+    "네이티브 셀렉트",
+    "native select",
+    "HTML select",
+    "기본 선택",
+    "react-hook-form"
   ],
   "hasChildren": true,
   "whenToUse": [
-    "간단한 목록에서 하나를 선택하는 맥락",
-    "커스텀 드롭다운이 불필요한 단순 선택",
-    "옵션 수 6개 이상이거나 공간이 제한적인 경우"
+    "네이티브 HTML select가 명시적으로 필요한 경우만",
+    "react-hook-form 등 폼 라이브러리와 직접 연동이 필요한 경우"
   ],
   "forbiddenRules": [
     "옵션 2개(반대 의미)이면 Switch 우선",
@@ -52,6 +40,11 @@
       "required": false,
       "default": false
     },
+    "disabled": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
     "disabledPlaceholder": {
       "type": "boolean",
       "required": false,
@@ -62,9 +55,25 @@
       "required": false
     },
     "optionItems": {
-      "type": "string",
+      "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined"
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "properties": {
+        "id": {
+          "type": "string",
+          "required": true,
+          "rawType": "string | number"
+        },
+        "label": {
+          "type": "string",
+          "required": true
+        },
+        "icon": {
+          "type": "function",
+          "required": false,
+          "semantic": "icon-component"
+        }
+      }
     },
     "placeholder": {
       "type": "string",
@@ -72,7 +81,8 @@
     },
     "register": {
       "type": "object",
-      "required": false
+      "required": false,
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
     },
     "size": {
       "type": "enum",
@@ -82,7 +92,7 @@
         "sm",
         "xs"
       ],
-      "default": "md"
+      "default": "xs"
     },
     "type": {
       "type": "enum",