@ncds/ui-admin-mcp 1.0.0-alpha.16 → 1.0.0-alpha.17

package/data/modal.json

@@ -31,13 +31,16 @@
     "NCDS"
   ],
   "hasChildren": true,
-  "whenToUse": [],
+  "whenToUse": [
+    "Modal은 현재 흐름을 중단하고 사용자 집중을 요구하는 UI 패턴입니다",
+    "단순 알림이나 페이지 이동 대체용으로 남용해서는 안 되며, 정보 확인/입력/처리성 작업에만 한정하여 사용합니다"
+  ],
   "forbiddenRules": [
     "단순 알림에 과도한 Modal 사용 금지",
     "버튼 3개 이상 구성 금지",
     "페이지 이동 대체용 사용 금지",
     "화면 전환을 모두 Modal로 처리 금지",
-    "좌/우 스크롤 구조 금지",
+    "좌/우 스크롤 구조 금지 (Modal Content 자체)",
     "배경 스크롤 허용 금지"
   ],
   "seeAlso": [
@@ -208,7 +211,7 @@
         "featuredIcon": {
           "type": "object",
           "required": false,
-          "rawType": "{ icon: import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SlotIconComponent; color: import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconColor; theme: import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconTheme; } | undefined",
+          "rawType": "{ icon: import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SlotIconComponent; color: import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconColor; theme: import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconTheme; } | undefined",
           "properties": {
             "icon": {
               "type": "function",

package/data/notification.json

@@ -26,22 +26,26 @@
     "NCDS"
   ],
   "hasChildren": false,
-  "whenToUse": [],
+  "whenToUse": [
+    "Notification은 비차단(non-blocking) 알림 UI 컴포넌트이다",
+    "4가지 type(floating, full-width, message, callout)별 시각 토큰과 구현 규격을 정의한다"
+  ],
   "forbiddenRules": [
     "Toast에 Dim 처리 금지",
-    "Message type에 info 컬러 사용 금지"
+    "Message · floating type에 info 컬러 사용 금지"
   ],
   "seeAlso": [
+    "modal",
+    "button",
     "featured-icon",
-    "icon",
-    "modal"
+    "icon"
   ],
   "htmlElement": "div",
   "props": {
     "actions": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
       "properties": {
         "label": {
           "type": "string",

package/data/number-input.json

@@ -34,7 +34,7 @@
     "Leading/Trailing 혼합 사용 금지"
   ],
   "seeAlso": [
-    "input",
+    "input-base",
     "slider",
     "tooltip",
     "label"

package/data/page-title.json

@@ -0,0 +1,135 @@
+{
+  "name": "page-title",
+  "exportName": "PageTitle",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "layout",
+  "description": "PageTitle은 페이지 최상단에 위치하며, 현재 페이지의 위치·목적·핵심 액션을 정의하는 영역입니다.",
+  "aliases": [
+    "PageTitle",
+    "Page Header",
+    "Page Title",
+    "페이지 타이틀",
+    "페이지 헤더",
+    "BreadCrumb",
+    "Back Button",
+    "Title",
+    "Action",
+    "Fixed Header",
+    "Tab Wrapper",
+    "탭 래퍼",
+    "페이지 탭",
+    "페이지 레벨 탭",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "PageTitle은 페이지의 목적과 위치를 한눈에 전달하고, 핵심 액션의 진입점이 되는 영역이다",
+    "일반 목록/설정 페이지",
+    "상세 조회/수정 페이지",
+    "스크롤 시 상단 고정",
+    "Block Header와 혼동 시"
+  ],
+  "forbiddenRules": [
+    "PageTitle에 Primary 버튼 2개 이상 배치 금지",
+    "PageTitle 배경색 변경 금지",
+    "Title에 두 줄 이상의 긴 텍스트 지양",
+    "Fixed Variant에서 BreadCrumb 노출 금지",
+    "Block Header와 PageTitle 스타일 혼용 금지",
+    "Back Button을 일반 페이지(Default)에서 사용 금지",
+    "Guide Button의 스타일 변경 금지",
+    "PageTitle 영역에 Form 요소 배치 금지",
+    "BreadCrumb 구분자에 텍스트 문자(`>`) 사용 금지",
+    "Action Button을 Title Row/Title Container 안에 배치 금지",
+    "NCDS 외부 아이콘 사용 금지",
+    "Default ↔ Fixed 전환 미구현 금지"
+  ],
+  "seeAlso": [
+    "bread-crumb",
+    "button",
+    "block-header",
+    "block-container",
+    "horizontal-tab"
+  ],
+  "htmlElement": "header",
+  "props": {
+    "breadcrumbItems": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/layout/page-title/PageTitle\").PageTitleBreadcrumbItem[] | undefined",
+      "properties": {
+        "label": {
+          "type": "string",
+          "required": true
+        },
+        "href": {
+          "type": "string",
+          "required": false
+        }
+      }
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "guideButton": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "onBack": {
+      "type": "function",
+      "required": false
+    },
+    "primaryAction": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "secondaryAction": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "title": {
+      "type": "string",
+      "required": true
+    },
+    "variant": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "default",
+        "detail",
+        "fixed",
+        "fixed-detail"
+      ],
+      "default": "default"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-page-title",
+    "ncua-page-title--fixed",
+    "ncua-page-title__actions",
+    "ncua-page-title__back-btn",
+    "ncua-page-title__breadcrumb",
+    "ncua-page-title__breadcrumb-current",
+    "ncua-page-title__breadcrumb-item",
+    "ncua-page-title__breadcrumb-separator",
+    "ncua-page-title__container",
+    "ncua-page-title__guide-btn",
+    "ncua-page-title__header",
+    "ncua-page-title__header--has-breadcrumb",
+    "ncua-page-title__page-header",
+    "ncua-page-title__title",
+    "ncua-page-title__title-row"
+  ],
+  "usage": {
+    "import": "import { PageTitle } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<PageTitle title=\"\" />",
+      "variant:default": "<PageTitle variant=\"default\" title=\"\" />",
+      "variant:detail": "<PageTitle variant=\"detail\" title=\"\" />",
+      "variant:fixed": "<PageTitle variant=\"fixed\" title=\"\" />",
+      "variant:fixed-detail": "<PageTitle variant=\"fixed-detail\" title=\"\" />"
+    }
+  }
+}

package/data/pagination.json

@@ -23,9 +23,12 @@
   ],
   "hasChildren": false,
   "whenToUse": [
-    "대량 데이터를 페이지 단위로 분할하여 순차적으로 탐색",
-    "20개 이상 데이터가 누적될 가능성이 있는 경우 필수 적용",
-    "10페이지 단위 그룹 이동과 첫/마지막 페이지 점프 지원"
+    "Pagination은 대량 데이터를 페이지 단위로 분할하여 순차적으로 탐색할 수 있게 하는 내비게이션입니다",
+    "20개 이상 데이터가 누적될 가능성이 있는 경우 필수 적용하며, 10페이지 단위 그룹 이동과 첫/마지막 페이지 점프를 지원합니다",
+    "20개 이상 데이터 누적 가능성",
+    "가로형 테이블",
+    "리스트 구조",
+    "검색 결과 목록"
   ],
   "forbiddenRules": [
     "10페이지 이하에서 이동 버튼 노출 금지",
@@ -34,7 +37,8 @@
     "세로형 테이블에서 사용 금지"
   ],
   "seeAlso": [
-    "table"
+    "table",
+    "select"
   ],
   "htmlElement": "button",
   "props": {

package/data/password-input.json

@@ -4,20 +4,30 @@
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
   "category": "forms-and-input",
-  "description": "비밀번호 전용 입력 필드로 마스킹 토글을 내장합니다",
+  "description": "Input은 사용자에게 텍스트 데이터를 입력받는 UI 요소로, 다양한 사이즈와 상태를 지원하며 입력 필드 앞뒤로 아이콘, 텍스트, 버튼 등의 요소를 배치할 수 있습니다.",
   "aliases": [
-    "비밀번호",
-    "비밀번호 입력",
-    "password",
-    "패스워드",
+    "인풋",
+    "Input",
+    "InputBase",
     "PasswordInput",
-    "비밀번호 변경",
-    "비밀번호 확인"
+    "텍스트입력",
+    "비밀번호",
+    "이메일",
+    "드롭다운",
+    "리딩텍스트",
+    "트레일링버튼",
+    "clearText",
+    "showTextCount",
+    "maxLength",
+    "leadingElement",
+    "trailingElement",
+    "validation",
+    "destructive",
+    "NCDS"
   ],
   "hasChildren": false,
   "whenToUse": [
-    "명확한 레이블과 입력 예시 Placeholder 및 유효성 안내 Helper Text와 함께 제공되어야 하는 경우",
-    "사용자가 입력 가능한 형식과 제한 조건을 입력 전에 인지할 수 있어야 하는 경우"
+    "Input은 명확한 레이블, 입력 예시(Placeholder), 유효성 안내(Helper Text)와 함께 제공되어야 하며, 사용자가 입력 가능한 형식과 제한 조건을 입력 전에 인지할 수 있어야 한다"
   ],
   "forbiddenRules": [
     "Label 없는 단독 Input 사용 금지",
@@ -27,7 +37,12 @@
     "Error 상태를 실시간 남용 금지"
   ],
   "seeAlso": [
-    "input"
+    "textarea",
+    "button",
+    "dropdown",
+    "tooltip",
+    "file-input",
+    "image-file-input"
   ],
   "props": {
     "clearText": {

package/data/progress-bar.json

@@ -23,19 +23,20 @@
   ],
   "hasChildren": false,
   "whenToUse": [
-    "진행 상태를 직관적인 막대 형태로 시각화",
-    "단일 값 표시뿐 아니라 다중 세그먼트를 통해 항목별 비율 분포도 표현"
+    "ProgressBar는 진행 상태를 직관적인 막대 형태로 시각화하여 사용자가 작업의 현재 상태와 남은 정도를 즉시 파악할 수 있도록 합니다",
+    "단일 값 표시뿐 아니라 다중 세그먼트를 통해 항목별 비율 분포도 표현할 수 있습니다"
   ],
   "forbiddenRules": [
-    "0-100 범위 이탈 금지",
-    "불확정 진행률에 사용 금지(Spinner 사용)",
+    "0–100 범위 이탈 금지",
+    "불확정 진행률에 사용 금지",
     "white/black 세그먼트 색상 금지",
     "세그먼트 최대 3개 제한",
     "장식 용도 금지"
   ],
   "seeAlso": [
     "progress-circle",
-    "spinner"
+    "spinner",
+    "skeleton"
   ],
   "props": {
     "label": {
@@ -51,7 +52,7 @@
     "segments": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/feedback-and-status/progress-bar/types\").ProgressSegment[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/feedback-and-status/progress-bar/types\").ProgressSegment[] | undefined",
       "properties": {
         "value": {
           "type": "number",

package/data/progress-circle.json

@@ -22,20 +22,23 @@
   ],
   "hasChildren": false,
   "whenToUse": [
-    "시간 예측이 어려운 장시간 진행 작업의 진행률을 원형 그래프로 시각화",
-    "Overlay(Dim Layer)와 함께 사용되어 작업 중 사용자 인터랙션을 차단하고 이탈 불안감을 최소화"
+    "ProgressCircle은 시간 예측이 어려운 장시간 진행 작업의 진행률을 원형 그래프로 시각화하여 사용자에게 현재 상태와 남은 정도를 즉시 파악할 수 있도록 합니다",
+    "Overlay(Dim Layer)와 함께 사용되어 작업 중 사용자 인터랙션을 차단하고, 이탈 불안감을 최소화합니다"
   ],
   "forbiddenRules": [
     "% 없는 진행 Circle 금지",
     "100% 초과 값 표시 금지",
     "값 점프형 급격 변화 지양",
-    "완료 즉시 사라짐 금지(0.5~1초 유지)",
-    "불확정 진행률에 사용 금지(Spinner 사용)",
+    "완료 즉시 사라짐 금지",
+    "불확정 진행률에 사용 금지",
     "단순 대기(3초 이내)에 사용 금지"
   ],
   "seeAlso": [
     "progress-bar",
-    "spinner"
+    "spinner",
+    "skeleton",
+    "toast",
+    "alert"
   ],
   "props": {
     "label": {

package/data/radio.json

@@ -4,7 +4,7 @@
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
   "category": "forms-and-input",
-  "description": "Radio는 여러 옵션 중 하나만 선택할 수 있는 단일 선택(Single Selection) 컨트롤로, 텍스트 라벨과 보조 설명을 함께 제공할 수 있습니다.",
+  "description": "Radio는 여러 옵션 중 하나만 선택할 수 있는 단일 선택(Single Selection) 컨트롤로, 텍스트 레이블과 보조 설명을 함께 제공할 수 있습니다.",
   "aliases": [
     "라디오",
     "Radio",
@@ -26,7 +26,7 @@
   "forbiddenRules": [
     "Radio 단독 사용 금지",
     "기본 선택 없이 사용 지양",
-    "텍스트 라벨 없이 사용 지양",
+    "텍스트 레이블 없이 사용 지양",
     "Checkbox와 혼동 금지",
     "선택 해제 동작 구현 금지"
   ],
@@ -34,6 +34,7 @@
     "checkbox",
     "toggle",
     "select",
+    "dropdown",
     "label"
   ],
   "htmlElement": "input",

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

@@ -61,7 +61,7 @@
     "endDateOptions": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
       "properties": {
         "size": {
           "type": "enum",
@@ -82,7 +82,7 @@
         "datePickerOptions": {
           "type": "object",
           "required": false,
-          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",
@@ -144,7 +144,7 @@
     "startDateOptions": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
       "properties": {
         "size": {
           "type": "enum",
@@ -165,7 +165,7 @@
         "datePickerOptions": {
           "type": "object",
           "required": false,
-          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",

package/data/range-date-picker.json

@@ -66,7 +66,7 @@
     "endDateOptions": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
       "properties": {
         "size": {
           "type": "enum",
@@ -87,7 +87,7 @@
         "datePickerOptions": {
           "type": "object",
           "required": false,
-          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",
@@ -135,7 +135,7 @@
     "startDateOptions": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
       "properties": {
         "size": {
           "type": "enum",
@@ -156,7 +156,7 @@
         "datePickerOptions": {
           "type": "object",
           "required": false,
-          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",

package/data/select-box.json

@@ -23,27 +23,29 @@
   ],
   "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",
@@ -106,7 +108,7 @@
     "optionItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
       "properties": {
         "id": {
           "type": "string",
@@ -133,7 +135,7 @@
     "register": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
+      "rawType": "import(\"/Users/nhn/Project/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",
@@ -157,7 +159,7 @@
     "value": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
     }
   },
   "html": {},

package/data/select.json

@@ -57,7 +57,7 @@
     "optionItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
       "properties": {
         "id": {
           "type": "string",
@@ -82,7 +82,7 @@
     "register": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
+      "rawType": "import(\"/Users/nhn/Project/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",

package/data/table.json

@@ -36,24 +36,44 @@
     "colSpan",
     "widths",
     "Pagination",
-    "NCDS"
+    "NCDS",
+    "가로스크롤",
+    "horizontal scroll",
+    "scrollX",
+    "overflow-x",
+    "column min-width",
+    "셀 최소 너비",
+    "셀 최소 글자수",
+    "1140",
+    "table min-width",
+    "줄바꿈",
+    "word-break",
+    "콘텐츠 타입별 차등",
+    "2단 wrapper",
+    "Portal",
+    "Floating UI",
+    "스크롤 컨테이너",
+    "scrollbar token"
   ],
   "hasChildren": true,
-  "whenToUse": [],
+  "whenToUse": [
+    "Table은 데이터를 일관된 구조로 전달하고, 정렬·선택·페이지네이션을 통해 효율적인 데이터 탐색을 지원하는 컴포넌트이다"
+  ],
   "forbiddenRules": [
     "컬러 토큰 외 임의 색상 사용 금지",
     "Row Height 임의 수정 금지",
     "텍스트 정렬 규칙 무시 금지",
     "프로젝트별 Padding 임의 변경 금지",
-    "정렬 아이콘 위치 변경 금지",
-    "Vertical Table을 Block에 배치 시 Block Body padding 0 override 금지",
-    "Vertical Table을 Block에 배치 시 Table [outer] 래퍼 생략 금지"
+    "정렬 아이콘 위치 변경 금지"
   ],
   "seeAlso": [
     "checkbox",
     "pagination",
     "badge",
-    "empty-state"
+    "empty-state",
+    "button",
+    "spinner",
+    "block-container"
   ],
   "htmlElement": "div",
   "props": {

package/data/tag.json

@@ -24,19 +24,22 @@
   ],
   "hasChildren": true,
   "whenToUse": [
-    "정보 분류와 필터링을 위한 시각적 라벨",
-    "사용자가 콘텐츠를 빠르게 분류/식별/필터링할 수 있도록 지원"
+    "Tag는 정보 분류와 필터링을 위한 시각적 레이블로, 사용자가 콘텐츠를 빠르게 분류·식별·필터링할 수 있도록 합니다",
+    "작고 간결한 형태로 다양한 컨텍스트에서 사용되며, 아이콘·액션을 통해 의미를 전달합니다"
   ],
   "forbiddenRules": [
     "disabled 태그에 액션 제공 금지",
     "과도한 태그 나열 금지",
-    "텍스트 없는 태그 사용 금지"
+    "텍스트 없는 태그 사용 금지",
+    "상태·중요도 표시에 Tag 사용 금지"
   ],
   "seeAlso": [
     "badge",
     "badge-group",
     "checkbox",
-    "dot"
+    "icon",
+    "dot",
+    "tooltip"
   ],
   "props": {
     "children": {
@@ -54,7 +57,7 @@
     "icon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",