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

package/bin/utils/dataLoader.d.ts

@@ -8,7 +8,6 @@ export interface CdnMeta {
 export interface IconMeta {
     packageName: string;
     version: string;
-    cdn: string;
 }
 /** data/ 디렉토리의 JSON 파일을 읽어 componentMap으로 반환 */
 export declare const loadComponentsFromDir: (dataDir: string) => Map<string, ComponentData>;

package/bin/utils/dataLoader.js

@@ -27,30 +27,22 @@ const isValidIconJson = (data) => !!data && typeof data === 'object' && 'icons'
 /** data/ 디렉토리의 JSON 파일을 읽어 componentMap으로 반환 */
 const loadComponentsFromDir = (dataDir) => {
     if (!fs_1.default.existsSync(dataDir)) {
-        logger_js_1.logger.error(`mcp/data/ 디렉토리가 없습니다: ${dataDir}`);
-        process.exit(1);
+        throw new Error(`mcp/data/ 디렉토리가 없습니다: ${dataDir}`);
     }
     const jsonFiles = fs_1.default.readdirSync(dataDir).filter((f) => f.endsWith('.json') && !f.startsWith('_'));
     if (jsonFiles.length === 0) {
-        logger_js_1.logger.error(`mcp/data/ 디렉토리에 JSON 파일이 없습니다: ${dataDir}`);
-        process.exit(1);
+        throw new Error(`mcp/data/ 디렉토리에 JSON 파일이 없습니다: ${dataDir}`);
     }
     const map = new Map();
     for (const file of jsonFiles) {
         const filePath = path_1.default.join(dataDir, file);
-        try {
-            const raw = fs_1.default.readFileSync(filePath, 'utf-8');
-            const parsed = JSON.parse(raw);
-            if (!isValidComponentJson(parsed)) {
-                throw new Error('name 필드가 없거나 올바르지 않습니다');
-            }
-            const component = parsed;
-            map.set(component.name, component);
-        }
-        catch (err) {
-            logger_js_1.logger.error(`JSON 파싱 실패 (${file}): ${(0, response_js_1.toErrorMessage)(err)}`);
-            process.exit(1);
+        const raw = fs_1.default.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!isValidComponentJson(parsed)) {
+            throw new Error(`JSON 파싱 실패 (${file}): name 필드가 없거나 올바르지 않습니다`);
         }
+        const component = parsed;
+        map.set(component.name, component);
     }
     logger_js_1.logger.info(`컴포넌트 ${map.size}개 로딩 완료`);
     return map;

package/bin/utils/domEnvironment.js

@@ -46,6 +46,7 @@ const setupDomEnvironment = () => {
         globalThis.document = dom.window.document;
     if (typeof globalThis.window === 'undefined')
         globalThis.window = dom.window;
+    /* v8 ignore next 3 -- Node.js 환경에서 navigator 미존재 시 설정. 테스트 실행 순서에 따라 이미 설정된 경우 스킵 */
     if (typeof globalThis.navigator === 'undefined') {
         Object.defineProperty(globalThis, 'navigator', { value: dom.window.navigator, writable: true });
     }

package/bin/utils/fuzzyMatch.d.ts

@@ -5,6 +5,10 @@
  * - 부분 포함 ("비번" ⊂ "비밀번호"는 안 되지만, "로딩" ⊂ "로딩중"은 됨)
  * - 편집 거리(Levenshtein) 기반 오타 허용 ("셀랙트" ↔ "셀렉트", "buttn" ↔ "button")
  */
+/** Levenshtein 편집 거리 */
+export declare const editDistance: (a: string, b: string) => number;
+/** 편집 거리 기반 유사도 (0~1, 1이 완전 일치) */
+export declare const similarity: (a: string, b: string) => number;
 export interface FuzzyResult {
     score: number;
     matchType: 'exact' | 'contains' | 'fuzzy';

package/bin/utils/fuzzyMatch.js

@@ -7,7 +7,7 @@
  * - 편집 거리(Levenshtein) 기반 오타 허용 ("셀랙트" ↔ "셀렉트", "buttn" ↔ "button")
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bestFuzzyMatch = exports.fuzzyMatch = void 0;
+exports.bestFuzzyMatch = exports.fuzzyMatch = exports.similarity = exports.editDistance = void 0;
 // ── 상수 ──────────────────────────────────────────────────────────
 /** 포함 매칭 시 기본 점수 */
 const CONTAINS_BASE_SCORE = 0.7;
@@ -49,6 +49,15 @@ const editDistance = (a, b) => {
     }
     return prev[n];
 };
+exports.editDistance = editDistance;
+/** 편집 거리 기반 유사도 (0~1, 1이 완전 일치) */
+const similarity = (a, b) => {
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1;
+    return 1 - (0, exports.editDistance)(a, b) / maxLen;
+};
+exports.similarity = similarity;
 /**
  * query가 target에 매칭되는지 퍼지 검사
  *
@@ -71,7 +80,7 @@ const fuzzyMatch = (query, target) => {
     // 3. 편집 거리 기반 퍼지 매칭
     const isShortQuery = q.length <= SHORT_QUERY_LENGTH;
     const typoThreshold = isShortQuery ? 1 : Math.ceil(q.length * TYPO_THRESHOLD_RATIO);
-    const dist = editDistance(q, t);
+    const dist = (0, exports.editDistance)(q, t);
     // target이 query보다 훨씬 길면, 부분 문자열 슬라이딩 윈도우로 비교
     const targetIsLonger = t.length > q.length + LENGTH_DIFF_FOR_SUBSTRING;
     const queryIsLongEnough = q.length >= SHORT_QUERY_LENGTH;
@@ -80,7 +89,7 @@ const fuzzyMatch = (query, target) => {
     if (shouldTrySubstringMatch) {
         for (let i = 0; i <= t.length - q.length; i++) {
             const sub = t.substring(i, i + q.length);
-            const subDist = editDistance(q, sub);
+            const subDist = (0, exports.editDistance)(q, sub);
             if (subDist <= typoThreshold) {
                 const subSimilarity = q.length === 0 ? 1 : 1 - subDist / q.length;
                 return { score: SUBSTRING_BASE_SCORE + SUBSTRING_BONUS_MULTIPLIER * subSimilarity, matchType: 'fuzzy' };

package/bin/utils/logger.d.ts

@@ -1,15 +1,15 @@
 /**
  * stderr 전용 logger 유틸리티 — 부수효과 함수 (stderr I/O)
  *
- * ⚠️ console.log / console.warn / console.error 직접 사용 금지
+ * console.log / console.warn / console.error 직접 사용 금지.
  *
- * MCP stdio 프로토콜은 채널 역할이 엄격히 분리됩니다.
+ * MCP stdio 프로토콜은 채널 역할이 엄격히 분리된다.
  *   stdin  → 클라이언트 → 서버 요청(JSON-RPC)
- *   stdout → 서버 → 클라이언트 응답(JSON-RPC) ← 프로토콜 전용 채널
+ *   stdout → 서버 → 클라이언트 응답(JSON-RPC). 프로토콜 전용 채널
  *   stderr → 로그 전용 (프로토콜 밖)
  *
- * console.log는 stdout에 출력되어 JSON-RPC 스트림을 오염시킵니다.
- * 모든 로깅은 반드시 이 logger를 통해 stderr로 출력해야 합니다.
+ * console.log는 stdout을 오염시켜 JSON-RPC 스트림을 깨뜨린다.
+ * 모든 로깅은 이 logger를 통해 stderr로 출력한다.
  */
 export declare const logger: {
     info: (msg: string) => void;

package/bin/utils/logger.js

@@ -4,15 +4,15 @@ exports.logger = void 0;
 /**
  * stderr 전용 logger 유틸리티 — 부수효과 함수 (stderr I/O)
  *
- * ⚠️ console.log / console.warn / console.error 직접 사용 금지
+ * console.log / console.warn / console.error 직접 사용 금지.
  *
- * MCP stdio 프로토콜은 채널 역할이 엄격히 분리됩니다.
+ * MCP stdio 프로토콜은 채널 역할이 엄격히 분리된다.
  *   stdin  → 클라이언트 → 서버 요청(JSON-RPC)
- *   stdout → 서버 → 클라이언트 응답(JSON-RPC) ← 프로토콜 전용 채널
+ *   stdout → 서버 → 클라이언트 응답(JSON-RPC). 프로토콜 전용 채널
  *   stderr → 로그 전용 (프로토콜 밖)
  *
- * console.log는 stdout에 출력되어 JSON-RPC 스트림을 오염시킵니다.
- * 모든 로깅은 반드시 이 logger를 통해 stderr로 출력해야 합니다.
+ * console.log는 stdout을 오염시켜 JSON-RPC 스트림을 깨뜨린다.
+ * 모든 로깅은 이 logger를 통해 stderr로 출력한다.
  */
 exports.logger = {
     info: (msg) => {

package/data/_meta.json

@@ -1,12 +1,11 @@
 {
   "cdn": {
-    "version": "1.6",
-    "css": "https://fe-sdk.cdn-nhncommerce.com/@ncds/ui-admin/1.6/main.min.css",
-    "js": "https://fe-sdk.cdn-nhncommerce.com/@ncds/ui-admin/1.6/main.min.js"
+    "version": "1.8",
+    "css": "https://fe-sdk.cdn-nhncommerce.com/@ncds/ui-admin/1.8/main.min.css",
+    "js": "https://fe-sdk.cdn-nhncommerce.com/@ncds/ui-admin/1.8/main.min.js"
   },
   "icon": {
     "packageName": "@ncds/ui-admin-icon",
-    "version": "0.1",
-    "cdn": "https://fe-sdk.cdn-nhncommerce.com/@ncds/ui-admin-icon/0.1/main.min.js"
+    "version": "0.1"
   }
 }

package/data/badge-group.json

@@ -59,7 +59,7 @@
     "groupIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -68,7 +68,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",
@@ -133,7 +134,7 @@
     "leadingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -142,7 +143,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",
@@ -209,7 +211,7 @@
     "trailingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -218,7 +220,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",

package/data/badge.json

@@ -3,7 +3,7 @@
   "exportName": "Badge",
   "importPath": "@ncds/ui-admin",
   "jsRequired": false,
-  "category": "feedback",
+  "category": "data-display",
   "description": "Badge는 상태나 중요성 및 이벤트 강조를 나타내는 레이블이며 빠른 인식을 제공해야 합니다.",
   "aliases": [
     "Badge",
@@ -19,27 +19,41 @@
     "dot",
     "강조",
     "읽기전용",
+    "Icon_new",
+    "icon-new",
+    "new-badge",
+    "new-mark",
+    "newMark",
+    "NEW 뱃지",
+    "NEW 배지",
+    "N 뱃지",
+    "N 배지",
+    "N 표시",
+    "New표시",
+    "신규표시",
+    "신규 뱃지",
+    "신규 마크",
+    "신규 아이콘",
+    "new 아이콘",
     "NCDS"
   ],
   "hasChildren": false,
-  "whenToUse": [
-    "읽기 전용 상태 표시 레이블",
-    "정보의 상태/중요도/이벤트를 시각적으로 빠르게 전달"
-  ],
+  "whenToUse": [],
   "forbiddenRules": [
     "클릭 액션 부여 금지",
     "과도한 컬러 남용 금지",
     "의미 없는 Badge 사용 금지",
-    "텍스트 과다 금지(2~4자 권장)",
+    "텍스트 과다 금지",
     "이미지 삽입 금지",
-    "임의 아이콘 금지(SideSlotType 구조체만 사용)",
-    "컬러 의미 혼용 금지"
+    "임의 아이콘 금지",
+    "컬러 의미 혼용 금지",
+    "상태 표시에 Tag 사용 금지",
+    "테이블 내 xs 외 사이즈 사용 금지"
   ],
   "seeAlso": [
+    "icon",
     "horizontal-tab",
-    "vertical-tab",
-    "badge-group",
-    "tag"
+    "vertical-tab"
   ],
   "props": {
     "className": {
@@ -67,7 +81,7 @@
     "leadingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -76,7 +90,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",
@@ -134,12 +149,12 @@
         "sm",
         "xs"
       ],
-      "default": "sm"
+      "default": "xs"
     },
     "trailingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -148,7 +163,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",

package/data/bread-crumb.json

@@ -57,7 +57,7 @@
     "items": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/bread-crumb/BreadCrumb\").BreadCrumbItemProps[]",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/components/bread-crumb/BreadCrumb\").BreadcrumbItemProps[]",
       "properties": {
         "href": {
           "type": "string",

package/data/button-group.json

@@ -50,6 +50,11 @@
       "required": false,
       "default": false
     },
+    "fullWidth": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
     "hasBorder": {
       "type": "boolean",
       "required": false,
@@ -72,6 +77,50 @@
       "default": "xs"
     }
   },
+  "subComponents": {
+    "ButtonGroup.Item": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "icon": {
+          "type": "string",
+          "required": false,
+          "rawType": "SideSlot | undefined"
+        },
+        "isCurrent": {
+          "type": "boolean",
+          "required": false
+        },
+        "label": {
+          "type": "string",
+          "required": false
+        },
+        "onlyIcon": {
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "md",
+            "sm",
+            "xs",
+            "xxs"
+          ],
+          "default": "xs"
+        }
+      }
+    }
+  },
   "html": {},
   "bemClasses": [
     "ncua-button-group",

package/data/button.json

@@ -77,7 +77,7 @@
     "leadingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -86,7 +86,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",
@@ -136,6 +137,10 @@
         }
       }
     },
+    "loading": {
+      "type": "boolean",
+      "required": false
+    },
     "onlyIcon": {
       "type": "boolean",
       "required": false
@@ -153,7 +158,7 @@
     "trailingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -162,7 +167,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         },
         "color": {
           "type": "enum",
@@ -234,6 +240,7 @@
     "ncua-btn--xs",
     "ncua-btn--xxs",
     "ncua-btn__label",
+    "ncua-btn__spinner",
     "ncua-button-close-x",
     "ncua-button-stepper"
   ],

package/data/carousel-arrow.json

@@ -50,11 +50,6 @@
       "type": "function",
       "required": false
     },
-    "size": {
-      "type": "string",
-      "required": true,
-      "rawType": "\"md\""
-    },
     "type": {
       "type": "enum",
       "required": false,
@@ -77,11 +72,11 @@
   "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=\"\" />"
+      "default": "<CarouselArrow chevron=\"left\" />",
+      "chevron:left": "<CarouselArrow chevron=\"left\" />",
+      "chevron:right": "<CarouselArrow chevron=\"right\" />",
+      "type:default": "<CarouselArrow type=\"default\" chevron=\"left\" />",
+      "type:line": "<CarouselArrow type=\"line\" chevron=\"left\" />"
     }
   }
 }

package/data/carousel-number-group.json

@@ -53,14 +53,6 @@
       "required": false,
       "default": true
     },
-    "size": {
-      "type": "enum",
-      "required": false,
-      "values": [
-        "sm"
-      ],
-      "default": "sm"
-    },
     "totalPage": {
       "type": "number",
       "required": true
@@ -71,7 +63,6 @@
     "ncua-carousel-number-group",
     "ncua-carousel-number-group--dark",
     "ncua-carousel-number-group--light",
-    "ncua-carousel-number-group--sm",
     "ncua-carousel-number-group__number",
     "ncua-carousel-number-group__total"
   ],
@@ -80,8 +71,7 @@
     "react": {
       "default": "<CarouselNumberGroup currentPage={0} totalPage={0} />",
       "color:dark": "<CarouselNumberGroup color=\"dark\" currentPage={0} totalPage={0} />",
-      "color:light": "<CarouselNumberGroup color=\"light\" currentPage={0} totalPage={0} />",
-      "size:sm": "<CarouselNumberGroup size=\"sm\" currentPage={0} totalPage={0} />"
+      "color:light": "<CarouselNumberGroup color=\"light\" currentPage={0} totalPage={0} />"
     }
   }
 }

package/data/combo-box.json

@@ -92,7 +92,7 @@
     "optionItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
       "properties": {
         "id": {
           "type": "string",
@@ -105,7 +105,8 @@
         },
         "icon": {
           "type": "function",
-          "required": false
+          "required": false,
+          "semantic": "icon-component"
         }
       },
       "default": "[]"
@@ -118,7 +119,7 @@
     "register": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
     },
     "required": {
       "type": "boolean",
@@ -147,7 +148,7 @@
     "value": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
     }
   },
   "html": {},