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

package/bin/utils/dataLoader.js

@@ -3,57 +3,142 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAllComponents = exports.getComponent = exports.loadInstructions = exports.loadComplianceRules = exports.loadTokenData = exports.loadMeta = exports.loadIconData = exports.loadComponentsFromDir = exports.DEFAULT_DATA_DIR = void 0;
+exports.loadTokenData = exports.loadMeta = exports.loadJsApi = exports.loadInstructions = exports.loadIconData = exports.loadComponentsFromDir = exports.loadCompositionOverrides = exports.loadComplianceRules = exports.getComponent = exports.getAllComponents = exports.DEFAULT_DATA_DIR = void 0;
 /**
  * dataLoader — mcp/data/*.json + definitions/ 파일을 읽어 반환
  *
  * 함수 분류:
- *   loadComponentsFromDir, loadIconData, loadCdnMeta, loadInstructions → 부수효과 (fs I/O)
+ *   loadComponentsFromDir, loadCompositionOverrides, loadIconData, loadCdnMeta, loadInstructions → 부수효과 (fs I/O)
  *   getComponent, getAllComponents → 순수 함수 (Map 조회)
  *
- * Map 소유권은 server.ts가 가진다. 이 파일은 상태를 보유하지 않는다.
+ * Map + 메타데이터 소유권은 server.ts가 가진다. 이 파일은 상태를 보유하지 않는다.
  */
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const logger_js_1 = require("./logger.js");
 const response_js_1 = require("./response.js");
-exports.DEFAULT_DATA_DIR = path_1.default.resolve(__dirname, '../../data');
+const DEFAULT_DATA_DIR = path_1.default.resolve(__dirname, '../../data');
+exports.DEFAULT_DATA_DIR = DEFAULT_DATA_DIR;
+/**
+ * P8: Composition Overrides 위치.
+ * extract-mcp-data.ts 가 만드는 data/*.json 위에 컴포넌트 디렉토리를 건드리지 않고
+ * allowedChildren / allowedParents / canonicalExample / canonicalExamples / bemClassesExtra 를
+ * 추가하는 단일 채널.
+ *
+ * 빌드 산출물(bin/) 에서는 src/overrides 가 build:server 단계에서 복사되지 않을 수 있으므로
+ * src 와 bin 양쪽을 fallback 으로 본다.
+ */
+const COMPOSITION_OVERRIDES_CANDIDATES = [
+    path_1.default.resolve(__dirname, '../../src/overrides/composition.json'),
+    path_1.default.resolve(__dirname, '../overrides/composition.json'),
+];
+/** composition.json 파일에서 메타 키를 제거하여 CompositionEntry 객체만 수집 */
+const filterCompositionEntries = (parsed) => {
+    if (typeof parsed !== 'object' || !parsed)
+        return {};
+    const entries = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (key.startsWith('_'))
+            continue;
+        if (value && typeof value === 'object' && !Array.isArray(value))
+            entries[key] = value;
+    }
+    return entries;
+};
+const loadCompositionOverrides = () => {
+    for (const candidate of COMPOSITION_OVERRIDES_CANDIDATES) {
+        try {
+            const raw = fs_1.default.readFileSync(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const entries = filterCompositionEntries(parsed);
+            logger_js_1.logger.info(`composition overrides 로딩: ${Object.keys(entries).length}개 (${path_1.default.basename(candidate)})`);
+            return entries;
+        }
+        catch (err) {
+            // ENOENT: 파일 없으면 다음 후보 시도 (TOCTOU 회피)
+            if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+                continue;
+            }
+            logger_js_1.logger.warn(`composition overrides 파싱 실패 (${candidate}): ${(0, response_js_1.toErrorMessage)(err)}`);
+            return {};
+        }
+    }
+    return {};
+};
+exports.loadCompositionOverrides = loadCompositionOverrides;
+/** P8: `_` 접두 메타 키를 객체에서 제거 (얕은 필터). canonicalExamples 같은 중첩 맵에서 _note 누출 방지. */
+const stripMetaKeys = (obj) => {
+    if (!obj)
+        return obj;
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (key.startsWith('_'))
+            continue;
+        cleaned[key] = value;
+    }
+    return cleaned;
+};
+/** ComponentData 에 composition overrides 항목을 in-place 병합 — bemClasses 는 union, 나머지는 추가 필드. */
+const mergeCompositionEntry = (component, entry) => {
+    if (entry.bemClassesExtra && entry.bemClassesExtra.length > 0) {
+        const merged = new Set([...component.bemClasses, ...entry.bemClassesExtra]);
+        component.bemClasses = [...merged].sort();
+    }
+    if (entry.allowedChildren)
+        component.allowedChildren = entry.allowedChildren;
+    if (entry.allowedParents)
+        component.allowedParents = entry.allowedParents;
+    if (entry.canonicalExample) {
+        // canonicalExample 내부 _note / _comment 같은 메타 키 제거 — 응답에 누출되지 않도록
+        component.canonicalExample = stripMetaKeys(entry.canonicalExample);
+    }
+    if (entry.canonicalExamples) {
+        // canonicalExamples 내부 _note / _comment 같은 메타 키 제거 — 응답에 누출되지 않도록
+        component.canonicalExamples = stripMetaKeys(entry.canonicalExamples);
+    }
+    // P13: description 끝에 append — list_components 응답에서 컴포넌트 용도 명시
+    if (entry.descriptionExtra) {
+        component.description = `${component.description}\n\n${entry.descriptionExtra}`;
+    }
+    // P13: aliases union — search_component 별칭 보강 (중복 제거)
+    if (entry.aliasesExtra && entry.aliasesExtra.length > 0) {
+        const set = new Set([...(component.aliases ?? []), ...entry.aliasesExtra]);
+        component.aliases = [...set];
+    }
+};
 // ── 검증 헬퍼 (§ 3.8 복잡한 조건을 의도가 드러나는 이름으로 분리) ──────────
 /** JSON.parse 결과가 name: string 필드를 가진 컴포넌트 객체인지 검증 */
 const isValidComponentJson = (data) => !!data && typeof data === 'object' && 'name' in data && typeof data.name === 'string';
 /** JSON.parse 결과가 icons 배열을 가진 아이콘 데이터인지 검증 */
 const isValidIconJson = (data) => !!data && typeof data === 'object' && 'icons' in data && Array.isArray(data.icons);
 // ── 부수효과 함수 (fs I/O) ────────────────────────────────────────────────
-/** data/ 디렉토리의 JSON 파일을 읽어 componentMap으로 반환 */
+/** data/ 디렉토리의 JSON 파일을 읽어 componentMap + compositionOverrides로 반환 */
 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();
+    // P8: composition overrides (composition.json) 를 한 번만 로딩해 각 컴포넌트에 병합 — 호출자에게도 반환
+    const compositionOverrides = loadCompositionOverrides();
     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;
+        const compositionOverridesEntry = compositionOverrides[component.name];
+        if (compositionOverridesEntry)
+            mergeCompositionEntry(component, compositionOverridesEntry);
+        map.set(component.name, component);
     }
     logger_js_1.logger.info(`컴포넌트 ${map.size}개 로딩 완료`);
-    return map;
+    return { map, compositionOverrides };
 };
 exports.loadComponentsFromDir = loadComponentsFromDir;
 /** data/_icons.json을 읽어 IconData로 반환 (파일 없으면 빈 데이터) */
@@ -165,6 +250,24 @@ const loadInstructions = (definitionsDir) => {
     return fs_1.default.readFileSync(instructionsPath, 'utf-8').trim();
 };
 exports.loadInstructions = loadInstructions;
+/** definitions/js-api.json을 로드하여 exportName→JsApiInfo Map 반환 */
+const loadJsApi = (definitionsDir) => {
+    const filePath = path_1.default.resolve(definitionsDir, 'js-api.json');
+    if (!fs_1.default.existsSync(filePath)) {
+        logger_js_1.logger.info('js-api.json이 없습니다 — JS API 힌트 비활성화');
+        return new Map();
+    }
+    try {
+        const raw = fs_1.default.readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(raw);
+        return new Map(Object.entries(data));
+    }
+    catch (err) {
+        logger_js_1.logger.error(`js-api.json 파싱 실패: ${(0, response_js_1.toErrorMessage)(err)}`);
+        return new Map();
+    }
+};
+exports.loadJsApi = loadJsApi;
 // ── 순수 함수 (외부 상태 없음, Map을 파라미터로 받음) ──────────────────────
 /** componentMap에서 이름으로 단일 컴포넌트 조회 */
 const getComponent = (map, name) => map.get(name);

package/bin/utils/domEnvironment.js

@@ -1,8 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupDomEnvironment = void 0;
+/**
+ * monorepo에서 패키지가 여러 node_modules에 설치될 수 있음.
+ * 번들의 external require가 MCP 로컬 node_modules의 버전을 사용하도록 통일한다.
+ *
+ * 문제: esbuild 번들은 ui-admin cwd에서 빌드되므로, external require가
+ * 루트 node_modules(오래된 버전)를 resolve할 수 있다.
+ * 해결: MCP 패키지 기준 require.resolve로 경로를 고정한다.
+ */
+const unifyModuleResolution = () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const Module = require('module');
+    const overrides = {};
+    const pin = (name) => {
+        try {
+            overrides[name] = require.resolve(name);
+        }
+        catch {
+            /* 미설치 패키지는 무시 */
+        }
+    };
+    // React 인스턴스 통일 (Hook dispatcher 일치 보장)
+    pin('react');
+    pin('react-dom');
+    pin('react/jsx-runtime');
+    // external 패키지 버전 통일 (monorepo hoisting 불일치 방지)
+    pin('@ncds/ui-admin-icon');
+    pin('swiper/react');
+    pin('swiper');
+    const origResolve = Module._resolveFilename;
+    Module._resolveFilename = function (request, parent, isMain, options) {
+        if (request in overrides)
+            return overrides[request];
+        return origResolve.call(this, request, parent, isMain, options);
+    };
+};
 /** jsdom + React SSR 환경을 초기화하고 ReactRuntime을 반환 */
 const setupDomEnvironment = () => {
+    unifyModuleResolution();
     // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
     const { JSDOM } = require('jsdom');
     const dom = new JSDOM('<!DOCTYPE html><html><body></body></html>');
@@ -10,9 +46,24 @@ 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 });
     }
+    // Swiper 등 외부 라이브러리가 HTMLElement를 직접 참조 — jsdom에서 전역 노출
+    for (const key of [
+        'HTMLElement',
+        'HTMLDivElement',
+        'HTMLSpanElement',
+        'Element',
+        'Node',
+        'Event',
+        'CustomEvent',
+    ]) {
+        if (typeof globalThis[key] === 'undefined') {
+            globalThis[key] = dom.window[key];
+        }
+    }
     // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
     const ReactDOM = require('react-dom');
     ReactDOM.createPortal = (children) => children;

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,11 +49,21 @@ 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에 매칭되는지 퍼지 검사
  *
  * @returns null이면 매칭 실패, FuzzyResult면 매칭 성공
  */
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: 정확/포함/퍼지 단계별 매칭 분기 — 알고리즘 본질, 별 리팩토링 거리
 const fuzzyMatch = (query, target) => {
     const q = normalize(query);
     const t = normalize(target);
@@ -71,7 +81,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 +90,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/bin/utils/response.d.ts

@@ -16,10 +16,12 @@ export type McpToolResponse = {
 };
 /** 성공 응답 — data를 JSON.stringify하여 반환 */
 export declare const successResponse: (data: unknown) => McpToolResponse;
-/** 오류 응답 — code + message + suggestion 구조로 isError: true 반환 */
-export declare const errorResponse: (code: McpErrorCode, message: string, suggestion: string) => McpToolResponse;
+/** 오류 응답 — code + message + suggestion + optional warnings 구조로 isError: true 반환 */
+export declare const errorResponse: (code: McpErrorCode, message: string, suggestion: string, warnings?: string[]) => McpToolResponse;
 /** COMPONENT_NOT_FOUND 오류 — 여러 tool에서 공통 사용 */
 export declare const componentNotFoundResponse: (name: string) => McpToolResponse;
+/** ping 미호출 시 응답에 핵심 rules를 주입하는 래퍼 */
+export declare const appendPingReminder: (response: McpToolResponse, reminder: string) => McpToolResponse;
 /** 입력 정규화 — name.trim().toLowerCase() */
 export declare const normalizeName: (name: string) => string;
 /** catch 블록에서 에러 메시지를 안전하게 추출 */

package/bin/utils/response.js

@@ -1,17 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toErrorMessage = exports.normalizeName = exports.componentNotFoundResponse = exports.errorResponse = exports.successResponse = void 0;
+exports.toErrorMessage = exports.normalizeName = exports.appendPingReminder = exports.componentNotFoundResponse = exports.errorResponse = exports.successResponse = void 0;
 /** 성공 응답 — data를 JSON.stringify하여 반환 */
 const successResponse = (data) => ({
     content: [{ type: 'text', text: JSON.stringify(data) }],
 });
 exports.successResponse = successResponse;
-/** 오류 응답 — code + message + suggestion 구조로 isError: true 반환 */
-const errorResponse = (code, message, suggestion) => ({
+/** 오류 응답 — code + message + suggestion + optional warnings 구조로 isError: true 반환 */
+const errorResponse = (code, message, suggestion, warnings) => ({
     content: [
         {
             type: 'text',
-            text: JSON.stringify({ code, message, suggestion }),
+            text: JSON.stringify({
+                code,
+                message,
+                suggestion,
+                ...(warnings && warnings.length > 0 && { warnings }),
+            }),
         },
     ],
     isError: true,
@@ -20,6 +25,12 @@ exports.errorResponse = errorResponse;
 /** COMPONENT_NOT_FOUND 오류 — 여러 tool에서 공통 사용 */
 const componentNotFoundResponse = (name) => (0, exports.errorResponse)('COMPONENT_NOT_FOUND', `Component '${name}' not found.`, 'Use search_component to find similar components, or list_components to see all available.');
 exports.componentNotFoundResponse = componentNotFoundResponse;
+/** ping 미호출 시 응답에 핵심 rules를 주입하는 래퍼 */
+const appendPingReminder = (response, reminder) => {
+    const text = `${response.content[0].text}\n\n${reminder}`;
+    return { ...response, content: [{ type: 'text', text }] };
+};
+exports.appendPingReminder = appendPingReminder;
 /** 입력 정규화 — name.trim().toLowerCase() */
 const normalizeName = (name) => name.trim().toLowerCase();
 exports.normalizeName = normalizeName;

package/bin/utils/tokenValidator.d.ts

@@ -6,11 +6,11 @@
 import type { parse } from 'node-html-parser';
 import type { ComplianceError, TokenData } from '../types.js';
 /** hex 값(lowercase) → 토큰 CSS 변수명 배열 역방향 매핑 빌드 — server.ts에서 1회 호출 */
-export declare const buildTokenValueMap: (tokenData: TokenData) => Map<string, string[]>;
+declare const buildTokenValueMap: (tokenData: TokenData) => Map<string, string[]>;
 /** inline style + <style> 블록의 CSS 텍스트를 하나로 합침 */
-export declare const extractAllCss: (root: ReturnType<typeof parse>) => string;
+declare const extractAllCss: (root: ReturnType<typeof parse>) => string;
 /** 토큰 미사용 + 무효 토큰 감지 */
-export declare const detectTokenIssues: (params: {
+declare const detectTokenIssues: (params: {
     root: ReturnType<typeof parse>;
     tokenData: TokenData;
     tokenValueMap: Map<string, string[]>;
@@ -22,3 +22,4 @@ export declare const detectTokenIssues: (params: {
         invalid: number;
     };
 };
+export { buildTokenValueMap, detectTokenIssues, extractAllCss };

package/bin/utils/tokenValidator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectTokenIssues = exports.extractAllCss = exports.buildTokenValueMap = void 0;
+exports.extractAllCss = exports.detectTokenIssues = exports.buildTokenValueMap = void 0;
 // ── server.ts 사전 계산용 ───────────────────────────────────────────────
 /** hex 값(lowercase) → 토큰 CSS 변수명 배열 역방향 매핑 빌드 — server.ts에서 1회 호출 */
 const buildTokenValueMap = (tokenData) => {
@@ -25,14 +25,18 @@ const HEX_PATTERN_SOURCE = /#([0-9a-fA-F]{3,8})\b/g.source;
 const RGB_PATTERN_SOURCE = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/g.source;
 const VAR_PATTERN_SOURCE = /var\(\s*(--[a-zA-Z0-9-]+)(?:\s*,\s*[^)]+)?\s*\)/g.source;
 // ── 순수 헬퍼 ────────────────────────────────────────────────────────────
+const HEX_RADIX = 16;
+const HEX_BYTE_LENGTH = 2;
+const HEX_SHORT_LENGTH = 3;
+const HEX_FULL_LENGTH = 6;
 /** rgb(r,g,b) → #rrggbb hex 변환 */
-const rgbToHex = (r, g, b) => `#${[r, g, b].map((v) => v.toString(16).padStart(2, '0')).join('')}`;
+const rgbToHex = (r, g, b) => `#${[r, g, b].map((v) => v.toString(HEX_RADIX).padStart(HEX_BYTE_LENGTH, '0')).join('')}`;
 /** 3자리 hex를 6자리로 정규화 */
 const normalizeHex = (hex) => {
     const h = hex.toLowerCase().replace('#', '');
-    if (h.length === 3)
+    if (h.length === HEX_SHORT_LENGTH)
         return `#${h[0]}${h[0]}${h[1]}${h[1]}${h[2]}${h[2]}`;
-    return `#${h.slice(0, 6)}`;
+    return `#${h.slice(0, HEX_FULL_LENGTH)}`;
 };
 /** var()의 prefix가 토큰 시스템에 속하는지 확인 */
 const hasKnownTokenPrefix = (varName, prefixSet) => {
@@ -83,16 +87,15 @@ exports.extractAllCss = extractAllCss;
 /** CSS 텍스트에서 하드코딩된 색상값(hex/rgb)을 추출 */
 const collectHardcodedColors = (css) => {
     const colors = [];
-    let match;
     const hexPattern = new RegExp(HEX_PATTERN_SOURCE, 'g');
-    while ((match = hexPattern.exec(css)) !== null) {
+    for (const match of css.matchAll(hexPattern)) {
         colors.push({ raw: match[0], normalized: normalizeHex(match[0]) });
     }
     const rgbPattern = new RegExp(RGB_PATTERN_SOURCE, 'g');
-    while ((match = rgbPattern.exec(css)) !== null) {
+    for (const match of css.matchAll(rgbPattern)) {
         colors.push({
             raw: match[0],
-            normalized: rgbToHex(parseInt(match[1], 10), parseInt(match[2], 10), parseInt(match[3], 10)),
+            normalized: rgbToHex(Number.parseInt(match[1], 10), Number.parseInt(match[2], 10), Number.parseInt(match[3], 10)),
         });
     }
     return colors;
@@ -126,9 +129,8 @@ const collectInvalidTokenErrors = (css, tokenNameSet, tokenPrefixSet) => {
     const errors = [];
     let correct = 0;
     let invalid = 0;
-    let varMatch;
     const varPattern = new RegExp(VAR_PATTERN_SOURCE, 'g');
-    while ((varMatch = varPattern.exec(css)) !== null) {
+    for (const varMatch of css.matchAll(varPattern)) {
         const varName = varMatch[1];
         if (!hasKnownTokenPrefix(varName, tokenPrefixSet))
             continue;
@@ -151,7 +153,7 @@ const collectInvalidTokenErrors = (css, tokenNameSet, tokenPrefixSet) => {
 /** 토큰 미사용 + 무효 토큰 감지 */
 const detectTokenIssues = (params) => {
     const { root, tokenData, tokenValueMap } = params;
-    const allCss = (0, exports.extractAllCss)(root);
+    const allCss = extractAllCss(root);
     const notUsed = collectTokenNotUsedErrors(allCss, tokenValueMap);
     const invalidResult = collectInvalidTokenErrors(allCss, buildTokenNameSet(tokenData), buildTokenPrefixSet(tokenData));
     return {

package/bin/version.d.ts

@@ -1,4 +1,6 @@
 /**
- * version — 빌드 시 scripts/build-npm.js가 자동 생성 (수동 편집 금지)
+ * NCDS UI Admin MCP 서버가 노출하는 ui-admin 정합 기준 버전.
+ * scripts/generate-version-ts.ts 가 ui-admin/package.json 의 version 으로부터 자동 생성한다.
+ * 수동 편집 금지 — 빌드(`pnpm generate:version-ts` 또는 `pnpm build`) 시 덮어쓰여진다.
  */
-export declare const VERSION = "1.6.3";
+export declare const VERSION = "1.8.7";

package/bin/version.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /**
- * version — 빌드 시 scripts/build-npm.js가 자동 생성 (수동 편집 금지)
+ * NCDS UI Admin MCP 서버가 노출하는 ui-admin 정합 기준 버전.
+ * scripts/generate-version-ts.ts 가 ui-admin/package.json 의 version 으로부터 자동 생성한다.
+ * 수동 편집 금지 — 빌드(`pnpm generate:version-ts` 또는 `pnpm build`) 시 덮어쓰여진다.
  */
-exports.VERSION = '1.6.3';
+exports.VERSION = '1.8.7';