@ncds/ui-admin-mcp 1.0.0-alpha.16 → 1.0.0-alpha.18

package/bin/utils/compliance.d.ts

@@ -3,12 +3,11 @@
  *
  * 토큰 검증은 tokenValidator.ts에 분리.
  */
-import { parse } from 'node-html-parser';
-import type { ComponentData, ComplianceRulesData, ComplianceError, ComplianceSummary } from '../types.js';
+import type { parse } from 'node-html-parser';
+import type { ComplianceError, ComplianceRulesData, ComplianceSummary, ComponentData } from '../types.js';
 import type { ValidationError } from './bemValidator.js';
-export { detectTokenIssues } from './tokenValidator.js';
 /** NCUA 컴포넌트 누락 감지 — 태그 인덱스로 O(n) 매칭 */
-export declare const detectNcuaOmission: (params: {
+declare const detectNcuaOmission: (params: {
     root: ReturnType<typeof parse>;
     complianceRules: ComplianceRulesData;
     componentMap: Map<string, ComponentData>;
@@ -20,7 +19,7 @@ export declare const detectNcuaOmission: (params: {
     };
 };
 /** NCUA 컴포넌트 내부 커스텀 스타일 감지 */
-export declare const detectCustomNotSeparated: (params: {
+declare const detectCustomNotSeparated: (params: {
     root: ReturnType<typeof parse>;
     rootClassMap: Map<string, string>;
     warnings: ValidationError[];
@@ -32,7 +31,7 @@ export declare const detectCustomNotSeparated: (params: {
     };
 };
 /** 준수도 점수 + 요약 빌드 */
-export declare const buildComplianceSummary: (params: {
+declare const buildComplianceSummary: (params: {
     ncuaErrors: ComplianceError[];
     tokenErrors: ComplianceError[];
     customErrors: ComplianceError[];
@@ -50,3 +49,5 @@ export declare const buildComplianceSummary: (params: {
         violated: number;
     };
 }) => ComplianceSummary;
+export { buildComplianceSummary, detectCustomNotSeparated, detectNcuaOmission };
+export { detectTokenIssues } from './tokenValidator.js';

package/bin/utils/compliance.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildComplianceSummary = exports.detectCustomNotSeparated = exports.detectNcuaOmission = exports.detectTokenIssues = void 0;
+exports.detectTokenIssues = exports.detectNcuaOmission = exports.detectCustomNotSeparated = exports.buildComplianceSummary = void 0;
 const bemValidator_js_1 = require("./bemValidator.js");
-var tokenValidator_js_1 = require("./tokenValidator.js");
-Object.defineProperty(exports, "detectTokenIssues", { enumerable: true, get: function () { return tokenValidator_js_1.detectTokenIssues; } });
 // ── 상수 ─────────────────────────────────────────────────────────────────
 const MAX_COMPLIANCE_ERRORS = 10;
 const NCUA_NOT_USED_MEDIUM_WEIGHT = 0.5;
@@ -188,8 +186,10 @@ const buildComplianceSummary = (params) => {
         ncuaNotUsedCount +
         (tokenUsage.correct + tokenUsage.missing + tokenUsage.invalid) +
         (customSeparation.clean + customSeparation.violated);
+    // biome-ignore lint/style/noMagicNumbers: 점수 0~1 boundary (clamp)
     const score = totalCheckpoints === 0 ? 1.0 : Math.max(0, Math.min(1, 1 - weightedViolations / totalCheckpoints));
     return {
+        // biome-ignore lint/style/noMagicNumbers: 2자리 소수점 반올림 (×100/100)
         score: Math.round(score * 100) / 100,
         errors: allErrors.slice(0, MAX_COMPLIANCE_ERRORS),
         ncuaUsage,
@@ -199,3 +199,5 @@ const buildComplianceSummary = (params) => {
     };
 };
 exports.buildComplianceSummary = buildComplianceSummary;
+var tokenValidator_js_1 = require("./tokenValidator.js");
+Object.defineProperty(exports, "detectTokenIssues", { enumerable: true, get: function () { return tokenValidator_js_1.detectTokenIssues; } });

package/bin/utils/dataLoader.d.ts

@@ -1,34 +1,36 @@
-import type { ComponentData, IconData, TokenData, ComplianceRulesData, JsApiInfo } from '../types.js';
-export declare const DEFAULT_DATA_DIR: string;
-export interface CdnMeta {
+import type { ComplianceRulesData, ComponentData, IconData, JsApiInfo, TokenData } from '../types.js';
+declare const DEFAULT_DATA_DIR: string;
+interface CdnMeta {
     version: string;
     css: string;
     js: string;
 }
-export interface IconMeta {
+interface IconMeta {
     packageName: string;
     version: string;
 }
 /** data/ 디렉토리의 JSON 파일을 읽어 componentMap으로 반환 */
-export declare const loadComponentsFromDir: (dataDir: string) => Map<string, ComponentData>;
+declare const loadComponentsFromDir: (dataDir: string) => Map<string, ComponentData>;
 /** data/_icons.json을 읽어 IconData로 반환 (파일 없으면 빈 데이터) */
-export declare const loadIconData: (dataDir: string) => IconData;
+declare const loadIconData: (dataDir: string) => IconData;
 /** _meta.json 파싱 결과 */
-export interface MetaData {
+interface MetaData {
     cdn: CdnMeta | null;
     icon: IconMeta | null;
 }
 /** data/_meta.json에서 CDN + icon 메타를 1회 읽기로 로드 */
-export declare const loadMeta: (dataDir: string) => MetaData;
+declare const loadMeta: (dataDir: string) => MetaData;
 /** data/_tokens.json을 읽어 TokenData로 반환 (파일 없으면 빈 데이터) */
-export declare const loadTokenData: (dataDir: string) => TokenData;
+declare const loadTokenData: (dataDir: string) => TokenData;
 /** definitions/compliance-rules.json을 로드하여 ComplianceRulesData로 반환 (파일 없으면 null) */
-export declare const loadComplianceRules: (definitionsDir: string) => ComplianceRulesData | null;
+declare const loadComplianceRules: (definitionsDir: string) => ComplianceRulesData | null;
 /** definitions/instructions.md를 로드하여 문자열 반환 */
-export declare const loadInstructions: (definitionsDir: string) => string;
+declare const loadInstructions: (definitionsDir: string) => string;
 /** definitions/js-api.json을 로드하여 exportName→JsApiInfo Map 반환 */
-export declare const loadJsApi: (definitionsDir: string) => Map<string, JsApiInfo>;
+declare const loadJsApi: (definitionsDir: string) => Map<string, JsApiInfo>;
 /** componentMap에서 이름으로 단일 컴포넌트 조회 */
-export declare const getComponent: (map: Map<string, ComponentData>, name: string) => ComponentData | undefined;
+declare const getComponent: (map: Map<string, ComponentData>, name: string) => ComponentData | undefined;
 /** componentMap의 모든 컴포넌트를 배열로 반환 */
-export declare const getAllComponents: (map: Map<string, ComponentData>) => ComponentData[];
+declare const getAllComponents: (map: Map<string, ComponentData>) => ComponentData[];
+export { DEFAULT_DATA_DIR, getAllComponents, getComponent, loadComplianceRules, loadComponentsFromDir, loadIconData, loadInstructions, loadJsApi, loadMeta, loadTokenData, };
+export type { CdnMeta, IconMeta, MetaData };

package/bin/utils/dataLoader.js

@@ -3,7 +3,7 @@ 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.loadJsApi = 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.loadComplianceRules = exports.getComponent = exports.getAllComponents = exports.DEFAULT_DATA_DIR = void 0;
 /**
  * dataLoader — mcp/data/*.json + definitions/ 파일을 읽어 반환
  *
@@ -17,7 +17,8 @@ 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;
 // ── 검증 헬퍼 (§ 3.8 복잡한 조건을 의도가 드러나는 이름으로 분리) ──────────
 /** JSON.parse 결과가 name: string 필드를 가진 컴포넌트 객체인지 검증 */
 const isValidComponentJson = (data) => !!data && typeof data === 'object' && 'name' in data && typeof data.name === 'string';

package/bin/utils/fuzzyMatch.js

@@ -63,6 +63,7 @@ exports.similarity = similarity;
  *
  * @returns null이면 매칭 실패, FuzzyResult면 매칭 성공
  */
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: 정확/포함/퍼지 단계별 매칭 분기 — 알고리즘 본질, 별 리팩토링 거리
 const fuzzyMatch = (query, target) => {
     const q = normalize(query);
     const t = normalize(target);

package/bin/utils/response.js

@@ -27,7 +27,7 @@ const componentNotFoundResponse = (name) => (0, exports.errorResponse)('COMPONEN
 exports.componentNotFoundResponse = componentNotFoundResponse;
 /** ping 미호출 시 응답에 핵심 rules를 주입하는 래퍼 */
 const appendPingReminder = (response, reminder) => {
-    const text = response.content[0].text + '\n\n' + reminder;
+    const text = `${response.content[0].text}\n\n${reminder}`;
     return { ...response, content: [{ type: 'text', text }] };
 };
 exports.appendPingReminder = appendPingReminder;

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.4";

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.4';