atlas-pipeline-mcp 1.0.16 → 1.0.18

package/dist/tools/docs.js

@@ -0,0 +1,508 @@
+/**
+ * Atlas Server - Documentation Generation Tool
+ *
+ * Automatic documentation generation:
+ * - JSDoc/TSDoc comments
+ * - Python docstrings
+ * - README generation
+ * - API documentation
+ * - Inline code comments
+ * - Changelog generation
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger } from '../utils.js';
+// ============================================================================
+// Documentation Generation
+// ============================================================================
+/**
+ * Generate documentation for code
+ */
+export async function generateDocumentation(code, options = {}) {
+    const { style = 'auto', format = 'markdown', includeExamples = true, includeTypes = true, verbose = false, language, } = options;
+    logger.debug({ style, format, codeLength: code.length }, 'Starting documentation generation');
+    // Detect language and style
+    const detectedLanguage = language ?? detectLanguage(code);
+    const detectedStyle = style === 'auto' ? detectDocStyle(detectedLanguage) : style;
+    // Analyze code structure
+    const codeAnalysis = analyzeCodeStructure(code, detectedLanguage);
+    // Generate documentation
+    let documentedCode;
+    let documentation;
+    if (!isNoLLMMode()) {
+        try {
+            const aiResult = await generateDocsWithAI(code, {
+                language: detectedLanguage,
+                style: detectedStyle,
+                includeExamples,
+                includeTypes,
+                verbose,
+                codeAnalysis,
+            });
+            documentedCode = aiResult.documentedCode;
+            documentation = aiResult.documentation;
+        }
+        catch (error) {
+            logger.warn({ error }, 'AI documentation generation failed, using heuristic generation');
+            const heuristicResult = generateHeuristicDocs(code, detectedLanguage, detectedStyle, codeAnalysis);
+            documentedCode = heuristicResult.documentedCode;
+            documentation = heuristicResult.documentation;
+        }
+    }
+    else {
+        const heuristicResult = generateHeuristicDocs(code, detectedLanguage, detectedStyle, codeAnalysis);
+        documentedCode = heuristicResult.documentedCode;
+        documentation = heuristicResult.documentation;
+    }
+    // Generate additional documentation artifacts
+    const readme = generateReadme(documentation, detectedLanguage);
+    const api = format === 'markdown' ? generateApiDocs(documentation) : undefined;
+    // Calculate stats
+    const stats = calculateDocStats(codeAnalysis, documentation);
+    return {
+        documentedCode,
+        documentation,
+        readme,
+        api,
+        stats,
+        generatedAt: new Date().toISOString(),
+    };
+}
+function analyzeCodeStructure(code, language) {
+    const analysis = {
+        functions: [],
+        classes: [],
+        types: [],
+        exports: [],
+    };
+    const lines = code.split('\n');
+    if (['typescript', 'javascript'].includes(language.toLowerCase())) {
+        // Parse functions
+        const funcRegex = /(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*(<[^>]+>)?\s*\(([^)]*)\)(?:\s*:\s*([^{]+))?/g;
+        let match;
+        while ((match = funcRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            const params = parseParams(match[3] ?? '');
+            analysis.functions.push({
+                name: match[1],
+                params,
+                returnType: match[4]?.trim(),
+                isAsync: match[0].includes('async'),
+                isExported: match[0].startsWith('export'),
+                lineNumber,
+            });
+        }
+        // Parse arrow functions
+        const arrowRegex = /(?:export\s+)?(?:const|let)\s+(\w+)\s*(?::\s*[^=]+)?\s*=\s*(?:async\s+)?(?:<[^>]+>)?\s*\(([^)]*)\)(?:\s*:\s*([^=]+))?\s*=>/g;
+        while ((match = arrowRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            const params = parseParams(match[2] ?? '');
+            analysis.functions.push({
+                name: match[1],
+                params,
+                returnType: match[3]?.trim(),
+                isAsync: match[0].includes('async'),
+                isExported: match[0].startsWith('export'),
+                lineNumber,
+            });
+        }
+        // Parse classes
+        const classRegex = /(?:export\s+)?class\s+(\w+)(?:\s+extends\s+\w+)?(?:\s+implements\s+[^{]+)?\s*\{/g;
+        while ((match = classRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            analysis.classes.push({
+                name: match[1],
+                methods: [],
+                properties: [],
+                isExported: match[0].startsWith('export'),
+                lineNumber,
+            });
+        }
+        // Parse interfaces and types
+        const typeRegex = /(?:export\s+)?(?:(interface|type)\s+(\w+)|enum\s+(\w+))/g;
+        while ((match = typeRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            const kind = match[1];
+            const name = match[2] ?? match[3];
+            analysis.types.push({
+                name,
+                kind: kind ?? 'enum',
+                lineNumber,
+            });
+        }
+    }
+    else if (language.toLowerCase() === 'python') {
+        // Parse Python functions
+        const pyFuncRegex = /(?:async\s+)?def\s+(\w+)\s*\(([^)]*)\)(?:\s*->\s*([^:]+))?:/g;
+        let match;
+        while ((match = pyFuncRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            const params = parsePythonParams(match[2] ?? '');
+            analysis.functions.push({
+                name: match[1],
+                params,
+                returnType: match[3]?.trim(),
+                isAsync: match[0].includes('async'),
+                isExported: !match[1].startsWith('_'),
+                lineNumber,
+            });
+        }
+        // Parse Python classes
+        const pyClassRegex = /class\s+(\w+)(?:\([^)]*\))?:/g;
+        while ((match = pyClassRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            analysis.classes.push({
+                name: match[1],
+                methods: [],
+                properties: [],
+                isExported: !match[1].startsWith('_'),
+                lineNumber,
+            });
+        }
+    }
+    return analysis;
+}
+function parseParams(paramString) {
+    if (!paramString.trim())
+        return [];
+    return paramString.split(',').map(p => {
+        const trimmed = p.trim();
+        const optional = trimmed.includes('?') || trimmed.includes('=');
+        const [nameType] = trimmed.split('=');
+        const [name, type] = (nameType ?? '').split(':').map(s => s.replace('?', '').trim());
+        return {
+            name: name ?? '',
+            type,
+            optional,
+        };
+    }).filter(p => p.name);
+}
+function parsePythonParams(paramString) {
+    if (!paramString.trim())
+        return [];
+    const result = [];
+    for (const p of paramString.split(',')) {
+        const trimmed = p.trim();
+        if (trimmed === 'self' || trimmed === 'cls' || !trimmed)
+            continue;
+        const optional = trimmed.includes('=');
+        const [nameType] = trimmed.split('=');
+        const [name, type] = (nameType ?? '').split(':').map(s => s.trim());
+        if (name) {
+            result.push({
+                name,
+                type: type || undefined,
+                optional,
+            });
+        }
+    }
+    return result;
+}
+// ============================================================================
+// AI Documentation Generation
+// ============================================================================
+async function generateDocsWithAI(code, options) {
+    const provider = await getActiveProvider();
+    const prompt = `Generate comprehensive documentation for this code.
+
+## Code
+\`\`\`${options.language}
+${code}
+\`\`\`
+
+## Requirements
+- Documentation style: ${options.style}
+- Language: ${options.language}
+- Include examples: ${options.includeExamples}
+- Include types: ${options.includeTypes}
+${options.verbose ? '- Generate verbose, detailed documentation' : '- Keep documentation concise'}
+
+## Functions to Document
+${options.codeAnalysis.functions.map(f => `- ${f.name}(${f.params.map(p => p.name).join(', ')})`).join('\n')}
+
+## Output Format
+{
+  "documentedCode": "The complete code with documentation comments added",
+  "documentation": {
+    "name": "module name",
+    "description": "module description",
+    "exports": ["exported items"],
+    "functions": [
+      {
+        "name": "function name",
+        "description": "what it does",
+        "params": [{"name": "param", "type": "type", "description": "desc", "optional": false}],
+        "returns": {"type": "return type", "description": "what it returns"},
+        "throws": ["error conditions"],
+        "examples": ["example usage"]
+      }
+    ],
+    "classes": [],
+    "types": []
+  }
+}`;
+    const response = await provider.completeJson(prompt, {
+        systemPrompt: 'You are a technical writer. Generate clear, accurate documentation. Include practical examples. Return valid JSON only.',
+        temperature: 0.3,
+        maxTokens: 4096,
+    });
+    if (response.data) {
+        return response.data;
+    }
+    throw new Error('Failed to generate documentation with AI');
+}
+// ============================================================================
+// Heuristic Documentation Generation
+// ============================================================================
+function generateHeuristicDocs(code, language, style, analysis) {
+    const lines = code.split('\n');
+    const documentedLines = [];
+    const documentation = {
+        name: analysis.moduleName ?? 'module',
+        description: 'Module documentation',
+        exports: [],
+        functions: [],
+        classes: [],
+        types: [],
+    };
+    // Track which lines have been processed
+    const processedLines = new Set();
+    // Add function documentation
+    for (const func of analysis.functions) {
+        const doc = generateFunctionDoc(func, style, language);
+        documentation.functions.push(doc.functionDoc);
+        // Insert doc comment before the function
+        processedLines.add(func.lineNumber);
+    }
+    // Rebuild code with documentation
+    let currentLine = 1;
+    for (const func of analysis.functions.sort((a, b) => a.lineNumber - b.lineNumber)) {
+        // Add lines before this function
+        while (currentLine < func.lineNumber) {
+            documentedLines.push(lines[currentLine - 1] ?? '');
+            currentLine++;
+        }
+        // Add documentation comment
+        const docComment = formatDocComment(generateFunctionDoc(func, style, language).comment, style, language);
+        documentedLines.push(docComment);
+        documentedLines.push(lines[currentLine - 1] ?? '');
+        currentLine++;
+    }
+    // Add remaining lines
+    while (currentLine <= lines.length) {
+        documentedLines.push(lines[currentLine - 1] ?? '');
+        currentLine++;
+    }
+    return {
+        documentedCode: documentedLines.join('\n'),
+        documentation,
+    };
+}
+function generateFunctionDoc(func, style, language) {
+    const description = generateDescription(func.name);
+    const params = func.params.map(p => ({
+        name: p.name,
+        type: p.type ?? 'any',
+        description: `The ${p.name} parameter`,
+        optional: p.optional,
+    }));
+    const functionDoc = {
+        name: func.name,
+        description,
+        params,
+        returns: {
+            type: func.returnType ?? 'void',
+            description: func.returnType ? `Returns ${func.returnType}` : 'No return value',
+        },
+        examples: [`${func.name}(${func.params.map(p => `/* ${p.name} */`).join(', ')})`],
+    };
+    let comment = '';
+    if (['jsdoc', 'tsdoc'].includes(style) || language === 'typescript' || language === 'javascript') {
+        comment = `/**\n * ${description}\n`;
+        for (const param of params) {
+            comment += ` * @param {${param.type}} ${param.optional ? '[' + param.name + ']' : param.name} - ${param.description}\n`;
+        }
+        comment += ` * @returns {${functionDoc.returns.type}} ${functionDoc.returns.description}\n`;
+        comment += ` */`;
+    }
+    else if (style === 'pydoc' || language === 'python') {
+        comment = `    """\n    ${description}\n\n    Args:\n`;
+        for (const param of params) {
+            comment += `        ${param.name} (${param.type}): ${param.description}\n`;
+        }
+        comment += `\n    Returns:\n        ${functionDoc.returns.type}: ${functionDoc.returns.description}\n    """`;
+    }
+    return { comment, functionDoc };
+}
+function generateDescription(name) {
+    // Convert camelCase/snake_case to readable description
+    const words = name
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/_/g, ' ')
+        .toLowerCase()
+        .trim()
+        .split(' ');
+    if (words[0] === 'get') {
+        return `Gets the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'set') {
+        return `Sets the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'is' || words[0] === 'has' || words[0] === 'can') {
+        return `Checks if ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'create' || words[0] === 'build' || words[0] === 'make') {
+        return `Creates a new ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'update') {
+        return `Updates the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'delete' || words[0] === 'remove') {
+        return `Removes the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'find' || words[0] === 'search') {
+        return `Finds ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'validate' || words[0] === 'check') {
+        return `Validates the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'parse') {
+        return `Parses the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'format') {
+        return `Formats the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'convert') {
+        return `Converts ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'calculate' || words[0] === 'compute') {
+        return `Calculates the ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'handle') {
+        return `Handles ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'process') {
+        return `Processes ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'load') {
+        return `Loads ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'save') {
+        return `Saves ${words.slice(1).join(' ')}.`;
+    }
+    if (words[0] === 'init' || words[0] === 'initialize') {
+        return `Initializes ${words.slice(1).join(' ') || 'the component'}.`;
+    }
+    return `Performs ${words.join(' ')} operation.`;
+}
+function formatDocComment(comment, style, language) {
+    return comment;
+}
+// ============================================================================
+// README Generation
+// ============================================================================
+function generateReadme(doc, language) {
+    let readme = `# ${doc.name}\n\n`;
+    readme += `${doc.description}\n\n`;
+    if (doc.functions.length > 0) {
+        readme += `## Functions\n\n`;
+        for (const func of doc.functions) {
+            readme += `### \`${func.name}\`\n\n`;
+            readme += `${func.description}\n\n`;
+            if (func.params.length > 0) {
+                readme += `**Parameters:**\n\n`;
+                readme += `| Name | Type | Description |\n`;
+                readme += `|------|------|-------------|\n`;
+                for (const param of func.params) {
+                    readme += `| ${param.name} | \`${param.type}\` | ${param.description} |\n`;
+                }
+                readme += `\n`;
+            }
+            readme += `**Returns:** \`${func.returns.type}\` - ${func.returns.description}\n\n`;
+            if (func.examples && func.examples.length > 0) {
+                readme += `**Example:**\n\n`;
+                readme += `\`\`\`${language}\n${func.examples[0]}\n\`\`\`\n\n`;
+            }
+        }
+    }
+    if (doc.classes.length > 0) {
+        readme += `## Classes\n\n`;
+        for (const cls of doc.classes) {
+            readme += `### \`${cls.name}\`\n\n`;
+            readme += `${cls.description}\n\n`;
+        }
+    }
+    return readme;
+}
+// ============================================================================
+// API Documentation Generation
+// ============================================================================
+function generateApiDocs(doc) {
+    let api = `# API Reference\n\n`;
+    api += `## Module: ${doc.name}\n\n`;
+    api += `${doc.description}\n\n`;
+    if (doc.exports.length > 0) {
+        api += `### Exports\n\n`;
+        api += doc.exports.map(e => `- \`${e}\``).join('\n');
+        api += `\n\n`;
+    }
+    if (doc.functions.length > 0) {
+        api += `### Functions\n\n`;
+        for (const func of doc.functions) {
+            const paramTypes = func.params.map(p => `${p.name}: ${p.type}`).join(', ');
+            api += `#### \`${func.name}(${paramTypes}): ${func.returns.type}\`\n\n`;
+            api += `${func.description}\n\n`;
+        }
+    }
+    return api;
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function detectLanguage(code) {
+    if (code.includes('interface ') || code.includes(': string') || code.includes(': number')) {
+        return 'typescript';
+    }
+    if (code.includes('def ') && code.includes(':') && !code.includes('function ')) {
+        return 'python';
+    }
+    if (code.includes('func ') && code.includes('package ')) {
+        return 'go';
+    }
+    if (code.includes('fn ') && code.includes('->')) {
+        return 'rust';
+    }
+    return 'javascript';
+}
+function detectDocStyle(language) {
+    switch (language.toLowerCase()) {
+        case 'typescript':
+            return 'tsdoc';
+        case 'javascript':
+            return 'jsdoc';
+        case 'python':
+            return 'pydoc';
+        case 'go':
+            return 'godoc';
+        case 'rust':
+            return 'rustdoc';
+        default:
+            return 'jsdoc';
+    }
+}
+function calculateDocStats(analysis, doc) {
+    const totalFunctions = analysis.functions.length;
+    const documentedFunctions = doc.functions.length;
+    const totalClasses = analysis.classes.length;
+    const documentedClasses = doc.classes.length;
+    const total = totalFunctions + totalClasses;
+    const documented = documentedFunctions + documentedClasses;
+    const coverage = total > 0 ? Math.round((documented / total) * 100) : 100;
+    return {
+        totalFunctions,
+        documentedFunctions,
+        totalClasses,
+        documentedClasses,
+        coverage,
+    };
+}
+//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

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

package/dist/tools/explain.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Atlas Server - Code Explanation Tool
+ *
+ * Intelligent code explanation capabilities:
+ * - Line-by-line explanation
+ * - Algorithm analysis
+ * - Complexity analysis (Big O)
+ * - Design pattern identification
+ * - Dependency explanation
+ * - Beginner-friendly mode
+ */
+export type ExplanationLevel = 'beginner' | 'intermediate' | 'expert';
+export type ExplanationType = 'overview' | 'detailed' | 'line-by-line' | 'algorithm';
+export interface ExplanationOptions {
+    level?: ExplanationLevel;
+    type?: ExplanationType;
+    language?: string;
+    focusArea?: string;
+    includeComplexity?: boolean;
+    includePatterns?: boolean;
+}
+export interface CodeExplanation {
+    summary: string;
+    purpose: string;
+    howItWorks: string;
+    sections: ExplanationSection[];
+    complexity?: ComplexityAnalysis;
+    patterns?: DesignPattern[];
+    dependencies?: DependencyInfo[];
+    suggestions?: string[];
+    glossary?: GlossaryTerm[];
+}
+export interface ExplanationSection {
+    title: string;
+    lineRange: {
+        start: number;
+        end: number;
+    };
+    code: string;
+    explanation: string;
+    keyPoints: string[];
+}
+export interface ComplexityAnalysis {
+    time: string;
+    space: string;
+    explanation: string;
+    bestCase?: string;
+    worstCase?: string;
+    averageCase?: string;
+}
+export interface DesignPattern {
+    name: string;
+    type: 'creational' | 'structural' | 'behavioral' | 'architectural';
+    description: string;
+    locationHint: string;
+}
+export interface DependencyInfo {
+    name: string;
+    type: 'import' | 'external' | 'internal';
+    purpose: string;
+    required: boolean;
+}
+export interface GlossaryTerm {
+    term: string;
+    definition: string;
+    example?: string;
+}
+export interface ExplanationResult {
+    explanation: CodeExplanation;
+    metadata: {
+        level: ExplanationLevel;
+        type: ExplanationType;
+        language: string;
+        lineCount: number;
+    };
+    generatedAt: string;
+}
+/**
+ * Generate an explanation for the given code
+ */
+export declare function explainCode(code: string, options?: ExplanationOptions): Promise<ExplanationResult>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/tools/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,eAAe,CAAC;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE;QACR,KAAK,EAAE,gBAAgB,CAAC;QACxB,IAAI,EAAE,eAAe,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAkD5B"}