mcp-probe-kit 1.13.0 → 1.15.1

package/build/utils/design-system-json-formatter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 设计系统 JSON 格式化器
+ *
+ * 将设计系统推荐转换为机器可读的 JSON 格式
+ */
+import { DesignSystemRecommendation } from './design-reasoning-engine.js';
+export interface DesignSystemJson {
+    version: string;
+    productType: string;
+    stack?: string;
+    colors: {
+        primary: Record<string, string>;
+        secondary?: Record<string, string>;
+        neutral: Record<string, string>;
+        success: Record<string, string>;
+        warning: Record<string, string>;
+        error: Record<string, string>;
+    };
+    typography: {
+        fontFamily: {
+            sans: string[];
+            serif: string[];
+            mono: string[];
+        };
+        fontSize: Record<string, string>;
+        fontWeight: Record<string, number>;
+        lineHeight: Record<string, string>;
+    };
+    spacing: {
+        base: number;
+        scale: number[];
+    };
+    borderRadius: Record<string, string>;
+    shadows: Record<string, string>;
+    breakpoints: Record<string, string>;
+    zIndex: Record<string, number>;
+}
+/**
+ * 格式化设计系统为 JSON
+ */
+export declare function formatDesignSystemJson(recommendation: DesignSystemRecommendation, productType: string, stack?: string): DesignSystemJson;

package/build/utils/design-system-json-formatter.js

@@ -0,0 +1,165 @@
+/**
+ * 设计系统 JSON 格式化器
+ *
+ * 将设计系统推荐转换为机器可读的 JSON 格式
+ */
+/**
+ * 解析颜色字符串，生成色阶
+ */
+function generateColorScale(baseColor) {
+    // 简化版：返回基础色阶
+    // 实际项目中可以使用 color 库生成完整色阶
+    return {
+        '50': lighten(baseColor, 0.95),
+        '100': lighten(baseColor, 0.9),
+        '200': lighten(baseColor, 0.8),
+        '300': lighten(baseColor, 0.6),
+        '400': lighten(baseColor, 0.4),
+        '500': baseColor,
+        '600': darken(baseColor, 0.2),
+        '700': darken(baseColor, 0.4),
+        '800': darken(baseColor, 0.6),
+        '900': darken(baseColor, 0.8),
+    };
+}
+/**
+ * 简单的颜色变亮函数
+ */
+function lighten(color, _amount) {
+    // 简化实现：返回原色
+    // 实际项目中应该使用专业的颜色库
+    return color;
+}
+/**
+ * 简单的颜色变暗函数
+ */
+function darken(color, _amount) {
+    // 简化实现：返回原色
+    // 实际项目中应该使用专业的颜色库
+    return color;
+}
+/**
+ * 从推荐中提取主色
+ */
+function extractPrimaryColor(recommendation) {
+    // 从配色方案中提取主色
+    const colorPalette = recommendation.colors;
+    // 尝试从 primary 字段提取
+    if (colorPalette.primary) {
+        return colorPalette.primary;
+    }
+    // 默认蓝色
+    return '#3b82f6';
+}
+/**
+ * 从推荐中提取辅色
+ */
+function extractSecondaryColor(recommendation) {
+    const colorPalette = recommendation.colors;
+    if (colorPalette.secondary) {
+        return colorPalette.secondary;
+    }
+    return undefined;
+}
+/**
+ * 从推荐中提取中性色
+ */
+function extractNeutralColor(recommendation) {
+    const colorPalette = recommendation.colors;
+    // 使用 text 颜色作为中性色
+    if (colorPalette.text) {
+        return colorPalette.text;
+    }
+    return '#6b7280';
+}
+/**
+ * 格式化设计系统为 JSON
+ */
+export function formatDesignSystemJson(recommendation, productType, stack) {
+    const primaryColor = extractPrimaryColor(recommendation);
+    const secondaryColor = extractSecondaryColor(recommendation);
+    const neutralColor = extractNeutralColor(recommendation);
+    return {
+        version: '1.0.0',
+        productType,
+        stack,
+        colors: {
+            primary: generateColorScale(primaryColor),
+            ...(secondaryColor && { secondary: generateColorScale(secondaryColor) }),
+            neutral: generateColorScale(neutralColor),
+            success: generateColorScale('#10b981'),
+            warning: generateColorScale('#f59e0b'),
+            error: generateColorScale('#ef4444'),
+        },
+        typography: {
+            fontFamily: {
+                sans: recommendation.typography.heading?.split(',').map((f) => f.trim()) || ['Inter', 'system-ui', 'sans-serif'],
+                serif: recommendation.typography.body?.split(',').map((f) => f.trim()) || ['Merriweather', 'Georgia', 'serif'],
+                mono: ['Fira Code', 'Consolas', 'monospace'],
+            },
+            fontSize: {
+                xs: '0.75rem',
+                sm: '0.875rem',
+                base: '1rem',
+                lg: '1.125rem',
+                xl: '1.25rem',
+                '2xl': '1.5rem',
+                '3xl': '1.875rem',
+                '4xl': '2.25rem',
+                '5xl': '3rem',
+            },
+            fontWeight: {
+                light: 300,
+                normal: 400,
+                medium: 500,
+                semibold: 600,
+                bold: 700,
+                extrabold: 800,
+            },
+            lineHeight: {
+                none: '1',
+                tight: '1.25',
+                snug: '1.375',
+                normal: '1.5',
+                relaxed: '1.625',
+                loose: '2',
+            },
+        },
+        spacing: {
+            base: 4,
+            scale: [0, 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128],
+        },
+        borderRadius: {
+            none: '0',
+            sm: '0.125rem',
+            md: '0.375rem',
+            lg: '0.5rem',
+            xl: '0.75rem',
+            '2xl': '1rem',
+            full: '9999px',
+        },
+        shadows: {
+            sm: '0 1px 2px 0 rgb(0 0 0 / 0.05)',
+            md: '0 4px 6px -1px rgb(0 0 0 / 0.1)',
+            lg: '0 10px 15px -3px rgb(0 0 0 / 0.1)',
+            xl: '0 20px 25px -5px rgb(0 0 0 / 0.1)',
+            '2xl': '0 25px 50px -12px rgb(0 0 0 / 0.25)',
+        },
+        breakpoints: {
+            sm: '640px',
+            md: '768px',
+            lg: '1024px',
+            xl: '1280px',
+            '2xl': '1536px',
+        },
+        zIndex: {
+            dropdown: 1000,
+            sticky: 1020,
+            fixed: 1030,
+            modalBackdrop: 1040,
+            modal: 1050,
+            popover: 1060,
+            tooltip: 1070,
+        },
+    };
+}

package/build/utils/ui-data-loader.d.ts

@@ -0,0 +1,56 @@
+/**
+ * UI/UX 数据加载器
+ *
+ * 三层数据策略：
+ * 1. 内嵌数据（构建时同步）
+ * 2. 缓存数据（运行时更新）
+ * 3. 手动同步（用户触发）
+ */
+import { CacheManager } from './cache-manager.js';
+import { UISearchEngine } from './ui-search-engine.js';
+export interface DataLoaderOptions {
+    useCache?: boolean;
+    autoUpdate?: boolean;
+}
+/**
+ * UI/UX 数据加载器
+ */
+export declare class UIDataLoader {
+    private cacheManager;
+    private searchEngine;
+    private useCache;
+    private loaded;
+    constructor(options?: DataLoaderOptions);
+    /**
+     * 加载数据
+     */
+    load(): Promise<void>;
+    /**
+     * 从缓存加载数据
+     */
+    private loadFromCache;
+    /**
+     * 从内嵌数据加载
+     */
+    private loadFromEmbedded;
+    /**
+     * 提取类别名称
+     */
+    private extractCategory;
+    /**
+     * 后台检查更新
+     */
+    private checkUpdateInBackground;
+    /**
+     * 获取搜索引擎
+     */
+    getSearchEngine(): UISearchEngine;
+    /**
+     * 获取缓存管理器
+     */
+    getCacheManager(): CacheManager;
+    /**
+     * 重新加载数据
+     */
+    reload(): Promise<void>;
+}

package/build/utils/ui-data-loader.js

@@ -0,0 +1,164 @@
+/**
+ * UI/UX 数据加载器
+ *
+ * 三层数据策略：
+ * 1. 内嵌数据（构建时同步）
+ * 2. 缓存数据（运行时更新）
+ * 3. 手动同步（用户触发）
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { CacheManager } from './cache-manager.js';
+import { UISearchEngine } from './ui-search-engine.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * UI/UX 数据加载器
+ */
+export class UIDataLoader {
+    cacheManager;
+    searchEngine;
+    useCache;
+    loaded = false;
+    constructor(options = {}) {
+        this.useCache = options.useCache ?? true;
+        this.cacheManager = new CacheManager({
+            autoUpdate: options.autoUpdate ?? true,
+        });
+        this.searchEngine = new UISearchEngine();
+    }
+    /**
+     * 加载数据
+     */
+    async load() {
+        if (this.loaded) {
+            return;
+        }
+        // 尝试从缓存加载
+        if (this.useCache && this.cacheManager.hasCache()) {
+            try {
+                await this.loadFromCache();
+                this.loaded = true;
+                // 后台检查更新
+                this.checkUpdateInBackground();
+                return;
+            }
+            catch (error) {
+                console.error('Failed to load from cache, falling back to embedded data:', error);
+            }
+        }
+        // 从内嵌数据加载
+        await this.loadFromEmbedded();
+        this.loaded = true;
+    }
+    /**
+     * 从缓存加载数据
+     */
+    async loadFromCache() {
+        const files = this.cacheManager.listFiles();
+        const datasets = [];
+        for (const file of files) {
+            if (!file.endsWith('.json')) {
+                continue;
+            }
+            const data = this.cacheManager.readFile(file);
+            if (!data || !Array.isArray(data)) {
+                continue;
+            }
+            // 提取类别名称
+            const category = this.extractCategory(file);
+            datasets.push({
+                category,
+                data,
+            });
+        }
+        this.searchEngine.loadDatasets(datasets);
+    }
+    /**
+     * 从内嵌数据加载
+     */
+    async loadFromEmbedded() {
+        const dataDir = path.join(__dirname, '..', 'resources', 'ui-ux-data');
+        if (!fs.existsSync(dataDir)) {
+            throw new Error('Embedded UI/UX data not found. Please run "npm run sync-ui-data" first.');
+        }
+        const datasets = [];
+        const walk = (dir, prefix = '') => {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+                if (entry.isDirectory()) {
+                    walk(fullPath, relativePath);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.json') && entry.name !== 'metadata.json') {
+                    try {
+                        const content = fs.readFileSync(fullPath, 'utf-8');
+                        const data = JSON.parse(content);
+                        if (Array.isArray(data)) {
+                            const category = this.extractCategory(relativePath);
+                            datasets.push({ category, data });
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Failed to load ${relativePath}:`, error);
+                    }
+                }
+            }
+        };
+        walk(dataDir);
+        this.searchEngine.loadDatasets(datasets);
+    }
+    /**
+     * 提取类别名称
+     */
+    extractCategory(filename) {
+        // 移除扩展名
+        let category = filename.replace(/\.json$/, '');
+        // 处理子目录（如 stacks/react.json -> react）
+        if (category.includes('/')) {
+            const parts = category.split('/');
+            category = parts[parts.length - 1];
+        }
+        return category;
+    }
+    /**
+     * 后台检查更新
+     */
+    async checkUpdateInBackground() {
+        try {
+            const updateInfo = await this.cacheManager.checkUpdate();
+            if (updateInfo.hasUpdate) {
+                console.log(`UI/UX data update available: ${updateInfo.currentVersion || 'none'} -> ${updateInfo.latestVersion}`);
+                console.log('Run "npm run sync-ui-data" to update.');
+            }
+        }
+        catch (error) {
+            // 静默失败，不影响主流程
+        }
+    }
+    /**
+     * 获取搜索引擎
+     */
+    getSearchEngine() {
+        if (!this.loaded) {
+            throw new Error('Data not loaded. Call load() first.');
+        }
+        return this.searchEngine;
+    }
+    /**
+     * 获取缓存管理器
+     */
+    getCacheManager() {
+        return this.cacheManager;
+    }
+    /**
+     * 重新加载数据
+     */
+    async reload() {
+        this.searchEngine.clear();
+        this.loaded = false;
+        await this.load();
+    }
+}

package/build/utils/ui-search-engine.d.ts

@@ -0,0 +1,57 @@
+/**
+ * UI/UX 搜索引擎
+ *
+ * 基于 BM25 算法的 UI/UX 数据搜索引擎
+ */
+export interface UISearchOptions {
+    category?: string;
+    stack?: string;
+    limit?: number;
+    minScore?: number;
+}
+export interface UISearchResult {
+    id: string;
+    score: number;
+    category: string;
+    data: Record<string, any>;
+}
+export interface UIDataset {
+    category: string;
+    data: Record<string, any>[];
+}
+/**
+ * UI/UX 搜索引擎
+ */
+export declare class UISearchEngine {
+    private bm25;
+    private datasets;
+    constructor();
+    /**
+     * 加载数据集
+     */
+    loadDataset(category: string, data: Record<string, any>[]): void;
+    /**
+     * 批量加载数据集
+     */
+    loadDatasets(datasets: UIDataset[]): void;
+    /**
+     * 构建搜索文本
+     */
+    private buildSearchText;
+    /**
+     * 搜索 UI/UX 数据
+     */
+    search(query: string, options?: UISearchOptions): UISearchResult[];
+    /**
+     * 获取所有类别
+     */
+    getCategories(): string[];
+    /**
+     * 获取类别数据
+     */
+    getCategoryData(category: string): Record<string, any>[] | undefined;
+    /**
+     * 清空索引
+     */
+    clear(): void;
+}

package/build/utils/ui-search-engine.js

@@ -0,0 +1,123 @@
+/**
+ * UI/UX 搜索引擎
+ *
+ * 基于 BM25 算法的 UI/UX 数据搜索引擎
+ */
+import { BM25 } from './bm25.js';
+/**
+ * UI/UX 搜索引擎
+ */
+export class UISearchEngine {
+    bm25;
+    datasets = new Map();
+    constructor() {
+        this.bm25 = new BM25({
+            k1: 1.5,
+            b: 0.75,
+        });
+    }
+    /**
+     * 加载数据集
+     */
+    loadDataset(category, data) {
+        this.datasets.set(category, data);
+        // 为每条数据创建 BM25 文档
+        for (let i = 0; i < data.length; i++) {
+            const item = data[i];
+            const docId = `${category}:${i}`;
+            // 构建搜索文本（包含所有字段）
+            const searchText = this.buildSearchText(item);
+            this.bm25.addDocument({
+                id: docId,
+                text: searchText,
+                metadata: {
+                    category,
+                    index: i,
+                },
+            });
+        }
+    }
+    /**
+     * 批量加载数据集
+     */
+    loadDatasets(datasets) {
+        for (const dataset of datasets) {
+            this.loadDataset(dataset.category, dataset.data);
+        }
+    }
+    /**
+     * 构建搜索文本
+     */
+    buildSearchText(item) {
+        const parts = [];
+        for (const [key, value] of Object.entries(item)) {
+            if (value == null)
+                continue;
+            if (typeof value === 'string') {
+                parts.push(value);
+            }
+            else if (typeof value === 'number') {
+                parts.push(String(value));
+            }
+            else if (Array.isArray(value)) {
+                parts.push(value.join(' '));
+            }
+            else if (typeof value === 'object') {
+                parts.push(JSON.stringify(value));
+            }
+        }
+        return parts.join(' ');
+    }
+    /**
+     * 搜索 UI/UX 数据
+     */
+    search(query, options = {}) {
+        const { category, limit = 10, minScore = 0, } = options;
+        // 执行 BM25 搜索
+        const bm25Results = this.bm25.search(query, limit * 2);
+        // 转换结果
+        const results = [];
+        for (const result of bm25Results) {
+            if (result.score < minScore)
+                continue;
+            const { category: resultCategory, index } = result.metadata;
+            // 过滤类别
+            if (category && resultCategory !== category) {
+                continue;
+            }
+            const dataset = this.datasets.get(resultCategory);
+            if (!dataset || index >= dataset.length) {
+                continue;
+            }
+            results.push({
+                id: result.id,
+                score: result.score,
+                category: resultCategory,
+                data: dataset[index],
+            });
+            if (results.length >= limit) {
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * 获取所有类别
+     */
+    getCategories() {
+        return Array.from(this.datasets.keys());
+    }
+    /**
+     * 获取类别数据
+     */
+    getCategoryData(category) {
+        return this.datasets.get(category);
+    }
+    /**
+     * 清空索引
+     */
+    clear() {
+        this.bm25.clear();
+        this.datasets.clear();
+    }
+}

package/build/utils/ui-sync.d.ts

@@ -0,0 +1,13 @@
+/**
+ * UI/UX 数据同步工具
+ *
+ * 从 npm 包 uipro-cli 同步数据到缓存目录
+ */
+/**
+ * 同步 UI/UX 数据到指定目录（通用函数）
+ */
+export declare function syncUIDataTo(outputDir: string, verbose?: boolean): Promise<void>;
+/**
+ * 同步 UI/UX 数据到缓存
+ */
+export declare function syncUIDataToCache(force?: boolean, verbose?: boolean): Promise<void>;