@tekton-ui/mcp-server 0.3.0

package/dist/data/template-matcher.js

@@ -0,0 +1,240 @@
+/**
+ * Template Matcher Module
+ * SPEC-MCP-004 Phase 3: Blueprint Generator Enhancement
+ *
+ * 자연어 설명에서 최적의 Screen Template을 매칭합니다.
+ */
+import { templateRegistry } from '@tekton-ui/ui';
+/**
+ * 키워드-템플릿 매핑 정의
+ * 각 템플릿 ID에 대해 관련 키워드를 정의
+ */
+const KEYWORD_TEMPLATE_MAP = {
+    // Auth Templates
+    'auth.login': [
+        'login',
+        'sign in',
+        'signin',
+        'log in',
+        '로그인',
+        'authentication',
+        'auth page',
+        'user login',
+        'member login',
+        'ログイン',
+        '登录',
+    ],
+    'auth.signup': [
+        'signup',
+        'sign up',
+        'register',
+        'registration',
+        'create account',
+        '회원가입',
+        'new user',
+        'join',
+        'サインアップ',
+        '注册',
+    ],
+    'auth.forgot-password': [
+        'forgot password',
+        'reset password',
+        'password recovery',
+        '비밀번호 찾기',
+        'recover account',
+        'パスワードリセット',
+        '忘记密码',
+    ],
+    'auth.verification': [
+        'verification',
+        'verify',
+        'confirm email',
+        'otp',
+        '인증',
+        'code verification',
+        '認証',
+        '验证',
+    ],
+    // Dashboard Templates
+    'dashboard.overview': [
+        'dashboard',
+        'analytics',
+        'metrics',
+        'stats',
+        'statistics',
+        '대시보드',
+        'admin panel',
+        'overview',
+        'kpi',
+        'ダッシュボード',
+        '仪表板',
+    ],
+    // Core Templates
+    'core.landing': [
+        'landing',
+        'landing page',
+        'home',
+        'homepage',
+        '랜딩',
+        'hero',
+        'marketing page',
+        'ランディング',
+        '首页',
+    ],
+    'core.profile': [
+        'profile',
+        'user profile',
+        'my page',
+        '프로필',
+        'account',
+        'my account',
+        'プロフィール',
+        '个人资料',
+    ],
+    'core.preferences': [
+        'settings',
+        'preferences',
+        'configuration',
+        '설정',
+        'options',
+        'config',
+        '設定',
+        '设置',
+    ],
+    // Feedback Templates
+    'feedback.loading': ['loading', 'spinner', 'wait', '로딩', 'progress', 'ローディング', '加载中'],
+    'feedback.error': ['error', '404', '500', 'not found', '오류', 'error page', 'エラー', '错误'],
+    'feedback.empty': [
+        'empty',
+        'no data',
+        'no results',
+        '빈 화면',
+        'empty state',
+        'nothing found',
+        '空',
+        '空状态',
+    ],
+    'feedback.confirmation': [
+        'confirm',
+        'confirmation',
+        'are you sure',
+        '확인',
+        'modal confirm',
+        '確認',
+        '确认',
+    ],
+    'feedback.success': [
+        'success',
+        'completed',
+        'done',
+        '성공',
+        'thank you',
+        'congratulations',
+        '成功',
+        '成功',
+    ],
+};
+/**
+ * 템플릿 카테고리별 Shell/Page 토큰 권장 매핑
+ */
+export const TEMPLATE_LAYOUT_RECOMMENDATIONS = {
+    auth: {
+        shell: 'shell.web.auth',
+        page: 'page.wizard',
+        description: 'Centered layout for authentication flows',
+    },
+    dashboard: {
+        shell: 'shell.web.dashboard',
+        page: 'page.dashboard',
+        description: 'Admin layout with sidebar for analytics',
+    },
+    core: {
+        shell: 'shell.web.app',
+        page: 'page.resource',
+        description: 'Standard app layout for content pages',
+    },
+    feedback: {
+        shell: 'shell.web.minimal',
+        page: 'page.empty',
+        description: 'Minimal layout for feedback states',
+    },
+    marketing: {
+        shell: 'shell.web.marketing',
+        page: 'page.detail',
+        description: 'Full-width layout for marketing pages',
+    },
+};
+/**
+ * 설명과 키워드 간 매칭 점수 계산
+ */
+function calculateMatchScore(description, keywords) {
+    const normalizedDesc = description.toLowerCase();
+    const matched = [];
+    let score = 0;
+    for (const keyword of keywords) {
+        if (normalizedDesc.includes(keyword.toLowerCase())) {
+            matched.push(keyword);
+            // 긴 키워드에 더 높은 점수 부여
+            score += keyword.split(' ').length * 10;
+        }
+    }
+    return { score, matched };
+}
+/**
+ * 자연어 설명에서 최적의 템플릿 매칭
+ *
+ * @param description - 사용자의 자연어 화면 설명
+ * @param topN - 반환할 상위 N개 결과 (기본: 3)
+ * @returns 매칭된 템플릿 결과 배열 (신뢰도순 정렬)
+ */
+export function matchTemplates(description, topN = 3) {
+    const results = [];
+    // 각 템플릿 키워드와 매칭
+    for (const [templateId, keywords] of Object.entries(KEYWORD_TEMPLATE_MAP)) {
+        const { score, matched } = calculateMatchScore(description, keywords);
+        if (score > 0) {
+            // 템플릿 메타데이터 가져오기
+            const template = templateRegistry.get(templateId);
+            const category = templateId.split('.')[0] || 'core';
+            results.push({
+                templateId,
+                templateName: template?.name || templateId,
+                category,
+                confidence: Math.min(100, score), // 0-100 범위로 제한
+                matchedKeywords: matched,
+                layoutRecommendation: TEMPLATE_LAYOUT_RECOMMENDATIONS[category] || {
+                    shell: 'shell.web.app',
+                    page: 'page.resource',
+                    description: 'Default app layout',
+                },
+            });
+        }
+    }
+    // 신뢰도순 정렬 후 상위 N개 반환
+    return results.sort((a, b) => b.confidence - a.confidence).slice(0, topN);
+}
+/**
+ * 최적 단일 템플릿 반환
+ */
+export function getBestMatch(description) {
+    const matches = matchTemplates(description, 1);
+    const firstMatch = matches[0];
+    return firstMatch ?? null;
+}
+/**
+ * 템플릿 ID로 레이아웃 권장사항 조회
+ */
+export function getLayoutRecommendation(templateId) {
+    const category = templateId.split('.')[0];
+    if (!category) {
+        return null;
+    }
+    return TEMPLATE_LAYOUT_RECOMMENDATIONS[category] || null;
+}
+/**
+ * 모든 템플릿 키워드 목록 조회 (디버깅용)
+ */
+export function getAllKeywordMappings() {
+    return { ...KEYWORD_TEMPLATE_MAP };
+}
+//# sourceMappingURL=template-matcher.js.map

package/dist/data/template-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-matcher.js","sourceRoot":"","sources":["../../src/data/template-matcher.ts"],"names":[],"mappings":"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"}

package/dist/generators/core-resolver.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Core Resolver for Tier 1 Export
+ * SPEC-COMPONENT-001-D: Hybrid Export System
+ *
+ * Tier 1: UI 라이브러리에서 컴포넌트 코드를 직접 가져옴
+ * - @tekton-ui/ui 패키지의 실제 구현을 참조
+ * - 사전 정의된 컴포넌트 템플릿 제공
+ */
+/**
+ * 컴포넌트 해결 결과 타입
+ */
+export interface ComponentResolutionResult {
+    success: boolean;
+    code?: string;
+    componentName?: string;
+    source?: 'tier1-ui' | 'tier1-example' | 'tier2-llm';
+    error?: string;
+}
+/**
+ * @tekton-ui/ui에서 지원하는 컴포넌트 목록
+ */
+export declare const TIER1_COMPONENTS: string[];
+/**
+ * Tier 1 컴포넌트인지 확인
+ */
+export declare function isTier1Component(componentName: string): boolean;
+/**
+ * Tier 1 예제 코드 가져오기
+ *
+ * @param componentName - 컴포넌트 이름
+ * @returns 해당 컴포넌트의 예제 코드
+ */
+export declare function getTier1Example(componentName: string): ComponentResolutionResult;
+/**
+ * @tekton-ui/ui 패키지에서 실제 컴포넌트 소스 코드 가져오기
+ *
+ * @param componentName - 컴포넌트 이름
+ * @returns 컴포넌트 소스 코드
+ */
+export declare function getTier1Source(componentName: string): ComponentResolutionResult;
+/**
+ * Tier 1에서 컴포넌트 해결 (예제 우선, 소스 fallback)
+ *
+ * @param componentName - 컴포넌트 이름
+ * @param preferSource - true면 소스 코드 우선, false면 예제 우선
+ * @returns 컴포넌트 해결 결과
+ */
+export declare function resolveFromTier1(componentName: string, preferSource?: boolean): ComponentResolutionResult;
+/**
+ * 여러 컴포넌트 해결
+ *
+ * @param componentNames - 컴포넌트 이름 배열
+ * @returns 각 컴포넌트의 해결 결과
+ */
+export declare function resolveMultipleFromTier1(componentNames: string[]): Map<string, ComponentResolutionResult>;
+//# sourceMappingURL=core-resolver.d.ts.map

package/dist/generators/core-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-resolver.d.ts","sourceRoot":"","sources":["../../src/generators/core-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,GAAG,eAAe,GAAG,WAAW,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6WD;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAA8B,CAAC;AAE5D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,yBAAyB,CAgBhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,yBAAyB,CA6D/E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,YAAY,UAAQ,GACnB,yBAAyB,CAmB3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EAAE,GACvB,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAQxC"}