@ncds/ui-admin-mcp 1.0.0-alpha.25 → 1.0.0-alpha.26

package/bin/tools/searchComponent.js

@@ -1,33 +1 @@
-"use strict";
-/**
- * search_component tool — name/description/aliases 퍼지 키워드 검색 (순수 함수)
- *
- * Calculator: searchComponent — 입력(componentMap, query) → 출력(매칭 결과, 점수순 정렬)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchComponent = void 0;
-const dataLoader_js_1 = require("../utils/dataLoader.js");
-const fuzzyMatch_js_1 = require("../utils/fuzzyMatch.js");
-const response_js_1 = require("../utils/response.js");
-/** search_component tool — name/description/aliases 퍼지 검색 후 점수순 반환 */
-const searchComponent = (componentMap, query) => {
-    if (!query.trim())
-        return (0, response_js_1.successResponse)([]);
-    const scored = (0, dataLoader_js_1.getAllComponents)(componentMap)
-        .map((c) => {
-        // name, description, aliases 모두에 대해 퍼지 매칭 → 최고 점수 채택
-        const targets = [c.name, c.description, ...c.aliases];
-        const match = (0, fuzzyMatch_js_1.bestFuzzyMatch)(query, targets);
-        return { component: c, score: match?.score ?? 0 };
-    })
-        .filter((item) => item.score > 0)
-        .sort((a, b) => b.score - a.score);
-    const results = scored.map(({ component: { name, category, description, aliases } }) => ({
-        name,
-        category,
-        description,
-        aliases,
-    }));
-    return (0, response_js_1.successResponse)(results);
-};
-exports.searchComponent = searchComponent;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.searchComponent=void 0;const e=require("../utils/dataLoader.js"),s=require("../utils/fuzzyMatch.js"),r=require("../utils/response.js"),o=(o,t)=>{if(!t.trim())return(0,r.successResponse)([]);const n=(0,e.getAllComponents)(o).map(e=>{const r=[e.name,e.description,...e.aliases],o=(0,s.bestFuzzyMatch)(t,r);return{component:e,score:o?.score??0}}).filter(e=>e.score>0).sort((e,s)=>s.score-e.score).map(({component:{name:e,category:s,description:r,aliases:o}})=>({name:e,category:s,description:r,aliases:o}));return(0,r.successResponse)(n)};exports.searchComponent=o;

package/bin/tools/searchIcon.js

@@ -1,19 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchIcon = void 0;
-const response_js_1 = require("../utils/response.js");
-/** search_icon tool — 키워드로 아이콘 이름/kebab을 검색 */
-const searchIcon = (iconData, query) => {
-    const lower = query.trim().toLowerCase();
-    if (!lower)
-        return (0, response_js_1.successResponse)([]);
-    const results = iconData.icons
-        .filter((icon) => icon.name.toLowerCase().includes(lower) || icon.kebab.includes(lower))
-        .map((icon) => ({
-        name: icon.name,
-        kebab: icon.kebab,
-        fill: icon.fill,
-    }));
-    return (0, response_js_1.successResponse)(results);
-};
-exports.searchIcon = searchIcon;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.searchIcon=void 0;const e=require("../utils/response.js"),s=(s,o)=>{const r=o.trim().toLowerCase();if(!r)return(0,e.successResponse)([]);const n=s.icons.filter(e=>e.name.toLowerCase().includes(r)||e.kebab.includes(r)).map(e=>({name:e.name,kebab:e.kebab,fill:e.fill}));return(0,e.successResponse)(n)};exports.searchIcon=s;

package/bin/tools/validateHtml.js

@@ -1,153 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildTokenValueMap = exports.buildRootClassMap = exports.validateHtml = void 0;
-/**
- * validate_html tool — NCUA HTML BEM 검증 + 디자인 시스템 준수도 검증 진입점
- *
- * BEM 검증: utils/bemValidator.ts
- * Compliance 검증: utils/compliance.ts
- * 이 파일은 오케스트레이션만 담당한다.
- */
-const node_html_parser_1 = require("node-html-parser");
-const bemValidator_js_1 = require("../utils/bemValidator.js");
-const compliance_js_1 = require("../utils/compliance.js");
-const response_js_1 = require("../utils/response.js");
-/** validate_html tool — HTML의 NCUA BEM 클래스 정합성 + 디자인 시스템 준수도 검증 */
-const validateHtml = (params) => {
-    const { componentMap, rootClassMap, html, cdnMeta, tokenData, complianceRules, tokenValueMap } = params;
-    const trimmed = html.trim();
-    if (trimmed.length === 0)
-        return (0, response_js_1.successResponse)({ valid: true });
-    const root = (0, node_html_parser_1.parse)(trimmed);
-    const elements = root.querySelectorAll('[class]');
-    const { errors, warnings, invalidClassesSet, hasNcuaClasses } = (0, bemValidator_js_1.collectBemErrors)({
-        elements,
-        rootClassMap,
-        componentMap,
-    });
-    if (!hasNcuaClasses)
-        return (0, response_js_1.successResponse)({ valid: true });
-    if (cdnMeta)
-        errors.push(...(0, bemValidator_js_1.checkCdnInclusion)(trimmed, cdnMeta));
-    // P13: Vertical Table context 검증 + 페이지 prefix required 마크 검출
-    errors.push(...collectVerticalTableContextErrors(root));
-    warnings.push(...collectCustomRequiredMarkWarnings(root));
-    const compliance = buildCompliance({
-        root,
-        componentMap,
-        rootClassMap,
-        warnings,
-        tokenData,
-        complianceRules,
-        tokenValueMap,
-    });
-    return buildResponse({ errors, warnings, invalidClassesSet, root, compliance });
-};
-exports.validateHtml = validateHtml;
-/** compliance 검증 오케스트레이션 — tokenData 또는 complianceRules가 있을 때만 실행 */
-const buildCompliance = (params) => {
-    const { root, componentMap, rootClassMap, warnings, tokenData, complianceRules, tokenValueMap } = params;
-    if (!complianceRules && !tokenData)
-        return undefined;
-    const ncuaResult = complianceRules
-        ? (0, compliance_js_1.detectNcuaOmission)({ root, complianceRules, componentMap })
-        : { errors: [], ncuaUsage: { used: 0, available: 0 } };
-    const tokenResult = tokenData && tokenValueMap
-        ? (0, compliance_js_1.detectTokenIssues)({ root, tokenData, tokenValueMap })
-        : { errors: [], tokenUsage: { correct: 0, missing: 0, invalid: 0 } };
-    const customResult = (0, compliance_js_1.detectCustomNotSeparated)({ root, rootClassMap, warnings });
-    return (0, compliance_js_1.buildComplianceSummary)({
-        ncuaErrors: ncuaResult.errors,
-        tokenErrors: tokenResult.errors,
-        customErrors: customResult.errors,
-        ncuaUsage: ncuaResult.ncuaUsage,
-        tokenUsage: tokenResult.tokenUsage,
-        customSeparation: customResult.customSeparation,
-    });
-};
-/** P13: Vertical Table context 위반 검출.
- *  1) ncua-table--vertical 안 ncua-table__header-cell → horizontal 전용 오용.
- *  2) ncua-table 안 <tr> 에 ncua-table__row 클래스 누락. */
-const collectVerticalTableContextErrors = (root) => {
-    const errors = [];
-    // (1) vertical 안의 header-cell 검출
-    const verticalRoots = root.querySelectorAll('.ncua-table--vertical');
-    for (const v of verticalRoots) {
-        const headerCells = v.querySelectorAll('.ncua-table__header-cell');
-        for (const _ of headerCells) {
-            errors.push({
-                type: 'vertical_uses_horizontal_header_cell',
-                class: 'ncua-table__header-cell',
-                component: 'table',
-                message: "Vertical Table 안에서 'ncua-table__header-cell' 사용은 horizontal 전용 — vertical 라벨에는 <th scope='row' class='ncua-table__cell'> 사용 (Table.Cell with isHeader=true).",
-                suggestion: "render_to_html('table', { type: 'vertical', children: [...] }) 호출하여 정확한 BEM 출력을 받거나, <th class='ncua-table__header-cell'> 을 <th scope='row' class='ncua-table__cell'> 로 교체.",
-            });
-        }
-    }
-    // (2) ncua-table 안 <tr> 의 ncua-table__row 클래스 누락
-    const allTables = root.querySelectorAll('.ncua-table');
-    for (const t of allTables) {
-        const trs = t.querySelectorAll('tr');
-        for (const tr of trs) {
-            const classAttr = tr.getAttribute('class') ?? '';
-            if (!classAttr.split(/\s+/).includes('ncua-table__row')) {
-                errors.push({
-                    type: 'missing_table_row_class',
-                    class: 'ncua-table__row',
-                    component: 'table',
-                    message: "ncua-table 안의 <tr> 에 'ncua-table__row' 클래스 누락. NCDS Table 의 모든 row 는 이 클래스가 필요.",
-                    suggestion: "render_to_html('table', ...) 출력을 그대로 사용. 수동 작성 시 모든 <tr> 에 class='ncua-table__row' 추가.",
-                });
-                // 같은 row 중복 보고 방지 — 첫 누락만
-                break;
-            }
-        }
-    }
-    return errors;
-};
-/** P13: 페이지 prefix 의 *-required 클래스로 필수 마크 자체 작성 검출.
- *  텍스트가 정확히 `*` 한 글자이면 ncua-table__required 사용 권장. */
-const collectCustomRequiredMarkWarnings = (root) => {
-    const warnings = [];
-    const allWithClass = root.querySelectorAll('[class]');
-    for (const el of allWithClass) {
-        const classAttr = el.getAttribute('class') ?? '';
-        const classes = classAttr.split(/\s+/).filter(Boolean);
-        // ncua- 가 아닌 prefix 의 *-required 또는 __required-mark 같은 형태
-        const matched = classes.find((c) => !c.startsWith('ncua-') && /(-required(?:-mark)?$|__required(?:-mark)?$)/.test(c));
-        if (!matched)
-            continue;
-        const text = (el.text ?? '').trim();
-        if (text !== '*')
-            continue;
-        warnings.push({
-            type: 'custom_required_mark',
-            class: matched,
-            component: 'table',
-            message: `페이지 prefix 클래스 '${matched}' 로 '*' 필수 마크를 자체 작성. NCDS 가 공식 element 'ncua-table__required' 를 제공.`,
-            suggestion: `<span class='${matched}'>*</span> 를 <span class='ncua-table__required'>*</span> 로 교체 (Vertical Table 라벨 셀 안에 prepend).`,
-        });
-    }
-    return warnings;
-};
-/** 최종 응답 빌드 */
-const buildResponse = (params) => {
-    const { errors, warnings, invalidClassesSet, root, compliance } = params;
-    if (errors.length === 0 && warnings.length === 0 && !compliance)
-        return (0, response_js_1.successResponse)({ valid: true });
-    if (errors.length === 0 && warnings.length === 0 && compliance)
-        return (0, response_js_1.successResponse)({ valid: true, compliance });
-    if (errors.length === 0)
-        return (0, response_js_1.successResponse)({ valid: true, warnings, ...(compliance && { compliance }) });
-    return (0, response_js_1.successResponse)({
-        valid: false,
-        errors,
-        ...(warnings.length > 0 && { warnings }),
-        fixed_html: (0, bemValidator_js_1.buildFixedHtml)(root, invalidClassesSet),
-        ...(compliance && { compliance }),
-    });
-};
-var bemValidator_js_2 = require("../utils/bemValidator.js");
-Object.defineProperty(exports, "buildRootClassMap", { enumerable: true, get: function () { return bemValidator_js_2.buildRootClassMap; } });
-var tokenValidator_js_1 = require("../utils/tokenValidator.js");
-Object.defineProperty(exports, "buildTokenValueMap", { enumerable: true, get: function () { return tokenValidator_js_1.buildTokenValueMap; } });
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildTokenValueMap=exports.buildRootClassMap=exports.validateHtml=void 0;const e=require("node-html-parser"),s=require("../utils/bemValidator.js"),t=require("../utils/compliance.js"),a=require("../utils/response.js"),r=t=>{const{componentMap:r,rootClassMap:i,html:u,cdnMeta:p,tokenData:d,complianceRules:m,tokenValueMap:b}=t,_=u.trim();if(0===_.length)return(0,a.successResponse)({valid:!0});const g=(0,e.parse)(_),h=g.querySelectorAll("[class]"),{errors:f,warnings:M,invalidClassesSet:k,hasNcuaClasses:v}=(0,s.collectBemErrors)({elements:h,rootClassMap:i,componentMap:r});if(!v)return(0,a.successResponse)({valid:!0});p&&f.push(...(0,s.checkCdnInclusion)(_,p)),f.push(...l(g)),M.push(...n(g));const C=o({root:g,componentMap:r,rootClassMap:i,warnings:M,tokenData:d,complianceRules:m,tokenValueMap:b});return c({errors:f,warnings:M,invalidClassesSet:k,root:g,compliance:C})};exports.validateHtml=r;const o=e=>{const{root:s,componentMap:a,rootClassMap:r,warnings:o,tokenData:l,complianceRules:n,tokenValueMap:c}=e;if(!n&&!l)return;const i=n?(0,t.detectNcuaOmission)({root:s,complianceRules:n,componentMap:a}):{errors:[],ncuaUsage:{used:0,available:0}},u=l&&c?(0,t.detectTokenIssues)({root:s,tokenData:l,tokenValueMap:c}):{errors:[],tokenUsage:{correct:0,missing:0,invalid:0}},p=(0,t.detectCustomNotSeparated)({root:s,rootClassMap:r,warnings:o});return(0,t.buildComplianceSummary)({ncuaErrors:i.errors,tokenErrors:u.errors,customErrors:p.errors,ncuaUsage:i.ncuaUsage,tokenUsage:u.tokenUsage,customSeparation:p.customSeparation})},l=e=>{const s=[],t=e.querySelectorAll(".ncua-table--vertical");for(const e of t){const t=e.querySelectorAll(".ncua-table__header-cell");for(const e of t)s.push({type:"vertical_uses_horizontal_header_cell",class:"ncua-table__header-cell",component:"table",message:"Vertical Table 안에서 'ncua-table__header-cell' 사용은 horizontal 전용 — vertical 라벨에는 <th scope='row' class='ncua-table__cell'> 사용 (Table.Cell with isHeader=true).",suggestion:"render_to_html('table', { type: 'vertical', children: [...] }) 호출하여 정확한 BEM 출력을 받거나, <th class='ncua-table__header-cell'> 을 <th scope='row' class='ncua-table__cell'> 로 교체."})}const a=e.querySelectorAll(".ncua-table");for(const e of a){const t=e.querySelectorAll("tr");for(const e of t)if(!(e.getAttribute("class")??"").split(/\s+/).includes("ncua-table__row")){s.push({type:"missing_table_row_class",class:"ncua-table__row",component:"table",message:"ncua-table 안의 <tr> 에 'ncua-table__row' 클래스 누락. NCDS Table 의 모든 row 는 이 클래스가 필요.",suggestion:"render_to_html('table', ...) 출력을 그대로 사용. 수동 작성 시 모든 <tr> 에 class='ncua-table__row' 추가."});break}}return s},n=e=>{const s=[],t=e.querySelectorAll("[class]");for(const e of t){const t=(e.getAttribute("class")??"").split(/\s+/).filter(Boolean).find(e=>!e.startsWith("ncua-")&&/(-required(?:-mark)?$|__required(?:-mark)?$)/.test(e));t&&"*"===(e.text??"").trim()&&s.push({type:"custom_required_mark",class:t,component:"table",message:`페이지 prefix 클래스 '${t}' 로 '*' 필수 마크를 자체 작성. NCDS 가 공식 element 'ncua-table__required' 를 제공.`,suggestion:`<span class='${t}'>*</span> 를 <span class='ncua-table__required'>*</span> 로 교체 (Vertical Table 라벨 셀 안에 prepend).`})}return s},c=e=>{const{errors:t,warnings:r,invalidClassesSet:o,root:l,compliance:n}=e;return 0!==t.length||0!==r.length||n?0===t.length&&0===r.length&&n?(0,a.successResponse)({valid:!0,compliance:n}):0===t.length?(0,a.successResponse)({valid:!0,warnings:r,...n&&{compliance:n}}):(0,a.successResponse)({valid:!1,errors:t,...r.length>0&&{warnings:r},fixed_html:(0,s.buildFixedHtml)(l,o),...n&&{compliance:n}}):(0,a.successResponse)({valid:!0})};var i=require("../utils/bemValidator.js");Object.defineProperty(exports,"buildRootClassMap",{enumerable:!0,get:function(){return i.buildRootClassMap}});var u=require("../utils/tokenValidator.js");Object.defineProperty(exports,"buildTokenValueMap",{enumerable:!0,get:function(){return u.buildTokenValueMap}});

package/bin/types.js

@@ -1,5 +1 @@
-"use strict";
-/**
- * MCP 서버 공통 타입 정의
- */
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});

package/bin/utils/bemValidator.js

@@ -1,210 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getClassList = exports.collectBemErrors = exports.checkCdnInclusion = exports.buildRootClassMap = exports.buildFixedHtml = void 0;
-// ── 상수 ─────────────────────────────────────────────────────────────────
-const MAX_SIMILAR_SUGGESTIONS = 3;
-// ── 순수 헬퍼 ────────────────────────────────────────────────────────────
-/** 엘리먼트에서 class 목록을 파싱 */
-const getClassList = (el) => el.getAttribute('class')?.split(/\s+/) ?? [];
-exports.getClassList = getClassList;
-/** root class → component name 매핑 빌드 — server.ts에서 1회 호출 */
-const buildRootClassMap = (componentMap) => {
-    const rootClassMap = new Map();
-    for (const [name, data] of componentMap) {
-        for (const cls of data.bemClasses) {
-            if (!cls.includes('--') && !cls.includes('__'))
-                rootClassMap.set(cls, name);
-        }
-    }
-    return rootClassMap;
-};
-exports.buildRootClassMap = buildRootClassMap;
-/** ncua- 클래스에서 root class를 결정 (modifier/element 제외, 가장 짧은 것) */
-const findRootClass = (ncuaClasses) => {
-    const roots = ncuaClasses.filter((c) => !c.includes('--') && !c.includes('__'));
-    if (roots.length === 0)
-        return undefined;
-    return roots.sort((a, b) => a.length - b.length)[0];
-};
-/** BEM 구분자(-- 또는 __)의 첫 위치를 반환. 없으면 -1 */
-const findFirstSeparatorIndex = (dashIdx, underIdx) => {
-    if (dashIdx >= 0 && underIdx >= 0)
-        return Math.min(dashIdx, underIdx);
-    if (dashIdx >= 0)
-        return dashIdx;
-    return underIdx;
-};
-/** modifier/element 클래스에서 root class를 추론 */
-const inferRootClass = (ncuaClasses, rootClassMap) => {
-    for (const cls of ncuaClasses) {
-        const sepIdx = findFirstSeparatorIndex(cls.indexOf('--'), cls.indexOf('__'));
-        if (sepIdx > 0) {
-            const candidate = cls.substring(0, sepIdx);
-            if (rootClassMap.has(candidate))
-                return candidate;
-        }
-    }
-    return undefined;
-};
-/** 문자열 유사도 — 공통 접두사 길이 기반 */
-const prefixSimilarity = (a, b) => {
-    let i = 0;
-    while (i < a.length && i < b.length && a[i] === b[i])
-        i++;
-    return i;
-};
-/** 유사도 상위 N개 제안 — modifier 오류면 modifier만, element 오류면 element만 */
-const suggestSimilar = (invalidClass, validClasses, max = MAX_SIMILAR_SUGGESTIONS) => {
-    const isElement = invalidClass.includes('__');
-    return validClasses
-        .filter((c) => (isElement ? c.includes('__') : c.includes('--')))
-        .map((c) => ({ class: c, score: prefixSimilarity(invalidClass, c) }))
-        .sort((a, b) => b.score - a.score)
-        .slice(0, max)
-        .map((item) => item.class);
-};
-/** unknown component 에러 수집 */
-const reportUnknownClasses = (ncuaClasses, errors, invalidClassesSet) => {
-    for (const cls of ncuaClasses) {
-        errors.push({
-            type: 'unknown_component',
-            class: cls,
-            component: 'unknown',
-            message: `Unknown component class '${cls}'. No matching component found.`,
-            suggestion: 'Use list_components to see all available components.',
-        });
-        invalidClassesSet.add(cls);
-    }
-};
-/** BEM 클래스 유효성 검증 */
-const validateBemClasses = (ncuaClasses, validSet, componentName, bemClasses, errors, invalidClassesSet) => {
-    for (const cls of ncuaClasses) {
-        if (validSet.has(cls))
-            continue;
-        const similar = suggestSimilar(cls, bemClasses);
-        errors.push({
-            type: cls.includes('__') ? 'invalid_element' : 'invalid_modifier',
-            class: cls,
-            component: componentName,
-            message: `Invalid BEM class '${cls}' for component '${componentName}'.`,
-            suggestion: similar.length > 0 ? `Similar: ${similar.join(', ')}` : 'Use get_component_props to see valid BEM classes.',
-        });
-        invalidClassesSet.add(cls);
-    }
-};
-// ── BEM 검증 엔트리 함수 ────────────────────────────────────────────────
-/** 엘리먼트별 BEM 클래스 검증 → errors + warnings + invalidClasses 수집 */
-const collectBemErrors = (params) => {
-    const { elements, rootClassMap, componentMap } = params;
-    const errors = [];
-    const warnings = [];
-    const invalidClassesSet = new Set();
-    const validSetCache = new Map();
-    let foundNcua = false;
-    for (const el of elements) {
-        const classes = getClassList(el);
-        const ncuaClasses = classes.filter((c) => c.startsWith('ncua-'));
-        if (ncuaClasses.length === 0)
-            continue;
-        foundNcua = true;
-        let rootClass = findRootClass(ncuaClasses);
-        if (!rootClass || !rootClassMap.has(rootClass)) {
-            const inferred = inferRootClass(ncuaClasses, rootClassMap);
-            if (inferred)
-                rootClass = inferred;
-        }
-        collectMixedNamespaceWarning(classes, ncuaClasses, rootClass, rootClassMap, warnings);
-        collectMissingRootClassError(ncuaClasses, rootClass, rootClassMap, errors);
-        if (!rootClass || !rootClassMap.has(rootClass)) {
-            reportUnknownClasses(ncuaClasses, errors, invalidClassesSet);
-            continue;
-        }
-        // biome-ignore lint/style/noNonNullAssertion: 직전 가드(rootClassMap.has)로 존재 보장
-        const componentName = rootClassMap.get(rootClass);
-        const component = componentMap.get(componentName);
-        if (!component) {
-            // rootClassMap 에는 있는데 componentMap 에 없는 비정상 상태 (호출자가 두 Map 을 분리 빌드한 경우).
-            // graceful skip — rootClass 가 알 수 없는 컴포넌트인 경로와 동일 처리.
-            reportUnknownClasses(ncuaClasses, errors, invalidClassesSet);
-            continue;
-        }
-        if (!validSetCache.has(componentName))
-            validSetCache.set(componentName, new Set(component.bemClasses));
-        validateBemClasses(ncuaClasses, 
-        // biome-ignore lint/style/noNonNullAssertion: 직전 has/set 보장
-        validSetCache.get(componentName), componentName, component.bemClasses, errors, invalidClassesSet);
-    }
-    return { errors, warnings, invalidClassesSet, hasNcuaClasses: foundNcua };
-};
-exports.collectBemErrors = collectBemErrors;
-/** mixed_namespace 경고 수집 */
-const collectMixedNamespaceWarning = (classes, ncuaClasses, rootClass, rootClassMap, warnings) => {
-    const customClasses = classes.filter((c) => !c.startsWith('ncua-'));
-    if (customClasses.length === 0)
-        return;
-    // biome-ignore lint/style/noNonNullAssertion: 삼항 가드로 rootClassMap.has(rootClass) 보장
-    const compName = rootClass && rootClassMap.has(rootClass) ? rootClassMap.get(rootClass) : 'unknown';
-    warnings.push({
-        type: 'mixed_namespace',
-        class: ncuaClasses[0],
-        component: compName,
-        message: `Element mixes NCUA classes (${ncuaClasses.join(', ')}) with custom classes (${customClasses.join(', ')}).`,
-        suggestion: 'Keep NCUA components isolated. Use a separate wrapper for custom styling.',
-    });
-};
-/** missing_root_class 에러 수집 */
-const collectMissingRootClassError = (ncuaClasses, rootClass, rootClassMap, errors) => {
-    const hasModifiers = ncuaClasses.some((c) => c.includes('--'));
-    const hasRootInElement = ncuaClasses.some((c) => !c.includes('--') && !c.includes('__'));
-    const isModifierWithoutRoot = hasModifiers && !hasRootInElement && rootClass != null && rootClassMap.has(rootClass);
-    if (!isModifierWithoutRoot)
-        return;
-    errors.push({
-        type: 'missing_root_class',
-        // biome-ignore lint/style/noNonNullAssertion: isModifierWithoutRoot 가드에 rootClass != null 포함
-        class: rootClass,
-        // biome-ignore lint/style/noNonNullAssertion: 위와 동일 가드 (rootClass != null + has)
-        component: rootClassMap.get(rootClass),
-        message: `Root class '${rootClass}' is missing. Modifiers/elements require their root class.`,
-        suggestion: `Add '${rootClass}' class to the same element.`,
-    });
-};
-/** 잘못된 클래스를 제거하여 fixed_html 생성 */
-const buildFixedHtml = (root, invalidClassesSet) => {
-    for (const el of root.querySelectorAll('[class]')) {
-        const classes = getClassList(el);
-        const filtered = classes.filter((c) => !invalidClassesSet.has(c));
-        if (filtered.length > 0) {
-            el.setAttribute('class', filtered.join(' '));
-        }
-        else {
-            el.removeAttribute('class');
-        }
-    }
-    return root.toString();
-};
-exports.buildFixedHtml = buildFixedHtml;
-/** CDN CSS/JS 링크 포함 여부 검증 */
-const checkCdnInclusion = (html, cdnMeta) => {
-    const errors = [];
-    if (!html.includes(cdnMeta.css)) {
-        errors.push({
-            type: 'missing_cdn',
-            class: '(page-level)',
-            component: '(page-level)',
-            message: 'HTML contains NCUA components but is missing the required CDN CSS link.',
-            suggestion: `Add <link href="${cdnMeta.css}" rel="stylesheet">`,
-        });
-    }
-    if (!html.includes(cdnMeta.js)) {
-        errors.push({
-            type: 'missing_cdn',
-            class: '(page-level)',
-            component: '(page-level)',
-            message: 'HTML contains NCUA components but is missing the required CDN JS link.',
-            suggestion: `Add <script src="${cdnMeta.js}"></script>`,
-        });
-    }
-    return errors;
-};
-exports.checkCdnInclusion = checkCdnInclusion;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.getClassList=exports.collectBemErrors=exports.checkCdnInclusion=exports.buildRootClassMap=exports.buildFixedHtml=void 0;const s=3,e=s=>s.getAttribute("class")?.split(/\s+/)??[];exports.getClassList=e;const t=s=>{const e=new Map;for(const[t,n]of s)for(const s of n.bemClasses)s.includes("--")||s.includes("__")||e.set(s,t);return e};exports.buildRootClassMap=t;const n=s=>{const e=s.filter(s=>!s.includes("--")&&!s.includes("__"));if(0!==e.length)return e.sort((s,e)=>s.length-e.length)[0]},o=(s,e)=>s>=0&&e>=0?Math.min(s,e):s>=0?s:e,c=(s,e)=>{for(const t of s){const s=o(t.indexOf("--"),t.indexOf("__"));if(s>0){const n=t.substring(0,s);if(e.has(n))return n}}},i=(s,e)=>{let t=0;for(;t<s.length&&t<e.length&&s[t]===e[t];)t++;return t},l=(s,e,t=3)=>{const n=s.includes("__");return e.filter(s=>n?s.includes("__"):s.includes("--")).map(e=>({class:e,score:i(s,e)})).sort((s,e)=>e.score-s.score).slice(0,t).map(s=>s.class)},r=(s,e,t)=>{for(const n of s)e.push({type:"unknown_component",class:n,component:"unknown",message:`Unknown component class '${n}'. No matching component found.`,suggestion:"Use list_components to see all available components."}),t.add(n)},a=(s,e,t,n,o,c)=>{for(const i of s){if(e.has(i))continue;const s=l(i,n);o.push({type:i.includes("__")?"invalid_element":"invalid_modifier",class:i,component:t,message:`Invalid BEM class '${i}' for component '${t}'.`,suggestion:s.length>0?`Similar: ${s.join(", ")}`:"Use get_component_props to see valid BEM classes."}),c.add(i)}},u=s=>{const{elements:t,rootClassMap:o,componentMap:i}=s,l=[],u=[],g=new Set,d=new Map;let f=!1;for(const s of t){const t=e(s),h=t.filter(s=>s.startsWith("ncua-"));if(0===h.length)continue;f=!0;let _=n(h);if(!_||!o.has(_)){const s=c(h,o);s&&(_=s)}if(p(t,h,_,o,u),m(h,_,o,l),!_||!o.has(_)){r(h,l,g);continue}const C=o.get(_),x=i.get(C);x?(d.has(C)||d.set(C,new Set(x.bemClasses)),a(h,d.get(C),C,x.bemClasses,l,g)):r(h,l,g)}return{errors:l,warnings:u,invalidClassesSet:g,hasNcuaClasses:f}};exports.collectBemErrors=u;const p=(s,e,t,n,o)=>{const c=s.filter(s=>!s.startsWith("ncua-"));if(0===c.length)return;const i=t&&n.has(t)?n.get(t):"unknown";o.push({type:"mixed_namespace",class:e[0],component:i,message:`Element mixes NCUA classes (${e.join(", ")}) with custom classes (${c.join(", ")}).`,suggestion:"Keep NCUA components isolated. Use a separate wrapper for custom styling."})},m=(s,e,t,n)=>{const o=s.some(s=>s.includes("--")),c=s.some(s=>!s.includes("--")&&!s.includes("__"));o&&!c&&null!=e&&t.has(e)&&n.push({type:"missing_root_class",class:e,component:t.get(e),message:`Root class '${e}' is missing. Modifiers/elements require their root class.`,suggestion:`Add '${e}' class to the same element.`})},g=(s,t)=>{for(const n of s.querySelectorAll("[class]")){const s=e(n).filter(s=>!t.has(s));s.length>0?n.setAttribute("class",s.join(" ")):n.removeAttribute("class")}return s.toString()};exports.buildFixedHtml=g;const d=(s,e)=>{const t=[];return s.includes(e.css)||t.push({type:"missing_cdn",class:"(page-level)",component:"(page-level)",message:"HTML contains NCUA components but is missing the required CDN CSS link.",suggestion:`Add <link href="${e.css}" rel="stylesheet">`}),s.includes(e.js)||t.push({type:"missing_cdn",class:"(page-level)",component:"(page-level)",message:"HTML contains NCUA components but is missing the required CDN JS link.",suggestion:`Add <script src="${e.js}"><\/script>`}),t};exports.checkCdnInclusion=d;

package/bin/utils/compliance.js

@@ -1,203 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectTokenIssues = exports.detectNcuaOmission = exports.detectCustomNotSeparated = exports.buildComplianceSummary = void 0;
-const bemValidator_js_1 = require("./bemValidator.js");
-// ── 상수 ─────────────────────────────────────────────────────────────────
-const MAX_COMPLIANCE_ERRORS = 10;
-const NCUA_NOT_USED_MEDIUM_WEIGHT = 0.5;
-const COMPLIANCE_WEIGHTS = {
-    ncua_not_used: 1.0,
-    token_not_used: 0.5,
-    invalid_token: 1.0,
-    custom_not_separated: 1.0,
-};
-/** 규칙의 hints가 요소 속성과 매칭되는지 확인 */
-const matchesHints = (el, hints) => {
-    if (!hints)
-        return true;
-    for (const hint of hints) {
-        const attrValue = el.getAttribute(hint.attr);
-        if (!attrValue || !hint.values.includes(attrValue.toLowerCase()))
-            return false;
-    }
-    return true;
-};
-/** 태그명 → 해당 태그의 규칙 배열 인덱스 (§ 5.3 O(n) 전환) */
-const buildTagRuleIndex = (rules, componentMap) => {
-    const index = new Map();
-    for (const rule of rules) {
-        if (!componentMap.has(rule.ncuaComponent))
-            continue;
-        const existing = index.get(rule.match.tag);
-        if (existing)
-            existing.push(rule);
-        else
-            index.set(rule.match.tag, [rule]);
-    }
-    return index;
-};
-/** ncua- root class → compliance rule의 ncuaComponent 매핑 */
-const buildNcuaRootToComponentMap = (complianceRules, componentMap) => {
-    const map = new Map();
-    for (const rule of complianceRules.patterns) {
-        const component = componentMap.get(rule.ncuaComponent);
-        if (!component)
-            continue;
-        for (const cls of component.bemClasses) {
-            if (!cls.includes('--') && !cls.includes('__'))
-                map.set(cls, rule.ncuaComponent);
-        }
-    }
-    return map;
-};
-/** compliance rules 중 componentMap에 실제 존재하는 고유 컴포넌트 수 */
-const countAvailableComponents = (patterns, componentMap) => {
-    const available = new Set();
-    for (const rule of patterns) {
-        if (componentMap.has(rule.ncuaComponent))
-            available.add(rule.ncuaComponent);
-    }
-    return available.size;
-};
-// ── 검증 함수 ────────────────────────────────────────────────────────────
-/** ncua 클래스를 가진 요소에서 사용 중인 컴포넌트 수집 */
-const collectUsedComponents = (el, ncuaRootMap, usedComponents) => {
-    for (const cls of (0, bemValidator_js_1.getClassList)(el)) {
-        const comp = ncuaRootMap.get(cls);
-        if (comp)
-            usedComponents.add(comp);
-    }
-};
-/** 네이티브 HTML 요소에서 ncua_not_used 에러 매칭 */
-const matchNativeElement = (el, tagIndex) => {
-    const tag = el.tagName?.toLowerCase();
-    if (!tag)
-        return undefined;
-    const candidateRules = tagIndex.get(tag);
-    if (!candidateRules)
-        return undefined;
-    for (const rule of candidateRules) {
-        if (!matchesHints(el, rule.match.hints))
-            continue;
-        return {
-            type: 'ncua_not_used',
-            target: `<${tag}>`,
-            component: rule.ncuaComponent,
-            message: `Native <${tag}> used instead of NCUA '${rule.ncuaComponent}' component.`,
-            suggestion: `Use NCUA '${rule.ncuaComponent}' component. Call search_component('${rule.ncuaComponent}') for usage.`,
-            ...(rule.confidence === 'medium' && { severity: 'warning' }),
-        };
-    }
-    return undefined;
-};
-/** NCUA 컴포넌트 누락 감지 — 태그 인덱스로 O(n) 매칭 */
-const detectNcuaOmission = (params) => {
-    const { root, complianceRules, componentMap } = params;
-    const errors = [];
-    const usedComponents = new Set();
-    const tagIndex = buildTagRuleIndex(complianceRules.patterns, componentMap);
-    const ncuaRootMap = buildNcuaRootToComponentMap(complianceRules, componentMap);
-    for (const el of root.querySelectorAll('*')) {
-        if ((0, bemValidator_js_1.getClassList)(el).some((c) => c.startsWith('ncua-'))) {
-            collectUsedComponents(el, ncuaRootMap, usedComponents);
-            continue;
-        }
-        const error = matchNativeElement(el, tagIndex);
-        if (error)
-            errors.push(error);
-    }
-    return {
-        errors,
-        ncuaUsage: {
-            used: usedComponents.size,
-            available: countAvailableComponents(complianceRules.patterns, componentMap),
-        },
-    };
-};
-exports.detectNcuaOmission = detectNcuaOmission;
-/** NCUA 컴포넌트 내부 커스텀 스타일 감지 */
-const detectCustomNotSeparated = (params) => {
-    const { root, rootClassMap, warnings } = params;
-    const errors = [];
-    let violated = 0;
-    let clean = 0;
-    const suppressedClasses = new Set();
-    for (const el of root.querySelectorAll('[class]')) {
-        const classes = (0, bemValidator_js_1.getClassList)(el);
-        const ncuaClasses = classes.filter((c) => c.startsWith('ncua-'));
-        if (ncuaClasses.length === 0)
-            continue;
-        const target = ncuaClasses[0];
-        const hasInlineStyle = !!el.getAttribute('style');
-        const isBemInternal = ncuaClasses.some((c) => c.includes('__'));
-        const hasCustomOverride = isBemInternal && classes.some((c) => !c.startsWith('ncua-'));
-        if (hasInlineStyle) {
-            violated++;
-            errors.push(buildCustomError(target, rootClassMap, 'inline'));
-        }
-        else if (hasCustomOverride) {
-            violated++;
-            suppressedClasses.add(target);
-            errors.push(buildCustomError(target, rootClassMap, 'override'));
-        }
-        else {
-            clean++;
-        }
-    }
-    suppressMixedNamespaceWarnings(warnings, suppressedClasses);
-    return { errors, customSeparation: { clean, violated } };
-};
-exports.detectCustomNotSeparated = detectCustomNotSeparated;
-/** custom_not_separated 에러 빌드 */
-const buildCustomError = (target, rootClassMap, kind) => {
-    const rootClass = kind === 'inline' ? target.split('--')[0].split('__')[0] : target.split('__')[0];
-    const message = kind === 'inline'
-        ? `Inline style on NCUA component element '${target}'. NCUA components should not have inline styles.`
-        : `Custom class override on NCUA BEM internal element '${target}'. Do not add custom classes to BEM sub-elements.`;
-    return {
-        type: 'custom_not_separated',
-        target,
-        component: rootClassMap.get(rootClass) ?? 'unknown',
-        message,
-        suggestion: 'Use a separate wrapper outside the NCUA component for custom styling.',
-    };
-};
-/** mixed_namespace warnings 중 suppress 대상을 제거 */
-const suppressMixedNamespaceWarnings = (warnings, suppressedClasses) => {
-    if (suppressedClasses.size === 0)
-        return;
-    for (let i = warnings.length - 1; i >= 0; i--) {
-        if (warnings[i].type === 'mixed_namespace' && suppressedClasses.has(warnings[i].class)) {
-            warnings.splice(i, 1);
-        }
-    }
-};
-/** 준수도 점수 + 요약 빌드 */
-const buildComplianceSummary = (params) => {
-    const { ncuaErrors, tokenErrors, customErrors, ncuaUsage, tokenUsage, customSeparation } = params;
-    const allErrors = [...ncuaErrors, ...tokenErrors, ...customErrors];
-    let weightedViolations = 0;
-    for (const err of allErrors) {
-        const isMedium = err.type === 'ncua_not_used' && err.severity === 'warning';
-        weightedViolations += isMedium ? NCUA_NOT_USED_MEDIUM_WEIGHT : COMPLIANCE_WEIGHTS[err.type];
-    }
-    const ncuaNotUsedCount = ncuaErrors.length;
-    const totalCheckpoints = ncuaUsage.used +
-        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,
-        tokenUsage,
-        customSeparation,
-        totalViolations: allErrors.length,
-    };
-};
-exports.buildComplianceSummary = buildComplianceSummary;
-var tokenValidator_js_1 = require("./tokenValidator.js");
-Object.defineProperty(exports, "detectTokenIssues", { enumerable: true, get: function () { return tokenValidator_js_1.detectTokenIssues; } });
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.detectTokenIssues=exports.detectNcuaOmission=exports.detectCustomNotSeparated=exports.buildComplianceSummary=void 0;const e=require("./bemValidator.js"),t=10,n=.5,o={ncua_not_used:1,token_not_used:.5,invalid_token:1,custom_not_separated:1},s=(e,t)=>{if(!t)return!0;for(const n of t){const t=e.getAttribute(n.attr);if(!t||!n.values.includes(t.toLowerCase()))return!1}return!0},r=(e,t)=>{const n=new Map;for(const o of e){if(!t.has(o.ncuaComponent))continue;const e=n.get(o.match.tag);e?e.push(o):n.set(o.match.tag,[o])}return n},a=(e,t)=>{const n=new Map;for(const o of e.patterns){const e=t.get(o.ncuaComponent);if(e)for(const t of e.bemClasses)t.includes("--")||t.includes("__")||n.set(t,o.ncuaComponent)}return n},c=(e,t)=>{const n=new Set;for(const o of e)t.has(o.ncuaComponent)&&n.add(o.ncuaComponent);return n.size},i=(t,n,o)=>{for(const s of(0,e.getClassList)(t)){const e=n.get(s);e&&o.add(e)}},u=(e,t)=>{const n=e.tagName?.toLowerCase();if(!n)return;const o=t.get(n);if(o)for(const t of o)if(s(e,t.match.hints))return{type:"ncua_not_used",target:`<${n}>`,component:t.ncuaComponent,message:`Native <${n}> used instead of NCUA '${t.ncuaComponent}' component.`,suggestion:`Use NCUA '${t.ncuaComponent}' component. Call search_component('${t.ncuaComponent}') for usage.`,..."medium"===t.confidence&&{severity:"warning"}}},l=t=>{const{root:n,complianceRules:o,componentMap:s}=t,l=[],p=new Set,m=r(o.patterns,s),d=a(o,s);for(const t of n.querySelectorAll("*")){if((0,e.getClassList)(t).some(e=>e.startsWith("ncua-"))){i(t,d,p);continue}const n=u(t,m);n&&l.push(n)}return{errors:l,ncuaUsage:{used:p.size,available:c(o.patterns,s)}}};exports.detectNcuaOmission=l;const p=t=>{const{root:n,rootClassMap:o,warnings:s}=t,r=[];let a=0,c=0;const i=new Set;for(const t of n.querySelectorAll("[class]")){const n=(0,e.getClassList)(t),s=n.filter(e=>e.startsWith("ncua-"));if(0===s.length)continue;const u=s[0],l=!!t.getAttribute("style"),p=s.some(e=>e.includes("__"))&&n.some(e=>!e.startsWith("ncua-"));l?(a++,r.push(m(u,o,"inline"))):p?(a++,i.add(u),r.push(m(u,o,"override"))):c++}return d(s,i),{errors:r,customSeparation:{clean:c,violated:a}}};exports.detectCustomNotSeparated=p;const m=(e,t,n)=>{const o="inline"===n?e.split("--")[0].split("__")[0]:e.split("__")[0],s="inline"===n?`Inline style on NCUA component element '${e}'. NCUA components should not have inline styles.`:`Custom class override on NCUA BEM internal element '${e}'. Do not add custom classes to BEM sub-elements.`;return{type:"custom_not_separated",target:e,component:t.get(o)??"unknown",message:s,suggestion:"Use a separate wrapper outside the NCUA component for custom styling."}},d=(e,t)=>{if(0!==t.size)for(let n=e.length-1;n>=0;n--)"mixed_namespace"===e[n].type&&t.has(e[n].class)&&e.splice(n,1)},f=e=>{const{ncuaErrors:s,tokenErrors:r,customErrors:a,ncuaUsage:c,tokenUsage:i,customSeparation:u}=e,l=[...s,...r,...a];let p=0;for(const e of l)p+="ncua_not_used"===e.type&&"warning"===e.severity?n:o[e.type];const m=s.length,d=c.used+m+(i.correct+i.missing+i.invalid)+(u.clean+u.violated),f=0===d?1:Math.max(0,Math.min(1,1-p/d));return{score:Math.round(100*f)/100,errors:l.slice(0,t),ncuaUsage:c,tokenUsage:i,customSeparation:u,totalViolations:l.length}};exports.buildComplianceSummary=f;var g=require("./tokenValidator.js");Object.defineProperty(exports,"detectTokenIssues",{enumerable:!0,get:function(){return g.detectTokenIssues}});