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

package/data/file-input.json

@@ -0,0 +1,315 @@
+{
+  "name": "file-input",
+  "exportName": "FileInput",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": true,
+  "category": "input",
+  "description": "File Upload가 필요한 영역에서 공통 UI/UX를 적용하는 입력 컴포넌트입니다",
+  "aliases": [
+    "파일인풋",
+    "FileInput",
+    "파일업로드",
+    "파일첨부",
+    "파일찾기",
+    "업로드",
+    "accept",
+    "maxFileCount",
+    "maxFileSize",
+    "onFail",
+    "multiple",
+    "hintText",
+    "hintItems",
+    "destructive",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "제한 정책 안내문을 항상 노출하며 파일명 텍스트 중심 UI를 기본으로 하고 삭제 기능을 필수 제공해야 하는 경우",
+    "단일 파일 또는 다중 파일 업로드가 필요한 경우",
+    "이미지가 아닌 일반 파일 업로드 영역"
+  ],
+  "forbiddenRules": [
+    "제한 정책 안내 없이 업로드 허용 금지",
+    "최대 등록 수 초과 시 무반응 처리 금지",
+    "파일명 34자 초과 그대로 노출 금지",
+    "단일 파일 영역에서 다중 파일 누적 금지",
+    "삭제 기능 없는 업로드 UI 제공 금지"
+  ],
+  "seeAlso": [
+    "image-file-input"
+  ],
+  "props": {
+    "accept": {
+      "type": "string",
+      "required": false
+    },
+    "buttonLabel": {
+      "type": "string",
+      "required": false,
+      "default": "파일 찾기"
+    },
+    "destructive": {
+      "type": "boolean",
+      "required": false
+    },
+    "disabled": {
+      "type": "boolean",
+      "required": false
+    },
+    "hintItems": {
+      "type": "object",
+      "required": false,
+      "rawType": "string[] | undefined"
+    },
+    "hintText": {
+      "type": "string",
+      "required": false
+    },
+    "isRequired": {
+      "type": "boolean",
+      "required": false
+    },
+    "label": {
+      "type": "string",
+      "required": false
+    },
+    "leadingElement": {
+      "type": "object",
+      "required": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"text\""
+        },
+        "text": {
+          "type": "string",
+          "required": false
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "size": {
+          "type": "number",
+          "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"
+          ]
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "placement": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "inside",
+            "outside"
+          ]
+        }
+      }
+    },
+    "maxFileCount": {
+      "type": "number",
+      "required": false
+    },
+    "maxFileSize": {
+      "type": "number",
+      "required": false
+    },
+    "maxLength": {
+      "type": "number",
+      "required": false
+    },
+    "onChange": {
+      "type": "function",
+      "required": false
+    },
+    "onFail": {
+      "type": "function",
+      "required": false
+    },
+    "onFileSelect": {
+      "type": "function",
+      "required": false
+    },
+    "required": {
+      "type": "boolean",
+      "required": false
+    },
+    "showHelpIcon": {
+      "type": "boolean",
+      "required": false
+    },
+    "showTextCount": {
+      "type": "boolean",
+      "required": false
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "sm",
+        "xs"
+      ],
+      "default": "xs"
+    },
+    "trailingElement": {
+      "type": "object",
+      "required": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "required": true,
+          "rawType": "\"icon\""
+        },
+        "icon": {
+          "type": "function",
+          "required": false
+        },
+        "size": {
+          "type": "number",
+          "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"
+          ]
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "placement": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "inside",
+            "outside"
+          ]
+        },
+        "label": {
+          "type": "string",
+          "required": false
+        },
+        "isSubmit": {
+          "type": "boolean",
+          "required": false
+        },
+        "onClick": {
+          "type": "function",
+          "required": false
+        }
+      }
+    },
+    "validation": {
+      "type": "boolean",
+      "required": false
+    },
+    "value": {
+      "type": "object",
+      "required": false,
+      "rawType": "File[] | undefined"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-file-input",
+    "ncua-file-input--sm",
+    "ncua-file-input--xs",
+    "ncua-file-input__file-image",
+    "ncua-file-input__file-tag-container",
+    "ncua-file-input__file-tags",
+    "ncua-file-input__hint-item",
+    "ncua-file-input__hint-list",
+    "ncua-file-input__input-container",
+    "ncua-file-input__label",
+    "ncua-input__help-icon"
+  ],
+  "usage": {
+    "import": "import { FileInput } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<FileInput />",
+      "size:sm": "<FileInput size=\"sm\" />",
+      "size:xs": "<FileInput size=\"xs\" />"
+    }
+  }
+}

package/data/horizontal-tab.json

@@ -0,0 +1,329 @@
+{
+  "name": "horizontal-tab",
+  "exportName": "HorizontalTab",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": true,
+  "category": "navigation",
+  "description": "HorizontalTab은 동일한 계층 구조의 관련 콘텐츠를 그룹화하여 탭 메뉴 사이를 전환하는 내비게이션 UI 컴포넌트입니다.",
+  "aliases": [
+    "HorizontalTab",
+    "가로탭",
+    "탭",
+    "Tab",
+    "수평탭",
+    "콘텐츠전환",
+    "Underline",
+    "Button",
+    "Badge",
+    "Closable",
+    "Slider",
+    "SPA",
+    "네비게이션",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "동일 페이지 내에서 콘텐츠를 전환하는 수평 내비게이션",
+    "페이지 리로드 없이 SPA 기준 라우팅 변경으로 동작",
+    "동등한 중요도의 섹션을 구분"
+  ],
+  "forbiddenRules": [
+    "아이콘 장식 사용 금지",
+    "이미지 사용 금지",
+    "서로 다른 계층 혼합 금지",
+    "과도한 개수 구성 지양(7개 이상 지양, 권장 2~6개)",
+    "페이지 리로드 금지",
+    "1개 탭 단독 노출 금지",
+    "탭 높이 변형 금지",
+    "배지를 클릭 액션으로 사용 금지",
+    "New 배지 영구 고정 금지",
+    "일반 페이지 구조 탭에 Close Button 사용 금지"
+  ],
+  "seeAlso": [
+    "badge",
+    "vertical-tab"
+  ],
+  "props": {
+    "activeTab": {
+      "type": "string",
+      "required": false
+    },
+    "className": {
+      "type": "string",
+      "required": false
+    },
+    "fullWidth": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "menus": {
+      "type": "object",
+      "required": false,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined",
+      "properties": {
+        "id": {
+          "type": "string",
+          "required": false
+        },
+        "label": {
+          "type": "string",
+          "required": false
+        },
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "lg",
+            "md",
+            "sm"
+          ]
+        },
+        "tabButtonType": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "button-primary",
+            "button-white",
+            "line-vertical",
+            "underline",
+            "underline-fill"
+          ]
+        },
+        "isActive": {
+          "type": "boolean",
+          "required": false
+        },
+        "badgeInfo": {
+          "type": "object",
+          "required": false,
+          "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/badge/Badge\").BadgeProps | undefined",
+          "properties": {
+            "label": {
+              "type": "string",
+              "required": true
+            },
+            "type": {
+              "type": "enum",
+              "required": false,
+              "values": [
+                "pill-dark-color",
+                "pill-outline"
+              ]
+            },
+            "color": {
+              "type": "enum",
+              "required": false,
+              "values": [
+                "blue",
+                "disabled",
+                "error",
+                "neutral",
+                "pink",
+                "success",
+                "warning"
+              ]
+            },
+            "className": {
+              "type": "string",
+              "required": false
+            },
+            "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
+                }
+              }
+            },
+            "size": {
+              "type": "enum",
+              "required": false,
+              "values": [
+                "md",
+                "sm",
+                "xs"
+              ]
+            }
+          }
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "onClick": {
+          "type": "function",
+          "required": false
+        }
+      },
+      "default": "[]"
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "lg",
+        "md",
+        "sm"
+      ],
+      "default": "sm"
+    },
+    "type": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "button-primary",
+        "button-white",
+        "underline",
+        "underline-fill"
+      ],
+      "default": "button-primary"
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-horizontal-tab",
+    "ncua-horizontal-tab--button-primary",
+    "ncua-horizontal-tab--button-white",
+    "ncua-horizontal-tab--fullWidth",
+    "ncua-horizontal-tab--lg",
+    "ncua-horizontal-tab--md",
+    "ncua-horizontal-tab--sm",
+    "ncua-horizontal-tab--underline",
+    "ncua-horizontal-tab--underline-fill",
+    "ncua-horizontal-tab__item"
+  ],
+  "usage": {
+    "import": "import { HorizontalTab } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<HorizontalTab />",
+      "size:lg": "<HorizontalTab size=\"lg\" />",
+      "size:md": "<HorizontalTab size=\"md\" />",
+      "size:sm": "<HorizontalTab size=\"sm\" />",
+      "type:button-primary": "<HorizontalTab type=\"button-primary\" />",
+      "type:button-white": "<HorizontalTab type=\"button-white\" />",
+      "type:underline": "<HorizontalTab type=\"underline\" />",
+      "type:underline-fill": "<HorizontalTab type=\"underline-fill\" />"
+    }
+  }
+}