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

package/data/toggle.json

@@ -3,7 +3,7 @@
   "exportName": "Toggle",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "input",
+  "category": "forms-and-input",
   "description": "Toggle은 단일 기능의 활성/비활성 상태를 즉시 전환하는 컨트롤입니다. 설정 값의 ON/OFF, 수신 여부, 사용 여부 등 즉각 반영되는 상태 전환 UI에 사용합니다.",
   "aliases": [
     "Toggle",
@@ -65,7 +65,7 @@
         "md",
         "sm"
       ],
-      "default": "md"
+      "default": "sm"
     },
     "supportText": {
       "type": "string",

package/data/tooltip.json

@@ -3,7 +3,7 @@
   "exportName": "Tooltip",
   "importPath": "@ncds/ui-admin",
   "jsRequired": true,
-  "category": "overlay",
+  "category": "overlays",
   "description": "Tooltip은 항목, 데이터, 기능 등에 대해 추가 설명이 필요한 경우 보조 정보를 제공하는 말풍선 내 UI 컴포넌트입니다.",
   "aliases": [
     "Tooltip",
@@ -50,6 +50,15 @@
       "type": "ReactNode",
       "required": false
     },
+    "disablePortal": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "forceVisible": {
+      "type": "boolean",
+      "required": false
+    },
     "hideArrow": {
       "type": "boolean",
       "required": false,
@@ -78,6 +87,10 @@
       ],
       "default": "stroke"
     },
+    "panelClassName": {
+      "type": "string",
+      "required": false
+    },
     "position": {
       "type": "enum",
       "required": false,
@@ -114,7 +127,7 @@
         "black",
         "white"
       ],
-      "default": "black"
+      "default": "white"
     },
     "type": {
       "type": "enum",
@@ -124,6 +137,10 @@
         "short"
       ],
       "default": "short"
+    },
+    "zIndex": {
+      "type": "number",
+      "required": false
     }
   },
   "html": {},
@@ -149,9 +166,9 @@
     "ncua-tooltip--top-left",
     "ncua-tooltip--top-right",
     "ncua-tooltip--white",
+    "ncua-tooltip-panel",
     "ncua-tooltip__bg",
     "ncua-tooltip__bg--force-hidden",
-    "ncua-tooltip__bg--measuring",
     "ncua-tooltip__bg--visible",
     "ncua-tooltip__close-button",
     "ncua-tooltip__content",

package/data/vertical-tab.json

@@ -2,7 +2,7 @@
   "name": "vertical-tab",
   "exportName": "VerticalTab",
   "importPath": "@ncds/ui-admin",
-  "jsRequired": true,
+  "jsRequired": false,
   "category": "navigation",
   "description": "VerticalTab은 동일한 계층 구조의 관련 콘텐츠를 그룹화하여 동일 화면 내에서 콘텐츠를 전환하는 내비게이션 UI 컴포넌트입니다.",
   "aliases": [
@@ -57,9 +57,226 @@
       "default": "pc"
     },
     "menus": {
-      "type": "string",
+      "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined"
+      "rawType": "import(\"/Users/nhn/Project/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/nhn/Project/ncds/packages/ui-admin/src/components/feedback-and-status/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/nhn/Project/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
+                }
+              }
+            },
+            "trailingIcon": {
+              "type": "object",
+              "required": false,
+              "rawType": "import(\"/Users/nhn/Project/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
+                }
+              }
+            },
+            "size": {
+              "type": "enum",
+              "required": false,
+              "values": [
+                "md",
+                "sm",
+                "xs"
+              ]
+            }
+          }
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "onClick": {
+          "type": "function",
+          "required": false
+        }
+      }
     },
     "onSelect": {
       "type": "function",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncds/ui-admin-mcp",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.21",
   "description": "NCDS UI Admin MCP 서버 — AI 에이전트가 NCUA 컴포넌트를 조회하고 HTML을 검증할 수 있는 MCP 서버",
   "bin": {
     "ncua-mcp": "./bin/server.mjs"
@@ -12,19 +12,22 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "extract": "tsx scripts/extract-mcp-data.ts",
     "extract:icons": "tsx scripts/extract-icons.ts",
     "extract:tokens": "tsx scripts/extract-design-tokens.ts",
     "generate:cdn-meta": "tsx scripts/generate-cdn-meta.ts",
+    "generate:version-ts": "tsx scripts/generate-version-ts.ts",
     "build:bundle": "tsx scripts/build-bundle.ts",
-    "build:server": "tsc --project tsconfig.json && rm -rf bin/definitions && cp -r src/definitions bin/definitions",
-    "build": "yarn extract && yarn extract:icons && yarn extract:tokens && yarn generate:cdn-meta && yarn build:bundle && yarn build:server",
+    "build:server": "mkdir -p bin && rm -rf bin/definitions bin/overrides && cp -r src/definitions bin/definitions && cp -r src/overrides bin/overrides && find bin/definitions -name '*.ts' -delete && tsc --project tsconfig.json",
+    "build": "pnpm extract && pnpm extract:icons && pnpm extract:tokens && pnpm generate:cdn-meta && pnpm generate:version-ts && pnpm build:bundle && pnpm build:server",
+    "check-meta": "tsx scripts/check-meta-coherence.ts",
     "test": "vitest run --config vitest.config.ts",
     "test:coverage": "vitest run --coverage --config vitest.config.ts",
-    "publish:npm": "npm publish --access=public"
+    "publish:npm": "pnpm run build && npm publish --access=public",
+    "publish:npm:alpha": "pnpm run build && npm publish --access=public --tag alpha"
   },
   "keywords": [
     "ncds",
@@ -36,36 +39,35 @@
   "license": "SEE LICENSE IN LICENSE",
   "private": false,
   "dependencies": {
+    "@atlaskit/pragmatic-drag-and-drop": "1.8.1",
+    "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "2.1.0",
+    "@atlaskit/pragmatic-drag-and-drop-hitbox": "1.1.0",
+    "@atlaskit/pragmatic-drag-and-drop-react-accessibility": "1.1.4",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@ncds/ui-admin-icon": "0.1.9",
+    "classnames": "2.5.1",
+    "dompurify": "3.4.1",
+    "flatpickr": "4.6.13",
     "jsdom": "^26.1.0",
+    "lodash": "4.18.1",
+    "lodash-es": "4.18.1",
+    "moment": "2.30.1",
     "node-html-parser": "^7.1.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
+    "react-flatpickr": "4.0.11",
+    "swiper": "12.1.3",
     "zod": "^4.3.6"
   },
-  "peerDependencies": {
-    "flatpickr": ">=4.6.0",
-    "lodash-es": ">=4.17.0",
-    "moment": ">=2.30.0",
-    "swiper": ">=11.0.0"
-  },
-  "peerDependenciesMeta": {
-    "flatpickr": {
-      "optional": true
-    },
-    "lodash-es": {
-      "optional": true
-    },
-    "moment": {
-      "optional": true
-    },
-    "swiper": {
-      "optional": true
-    }
-  },
   "devDependencies": {
+    "@ncds/ui-admin": "workspace:*",
+    "@types/lodash": "^4.17.24",
     "@types/node": "^25.5.0",
     "@types/react": "^18.3.20",
-    "ts-morph": "^27.0.2"
+    "esbuild": "^0.28.0",
+    "ts-morph": "^27.0.2",
+    "tsx": "^4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "^4.1.4"
   }
 }

package/templates/README.md

@@ -23,7 +23,7 @@ cp node_modules/@ncds/ui-admin-mcp/templates/.mcp.json.example .mcp.json
 
 ## 요구사항
 
-- Node.js 20 이상
+- Node.js 22 이상
 
 ## 확인 방법
 

package/bin/instructions.d.ts

@@ -1 +0,0 @@
-export declare const INSTRUCTIONS: string;

package/bin/instructions.js

@@ -1,14 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.INSTRUCTIONS = void 0;
-/**
- * AI 에이전트가 MCP 서버 연결 시 자동으로 수신하는 필수 지침.
- * definitions/instructions.md에서 로드한다.
- */
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const INSTRUCTIONS_PATH = path_1.default.resolve(__dirname, 'definitions', 'instructions.md');
-exports.INSTRUCTIONS = fs_1.default.readFileSync(INSTRUCTIONS_PATH, 'utf-8').trim();

package/bin/tools/getComponentHtml.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentData } from '../types.js';
-import { type McpToolResponse } from '../utils/response.js';
-export declare const getComponentHtml: (componentMap: Map<string, ComponentData>, name: string, variant?: Record<string, string>) => McpToolResponse;

package/bin/tools/getComponentHtml.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getComponentHtml = void 0;
-/**
- * get_component_html tool — 컴포넌트 HTML 스니펫 반환 (순수 함수)
- */
-const dataLoader_js_1 = require("../utils/dataLoader.js");
-const response_js_1 = require("../utils/response.js");
-/** default HTML에서 태그명 추출 */
-const extractTag = (defaultHtml) => {
-    const match = defaultHtml.match(/^<(\w+)/);
-    return match ? match[1] : 'div';
-};
-const getComponentHtml = (componentMap, name, variant) => {
-    const normalized = (0, response_js_1.normalizeName)(name);
-    const component = (0, dataLoader_js_1.getComponent)(componentMap, normalized);
-    if (!component)
-        return (0, response_js_1.componentNotFoundResponse)(normalized);
-    if (!variant || Object.keys(variant).length === 0) {
-        return (0, response_js_1.successResponse)(component.html);
-    }
-    const rootClass = component.bemClasses.find((c) => !c.includes('--') && !c.includes('__')) ?? `ncua-${normalized}`;
-    const tag = extractTag(component.html.default);
-    const modifiers = Object.values(variant).map((v) => `${rootClass}--${v}`);
-    const classes = [rootClass, ...modifiers].join(' ');
-    const isVoid = /^<\w+\s[^>]*\/>$/.test(component.html.default);
-    const html = isVoid ? `<${tag} class="${classes}" />` : `<${tag} class="${classes}"></${tag}>`;
-    return (0, response_js_1.successResponse)({ variant, html });
-};
-exports.getComponentHtml = getComponentHtml;