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

package/bin/utils/dataLoader.js

@@ -1,277 +1 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadTokenData = exports.loadMeta = exports.loadJsApi = exports.loadInstructions = exports.loadIconData = exports.loadComponentsFromDir = exports.loadCompositionOverrides = exports.loadComplianceRules = exports.getComponent = exports.getAllComponents = exports.DEFAULT_DATA_DIR = void 0;
-/**
- * dataLoader — mcp/data/*.json + definitions/ 파일을 읽어 반환
- *
- * 함수 분류:
- *   loadComponentsFromDir, loadCompositionOverrides, loadIconData, loadCdnMeta, loadInstructions → 부수효과 (fs I/O)
- *   getComponent, getAllComponents → 순수 함수 (Map 조회)
- *
- * Map + 메타데이터 소유권은 server.ts가 가진다. 이 파일은 상태를 보유하지 않는다.
- */
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const logger_js_1 = require("./logger.js");
-const response_js_1 = require("./response.js");
-const DEFAULT_DATA_DIR = path_1.default.resolve(__dirname, '../../data');
-exports.DEFAULT_DATA_DIR = DEFAULT_DATA_DIR;
-/**
- * P8: Composition Overrides 위치.
- * extract-mcp-data.ts 가 만드는 data/*.json 위에 컴포넌트 디렉토리를 건드리지 않고
- * allowedChildren / allowedParents / canonicalExample / canonicalExamples / bemClassesExtra 를
- * 추가하는 단일 채널.
- *
- * 빌드 산출물(bin/) 에서는 src/overrides 가 build:server 단계에서 복사되지 않을 수 있으므로
- * src 와 bin 양쪽을 fallback 으로 본다.
- */
-const COMPOSITION_OVERRIDES_CANDIDATES = [
-    path_1.default.resolve(__dirname, '../../src/overrides/composition.json'),
-    path_1.default.resolve(__dirname, '../overrides/composition.json'),
-];
-/** composition.json 파일에서 메타 키를 제거하여 CompositionEntry 객체만 수집 */
-const filterCompositionEntries = (parsed) => {
-    if (typeof parsed !== 'object' || !parsed)
-        return {};
-    const entries = {};
-    for (const [key, value] of Object.entries(parsed)) {
-        if (key.startsWith('_'))
-            continue;
-        if (value && typeof value === 'object' && !Array.isArray(value))
-            entries[key] = value;
-    }
-    return entries;
-};
-const loadCompositionOverrides = () => {
-    for (const candidate of COMPOSITION_OVERRIDES_CANDIDATES) {
-        try {
-            const raw = fs_1.default.readFileSync(candidate, 'utf-8');
-            const parsed = JSON.parse(raw);
-            const entries = filterCompositionEntries(parsed);
-            logger_js_1.logger.info(`composition overrides 로딩: ${Object.keys(entries).length}개 (${path_1.default.basename(candidate)})`);
-            return entries;
-        }
-        catch (err) {
-            // ENOENT: 파일 없으면 다음 후보 시도 (TOCTOU 회피)
-            if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
-                continue;
-            }
-            logger_js_1.logger.warn(`composition overrides 파싱 실패 (${candidate}): ${(0, response_js_1.toErrorMessage)(err)}`);
-            return {};
-        }
-    }
-    return {};
-};
-exports.loadCompositionOverrides = loadCompositionOverrides;
-/** P8: `_` 접두 메타 키를 객체에서 제거 (얕은 필터). canonicalExamples 같은 중첩 맵에서 _note 누출 방지. */
-const stripMetaKeys = (obj) => {
-    if (!obj)
-        return obj;
-    const cleaned = {};
-    for (const [key, value] of Object.entries(obj)) {
-        if (key.startsWith('_'))
-            continue;
-        cleaned[key] = value;
-    }
-    return cleaned;
-};
-/** ComponentData 에 composition overrides 항목을 in-place 병합 — bemClasses 는 union, 나머지는 추가 필드. */
-const mergeCompositionEntry = (component, entry) => {
-    if (entry.bemClassesExtra && entry.bemClassesExtra.length > 0) {
-        const merged = new Set([...component.bemClasses, ...entry.bemClassesExtra]);
-        component.bemClasses = [...merged].sort();
-    }
-    if (entry.allowedChildren)
-        component.allowedChildren = entry.allowedChildren;
-    if (entry.allowedParents)
-        component.allowedParents = entry.allowedParents;
-    if (entry.canonicalExample) {
-        // canonicalExample 내부 _note / _comment 같은 메타 키 제거 — 응답에 누출되지 않도록
-        component.canonicalExample = stripMetaKeys(entry.canonicalExample);
-    }
-    if (entry.canonicalExamples) {
-        // canonicalExamples 내부 _note / _comment 같은 메타 키 제거 — 응답에 누출되지 않도록
-        component.canonicalExamples = stripMetaKeys(entry.canonicalExamples);
-    }
-    // P13: description 끝에 append — list_components 응답에서 컴포넌트 용도 명시
-    if (entry.descriptionExtra) {
-        component.description = `${component.description}\n\n${entry.descriptionExtra}`;
-    }
-    // P13: aliases union — search_component 별칭 보강 (중복 제거)
-    if (entry.aliasesExtra && entry.aliasesExtra.length > 0) {
-        const set = new Set([...(component.aliases ?? []), ...entry.aliasesExtra]);
-        component.aliases = [...set];
-    }
-};
-// ── 검증 헬퍼 (§ 3.8 복잡한 조건을 의도가 드러나는 이름으로 분리) ──────────
-/** JSON.parse 결과가 name: string 필드를 가진 컴포넌트 객체인지 검증 */
-const isValidComponentJson = (data) => !!data && typeof data === 'object' && 'name' in data && typeof data.name === 'string';
-/** JSON.parse 결과가 icons 배열을 가진 아이콘 데이터인지 검증 */
-const isValidIconJson = (data) => !!data && typeof data === 'object' && 'icons' in data && Array.isArray(data.icons);
-// ── 부수효과 함수 (fs I/O) ────────────────────────────────────────────────
-/** data/ 디렉토리의 JSON 파일을 읽어 componentMap + compositionOverrides로 반환 */
-const loadComponentsFromDir = (dataDir) => {
-    if (!fs_1.default.existsSync(dataDir)) {
-        throw new Error(`mcp/data/ 디렉토리가 없습니다: ${dataDir}`);
-    }
-    const jsonFiles = fs_1.default.readdirSync(dataDir).filter((f) => f.endsWith('.json') && !f.startsWith('_'));
-    if (jsonFiles.length === 0) {
-        throw new Error(`mcp/data/ 디렉토리에 JSON 파일이 없습니다: ${dataDir}`);
-    }
-    const map = new Map();
-    // P8: composition overrides (composition.json) 를 한 번만 로딩해 각 컴포넌트에 병합 — 호출자에게도 반환
-    const compositionOverrides = loadCompositionOverrides();
-    for (const file of jsonFiles) {
-        const filePath = path_1.default.join(dataDir, file);
-        const raw = fs_1.default.readFileSync(filePath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!isValidComponentJson(parsed)) {
-            throw new Error(`JSON 파싱 실패 (${file}): name 필드가 없거나 올바르지 않습니다`);
-        }
-        const component = parsed;
-        const compositionOverridesEntry = compositionOverrides[component.name];
-        if (compositionOverridesEntry)
-            mergeCompositionEntry(component, compositionOverridesEntry);
-        map.set(component.name, component);
-    }
-    logger_js_1.logger.info(`컴포넌트 ${map.size}개 로딩 완료`);
-    return { map, compositionOverrides };
-};
-exports.loadComponentsFromDir = loadComponentsFromDir;
-/** data/_icons.json을 읽어 IconData로 반환 (파일 없으면 빈 데이터) */
-const loadIconData = (dataDir) => {
-    const iconPath = path_1.default.join(dataDir, '_icons.json');
-    if (!fs_1.default.existsSync(iconPath)) {
-        logger_js_1.logger.error(`_icons.json이 없습니다: ${iconPath}`);
-        return { totalCount: 0, fillCount: 0, icons: [] };
-    }
-    try {
-        const raw = fs_1.default.readFileSync(iconPath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!isValidIconJson(parsed)) {
-            throw new Error('icons 배열이 없습니다');
-        }
-        return parsed;
-    }
-    catch (err) {
-        logger_js_1.logger.error(`_icons.json 파싱 실패: ${(0, response_js_1.toErrorMessage)(err)}`);
-        return { totalCount: 0, fillCount: 0, icons: [] };
-    }
-};
-exports.loadIconData = loadIconData;
-/** data/_meta.json에서 CDN + icon 메타를 1회 읽기로 로드 */
-const loadMeta = (dataDir) => {
-    const metaPath = path_1.default.join(dataDir, '_meta.json');
-    if (!fs_1.default.existsSync(metaPath))
-        return { cdn: null, icon: null };
-    try {
-        const raw = fs_1.default.readFileSync(metaPath, 'utf-8');
-        const meta = JSON.parse(raw);
-        return {
-            cdn: isValidCdnMeta(meta.cdn) ? meta.cdn : null,
-            icon: isValidIconMeta(meta.icon) ? meta.icon : null,
-        };
-    }
-    catch (err) {
-        logger_js_1.logger.error(`_meta.json 파싱 실패: ${(0, response_js_1.toErrorMessage)(err)}`);
-        return { cdn: null, icon: null };
-    }
-};
-exports.loadMeta = loadMeta;
-/** CdnMeta 스키마 검증 */
-const isValidCdnMeta = (data) => !!data &&
-    typeof data === 'object' &&
-    'version' in data &&
-    'css' in data &&
-    'js' in data &&
-    typeof data.version === 'string';
-/** IconMeta 스키마 검증 */
-const isValidIconMeta = (data) => !!data &&
-    typeof data === 'object' &&
-    'packageName' in data &&
-    'version' in data &&
-    typeof data.packageName === 'string';
-/** data/_tokens.json을 읽어 TokenData로 반환 (파일 없으면 빈 데이터) */
-const loadTokenData = (dataDir) => {
-    const tokenPath = path_1.default.join(dataDir, '_tokens.json');
-    if (!fs_1.default.existsSync(tokenPath)) {
-        logger_js_1.logger.error(`_tokens.json이 없습니다: ${tokenPath}`);
-        return { totalCount: 0, categories: [], groups: [] };
-    }
-    try {
-        const raw = fs_1.default.readFileSync(tokenPath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!isValidTokenJson(parsed)) {
-            throw new Error('totalCount 또는 groups 배열이 없습니다');
-        }
-        return parsed;
-    }
-    catch (err) {
-        logger_js_1.logger.error(`_tokens.json 파싱 실패: ${(0, response_js_1.toErrorMessage)(err)}`);
-        return { totalCount: 0, categories: [], groups: [] };
-    }
-};
-exports.loadTokenData = loadTokenData;
-/** TokenData 스키마 검증 */
-const isValidTokenJson = (data) => !!data &&
-    typeof data === 'object' &&
-    'totalCount' in data &&
-    'groups' in data &&
-    Array.isArray(data.groups);
-/** compliance-rules.json 스키마 검증 */
-const isValidComplianceRulesJson = (data) => !!data && typeof data === 'object' && 'patterns' in data && Array.isArray(data.patterns);
-/** definitions/compliance-rules.json을 로드하여 ComplianceRulesData로 반환 (파일 없으면 null) */
-const loadComplianceRules = (definitionsDir) => {
-    const filePath = path_1.default.resolve(definitionsDir, 'compliance-rules.json');
-    if (!fs_1.default.existsSync(filePath)) {
-        logger_js_1.logger.info('compliance-rules.json이 없습니다 — compliance 검증 비활성화');
-        return null;
-    }
-    try {
-        const raw = fs_1.default.readFileSync(filePath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!isValidComplianceRulesJson(parsed)) {
-            throw new Error('patterns 배열이 없습니다');
-        }
-        return parsed;
-    }
-    catch (err) {
-        logger_js_1.logger.error(`compliance-rules.json 파싱 실패: ${(0, response_js_1.toErrorMessage)(err)}`);
-        return null;
-    }
-};
-exports.loadComplianceRules = loadComplianceRules;
-/** definitions/instructions.md를 로드하여 문자열 반환 */
-const loadInstructions = (definitionsDir) => {
-    const instructionsPath = path_1.default.resolve(definitionsDir, 'instructions.md');
-    return fs_1.default.readFileSync(instructionsPath, 'utf-8').trim();
-};
-exports.loadInstructions = loadInstructions;
-/** definitions/js-api.json을 로드하여 exportName→JsApiInfo Map 반환 */
-const loadJsApi = (definitionsDir) => {
-    const filePath = path_1.default.resolve(definitionsDir, 'js-api.json');
-    if (!fs_1.default.existsSync(filePath)) {
-        logger_js_1.logger.info('js-api.json이 없습니다 — JS API 힌트 비활성화');
-        return new Map();
-    }
-    try {
-        const raw = fs_1.default.readFileSync(filePath, 'utf-8');
-        const data = JSON.parse(raw);
-        return new Map(Object.entries(data));
-    }
-    catch (err) {
-        logger_js_1.logger.error(`js-api.json 파싱 실패: ${(0, response_js_1.toErrorMessage)(err)}`);
-        return new Map();
-    }
-};
-exports.loadJsApi = loadJsApi;
-// ── 순수 함수 (외부 상태 없음, Map을 파라미터로 받음) ──────────────────────
-/** componentMap에서 이름으로 단일 컴포넌트 조회 */
-const getComponent = (map, name) => map.get(name);
-exports.getComponent = getComponent;
-/** componentMap의 모든 컴포넌트를 배열로 반환 */
-const getAllComponents = (map) => Array.from(map.values());
-exports.getAllComponents = getAllComponents;
+"use strict";var e=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.loadTokenData=exports.loadMeta=exports.loadJsApi=exports.loadInstructions=exports.loadIconData=exports.loadComponentsFromDir=exports.loadCompositionOverrides=exports.loadComplianceRules=exports.getComponent=exports.getAllComponents=exports.DEFAULT_DATA_DIR=void 0;const o=e(require("fs")),r=e(require("path")),t=require("./logger.js"),n=require("./response.js"),s=r.default.resolve(__dirname,"../../data");exports.DEFAULT_DATA_DIR=s;const a=[r.default.resolve(__dirname,"../../src/overrides/composition.json"),r.default.resolve(__dirname,"../overrides/composition.json")],i=e=>{if("object"!=typeof e||!e)return{};const o={};for(const[r,t]of Object.entries(e))r.startsWith("_")||t&&"object"==typeof t&&!Array.isArray(t)&&(o[r]=t);return o},l=()=>{for(const e of a)try{const n=o.default.readFileSync(e,"utf-8"),s=JSON.parse(n),a=i(s);return t.logger.info(`composition overrides 로딩: ${Object.keys(a).length}개 (${r.default.basename(e)})`),a}catch(o){if(o instanceof Error&&"code"in o&&"ENOENT"===o.code)continue;return t.logger.warn(`composition overrides 파싱 실패 (${e}): ${(0,n.toErrorMessage)(o)}`),{}}return{}};exports.loadCompositionOverrides=l;const c=e=>{if(!e)return e;const o={};for(const[r,t]of Object.entries(e))r.startsWith("_")||(o[r]=t);return o},u=(e,o)=>{if(o.bemClassesExtra&&o.bemClassesExtra.length>0){const r=new Set([...e.bemClasses,...o.bemClassesExtra]);e.bemClasses=[...r].sort()}if(o.allowedChildren&&(e.allowedChildren=o.allowedChildren),o.allowedParents&&(e.allowedParents=o.allowedParents),o.canonicalExample&&(e.canonicalExample=c(o.canonicalExample)),o.canonicalExamples&&(e.canonicalExamples=c(o.canonicalExamples)),o.descriptionExtra&&(e.description=`${e.description}\n\n${o.descriptionExtra}`),o.aliasesExtra&&o.aliasesExtra.length>0){const r=new Set([...e.aliases??[],...o.aliasesExtra]);e.aliases=[...r]}},p=e=>!!e&&"object"==typeof e&&"name"in e&&"string"==typeof e.name,d=e=>!!e&&"object"==typeof e&&"icons"in e&&Array.isArray(e.icons),f=e=>{if(!o.default.existsSync(e))throw new Error(`mcp/data/ 디렉토리가 없습니다: ${e}`);const n=o.default.readdirSync(e).filter(e=>e.endsWith(".json")&&!e.startsWith("_"));if(0===n.length)throw new Error(`mcp/data/ 디렉토리에 JSON 파일이 없습니다: ${e}`);const s=new Map,a=l();for(const t of n){const n=r.default.join(e,t),i=o.default.readFileSync(n,"utf-8"),l=JSON.parse(i);if(!p(l))throw new Error(`JSON 파싱 실패 (${t}): name 필드가 없거나 올바르지 않습니다`);const c=l,d=a[c.name];d&&u(c,d),s.set(c.name,c)}return t.logger.info(`컴포넌트 ${s.size}개 로딩 완료`),{map:s,compositionOverrides:a}};exports.loadComponentsFromDir=f;const g=e=>{const s=r.default.join(e,"_icons.json");if(!o.default.existsSync(s))return t.logger.error(`_icons.json이 없습니다: ${s}`),{totalCount:0,fillCount:0,icons:[]};try{const e=o.default.readFileSync(s,"utf-8"),r=JSON.parse(e);if(!d(r))throw new Error("icons 배열이 없습니다");return r}catch(e){return t.logger.error(`_icons.json 파싱 실패: ${(0,n.toErrorMessage)(e)}`),{totalCount:0,fillCount:0,icons:[]}}};exports.loadIconData=g;const m=e=>{const s=r.default.join(e,"_meta.json");if(!o.default.existsSync(s))return{cdn:null,icon:null};try{const e=o.default.readFileSync(s,"utf-8"),r=JSON.parse(e);return{cdn:x(r.cdn)?r.cdn:null,icon:y(r.icon)?r.icon:null}}catch(e){return t.logger.error(`_meta.json 파싱 실패: ${(0,n.toErrorMessage)(e)}`),{cdn:null,icon:null}}};exports.loadMeta=m;const x=e=>!!e&&"object"==typeof e&&"version"in e&&"css"in e&&"js"in e&&"string"==typeof e.version,y=e=>!!e&&"object"==typeof e&&"packageName"in e&&"version"in e&&"string"==typeof e.packageName,j=e=>{const s=r.default.join(e,"_tokens.json");if(!o.default.existsSync(s))return t.logger.error(`_tokens.json이 없습니다: ${s}`),{totalCount:0,categories:[],groups:[]};try{const e=o.default.readFileSync(s,"utf-8"),r=JSON.parse(e);if(!E(r))throw new Error("totalCount 또는 groups 배열이 없습니다");return r}catch(e){return t.logger.error(`_tokens.json 파싱 실패: ${(0,n.toErrorMessage)(e)}`),{totalCount:0,categories:[],groups:[]}}};exports.loadTokenData=j;const E=e=>!!e&&"object"==typeof e&&"totalCount"in e&&"groups"in e&&Array.isArray(e.groups),S=e=>!!e&&"object"==typeof e&&"patterns"in e&&Array.isArray(e.patterns),_=e=>{const s=r.default.resolve(e,"compliance-rules.json");if(!o.default.existsSync(s))return t.logger.info("compliance-rules.json이 없습니다 — compliance 검증 비활성화"),null;try{const e=o.default.readFileSync(s,"utf-8"),r=JSON.parse(e);if(!S(r))throw new Error("patterns 배열이 없습니다");return r}catch(e){return t.logger.error(`compliance-rules.json 파싱 실패: ${(0,n.toErrorMessage)(e)}`),null}};exports.loadComplianceRules=_;const h=e=>{const t=r.default.resolve(e,"instructions.md");return o.default.readFileSync(t,"utf-8").trim()};exports.loadInstructions=h;const C=e=>{const s=r.default.resolve(e,"js-api.json");if(!o.default.existsSync(s))return t.logger.info("js-api.json이 없습니다 — JS API 힌트 비활성화"),new Map;try{const e=o.default.readFileSync(s,"utf-8"),r=JSON.parse(e);return new Map(Object.entries(r))}catch(e){return t.logger.error(`js-api.json 파싱 실패: ${(0,n.toErrorMessage)(e)}`),new Map}};exports.loadJsApi=C;const w=(e,o)=>e.get(o);exports.getComponent=w;const v=e=>Array.from(e.values());exports.getAllComponents=v;

package/bin/utils/domEnvironment.js

@@ -1,77 +1 @@
-"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;
-    /* v8 ignore next 3 -- Node.js 환경에서 navigator 미존재 시 설정. 테스트 실행 순서에 따라 이미 설정된 경우 스킵 */
-    if (typeof globalThis.navigator === 'undefined') {
-        Object.defineProperty(globalThis, 'navigator', { value: dom.window.navigator, writable: true });
-    }
-    // Swiper 등 외부 라이브러리가 HTMLElement를 직접 참조 — jsdom에서 전역 노출
-    for (const key of [
-        'HTMLElement',
-        'HTMLDivElement',
-        'HTMLSpanElement',
-        'Element',
-        'Node',
-        'Event',
-        'CustomEvent',
-        'Image',
-    ]) {
-        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;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.setupDomEnvironment=void 0;const e=()=>{const e=require("module"),o={},t=e=>{try{o[e]=require.resolve(e)}catch{}};t("react"),t("react-dom"),t("react/jsx-runtime"),t("@ncds/ui-admin-icon"),t("swiper/react"),t("swiper");const r=e._resolveFilename;e._resolveFilename=function(e,t,n,i){return e in o?o[e]:r.call(this,e,t,n,i)}},o=()=>{e();const{JSDOM:o}=require("jsdom"),t=new o("<!DOCTYPE html><html><body></body></html>");void 0===globalThis.document&&(globalThis.document=t.window.document),void 0===globalThis.window&&(globalThis.window=t.window),void 0===globalThis.navigator&&Object.defineProperty(globalThis,"navigator",{value:t.window.navigator,writable:!0});for(const e of["HTMLElement","HTMLDivElement","HTMLSpanElement","Element","Node","Event","CustomEvent","Image"])void 0===globalThis[e]&&(globalThis[e]=t.window[e]);require("react-dom").createPortal=e=>e;const r=require("react"),{renderToStaticMarkup:n}=require("react-dom/server");return{createElement:r.createElement,renderToStaticMarkup:n}};exports.setupDomEnvironment=o;

package/bin/utils/fuzzyMatch.js

@@ -1,120 +1 @@
-"use strict";
-/**
- * 한국어/영어 퍼지 매칭 유틸
- *
- * - 공백 제거 후 비교 ("약관동의" ↔ "약관 동의")
- * - 부분 포함 ("비번" ⊂ "비밀번호"는 안 되지만, "로딩" ⊂ "로딩중"은 됨)
- * - 편집 거리(Levenshtein) 기반 오타 허용 ("셀랙트" ↔ "셀렉트", "buttn" ↔ "button")
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bestFuzzyMatch = exports.fuzzyMatch = exports.similarity = exports.editDistance = 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];
-};
-exports.editDistance = editDistance;
-/** 편집 거리 기반 유사도 (0~1, 1이 완전 일치) */
-const similarity = (a, b) => {
-    const maxLen = Math.max(a.length, b.length);
-    if (maxLen === 0)
-        return 1;
-    return 1 - (0, exports.editDistance)(a, b) / maxLen;
-};
-exports.similarity = similarity;
-/**
- * query가 target에 매칭되는지 퍼지 검사
- *
- * @returns null이면 매칭 실패, FuzzyResult면 매칭 성공
- */
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: 정확/포함/퍼지 단계별 매칭 분기 — 알고리즘 본질, 별 리팩토링 거리
-const fuzzyMatch = (query, target) => {
-    const q = normalize(query);
-    const t = normalize(target);
-    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 = (0, exports.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 = (0, exports.editDistance)(q, sub);
-            if (subDist <= typoThreshold) {
-                const subSimilarity = q.length === 0 ? 1 : 1 - subDist / q.length;
-                return { score: SUBSTRING_BASE_SCORE + SUBSTRING_BONUS_MULTIPLIER * subSimilarity, matchType: 'fuzzy' };
-            }
-        }
-    }
-    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;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.bestFuzzyMatch=exports.fuzzyMatch=exports.similarity=exports.editDistance=void 0;const t=.7,e=.2,n=2,r=.3,s=2,o=100,c=.5,l=.2,h=t=>t.toLowerCase().replace(/[\s\-_]/g,""),i=(t,e)=>{const n=t.length,r=e.length;if(0===n)return r;if(0===r)return n;let s=Array.from({length:r+1},(t,e)=>e),o=new Array(r+1);for(let c=1;c<=n;c++){o[0]=c;for(let n=1;n<=r;n++){const r=t[c-1]===e[n-1]?0:1;o[n]=Math.min(s[n]+1,o[n-1]+1,s[n-1]+r)}[s,o]=[o,s]}return s[r]};exports.editDistance=i;const a=(t,e)=>{const n=Math.max(t.length,e.length);return 0===n?1:1-(0,exports.editDistance)(t,e)/n};exports.similarity=a;const u=(n,s)=>{const i=h(n),a=h(s);if(!i||!a)return null;if(a===i)return{score:1,matchType:"exact"};if(a.includes(i)||i.includes(a)){const n=Math.min(i.length,a.length),r=Math.max(i.length,a.length);return{score:t+e*(n/r),matchType:"contains"}}const u=i.length<=2?1:Math.ceil(i.length*r),g=(0,exports.editDistance)(i,a),f=a.length>i.length+2,p=i.length>=2,x=a.length<=o;if(f&&p&&x)for(let t=0;t<=a.length-i.length;t++){const e=a.substring(t,t+i.length),n=(0,exports.editDistance)(i,e);if(n<=u){const t=0===i.length?1:1-n/i.length;return{score:c+l*t,matchType:"fuzzy"}}}if(g<=u){const t=Math.max(i.length,a.length);return{score:0===t?1:1-g/t,matchType:"fuzzy"}}return null};exports.fuzzyMatch=u;const g=(t,e)=>{let n=null;for(const r of e){const e=(0,exports.fuzzyMatch)(t,r);e&&(!n||e.score>n.score)&&(n=e)}return n};exports.bestFuzzyMatch=g;

package/bin/utils/logger.js

@@ -1,27 +1 @@
-"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`);
-    },
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.logger=void 0,exports.logger={info:r=>{process.stderr.write(`[INFO] ${r}\n`)},warn:r=>{process.stderr.write(`[WARN] ${r}\n`)},error:r=>{process.stderr.write(`[ERROR] ${r}\n`)}};

package/bin/utils/response.js

@@ -1,39 +1 @@
-"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;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.toErrorMessage=exports.normalizeName=exports.appendPingReminder=exports.componentNotFoundResponse=exports.errorResponse=exports.successResponse=void 0;const e=e=>({content:[{type:"text",text:JSON.stringify(e)}]});exports.successResponse=e;const t=(e,t,o,s)=>({content:[{type:"text",text:JSON.stringify({code:e,message:t,suggestion:o,...s&&s.length>0&&{warnings:s}})}],isError:!0});exports.errorResponse=t;const o=e=>(0,exports.errorResponse)("COMPONENT_NOT_FOUND",`Component '${e}' not found.`,"Use search_component to find similar components, or list_components to see all available.");exports.componentNotFoundResponse=o;const s=(e,t)=>{const o=`${e.content[0].text}\n\n${t}`;return{...e,content:[{type:"text",text:o}]}};exports.appendPingReminder=s;const n=e=>e.trim().toLowerCase();exports.normalizeName=n;const r=e=>e instanceof Error?e.message:String(e);exports.toErrorMessage=r;