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

package/data/block-header.json

@@ -0,0 +1,208 @@
+{
+  "name": "block-header",
+  "exportName": "BlockHeader",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "layout",
+  "description": "Block Header는 Block의 최상단에 위치하며, 블록의 목적과 실행 범위를 정의하는 영역입니다.",
+  "aliases": [
+    "Block Header",
+    "BlockHeader",
+    "블록헤더",
+    "Section Header",
+    "Title",
+    "Tooltip",
+    "Action",
+    "Tab",
+    "Collapsible",
+    "Grid Control",
+    "Sub Title",
+    "Required Notice",
+    "필수 안내",
+    "Divider",
+    "NCDS"
+  ],
+  "hasChildren": true,
+  "whenToUse": [
+    "Block Header는 블록의 목적을 한눈에 전달하는 영역이다"
+  ],
+  "forbiddenRules": [
+    "Header에 두 줄 이상의 긴 설명 지양",
+    "Header Action에 `hierarchy=\"secondary-gray\" size=\"xs\"` 외 사용 금지",
+    "Header 내부에서 아이콘 남발 금지",
+    "Header 배경색 변경 금지",
+    "페이지 단위 탭과 블록 탭 혼용 금지",
+    "Grid Control을 별도 Block으로 분리 금지",
+    "필수 마커 없는 블록에 Required Notice 표시 금지",
+    "Required Notice 고정 문구 임의 변경 금지",
+    "Required Notice 2색 구성 임의 변경 금지"
+  ],
+  "seeAlso": [
+    "block-container",
+    "tooltip",
+    "tab",
+    "badge",
+    "radio-group",
+    "button",
+    "vertical-table"
+  ],
+  "htmlElement": "div",
+  "usageExamples": {
+    "basic": {
+      "title": "상품 기본 정보"
+    },
+    "withTooltip": {
+      "title": "배송 설정",
+      "tooltip": "배송 방법과 기본 설정을 입력하세요."
+    },
+    "withRequiredNotice": {
+      "title": "상품 기본 정보",
+      "showRequiredNotice": true
+    },
+    "collapsible": {
+      "title": "고급 설정",
+      "collapsible": {
+        "expanded": false,
+        "onToggle": "() => {}"
+      }
+    }
+  },
+  "props": {
+    "action": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "badge": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "children": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "collapsible": {
+      "type": "function",
+      "required": false
+    },
+    "controlStrip": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "description": {
+      "type": "string",
+      "required": false
+    },
+    "showDivider": {
+      "type": "boolean",
+      "required": false,
+      "default": true
+    },
+    "showRequiredNotice": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "title": {
+      "type": "ReactNode",
+      "required": true
+    },
+    "tooltip": {
+      "type": "string",
+      "required": false
+    }
+  },
+  "subComponents": {
+    "BlockHeader.SubTitle": {
+      "props": {
+        "action": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "description": {
+          "type": "string",
+          "required": false
+        },
+        "error": {
+          "type": "string",
+          "required": false
+        },
+        "required": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "showDivider": {
+          "type": "boolean",
+          "required": false,
+          "default": true
+        },
+        "showRequiredNotice": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "middle",
+            "sm",
+            "xs"
+          ],
+          "default": "sm"
+        },
+        "title": {
+          "type": "ReactNode",
+          "required": true
+        },
+        "tooltip": {
+          "type": "string",
+          "required": false
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-block-header",
+    "ncua-block-header--column",
+    "ncua-block-header--has-control-strip",
+    "ncua-block-header--has-tab",
+    "ncua-block-header--is-required",
+    "ncua-block-header--no-divider",
+    "ncua-block-header__action-area",
+    "ncua-block-header__badge",
+    "ncua-block-header__collapsible-btn",
+    "ncua-block-header__control-strip",
+    "ncua-block-header__description",
+    "ncua-block-header__required-notice",
+    "ncua-block-header__required-notice--gray",
+    "ncua-block-header__required-notice--red",
+    "ncua-block-header__row",
+    "ncua-block-header__tabs",
+    "ncua-block-header__title",
+    "ncua-block-header__title-area",
+    "ncua-sub-title",
+    "ncua-sub-title__action",
+    "ncua-sub-title__description",
+    "ncua-sub-title__error",
+    "ncua-sub-title__required-marker",
+    "ncua-sub-title__title",
+    "ncua-sub-title__title-area",
+    "ncua-sub-title__title-row"
+  ],
+  "usage": {
+    "import": "import { BlockHeader } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<BlockHeader title=\"예시\" />"
+    }
+  }
+}

package/data/bread-crumb.json

@@ -33,7 +33,43 @@
   "seeAlso": [
     "icon"
   ],
-  "props": {},
+  "usageExamples": {
+    "default": {
+      "items": [
+        {
+          "label": "대시보드"
+        },
+        {
+          "label": "상품",
+          "href": "/products"
+        },
+        {
+          "label": "상품 상세"
+        }
+      ]
+    }
+  },
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "items": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/navigation/bread-crumb/BreadCrumb\").BreadcrumbItemProps[]",
+      "properties": {
+        "href": {
+          "type": "string",
+          "required": false
+        },
+        "label": {
+          "type": "string",
+          "required": true
+        }
+      }
+    }
+  },
   "html": {},
   "bemClasses": [
     "ncua-breadcrumb",
@@ -45,7 +81,7 @@
   "usage": {
     "import": "import { BreadCrumb } from '@ncds/ui-admin';",
     "react": {
-      "default": "<BreadCrumb />"
+      "default": "<BreadCrumb items=\"\" />"
     }
   }
 }

package/data/button-group.json

@@ -50,6 +50,11 @@
       "required": false,
       "default": false
     },
+    "fullWidth": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
     "hasBorder": {
       "type": "boolean",
       "required": false,
@@ -72,6 +77,60 @@
       "default": "xs"
     }
   },
+  "subComponents": {
+    "ButtonGroup.Item": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "fullWidth": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "hasBorder": {
+          "type": "boolean",
+          "required": false,
+          "default": true
+        },
+        "icon": {
+          "type": "string",
+          "required": false,
+          "rawType": "SideSlot | undefined"
+        },
+        "isCurrent": {
+          "type": "boolean",
+          "required": false
+        },
+        "label": {
+          "type": "string",
+          "required": false
+        },
+        "onlyIcon": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "md",
+            "sm",
+            "xs",
+            "xxs"
+          ],
+          "default": "xs"
+        }
+      }
+    }
+  },
   "html": {},
   "bemClasses": [
     "ncua-button-group",

package/data/button.json

@@ -76,6 +76,69 @@
     },
     "leadingIcon": {
       "type": "object",
+      "required": false,
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false,
+          "semantic": "icon-component"
+        },
+        "color": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "black",
+            "blue500",
+            "blue600",
+            "currentColor",
+            "gray100",
+            "gray200",
+            "gray300",
+            "gray400",
+            "gray500",
+            "gray600",
+            "gray700",
+            "green500",
+            "green600",
+            "orange500",
+            "orange600",
+            "pink100",
+            "pink600",
+            "red500",
+            "red600",
+            "secondary-gray-blue-100",
+            "secondary-gray-blue-200",
+            "secondary-gray-blue-300",
+            "secondary-gray-blue-400",
+            "secondary-gray-blue-450",
+            "secondary-gray-blue-50",
+            "secondary-gray-blue-500",
+            "secondary-gray-blue-600",
+            "secondary-gray-blue-700",
+            "violet300",
+            "violet600",
+            "white",
+            "yellow600"
+          ]
+        },
+        "size": {
+          "type": "number",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        }
+      }
+    },
+    "loading": {
+      "type": "boolean",
       "required": false
     },
     "onlyIcon": {
@@ -94,7 +157,66 @@
     },
     "trailingIcon": {
       "type": "object",
-      "required": false
+      "required": false,
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false,
+          "semantic": "icon-component"
+        },
+        "color": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "black",
+            "blue500",
+            "blue600",
+            "currentColor",
+            "gray100",
+            "gray200",
+            "gray300",
+            "gray400",
+            "gray500",
+            "gray600",
+            "gray700",
+            "green500",
+            "green600",
+            "orange500",
+            "orange600",
+            "pink100",
+            "pink600",
+            "red500",
+            "red600",
+            "secondary-gray-blue-100",
+            "secondary-gray-blue-200",
+            "secondary-gray-blue-300",
+            "secondary-gray-blue-400",
+            "secondary-gray-blue-450",
+            "secondary-gray-blue-50",
+            "secondary-gray-blue-500",
+            "secondary-gray-blue-600",
+            "secondary-gray-blue-700",
+            "violet300",
+            "violet600",
+            "white",
+            "yellow600"
+          ]
+        },
+        "size": {
+          "type": "number",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        }
+      }
     },
     "underline": {
       "type": "boolean",
@@ -118,6 +240,7 @@
     "ncua-btn--xs",
     "ncua-btn--xxs",
     "ncua-btn__label",
+    "ncua-btn__spinner",
     "ncua-button-close-x",
     "ncua-button-stepper"
   ],

package/data/carousel-arrow.json

@@ -3,7 +3,7 @@
   "exportName": "CarouselArrow",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "feedback",
+  "category": "feedback-and-status",
   "description": "CarouselArrow는 캐러셀의 이전/다음 페이지로 이동할 수 있는 화살표 버튼 컴포넌트입니다.",
   "aliases": [
     "CarouselArrow",
@@ -50,11 +50,6 @@
       "type": "function",
       "required": false
     },
-    "size": {
-      "type": "string",
-      "required": true,
-      "rawType": "\"md\""
-    },
     "type": {
       "type": "enum",
       "required": false,
@@ -77,11 +72,11 @@
   "usage": {
     "import": "import { CarouselArrow } from '@ncds/ui-admin';",
     "react": {
-      "default": "<CarouselArrow chevron=\"left\" size=\"\" />",
-      "chevron:left": "<CarouselArrow chevron=\"left\" size=\"\" />",
-      "chevron:right": "<CarouselArrow chevron=\"right\" size=\"\" />",
-      "type:default": "<CarouselArrow type=\"default\" chevron=\"left\" size=\"\" />",
-      "type:line": "<CarouselArrow type=\"line\" chevron=\"left\" size=\"\" />"
+      "default": "<CarouselArrow chevron=\"left\" />",
+      "chevron:left": "<CarouselArrow chevron=\"left\" />",
+      "chevron:right": "<CarouselArrow chevron=\"right\" />",
+      "type:default": "<CarouselArrow type=\"default\" chevron=\"left\" />",
+      "type:line": "<CarouselArrow type=\"line\" chevron=\"left\" />"
     }
   }
 }

package/data/carousel-number-group.json

@@ -3,7 +3,7 @@
   "exportName": "CarouselNumberGroup",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "feedback",
+  "category": "feedback-and-status",
   "description": "CarouselNumberGroup은 캐러셀의 현재 페이지와 전체 페이지 수를 표시하는 컴포넌트입니다.",
   "aliases": [
     "CarouselNumberGroup",
@@ -53,14 +53,6 @@
       "required": false,
       "default": true
     },
-    "size": {
-      "type": "enum",
-      "required": false,
-      "values": [
-        "sm"
-      ],
-      "default": "sm"
-    },
     "totalPage": {
       "type": "number",
       "required": true
@@ -71,7 +63,6 @@
     "ncua-carousel-number-group",
     "ncua-carousel-number-group--dark",
     "ncua-carousel-number-group--light",
-    "ncua-carousel-number-group--sm",
     "ncua-carousel-number-group__number",
     "ncua-carousel-number-group__total"
   ],
@@ -80,8 +71,7 @@
     "react": {
       "default": "<CarouselNumberGroup currentPage={0} totalPage={0} />",
       "color:dark": "<CarouselNumberGroup color=\"dark\" currentPage={0} totalPage={0} />",
-      "color:light": "<CarouselNumberGroup color=\"light\" currentPage={0} totalPage={0} />",
-      "size:sm": "<CarouselNumberGroup size=\"sm\" currentPage={0} totalPage={0} />"
+      "color:light": "<CarouselNumberGroup color=\"light\" currentPage={0} totalPage={0} />"
     }
   }
 }

package/data/checkbox.json

@@ -3,7 +3,7 @@
   "exportName": "Checkbox",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "input",
+  "category": "forms-and-input",
   "description": "체크박스는 사용자가 목록에서 하나 이상의 항목을 선택하거나 옵션을 활성화/비활성화할 때 사용하는 핵심 Selection 컴포넌트입니다.",
   "aliases": [
     "체크박스",

package/data/combo-box.json

@@ -3,7 +3,7 @@
   "exportName": "ComboBox",
   "importPath": "@ncds/ui-admin",
   "jsRequired": true,
-  "category": "input",
+  "category": "forms-and-input",
   "description": "ComboBox는 여러 개의 데이터에서 검색(입력)하거나 리스트에서 옵션을 골라 빠르게 선택하는 복합 선택 컴포넌트입니다.",
   "aliases": [
     "콤보박스",
@@ -26,6 +26,10 @@
     "전체선택",
     "선택완료",
     "Clear",
+    "maxSelection",
+    "최대 선택 개수",
+    "최대선택",
+    "선택 제한",
     "NCDS"
   ],
   "hasChildren": true,
@@ -40,8 +44,7 @@
     "Clear 버튼 없이 입력 유지 강제 금지"
   ],
   "seeAlso": [
-    "selectbox",
-    "select"
+    "button"
   ],
   "htmlElement": "div",
   "props": {
@@ -72,6 +75,10 @@
       "required": false,
       "default": "defaultMaxHeight"
     },
+    "maxSelection": {
+      "type": "number",
+      "required": false
+    },
     "multiple": {
       "type": "boolean",
       "required": false,
@@ -90,9 +97,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": {
@@ -102,7 +125,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"
     },
     "required": {
       "type": "boolean",
@@ -129,9 +153,9 @@
       "default": "xs"
     },
     "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": {},