@ncds/ui-admin-mcp 1.0.0-alpha.20 → 1.0.0-alpha.22

package/bin/utils/tokenValidator.js

@@ -70,6 +70,32 @@ const buildTokenNameSet = (tokenData) => {
     }
     return names;
 };
+/** token prefix → 카테고리 역방향 맵 — invalid_token suggestion에 카테고리 명시용 */
+const buildPrefixCategoryMap = (tokenData) => {
+    const map = new Map();
+    for (const group of tokenData.groups) {
+        for (const token of group.tokens) {
+            const stripped = token.name.replace(/^--/, '');
+            const segments = stripped.split('-');
+            if (segments.length >= 2)
+                map.set(`--${segments.slice(0, 2).join('-')}`, group.category);
+            if (segments.length >= 1)
+                map.set(`--${segments[0]}`, group.category);
+        }
+    }
+    return map;
+};
+/** var 이름의 prefix에서 카테고리 추론 — 더 긴 prefix 우선 */
+const inferCategoryFromVarName = (varName, prefixCategoryMap) => {
+    const stripped = varName.replace(/^--/, '');
+    const segments = stripped.split('-');
+    if (segments.length >= 2) {
+        const cat = prefixCategoryMap.get(`--${segments.slice(0, 2).join('-')}`);
+        if (cat)
+            return cat;
+    }
+    return prefixCategoryMap.get(`--${segments[0]}`);
+};
 /** inline style + <style> 블록의 CSS 텍스트를 하나로 합침 */
 const extractAllCss = (root) => {
     const parts = [];
@@ -125,7 +151,7 @@ const collectTokenNotUsedErrors = (css, tokenValueMap) => {
     return { errors, missing };
 };
 /** var() 참조 → invalid_token 에러 수집 + correct 카운트 */
-const collectInvalidTokenErrors = (css, tokenNameSet, tokenPrefixSet) => {
+const collectInvalidTokenErrors = (css, tokenNameSet, tokenPrefixSet, prefixCategoryMap) => {
     const errors = [];
     let correct = 0;
     let invalid = 0;
@@ -139,12 +165,16 @@ const collectInvalidTokenErrors = (css, tokenNameSet, tokenPrefixSet) => {
         }
         else {
             invalid++;
+            const category = inferCategoryFromVarName(varName, prefixCategoryMap);
+            const suggestion = category
+                ? `Call get_design_tokens('${category}') to see available ${category} tokens.`
+                : 'Call get_design_tokens to see available tokens.';
             errors.push({
                 type: 'invalid_token',
                 target: `var(${varName})`,
                 component: '(inline-style)',
                 message: `Token '${varName}' does not exist in the design system.`,
-                suggestion: "Call get_design_tokens('color') to see available tokens.",
+                suggestion,
             });
         }
     }
@@ -155,7 +185,7 @@ const detectTokenIssues = (params) => {
     const { root, tokenData, tokenValueMap } = params;
     const allCss = extractAllCss(root);
     const notUsed = collectTokenNotUsedErrors(allCss, tokenValueMap);
-    const invalidResult = collectInvalidTokenErrors(allCss, buildTokenNameSet(tokenData), buildTokenPrefixSet(tokenData));
+    const invalidResult = collectInvalidTokenErrors(allCss, buildTokenNameSet(tokenData), buildTokenPrefixSet(tokenData), buildPrefixCategoryMap(tokenData));
     return {
         errors: [...notUsed.errors, ...invalidResult.errors],
         tokenUsage: { correct: invalidResult.correct, missing: notUsed.missing, invalid: invalidResult.invalid },

package/bin/version.d.ts

@@ -3,4 +3,4 @@
  * scripts/generate-version-ts.ts 가 ui-admin/package.json 의 version 으로부터 자동 생성한다.
  * 수동 편집 금지 — 빌드(`pnpm generate:version-ts` 또는 `pnpm build`) 시 덮어쓰여진다.
  */
-export declare const VERSION = "1.8.7";
+export declare const VERSION = "1.8.9";

package/bin/version.js

@@ -6,4 +6,4 @@ exports.VERSION = void 0;
  * scripts/generate-version-ts.ts 가 ui-admin/package.json 의 version 으로부터 자동 생성한다.
  * 수동 편집 금지 — 빌드(`pnpm generate:version-ts` 또는 `pnpm build`) 시 덮어쓰여진다.
  */
-exports.VERSION = '1.8.7';
+exports.VERSION = '1.8.9';

package/data/badge-group.json

@@ -129,7 +129,7 @@
     },
     "label": {
       "type": "string",
-      "required": true
+      "required": false
     },
     "leadingIcon": {
       "type": "object",
@@ -286,13 +286,13 @@
   "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=\"\" />"
+      "default": "<BadgeGroup groupLabel=\"\" />",
+      "color:error": "<BadgeGroup color=\"error\" groupLabel=\"\" />",
+      "color:neutral": "<BadgeGroup color=\"neutral\" groupLabel=\"\" />",
+      "color:success": "<BadgeGroup color=\"success\" groupLabel=\"\" />",
+      "color:warning": "<BadgeGroup color=\"warning\" groupLabel=\"\" />",
+      "size:sm": "<BadgeGroup size=\"sm\" groupLabel=\"\" />",
+      "size:xs": "<BadgeGroup size=\"xs\" groupLabel=\"\" />"
     }
   }
 }

package/data/badge.json

@@ -76,7 +76,7 @@
     },
     "label": {
       "type": "string",
-      "required": true
+      "required": false
     },
     "leadingIcon": {
       "type": "object",
@@ -218,6 +218,7 @@
       "type": "enum",
       "required": false,
       "values": [
+        "new-badge",
         "pill-dark-color",
         "pill-outline"
       ],
@@ -232,6 +233,8 @@
     "ncua-badge--error",
     "ncua-badge--md",
     "ncua-badge--neutral",
+    "ncua-badge--new-badge",
+    "ncua-badge--new-badge-",
     "ncua-badge--pill-dark-color",
     "ncua-badge--pill-outline",
     "ncua-badge--pink",
@@ -244,19 +247,20 @@
   "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=\"\" />"
+      "default": "<Badge />",
+      "color:blue": "<Badge color=\"blue\" />",
+      "color:disabled": "<Badge color=\"disabled\" />",
+      "color:error": "<Badge color=\"error\" />",
+      "color:neutral": "<Badge color=\"neutral\" />",
+      "color:pink": "<Badge color=\"pink\" />",
+      "color:success": "<Badge color=\"success\" />",
+      "color:warning": "<Badge color=\"warning\" />",
+      "size:md": "<Badge size=\"md\" />",
+      "size:sm": "<Badge size=\"sm\" />",
+      "size:xs": "<Badge size=\"xs\" />",
+      "type:new-badge": "<Badge type=\"new-badge\" />",
+      "type:pill-dark-color": "<Badge type=\"pill-dark-color\" />",
+      "type:pill-outline": "<Badge type=\"pill-outline\" />"
     }
   }
 }

package/data/bread-crumb.json

@@ -58,6 +58,7 @@
       "type": "object",
       "required": true,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/navigation/bread-crumb/BreadCrumb\").BreadcrumbItemProps[]",
+      "isArray": true,
       "properties": {
         "href": {
           "type": "string",

package/data/combo-box.json

@@ -88,6 +88,10 @@
       "type": "function",
       "required": false
     },
+    "onComplete": {
+      "type": "function",
+      "required": false
+    },
     "onEdit": {
       "type": "function",
       "required": false
@@ -100,6 +104,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "isArray": true,
       "properties": {
         "id": {
           "type": "string",

package/data/dropdown.json

@@ -116,11 +116,13 @@
       "type": "object",
       "required": true,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownGroup[]",
+      "isArray": true,
       "properties": {
         "items": {
           "type": "object",
           "required": true,
           "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownItemType[]",
+          "isArray": true,
           "properties": {
             "id": {
               "type": "string",

package/data/file-input.json

@@ -64,7 +64,8 @@
     "hintItems": {
       "type": "object",
       "required": false,
-      "rawType": "string[] | undefined"
+      "rawType": "string[] | undefined",
+      "isArray": true
     },
     "hintText": {
       "type": "string",
@@ -299,7 +300,8 @@
     "value": {
       "type": "object",
       "required": false,
-      "rawType": "File[] | undefined"
+      "rawType": "File[] | undefined",
+      "isArray": true
     }
   },
   "html": {},

package/data/horizontal-tab.json

@@ -61,6 +61,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined",
+      "isArray": true,
       "properties": {
         "id": {
           "type": "string",
@@ -101,12 +102,13 @@
           "properties": {
             "label": {
               "type": "string",
-              "required": true
+              "required": false
             },
             "type": {
               "type": "enum",
               "required": false,
               "values": [
+                "new-badge",
                 "pill-dark-color",
                 "pill-outline"
               ]

package/data/image-file-input.json

@@ -67,7 +67,8 @@
     "hintItems": {
       "type": "object",
       "required": false,
-      "rawType": "string[] | undefined"
+      "rawType": "string[] | undefined",
+      "isArray": true
     },
     "hintText": {
       "type": "string",
@@ -322,7 +323,8 @@
     "value": {
       "type": "object",
       "required": false,
-      "rawType": "File[] | undefined"
+      "rawType": "File[] | undefined",
+      "isArray": true
     }
   },
   "html": {},
@@ -338,6 +340,7 @@
     "ncua-image-file-input__empty-slot-wrapper",
     "ncua-image-file-input__preview-container",
     "ncua-image-file-input__previews",
+    "ncua-image-file-input__slot-tooltip",
     "ncua-input__help-icon"
   ],
   "usage": {

package/data/notification.json

@@ -46,6 +46,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
+      "isArray": true,
       "properties": {
         "label": {
           "type": "string",

package/data/page-title.json

@@ -57,6 +57,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/layout/page-title/PageTitle\").PageTitleBreadcrumbItem[] | undefined",
+      "isArray": true,
       "properties": {
         "label": {
           "type": "string",

package/data/progress-bar.json

@@ -53,6 +53,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/feedback-and-status/progress-bar/types\").ProgressSegment[] | undefined",
+      "isArray": true,
       "properties": {
         "value": {
           "type": "number",

package/data/range-date-picker-with-buttons.json

@@ -2,7 +2,7 @@
   "name": "range-date-picker-with-buttons",
   "exportName": "RangeDatePickerWithButtons",
   "importPath": "@ncds/ui-admin",
-  "jsRequired": false,
+  "jsRequired": true,
   "category": "forms-and-input",
   "description": "기간 옵션 버튼이 내장된 RangeDatePicker 확장 컴포넌트로 빠른 기간 설정을 지원합니다",
   "aliases": [
@@ -126,7 +126,8 @@
     "periodKeys": {
       "type": "object",
       "required": true,
-      "rawType": "(keyof T & string)[]"
+      "rawType": "(keyof T & string)[]",
+      "isArray": true
     },
     "setCurrentButtonId": {
       "type": "function",

package/data/range-date-picker.json

@@ -2,7 +2,7 @@
   "name": "range-date-picker",
   "exportName": "RangeDatePicker",
   "importPath": "@ncds/ui-admin",
-  "jsRequired": false,
+  "jsRequired": true,
   "category": "forms-and-input",
   "description": "RangeDatePicker는 시작일~종료일 기간 범위를 선택해야 하는 경우 사용하는 복합 선택 위젯입니다. 검색 기간 설정, 노출 기간 설정, 이벤트 기간 설정 등 두 날짜의 쌍(Pair)이 필요한 모든 상황에서 사용합니다.",
   "aliases": [

package/data/select-box.json

@@ -109,6 +109,10 @@
       "type": "function",
       "required": false
     },
+    "onComplete": {
+      "type": "function",
+      "required": false
+    },
     "onEdit": {
       "type": "function",
       "required": false
@@ -117,6 +121,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "isArray": true,
       "properties": {
         "id": {
           "type": "string",

package/data/select.json

@@ -58,6 +58,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "isArray": true,
       "properties": {
         "id": {
           "type": "string",

package/data/table.json

@@ -226,12 +226,14 @@
         "minWidths": {
           "type": "object",
           "required": false,
-          "rawType": "(string | number)[] | undefined"
+          "rawType": "(string | number)[] | undefined",
+          "isArray": true
         },
         "widths": {
           "type": "object",
           "required": true,
-          "rawType": "(string | number)[]"
+          "rawType": "(string | number)[]",
+          "isArray": true
         }
       }
     },

package/data/tooltip.json

@@ -87,6 +87,10 @@
       ],
       "default": "stroke"
     },
+    "panelClassName": {
+      "type": "string",
+      "required": false
+    },
     "position": {
       "type": "enum",
       "required": false,

package/data/vertical-tab.json

@@ -60,6 +60,7 @@
       "type": "object",
       "required": false,
       "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined",
+      "isArray": true,
       "properties": {
         "id": {
           "type": "string",
@@ -100,12 +101,13 @@
           "properties": {
             "label": {
               "type": "string",
-              "required": true
+              "required": false
             },
             "type": {
               "type": "enum",
               "required": false,
               "values": [
+                "new-badge",
                 "pill-dark-color",
                 "pill-outline"
               ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncds/ui-admin-mcp",
-  "version": "1.0.0-alpha.20",
+  "version": "1.0.0-alpha.22",
   "description": "NCDS UI Admin MCP 서버 — AI 에이전트가 NCUA 컴포넌트를 조회하고 HTML을 검증할 수 있는 MCP 서버",
   "bin": {
     "ncua-mcp": "./bin/server.mjs"
@@ -12,7 +12,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "extract": "tsx scripts/extract-mcp-data.ts",

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 이상
 
 ## 확인 방법