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

package/data/badge-group.json

@@ -0,0 +1,121 @@
+{
+  "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
+    },
+    "groupLabel": {
+      "type": "string",
+      "required": true
+    },
+    "href": {
+      "type": "string",
+      "required": false
+    },
+    "label": {
+      "type": "string",
+      "required": true
+    },
+    "leadingIcon": {
+      "type": "object",
+      "required": false
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "sm",
+        "xs"
+      ],
+      "default": "sm"
+    },
+    "target": {
+      "type": "string",
+      "required": false,
+      "default": "_blank"
+    },
+    "trailingIcon": {
+      "type": "object",
+      "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,130 @@
+{
+  "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
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "md",
+        "sm",
+        "xs"
+      ],
+      "default": "sm"
+    },
+    "trailingIcon": {
+      "type": "object",
+      "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,51 @@
+{
+  "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"
+  ],
+  "props": {},
+  "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 />"
+    }
+  }
+}

package/data/button-group.json

@@ -0,0 +1,94 @@
+{
+  "name": "button-group",
+  "exportName": "ButtonGroup",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "action",
+  "description": "ButtonGroup은 관련된 버튼을 하나의 그룹으로 묶어 통합된 UI 구조를 제공하는 컴포넌트입니다",
+  "aliases": [
+    "버튼그룹",
+    "ButtonGroup",
+    "컴포넌트",
+    "Toolset",
+    "Default",
+    "선택형",
+    "도구형",
+    "isCurrent",
+    "hasBorder",
+    "onlyIcon",
+    "그룹",
+    "NCDS"
+  ],
+  "hasChildren": true,
+  "whenToUse": [
+    "그룹의 성격(도구형 vs 선택형)에 따라 타입이 결정되는 상황",
+    "사용자가 그룹의 인터랙션 패턴과 현재 상태를 즉시 이해해야 하는 상황"
+  ],
+  "forbiddenRules": [
+    "그룹 내 혼합 사이즈 사용",
+    "Toolset(v1)에서 선택 상태 유지 사용",
+    "Default(v2)에서 다중 선택 허용",
+    "의미적으로 관련 없는 버튼 그룹화 (최대 6개 이내 권장)",
+    "그룹 내 서로 다른 콘텐츠 구성(Text/Icon) 혼용",
+    "NCDS 기준 외 임의 스타일 변경"
+  ],
+  "seeAlso": [
+    "button"
+  ],
+  "htmlElement": "button",
+  "props": {
+    "children": {
+      "type": "ReactNode",
+      "required": true
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "disabled": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "hasBorder": {
+      "type": "boolean",
+      "required": false,
+      "default": true
+    },
+    "onlyIcon": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "md",
+        "sm",
+        "xs",
+        "xxs"
+      ],
+      "default": "xs"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-button-group",
+    "ncua-button-group--md",
+    "ncua-button-group--sm",
+    "ncua-button-group--xs",
+    "ncua-button-group--xxs",
+    "ncua-button-group__item"
+  ],
+  "usage": {
+    "import": "import { ButtonGroup } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<ButtonGroup children=\"예시\" />",
+      "size:md": "<ButtonGroup size=\"md\" children=\"예시\" />",
+      "size:sm": "<ButtonGroup size=\"sm\" children=\"예시\" />",
+      "size:xs": "<ButtonGroup size=\"xs\" children=\"예시\" />",
+      "size:xxs": "<ButtonGroup size=\"xxs\" children=\"예시\" />"
+    }
+  }
+}

package/data/button.json

@@ -0,0 +1,143 @@
+{
+  "name": "button",
+  "exportName": "Button",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "action",
+  "description": "버튼은 사용자의 명시적 실행 의도를 수행하는 핵심 Action 컴포넌트입니다",
+  "aliases": [
+    "버튼",
+    "Button",
+    "컴포넌트",
+    "hierarchy",
+    "Primary",
+    "Secondary",
+    "Destructive",
+    "Text버튼",
+    "사이즈",
+    "아이콘",
+    "disabled",
+    "Loading",
+    "Focused",
+    "Hover",
+    "Confirm",
+    "NCDS",
+    "액션"
+  ],
+  "hasChildren": true,
+  "whenToUse": [
+    "역할과 중요도에 따라 계층(hierarchy)이 결정되는 상황",
+    "페이지 내 시각적 우선순위를 명확히 전달해야 하는 상황"
+  ],
+  "forbiddenRules": [
+    "Primary 버튼 복수 사용 (페이지당 1개)",
+    "버튼 사이즈 혼용 (같은 영역 내)",
+    "네비게이션 용도로 버튼 사용",
+    "NCDS 기준 외 임의 색상, radius, padding, 인터랙션 변경",
+    "Disabled 상태에서 시각적 강조나 인터랙션 하이라이트 추가",
+    "아이콘을 꾸밈 요소로만 사용",
+    "Destructive 외 Variant에서 Red 600/700 계열 색상 사용"
+  ],
+  "seeAlso": [
+    "button-group"
+  ],
+  "htmlElement": "button",
+  "props": {
+    "children": {
+      "type": "ReactNode",
+      "required": false
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "disabled": {
+      "type": "boolean",
+      "required": false
+    },
+    "hierarchy": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "destructive",
+        "primary",
+        "secondary",
+        "secondary-gray",
+        "tertiary",
+        "tertiary-gray",
+        "text",
+        "text-gray",
+        "text-red"
+      ]
+    },
+    "label": {
+      "type": "ReactNode",
+      "required": true
+    },
+    "leadingIcon": {
+      "type": "object",
+      "required": false
+    },
+    "onlyIcon": {
+      "type": "boolean",
+      "required": false
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "md",
+        "sm",
+        "xs",
+        "xxs"
+      ]
+    },
+    "trailingIcon": {
+      "type": "object",
+      "required": false
+    },
+    "underline": {
+      "type": "boolean",
+      "required": false
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-btn",
+    "ncua-btn--destructive",
+    "ncua-btn--md",
+    "ncua-btn--primary",
+    "ncua-btn--secondary",
+    "ncua-btn--secondary-gray",
+    "ncua-btn--sm",
+    "ncua-btn--tertiary",
+    "ncua-btn--tertiary-gray",
+    "ncua-btn--text",
+    "ncua-btn--text-gray",
+    "ncua-btn--text-red",
+    "ncua-btn--xs",
+    "ncua-btn--xxs",
+    "ncua-btn__label",
+    "ncua-button-close-x",
+    "ncua-button-stepper"
+  ],
+  "usage": {
+    "import": "import { Button } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<Button label=\"예시\" />",
+      "hierarchy:destructive": "<Button hierarchy=\"destructive\" label=\"예시\" />",
+      "hierarchy:primary": "<Button hierarchy=\"primary\" label=\"예시\" />",
+      "hierarchy:secondary": "<Button hierarchy=\"secondary\" label=\"예시\" />",
+      "hierarchy:secondary-gray": "<Button hierarchy=\"secondary-gray\" label=\"예시\" />",
+      "hierarchy:tertiary": "<Button hierarchy=\"tertiary\" label=\"예시\" />",
+      "hierarchy:tertiary-gray": "<Button hierarchy=\"tertiary-gray\" label=\"예시\" />",
+      "hierarchy:text": "<Button hierarchy=\"text\" label=\"예시\" />",
+      "hierarchy:text-gray": "<Button hierarchy=\"text-gray\" label=\"예시\" />",
+      "hierarchy:text-red": "<Button hierarchy=\"text-red\" label=\"예시\" />",
+      "size:md": "<Button size=\"md\" label=\"예시\" />",
+      "size:sm": "<Button size=\"sm\" label=\"예시\" />",
+      "size:xs": "<Button size=\"xs\" label=\"예시\" />",
+      "size:xxs": "<Button size=\"xxs\" label=\"예시\" />"
+    }
+  }
+}

package/data/carousel-arrow.json

@@ -0,0 +1,87 @@
+{
+  "name": "carousel-arrow",
+  "exportName": "CarouselArrow",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "feedback",
+  "description": "CarouselArrow는 캐러셀의 이전/다음 페이지로 이동할 수 있는 화살표 버튼 컴포넌트입니다.",
+  "aliases": [
+    "CarouselArrow",
+    "캐러셀",
+    "화살표",
+    "캐러셀화살표",
+    "chevron",
+    "이전",
+    "다음",
+    "페이지이동",
+    "Default",
+    "Line",
+    "네비게이션",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "캐러셀 내비게이션 전용 버튼",
+    "좌/우 방향 화살표를 통해 콘텐츠 페이지 간 이동을 직관적으로 유도"
+  ],
+  "forbiddenRules": [
+    "단일 방향만 사용 금지(left/right 쌍 필수)",
+    "캐러셀 외 용도 금지",
+    "커스텀 아이콘 금지",
+    "크기 임의 변경 금지"
+  ],
+  "seeAlso": [
+    "carousel-number-group"
+  ],
+  "props": {
+    "chevron": {
+      "type": "enum",
+      "required": true,
+      "values": [
+        "left",
+        "right"
+      ]
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "onClick": {
+      "type": "function",
+      "required": false
+    },
+    "size": {
+      "type": "string",
+      "required": true,
+      "rawType": "\"md\""
+    },
+    "type": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "default",
+        "line"
+      ],
+      "default": "default"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-carousel-arrow",
+    "ncua-carousel-arrow--default",
+    "ncua-carousel-arrow--left",
+    "ncua-carousel-arrow--line",
+    "ncua-carousel-arrow--right",
+    "ncua-carousel-arrow__icon"
+  ],
+  "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=\"\" />"
+    }
+  }
+}