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

package/bin/definitions/external/editor.js

@@ -1,53 +1 @@
-"use strict";
-/**
- * Story 5.10: editor 외부 분기 정의
- *
- * froala 기반 에디터(`@ncds/editor-html`)의 응답 메타·CDN URL·props·cdnDefaults·methods.
- * `tools/external/editor.ts` 의 `buildEditorResponse` 가 본 정의를 읽어 응답 조립.
- * (json 대신 ts — tsconfig `module: Node16` 환경에서 import 단순화. 빌드 시 자동 포함.)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.editorDefinition = void 0;
-exports.editorDefinition = {
-    name: 'editor',
-    className: 'NcdsEditor',
-    category: 'form',
-    description: 'froala 기반 WYSIWYG 에디터. textarea 를 in-place 변환.',
-    cdn: {
-        version: '0.0',
-        css: 'https://fe-sdk.cdn-nhncommerce.com/@ncds/editor/0.0/ncds-editor.css',
-        js: 'https://fe-sdk.cdn-nhncommerce.com/@ncds/editor/0.0/ncds-editor.js',
-    },
-    props: [
-        { name: 'heightMin', type: 'number', default: 300, description: '최소 높이 (px)' },
-        { name: 'heightMax', type: 'number', default: 600, description: '최대 높이 (px)' },
-        { name: 'heightResize', type: 'boolean', default: false, description: '높이 조정 가능 여부' },
-        { name: 'placeholderText', type: 'string', default: '내용을 입력하세요.', description: '플레이스홀더 텍스트' },
-        {
-            name: 'imageUploadCallback',
-            type: 'function',
-            description: '이미지 업로드 콜백 함수명 (전역 함수). 외부 분기에서 stripFunctionProps 로 자동 제외 — data-* 직렬화 대상 아님',
-        },
-    ],
-    cdnDefaults: {
-        heightMin: 300,
-        heightMax: 600,
-        heightResize: false,
-        placeholderText: '내용을 입력하세요.',
-    },
-    methods: [
-        'getHTML()',
-        'setHTML(html)',
-        'getText()',
-        'focus()',
-        'blur()',
-        'enable()',
-        'disable()',
-        'destroy()',
-        'insertImage(src, alt, link)',
-        'insertLink(href, text)',
-        'insertTable(rows, cols)',
-        'on(event, handler)',
-        'off(event)',
-    ],
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.editorDefinition=void 0,exports.editorDefinition={name:"editor",className:"NcdsEditor",category:"form",description:"froala 기반 WYSIWYG 에디터. textarea 를 in-place 변환.",cdn:{version:"0.0",css:"https://fe-sdk.cdn-nhncommerce.com/@ncds/editor/0.0/ncds-editor.css",js:"https://fe-sdk.cdn-nhncommerce.com/@ncds/editor/0.0/ncds-editor.js"},props:[{name:"heightMin",type:"number",default:300,description:"최소 높이 (px)"},{name:"heightMax",type:"number",default:600,description:"최대 높이 (px)"},{name:"heightResize",type:"boolean",default:!1,description:"높이 조정 가능 여부"},{name:"placeholderText",type:"string",default:"내용을 입력하세요.",description:"플레이스홀더 텍스트"},{name:"imageUploadCallback",type:"function",description:"이미지 업로드 콜백 함수명 (전역 함수). 외부 분기에서 stripFunctionProps 로 자동 제외 — data-* 직렬화 대상 아님"}],cdnDefaults:{heightMin:300,heightMax:600,heightResize:!1,placeholderText:"내용을 입력하세요."},methods:["getHTML()","setHTML(html)","getText()","focus()","blur()","enable()","disable()","destroy()","insertImage(src, alt, link)","insertLink(href, text)","insertTable(rows, cols)","on(event, handler)","off(event)"]};

package/bin/definitions/external/step-guide.js

@@ -1,52 +1 @@
-"use strict";
-/**
- * Story 6.1: step-guide 외부 분기 정의
- *
- * vanilla JS 함수 기반 step-by-step 가이드 투어(`step-guide`)의 응답 메타·CDN URL·props·cdnDefaults·methods.
- * `tools/external/step-guide.ts`의 `buildStepGuideResponse`가 본 정의를 읽어 응답 조립.
- * 5-10 editor 패턴 답습 — 단, step-guide는 함수 호출(`window.stepGuide({el, options})`) 형식.
- * (json 대신 ts — tsconfig `module: Node16` 환경에서 import 단순화. 빌드 시 자동 포함.)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stepGuideDefinition = void 0;
-exports.stepGuideDefinition = {
-    name: 'step-guide',
-    exportName: 'stepGuide', // CDN UMD default export = 함수 (소문자, class 아님)
-    category: 'overlays',
-    description: 'vanilla JS 함수 기반 step-by-step 가이드 투어. CDN 로드 후 window.stepGuide({el, options}) 호출.',
-    cdn: {
-        version: '2.0',
-        css: 'https://fe-sdk.cdn-nhncommerce.com/@ncds/step-guide/2.0/step-guide.min.css',
-        js: 'https://fe-sdk.cdn-nhncommerce.com/@ncds/step-guide/2.0/step-guide.min.js',
-    },
-    props: [
-        { name: 'steps', type: 'Step[]', required: true, description: '단계 배열' },
-        { name: 'useAnimation', type: 'boolean', default: true, description: '애니메이션 사용 여부' },
-        {
-            name: 'buttonLabel',
-            type: '{ prev, next, done, skip }',
-            description: '버튼 라벨 (v2 default: 이전/다음/완료/나중에 하기)',
-        },
-        { name: 'hideSkip', type: 'boolean', default: true, description: '스킵 버튼 숨김 여부' },
-        { name: 'hideStepCount', type: 'boolean', default: true, description: '스텝 카운트 숨김 여부' },
-        {
-            name: 'hideStepPrefix',
-            type: 'boolean',
-            default: false,
-            description: 'STEP N prefix 숨김 여부. 단계 1개일 때는 옵션과 무관하게 자동 생략',
-        },
-        {
-            name: 'exitOnOverlayClick',
-            type: 'boolean',
-            default: true,
-            description: '오버레이 클릭 시 종료 여부',
-        },
-    ],
-    cdnDefaults: {
-        useAnimation: true,
-        hideSkip: true,
-        hideStepCount: true,
-        exitOnOverlayClick: true,
-    },
-    methods: ['goToStep(index)', 'previousStep(e)', 'nextStep(e)', 'onChange(callback)', 'onExit(callback)', 'exit(e)'],
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.stepGuideDefinition=void 0,exports.stepGuideDefinition={name:"step-guide",exportName:"stepGuide",category:"overlays",description:"vanilla JS 함수 기반 step-by-step 가이드 투어. CDN 로드 후 window.stepGuide({el, options}) 호출.",cdn:{version:"2.0",css:"https://fe-sdk.cdn-nhncommerce.com/@ncds/step-guide/2.0/step-guide.min.css",js:"https://fe-sdk.cdn-nhncommerce.com/@ncds/step-guide/2.0/step-guide.min.js"},props:[{name:"steps",type:"Step[]",required:!0,description:"단계 배열"},{name:"useAnimation",type:"boolean",default:!0,description:"애니메이션 사용 여부"},{name:"buttonLabel",type:"{ prev, next, done, skip }",description:"버튼 라벨 (v2 default: 이전/다음/완료/나중에 하기)"},{name:"hideSkip",type:"boolean",default:!0,description:"스킵 버튼 숨김 여부"},{name:"hideStepCount",type:"boolean",default:!0,description:"스텝 카운트 숨김 여부"},{name:"hideStepPrefix",type:"boolean",default:!1,description:"STEP N prefix 숨김 여부. 단계 1개일 때는 옵션과 무관하게 자동 생략"},{name:"exitOnOverlayClick",type:"boolean",default:!0,description:"오버레이 클릭 시 종료 여부"}],cdnDefaults:{useAnimation:!0,hideSkip:!0,hideStepCount:!0,exitOnOverlayClick:!0},methods:["goToStep(index)","previousStep(e)","nextStep(e)","onChange(callback)","onExit(callback)","exit(e)"]};

package/bin/server.js

@@ -1,231 +1 @@
-"use strict";
-/**
- * MCP 서버 진입점 — 모든 데이터 소유, tool 등록, transport 연결
- *
- * 이 파일만 Action(부수효과)을 포함한다. tool 핸들러는 모두 Calculation.
- */
-// biome-ignore-all lint/complexity/useLiteralKeys: descriptions['key'] 형태가 tool 이름과 일관성 (Story 5.8 scope 외)
-// biome-ignore-all lint/style/noMagicNumbers: 기존 코드의 zod .max(N) 등 (Story 5.8 scope 외)
-// biome-ignore-all lint/complexity/noExcessiveCognitiveComplexity: main() 진입점 (Story 5.8 scope 외, 별도 refactor 스토리)
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const node_crypto_1 = require("node:crypto");
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const zod_1 = require("zod");
-const getComponentProps_js_1 = require("./tools/getComponentProps.js");
-const getDesignTokens_js_1 = require("./tools/getDesignTokens.js");
-const listComponents_js_1 = require("./tools/listComponents.js");
-const listCompositionOverrides_js_1 = require("./tools/listCompositionOverrides.js");
-const listIcons_js_1 = require("./tools/listIcons.js");
-const ping_js_1 = require("./tools/ping.js");
-const renderToHtml_js_1 = require("./tools/renderToHtml.js");
-const searchComponent_js_1 = require("./tools/searchComponent.js");
-const searchIcon_js_1 = require("./tools/searchIcon.js");
-const validateHtml_js_1 = require("./tools/validateHtml.js");
-const dataLoader_js_1 = require("./utils/dataLoader.js");
-const domEnvironment_js_1 = require("./utils/domEnvironment.js");
-const logger_js_1 = require("./utils/logger.js");
-const response_js_1 = require("./utils/response.js");
-const version_js_1 = require("./version.js");
-// ── definitions/ 로딩 헬퍼 (Action) ─────────────────────────────────────────
-/** tool-definitions.json을 1회 로딩하여 descriptions + capabilities를 분리 반환 */
-const loadToolDefinitions = (definitionsDir) => {
-    const raw = fs_1.default.readFileSync(path_1.default.resolve(definitionsDir, 'tool-definitions.json'), 'utf-8');
-    const data = JSON.parse(raw);
-    // JSON 구조 검증 — 타입 단언만으로 신뢰하지 않음 (§ 2.5)
-    const tools = data.tools;
-    if (!tools || typeof tools !== 'object') {
-        throw new Error('tool-definitions.json에 tools 키가 없거나 올바르지 않습니다');
-    }
-    const descriptions = {};
-    for (const [name, def] of Object.entries(tools)) {
-        if (def.description)
-            descriptions[name] = def.description;
-    }
-    const capabilities = data.capabilities;
-    if (!Array.isArray(capabilities)) {
-        throw new Error('tool-definitions.json에 capabilities 배열이 없습니다');
-    }
-    return { descriptions, capabilities };
-};
-/** rules.json을 로딩하여 flat 배열 + pingReminder 반환 */
-const loadRules = (definitionsDir) => {
-    const raw = fs_1.default.readFileSync(path_1.default.join(definitionsDir, 'rules.json'), 'utf-8');
-    const data = JSON.parse(raw);
-    const RULE_KEYS = [
-        'workflow',
-        'componentSelection',
-        'version',
-        'cdn',
-        'react',
-        'forbidden',
-        'composition',
-        'fontFamily',
-        'customArea',
-        'compliance',
-        'category',
-    ];
-    const flat = [];
-    for (const key of RULE_KEYS) {
-        const arr = data[key];
-        if (!Array.isArray(arr)) {
-            throw new Error(`rules.json에 ${key} 배열이 없습니다`);
-        }
-        flat.push(...arr);
-    }
-    const pingReminder = typeof data.pingReminder === 'string' ? data.pingReminder : '';
-    return { flat, pingReminder };
-};
-// ── 진입점 ───────────────────────────────────────────────────────────────────
-const main = async () => {
-    const definitionsDir = path_1.default.resolve(__dirname, 'definitions');
-    // ── definitions/ 로딩 (main() 안에서 실행하여 catch에 포함) ──
-    const { descriptions, capabilities } = loadToolDefinitions(definitionsDir);
-    const { flat: rules, pingReminder } = loadRules(definitionsDir);
-    const instructions = (0, dataLoader_js_1.loadInstructions)(definitionsDir);
-    const complianceRules = (0, dataLoader_js_1.loadComplianceRules)(definitionsDir);
-    const jsApiMap = (0, dataLoader_js_1.loadJsApi)(definitionsDir);
-    // ── DOM + React 런타임 초기화 — 번들 로드 전에 실행해야 unifyModuleResolution 이 적용됨 ──
-    // setupDomEnvironment()가 Module._resolveFilename 을 override 하여 react / @ncds/ui-admin-icon 경로를
-    // MCP 기준으로 pin 한다. 번들 로드 이후에 실행하면 번들 내 require() 가 pin 이전 경로로 캐시되어
-    // React 인스턴스 불일치($$typeof Symbol mismatch) 가 발생한다.
-    const reactRuntime = (0, domEnvironment_js_1.setupDomEnvironment)();
-    logger_js_1.logger.info('DOM + React 런타임 초기화 완료');
-    // ── 데이터 로딩 ──
-    const { map: componentMap, compositionOverrides } = (0, dataLoader_js_1.loadComponentsFromDir)(dataLoader_js_1.DEFAULT_DATA_DIR);
-    const { cdn: cdnMeta, icon: iconMeta } = (0, dataLoader_js_1.loadMeta)(dataLoader_js_1.DEFAULT_DATA_DIR);
-    const iconData = (0, dataLoader_js_1.loadIconData)(dataLoader_js_1.DEFAULT_DATA_DIR);
-    const tokenData = (0, dataLoader_js_1.loadTokenData)(dataLoader_js_1.DEFAULT_DATA_DIR);
-    const bundlePath = path_1.default.resolve(__dirname, '..', 'bin', 'components.bundle.js');
-    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
-    const bundle = require(bundlePath);
-    logger_js_1.logger.info('컴포넌트 번들 로딩 완료');
-    // 아이콘 번들 로딩 — renderToHtml에서 아이콘 이름 문자열을 실제 React 컴포넌트로 resolve
-    let iconBundle = {};
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
-        iconBundle = require('@ncds/ui-admin-icon');
-        logger_js_1.logger.info('아이콘 번들 로딩 완료');
-    }
-    catch {
-        logger_js_1.logger.warn('아이콘 번들 로딩 실패 — 아이콘 resolve 비활성화');
-    }
-    // ── 파생 데이터 사전 계산 (code-guide § 5.1 반복 계산 제거) ──
-    const rootClassMap = (0, validateHtml_js_1.buildRootClassMap)(componentMap);
-    const tokenValueMap = (0, validateHtml_js_1.buildTokenValueMap)(tokenData);
-    const groupedComponents = (0, listComponents_js_1.buildGroupedComponents)(componentMap);
-    const iconSummary = (0, listIcons_js_1.buildIconSummary)(iconData);
-    const listComponentsResponse = (0, listComponents_js_1.buildListComponentsResponse)(groupedComponents);
-    const listIconsResponse = (0, listIcons_js_1.buildListIconsResponse)(iconSummary);
-    const listCompositionOverridesResponse = (0, listCompositionOverrides_js_1.buildListCompositionOverridesResponse)(compositionOverrides, componentMap);
-    // ── MCP 서버 생성 + tool 등록 ──
-    const server = new mcp_js_1.McpServer({ name: 'ncds-ui-admin', version: version_js_1.VERSION }, { instructions });
-    // ping 호출 추적 — 미호출 시 다른 tool 응답에 핵심 rules 주입 (세션 레벨 상태, let 의도적 사용)
-    let pinged = false;
-    const withPingReminder = (response) => {
-        if (pinged || !pingReminder)
-            return response;
-        return (0, response_js_1.appendPingReminder)(response, pingReminder);
-    };
-    server.registerTool('ping', { description: descriptions['ping'] }, () => {
-        pinged = true;
-        return (0, ping_js_1.ping)({ componentMap, cdnMeta, iconMeta, version: version_js_1.VERSION, rules, capabilities });
-    });
-    server.registerTool('list_icons', { description: descriptions['list_icons'] }, () => withPingReminder((0, listIcons_js_1.listIcons)(listIconsResponse)));
-    server.registerTool('search_icon', {
-        description: descriptions['search_icon'],
-        inputSchema: { query: zod_1.z.string().describe('Search keyword (e.g. "search", "alert", "arrow")') },
-    }, ({ query }) => withPingReminder((0, searchIcon_js_1.searchIcon)(iconData, query)));
-    server.registerTool('list_components', { description: descriptions['list_components'] }, () => withPingReminder((0, listComponents_js_1.listComponents)(listComponentsResponse)));
-    server.registerTool('list_composition_overrides', { description: descriptions['list_composition_overrides'] }, () => withPingReminder((0, listCompositionOverrides_js_1.listCompositionOverrides)(listCompositionOverridesResponse)));
-    server.registerTool('search_component', {
-        description: descriptions['search_component'],
-        inputSchema: { query: zod_1.z.string().describe('Search keyword (Korean/English, case-insensitive)') },
-    }, ({ query }) => withPingReminder((0, searchComponent_js_1.searchComponent)(componentMap, query)));
-    server.registerTool('get_component_props', {
-        description: descriptions['get_component_props'],
-        inputSchema: { name: zod_1.z.string().min(1).describe('Component name (e.g. "button", "password-input")') },
-    }, ({ name }) => withPingReminder((0, getComponentProps_js_1.getComponentProps)(componentMap, name)));
-    server.registerTool('validate_html', {
-        description: descriptions['validate_html'],
-        inputSchema: {
-            html: zod_1.z
-                .string()
-                .min(1)
-                .describe('HTML markup to validate (e.g. \'<button class="ncua-btn ncua-btn--primary"></button>\')'),
-        },
-    }, ({ html }) => withPingReminder((0, validateHtml_js_1.validateHtml)({ componentMap, rootClassMap, html, cdnMeta, tokenData, complianceRules, tokenValueMap })));
-    server.registerTool('render_to_html', {
-        description: descriptions['render_to_html'],
-        inputSchema: {
-            name: zod_1.z.string().min(1).describe('Component name (e.g. "button", "modal", "password-input")'),
-            props: zod_1.z
-                .record(zod_1.z.string(), zod_1.z.unknown())
-                .optional()
-                .describe('Component props (e.g. { label: "OK", hierarchy: "primary" })'),
-        },
-    }, ({ name, props }) => withPingReminder((0, renderToHtml_js_1.renderToHtml)({
-        componentMap,
-        bundle,
-        iconBundle,
-        cdnMeta,
-        iconMeta,
-        reactRuntime,
-        jsApiMap,
-        name,
-        props: props,
-        instanceId: (0, node_crypto_1.randomUUID)().slice(0, 6),
-    })));
-    server.registerTool('render_to_html_batch', {
-        description: descriptions['render_to_html_batch'],
-        inputSchema: {
-            components: zod_1.z
-                .array(zod_1.z.object({
-                name: zod_1.z.string().min(1).describe('Component name'),
-                props: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional().describe('Component props'),
-            }))
-                .min(1)
-                .max(30)
-                .describe('Array of components to render (max 30)'),
-        },
-    }, ({ components }) => {
-        const results = components.map(({ name, props }) => (0, renderToHtml_js_1.renderToHtml)({
-            componentMap,
-            bundle,
-            iconBundle,
-            cdnMeta,
-            iconMeta,
-            reactRuntime,
-            jsApiMap,
-            name,
-            props: props,
-            instanceId: (0, node_crypto_1.randomUUID)().slice(0, 6),
-        }));
-        const parsed = results.map((r) => {
-            const text = r.content[0].text;
-            return r.isError ? { error: JSON.parse(text) } : JSON.parse(text);
-        });
-        return withPingReminder((0, response_js_1.successResponse)(parsed));
-    });
-    server.registerTool('get_design_tokens', {
-        description: descriptions['get_design_tokens'],
-        inputSchema: {
-            category: zod_1.z
-                .string()
-                .optional()
-                .describe('Token category filter (e.g. "color", "typography", "shadow", "spacing"). Omit to get all tokens.'),
-        },
-    }, ({ category }) => withPingReminder((0, getDesignTokens_js_1.getDesignTokens)({ tokenData, category })));
-    const transport = new stdio_js_1.StdioServerTransport();
-    await server.connect(transport);
-    logger_js_1.logger.info(`NCUA MCP 서버 시작됨 (ncds-ui-admin v${version_js_1.VERSION})`);
-};
-main().catch((err) => {
-    process.stderr.write(`[ERROR] 서버 시작 실패: ${err instanceof Error ? err.message : String(err)}\n`);
-    process.exit(1);
-});
+"use strict";var e=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const o=require("node:crypto"),n=require("@modelcontextprotocol/sdk/server/mcp.js"),r=require("@modelcontextprotocol/sdk/server/stdio.js"),t=e(require("fs")),i=e(require("path")),s=require("zod"),a=require("./tools/getComponentProps.js"),c=require("./tools/getDesignTokens.js"),p=require("./tools/listComponents.js"),l=require("./tools/listCompositionOverrides.js"),d=require("./tools/listIcons.js"),m=require("./tools/ping.js"),u=require("./tools/renderToHtml.js"),g=require("./tools/searchComponent.js"),_=require("./tools/searchIcon.js"),h=require("./tools/validateHtml.js"),b=require("./utils/dataLoader.js"),f=require("./utils/domEnvironment.js"),y=require("./utils/logger.js"),j=require("./utils/response.js"),v=require("./version.js"),T=e=>{const o=t.default.readFileSync(i.default.resolve(e,"tool-definitions.json"),"utf-8"),n=JSON.parse(o),r=n.tools;if(!r||"object"!=typeof r)throw new Error("tool-definitions.json에 tools 키가 없거나 올바르지 않습니다");const s={};for(const[e,o]of Object.entries(r))o.description&&(s[e]=o.description);const a=n.capabilities;if(!Array.isArray(a))throw new Error("tool-definitions.json에 capabilities 배열이 없습니다");return{descriptions:s,capabilities:a}},q=e=>{const o=t.default.readFileSync(i.default.join(e,"rules.json"),"utf-8"),n=JSON.parse(o),r=["workflow","componentSelection","version","cdn","react","forbidden","composition","fontFamily","customArea","compliance","category"],s=[];for(const e of r){const o=n[e];if(!Array.isArray(o))throw new Error(`rules.json에 ${e} 배열이 없습니다`);s.push(...o)}return{flat:s,pingReminder:"string"==typeof n.pingReminder?n.pingReminder:""}},R=async()=>{const e=i.default.resolve(__dirname,"definitions"),{descriptions:t,capabilities:R}=T(e),{flat:D,pingReminder:M}=q(e),S=(0,b.loadInstructions)(e),A=(0,b.loadComplianceRules)(e),C=(0,b.loadJsApi)(e),w=(0,f.setupDomEnvironment)();y.logger.info("DOM + React 런타임 초기화 완료");const{map:k,compositionOverrides:I}=(0,b.loadComponentsFromDir)(b.DEFAULT_DATA_DIR),{cdn:O,icon:z}=(0,b.loadMeta)(b.DEFAULT_DATA_DIR),E=(0,b.loadIconData)(b.DEFAULT_DATA_DIR),L=(0,b.loadTokenData)(b.DEFAULT_DATA_DIR),U=i.default.resolve(__dirname,"..","bin","components.bundle.js"),F=require(U);y.logger.info("컴포넌트 번들 로딩 완료");let N={};try{N=require("@ncds/ui-admin-icon"),y.logger.info("아이콘 번들 로딩 완료")}catch{y.logger.warn("아이콘 번들 로딩 실패 — 아이콘 resolve 비활성화")}const x=(0,h.buildRootClassMap)(k),H=(0,h.buildTokenValueMap)(L),J=(0,p.buildGroupedComponents)(k),P=(0,d.buildIconSummary)(E),V=(0,p.buildListComponentsResponse)(J),$=(0,d.buildListIconsResponse)(P),B=(0,l.buildListCompositionOverridesResponse)(I,k),K=new n.McpServer({name:"ncds-ui-admin",version:v.VERSION},{instructions:S});let G=!1;const Q=e=>G||!M?e:(0,j.appendPingReminder)(e,M);K.registerTool("ping",{description:t.ping},()=>(G=!0,(0,m.ping)({componentMap:k,cdnMeta:O,iconMeta:z,version:v.VERSION,rules:D,capabilities:R}))),K.registerTool("list_icons",{description:t.list_icons},()=>Q((0,d.listIcons)($))),K.registerTool("search_icon",{description:t.search_icon,inputSchema:{query:s.z.string().describe('Search keyword (e.g. "search", "alert", "arrow")')}},({query:e})=>Q((0,_.searchIcon)(E,e))),K.registerTool("list_components",{description:t.list_components},()=>Q((0,p.listComponents)(V))),K.registerTool("list_composition_overrides",{description:t.list_composition_overrides},()=>Q((0,l.listCompositionOverrides)(B))),K.registerTool("search_component",{description:t.search_component,inputSchema:{query:s.z.string().describe("Search keyword (Korean/English, case-insensitive)")}},({query:e})=>Q((0,g.searchComponent)(k,e))),K.registerTool("get_component_props",{description:t.get_component_props,inputSchema:{name:s.z.string().min(1).describe('Component name (e.g. "button", "password-input")')}},({name:e})=>Q((0,a.getComponentProps)(k,e))),K.registerTool("validate_html",{description:t.validate_html,inputSchema:{html:s.z.string().min(1).describe("HTML markup to validate (e.g. '<button class=\"ncua-btn ncua-btn--primary\"></button>')")}},({html:e})=>Q((0,h.validateHtml)({componentMap:k,rootClassMap:x,html:e,cdnMeta:O,tokenData:L,complianceRules:A,tokenValueMap:H}))),K.registerTool("render_to_html",{description:t.render_to_html,inputSchema:{name:s.z.string().min(1).describe('Component name (e.g. "button", "modal", "password-input")'),props:s.z.record(s.z.string(),s.z.unknown()).optional().describe('Component props (e.g. { label: "OK", hierarchy: "primary" })')}},({name:e,props:n})=>Q((0,u.renderToHtml)({componentMap:k,bundle:F,iconBundle:N,cdnMeta:O,iconMeta:z,reactRuntime:w,jsApiMap:C,name:e,props:n,instanceId:(0,o.randomUUID)().slice(0,6)}))),K.registerTool("render_to_html_batch",{description:t.render_to_html_batch,inputSchema:{components:s.z.array(s.z.object({name:s.z.string().min(1).describe("Component name"),props:s.z.record(s.z.string(),s.z.unknown()).optional().describe("Component props")})).min(1).max(30).describe("Array of components to render (max 30)")}},({components:e})=>{const n=e.map(({name:e,props:n})=>(0,u.renderToHtml)({componentMap:k,bundle:F,iconBundle:N,cdnMeta:O,iconMeta:z,reactRuntime:w,jsApiMap:C,name:e,props:n,instanceId:(0,o.randomUUID)().slice(0,6)})).map(e=>{const o=e.content[0].text;return e.isError?{error:JSON.parse(o)}:JSON.parse(o)});return Q((0,j.successResponse)(n))}),K.registerTool("get_design_tokens",{description:t.get_design_tokens,inputSchema:{category:s.z.string().optional().describe('Token category filter (e.g. "color", "typography", "shadow", "spacing"). Omit to get all tokens.')}},({category:e})=>Q((0,c.getDesignTokens)({tokenData:L,category:e})));const W=new r.StdioServerTransport;await K.connect(W),y.logger.info(`NCUA MCP 서버 시작됨 (ncds-ui-admin v${v.VERSION})`)};R().catch(e=>{process.stderr.write(`[ERROR] 서버 시작 실패: ${e instanceof Error?e.message:String(e)}\n`),process.exit(1)});

package/bin/tools/external/editor.js

@@ -1,88 +1 @@
-"use strict";
-/**
- * Story 5.10: editor 외부 분기 모듈
- *
- * froala 기반 에디터(`@ncds/editor-html`)는 ui-admin 외부 패키지라
- * ui-admin 흐름(componentMap / data/{name}.json / cdnAssets) 을 거치지 않고
- * 본 모듈에서 응답을 직접 조립한다. ui-admin 코드 미수정 → 5-8/5-9 회귀 위험 0.
- *
- * 호출 진입점: `renderToHtml` 함수 시작부 (Task 1 결정).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isEditorAlias = exports.buildEditorResponse = void 0;
-const editor_js_1 = require("../../definitions/external/editor.js");
-const response_js_1 = require("../../utils/response.js");
-const renderToHtml_js_1 = require("../renderToHtml.js");
-/** editor 컴포넌트로 매칭할 alias 집합 (Task 1 결정 — 보수적 5개) */
-const EDITOR_ALIASES = new Set(['editor', 'ncds-editor', 'ncdseditor', 'ncuaeditor', 'editor-html']);
-/** `normalizeName` 적용된 컴포넌트 이름이 editor alias 인지 검사 */
-const isEditorAlias = (normalizedName) => EDITOR_ALIASES.has(normalizedName);
-exports.isEditorAlias = isEditorAlias;
-/** camelCase → kebab-case (heightMin → height-min) */
-const camelToKebab = (s) => s.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
-/** HTML attribute 값 escape (` " ` / ` & ` / ` < ` / ` > `) */
-const escapeHtmlAttr = (s) => s.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-/**
- * options → data-* 속성 직렬화.
- * - camelCase → kebab-case
- * - 값 String(v) (boolean → "true"/"false", number → 숫자 문자열)
- * - null / undefined / function skip (함수는 stripFunctionProps 로 사전 제거되지만 방어적 추가 필터)
- */
-const serializeDataAttributes = (options) => Object.entries(options)
-    .filter(([, v]) => v !== null && v !== undefined && typeof v !== 'function')
-    .map(([k, v]) => `data-${camelToKebab(k)}="${escapeHtmlAttr(String(v))}"`)
-    .join(' ');
-/**
- * patternD: textarea + data-* + element-only init script.
- * 5-8 의 buildPatternA/B/C 와 동일 시그니처 `(id, className, options) => string`.
- * patternA/B/C 와 차이:
- *   - 컨테이너: `<div>` → `<textarea>` (froala 가 textarea 를 in-place 변환)
- *   - options 위치: `new X(wrapper, options)` 두번째 인자 → textarea 의 `data-*` 속성
- *   - 글로벌: `ncua.X` → `window.NcdsEditor`
- *   - 호출 위치: ui-admin 의 `PATTERN_BY_COMPONENT` 분기 → 외부 분기 모듈 안 (이 함수)
- */
-const buildPatternD = (id, className, options) => {
-    const dataAttrs = serializeDataAttributes(options);
-    const tagBody = dataAttrs ? `id="${id}" ${dataAttrs}` : `id="${id}"`;
-    return [
-        `<textarea ${tagBody}></textarea>`,
-        '<script>',
-        "  document.addEventListener('DOMContentLoaded', function () {",
-        `    new window.${className}(document.querySelector('#${id}'));`,
-        '  });',
-        '</script>',
-    ].join('\n');
-};
-/**
- * editor 응답 조립 — ui-admin 흐름 우회.
- * 5-9 helper(`mergeCdnDefaults` / `stripFunctionProps`) import 재사용 (코드 중복 0).
- */
-const buildEditorResponse = (props, instanceId) => {
-    // 5-9: 함수 prop 사전 제거 + cdnDefaults deep merge (사용자 props 우선)
-    const cleanedProps = (0, renderToHtml_js_1.stripFunctionProps)(props);
-    const { merged, defaultsApplied } = (0, renderToHtml_js_1.mergeCdnDefaults)('editor', editor_js_1.editorDefinition.cdnDefaults, cleanedProps);
-    const id = `ed-${instanceId}`;
-    const html = buildPatternD(id, editor_js_1.editorDefinition.className, merged);
-    // cdnDefaults 적용된 키 → defaultsUsed 응답
-    const defaultsUsed = Object.fromEntries(defaultsApplied.map((key) => [key, editor_js_1.editorDefinition.cdnDefaults[key]]));
-    return (0, response_js_1.successResponse)({
-        html,
-        component: editor_js_1.editorDefinition.name,
-        exportName: editor_js_1.editorDefinition.className,
-        importPath: '@ncds/editor-html',
-        appliedProps: merged,
-        ...(Object.keys(defaultsUsed).length > 0 && { defaultsUsed }),
-        js: {
-            required: true,
-            description: '이 컴포넌트는 인터랙션을 위해 CDN JS가 필요합니다',
-            api: {
-                className: editor_js_1.editorDefinition.className,
-                methods: editor_js_1.editorDefinition.methods,
-            },
-        },
-        cdn: editor_js_1.editorDefinition.cdn,
-        dataVersion: { '@ncds/editor': editor_js_1.editorDefinition.cdn.version },
-        react: { notes: 'React not supported in editor (vanilla JS only)' },
-    });
-};
-exports.buildEditorResponse = buildEditorResponse;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.isEditorAlias=exports.buildEditorResponse=void 0;const e=require("../../definitions/external/editor.js"),t=require("../../utils/response.js"),i=require("../renderToHtml.js"),o=new Set(["editor","ncds-editor","ncdseditor","ncuaeditor","editor-html"]),n=e=>o.has(e);exports.isEditorAlias=n;const r=e=>e.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`),s=e=>e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;"),d=e=>Object.entries(e).filter(([,e])=>null!=e&&"function"!=typeof e).map(([e,t])=>`data-${r(e)}="${s(String(t))}"`).join(" "),a=(e,t,i)=>{const o=d(i);return[`<textarea ${o?`id="${e}" ${o}`:`id="${e}"`}></textarea>`,"<script>","  document.addEventListener('DOMContentLoaded', function () {",`    new window.${t}(document.querySelector('#${e}'));`,"  });","<\/script>"].join("\n")},c=(o,n)=>{const r=(0,i.stripFunctionProps)(o),{merged:s,defaultsApplied:d}=(0,i.mergeCdnDefaults)("editor",e.editorDefinition.cdnDefaults,r),c=a(`ed-${n}`,e.editorDefinition.className,s),l=Object.fromEntries(d.map(t=>[t,e.editorDefinition.cdnDefaults[t]]));return(0,t.successResponse)({html:c,component:e.editorDefinition.name,exportName:e.editorDefinition.className,importPath:"@ncds/editor-html",appliedProps:s,...Object.keys(l).length>0&&{defaultsUsed:l},js:{required:!0,description:"이 컴포넌트는 인터랙션을 위해 CDN JS가 필요합니다",api:{className:e.editorDefinition.className,methods:e.editorDefinition.methods}},cdn:e.editorDefinition.cdn,dataVersion:{"@ncds/editor":e.editorDefinition.cdn.version},react:{notes:"React not supported in editor (vanilla JS only)"}})};exports.buildEditorResponse=c;

package/bin/tools/external/step-guide.js

@@ -1,79 +1 @@
-"use strict";
-/**
- * Story 6.1: step-guide 외부 분기 모듈
- *
- * vanilla JS 함수 기반 가이드 투어(`step-guide`)는 ui-admin 외부 패키지이며
- * 5-10 editor와 동일 패턴으로 ui-admin 흐름을 우회하고 본 모듈에서 응답을 직접 조립한다.
- * 핵심 차이 — step-guide는 함수 호출(`window.stepGuide({el, options})`) 형식이라
- * 5-10 patternD(생성자 호출 `new window.NcdsEditor(querySelector)`)와 다른 init 스니펫 패턴 신설.
- *
- * 호출 진입점: `renderToHtml` 함수 시작부 (editor 분기 다음).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isStepGuideAlias = exports.buildStepGuideResponse = void 0;
-const step_guide_js_1 = require("../../definitions/external/step-guide.js");
-const response_js_1 = require("../../utils/response.js");
-const renderToHtml_js_1 = require("../renderToHtml.js");
-/** step-guide 컴포넌트로 매칭할 alias 집합 (render_to_html 진입점용, 보수적 4 영문) */
-const STEP_GUIDE_ALIASES = new Set(['step-guide', 'stepguide', 'ncdsstepguide', 'step_guide']);
-/** `normalizeName` 적용된 컴포넌트 이름이 step-guide alias 인지 검사 */
-const isStepGuideAlias = (normalizedName) => STEP_GUIDE_ALIASES.has(normalizedName);
-exports.isStepGuideAlias = isStepGuideAlias;
-/**
- * init 스니펫 — 함수 호출 형식.
- * 5-10 patternD(생성자 호출 `new window.NcdsEditor(querySelector)`)와 다른 새 패턴.
- *   - 컨테이너 div 없음 — step-guide는 document.body 에 overlay를 그리는 도구라 격리 div 의미 없음
- *   - `el: document.body` — step-guide의 _fetchSteps 가 _targetElement 안에서만 step.element selector를 검색하므로
- *     사용자가 step.element에 외부 카드 selector를 명시할 수 있도록 document.body를 target으로 지정
- *   - 함수 호출: `window.stepGuide({ el: document.body, options: ... })`
- *   - JSON.stringify로 options 직렬화 (data-* 미사용)
- */
-const buildInitSnippet = (options) => {
-    const optionsJson = JSON.stringify(options);
-    return [
-        '<script>',
-        "  document.addEventListener('DOMContentLoaded', function () {",
-        `    window.stepGuide({ el: document.body, options: ${optionsJson} });`,
-        '  });',
-        '</script>',
-    ].join('\n');
-};
-/**
- * step-guide 응답 조립 — ui-admin 흐름 우회.
- * 5-9 helper(`mergeCdnDefaults` / `stripFunctionProps`) import 재사용 (코드 중복 0).
- */
-const buildStepGuideResponse = (props, _instanceId // 격리 div 제거로 인해 unused — 외부 분기 시그니처 일관성 위해 인자는 유지
-) => {
-    // 5-9: 함수 prop 사전 제거 + cdnDefaults deep merge (사용자 props 우선)
-    const cleanedProps = (0, renderToHtml_js_1.stripFunctionProps)(props);
-    const { merged, defaultsApplied } = (0, renderToHtml_js_1.mergeCdnDefaults)('step-guide', step_guide_js_1.stepGuideDefinition.cdnDefaults, cleanedProps);
-    const html = buildInitSnippet(merged);
-    // cdnDefaults 적용된 키 → defaultsUsed 응답
-    const defaultsUsed = Object.fromEntries(defaultsApplied.map((key) => [
-        key,
-        step_guide_js_1.stepGuideDefinition.cdnDefaults[key],
-    ]));
-    return (0, response_js_1.successResponse)({
-        html,
-        component: step_guide_js_1.stepGuideDefinition.name,
-        exportName: step_guide_js_1.stepGuideDefinition.exportName,
-        importPath: 'step-guide',
-        appliedProps: merged,
-        ...(Object.keys(defaultsUsed).length > 0 && { defaultsUsed }),
-        js: {
-            required: true,
-            description: '이 컴포넌트는 인터랙션을 위해 CDN JS가 필요합니다',
-            api: {
-                exportName: step_guide_js_1.stepGuideDefinition.exportName,
-                methods: step_guide_js_1.stepGuideDefinition.methods,
-            },
-        },
-        cdn: step_guide_js_1.stepGuideDefinition.cdn,
-        dataVersion: { '@ncds/step-guide': step_guide_js_1.stepGuideDefinition.cdn.version },
-        react: {
-            notes: 'React 환경: useEffect 내 window.stepGuide({el, options}) 호출 + cleanup에서 instance.exit() 호출. ' +
-                'StrictMode 이중 마운트 회피 — cleanup 멱등성 보장 필요 (exit()가 이미 호출된 후 다시 호출되어도 안전).',
-        },
-    });
-};
-exports.buildStepGuideResponse = buildStepGuideResponse;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.isStepGuideAlias=exports.buildStepGuideResponse=void 0;const e=require("../../definitions/external/step-guide.js"),t=require("../../utils/response.js"),i=require("../renderToHtml.js"),s=new Set(["step-guide","stepguide","ncdsstepguide","step_guide"]),n=e=>s.has(e);exports.isStepGuideAlias=n;const d=e=>["<script>","  document.addEventListener('DOMContentLoaded', function () {",`    window.stepGuide({ el: document.body, options: ${JSON.stringify(e)} });`,"  });","<\/script>"].join("\n"),o=(s,n)=>{const o=(0,i.stripFunctionProps)(s),{merged:p,defaultsApplied:u}=(0,i.mergeCdnDefaults)("step-guide",e.stepGuideDefinition.cdnDefaults,o),r=d(p),c=Object.fromEntries(u.map(t=>[t,e.stepGuideDefinition.cdnDefaults[t]]));return(0,t.successResponse)({html:r,component:e.stepGuideDefinition.name,exportName:e.stepGuideDefinition.exportName,importPath:"step-guide",appliedProps:p,...Object.keys(c).length>0&&{defaultsUsed:c},js:{required:!0,description:"이 컴포넌트는 인터랙션을 위해 CDN JS가 필요합니다",api:{exportName:e.stepGuideDefinition.exportName,methods:e.stepGuideDefinition.methods}},cdn:e.stepGuideDefinition.cdn,dataVersion:{"@ncds/step-guide":e.stepGuideDefinition.cdn.version},react:{notes:"React 환경: useEffect 내 window.stepGuide({el, options}) 호출 + cleanup에서 instance.exit() 호출. StrictMode 이중 마운트 회피 — cleanup 멱등성 보장 필요 (exit()가 이미 호출된 후 다시 호출되어도 안전)."}})};exports.buildStepGuideResponse=o;

package/bin/tools/getComponentProps.js

@@ -1,26 +1 @@
-"use strict";
-/**
- * get_component_props tool — 컴포넌트 props 스펙 반환 (순수 함수)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getComponentProps = void 0;
-const dataLoader_js_1 = require("../utils/dataLoader.js");
-const response_js_1 = require("../utils/response.js");
-/** get_component_props tool — 컴포넌트의 props 스펙을 JSON으로 반환 */
-const getComponentProps = (componentMap, name) => {
-    const normalized = (0, response_js_1.normalizeName)(name);
-    const component = (0, dataLoader_js_1.getComponent)(componentMap, normalized);
-    if (!component)
-        return (0, response_js_1.componentNotFoundResponse)(normalized);
-    return (0, response_js_1.successResponse)({
-        props: component.props,
-        ...(component.subComponents && { subComponents: component.subComponents }),
-        ...(component.usageExamples && { usageExamples: component.usageExamples }),
-        // P8: composition overrides 에서 병합되는 필드들 — AI 가 부모-자식 관계와 권장 조합을 우선 학습
-        ...(component.allowedChildren && { allowedChildren: component.allowedChildren }),
-        ...(component.allowedParents && { allowedParents: component.allowedParents }),
-        ...(component.canonicalExample && { canonicalExample: component.canonicalExample }),
-        ...(component.canonicalExamples && { canonicalExamples: component.canonicalExamples }),
-    });
-};
-exports.getComponentProps = getComponentProps;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.getComponentProps=void 0;const e=require("../utils/dataLoader.js"),o=require("../utils/response.js"),s=(s,n)=>{const a=(0,o.normalizeName)(n),l=(0,e.getComponent)(s,a);return l?(0,o.successResponse)({props:l.props,...l.subComponents&&{subComponents:l.subComponents},...l.usageExamples&&{usageExamples:l.usageExamples},...l.allowedChildren&&{allowedChildren:l.allowedChildren},...l.allowedParents&&{allowedParents:l.allowedParents},...l.canonicalExample&&{canonicalExample:l.canonicalExample},...l.canonicalExamples&&{canonicalExamples:l.canonicalExamples}}):(0,o.componentNotFoundResponse)(a)};exports.getComponentProps=s;

package/bin/tools/getDesignTokens.js

@@ -1,20 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDesignTokens = void 0;
-const response_js_1 = require("../utils/response.js");
-const getDesignTokens = ({ tokenData, category }) => {
-    if (!category) {
-        return (0, response_js_1.successResponse)(tokenData);
-    }
-    if (!tokenData.categories.includes(category)) {
-        return (0, response_js_1.errorResponse)('INVALID_TOKEN_CATEGORY', `Category '${category}' not found. Available: ${tokenData.categories.join(', ')}`, 'Use get_design_tokens without category to see all available categories and tokens.');
-    }
-    const filteredGroups = tokenData.groups.filter((group) => group.category === category);
-    const filteredCount = filteredGroups.reduce((sum, group) => sum + group.tokens.length, 0);
-    return (0, response_js_1.successResponse)({
-        totalCount: filteredCount,
-        categories: [category],
-        groups: filteredGroups,
-    });
-};
-exports.getDesignTokens = getDesignTokens;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.getDesignTokens=void 0;const e=require("../utils/response.js"),s=({tokenData:s,category:t})=>{if(!t)return(0,e.successResponse)(s);if(!s.categories.includes(t))return(0,e.errorResponse)("INVALID_TOKEN_CATEGORY",`Category '${t}' not found. Available: ${s.categories.join(", ")}`,"Use get_design_tokens without category to see all available categories and tokens.");const o=s.groups.filter(e=>e.category===t),r=o.reduce((e,s)=>e+s.tokens.length,0);return(0,e.successResponse)({totalCount:r,categories:[t],groups:o})};exports.getDesignTokens=s;

package/bin/tools/listComponents.js

@@ -1,24 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listComponents = exports.buildListComponentsResponse = exports.buildGroupedComponents = void 0;
-const response_js_1 = require("../utils/response.js");
-/** componentMap에서 카테고리별 그룹을 사전 계산 — server.ts에서 1회 호출 */
-const buildGroupedComponents = (componentMap) => {
-    const sorted = [...componentMap.values()]
-        .map((c) => ({ name: c.name, category: c.category, description: c.description }))
-        .sort((a, b) => a.category.localeCompare(b.category) || a.name.localeCompare(b.name));
-    const grouped = {};
-    for (const c of sorted) {
-        if (!grouped[c.category])
-            grouped[c.category] = [];
-        grouped[c.category].push({ name: c.name, description: c.description });
-    }
-    return grouped;
-};
-exports.buildGroupedComponents = buildGroupedComponents;
-/** GroupedComponents를 사전 직렬화 — server.ts에서 1회 호출 */
-const buildListComponentsResponse = (grouped) => (0, response_js_1.successResponse)(grouped);
-exports.buildListComponentsResponse = buildListComponentsResponse;
-/** list_components tool — 사전 직렬화된 응답을 그대로 반환 */
-const listComponents = (prebuilt) => prebuilt;
-exports.listComponents = listComponents;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.listComponents=exports.buildListComponentsResponse=exports.buildGroupedComponents=void 0;const e=require("../utils/response.js"),o=e=>{const o=[...e.values()].map(e=>({name:e.name,category:e.category,description:e.description})).sort((e,o)=>e.category.localeCompare(o.category)||e.name.localeCompare(o.name)),s={};for(const e of o)s[e.category]||(s[e.category]=[]),s[e.category].push({name:e.name,description:e.description});return s};exports.buildGroupedComponents=o;const s=o=>(0,e.successResponse)(o);exports.buildListComponentsResponse=s;const t=e=>e;exports.listComponents=t;