npm - @ncds/ui-admin-mcp - Versions diffs - 1.0.0-alpha.2 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (97) hide show

package/README.md +113 -0
package/bin/components.bundle.js +21 -0
package/bin/definitions/compliance-rules.json +64 -0
package/bin/definitions/instructions.md +96 -0
package/bin/definitions/rules.json +57 -0
package/bin/definitions/token-descriptions.json +27 -0
package/bin/definitions/tool-definitions.json +42 -0
package/bin/instructions.d.ts +1 -0
package/bin/instructions.js +14 -0
package/bin/server.d.ts +1 -0
package/bin/server.js +164 -0
package/bin/server.mjs +8 -0
package/bin/tools/getComponentHtml.d.ts +3 -0
package/bin/tools/getComponentHtml.js +30 -0
package/bin/tools/getComponentProps.d.ts +4 -0
package/bin/tools/getComponentProps.js +17 -0
package/bin/tools/getDesignTokens.d.ts +13 -0
package/bin/tools/getDesignTokens.js +20 -0
package/bin/tools/listComponents.d.ts +16 -0
package/bin/tools/listComponents.js +24 -0
package/bin/tools/listIcons.d.ts +22 -0
package/bin/tools/listIcons.js +23 -0
package/bin/tools/ping.d.ts +17 -0
package/bin/tools/ping.js +20 -0
package/bin/tools/renderToHtml.d.ts +21 -0
package/bin/tools/renderToHtml.js +177 -0
package/bin/tools/searchComponent.d.ts +4 -0
package/bin/tools/searchComponent.js +33 -0
package/bin/tools/searchIcon.d.ts +7 -0
package/bin/tools/searchIcon.js +19 -0
package/bin/tools/validateHtml.d.ts +18 -0
package/bin/tools/validateHtml.js +85 -0
package/bin/types.d.ts +111 -0
package/bin/types.js +5 -0
package/bin/utils/bemValidator.d.ts +36 -0
package/bin/utils/bemValidator.js +198 -0
package/bin/utils/compliance.d.ts +52 -0
package/bin/utils/compliance.js +199 -0
package/bin/utils/dataLoader.d.ts +33 -0
package/bin/utils/dataLoader.js +174 -0
package/bin/utils/domEnvironment.d.ts +9 -0
package/bin/utils/domEnvironment.js +25 -0
package/bin/utils/fuzzyMatch.d.ts +21 -0
package/bin/utils/fuzzyMatch.js +110 -0
package/bin/utils/logger.d.ts +18 -0
package/bin/utils/logger.js +27 -0
package/bin/utils/response.d.ts +26 -0
package/bin/utils/response.js +28 -0
package/bin/utils/tokenValidator.d.ts +24 -0
package/bin/utils/tokenValidator.js +162 -0
package/bin/version.d.ts +4 -0
package/bin/version.js +7 -0
package/data/_icons.json +12361 -0
package/data/_meta.json +12 -0
package/data/_tokens.json +661 -0
package/data/badge-group.json +121 -0
package/data/badge.json +130 -0
package/data/bread-crumb.json +51 -0
package/data/button-group.json +94 -0
package/data/button.json +143 -0
package/data/carousel-arrow.json +87 -0
package/data/carousel-number-group.json +87 -0
package/data/checkbox.json +99 -0
package/data/combo-box.json +157 -0
package/data/date-picker.json +109 -0
package/data/divider.json +91 -0
package/data/dot.json +103 -0
package/data/dropdown.json +123 -0
package/data/empty-state.json +64 -0
package/data/featured-icon.json +125 -0
package/data/file-input.json +161 -0
package/data/horizontal-tab.json +114 -0
package/data/image-file-input.json +185 -0
package/data/input-base.json +145 -0
package/data/modal.json +131 -0
package/data/notification.json +176 -0
package/data/number-input.json +141 -0
package/data/pagination.json +101 -0
package/data/password-input.json +45 -0
package/data/progress-bar.json +90 -0
package/data/progress-circle.json +96 -0
package/data/radio.json +86 -0
package/data/range-date-picker-with-buttons.json +101 -0
package/data/range-date-picker.json +87 -0
package/data/select-box.json +177 -0
package/data/select.json +116 -0
package/data/slider.json +100 -0
package/data/spinner.json +94 -0
package/data/switch.json +109 -0
package/data/tag.json +101 -0
package/data/textarea.json +96 -0
package/data/toggle.json +102 -0
package/data/tooltip.json +185 -0
package/data/vertical-tab.json +99 -0
package/package.json +71 -0
package/templates/.mcp.json.example +8 -0
package/templates/README.md +30 -0

package/bin/utils/domEnvironment.js ADDED Viewed

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupDomEnvironment = void 0;
+/** jsdom + React SSR 환경을 초기화하고 ReactRuntime을 반환 */
+const setupDomEnvironment = () => {
+    // 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>');
+    if (typeof globalThis.document === 'undefined')
+        globalThis.document = dom.window.document;
+    if (typeof globalThis.window === 'undefined')
+        globalThis.window = dom.window;
+    if (typeof globalThis.navigator === 'undefined') {
+        Object.defineProperty(globalThis, 'navigator', { value: dom.window.navigator, writable: true });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const ReactDOM = require('react-dom');
+    ReactDOM.createPortal = (children) => children;
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const React = require('react');
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const { renderToStaticMarkup } = require('react-dom/server');
+    return { createElement: React.createElement, renderToStaticMarkup };
+};
+exports.setupDomEnvironment = setupDomEnvironment;

package/bin/utils/fuzzyMatch.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+/**
+ * 한국어/영어 퍼지 매칭 유틸
+ *
+ * - 공백 제거 후 비교 ("약관동의" ↔ "약관 동의")
+ * - 부분 포함 ("비번" ⊂ "비밀번호"는 안 되지만, "로딩" ⊂ "로딩중"은 됨)
+ * - 편집 거리(Levenshtein) 기반 오타 허용 ("셀랙트" ↔ "셀렉트", "buttn" ↔ "button")
+ */
+export interface FuzzyResult {
+    score: number;
+    matchType: 'exact' | 'contains' | 'fuzzy';
+}
+/**
+ * query가 target에 매칭되는지 퍼지 검사
+ *
+ * @returns null이면 매칭 실패, FuzzyResult면 매칭 성공
+ */
+export declare const fuzzyMatch: (query: string, target: string) => FuzzyResult | null;
+/**
+ * query를 여러 targets에 대해 퍼지 매칭하고 최고 점수를 반환
+ */
+export declare const bestFuzzyMatch: (query: string, targets: string[]) => FuzzyResult | null;

package/bin/utils/fuzzyMatch.js ADDED Viewed

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * 한국어/영어 퍼지 매칭 유틸
+ *
+ * - 공백 제거 후 비교 ("약관동의" ↔ "약관 동의")
+ * - 부분 포함 ("비번" ⊂ "비밀번호"는 안 되지만, "로딩" ⊂ "로딩중"은 됨)
+ * - 편집 거리(Levenshtein) 기반 오타 허용 ("셀랙트" ↔ "셀렉트", "buttn" ↔ "button")
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bestFuzzyMatch = exports.fuzzyMatch = void 0;
+// ── 상수 ──────────────────────────────────────────────────────────
+/** 포함 매칭 시 기본 점수 */
+const CONTAINS_BASE_SCORE = 0.7;
+/** 포함 매칭 시 길이 비율 보너스 가중치 */
+const CONTAINS_BONUS_MULTIPLIER = 0.2;
+/** 이 길이 이하의 쿼리는 "짧은 쿼리"로 분류 (typo threshold = 1) */
+const SHORT_QUERY_LENGTH = 2;
+/** 긴 쿼리의 오타 허용 비율 (ceil(length * 이 값)) */
+const TYPO_THRESHOLD_RATIO = 0.3;
+/** target이 query보다 이만큼 이상 길면 부분 문자열 매칭 시도 */
+const LENGTH_DIFF_FOR_SUBSTRING = 2;
+/** 부분 문자열 매칭을 시도할 target 최대 길이 */
+const SUBSTRING_TARGET_LIMIT = 100;
+/** 부분 문자열 퍼지 매칭 시 기본 점수 */
+const SUBSTRING_BASE_SCORE = 0.5;
+/** 부분 문자열 퍼지 매칭 시 유사도 보너스 가중치 */
+const SUBSTRING_BONUS_MULTIPLIER = 0.2;
+// ── 순수 함수 ────────────────────────────────────────────────────
+/** 공백·하이픈 제거 후 소문자 */
+const normalize = (s) => s.toLowerCase().replace(/[\s\-_]/g, '');
+/** Levenshtein 편집 거리 */
+const editDistance = (a, b) => {
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    // 짧은 배열만 유지 (메모리 최적화)
+    let prev = Array.from({ length: n + 1 }, (_, i) => i);
+    let curr = new Array(n + 1);
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[n];
+};
+/**
+ * query가 target에 매칭되는지 퍼지 검사
+ *
+ * @returns null이면 매칭 실패, FuzzyResult면 매칭 성공
+ */
+const fuzzyMatch = (query, target) => {
+    const q = normalize(query);
+    const t = normalize(target);
+    if (!q || !t)
+        return null;
+    // 1. 정확 일치 (공백 제거 후)
+    if (t === q)
+        return { score: 1.0, matchType: 'exact' };
+    // 2. 포함 매칭 (공백 제거 후)
+    if (t.includes(q) || q.includes(t)) {
+        const shorter = Math.min(q.length, t.length);
+        const longer = Math.max(q.length, t.length);
+        return { score: CONTAINS_BASE_SCORE + CONTAINS_BONUS_MULTIPLIER * (shorter / longer), matchType: 'contains' };
+    }
+    // 3. 편집 거리 기반 퍼지 매칭
+    const isShortQuery = q.length <= SHORT_QUERY_LENGTH;
+    const typoThreshold = isShortQuery ? 1 : Math.ceil(q.length * TYPO_THRESHOLD_RATIO);
+    const dist = editDistance(q, t);
+    // target이 query보다 훨씬 길면, 부분 문자열 슬라이딩 윈도우로 비교
+    const targetIsLonger = t.length > q.length + LENGTH_DIFF_FOR_SUBSTRING;
+    const queryIsLongEnough = q.length >= SHORT_QUERY_LENGTH;
+    const targetWithinLimit = t.length <= SUBSTRING_TARGET_LIMIT;
+    const shouldTrySubstringMatch = targetIsLonger && queryIsLongEnough && targetWithinLimit;
+    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);
+            if (subDist <= typoThreshold) {
+                const subSimilarity = q.length === 0 ? 1 : 1 - subDist / q.length;
+                return { score: SUBSTRING_BASE_SCORE + SUBSTRING_BONUS_MULTIPLIER * subSimilarity, matchType: 'fuzzy' };
+            }
+        }
+    }
+    if (dist <= typoThreshold) {
+        const maxLen = Math.max(q.length, t.length);
+        return { score: maxLen === 0 ? 1 : 1 - dist / maxLen, matchType: 'fuzzy' };
+    }
+    return null;
+};
+exports.fuzzyMatch = fuzzyMatch;
+/**
+ * query를 여러 targets에 대해 퍼지 매칭하고 최고 점수를 반환
+ */
+const bestFuzzyMatch = (query, targets) => {
+    let best = null;
+    for (const target of targets) {
+        const result = (0, exports.fuzzyMatch)(query, target);
+        if (result && (!best || result.score > best.score)) {
+            best = result;
+        }
+    }
+    return best;
+};
+exports.bestFuzzyMatch = bestFuzzyMatch;

package/bin/utils/logger.d.ts ADDED Viewed

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

package/bin/utils/logger.js ADDED Viewed

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+/**
+ * stderr 전용 logger 유틸리티 — 부수효과 함수 (stderr I/O)
+ *
+ * ⚠️ console.log / console.warn / console.error 직접 사용 금지
+ *
+ * MCP stdio 프로토콜은 채널 역할이 엄격히 분리됩니다.
+ *   stdin  → 클라이언트 → 서버 요청(JSON-RPC)
+ *   stdout → 서버 → 클라이언트 응답(JSON-RPC) ← 프로토콜 전용 채널
+ *   stderr → 로그 전용 (프로토콜 밖)
+ *
+ * console.log는 stdout에 출력되어 JSON-RPC 스트림을 오염시킵니다.
+ * 모든 로깅은 반드시 이 logger를 통해 stderr로 출력해야 합니다.
+ */
+exports.logger = {
+    info: (msg) => {
+        process.stderr.write(`[INFO] ${msg}\n`);
+    },
+    warn: (msg) => {
+        process.stderr.write(`[WARN] ${msg}\n`);
+    },
+    error: (msg) => {
+        process.stderr.write(`[ERROR] ${msg}\n`);
+    },
+};

package/bin/utils/response.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+/**
+ * MCP tool 응답 헬퍼 — 순수 함수
+ *
+ * 모든 tool이 동일한 응답 구조를 사용하도록 통일합니다.
+ * AI가 tool 코드를 읽을 때 응답 구조를 이 파일 하나로 파악할 수 있습니다.
+ */
+import type { McpErrorCode } from '../types.js';
+/** MCP tool 응답 타입 — registerTool 콜백 반환 타입과 호환 */
+export type McpToolResponse = {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: true;
+};
+/** 성공 응답 — 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;
+/** COMPONENT_NOT_FOUND 오류 — 여러 tool에서 공통 사용 */
+export declare const componentNotFoundResponse: (name: string) => McpToolResponse;
+/** 입력 정규화 — name.trim().toLowerCase() */
+export declare const normalizeName: (name: string) => string;
+/** catch 블록에서 에러 메시지를 안전하게 추출 */
+export declare const toErrorMessage: (err: unknown) => string;

package/bin/utils/response.js ADDED Viewed

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toErrorMessage = exports.normalizeName = 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) => ({
+    content: [
+        {
+            type: 'text',
+            text: JSON.stringify({ code, message, suggestion }),
+        },
+    ],
+    isError: true,
+});
+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;
+/** 입력 정규화 — name.trim().toLowerCase() */
+const normalizeName = (name) => name.trim().toLowerCase();
+exports.normalizeName = normalizeName;
+/** catch 블록에서 에러 메시지를 안전하게 추출 */
+const toErrorMessage = (err) => (err instanceof Error ? err.message : String(err));
+exports.toErrorMessage = toErrorMessage;

package/bin/utils/tokenValidator.d.ts ADDED Viewed

@@ -0,0 +1,24 @@
+/**
+ * 토큰 검증 순수 함수 — 하드코딩 색상 감지 + 존재하지 않는 토큰 감지
+ *
+ * compliance.ts에서 분리. 모든 함수는 순수 함수(Calculation).
+ */
+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[]>;
+/** inline style + <style> 블록의 CSS 텍스트를 하나로 합침 */
+export declare const extractAllCss: (root: ReturnType<typeof parse>) => string;
+/** 토큰 미사용 + 무효 토큰 감지 */
+export declare const detectTokenIssues: (params: {
+    root: ReturnType<typeof parse>;
+    tokenData: TokenData;
+    tokenValueMap: Map<string, string[]>;
+}) => {
+    errors: ComplianceError[];
+    tokenUsage: {
+        correct: number;
+        missing: number;
+        invalid: number;
+    };
+};

package/bin/utils/tokenValidator.js ADDED Viewed

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTokenIssues = exports.extractAllCss = exports.buildTokenValueMap = void 0;
+// ── server.ts 사전 계산용 ───────────────────────────────────────────────
+/** hex 값(lowercase) → 토큰 CSS 변수명 배열 역방향 매핑 빌드 — server.ts에서 1회 호출 */
+const buildTokenValueMap = (tokenData) => {
+    const map = new Map();
+    for (const group of tokenData.groups) {
+        if (group.category !== 'color')
+            continue;
+        for (const token of group.tokens) {
+            const hex = token.value.toLowerCase();
+            const existing = map.get(hex);
+            if (existing)
+                existing.push(token.name);
+            else
+                map.set(hex, [token.name]);
+        }
+    }
+    return map;
+};
+exports.buildTokenValueMap = buildTokenValueMap;
+// ── 상수 ─────────────────────────────────────────────────────────────────
+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;
+// ── 순수 헬퍼 ────────────────────────────────────────────────────────────
+/** rgb(r,g,b) → #rrggbb hex 변환 */
+const rgbToHex = (r, g, b) => `#${[r, g, b].map((v) => v.toString(16).padStart(2, '0')).join('')}`;
+/** 3자리 hex를 6자리로 정규화 */
+const normalizeHex = (hex) => {
+    const h = hex.toLowerCase().replace('#', '');
+    if (h.length === 3)
+        return `#${h[0]}${h[0]}${h[1]}${h[1]}${h[2]}${h[2]}`;
+    return `#${h.slice(0, 6)}`;
+};
+/** var()의 prefix가 토큰 시스템에 속하는지 확인 */
+const hasKnownTokenPrefix = (varName, prefixSet) => {
+    for (const prefix of prefixSet) {
+        if (varName.startsWith(prefix))
+            return true;
+    }
+    return false;
+};
+/** tokenData에 등록된 토큰명 prefix Set — 커스텀 변수 제외용 */
+const buildTokenPrefixSet = (tokenData) => {
+    const prefixes = new Set();
+    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)
+                prefixes.add(`--${segments.slice(0, 2).join('-')}`);
+            if (segments.length >= 1)
+                prefixes.add(`--${segments[0]}`);
+        }
+    }
+    return prefixes;
+};
+/** 모든 토큰명을 Set으로 수집 */
+const buildTokenNameSet = (tokenData) => {
+    const names = new Set();
+    for (const group of tokenData.groups) {
+        for (const token of group.tokens)
+            names.add(token.name);
+    }
+    return names;
+};
+/** inline style + <style> 블록의 CSS 텍스트를 하나로 합침 */
+const extractAllCss = (root) => {
+    const parts = [];
+    for (const el of root.querySelectorAll('[style]')) {
+        const style = el.getAttribute('style');
+        if (style)
+            parts.push(style);
+    }
+    for (const styleEl of root.querySelectorAll('style')) {
+        parts.push(styleEl.textContent ?? '');
+    }
+    return parts.join(' ');
+};
+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) {
+        colors.push({ raw: match[0], normalized: normalizeHex(match[0]) });
+    }
+    const rgbPattern = new RegExp(RGB_PATTERN_SOURCE, 'g');
+    while ((match = rgbPattern.exec(css)) !== null) {
+        colors.push({
+            raw: match[0],
+            normalized: rgbToHex(parseInt(match[1], 10), parseInt(match[2], 10), parseInt(match[3], 10)),
+        });
+    }
+    return colors;
+};
+/** token_not_used suggestion 생성 */
+const buildTokenSuggestion = (raw, tokenNames) => tokenNames.length === 1
+    ? `Use var(${tokenNames[0]}) instead of ${raw}`
+    : `Possible tokens: ${tokenNames.map((t) => `var(${t})`).join(', ')}`;
+// ── 검증 함수 ────────────────────────────────────────────────────────────
+/** 하드코딩 색상 → token_not_used 에러 수집 */
+const collectTokenNotUsedErrors = (css, tokenValueMap) => {
+    const errors = [];
+    let missing = 0;
+    for (const color of collectHardcodedColors(css)) {
+        const tokenNames = tokenValueMap.get(color.normalized);
+        if (!tokenNames)
+            continue;
+        missing++;
+        errors.push({
+            type: 'token_not_used',
+            target: color.raw,
+            component: '(inline-style)',
+            message: `Hardcoded color '${color.raw}' should use a design token.`,
+            suggestion: buildTokenSuggestion(color.raw, tokenNames),
+        });
+    }
+    return { errors, missing };
+};
+/** var() 참조 → invalid_token 에러 수집 + correct 카운트 */
+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) {
+        const varName = varMatch[1];
+        if (!hasKnownTokenPrefix(varName, tokenPrefixSet))
+            continue;
+        if (tokenNameSet.has(varName)) {
+            correct++;
+        }
+        else {
+            invalid++;
+            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.",
+            });
+        }
+    }
+    return { errors, correct, invalid };
+};
+/** 토큰 미사용 + 무효 토큰 감지 */
+const detectTokenIssues = (params) => {
+    const { root, tokenData, tokenValueMap } = params;
+    const allCss = (0, exports.extractAllCss)(root);
+    const notUsed = collectTokenNotUsedErrors(allCss, tokenValueMap);
+    const invalidResult = collectInvalidTokenErrors(allCss, buildTokenNameSet(tokenData), buildTokenPrefixSet(tokenData));
+    return {
+        errors: [...notUsed.errors, ...invalidResult.errors],
+        tokenUsage: { correct: invalidResult.correct, missing: notUsed.missing, invalid: invalidResult.invalid },
+    };
+};
+exports.detectTokenIssues = detectTokenIssues;

package/bin/version.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/**
+ * version — 빌드 시 scripts/build-npm.js가 자동 생성 (수동 편집 금지)
+ */
+export declare const VERSION = "1.6.3";

package/bin/version.js ADDED Viewed

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+/**
+ * version — 빌드 시 scripts/build-npm.js가 자동 생성 (수동 편집 금지)
+ */
+exports.VERSION = '1.6.3';