statecli-mcp-server 0.2.0 → 0.3.0

package/dist/cross-file-impact.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Cross-File Impact - Predict which files will be affected by a change
+ *
+ * Analyzes code to predict ripple effects of changes.
+ */
+import { StateCLI } from './statecli';
+export interface SymbolReference {
+    symbol: string;
+    file: string;
+    line: number;
+    type: 'definition' | 'usage' | 'import' | 'export';
+}
+export interface ChangeProposal {
+    file: string;
+    symbol?: string;
+    changeType: 'modify' | 'rename' | 'delete' | 'move';
+    newValue?: string;
+}
+export interface ImpactPrediction {
+    proposal: ChangeProposal;
+    affectedFiles: AffectedFile[];
+    totalFilesAffected: number;
+    riskScore: number;
+    breakingChanges: BreakingChange[];
+    suggestions: string[];
+}
+export interface AffectedFile {
+    path: string;
+    reason: string;
+    references: SymbolReference[];
+    changeRequired: boolean;
+    suggestedFix?: string;
+}
+export interface BreakingChange {
+    file: string;
+    line: number;
+    description: string;
+    severity: 'error' | 'warning';
+}
+export declare class CrossFileImpact {
+    private statecli;
+    private dependencyTracker;
+    private projectPath;
+    private symbolIndex;
+    constructor(statecli: StateCLI, projectPath?: string);
+    /**
+     * Build symbol index for the project
+     */
+    buildIndex(): void;
+    /**
+     * Predict impact of a proposed change
+     */
+    predictImpact(proposal: ChangeProposal): ImpactPrediction;
+    /**
+     * Find all references to a symbol
+     */
+    findSymbolReferences(symbol: string): SymbolReference[];
+    /**
+     * Analyze what would break if a file is deleted
+     */
+    analyzeFileDeletion(filePath: string): ImpactPrediction;
+    /**
+     * Analyze what would break if a symbol is renamed
+     */
+    analyzeRename(filePath: string, oldName: string, newName: string): ImpactPrediction;
+    /**
+     * Get a safe change order for multiple files
+     */
+    getSafeChangeOrder(files: string[]): {
+        order: string[];
+        reason: string;
+    };
+    /**
+     * Check if a change is safe to make
+     */
+    isChangeSafe(proposal: ChangeProposal): {
+        safe: boolean;
+        reasons: string[];
+    };
+    private scanForSymbols;
+    private extractSymbols;
+    private isSourceFile;
+    private calculateRiskScore;
+}
+//# sourceMappingURL=cross-file-impact.d.ts.map

package/dist/cross-file-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-file-impact.d.ts","sourceRoot":"","sources":["../src/cross-file-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACpD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA6C;gBAEpD,QAAQ,EAAE,QAAQ,EAAE,WAAW,GAAE,MAAY;IAMzD;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,gBAAgB;IAoGzD;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAIvD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAOvD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB;IASnF;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;QACnC,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB;IAoBD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG;QACtC,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB;IAoBD,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,cAAc;IAyEtB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,kBAAkB;CAwB3B"}

package/dist/cross-file-impact.js

@@ -0,0 +1,338 @@
+"use strict";
+/**
+ * Cross-File Impact - Predict which files will be affected by a change
+ *
+ * Analyzes code to predict ripple effects of changes.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrossFileImpact = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const dependency_tracker_1 = require("./dependency-tracker");
+class CrossFileImpact {
+    statecli;
+    dependencyTracker;
+    projectPath;
+    symbolIndex = new Map();
+    constructor(statecli, projectPath = '.') {
+        this.statecli = statecli;
+        this.projectPath = path.resolve(projectPath);
+        this.dependencyTracker = new dependency_tracker_1.DependencyTracker(statecli, projectPath);
+    }
+    /**
+     * Build symbol index for the project
+     */
+    buildIndex() {
+        this.symbolIndex.clear();
+        this.dependencyTracker.buildGraph();
+        this.scanForSymbols(this.projectPath);
+        this.statecli.track('cross-file', 'index-built', {
+            symbolCount: this.symbolIndex.size,
+            timestamp: new Date().toISOString()
+        }, 'cross-file-impact');
+    }
+    /**
+     * Predict impact of a proposed change
+     */
+    predictImpact(proposal) {
+        const affectedFiles = [];
+        const breakingChanges = [];
+        const suggestions = [];
+        // Get dependency impact
+        const depImpact = this.dependencyTracker.analyzeImpact(proposal.file);
+        // Add direct dependents
+        for (const dep of depImpact.directDependents) {
+            affectedFiles.push({
+                path: dep,
+                reason: 'Directly imports the changed file',
+                references: [],
+                changeRequired: proposal.changeType === 'delete' || proposal.changeType === 'move'
+            });
+        }
+        // Add transitive dependents for high-risk changes
+        if (proposal.changeType === 'delete' || proposal.changeType === 'rename') {
+            for (const dep of depImpact.transitiveDependents) {
+                if (!affectedFiles.find(f => f.path === dep)) {
+                    affectedFiles.push({
+                        path: dep,
+                        reason: 'Transitively depends on the changed file',
+                        references: [],
+                        changeRequired: false
+                    });
+                }
+            }
+        }
+        // If changing a specific symbol, find all usages
+        if (proposal.symbol) {
+            const references = this.findSymbolReferences(proposal.symbol);
+            for (const ref of references) {
+                if (ref.file !== proposal.file) {
+                    let existing = affectedFiles.find(f => f.path === ref.file);
+                    if (!existing) {
+                        existing = {
+                            path: ref.file,
+                            reason: `Uses symbol "${proposal.symbol}"`,
+                            references: [],
+                            changeRequired: proposal.changeType !== 'modify'
+                        };
+                        affectedFiles.push(existing);
+                    }
+                    existing.references.push(ref);
+                    // Add breaking change if deleting or renaming
+                    if (proposal.changeType === 'delete' || proposal.changeType === 'rename') {
+                        breakingChanges.push({
+                            file: ref.file,
+                            line: ref.line,
+                            description: `Reference to "${proposal.symbol}" will break`,
+                            severity: 'error'
+                        });
+                    }
+                }
+            }
+        }
+        // Generate suggestions
+        if (proposal.changeType === 'rename' && proposal.newValue) {
+            suggestions.push(`Use find-and-replace to rename "${proposal.symbol}" to "${proposal.newValue}" across ${affectedFiles.length} files`);
+        }
+        if (proposal.changeType === 'delete') {
+            suggestions.push(`Remove or replace all ${breakingChanges.length} references before deleting`);
+        }
+        if (affectedFiles.length > 10) {
+            suggestions.push('Consider creating a checkpoint before making this change');
+        }
+        if (breakingChanges.length === 0 && affectedFiles.length > 0) {
+            suggestions.push('No breaking changes detected, but review affected files after change');
+        }
+        // Calculate risk score
+        const riskScore = this.calculateRiskScore(proposal, affectedFiles, breakingChanges);
+        // Track prediction
+        this.statecli.track('cross-file', 'impact-prediction', {
+            file: proposal.file,
+            changeType: proposal.changeType,
+            symbol: proposal.symbol,
+            affectedCount: affectedFiles.length,
+            breakingCount: breakingChanges.length,
+            riskScore
+        }, 'cross-file-impact');
+        return {
+            proposal,
+            affectedFiles,
+            totalFilesAffected: affectedFiles.length,
+            riskScore,
+            breakingChanges,
+            suggestions
+        };
+    }
+    /**
+     * Find all references to a symbol
+     */
+    findSymbolReferences(symbol) {
+        return this.symbolIndex.get(symbol) || [];
+    }
+    /**
+     * Analyze what would break if a file is deleted
+     */
+    analyzeFileDeletion(filePath) {
+        return this.predictImpact({
+            file: filePath,
+            changeType: 'delete'
+        });
+    }
+    /**
+     * Analyze what would break if a symbol is renamed
+     */
+    analyzeRename(filePath, oldName, newName) {
+        return this.predictImpact({
+            file: filePath,
+            symbol: oldName,
+            changeType: 'rename',
+            newValue: newName
+        });
+    }
+    /**
+     * Get a safe change order for multiple files
+     */
+    getSafeChangeOrder(files) {
+        // Sort by dependency order - change leaf nodes first
+        const scored = files.map(file => {
+            const impact = this.dependencyTracker.analyzeImpact(file);
+            return {
+                file,
+                score: impact.transitiveDependents.length
+            };
+        });
+        const order = scored
+            .sort((a, b) => a.score - b.score)
+            .map(s => s.file);
+        return {
+            order,
+            reason: 'Files sorted by dependency impact - change files with fewer dependents first'
+        };
+    }
+    /**
+     * Check if a change is safe to make
+     */
+    isChangeSafe(proposal) {
+        const prediction = this.predictImpact(proposal);
+        const reasons = [];
+        if (prediction.breakingChanges.length > 0) {
+            reasons.push(`${prediction.breakingChanges.length} breaking changes detected`);
+        }
+        if (prediction.riskScore > 70) {
+            reasons.push(`High risk score: ${prediction.riskScore}`);
+        }
+        if (prediction.totalFilesAffected > 20) {
+            reasons.push(`Too many files affected: ${prediction.totalFilesAffected}`);
+        }
+        return {
+            safe: reasons.length === 0,
+            reasons
+        };
+    }
+    scanForSymbols(dir) {
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (!['node_modules', '.git', 'dist', 'build', '__pycache__'].includes(entry.name)) {
+                        this.scanForSymbols(fullPath);
+                    }
+                }
+                else if (entry.isFile() && this.isSourceFile(entry.name)) {
+                    this.extractSymbols(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            // Directory might not be readable
+        }
+    }
+    extractSymbols(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const lines = content.split('\n');
+            const relativePath = path.relative(this.projectPath, filePath).replace(/\\/g, '/');
+            // Patterns for symbol extraction
+            const patterns = [
+                // Function/class definitions
+                { regex: /(?:export\s+)?(?:async\s+)?function\s+(\w+)/g, type: 'definition' },
+                { regex: /(?:export\s+)?class\s+(\w+)/g, type: 'definition' },
+                { regex: /(?:export\s+)?(?:const|let|var)\s+(\w+)/g, type: 'definition' },
+                { regex: /(?:export\s+)?interface\s+(\w+)/g, type: 'definition' },
+                { regex: /(?:export\s+)?type\s+(\w+)/g, type: 'definition' },
+                // Python definitions
+                { regex: /^def\s+(\w+)/gm, type: 'definition' },
+                { regex: /^class\s+(\w+)/gm, type: 'definition' },
+                // Imports
+                { regex: /import\s+\{([^}]+)\}/g, type: 'import' },
+                { regex: /import\s+(\w+)\s+from/g, type: 'import' },
+            ];
+            for (const { regex, type } of patterns) {
+                let match;
+                while ((match = regex.exec(content)) !== null) {
+                    const symbols = match[1].split(',').map(s => s.trim());
+                    const lineNumber = content.substring(0, match.index).split('\n').length;
+                    for (const symbol of symbols) {
+                        if (symbol && symbol.length > 1) {
+                            const ref = {
+                                symbol,
+                                file: relativePath,
+                                line: lineNumber,
+                                type
+                            };
+                            if (!this.symbolIndex.has(symbol)) {
+                                this.symbolIndex.set(symbol, []);
+                            }
+                            this.symbolIndex.get(symbol).push(ref);
+                        }
+                    }
+                }
+            }
+            // Find usages (identifiers that aren't definitions)
+            const identifierRegex = /\b([A-Z][a-zA-Z0-9]*)\b/g;
+            let match;
+            while ((match = identifierRegex.exec(content)) !== null) {
+                const symbol = match[1];
+                const lineNumber = content.substring(0, match.index).split('\n').length;
+                // Check if this is already tracked as a definition in this file
+                const existing = this.symbolIndex.get(symbol);
+                const isDefinitionHere = existing?.some(r => r.file === relativePath && r.type === 'definition' && r.line === lineNumber);
+                if (!isDefinitionHere && existing) {
+                    existing.push({
+                        symbol,
+                        file: relativePath,
+                        line: lineNumber,
+                        type: 'usage'
+                    });
+                }
+            }
+        }
+        catch (error) {
+            // File might not be readable
+        }
+    }
+    isSourceFile(filename) {
+        const extensions = ['.ts', '.tsx', '.js', '.jsx', '.py', '.java', '.cs'];
+        return extensions.some(ext => filename.endsWith(ext));
+    }
+    calculateRiskScore(proposal, affectedFiles, breakingChanges) {
+        let score = 0;
+        // Base score by change type
+        switch (proposal.changeType) {
+            case 'modify':
+                score += 10;
+                break;
+            case 'rename':
+                score += 30;
+                break;
+            case 'move':
+                score += 40;
+                break;
+            case 'delete':
+                score += 50;
+                break;
+        }
+        // Add for affected files
+        score += Math.min(affectedFiles.length * 3, 30);
+        // Add for breaking changes
+        score += Math.min(breakingChanges.length * 5, 20);
+        // Cap at 100
+        return Math.min(score, 100);
+    }
+}
+exports.CrossFileImpact = CrossFileImpact;
+//# sourceMappingURL=cross-file-impact.js.map

package/dist/cross-file-impact.js.map

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

package/dist/dependency-tracker.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Dependency Tracker - Understand code dependencies
+ *
+ * Analyzes imports/exports to understand what code depends on what.
+ */
+import { StateCLI } from './statecli';
+export interface Dependency {
+    source: string;
+    target: string;
+    type: 'import' | 'require' | 'export' | 'extends' | 'implements';
+    line?: number;
+}
+export interface FileNode {
+    path: string;
+    imports: string[];
+    exports: string[];
+    dependsOn: string[];
+    dependedBy: string[];
+}
+export interface DependencyGraph {
+    files: Map<string, FileNode>;
+    edges: Dependency[];
+}
+export interface ImpactAnalysis {
+    changedFile: string;
+    directDependents: string[];
+    transitiveDependents: string[];
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    recommendation: string;
+}
+export declare class DependencyTracker {
+    private statecli;
+    private projectPath;
+    private graph;
+    private fileExtensions;
+    constructor(statecli: StateCLI, projectPath?: string, options?: {
+        extensions?: string[];
+    });
+    /**
+     * Build dependency graph for the project
+     */
+    buildGraph(rootDir?: string): DependencyGraph;
+    /**
+     * Analyze impact of changing a file
+     */
+    analyzeImpact(filePath: string): ImpactAnalysis;
+    /**
+     * Get what a file depends on
+     */
+    getDependencies(filePath: string): string[];
+    /**
+     * Get what depends on a file
+     */
+    getDependents(filePath: string): string[];
+    /**
+     * Find circular dependencies
+     */
+    findCircularDependencies(): string[][];
+    /**
+     * Get dependency tree as a string for display
+     */
+    getDependencyTree(filePath: string, maxDepth?: number): string;
+    /**
+     * Get most depended-upon files (core files)
+     */
+    getCoreFiles(limit?: number): Array<{
+        file: string;
+        dependentCount: number;
+    }>;
+    private scanDirectory;
+    private analyzeFile;
+    private buildReverseLinks;
+    private resolveImportPath;
+    private normalizePath;
+    private getDirectDependents;
+    private getTransitiveDependents;
+}
+//# sourceMappingURL=dependency-tracker.d.ts.map

package/dist/dependency-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-tracker.d.ts","sourceRoot":"","sources":["../src/dependency-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAAW;gBAG/B,QAAQ,EAAE,QAAQ,EAClB,WAAW,GAAE,MAAY,EACzB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB;IAQH;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe;IAiB7C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IAmD/C;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAM3C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAMzC;;OAEG;IACH,wBAAwB,IAAI,MAAM,EAAE,EAAE;IAmCtC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM;IAyBjE;;OAEG;IACH,YAAY,CAAC,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAejF,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,uBAAuB;CAkBhC"}