@tekton-ui/mcp-server 0.3.0

package/dist/data/hint-generator.js

@@ -0,0 +1,298 @@
+/**
+ * Hint Generator Module
+ * SPEC-MCP-004 Phase 3.5: Generates contextual hints for coding agents
+ *
+ * Provides guidance on layout, components, styling, accessibility, and best practices
+ */
+/**
+ * Keyword patterns for hint generation
+ */
+const LAYOUT_KEYWORDS = {
+    dashboard: ['dashboard', 'analytics', 'metrics', 'admin', 'kpi', 'stats'],
+    form: ['form', 'input', 'submit', 'register', 'signup', 'contact'],
+    auth: ['login', 'signin', 'signup', 'auth', 'password', 'verification'],
+    table: ['table', 'list', 'data', 'records', 'grid', 'rows'],
+    landing: ['landing', 'hero', 'marketing', 'homepage', 'home'],
+    profile: ['profile', 'user', 'account', 'settings', 'preferences'],
+};
+const COMPONENT_KEYWORDS = {
+    Card: ['card', 'panel', 'container', 'box'],
+    Table: ['table', 'data', 'records', 'rows', 'columns'],
+    Form: ['form', 'input', 'submit', 'field'],
+    Avatar: ['avatar', 'profile', 'user', 'photo'],
+    Badge: ['badge', 'tag', 'label', 'status'],
+    Button: ['button', 'action', 'cta', 'submit'],
+    Modal: ['modal', 'dialog', 'popup', 'overlay'],
+    Tabs: ['tabs', 'tabbed', 'sections', 'panels'],
+    Chart: ['chart', 'graph', 'visualization', 'analytics'],
+};
+/**
+ * Generate layout hints based on description
+ */
+function generateLayoutHints(description) {
+    const hints = [];
+    const lowerDesc = description.toLowerCase();
+    // Dashboard layout hints
+    if (LAYOUT_KEYWORDS.dashboard.some(kw => lowerDesc.includes(kw))) {
+        hints.push({
+            category: 'layout',
+            priority: 'high',
+            message: 'Use shell.web.dashboard with page.dashboard for admin-style layouts with sidebar navigation',
+            example: 'shell: "shell.web.dashboard", page: "page.dashboard"',
+        });
+        hints.push({
+            category: 'layout',
+            priority: 'medium',
+            message: 'Consider section.grid-4 for KPI cards at the top of the dashboard',
+        });
+    }
+    // Form layout hints
+    if (LAYOUT_KEYWORDS.form.some(kw => lowerDesc.includes(kw))) {
+        hints.push({
+            category: 'layout',
+            priority: 'high',
+            message: 'Use section.container for form content with appropriate max-width',
+            example: 'pattern: "section.container"',
+        });
+        hints.push({
+            category: 'best-practice',
+            priority: 'medium',
+            message: 'Group related form fields together and use clear labels',
+        });
+    }
+    // Auth layout hints
+    if (LAYOUT_KEYWORDS.auth.some(kw => lowerDesc.includes(kw))) {
+        hints.push({
+            category: 'layout',
+            priority: 'high',
+            message: 'Use shell.web.auth with page.wizard for centered authentication flows',
+            example: 'shell: "shell.web.auth", page: "page.wizard"',
+        });
+        hints.push({
+            category: 'layout',
+            priority: 'medium',
+            message: 'Use section.centered to center the authentication card vertically and horizontally',
+        });
+    }
+    // Table layout hints
+    if (LAYOUT_KEYWORDS.table.some(kw => lowerDesc.includes(kw))) {
+        hints.push({
+            category: 'layout',
+            priority: 'high',
+            message: 'Use shell.web.app with page.resource for data table views',
+            example: 'shell: "shell.web.app", page: "page.resource"',
+        });
+        hints.push({
+            category: 'component',
+            priority: 'medium',
+            message: 'Include a toolbar section with search and filter controls above the table',
+        });
+    }
+    // Landing page hints
+    if (LAYOUT_KEYWORDS.landing.some(kw => lowerDesc.includes(kw))) {
+        hints.push({
+            category: 'layout',
+            priority: 'high',
+            message: 'Use shell.web.marketing with page.detail for full-width marketing layouts',
+            example: 'shell: "shell.web.marketing", page: "page.detail"',
+        });
+    }
+    return hints;
+}
+/**
+ * Generate component hints based on description
+ */
+function generateComponentHints(description) {
+    const hints = [];
+    const lowerDesc = description.toLowerCase();
+    const detectedComponents = [];
+    // Detect components from description
+    for (const [component, keywords] of Object.entries(COMPONENT_KEYWORDS)) {
+        if (keywords.some(kw => lowerDesc.includes(kw))) {
+            detectedComponents.push(component);
+        }
+    }
+    // Add hints for detected components
+    if (detectedComponents.includes('Card')) {
+        hints.push({
+            category: 'component',
+            priority: 'medium',
+            message: 'Use Card with variant="elevated" for prominent content or variant="outline" for subtle containers',
+            example: '{ type: "Card", props: { variant: "elevated" } }',
+        });
+    }
+    if (detectedComponents.includes('Table')) {
+        hints.push({
+            category: 'component',
+            priority: 'high',
+            message: 'Define table columns with key, header, and sortable properties for interactive tables',
+            example: 'columns: [{ key: "name", header: "Name", sortable: true }]',
+        });
+        hints.push({
+            category: 'accessibility',
+            priority: 'high',
+            message: 'Ensure tables have proper column headers for screen reader accessibility',
+        });
+    }
+    if (detectedComponents.includes('Form')) {
+        hints.push({
+            category: 'component',
+            priority: 'high',
+            message: 'Use Input components with proper label and type props for form fields',
+            example: '{ type: "Input", props: { type: "email", label: "Email", required: true } }',
+        });
+        hints.push({
+            category: 'accessibility',
+            priority: 'high',
+            message: 'All form inputs must have associated labels for accessibility',
+        });
+    }
+    if (detectedComponents.includes('Avatar')) {
+        hints.push({
+            category: 'component',
+            priority: 'medium',
+            message: 'Always provide alt text for Avatar components',
+            example: '{ type: "Avatar", props: { src: "...", alt: "User Name", size: "lg" } }',
+        });
+    }
+    if (detectedComponents.includes('Button')) {
+        hints.push({
+            category: 'component',
+            priority: 'medium',
+            message: 'Use variant="primary" for main actions and variant="secondary" or variant="outline" for secondary actions',
+        });
+    }
+    if (detectedComponents.includes('Modal')) {
+        hints.push({
+            category: 'accessibility',
+            priority: 'high',
+            message: 'Modals should trap focus and be dismissible with Escape key',
+        });
+    }
+    return hints;
+}
+/**
+ * Generate styling hints based on theme
+ */
+function generateStylingHints(themeId) {
+    const hints = [];
+    hints.push({
+        category: 'styling',
+        priority: 'medium',
+        message: 'Use theme recipes for consistent component styling instead of custom classes',
+        example: 'Recipe classes are automatically applied based on component variant props',
+    });
+    if (themeId) {
+        hints.push({
+            category: 'styling',
+            priority: 'low',
+            message: `Theme "${themeId}" is selected - component variants will use this theme's recipe classes`,
+        });
+    }
+    else {
+        hints.push({
+            category: 'styling',
+            priority: 'medium',
+            message: 'Consider specifying a themeId to enable automatic recipe class application',
+        });
+    }
+    return hints;
+}
+/**
+ * Generate accessibility hints
+ */
+function generateAccessibilityHints(description) {
+    const hints = [];
+    const lowerDesc = description.toLowerCase();
+    // Always include basic accessibility hints
+    hints.push({
+        category: 'accessibility',
+        priority: 'high',
+        message: 'Use semantic HTML elements (Heading for titles, List for lists) for proper document structure',
+    });
+    // Add context-specific accessibility hints
+    if (lowerDesc.includes('image') || lowerDesc.includes('photo') || lowerDesc.includes('avatar')) {
+        hints.push({
+            category: 'accessibility',
+            priority: 'high',
+            message: 'All images must have descriptive alt text',
+            example: 'props: { alt: "Description of the image content" }',
+        });
+    }
+    if (lowerDesc.includes('form') || lowerDesc.includes('input')) {
+        hints.push({
+            category: 'accessibility',
+            priority: 'high',
+            message: 'Form inputs should have clear error messages and validation feedback',
+        });
+    }
+    if (lowerDesc.includes('button') || lowerDesc.includes('click')) {
+        hints.push({
+            category: 'accessibility',
+            priority: 'medium',
+            message: 'Interactive elements should have clear focus states and be keyboard accessible',
+        });
+    }
+    return hints;
+}
+/**
+ * Generate best practice hints
+ */
+function generateBestPracticeHints(description) {
+    const hints = [];
+    const lowerDesc = description.toLowerCase();
+    hints.push({
+        category: 'best-practice',
+        priority: 'medium',
+        message: 'Use meaningful section IDs that describe the content purpose',
+        example: 'id: "user-profile-header" instead of id: "section-1"',
+    });
+    hints.push({
+        category: 'best-practice',
+        priority: 'low',
+        message: 'Assign sections to appropriate slots (header, main, sidebar, footer) for proper layout positioning',
+    });
+    // Add context-specific best practices
+    if (lowerDesc.includes('list') || lowerDesc.includes('grid') || lowerDesc.includes('cards')) {
+        hints.push({
+            category: 'best-practice',
+            priority: 'medium',
+            message: 'For repeating content, define one component structure as a template pattern',
+        });
+    }
+    if (lowerDesc.includes('navigation') || lowerDesc.includes('menu')) {
+        hints.push({
+            category: 'best-practice',
+            priority: 'medium',
+            message: 'Use consistent navigation patterns across related screens',
+        });
+    }
+    return hints;
+}
+/**
+ * Generate all contextual hints based on description and theme
+ */
+export function generateHints(description, themeId) {
+    const allHints = [
+        ...generateLayoutHints(description),
+        ...generateComponentHints(description),
+        ...generateStylingHints(themeId),
+        ...generateAccessibilityHints(description),
+        ...generateBestPracticeHints(description),
+    ];
+    // Sort by priority (high first, then medium, then low)
+    const priorityOrder = { high: 0, medium: 1, low: 2 };
+    allHints.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+    // Remove duplicates and limit total hints
+    const uniqueHints = allHints.filter((hint, index, self) => index === self.findIndex(h => h.message === hint.message));
+    // Return top 10 hints to avoid overwhelming the agent
+    return uniqueHints.slice(0, 10);
+}
+/**
+ * Generate hints for a specific category
+ */
+export function generateCategoryHints(description, category, themeId) {
+    const allHints = generateHints(description, themeId);
+    return allHints.filter(hint => hint.category === category);
+}
+//# sourceMappingURL=hint-generator.js.map

package/dist/data/hint-generator.js.map

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

package/dist/data/recipe-resolver.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Recipe Resolver Module
+ * SPEC-MCP-004 Phase 4: Theme Recipes Auto-Application
+ *
+ * 테마에서 레시피를 조회하고 컴포넌트 className에 적용합니다.
+ */
+import type { ComponentNode } from '@tekton-ui/core';
+/**
+ * 테마에서 레시피 조회
+ *
+ * @param themeId - 테마 ID
+ * @param componentType - 컴포넌트 타입 (Card, Button, Text 등)
+ * @param variant - 컴포넌트 variant (glass, primary, hero 등)
+ * @returns 레시피 className 문자열 또는 undefined
+ */
+export declare function resolveRecipe(themeId: string, componentType: string, variant?: string): string | undefined;
+/**
+ * ComponentNode에 레시피 적용 (재귀)
+ *
+ * @param node - 컴포넌트 노드
+ * @param themeId - 테마 ID
+ * @returns 레시피가 적용된 노드 (원본 수정하지 않음)
+ */
+export declare function applyRecipeToNode(node: ComponentNode, themeId: string): ComponentNode;
+/**
+ * Blueprint의 모든 컴포넌트에 레시피 적용
+ *
+ * @param components - 컴포넌트 배열
+ * @param themeId - 테마 ID
+ * @returns 레시피가 적용된 컴포넌트 배열
+ */
+export declare function applyRecipesToBlueprint(components: ComponentNode[], themeId: string): ComponentNode[];
+/**
+ * 레시피 통계 계산
+ *
+ * @param components - 컴포넌트 배열
+ * @param themeId - 테마 ID
+ * @returns 적용된 레시피 개수
+ */
+export declare function countAppliedRecipes(components: ComponentNode[], themeId: string): number;
+/**
+ * 사용 가능한 모든 레시피 조회 (디버깅용)
+ *
+ * @param themeId - 테마 ID
+ * @returns 레시피 경로 → className 매핑
+ */
+export declare function getAllRecipes(themeId: string): Record<string, string>;
+//# sourceMappingURL=recipe-resolver.d.ts.map

package/dist/data/recipe-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-resolver.d.ts","sourceRoot":"","sources":["../../src/data/recipe-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAwDrD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CA2CpB;AAyBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CA+BrF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,aAAa,EAAE,EAC3B,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBxF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCrE"}

package/dist/data/recipe-resolver.js

@@ -0,0 +1,226 @@
+/**
+ * Recipe Resolver Module
+ * SPEC-MCP-004 Phase 4: Theme Recipes Auto-Application
+ *
+ * 테마에서 레시피를 조회하고 컴포넌트 className에 적용합니다.
+ */
+import { loadTheme } from '@tekton-ui/core';
+/**
+ * 컴포넌트 타입과 variant에서 레시피 경로 생성
+ *
+ * 규칙:
+ * - card + glass → recipes.card.glass
+ * - button + primary → recipes.button.primary
+ * - Text + hero → recipes.typography.hero (특수 케이스)
+ * - Badge + neutral → recipes.badge.neutral
+ */
+function getRecipePath(componentType, variant) {
+    if (!variant) {
+        return [`recipes.${componentType.toLowerCase()}.default`];
+    }
+    const type = componentType.toLowerCase();
+    const paths = [];
+    // Typography 특수 처리 (Text → recipes.typography)
+    if (type === 'text' || type === 'heading') {
+        paths.push(`recipes.typography.${variant}`);
+    }
+    // 일반 컴포넌트
+    else {
+        paths.push(`recipes.${type}.${variant}`);
+    }
+    // Fallback: variant 없이 기본 레시피
+    paths.push(`recipes.${type}.default`);
+    paths.push(`recipes.${type}`);
+    return paths;
+}
+/**
+ * 중첩 객체에서 경로로 값 조회
+ *
+ * @example
+ * getNestedValue({ a: { b: { c: 'value' } } }, 'a.b.c') → 'value'
+ */
+function getNestedValue(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current && typeof current === 'object' && key in current) {
+            current = current[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * 테마에서 레시피 조회
+ *
+ * @param themeId - 테마 ID
+ * @param componentType - 컴포넌트 타입 (Card, Button, Text 등)
+ * @param variant - 컴포넌트 variant (glass, primary, hero 등)
+ * @returns 레시피 className 문자열 또는 undefined
+ */
+export function resolveRecipe(themeId, componentType, variant) {
+    try {
+        const theme = loadTheme(themeId);
+        if (!theme) {
+            return undefined;
+        }
+        // recipes는 tokens 내부가 아니라 최상위 필드
+        const recipes = theme.recipes || theme.tokens?.recipes;
+        if (!recipes) {
+            return undefined;
+        }
+        const paths = getRecipePath(componentType, variant);
+        // 우선순위대로 레시피 경로 시도
+        for (const path of paths) {
+            const recipe = getNestedValue(recipes, path.replace('recipes.', ''));
+            // 레시피가 문자열이면 반환
+            if (typeof recipe === 'string') {
+                return recipe;
+            }
+            // 레시피가 객체면 'base' 또는 'default' 키 확인
+            if (recipe && typeof recipe === 'object') {
+                if (typeof recipe.base === 'string') {
+                    return recipe.base;
+                }
+                if (typeof recipe.default === 'string') {
+                    return recipe.default;
+                }
+            }
+        }
+        return undefined;
+    }
+    catch (error) {
+        console.warn(`[Recipe Resolver] Failed to resolve recipe for ${componentType}.${variant}:`, error);
+        return undefined;
+    }
+}
+/**
+ * ComponentNode의 props.className에 레시피 병합
+ *
+ * 기존 className이 있으면 레시피를 앞에 추가합니다.
+ *
+ * @example
+ * mergeClassName("p-4", "bg-white border") → "bg-white border p-4"
+ */
+function mergeClassName(existing, recipe) {
+    if (!existing) {
+        return recipe;
+    }
+    // 중복 제거를 위해 Set 사용
+    const existingClasses = existing.split(/\s+/).filter(Boolean);
+    const recipeClasses = recipe.split(/\s+/).filter(Boolean);
+    // 레시피 클래스를 앞에, 기존 클래스를 뒤에 (specificity 우선순위)
+    const merged = [...new Set([...recipeClasses, ...existingClasses])];
+    return merged.join(' ');
+}
+/**
+ * ComponentNode에 레시피 적용 (재귀)
+ *
+ * @param node - 컴포넌트 노드
+ * @param themeId - 테마 ID
+ * @returns 레시피가 적용된 노드 (원본 수정하지 않음)
+ */
+export function applyRecipeToNode(node, themeId) {
+    const result = { ...node };
+    // variant가 있으면 레시피 조회
+    if (result.type) {
+        const variant = result.props?.variant;
+        const recipe = resolveRecipe(themeId, result.type, variant);
+        if (recipe) {
+            // props 복사 (immutability 보장)
+            const currentProps = result.props || {};
+            const existingClassName = currentProps.className;
+            result.props = {
+                ...currentProps,
+                className: mergeClassName(existingClassName, recipe),
+            };
+        }
+    }
+    // children 재귀 처리
+    if (Array.isArray(result.children)) {
+        result.children = result.children.map(child => {
+            if (typeof child === 'object' && child !== null && 'type' in child) {
+                return applyRecipeToNode(child, themeId);
+            }
+            return child;
+        });
+    }
+    return result;
+}
+/**
+ * Blueprint의 모든 컴포넌트에 레시피 적용
+ *
+ * @param components - 컴포넌트 배열
+ * @param themeId - 테마 ID
+ * @returns 레시피가 적용된 컴포넌트 배열
+ */
+export function applyRecipesToBlueprint(components, themeId) {
+    return components.map(component => applyRecipeToNode(component, themeId));
+}
+/**
+ * 레시피 통계 계산
+ *
+ * @param components - 컴포넌트 배열
+ * @param themeId - 테마 ID
+ * @returns 적용된 레시피 개수
+ */
+export function countAppliedRecipes(components, themeId) {
+    let count = 0;
+    function traverse(node) {
+        const variant = node.props?.variant;
+        if (node.type && resolveRecipe(themeId, node.type, variant)) {
+            count++;
+        }
+        if (Array.isArray(node.children)) {
+            for (const child of node.children) {
+                if (typeof child === 'object' && child !== null && 'type' in child) {
+                    traverse(child);
+                }
+            }
+        }
+    }
+    for (const component of components) {
+        traverse(component);
+    }
+    return count;
+}
+/**
+ * 사용 가능한 모든 레시피 조회 (디버깅용)
+ *
+ * @param themeId - 테마 ID
+ * @returns 레시피 경로 → className 매핑
+ */
+export function getAllRecipes(themeId) {
+    try {
+        const theme = loadTheme(themeId);
+        if (!theme) {
+            return {};
+        }
+        // recipes는 tokens 내부가 아니라 최상위 필드
+        const recipes = theme.recipes || theme.tokens?.recipes;
+        if (!recipes) {
+            return {};
+        }
+        const result = {};
+        function traverse(obj, path = 'recipes') {
+            for (const [key, value] of Object.entries(obj)) {
+                const currentPath = path ? `${path}.${key}` : key;
+                if (typeof value === 'string') {
+                    result[currentPath] = value;
+                }
+                else if (typeof value === 'object' && value !== null) {
+                    traverse(value, currentPath);
+                }
+            }
+        }
+        traverse(recipes);
+        return result;
+    }
+    catch (error) {
+        console.warn(`[Recipe Resolver] Failed to get all recipes for ${themeId}:`, error);
+        return {};
+    }
+}
+//# sourceMappingURL=recipe-resolver.js.map

package/dist/data/recipe-resolver.js.map

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

package/dist/data/template-matcher.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Template Matcher Module
+ * SPEC-MCP-004 Phase 3: Blueprint Generator Enhancement
+ *
+ * 자연어 설명에서 최적의 Screen Template을 매칭합니다.
+ */
+/**
+ * 템플릿 카테고리별 Shell/Page 토큰 권장 매핑
+ */
+export declare const TEMPLATE_LAYOUT_RECOMMENDATIONS: Record<string, {
+    shell: string;
+    page: string;
+    description: string;
+}>;
+/**
+ * 템플릿 매칭 결과
+ */
+export interface TemplateMatchResult {
+    templateId: string;
+    templateName: string;
+    category: string;
+    confidence: number;
+    matchedKeywords: string[];
+    layoutRecommendation: {
+        shell: string;
+        page: string;
+        description: string;
+    };
+}
+/**
+ * 자연어 설명에서 최적의 템플릿 매칭
+ *
+ * @param description - 사용자의 자연어 화면 설명
+ * @param topN - 반환할 상위 N개 결과 (기본: 3)
+ * @returns 매칭된 템플릿 결과 배열 (신뢰도순 정렬)
+ */
+export declare function matchTemplates(description: string, topN?: number): TemplateMatchResult[];
+/**
+ * 최적 단일 템플릿 반환
+ */
+export declare function getBestMatch(description: string): TemplateMatchResult | null;
+/**
+ * 템플릿 ID로 레이아웃 권장사항 조회
+ */
+export declare function getLayoutRecommendation(templateId: string): (typeof TEMPLATE_LAYOUT_RECOMMENDATIONS)[string] | null;
+/**
+ * 모든 템플릿 키워드 목록 조회 (디버깅용)
+ */
+export declare function getAllKeywordMappings(): Record<string, string[]>;
+//# sourceMappingURL=template-matcher.d.ts.map

package/dist/data/template-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-matcher.d.ts","sourceRoot":"","sources":["../../src/data/template-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyIH;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAClD,MAAM,EACN;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA2BrD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAwBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,mBAAmB,EAAE,CA6B3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAI5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,GACjB,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAMzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAEhE"}