autosnippet 3.2.16 → 3.2.18

package/dist/lib/core/analysis/CallEdgeResolver.js

@@ -21,8 +21,6 @@ export class CallEdgeResolver {
     propertyTypes;
     symbolTable;
     /**
-     * @param {import('./SymbolTableBuilder.js').SymbolTable} symbolTable
-     * @param {import('./ImportPathResolver.js').ImportPathResolver} importResolver
      * @param {Array<{from: string, to: string, type: string}>} [inheritanceGraph=[]] 继承图边
      */
     constructor(symbolTable, importResolver, inheritanceGraph = []) {
@@ -34,13 +32,11 @@ export class CallEdgeResolver {
         // Phase 5.3: DI — property type annotations: className → (fieldName → typeName)
         this.propertyTypes = symbolTable.propertyTypes || new Map();
         // 构建反向索引: symbolName → [fqn1, fqn2, ...]
-        /** @type {Map<string, string[]>} */
         this.nameIndex = new Map();
         // 构建文件级索引: file → [{ name, qualifiedName, fqn }] (Issue #14 性能优化)
         /** @type {Map<string, Array<{name: string, qualifiedName: string, fqn: string}>>} */
         this.fileIndex = new Map();
         // Phase 5.3: 类名集合索引 (用于 _inferFieldType 优化，避免全表扫描)
-        /** @type {Set<string>} */
         this.classNames = new Set();
         for (const [fqn, decl] of symbolTable.declarations) {
             const names = [decl.name];
@@ -68,9 +64,8 @@ export class CallEdgeResolver {
     /**
      * 解析一个文件中的所有调用点为边
      *
-     * @param {import('./CallSiteExtractor.js').CallSite[]} callSites 来自某个文件的所有调用点
-     * @param {string} callerFile 调用者文件路径 (相对)
-     * @returns {ResolvedEdge[]}
+     * @param callSites 来自某个文件的所有调用点
+     * @param callerFile 调用者文件路径 (相对)
      */
     resolveFile(callSites, callerFile) {
         const edges = [];
@@ -91,9 +86,7 @@ export class CallEdgeResolver {
         }
         return edges;
     }
-    /**
-     * @private 构建局部 import 映射
-     */
+    /** @private 构建局部 import 映射 */
     _buildImportMap(fileImports, callerFile) {
         /** @type {Map<string, { file: string, namespace: boolean }>} */
         const importedSymbols = new Map();
@@ -124,9 +117,7 @@ export class CallEdgeResolver {
         }
         return importedSymbols;
     }
-    /**
-     * @private 解析单个调用点
-     */
+    /** @private 解析单个调用点 */
     _resolveCallSite(cs, callerFile, importedSymbols) {
         const callerFqn = `${callerFile}::${cs.callerClass ? `${cs.callerClass}.` : ''}${cs.callerMethod}`;
         // Priority 0: super.xxx() — 父类方法调用 (CHA 解析，禁止 fallthrough 防止自引用边)
@@ -278,9 +269,9 @@ export class CallEdgeResolver {
      * 使用 BFS 遍历 inheritanceGraph，从 className 向上搜索直到找到
      * 定义了 methodName 的祖先类。只跟踪 'inherits' 类型的边。
      *
-     * @param {string} methodName 被调用的方法名
-     * @param {string} className 起始类名
-     * @returns {string|null} 找到的 FQN 或 null
+     * @param methodName 被调用的方法名
+     * @param className 起始类名
+     * @returns 找到的 FQN 或 null
      */
     _resolveByCHA(methodName, className) {
         if (!this.inheritanceGraph || this.inheritanceGraph.length === 0) {
@@ -324,9 +315,6 @@ export class CallEdgeResolver {
      *   - _userRepo → UserRepo (Java/Kotlin private field)
      *
      * 只在符号表中存在匹配类时返回
-     *
-     * @param {string} fieldName
-     * @returns {string|null}
      */
     _inferFieldType(fieldName) {
         // 去除前导下划线
@@ -341,9 +329,8 @@ export class CallEdgeResolver {
     }
     /**
      * @private 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
-     * @param {string} name 符号名 (可以是 "ClassName.methodName" 或 "functionName")
-     * @param {string} file
-     * @returns {string[]} 匹配的 FQN 列表
+     * @param name 符号名 (可以是 "ClassName.methodName" 或 "functionName")
+     * @returns 匹配的 FQN 列表
      */
     _findInFile(name, file) {
         const fileDecls = this.fileIndex.get(file);
@@ -354,9 +341,7 @@ export class CallEdgeResolver {
             .filter((d) => d.name === name || d.qualifiedName === name)
             .map((d) => d.fqn);
     }
-    /**
-     * @private 构建 ResolvedEdge
-     */
+    /** @private 构建 ResolvedEdge */
     _makeEdge(callerFqn, calleeFqn, resolveMethod, cs, callerFile) {
         return {
             caller: callerFqn,
@@ -371,4 +356,3 @@ export class CallEdgeResolver {
     }
 }
 export default CallEdgeResolver;
-//# sourceMappingURL=CallEdgeResolver.js.map

package/dist/lib/core/analysis/CallGraphAnalyzer.d.ts

@@ -92,25 +92,18 @@ interface CallSite {
 type DataFlowEdge = import('./DataFlowInferrer.js').DataFlowEdge;
 export declare class CallGraphAnalyzer {
     projectRoot: string;
-    /**
-     * @param {string} projectRoot
-     */
     constructor(projectRoot: string);
     /**
      * 执行完整的调用图分析
      *
-     * @param {object} astProjectSummary - analyzeProject() 的输出 (需包含 callSites)
-     * @param {AnalyzeOptions} [options]
-     * @returns {Promise<CallGraphResult>}
+     * @param astProjectSummary analyzeProject() 的输出 (需包含 callSites)
      */
     analyze(astProjectSummary: AstProjectSummary, options?: AnalyzeOptions): Promise<CallGraphResult>;
     /**
      * 增量分析 — 仅重新分析变更文件及其依赖方
      *
-     * @param {object} astProjectSummary - analyzeProject() 的全量输出
-     * @param {string[]} changedFiles 变更文件的相对路径列表
-     * @param {AnalyzeOptions} [options]
-     * @returns {Promise<CallGraphResult>}
+     * @param astProjectSummary analyzeProject() 的全量输出
+     * @param changedFiles 变更文件的相对路径列表
      */
     analyzeIncremental(astProjectSummary: AstProjectSummary, changedFiles: string[], options?: AnalyzeOptions): Promise<CallGraphResult>;
     /**
@@ -125,15 +118,10 @@ export declare class CallGraphAnalyzer {
      * 渐进式超时 (§13 Issue #15):
      *   每处理完一个文件检查 deadline，超时时返回已有的 partial result
      *
-     * @param {object} astProjectSummary
-     * @param {number} maxCallSitesPerFile
-     * @param {number} deadline - Date.now() + timeout
+     * @param deadline Date.now() + timeout
      */
     _doAnalyze(astProjectSummary: AstProjectSummary, maxCallSitesPerFile: number, deadline: number): Promise<CallGraphResult>;
-    /**
-     * @private 空结果
-     */
+    /** @private 空结果 */
     _emptyResult(durationMs: number): CallGraphResult;
 }
 export default CallGraphAnalyzer;
-//# sourceMappingURL=CallGraphAnalyzer.d.ts.map

package/dist/lib/core/analysis/CallGraphAnalyzer.js

@@ -18,18 +18,13 @@ import { ImportPathResolver } from './ImportPathResolver.js';
 import { SymbolTableBuilder } from './SymbolTableBuilder.js';
 export class CallGraphAnalyzer {
     projectRoot;
-    /**
-     * @param {string} projectRoot
-     */
     constructor(projectRoot) {
         this.projectRoot = projectRoot;
     }
     /**
      * 执行完整的调用图分析
      *
-     * @param {object} astProjectSummary - analyzeProject() 的输出 (需包含 callSites)
-     * @param {AnalyzeOptions} [options]
-     * @returns {Promise<CallGraphResult>}
+     * @param astProjectSummary analyzeProject() 的输出 (需包含 callSites)
      */
     async analyze(astProjectSummary, options = {}) {
         const t0 = Date.now();
@@ -47,10 +42,8 @@ export class CallGraphAnalyzer {
     /**
      * 增量分析 — 仅重新分析变更文件及其依赖方
      *
-     * @param {object} astProjectSummary - analyzeProject() 的全量输出
-     * @param {string[]} changedFiles 变更文件的相对路径列表
-     * @param {AnalyzeOptions} [options]
-     * @returns {Promise<CallGraphResult>}
+     * @param astProjectSummary analyzeProject() 的全量输出
+     * @param changedFiles 变更文件的相对路径列表
      */
     async analyzeIncremental(astProjectSummary, changedFiles, options = {}) {
         const t0 = Date.now();
@@ -162,9 +155,7 @@ export class CallGraphAnalyzer {
      * 渐进式超时 (§13 Issue #15):
      *   每处理完一个文件检查 deadline，超时时返回已有的 partial result
      *
-     * @param {object} astProjectSummary
-     * @param {number} maxCallSitesPerFile
-     * @param {number} deadline - Date.now() + timeout
+     * @param deadline Date.now() + timeout
      */
     async _doAnalyze(astProjectSummary, maxCallSitesPerFile, deadline) {
         const fileCount = astProjectSummary.fileSummaries.length;
@@ -255,9 +246,7 @@ export class CallGraphAnalyzer {
         };
         return { callEdges: allCallEdges, dataFlowEdges, stats };
     }
-    /**
-     * @private 空结果
-     */
+    /** @private 空结果 */
     _emptyResult(durationMs) {
         return {
             callEdges: [],
@@ -275,11 +264,7 @@ export class CallGraphAnalyzer {
     }
 }
 // ── 分级降级辅助 ──────────────────────────────────────────
-/**
- * 根据文件数量确定分析层级
- * @param {number} fileCount
- * @returns {'full-cha'|'full'|'sampled'|'import-only'}
- */
+/** 根据文件数量确定分析层级 */
 function _computeTier(fileCount) {
     if (fileCount < 100) {
         return 'full-cha';
@@ -292,12 +277,7 @@ function _computeTier(fileCount) {
     }
     return 'import-only';
 }
-/**
- * 抽样核心文件 — 优先选取 src/、lib/、app/、core/ 等核心目录
- * @param {object[]} fileSummaries
- * @param {number} limit
- * @returns {object[]}
- */
+/** 抽样核心文件 — 优先选取 src/、lib/、app/、core/ 等核心目录 */
 function _sampleCoreFiles(fileSummaries, limit) {
     const CORE_DIRS = /\/(src|lib|app|core|pkg|internal|domain|service|controller|handler|api)\//i;
     const scored = fileSummaries.map((f) => ({
@@ -310,4 +290,3 @@ function _sampleCoreFiles(fileSummaries, limit) {
     return scored.slice(0, limit).map((s) => s.f);
 }
 export default CallGraphAnalyzer;
-//# sourceMappingURL=CallGraphAnalyzer.js.map

package/dist/lib/core/analysis/CallSiteExtractor.d.ts

@@ -15,18 +15,6 @@
  *   - Python (P0)
  *   - Go / Java / Kotlin (P1 — via lang plugin extractCallSites)
  */
-/**
- * @typedef {object} CallSite
- * @property {string} callee 被调用者名称 (尽可能 qualified)
- * @property {string} callerMethod 调用者所在函数
- * @property {string|null} callerClass 调用者所在类
- * @property {'function'|'method'|'constructor'|'super'|'static'} callType
- * @property {string|null} receiver 接收者对象
- * @property {string|null} receiverType 接收者推断类型
- * @property {number} argCount 参数数量
- * @property {number} line 行号
- * @property {boolean} isAwait 是否 await
- */
 interface WalkerContext {
     callSites: CallSiteInfo[];
     [key: string]: unknown;
@@ -47,33 +35,24 @@ export interface CallSiteInfo {
  * 使用 post-walk 策略，遍历已由 walker 收集的 methods/classes 来定位方法体，
  * 然后从方法体中递归提取 call_expression / new_expression。
  *
- * @param {TreeSitterNode} root - AST root 节点
- * @param {object} ctx - walker context (含 classes, methods, callSites, references 等)
- * @param {string} lang 语言标识
+ * @param root AST root 节点
+ * @param ctx walker context (含 classes, methods, callSites, references 等)
+ * @param lang 语言标识
  */
 export declare function extractCallSitesTS(root: TreeSitterNode, ctx: WalkerContext, lang: string): void;
 /**
  * 从 Python AST root 中提取所有调用点
  *
- * @param {TreeSitterNode} root - AST root 节点
- * @param {object} ctx - walker context
- * @param {string} lang 语言标识
+ * @param root AST root 节点
+ * @param ctx walker context
+ * @param lang 语言标识
  */
 export declare function extractCallSitesPython(root: TreeSitterNode, ctx: WalkerContext, lang: string): void;
-/**
- * 获取特定语言的 CallSite 提取器
- * @param {string} lang
- * @returns {((root: TreeSitterNode, ctx: object, lang: string) => void)|null}
- */
+/** 获取特定语言的 CallSite 提取器 */
 export declare function getCallSiteExtractor(lang: string): typeof extractCallSitesTS | null;
 /**
  * 默认的 CallSite 提取器 — 用于无专门提取器的语言
  * 使用通用的 call_expression 匹配策略
- *
- * @param {TreeSitterNode} root
- * @param {object} ctx
- * @param {string} lang
  */
 export declare function defaultExtractCallSites(root: TreeSitterNode, ctx: WalkerContext, lang: string): void;
 export {};
-//# sourceMappingURL=CallSiteExtractor.d.ts.map

package/dist/lib/core/analysis/CallSiteExtractor.js

@@ -21,9 +21,9 @@
  * 使用 post-walk 策略，遍历已由 walker 收集的 methods/classes 来定位方法体，
  * 然后从方法体中递归提取 call_expression / new_expression。
  *
- * @param {TreeSitterNode} root - AST root 节点
- * @param {object} ctx - walker context (含 classes, methods, callSites, references 等)
- * @param {string} lang 语言标识
+ * @param root AST root 节点
+ * @param ctx walker context (含 classes, methods, callSites, references 等)
+ * @param lang 语言标识
  */
 export function extractCallSitesTS(root, ctx, lang) {
     // 收集所有 function/method body 节点与其上下文
@@ -37,8 +37,7 @@ export function extractCallSitesTS(root, ctx, lang) {
  * 遍历 AST 找到 function_declaration / method_definition / arrow_function 等，
  * 以及它们对应的 statement_block 和上下文信息。
  *
- * @param {TreeSitterNode} root
- * @returns {Array<{ body: TreeSitterNode, className: string|null, methodName: string }>}
+ * @returns >}
  */
 function _collectTSScopes(root) {
     const scopes = [];
@@ -115,10 +114,10 @@ function _collectTSScopes(root) {
 /**
  * 从方法体中递归提取调用点
  *
- * @param {TreeSitterNode} bodyNode - statement_block 节点
- * @param {string|null} className 所在类名
- * @param {string} methodName 所在方法名
- * @param {object} ctx - walker context
+ * @param bodyNode statement_block 节点
+ * @param className 所在类名
+ * @param methodName 所在方法名
+ * @param ctx walker context
  */
 function _extractCallSitesFromBody(bodyNode, className, methodName, ctx) {
     if (!bodyNode) {
@@ -238,11 +237,10 @@ function _extractCallSitesFromBody(bodyNode, className, methodName, ctx) {
 /**
  * 解析 TS/JS 的 call_expression 节点
  *
- * @param {TreeSitterNode} node - call_expression 节点
- * @param {string|null} className 所在类名
- * @param {string} methodName 所在方法名
- * @param {boolean} isAwaited 是否被 await
- * @returns {CallSite|null}
+ * @param node call_expression 节点
+ * @param className 所在类名
+ * @param methodName 所在方法名
+ * @param isAwaited 是否被 await
  */
 function _parseTSCallExpression(node, className, methodName, isAwaited) {
     const func = node.namedChildren[0]; // call_expression 的第一个子节点是被调用者
@@ -314,9 +312,9 @@ function _parseTSCallExpression(node, className, methodName, isAwaited) {
 /**
  * 从 Python AST root 中提取所有调用点
  *
- * @param {TreeSitterNode} root - AST root 节点
- * @param {object} ctx - walker context
- * @param {string} lang 语言标识
+ * @param root AST root 节点
+ * @param ctx walker context
+ * @param lang 语言标识
  */
 export function extractCallSitesPython(root, ctx, lang) {
     const scopes = _collectPyScopes(root);
@@ -327,8 +325,7 @@ export function extractCallSitesPython(root, ctx, lang) {
 /**
  * 收集 Python 中所有函数/方法作用域
  *
- * @param {TreeSitterNode} root
- * @returns {Array<{ body: TreeSitterNode, className: string|null, methodName: string }>}
+ * @returns >}
  */
 function _collectPyScopes(root) {
     const scopes = [];
@@ -391,10 +388,7 @@ function _collectPyScopes(root) {
 /**
  * 从 Python 方法体中递归提取调用点
  *
- * @param {TreeSitterNode} bodyNode - block 节点
- * @param {string|null} className
- * @param {string} methodName
- * @param {object} ctx
+ * @param bodyNode block 节点
  */
 function _extractPyCallSitesFromBody(bodyNode, className, methodName, ctx) {
     if (!bodyNode) {
@@ -444,11 +438,7 @@ function _extractPyCallSitesFromBody(bodyNode, className, methodName, ctx) {
 /**
  * 解析 Python 的 call 节点
  *
- * @param {TreeSitterNode} node - call 节点
- * @param {string|null} className
- * @param {string} methodName
- * @param {boolean} isAwaited
- * @returns {CallSite|null}
+ * @param node call 节点
  */
 function _parsePyCallExpression(node, className, methodName, isAwaited) {
     // Python call 节点: function 是第一个 named child
@@ -520,37 +510,26 @@ function _parsePyCallExpression(node, className, methodName, isAwaited) {
     };
 }
 // ── 通用提取器注册 ─────────────────────────────────────────
-/** @type {Map<string, (root, ctx, lang) => void>} */
 const _extractors = new Map([
     ['typescript', extractCallSitesTS],
     ['tsx', extractCallSitesTS],
     ['javascript', extractCallSitesTS],
     ['python', extractCallSitesPython],
 ]);
-/**
- * 获取特定语言的 CallSite 提取器
- * @param {string} lang
- * @returns {((root: TreeSitterNode, ctx: object, lang: string) => void)|null}
- */
+/** 获取特定语言的 CallSite 提取器 */
 export function getCallSiteExtractor(lang) {
     return _extractors.get(lang) || null;
 }
 /**
  * 默认的 CallSite 提取器 — 用于无专门提取器的语言
  * 使用通用的 call_expression 匹配策略
- *
- * @param {TreeSitterNode} root
- * @param {object} ctx
- * @param {string} lang
  */
 export function defaultExtractCallSites(root, ctx, lang) {
     // 对于未适配的语言，暂不提取（降级为空）
     // Phase 5.1 将逐步增加 Go / Rust / Java / Kotlin 等
 }
 // ── 工具函数 ───────────────────────────────────────────────
-/**
- * 计算参数数量 (TS/JS)
- */
+/** 计算参数数量 (TS/JS) */
 function _countArgs(node) {
     const args = node.namedChildren.find((c) => c.type === 'arguments');
     if (!args) {
@@ -558,9 +537,7 @@ function _countArgs(node) {
     }
     return args.namedChildCount;
 }
-/**
- * 计算参数数量 (Python)
- */
+/** 计算参数数量 (Python) */
 function _countPyArgs(node) {
     const args = node.namedChildren.find((c) => c.type === 'argument_list');
     if (!args) {
@@ -568,13 +545,7 @@ function _countPyArgs(node) {
     }
     return args.namedChildCount;
 }
-/**
- * 判断是否为噪声调用（内置/console/日志等，不产生有意义的调用边）
- *
- * @param {string} callee
- * @param {string|null} receiver
- * @returns {boolean}
- */
+/** 判断是否为噪声调用（内置/console/日志等，不产生有意义的调用边） */
 function _isNoiseCall(callee, receiver) {
     // 常见内置调用噪声
     const NOISE_RECEIVERS = new Set([
@@ -651,4 +622,3 @@ function _isNoiseCall(callee, receiver) {
     }
     return false;
 }
-//# sourceMappingURL=CallSiteExtractor.js.map

package/dist/lib/core/analysis/DataFlowInferrer.d.ts

@@ -17,21 +17,8 @@ export interface DataFlowEdge {
     confidence?: number;
     [key: string]: unknown;
 }
-/**
- * @typedef {object} DataFlowEdge
- * @property {string} from 源 FQN
- * @property {string} to 目标 FQN
- * @property {'argument'|'return-value'} flowType
- * @property {'forward'|'backward'} direction
- */
 export declare class DataFlowInferrer {
-    /**
-     * 从已解析的调用边推断数据流边
-     *
-     * @param {import('./CallEdgeResolver.js').ResolvedEdge[]} resolvedEdges
-     * @returns {DataFlowEdge[]}
-     */
+    /** 从已解析的调用边推断数据流边 */
     static infer(resolvedEdges: ResolvedEdge[]): DataFlowEdge[];
 }
 export default DataFlowInferrer;
-//# sourceMappingURL=DataFlowInferrer.d.ts.map

package/dist/lib/core/analysis/DataFlowInferrer.js

@@ -8,22 +8,9 @@
  *
  * Phase 5.0 只实现 L0 + L1，L2/L3 (参数级/语句级) 留待 Phase 5.2。
  */
-/**
- * @typedef {object} DataFlowEdge
- * @property {string} from 源 FQN
- * @property {string} to 目标 FQN
- * @property {'argument'|'return-value'} flowType
- * @property {'forward'|'backward'} direction
- */
 export class DataFlowInferrer {
-    /**
-     * 从已解析的调用边推断数据流边
-     *
-     * @param {import('./CallEdgeResolver.js').ResolvedEdge[]} resolvedEdges
-     * @returns {DataFlowEdge[]}
-     */
+    /** 从已解析的调用边推断数据流边 */
     static infer(resolvedEdges) {
-        /** @type {DataFlowEdge[]} */
         const dataFlowEdges = [];
         for (const edge of resolvedEdges) {
             // 仅当调用有参数时生成正向数据流 (参数从 caller 流向 callee)
@@ -49,4 +36,3 @@ export class DataFlowInferrer {
     }
 }
 export default DataFlowInferrer;
-//# sourceMappingURL=DataFlowInferrer.js.map

package/dist/lib/core/analysis/ImportPathResolver.d.ts

@@ -21,39 +21,31 @@ export declare class ImportPathResolver {
     }>;
     projectRoot: string;
     /**
-     * @param {string} projectRoot 项目根目录
-     * @param {string[]} allFiles 项目内所有文件的相对路径
+     * @param projectRoot 项目根目录
+     * @param allFiles 项目内所有文件的相对路径
      */
     constructor(projectRoot: string, allFiles: string[]);
     /**
      * 从 tsconfig.json 加载 paths alias 配置
-     * @param {string} projectRoot
      * @private
      */
     _loadTsconfigPaths(projectRoot: string): void;
     /**
      * 解析 import 路径到项目文件
      *
-     * @param {string} importPath 如 "./UserRepo" 或 "../shared/utils"
-     * @param {string} importerFile 当前文件路径 (相对路径)
-     * @returns {string|null} 解析后的文件路径 (相对) 或 null (外部依赖)
+     * @param importPath 如 "./UserRepo" 或 "../shared/utils"
+     * @param importerFile 当前文件路径 (相对路径)
+     * @returns 解析后的文件路径 (相对) 或 null (外部依赖)
      */
     resolve(importPath: string | {
         toString(): string;
     }, importerFile: string): string | null | undefined;
     /**
      * 尝试通过 tsconfig paths alias 解析
-     * @param {string} importPath
-     * @returns {string|null}
      * @private
      */
     _resolveAlias(importPath: string): string | null;
-    /**
-     * 判断是否为外部依赖
-     * @param {string} importPath
-     * @returns {boolean}
-     */
+    /** 判断是否为外部依赖 */
     _isExternal(importPath: string): boolean;
 }
 export default ImportPathResolver;
-//# sourceMappingURL=ImportPathResolver.d.ts.map

package/dist/lib/core/analysis/ImportPathResolver.js

@@ -20,8 +20,8 @@ export class ImportPathResolver {
     pathAliases;
     projectRoot;
     /**
-     * @param {string} projectRoot 项目根目录
-     * @param {string[]} allFiles 项目内所有文件的相对路径
+     * @param projectRoot 项目根目录
+     * @param allFiles 项目内所有文件的相对路径
      */
     constructor(projectRoot, allFiles) {
         this.projectRoot = projectRoot;
@@ -58,7 +58,6 @@ export class ImportPathResolver {
     }
     /**
      * 从 tsconfig.json 加载 paths alias 配置
-     * @param {string} projectRoot
      * @private
      */
     _loadTsconfigPaths(projectRoot) {
@@ -104,9 +103,9 @@ export class ImportPathResolver {
     /**
      * 解析 import 路径到项目文件
      *
-     * @param {string} importPath 如 "./UserRepo" 或 "../shared/utils"
-     * @param {string} importerFile 当前文件路径 (相对路径)
-     * @returns {string|null} 解析后的文件路径 (相对) 或 null (外部依赖)
+     * @param importPath 如 "./UserRepo" 或 "../shared/utils"
+     * @param importerFile 当前文件路径 (相对路径)
+     * @returns 解析后的文件路径 (相对) 或 null (外部依赖)
      */
     resolve(importPath, importerFile) {
         const pathStr = String(importPath);
@@ -141,8 +140,6 @@ export class ImportPathResolver {
     }
     /**
      * 尝试通过 tsconfig paths alias 解析
-     * @param {string} importPath
-     * @returns {string|null}
      * @private
      */
     _resolveAlias(importPath) {
@@ -159,11 +156,7 @@ export class ImportPathResolver {
         }
         return null;
     }
-    /**
-     * 判断是否为外部依赖
-     * @param {string} importPath
-     * @returns {boolean}
-     */
+    /** 判断是否为外部依赖 */
     _isExternal(importPath) {
         // 相对路径不是外部
         if (importPath.startsWith('.') || importPath.startsWith('/')) {
@@ -186,4 +179,3 @@ export class ImportPathResolver {
     }
 }
 export default ImportPathResolver;
-//# sourceMappingURL=ImportPathResolver.js.map

package/dist/lib/core/analysis/ImportRecord.d.ts

@@ -30,12 +30,11 @@ export declare class ImportRecord {
     path: string;
     symbols: string[];
     /**
-     * @param {string} path 导入路径原始字符串
-     * @param {object} [meta]
-     * @param {string[]} [meta.symbols] 导入的符号名 e.g. ['UserRepo', 'findById'] 或 ['*']
-     * @param {string|null} [meta.alias] 导入别名 e.g. import { UserRepo as Repo }
-     * @param {'named'|'default'|'namespace'|'side-effect'} [meta.kind] 导入方式
-     * @param {boolean} [meta.isTypeOnly] 是否为类型导入 (TypeScript)
+     * @param path 导入路径原始字符串
+     * @param [meta.symbols] 导入的符号名 e.g. ['UserRepo', 'findById'] 或 ['*']
+     * @param [meta.alias] 导入别名 e.g. import { UserRepo as Repo }
+     * @param [meta.kind] 导入方式
+     * @param [meta.isTypeOnly] 是否为类型导入 (TypeScript)
      */
     constructor(path: string, meta?: ImportRecordMeta);
     toString(): string;
@@ -52,12 +51,7 @@ export declare class ImportRecord {
     valueOf(): string;
     /** 是否具有结构化符号信息 */
     get isStructured(): boolean;
-    /**
-     * 检查是否导入了指定符号名
-     * @param {string} symbolName
-     * @returns {boolean}
-     */
+    /** 检查是否导入了指定符号名 */
     hasSymbol(symbolName: string): boolean;
 }
 export default ImportRecord;
-//# sourceMappingURL=ImportRecord.d.ts.map