m8-mcp-server 1.0.1 → 1.0.3

package/dist/docs/components.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 组件信息查询
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现 UI 组件信息的查询功能
+ */
+import type { UIComponentDoc } from '../types/index.js';
+/**
+ * 规范化组件名称
+ * 支持带或不带 em- 前缀的查询
+ * @param name 组件名称
+ * @returns 规范化后的名称数组（用于查找）
+ */
+export declare function normalizeComponentName(name: string): string[];
+/**
+ * 获取组件信息
+ * @param components 组件映射
+ * @param name 组件名称
+ * @returns 组件信息或 null
+ */
+export declare function getComponentInfo(components: Map<string, UIComponentDoc>, name: string): UIComponentDoc | null;
+/**
+ * 查找相似的组件名称
+ * @param components 组件映射
+ * @param name 查询的名称
+ * @param limit 返回数量限制
+ * @returns 相似组件名称数组
+ */
+export declare function findSimilarComponents(components: Map<string, UIComponentDoc>, name: string, limit?: number): string[];
+/**
+ * 格式化组件信息为文本
+ * @param doc 组件文档
+ * @returns 格式化的文本
+ */
+export declare function formatComponentInfo(doc: UIComponentDoc): string;
+/**
+ * 获取所有组件列表
+ * @param components 组件映射
+ * @returns 组件列表
+ */
+export declare function getAllComponents(components: Map<string, UIComponentDoc>): Array<{
+    name: string;
+    title: string;
+}>;
+//# sourceMappingURL=components.d.ts.map

package/dist/docs/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/docs/components.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,mBAAmB,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAa7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,IAAI,EAAE,MAAM,GACX,cAAc,GAAG,IAAI,CAWvB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,GAChB,MAAM,EAAE,CAqBV;AA4BD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CA+E/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWhH"}

package/dist/docs/components.js

@@ -0,0 +1,186 @@
+/**
+ * 组件信息查询
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现 UI 组件信息的查询功能
+ */
+/**
+ * 规范化组件名称
+ * 支持带或不带 em- 前缀的查询
+ * @param name 组件名称
+ * @returns 规范化后的名称数组（用于查找）
+ */
+export function normalizeComponentName(name) {
+    const normalized = name.toLowerCase().trim();
+    const names = [normalized];
+    // 如果带有 em- 前缀，添加不带前缀的版本
+    if (normalized.startsWith('em-')) {
+        names.push(normalized.replace('em-', ''));
+    }
+    else {
+        // 如果不带前缀，添加带前缀的版本
+        names.push(`em-${normalized}`);
+    }
+    return names;
+}
+/**
+ * 获取组件信息
+ * @param components 组件映射
+ * @param name 组件名称
+ * @returns 组件信息或 null
+ */
+export function getComponentInfo(components, name) {
+    const names = normalizeComponentName(name);
+    for (const n of names) {
+        const doc = components.get(n);
+        if (doc) {
+            return doc;
+        }
+    }
+    return null;
+}
+/**
+ * 查找相似的组件名称
+ * @param components 组件映射
+ * @param name 查询的名称
+ * @param limit 返回数量限制
+ * @returns 相似组件名称数组
+ */
+export function findSimilarComponents(components, name, limit = 5) {
+    const query = name.toLowerCase().replace('em-', '');
+    const seen = new Set();
+    const similar = [];
+    for (const [, doc] of components) {
+        if (seen.has(doc.id))
+            continue;
+        seen.add(doc.id);
+        const componentName = doc.id.toLowerCase();
+        const score = calculateSimilarity(query, componentName);
+        if (score > 0.3) {
+            similar.push({ name: doc.name, score });
+        }
+    }
+    // 按相似度排序
+    similar.sort((a, b) => b.score - a.score);
+    return similar.slice(0, limit).map(s => s.name);
+}
+/**
+ * 计算两个字符串的相似度（简单实现）
+ * @param a 字符串 a
+ * @param b 字符串 b
+ * @returns 相似度分数 (0-1)
+ */
+function calculateSimilarity(a, b) {
+    if (a === b)
+        return 1;
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    // 检查是否包含
+    if (a.includes(b) || b.includes(a)) {
+        return 0.8;
+    }
+    // 计算共同字符数
+    const setA = new Set(a.split(''));
+    const setB = new Set(b.split(''));
+    let common = 0;
+    for (const char of setA) {
+        if (setB.has(char))
+            common++;
+    }
+    return common / Math.max(setA.size, setB.size);
+}
+/**
+ * 格式化组件信息为文本
+ * @param doc 组件文档
+ * @returns 格式化的文本
+ */
+export function formatComponentInfo(doc) {
+    const lines = [];
+    // 标题
+    lines.push(`# ${doc.name} (${doc.title})`);
+    lines.push('');
+    lines.push(doc.description);
+    lines.push('');
+    // Props
+    if (doc.props.length > 0) {
+        lines.push('## Props');
+        lines.push('');
+        lines.push('| 参数 | 类型 | 默认值 | 必填 | 说明 |');
+        lines.push('| --- | --- | --- | --- | --- |');
+        for (const prop of doc.props) {
+            lines.push(`| ${prop.name} | ${prop.type} | ${prop.default || '-'} | ${prop.required ? '是' : '否'} | ${prop.description} |`);
+        }
+        lines.push('');
+    }
+    // Events
+    if (doc.events.length > 0) {
+        lines.push('## Events');
+        lines.push('');
+        lines.push('| 事件名 | 参数 | 说明 |');
+        lines.push('| --- | --- | --- |');
+        for (const event of doc.events) {
+            lines.push(`| ${event.name} | ${event.parameters} | ${event.description} |`);
+        }
+        lines.push('');
+    }
+    // Slots
+    if (doc.slots && doc.slots.length > 0) {
+        lines.push('## Slots');
+        lines.push('');
+        lines.push('| 名称 | 说明 |');
+        lines.push('| --- | --- |');
+        for (const slot of doc.slots) {
+            lines.push(`| ${slot.name} | ${slot.description} |`);
+        }
+        lines.push('');
+    }
+    // 示例代码
+    if (doc.examples) {
+        if (doc.examples.vue2 && doc.examples.vue2.length > 0) {
+            lines.push('## Vue2 (M8.3) 示例');
+            lines.push('');
+            for (const example of doc.examples.vue2) {
+                lines.push(`### ${example.title}`);
+                if (example.description) {
+                    lines.push(example.description);
+                }
+                lines.push('```vue');
+                lines.push(example.code);
+                lines.push('```');
+                lines.push('');
+            }
+        }
+        if (doc.examples.vue3 && doc.examples.vue3.length > 0) {
+            lines.push('## Vue3 (M8.4) 示例');
+            lines.push('');
+            for (const example of doc.examples.vue3) {
+                lines.push(`### ${example.title}`);
+                if (example.description) {
+                    lines.push(example.description);
+                }
+                lines.push('```vue');
+                lines.push(example.code);
+                lines.push('```');
+                lines.push('');
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * 获取所有组件列表
+ * @param components 组件映射
+ * @returns 组件列表
+ */
+export function getAllComponents(components) {
+    const seen = new Set();
+    const list = [];
+    for (const [, doc] of components) {
+        if (seen.has(doc.id))
+            continue;
+        seen.add(doc.id);
+        list.push({ name: doc.name, title: doc.title });
+    }
+    return list.sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=components.js.map

package/dist/docs/components.js.map

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

package/dist/docs/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Document Manager 主入口
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 文档管理器，提供文档加载、搜索和查询功能
+ */
+import type { DocumentIndex, SearchOptions, SearchResult, UIComponentDoc, CodingStandardDoc, UtilDoc, ApiDoc, StandardType } from '../types/index.js';
+/**
+ * 文档管理器类
+ */
+export declare class DocumentManager {
+    private index;
+    private initialized;
+    constructor();
+    /**
+     * 初始化文档管理器，加载所有文档
+     */
+    initialize(): Promise<void>;
+    /**
+     * 搜索文档
+     */
+    searchDocs(query: string, options?: SearchOptions): SearchResult[];
+    /**
+     * 搜索文档并格式化结果
+     */
+    searchDocsFormatted(query: string, options?: SearchOptions): string;
+    /**
+     * 获取组件信息
+     */
+    getComponentInfo(name: string): UIComponentDoc | null;
+    /**
+     * 获取组件信息并格式化
+     */
+    getComponentInfoFormatted(name: string): string;
+    /**
+     * 获取所有组件列表
+     */
+    getAllComponents(): Array<{
+        name: string;
+        title: string;
+    }>;
+    /**
+     * 获取 API 信息
+     */
+    getApiInfo(moduleName: string, methodName?: string): ApiDoc | null;
+    /**
+     * 获取 API 信息并格式化
+     */
+    getApiInfoFormatted(moduleName: string, methodName?: string): string;
+    /**
+     * 获取可用的 API 模块
+     */
+    getAvailableApiModules(): string[];
+    /**
+     * 获取 Util 信息
+     */
+    getUtilInfo(category: string, methodName?: string): UtilDoc | null;
+    /**
+     * 获取 Util 信息并格式化
+     */
+    getUtilInfoFormatted(category: string, methodName?: string): string;
+    /**
+     * 获取可用的 Util 分类
+     */
+    getAvailableUtilCategories(): string[];
+    /**
+     * 获取编码规范
+     */
+    getCodingStandard(type: StandardType, keyword?: string): CodingStandardDoc | CodingStandardDoc[] | null;
+    /**
+     * 获取编码规范并格式化
+     */
+    getCodingStandardFormatted(type: StandardType, keyword?: string): string;
+    /**
+     * 获取可用的规范类型
+     */
+    getAvailableStandardTypes(): string[];
+    /**
+     * 获取文档索引（用于测试）
+     */
+    getIndex(): DocumentIndex;
+    /**
+     * 检查是否已初始化
+     */
+    isInitialized(): boolean;
+}
+export declare const documentManager: DocumentManager;
+export * from './loader.js';
+export * from './search.js';
+export * from './components.js';
+export * from './apis.js';
+export * from './utils.js';
+export * from './standards.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,OAAO,EACP,MAAM,EACN,YAAY,EACb,MAAM,mBAAmB,CAAC;AAS3B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,WAAW,CAAkB;;IAYrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IAIlE;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAKnE;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAIrD;;OAEG;IACH,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY/C;;OAEG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1D;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlE;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IASpE;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAIlE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IASnE;;OAEG;IACH,0BAA0B,IAAI,MAAM,EAAE;IAItC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,IAAI;IAIvG;;OAEG;IACH,0BAA0B,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IASxE;;OAEG;IACH,yBAAyB,IAAI,MAAM,EAAE;IAIrC;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAGrD,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,177 @@
+/**
+ * Document Manager 主入口
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 文档管理器，提供文档加载、搜索和查询功能
+ */
+import { loadAllDocuments } from './loader.js';
+import { searchDocs, formatSearchResults } from './search.js';
+import { getComponentInfo, formatComponentInfo, findSimilarComponents, getAllComponents } from './components.js';
+import { getApiInfo, formatApiInfo, loadEjsApis, getAvailableModules } from './apis.js';
+import { getUtilInfo, formatUtilInfo, getAvailableCategories } from './utils.js';
+import { getCodingStandard, formatCodingStandard, getAvailableStandardTypes } from './standards.js';
+/**
+ * 文档管理器类
+ */
+export class DocumentManager {
+    index;
+    initialized = false;
+    constructor() {
+        this.index = {
+            components: new Map(),
+            apis: new Map(),
+            utils: new Map(),
+            standards: new Map(),
+            cases: []
+        };
+    }
+    /**
+     * 初始化文档管理器，加载所有文档
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // 加载文档资源
+            this.index = loadAllDocuments();
+            // 加载内置的 EJS API
+            this.index.apis = loadEjsApis();
+            this.initialized = true;
+            // MCP 协议不允许输出非 JSON 内容，移除 console.log
+        }
+        catch {
+            // 初始化失败，静默抛出错误
+            throw new Error('Document manager initialization failed');
+        }
+    }
+    /**
+     * 搜索文档
+     */
+    searchDocs(query, options) {
+        return searchDocs(this.index, query, options);
+    }
+    /**
+     * 搜索文档并格式化结果
+     */
+    searchDocsFormatted(query, options) {
+        const results = this.searchDocs(query, options);
+        return formatSearchResults(results);
+    }
+    /**
+     * 获取组件信息
+     */
+    getComponentInfo(name) {
+        return getComponentInfo(this.index.components, name);
+    }
+    /**
+     * 获取组件信息并格式化
+     */
+    getComponentInfoFormatted(name) {
+        const doc = this.getComponentInfo(name);
+        if (!doc) {
+            const similar = findSimilarComponents(this.index.components, name);
+            if (similar.length > 0) {
+                return `组件 "${name}" 不存在。\n\n您是否在找:\n${similar.map(s => `- ${s}`).join('\n')}`;
+            }
+            return `组件 "${name}" 不存在。请检查组件名称是否正确。`;
+        }
+        return formatComponentInfo(doc);
+    }
+    /**
+     * 获取所有组件列表
+     */
+    getAllComponents() {
+        return getAllComponents(this.index.components);
+    }
+    /**
+     * 获取 API 信息
+     */
+    getApiInfo(moduleName, methodName) {
+        return getApiInfo(moduleName);
+    }
+    /**
+     * 获取 API 信息并格式化
+     */
+    getApiInfoFormatted(moduleName, methodName) {
+        const api = getApiInfo(moduleName);
+        if (!api) {
+            const available = getAvailableModules();
+            return `API 模块 "${moduleName}" 不存在。\n\n可用模块:\n${available.map(m => `- ejs.${m}`).join('\n')}`;
+        }
+        return formatApiInfo(api, methodName);
+    }
+    /**
+     * 获取可用的 API 模块
+     */
+    getAvailableApiModules() {
+        return getAvailableModules();
+    }
+    /**
+     * 获取 Util 信息
+     */
+    getUtilInfo(category, methodName) {
+        return getUtilInfo(this.index.utils, category);
+    }
+    /**
+     * 获取 Util 信息并格式化
+     */
+    getUtilInfoFormatted(category, methodName) {
+        const doc = getUtilInfo(this.index.utils, category);
+        if (!doc) {
+            const available = getAvailableCategories(this.index.utils);
+            return `Util 分类 "${category}" 不存在。\n\n可用分类:\n${available.map(c => `- ${c}`).join('\n')}`;
+        }
+        return formatUtilInfo(doc, methodName);
+    }
+    /**
+     * 获取可用的 Util 分类
+     */
+    getAvailableUtilCategories() {
+        return getAvailableCategories(this.index.utils);
+    }
+    /**
+     * 获取编码规范
+     */
+    getCodingStandard(type, keyword) {
+        return getCodingStandard(this.index.standards, type);
+    }
+    /**
+     * 获取编码规范并格式化
+     */
+    getCodingStandardFormatted(type, keyword) {
+        const doc = getCodingStandard(this.index.standards, type);
+        if (!doc) {
+            const available = getAvailableStandardTypes(this.index.standards);
+            return `编码规范类型 "${type}" 不存在。\n\n可用类型:\n${available.map(t => `- ${t}`).join('\n')}\n- all (获取所有规范)`;
+        }
+        return formatCodingStandard(doc, keyword);
+    }
+    /**
+     * 获取可用的规范类型
+     */
+    getAvailableStandardTypes() {
+        return getAvailableStandardTypes(this.index.standards);
+    }
+    /**
+     * 获取文档索引（用于测试）
+     */
+    getIndex() {
+        return this.index;
+    }
+    /**
+     * 检查是否已初始化
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+// 导出单例实例
+export const documentManager = new DocumentManager();
+// 导出子模块
+export * from './loader.js';
+export * from './search.js';
+export * from './components.js';
+export * from './apis.js';
+export * from './utils.js';
+export * from './standards.js';
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

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

package/dist/docs/loader.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 文档加载器
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 负责加载编码规范、组件文档、工具文档和典型案例
+ */
+import type { CodingStandardDoc, UIComponentDoc, UtilDoc, CaseDoc, DocumentIndex } from '../types/index.js';
+/**
+ * 加载编码规范文档
+ * @returns 编码规范文档映射
+ */
+export declare function loadStandards(): Map<string, CodingStandardDoc>;
+/**
+ * 加载 UI 组件文档
+ * @returns 组件文档映射
+ */
+export declare function loadComponents(): Map<string, UIComponentDoc>;
+/**
+ * 加载 Util 工具文档
+ * @returns 工具文档映射
+ */
+export declare function loadUtils(): Map<string, UtilDoc>;
+/**
+ * 加载典型案例文档
+ * @returns 案例文档数组
+ */
+export declare function loadCases(): CaseDoc[];
+/**
+ * 加载所有文档并构建索引
+ * @returns 文档索引
+ */
+export declare function loadAllDocuments(): DocumentIndex;
+/**
+ * 获取所有已加载的编码规范类型
+ * @param standards 编码规范映射
+ * @returns 规范类型数组
+ */
+export declare function getStandardTypes(standards: Map<string, CodingStandardDoc>): string[];
+/**
+ * 获取所有已加载的组件名称
+ * @param components 组件映射
+ * @returns 组件名称数组（去重）
+ */
+export declare function getComponentNames(components: Map<string, UIComponentDoc>): string[];
+/**
+ * 获取所有已加载的 Util 分类
+ * @param utils 工具映射
+ * @returns 分类数组
+ */
+export declare function getUtilCategories(utils: Map<string, UtilDoc>): string[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/docs/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/docs/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,OAAO,EACP,OAAO,EACP,aAAa,EACd,MAAM,mBAAmB,CAAC;AA4B3B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAoB9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CA0B5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBhD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,EAAE,CAoBrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAQhD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,EAAE,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,MAAM,EAAE,CAMnF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAEvE"}