@ncds/ui-admin-mcp 1.0.0-alpha.11 → 1.0.0-alpha.13

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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/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/nhn/Project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
     }
   },
   "html": {},

package/data/data-grid.json

@@ -0,0 +1,212 @@
+{
+  "name": "data-grid",
+  "exportName": "DataGrid",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "data-display",
+  "description": "DataGrid는 관리자 화면에서 대량의 데이터를 테이블 형태로 조회·관리하기 위한 핵심 컴포넌트입니다.",
+  "aliases": [
+    "DataGrid",
+    "데이터그리드",
+    "테이블",
+    "Table",
+    "Grid",
+    "조회결과",
+    "가로형",
+    "세로형",
+    "Header",
+    "Pagination",
+    "Filter",
+    "Sort",
+    "Action Button",
+    "Row Selection",
+    "Reorder",
+    "Expand",
+    "Collapse",
+    "Empty State",
+    "Badge",
+    "Checkbox",
+    "DataGrid.SearchFilter",
+    "DataGrid.Summary",
+    "DataGrid.FilterBar",
+    "DataGrid.ActionBar",
+    "DataGrid.Table",
+    "DataGrid.Pagination",
+    "variant",
+    "search-result",
+    "horizontal",
+    "position",
+    "align",
+    "fixedHeader",
+    "maxHeight",
+    "hoverable",
+    "selectable",
+    "NCDS"
+  ],
+  "hasChildren": true,
+  "whenToUse": [
+    "10개 이상 데이터 관리 화면에서 적용",
+    "관리자가 데이터를 조작하는 화면",
+    "대량 데이터 일괄 처리 화면"
+  ],
+  "forbiddenRules": [
+    "블록 내부 중첩 테이블 남발 금지",
+    "▲▼ 형태 정렬 UI 사용 금지",
+    "과도한 Badge/Icon 사용 금지",
+    "Row Height 임의 수정 금지",
+    "프로젝트별 임의 컬럼 정렬 변경 금지"
+  ],
+  "seeAlso": [
+    "button",
+    "checkbox",
+    "radio",
+    "pagination",
+    "badge",
+    "empty-state",
+    "block-container",
+    "table"
+  ],
+  "htmlElement": "div",
+  "props": {
+    "children": {
+      "type": "ReactNode",
+      "required": true
+    },
+    "variant": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "horizontal",
+        "search-result"
+      ],
+      "default": "search-result"
+    }
+  },
+  "subComponents": {
+    "DataGrid.SearchFilter": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": true
+        }
+      }
+    },
+    "DataGrid.Summary": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": true
+        }
+      }
+    },
+    "DataGrid.FilterBar": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": true
+        }
+      }
+    },
+    "DataGrid.ActionBar": {
+      "props": {
+        "align": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "left",
+            "right",
+            "space-between"
+          ],
+          "default": "space-between"
+        },
+        "children": {
+          "type": "ReactNode",
+          "required": true
+        },
+        "position": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "bottom",
+            "top"
+          ],
+          "default": "top"
+        }
+      }
+    },
+    "DataGrid.Table": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": true
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "fixedHeader": {
+          "type": "boolean",
+          "required": false
+        },
+        "hoverable": {
+          "type": "boolean",
+          "required": false
+        },
+        "maxHeight": {
+          "type": "string",
+          "required": false,
+          "rawType": "string | number | undefined"
+        },
+        "selectable": {
+          "type": "boolean",
+          "required": false
+        },
+        "type": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "horizontal",
+            "vertical"
+          ],
+          "default": "horizontal"
+        }
+      }
+    },
+    "DataGrid.Pagination": {
+      "props": {
+        "children": {
+          "type": "ReactNode",
+          "required": true
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-data-grid",
+    "ncua-data-grid--horizontal",
+    "ncua-data-grid--search-result",
+    "ncua-data-grid__action-bar",
+    "ncua-data-grid__action-bar ncua-data-grid__action-bar--bottom",
+    "ncua-data-grid__action-bar--bottom",
+    "ncua-data-grid__action-bar--left",
+    "ncua-data-grid__action-bar--right",
+    "ncua-data-grid__action-bar--space-between",
+    "ncua-data-grid__action-bar--top",
+    "ncua-data-grid__filter-bar",
+    "ncua-data-grid__pagination",
+    "ncua-data-grid__search-filter",
+    "ncua-data-grid__summary",
+    "ncua-data-grid__table",
+    "ncua-data-grid__table-wrapper",
+    "ncua-table--in-data-grid"
+  ],
+  "usage": {
+    "import": "import { DataGrid } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<DataGrid children=\"예시\" />",
+      "variant:horizontal": "<DataGrid variant=\"horizontal\" children=\"예시\" />",
+      "variant:search-result": "<DataGrid variant=\"search-result\" children=\"예시\" />"
+    }
+  }
+}