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

package/data/dropdown.json

@@ -0,0 +1,258 @@
+{
+  "name": "dropdown",
+  "exportName": "Dropdown",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "overlay",
+  "description": "Dropdown(메뉴형)은 버튼, 아이콘, 아바타 등 트리거 요소를 통해 숨겨진 메뉴 또는 작업(Action) 목록을 레이어 형태로 노출하는 컴포넌트입니다.",
+  "aliases": [
+    "Dropdown",
+    "드롭다운",
+    "Trigger",
+    "Layer",
+    "Menu",
+    "IconTrigger",
+    "AvatarTrigger",
+    "ButtonTrigger",
+    "TextTrigger",
+    "CustomTrigger",
+    "DropdownGroup",
+    "DropdownItem",
+    "Header",
+    "Divider",
+    "Danger",
+    "align",
+    "closeOnClickItem",
+    "NCDS"
+  ],
+  "hasChildren": true,
+  "whenToUse": [
+    "Dropdown은 값 선택이 아닌 액션 실행 컴포넌트입니다",
+    "제한된 화면 공간에서 다수의 작업을 구조적으로 제공할 때 사용합니다"
+  ],
+  "forbiddenRules": [
+    "메뉴명 말줄임 처리 금지",
+    "10개 이상 메뉴 구성 지양",
+    "내부 스크롤 지양",
+    "값 선택 용도 사용 금지",
+    "별도 전용 버튼 생성 금지",
+    "Danger 스타일 남용 금지"
+  ],
+  "seeAlso": [
+    "button",
+    "selectbox",
+    "icon",
+    "icon-button"
+  ],
+  "usageExamples": {
+    "buttonTrigger": {
+      "trigger": {
+        "type": "button",
+        "text": "메뉴"
+      },
+      "groups": [
+        {
+          "items": [
+            {
+              "id": "edit",
+              "text": "수정"
+            },
+            {
+              "id": "copy",
+              "text": "복사"
+            },
+            {
+              "id": "delete",
+              "text": "삭제",
+              "type": "danger"
+            }
+          ]
+        }
+      ]
+    },
+    "iconTrigger": {
+      "trigger": {
+        "type": "icon"
+      },
+      "groups": [
+        {
+          "items": [
+            {
+              "id": "setting",
+              "text": "설정"
+            },
+            {
+              "id": "logout",
+              "text": "로그아웃"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "props": {
+    "align": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "left",
+        "right"
+      ],
+      "default": "left"
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "closeOnClickItem": {
+      "type": "boolean",
+      "required": false,
+      "default": true
+    },
+    "closeOnClickOutside": {
+      "type": "boolean",
+      "required": false,
+      "default": true
+    },
+    "groups": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").DropdownGroup[]",
+      "properties": {
+        "items": {
+          "type": "object",
+          "required": true,
+          "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").DropdownItemType[]",
+          "properties": {
+            "id": {
+              "type": "string",
+              "required": true
+            },
+            "text": {
+              "type": "string",
+              "required": true
+            },
+            "icon": {
+              "type": "function",
+              "required": false
+            },
+            "shortcut": {
+              "type": "string",
+              "required": false
+            },
+            "onClick": {
+              "type": "function",
+              "required": false
+            },
+            "disabled": {
+              "type": "boolean",
+              "required": false
+            },
+            "type": {
+              "type": "enum",
+              "required": false,
+              "values": [
+                "danger",
+                "default"
+              ]
+            },
+            "className": {
+              "type": "string",
+              "required": false
+            }
+          }
+        }
+      }
+    },
+    "header": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").DropdownHeaderType | undefined",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"avatar\""
+        },
+        "avatar": {
+          "type": "string",
+          "required": false
+        },
+        "title": {
+          "type": "string",
+          "required": true
+        },
+        "subtitle": {
+          "type": "string",
+          "required": false
+        }
+      }
+    },
+    "opened": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "trigger": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").AvatarTrigger | import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").ButtonTrigger | import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").IconTrigger | import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/dropdown/Dropdown\").CustomTrigger",
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"avatar\""
+        },
+        "avatar": {
+          "type": "string",
+          "required": false
+        },
+        "text": {
+          "type": "string",
+          "required": false
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-dropdown",
+    "ncua-dropdown--right",
+    "ncua-dropdown__avatar",
+    "ncua-dropdown__group",
+    "ncua-dropdown__header",
+    "ncua-dropdown__header-avatar-group",
+    "ncua-dropdown__header-subtitle",
+    "ncua-dropdown__header-text",
+    "ncua-dropdown__header-title",
+    "ncua-dropdown__item",
+    "ncua-dropdown__item-clickable-layer",
+    "ncua-dropdown__item-content",
+    "ncua-dropdown__item-icon",
+    "ncua-dropdown__item-shortcut",
+    "ncua-dropdown__item-text",
+    "ncua-dropdown__item-text-group",
+    "ncua-dropdown__menu",
+    "ncua-dropdown__menu-items",
+    "ncua-dropdown__trigger",
+    "ncua-dropdown__trigger ncua-dropdown__trigger--avatar",
+    "ncua-dropdown__trigger ncua-dropdown__trigger--button",
+    "ncua-dropdown__trigger ncua-dropdown__trigger--icon"
+  ],
+  "usage": {
+    "import": "import { Dropdown } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<Dropdown groups=\"\" trigger=\"\" />",
+      "align:left": "<Dropdown align=\"left\" groups=\"\" trigger=\"\" />",
+      "align:right": "<Dropdown align=\"right\" groups=\"\" trigger=\"\" />"
+    }
+  }
+}

package/data/empty-state.json

@@ -0,0 +1,227 @@
+{
+  "name": "empty-state",
+  "exportName": "EmptyState",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "feedback",
+  "description": "EmptyState는 앱에서 사용자에게 표시할 데이터가 없거나 검색어가 0개의 결과를 반환하는 순간을 표시하는 컴포넌트입니다.",
+  "aliases": [
+    "EmptyState",
+    "빈상태",
+    "빈화면",
+    "검색결과없음",
+    "데이터없음",
+    "안내메시지",
+    "title",
+    "description",
+    "buttons",
+    "액션버튼",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "빈 상태의 이유를 명확하게 설명하고 사용자가 취할 수 있는 다음 단계와 명확한 작업에 대한 지침을 제공",
+    "충분한 지침이 있으면 작업이 예상대로 작동하지 않을 때에도 원활한 경험을 보장"
+  ],
+  "forbiddenRules": [
+    "빈 상태 무시 금지(반드시 EmptyState로 안내 메시지 제공)",
+    "모호한 메시지 금지",
+    "과도한 버튼 사용 금지",
+    "장식 용도 금지",
+    "로딩 중 표시 금지"
+  ],
+  "seeAlso": [
+    "spinner"
+  ],
+  "props": {
+    "buttons": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/empty-state/EmptyState\").ButtonOptions | import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/empty-state/EmptyState\").ButtonOptions[] | undefined",
+      "properties": {
+        "label": {
+          "type": "string",
+          "required": true
+        },
+        "onClick": {
+          "type": "function",
+          "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"
+          ]
+        },
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "md",
+            "sm",
+            "xs",
+            "xxs"
+          ]
+        },
+        "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
+            }
+          }
+        },
+        "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
+            }
+          }
+        }
+      }
+    },
+    "description": {
+      "type": "string",
+      "required": true
+    },
+    "title": {
+      "type": "string",
+      "required": true
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-empty-state",
+    "ncua-empty-state__button-group",
+    "ncua-empty-state__description",
+    "ncua-empty-state__title"
+  ],
+  "usage": {
+    "import": "import { EmptyState } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<EmptyState description=\"\" title=\"\" />"
+    }
+  }
+}

package/data/featured-icon.json

@@ -0,0 +1,139 @@
+{
+  "name": "featured-icon",
+  "exportName": "FeaturedIcon",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": true,
+  "category": "icon",
+  "description": "FeaturedIcon은 상태(Status), 결과(Result), 중요 액션(Action)을 시각적으로 강조하기 위한 아이콘 강조 컴포넌트입니다",
+  "aliases": [
+    "FeaturedIcon",
+    "피처드아이콘",
+    "아이콘강조",
+    "상태아이콘",
+    "light-circle",
+    "dark-circle",
+    "outline-circle",
+    "square-outline",
+    "neutral",
+    "error",
+    "warning",
+    "success",
+    "컨테이너아이콘",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "상태 결과 페이지",
+    "에러 페이지",
+    "단독 메시지 영역",
+    "알림/승인 결과",
+    "시스템 메시지"
+  ],
+  "forbiddenRules": [
+    "버튼 트리거로 사용 금지",
+    "임의 색상 사용 금지",
+    "의미와 맞지 않는 색상 사용 금지",
+    "Interactive 사용 지양",
+    "반복적 나열 지양"
+  ],
+  "seeAlso": [
+    "icon",
+    "icon-button",
+    "badge",
+    "dot"
+  ],
+  "htmlElement": "div",
+  "usageExamples": {
+    "success": {
+      "icon": "CheckCircle",
+      "color": "success",
+      "theme": "light-circle",
+      "size": "md"
+    },
+    "error": {
+      "icon": "AlertCircle",
+      "color": "error",
+      "theme": "dark-circle",
+      "size": "lg"
+    }
+  },
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "color": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "error",
+        "neutral",
+        "success",
+        "warning"
+      ],
+      "default": "neutral"
+    },
+    "icon": {
+      "type": "function",
+      "required": true
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "lg",
+        "md",
+        "sm",
+        "xl"
+      ],
+      "default": "md"
+    },
+    "theme": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "dark-circle",
+        "light-circle",
+        "outline-circle",
+        "square-outline"
+      ],
+      "default": "light-circle"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-featured-icon",
+    "ncua-featured-icon--dark-circle",
+    "ncua-featured-icon--error",
+    "ncua-featured-icon--lg",
+    "ncua-featured-icon--light-circle",
+    "ncua-featured-icon--md",
+    "ncua-featured-icon--neutral",
+    "ncua-featured-icon--outline-circle",
+    "ncua-featured-icon--sm",
+    "ncua-featured-icon--square-outline",
+    "ncua-featured-icon--success",
+    "ncua-featured-icon--warning",
+    "ncua-featured-icon--xl",
+    "ncua-featured-icon__outline ncua-featured-icon__outline--inner",
+    "ncua-featured-icon__outline ncua-featured-icon__outline--outer"
+  ],
+  "usage": {
+    "import": "import { FeaturedIcon } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<FeaturedIcon icon=\"\" />",
+      "color:error": "<FeaturedIcon color=\"error\" icon=\"\" />",
+      "color:neutral": "<FeaturedIcon color=\"neutral\" icon=\"\" />",
+      "color:success": "<FeaturedIcon color=\"success\" icon=\"\" />",
+      "color:warning": "<FeaturedIcon color=\"warning\" icon=\"\" />",
+      "size:lg": "<FeaturedIcon size=\"lg\" icon=\"\" />",
+      "size:md": "<FeaturedIcon size=\"md\" icon=\"\" />",
+      "size:sm": "<FeaturedIcon size=\"sm\" icon=\"\" />",
+      "size:xl": "<FeaturedIcon size=\"xl\" icon=\"\" />",
+      "theme:dark-circle": "<FeaturedIcon theme=\"dark-circle\" icon=\"\" />",
+      "theme:light-circle": "<FeaturedIcon theme=\"light-circle\" icon=\"\" />",
+      "theme:outline-circle": "<FeaturedIcon theme=\"outline-circle\" icon=\"\" />",
+      "theme:square-outline": "<FeaturedIcon theme=\"square-outline\" icon=\"\" />"
+    }
+  }
+}