@mycodemap/mycodemap 0.1.0

package/dist/core/ast-complexity-analyzer.js

@@ -0,0 +1,279 @@
+// [META] since:2026-03-03 | owner:orchestrator-team | stable:true
+// [WHY] 提供基于 AST 的精确圈复杂度计算，支持函数级复杂度详情分析
+import * as ts from 'typescript';
+import * as fs from 'fs';
+import * as path from 'path';
+// 高复杂度阈值
+const HIGH_COMPLEXITY_THRESHOLD = 10;
+/**
+ * 基于 AST 分析单个文件的圈复杂度
+ */
+function analyzeFileWithAST(filePath, sourceCode) {
+    const sourceFile = ts.createSourceFile(path.basename(filePath), sourceCode, ts.ScriptTarget.Latest, true);
+    const functionDetails = [];
+    // 遍历 AST 节点
+    function visit(node, context) {
+        // 检测函数/方法
+        let currentFunction = context.inFunction;
+        let functionName = context.functionName;
+        let functionKind = context.functionKind;
+        let functionStart = context.functionStart;
+        let cyclomatic = 1;
+        let maxDepth = 0;
+        let currentDepth = 0;
+        if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isConstructorDeclaration(node)) {
+            currentFunction = true;
+            functionName = node.name?.getText(sourceFile) || '<anonymous>';
+            functionKind = ts.isFunctionDeclaration(node) ? 'function' : ts.isMethodDeclaration(node) ? 'method' : 'constructor';
+            functionStart = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+            cyclomatic = 1;
+            currentDepth = 0;
+        }
+        // 计算控制流复杂度
+        if (currentFunction) {
+            if (ts.isIfStatement(node) || ts.isWhileStatement(node) ||
+                ts.isForStatement(node) || ts.isForInStatement(node) ||
+                ts.isForOfStatement(node) || ts.isCaseClause(node) ||
+                ts.isCatchClause(node) || ts.isConditionalExpression(node)) {
+                cyclomatic++;
+            }
+            // 三元运算符增加复杂度
+            if (ts.isConditionalExpression(node)) {
+                cyclomatic++; // 三元运算符算作一个分支
+            }
+            // 逻辑运算符增加复杂度
+            if (ts.isBinaryExpression(node)) {
+                const operator = node.operatorToken.kind;
+                if (operator === ts.SyntaxKind.AmpersandAmpersandToken ||
+                    operator === ts.SyntaxKind.BarBarToken) {
+                    // && 和 || 每个增加一个分支
+                    cyclomatic++;
+                }
+            }
+        }
+        // 计算嵌套深度
+        if (ts.isIfStatement(node) || ts.isWhileStatement(node) ||
+            ts.isForStatement(node) || ts.isForInStatement(node) ||
+            ts.isForOfStatement(node) || ts.isSwitchStatement(node) ||
+            ts.isTryStatement(node)) {
+            currentDepth = context.depth + 1;
+            maxDepth = Math.max(maxDepth, currentDepth);
+        }
+        // 类计数
+        if (ts.isClassDeclaration(node)) {
+            classCount++;
+        }
+        // 递归遍历子节点
+        ts.forEachChild(node, child => {
+            visit(child, {
+                depth: currentDepth,
+                inFunction: currentFunction,
+                functionName,
+                functionKind,
+                functionStart
+            });
+        });
+        // 在函数结束时记录复杂度
+        if (currentFunction && (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isConstructorDeclaration(node))) {
+            const endLine = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+            functionDetails.push({
+                name: functionName,
+                kind: functionKind,
+                line: functionStart.line + 1,
+                column: functionStart.character + 1,
+                cyclomatic,
+                cognitive: cyclomatic + maxDepth * 2, // 认知复杂度考虑嵌套深度
+                nestingDepth: maxDepth,
+                isHighComplexity: cyclomatic >= HIGH_COMPLEXITY_THRESHOLD
+            });
+        }
+    }
+    // 先收集所有函数信息，然后计算文件级别的复杂度
+    const allFunctions = [];
+    function collectFunctions(node) {
+        if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isConstructorDeclaration(node)) {
+            const name = node.name?.getText(sourceFile) || '<anonymous>';
+            const kind = ts.isFunctionDeclaration(node) ? 'function' : ts.isMethodDeclaration(node) ? 'method' : 'constructor';
+            const start = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+            let cyclomatic = 1;
+            let maxDepth = 0;
+            // 统计函数内的控制流
+            function countControlFlow(n, depth) {
+                if (ts.isIfStatement(n) || ts.isWhileStatement(n) ||
+                    ts.isForStatement(n) || ts.isForInStatement(n) ||
+                    ts.isForOfStatement(n) || ts.isCaseClause(n) ||
+                    ts.isCatchClause(n)) {
+                    cyclomatic++;
+                }
+                if (ts.isConditionalExpression(n)) {
+                    cyclomatic++;
+                }
+                if (ts.isBinaryExpression(n)) {
+                    const operator = n.operatorToken.kind;
+                    if (operator === ts.SyntaxKind.AmpersandAmpersandToken ||
+                        operator === ts.SyntaxKind.BarBarToken) {
+                        cyclomatic++;
+                    }
+                }
+                if (ts.isIfStatement(n) || ts.isWhileStatement(n) ||
+                    ts.isForStatement(n) || ts.isForInStatement(n) ||
+                    ts.isForOfStatement(n) || ts.isSwitchStatement(n) ||
+                    ts.isTryStatement(n)) {
+                    maxDepth = Math.max(maxDepth, depth + 1);
+                }
+                ts.forEachChild(n, child => countControlFlow(child, ts.isBlock(n) ? depth : depth + (ts.isIfStatement(n) || ts.isWhileStatement(n) || ts.isForStatement(n) ? 1 : 0)));
+            }
+            countControlFlow(node, 0);
+            allFunctions.push({
+                name,
+                kind,
+                line: start.line + 1,
+                cyclomatic,
+                cognitive: cyclomatic + maxDepth * 2,
+                nestingDepth: maxDepth
+            });
+        }
+        ts.forEachChild(node, collectFunctions);
+    }
+    collectFunctions(sourceFile);
+    // 统计类数量
+    let classCount = 0;
+    function countClasses(n) {
+        if (ts.isClassDeclaration(n)) {
+            classCount++;
+        }
+        ts.forEachChild(n, countClasses);
+    }
+    countClasses(sourceFile);
+    // 计算文件级别的圈复杂度
+    let fileCyclomatic = 1;
+    function countFileControlFlow(n) {
+        if (ts.isIfStatement(n) || ts.isWhileStatement(n) ||
+            ts.isForStatement(n) || ts.isForInStatement(n) ||
+            ts.isForOfStatement(n) || ts.isCatchClause(n)) {
+            fileCyclomatic++;
+        }
+        // switch 语句: 每个 case 增加复杂度 (不包括 default)
+        if (ts.isCaseClause(n)) {
+            fileCyclomatic++;
+        }
+        // 三元运算符增加复杂度
+        if (ts.isConditionalExpression(n)) {
+            fileCyclomatic++;
+        }
+        if (ts.isBinaryExpression(n)) {
+            const operator = n.operatorToken.kind;
+            if (operator === ts.SyntaxKind.AmpersandAmpersandToken ||
+                operator === ts.SyntaxKind.BarBarToken) {
+                fileCyclomatic++;
+            }
+        }
+        ts.forEachChild(n, countFileControlFlow);
+    }
+    countFileControlFlow(sourceFile);
+    // 计算认知复杂度（考虑嵌套）
+    let maxNesting = 0;
+    function countNesting(n, depth) {
+        if (ts.isIfStatement(n) || ts.isWhileStatement(n) ||
+            ts.isForStatement(n) || ts.isForInStatement(n) ||
+            ts.isForOfStatement(n) || ts.isSwitchStatement(n) ||
+            ts.isTryStatement(n)) {
+            maxNesting = Math.max(maxNesting, depth + 1);
+        }
+        ts.forEachChild(n, child => countNesting(child, ts.isBlock(n) ? depth : depth));
+    }
+    countNesting(sourceFile, 0);
+    const fileCognitive = fileCyclomatic + maxNesting * 2;
+    // 计算可维护性指数
+    const lines = sourceCode.split('\n').length;
+    const commentLines = sourceCode.split('\n').filter(line => line.trim().startsWith('//') || line.trim().startsWith('/*') || line.trim().startsWith('*')).length;
+    const commentRatio = commentLines / Math.max(1, lines);
+    const maintainability = calculateMaintainabilityIndex(lines, fileCyclomatic, commentRatio);
+    return {
+        filePath,
+        relativePath: path.basename(filePath),
+        cyclomatic: fileCyclomatic,
+        cognitive: fileCognitive,
+        maintainability,
+        functions: allFunctions.length,
+        classes: classCount,
+        lines,
+        functionDetails: allFunctions.map(f => ({
+            name: f.name,
+            kind: f.kind,
+            line: f.line,
+            column: 1,
+            cyclomatic: f.cyclomatic,
+            cognitive: f.cognitive,
+            nestingDepth: f.nestingDepth,
+            isHighComplexity: f.cyclomatic >= HIGH_COMPLEXITY_THRESHOLD
+        }))
+    };
+}
+/**
+ * 计算可维护性指数
+ */
+function calculateMaintainabilityIndex(loc, cyclomatic, commentRatio) {
+    const normalizedLOC = Math.max(1, loc);
+    const normalizedCC = Math.max(1, cyclomatic);
+    let mi = 100;
+    mi -= (normalizedCC - 1) * 2;
+    mi -= Math.log(normalizedLOC / 10 + 1) * 5;
+    mi += commentRatio * 15;
+    return Math.max(0, Math.min(100, Math.round(mi)));
+}
+/**
+ * 分析文件复杂度（公开 API）
+ */
+export function analyzeFileComplexity(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`文件不存在: ${filePath}`);
+    }
+    const sourceCode = fs.readFileSync(filePath, 'utf-8');
+    return analyzeFileWithAST(filePath, sourceCode);
+}
+/**
+ * 分析多个文件复杂度（公开 API）
+ */
+export function analyzeMultipleFiles(filePaths, rootDir) {
+    const files = [];
+    for (const filePath of filePaths) {
+        try {
+            const result = analyzeFileComplexity(filePath);
+            if (rootDir) {
+                result.relativePath = path.relative(rootDir, filePath);
+            }
+            files.push(result);
+        }
+        catch (error) {
+            console.warn(`警告: 无法分析文件 ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (files.length === 0) {
+        return {
+            files: [],
+            summary: {
+                totalFiles: 0,
+                averageCyclomatic: 0,
+                averageCognitive: 0,
+                averageMaintainability: 0,
+                highComplexityFunctions: 0
+            }
+        };
+    }
+    const totalCyclomatic = files.reduce((sum, f) => sum + f.cyclomatic, 0);
+    const totalCognitive = files.reduce((sum, f) => sum + f.cognitive, 0);
+    const totalMaintainability = files.reduce((sum, f) => sum + f.maintainability, 0);
+    const highComplexityFunctions = files.reduce((sum, f) => sum + f.functionDetails.filter(d => d.isHighComplexity).length, 0);
+    return {
+        files,
+        summary: {
+            totalFiles: files.length,
+            averageCyclomatic: Math.round(totalCyclomatic / files.length),
+            averageCognitive: Math.round(totalCognitive / files.length),
+            averageMaintainability: Math.round(totalMaintainability / files.length),
+            highComplexityFunctions
+        }
+    };
+}
+//# sourceMappingURL=ast-complexity-analyzer.js.map

package/dist/core/ast-complexity-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-complexity-analyzer.js","sourceRoot":"","sources":["../../src/core/ast-complexity-analyzer.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wCAAwC;AAExC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAoC7B,SAAS;AACT,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAErC;;GAEG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,UAAkB;IAC9D,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACvB,UAAU,EACV,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,CACL,CAAC;IAEF,MAAM,eAAe,GAAyB,EAAE,CAAC;IAEjD,YAAY;IACZ,SAAS,KAAK,CAAC,IAAa,EAAE,OAA8J;QAC1L,UAAU;QACV,IAAI,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;QACzC,IAAI,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACxC,IAAI,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACxC,IAAI,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;YACxG,eAAe,GAAG,IAAI,CAAC;YACvB,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC;YAC/D,YAAY,GAAG,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;YACrH,aAAa,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YACpF,UAAU,GAAG,CAAC,CAAC;YACf,YAAY,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,WAAW;QACX,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBACnD,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBACpD,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;gBAClD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/D,UAAU,EAAE,CAAC;YACf,CAAC;YAED,aAAa;YACb,IAAI,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,UAAU,EAAE,CAAC,CAAC,cAAc;YAC9B,CAAC;YAED,aAAa;YACb,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBACzC,IAAI,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,uBAAuB;oBAClD,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;oBAC3C,mBAAmB;oBACnB,UAAU,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,SAAS;QACT,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACnD,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACpD,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;YACvD,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,YAAY,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;YACjC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM;QACN,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,UAAU,EAAE,CAAC;QACf,CAAC;QAED,UAAU;QACV,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;YAC5B,KAAK,CAAC,KAAK,EAAE;gBACX,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,eAAe;gBAC3B,YAAY;gBACZ,YAAY;gBACZ,aAAa;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC7H,MAAM,OAAO,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,eAAe,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC;gBAC5B,MAAM,EAAE,aAAa,CAAC,SAAS,GAAG,CAAC;gBACnC,UAAU;gBACV,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,CAAC,EAAE,cAAc;gBACpD,YAAY,EAAE,QAAQ;gBACtB,gBAAgB,EAAE,UAAU,IAAI,yBAAyB;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,YAAY,GAAqH,EAAE,CAAC;IAE1I,SAAS,gBAAgB,CAAC,IAAa;QACrC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;YACxG,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC;YAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;YACnH,MAAM,KAAK,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YAElF,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,QAAQ,GAAG,CAAC,CAAC;YAEjB,YAAY;YACZ,SAAS,gBAAgB,CAAC,CAAU,EAAE,KAAa;gBACjD,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;oBAC7C,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;oBAC9C,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;oBAC5C,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxB,UAAU,EAAE,CAAC;gBACf,CAAC;gBACD,IAAI,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClC,UAAU,EAAE,CAAC;gBACf,CAAC;gBACD,IAAI,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;oBACtC,IAAI,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,uBAAuB;wBAClD,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;wBAC3C,UAAU,EAAE,CAAC;oBACf,CAAC;gBACH,CAAC;gBAED,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;oBAC7C,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;oBAC9C,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;oBACjD,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzB,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC3C,CAAC;gBAED,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxK,CAAC;YAED,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAE1B,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC;gBACpB,UAAU;gBACV,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,CAAC;gBACpC,YAAY,EAAE,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC1C,CAAC;IAED,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE7B,QAAQ;IACR,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,SAAS,YAAY,CAAC,CAAU;QAC9B,IAAI,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,UAAU,EAAE,CAAC;QACf,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACnC,CAAC;IACD,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzB,cAAc;IACd,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,SAAS,oBAAoB,CAAC,CAAU;QACtC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC7C,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC9C,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,cAAc,EAAE,CAAC;QACnB,CAAC;QACD,yCAAyC;QACzC,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,cAAc,EAAE,CAAC;QACnB,CAAC;QACD,aAAa;QACb,IAAI,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;YAClC,cAAc,EAAE,CAAC;QACnB,CAAC;QACD,IAAI,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACtC,IAAI,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,uBAAuB;gBAClD,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC3C,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC3C,CAAC;IACD,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAEjC,gBAAgB;IAChB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,SAAS,YAAY,CAAC,CAAU,EAAE,KAAa;QAC7C,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC7C,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC9C,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACjD,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,CAAC,CAAC;IAEtD,WAAW;IACX,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CACxD,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAC5F,CAAC,MAAM,CAAC;IACT,MAAM,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEvD,MAAM,eAAe,GAAG,6BAA6B,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;IAE3F,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACrC,UAAU,EAAE,cAAc;QAC1B,SAAS,EAAE,aAAa;QACxB,eAAe;QACf,SAAS,EAAE,YAAY,CAAC,MAAM;QAC9B,OAAO,EAAE,UAAU;QACnB,KAAK;QACL,eAAe,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAA6C;YACrD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,gBAAgB,EAAE,CAAC,CAAC,UAAU,IAAI,yBAAyB;SAC5D,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,6BAA6B,CAAC,GAAW,EAAE,UAAkB,EAAE,YAAoB;IAC1F,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAE7C,IAAI,EAAE,GAAG,GAAG,CAAC;IACb,EAAE,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7B,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3C,EAAE,IAAI,YAAY,GAAG,EAAE,CAAC;IAExB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAmB,EAAE,OAAgB;IACxE,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACzD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,cAAc,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,EAAE;YACT,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC;gBACb,iBAAiB,EAAE,CAAC;gBACpB,gBAAgB,EAAE,CAAC;gBACnB,sBAAsB,EAAE,CAAC;gBACzB,uBAAuB,EAAE,CAAC;aAC3B;SACF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACtE,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,uBAAuB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CACtD,GAAG,GAAG,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAErE,OAAO;QACL,KAAK;QACL,OAAO,EAAE;YACP,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC;YAC7D,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3D,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC;YACvE,uBAAuB;SACxB;KACF,CAAC;AACJ,CAAC"}

package/dist/core/global-index.d.ts

@@ -0,0 +1,69 @@
+import type { GlobalSymbolIndex, GlobalSymbolInfo, CrossFileCall, CallChain } from '../types/index.js';
+import type { ParseResult } from '../parser/interfaces/IParser.js';
+/**
+ * 全局符号索引构建器
+ *
+ * 功能：
+ * 1. 收集所有文件的导出符号
+ * 2. 建立 import -> export 映射
+ * 3. 解析跨文件调用关系
+ * 4. 构建调用链
+ */
+export declare class GlobalSymbolIndexBuilder {
+    private index;
+    private rootDir;
+    constructor(rootDir: string);
+    /**
+     * 从解析结果构建全局索引
+     */
+    build(results: ParseResult[]): GlobalSymbolIndex;
+    /**
+     * 为单个文件建立符号索引
+     */
+    private buildFileIndex;
+    /**
+     * 解析跨文件调用
+     */
+    private resolveCrossFileCalls;
+    /**
+     * 解析被调用者位置
+     */
+    private resolveCallee;
+    /**
+     * 根据导入路径查找文件
+     */
+    private findFileByImport;
+    /**
+     * 构建全局符号表
+     */
+    private buildGlobalSymbolTable;
+    /**
+     * 获取导入的键
+     */
+    private getImportKey;
+    /**
+     * 查找符号的定义位置
+     */
+    findSymbol(name: string): GlobalSymbolInfo[];
+    /**
+     * 获取文件的跨文件调用
+     */
+    getCrossFileCalls(filePath: string): CrossFileCall[];
+    /**
+     * 构建调用链
+     */
+    buildCallChain(startSymbol: string, maxDepth?: number): CallChain;
+    /**
+     * 获取模块的依赖图
+     */
+    getModuleDependencyGraph(): Map<string, Set<string>>;
+}
+/**
+ * 创建全局符号索引
+ */
+export declare function createGlobalIndex(results: ParseResult[], rootDir: string): GlobalSymbolIndex;
+/**
+ * 查找符号定义
+ */
+export declare function findSymbolDefinition(index: GlobalSymbolIndex, name: string, currentFile?: string): GlobalSymbolInfo | undefined;
+//# sourceMappingURL=global-index.d.ts.map

package/dist/core/global-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-index.d.ts","sourceRoot":"","sources":["../../src/core/global-index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EAMb,SAAS,EAEV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAQ3B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,iBAAiB;IAiBhD;;OAEG;IACH,OAAO,CAAC,cAAc;IAyDtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8C7B;;OAEG;IACH,OAAO,CAAC,aAAa;IA2FrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAI5C;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAKpD;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,SAAS;IAkDpE;;OAEG;IACH,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CA4BrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,EAAE,MAAM,GACd,iBAAiB,CAGnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,gBAAgB,GAAG,SAAS,CAe9B"}