@ncds/ui-admin-mcp 1.0.0-alpha.10

package/data/badge-group.json

@@ -0,0 +1,295 @@
+{
+  "name": "badge-group",
+  "exportName": "BadgeGroup",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "feedback",
+  "description": "BadgeGroup은 Badge 컴포넌트를 그룹화하여 표시하는 컴포넌트입니다. 주로 Badge와 함께 추가적인 라벨과 아이콘을 표시하여 액션유도할 수 있는 아이템으로 활용할 수 있습니다.",
+  "aliases": [
+    "BadgeGroup",
+    "배지그룹",
+    "뱃지그룹",
+    "Badge",
+    "groupLabel",
+    "groupIcon",
+    "pill",
+    "액션유도",
+    "링크",
+    "상태표시",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "Badge + groupLabel + groupIcon을 조합하여 상태 정보와 함께 추가 설명 및 액션을 유도",
+    "Badge(읽기 전용)와 달리 Hover 상태와 링크 기능을 지원"
+  ],
+  "forbiddenRules": [
+    "의미 없는 그룹 사용 금지(groupLabel 없이 Badge만 사용할 경우 Badge 직접 사용)",
+    "과도한 groupLabel 금지(간결한 한 문장)",
+    "컬러 의미 혼용 금지",
+    "커스텀 아이콘 금지(SideSlotType 정의에 따른 구조체만 사용)",
+    "과도한 중첩 금지",
+    "이미지 삽입 금지"
+  ],
+  "seeAlso": [
+    "badge",
+    "horizontal-tab",
+    "vertical-tab"
+  ],
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "color": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "error",
+        "neutral",
+        "success",
+        "warning"
+      ],
+      "default": "neutral"
+    },
+    "groupClassName": {
+      "type": "string",
+      "required": false
+    },
+    "groupIcon": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "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
+        }
+      }
+    },
+    "groupLabel": {
+      "type": "string",
+      "required": true
+    },
+    "href": {
+      "type": "string",
+      "required": false
+    },
+    "label": {
+      "type": "string",
+      "required": true
+    },
+    "leadingIcon": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "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
+        }
+      }
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "sm",
+        "xs"
+      ],
+      "default": "sm"
+    },
+    "target": {
+      "type": "string",
+      "required": false,
+      "default": "_blank"
+    },
+    "trailingIcon": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "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
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-badge-group",
+    "ncua-badge-group--error",
+    "ncua-badge-group--neutral",
+    "ncua-badge-group--sm",
+    "ncua-badge-group--success",
+    "ncua-badge-group--warning",
+    "ncua-badge-group--xs",
+    "ncua-badge-group__label"
+  ],
+  "usage": {
+    "import": "import { BadgeGroup } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<BadgeGroup groupLabel=\"\" label=\"\" />",
+      "color:error": "<BadgeGroup color=\"error\" groupLabel=\"\" label=\"\" />",
+      "color:neutral": "<BadgeGroup color=\"neutral\" groupLabel=\"\" label=\"\" />",
+      "color:success": "<BadgeGroup color=\"success\" groupLabel=\"\" label=\"\" />",
+      "color:warning": "<BadgeGroup color=\"warning\" groupLabel=\"\" label=\"\" />",
+      "size:sm": "<BadgeGroup size=\"sm\" groupLabel=\"\" label=\"\" />",
+      "size:xs": "<BadgeGroup size=\"xs\" groupLabel=\"\" label=\"\" />"
+    }
+  }
+}

package/data/badge.json

@@ -0,0 +1,246 @@
+{
+  "name": "badge",
+  "exportName": "Badge",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "feedback",
+  "description": "Badge는 상태나 중요성 및 이벤트 강조를 나타내는 레이블이며 빠른 인식을 제공해야 합니다.",
+  "aliases": [
+    "Badge",
+    "뱃지",
+    "배지",
+    "라벨",
+    "상태표시",
+    "pill-outline",
+    "pill-dark-color",
+    "leadingIcon",
+    "trailingIcon",
+    "SideSlotType",
+    "dot",
+    "강조",
+    "읽기전용",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "읽기 전용 상태 표시 레이블",
+    "정보의 상태/중요도/이벤트를 시각적으로 빠르게 전달"
+  ],
+  "forbiddenRules": [
+    "클릭 액션 부여 금지",
+    "과도한 컬러 남용 금지",
+    "의미 없는 Badge 사용 금지",
+    "텍스트 과다 금지(2~4자 권장)",
+    "이미지 삽입 금지",
+    "임의 아이콘 금지(SideSlotType 구조체만 사용)",
+    "컬러 의미 혼용 금지"
+  ],
+  "seeAlso": [
+    "horizontal-tab",
+    "vertical-tab",
+    "badge-group",
+    "tag"
+  ],
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "color": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "blue",
+        "disabled",
+        "error",
+        "neutral",
+        "pink",
+        "success",
+        "warning"
+      ],
+      "default": "neutral"
+    },
+    "label": {
+      "type": "string",
+      "required": true
+    },
+    "leadingIcon": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "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
+        }
+      }
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "md",
+        "sm",
+        "xs"
+      ],
+      "default": "sm"
+    },
+    "trailingIcon": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "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
+        }
+      }
+    },
+    "type": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "pill-dark-color",
+        "pill-outline"
+      ],
+      "default": "pill-outline"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-badge",
+    "ncua-badge--blue",
+    "ncua-badge--disabled",
+    "ncua-badge--error",
+    "ncua-badge--md",
+    "ncua-badge--neutral",
+    "ncua-badge--pill-dark-color",
+    "ncua-badge--pill-outline",
+    "ncua-badge--pink",
+    "ncua-badge--sm",
+    "ncua-badge--success",
+    "ncua-badge--warning",
+    "ncua-badge--xs",
+    "ncua-badge__label"
+  ],
+  "usage": {
+    "import": "import { Badge } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<Badge label=\"\" />",
+      "color:blue": "<Badge color=\"blue\" label=\"\" />",
+      "color:disabled": "<Badge color=\"disabled\" label=\"\" />",
+      "color:error": "<Badge color=\"error\" label=\"\" />",
+      "color:neutral": "<Badge color=\"neutral\" label=\"\" />",
+      "color:pink": "<Badge color=\"pink\" label=\"\" />",
+      "color:success": "<Badge color=\"success\" label=\"\" />",
+      "color:warning": "<Badge color=\"warning\" label=\"\" />",
+      "size:md": "<Badge size=\"md\" label=\"\" />",
+      "size:sm": "<Badge size=\"sm\" label=\"\" />",
+      "size:xs": "<Badge size=\"xs\" label=\"\" />",
+      "type:pill-dark-color": "<Badge type=\"pill-dark-color\" label=\"\" />",
+      "type:pill-outline": "<Badge type=\"pill-outline\" label=\"\" />"
+    }
+  }
+}

package/data/bread-crumb.json

@@ -0,0 +1,87 @@
+{
+  "name": "bread-crumb",
+  "exportName": "BreadCrumb",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "navigation",
+  "description": "BreadCrumb은 현재 사용자의 위치를 상위 구조 기준으로 알려주는 계층 네비게이션 경로(보조) UI 컴포넌트입니다.",
+  "aliases": [
+    "BreadCrumb",
+    "브레드크럼",
+    "경로탐색",
+    "계층구조",
+    "Depth",
+    "네비게이션",
+    "Home",
+    "축약",
+    "구분자",
+    "GNB",
+    "페이지위치",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "페이지 계층 구조를 한눈에 파악하고 상위 메뉴로 빠르게 이동할 수 있도록 보조하는 네비게이션",
+    "과도한 Depth 노출이나 불필요한 강조는 지양"
+  ],
+  "forbiddenRules": [
+    "5 Depth 이상 그대로 노출 금지",
+    "마지막(Current) 항목 클릭 허용 금지",
+    "모든 Depth를 버튼처럼 동일 강조 금지",
+    "BreadCrumb을 필수 네비게이션으로 오해하게 만들지 않음"
+  ],
+  "seeAlso": [
+    "icon"
+  ],
+  "usageExamples": {
+    "default": {
+      "items": [
+        {
+          "label": "대시보드"
+        },
+        {
+          "label": "상품",
+          "href": "/products"
+        },
+        {
+          "label": "상품 상세"
+        }
+      ]
+    }
+  },
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "items": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/bread-crumb/BreadCrumb\").BreadCrumbItemProps[]",
+      "properties": {
+        "href": {
+          "type": "string",
+          "required": false
+        },
+        "label": {
+          "type": "string",
+          "required": true
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-breadcrumb",
+    "ncua-breadcrumb__item",
+    "ncua-breadcrumb__list",
+    "ncua-breadcrumb__list-item",
+    "ncua-breadcrumb__list-item--active"
+  ],
+  "usage": {
+    "import": "import { BreadCrumb } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<BreadCrumb items=\"\" />"
+    }
+  }
+}