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

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

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 (94) hide show

package/README.md +113 -0
package/bin/components.bundle.js +1 -0
package/bin/definitions/compliance-rules.json +64 -0
package/bin/definitions/instructions.md +164 -0
package/bin/definitions/js-api.json +165 -0
package/bin/definitions/rules.json +59 -0
package/bin/definitions/token-descriptions.json +27 -0
package/bin/definitions/tool-definitions.json +58 -0
package/bin/server.d.ts +1 -0
package/bin/server.js +217 -0
package/bin/server.mjs +8 -0
package/bin/tools/getComponentProps.d.ts +4 -0
package/bin/tools/getComponentProps.js +20 -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 +23 -0
package/bin/tools/renderToHtml.js +267 -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 +123 -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 +35 -0
package/bin/utils/dataLoader.js +192 -0
package/bin/utils/domEnvironment.d.ts +9 -0
package/bin/utils/domEnvironment.js +75 -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 +28 -0
package/bin/utils/response.js +39 -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 +12401 -0
package/data/_meta.json +12 -0
package/data/_tokens.json +661 -0
package/data/badge-group.json +295 -0
package/data/badge.json +246 -0
package/data/bread-crumb.json +87 -0
package/data/button-group.json +94 -0
package/data/button.json +259 -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 +173 -0
package/data/date-picker.json +123 -0
package/data/divider.json +91 -0
package/data/dot.json +103 -0
package/data/dropdown.json +258 -0
package/data/empty-state.json +227 -0
package/data/featured-icon.json +139 -0
package/data/file-input.json +315 -0
package/data/horizontal-tab.json +329 -0
package/data/image-file-input.json +339 -0
package/data/input-base.json +299 -0
package/data/modal.json +143 -0
package/data/notification.json +194 -0
package/data/number-input.json +295 -0
package/data/pagination.json +101 -0
package/data/password-input.json +263 -0
package/data/progress-bar.json +109 -0
package/data/progress-circle.json +96 -0
package/data/radio.json +86 -0
package/data/range-date-picker-with-buttons.json +273 -0
package/data/range-date-picker.json +259 -0
package/data/select-box.json +193 -0
package/data/select.json +132 -0
package/data/slider.json +100 -0
package/data/spinner.json +93 -0
package/data/switch.json +156 -0
package/data/tag.json +159 -0
package/data/textarea.json +96 -0
package/data/toggle.json +102 -0
package/data/tooltip.json +185 -0
package/data/vertical-tab.json +314 -0
package/package.json +61 -0
package/templates/.mcp.json.example +8 -0
package/templates/README.md +30 -0

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

@@ -0,0 +1,9 @@
+/**
+ * DOM + React 런타임 초기화 — jsdom 환경 + createPortal mock + React SSR
+ *
+ * Action (부수효과): globalThis를 변조한다. server.ts 또는 테스트 beforeAll에서 1회 호출.
+ * 이 파일로 추출하여 server.ts/테스트 간 코드 중복을 제거한다 (§ 3.9).
+ */
+import type { ReactRuntime } from '../types.js';
+/** jsdom + React SSR 환경을 초기화하고 ReactRuntime을 반환 */
+export declare const setupDomEnvironment: () => ReactRuntime;

package/bin/utils/domEnvironment.js ADDED Viewed

@@ -0,0 +1,75 @@
+"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>');
+    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 });
+    }
+    // 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;
+    // 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,28 @@
+/**
+ * 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 + 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 블록에서 에러 메시지를 안전하게 추출 */
+export declare const toErrorMessage: (err: unknown) => string;

package/bin/utils/response.js ADDED Viewed

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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 + optional warnings 구조로 isError: true 반환 */
+const errorResponse = (code, message, suggestion, warnings) => ({
+    content: [
+        {
+            type: 'text',
+            text: JSON.stringify({
+                code,
+                message,
+                suggestion,
+                ...(warnings && warnings.length > 0 && { warnings }),
+            }),
+        },
+    ],
+    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;
+/** 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;
+/** 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';