autosnippet 3.2.16 → 3.2.18

package/dist/lib/cli/KnowledgeSyncService.js

@@ -24,9 +24,6 @@ export class KnowledgeSyncService {
     logger;
     projectRoot;
     recipesDir;
-    /**
-     * @param {string} projectRoot
-     */
     constructor(projectRoot) {
         this.projectRoot = projectRoot;
         this.recipesDir = path.join(projectRoot, RECIPES_DIR);
@@ -38,12 +35,11 @@ export class KnowledgeSyncService {
      *
      * 同时扫描 candidates/ 和 recipes/ 两个目录。
      *
-     * @param {import('better-sqlite3').Database} db  better-sqlite3 原始句柄
-     * @param {Object}  [opts={}]
-     * @param {boolean} [opts.dryRun=false]        只报告不写入
-     * @param {boolean} [opts.force=false]         忽略 hash，强制覆盖
-     * @param {boolean} [opts.skipViolations=false] 跳过违规记录（setup 场景）
-     * @returns {{ synced: number, created: number, updated: number, violations: string[], orphaned: string[], skipped: number }}
+     * @param db better-sqlite3 原始句柄
+     * @param [opts.dryRun=false] 只报告不写入
+     * @param [opts.force=false] 忽略 hash，强制覆盖
+     * @param [opts.skipViolations=false] 跳过违规记录（setup 场景）
+     * @returns }
      */
     sync(db, opts = {}) {
         const { dryRun = false, force = false, skipViolations = false } = opts;
@@ -125,9 +121,9 @@ export class KnowledgeSyncService {
     /* ═══ 文件收集 ═══════════════════════════════════════════ */
     /**
      * 递归收集指定目录下所有 .md 文件（跳过 _ 前缀模板）
-     * @param {string} dir    绝对目录路径
-     * @param {string} prefix 相对路径前缀 (e.g. 'AutoSnippet/candidates')
-     * @returns {{ absPath: string, relPath: string }[]}
+     * @param dir 绝对目录路径
+     * @param prefix 相对路径前缀 (e.g. 'AutoSnippet/candidates')
+     * @returns []}
      */
     _collectMdFiles(dir, prefix) {
         if (!fs.existsSync(dir)) {
@@ -208,9 +204,7 @@ export class KnowledgeSyncService {
             contentHash: contentHash,
         };
     }
-    /**
-     * 准备 upsert 语句（INSERT ... ON CONFLICT DO UPDATE 全字段）
-     */
+    /** 准备 upsert 语句（INSERT ... ON CONFLICT DO UPDATE 全字段） */
     _prepareUpsert(db) {
         const cols = [
             'id',
@@ -269,9 +263,7 @@ export class KnowledgeSyncService {
     `;
         return db.prepare(sql);
     }
-    /**
-     * 检查 entry 是否已存在于 DB
-     */
+    /** 检查 entry 是否已存在于 DB */
     _entryExists(db, id) {
         const row = db.prepare('SELECT 1 FROM knowledge_entries WHERE id = ?').get(id);
         return !!row;
@@ -302,7 +294,7 @@ export class KnowledgeSyncService {
     /* ═══ 孤儿检测 ═══════════════════════════════════════════ */
     /**
      * 检测 DB 中存在但 .md 已删除的 Entry → 标记 deprecated
-     * @returns {string[]} 孤儿 entry id 列表
+     * @returns 孤儿 entry id 列表
      */
     _detectOrphans(db, syncedIds, dryRun) {
         const orphanIds = [];
@@ -335,4 +327,3 @@ export class KnowledgeSyncService {
     }
 }
 export default KnowledgeSyncService;
-//# sourceMappingURL=KnowledgeSyncService.js.map

package/dist/lib/cli/SetupService.d.ts

@@ -197,4 +197,3 @@ export declare class SetupService {
     }>;
 }
 export default SetupService;
-//# sourceMappingURL=SetupService.d.ts.map

package/dist/lib/cli/SetupService.js

@@ -695,4 +695,3 @@ export class SetupService {
     }
 }
 export default SetupService;
-//# sourceMappingURL=SetupService.js.map

package/dist/lib/cli/UpgradeService.d.ts

@@ -27,4 +27,3 @@ export declare class UpgradeService {
     _migrateSkillsPath(): void;
 }
 export default UpgradeService;
-//# sourceMappingURL=UpgradeService.d.ts.map

package/dist/lib/cli/UpgradeService.js

@@ -81,4 +81,3 @@ export class UpgradeService {
     }
 }
 export default UpgradeService;
-//# sourceMappingURL=UpgradeService.js.map

package/dist/lib/cli/deploy/FileDeployer.d.ts

@@ -35,18 +35,15 @@ export declare class FileDeployer {
     force: boolean;
     projectName: string;
     projectRoot: string;
-    /**
-     * @param {{ projectRoot: string, force?: boolean }} options
-     */
+    /** @param {{ projectRoot: string, force?: boolean }} options */
     constructor({ projectRoot, force }: {
         projectRoot: string;
         force?: boolean;
     });
     /**
      * 部署所有适用的文件
-     * @param {'setup'|'upgrade'} mode
      * @param {{ filter?: string[] }} options 可选过滤部署的 category
-     * @returns {{ deployed: string[], skipped: string[], errors: Array<{id: string, error: string}> }}
+     * @returns > }}
      */
     deployAll(mode: 'setup' | 'upgrade', { filter }?: {
         filter?: string[];
@@ -58,11 +55,7 @@ export declare class FileDeployer {
             error: string;
         }[];
     };
-    /**
-     * 按 category 部署
-     * @param {string} category
-     * @param {'setup'|'upgrade'} mode
-     */
+    /** 按 category 部署 */
     deployCategory(category: string, mode: 'setup' | 'upgrade'): {
         deployed: string[];
         skipped: string[];
@@ -72,9 +65,8 @@ export declare class FileDeployer {
         }[];
     };
     /**
-     * @param {object} entry - Manifest 条目
-     * @param {'setup'|'upgrade'} mode
-     * @returns {boolean} 是否实际写入了文件
+     * @param entry Manifest 条目
+     * @returns 是否实际写入了文件
      */
     _deployOne(entry: ManifestEntry, mode: 'setup' | 'upgrade'): boolean;
     /** overwrite — AutoSnippet 完全拥有，始终覆盖 */
@@ -105,4 +97,3 @@ export declare class FileDeployer {
     _triggerCursorDeliveryAsync(): Promise<void>;
 }
 export default FileDeployer;
-//# sourceMappingURL=FileDeployer.d.ts.map

package/dist/lib/cli/deploy/FileDeployer.js

@@ -19,7 +19,7 @@ import { execSync } from 'node:child_process';
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync, } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { injectAutoApprove } from '../../external/mcp/autoApproveInjector.js';
-import { checkWriteSafety, safeCopyFile } from '../../service/cursor/FileProtection.js';
+import { checkWriteSafety, safeCopyFile } from '../../service/delivery/FileProtection.js';
 import { DEFAULT_KNOWLEDGE_BASE_DIR } from '../../shared/ProjectMarkers.js';
 import { PACKAGE_ROOT, TEMPLATES_DIR } from '../../shared/package-root.js';
 import { buildMcpServerEntry, GITIGNORE_MIGRATIONS, GITIGNORE_RULES, MANIFEST, } from './FileManifest.js';
@@ -29,9 +29,7 @@ export class FileDeployer {
     force;
     projectName;
     projectRoot;
-    /**
-     * @param {{ projectRoot: string, force?: boolean }} options
-     */
+    /** @param {{ projectRoot: string, force?: boolean }} options */
     constructor({ projectRoot, force = false }) {
         this.projectRoot = resolve(projectRoot);
         this.projectName = this.projectRoot.split('/').pop() || '';
@@ -40,9 +38,8 @@ export class FileDeployer {
     /* ═══ 公共入口 ═══════════════════════════════════════ */
     /**
      * 部署所有适用的文件
-     * @param {'setup'|'upgrade'} mode
      * @param {{ filter?: string[] }} options 可选过滤部署的 category
-     * @returns {{ deployed: string[], skipped: string[], errors: Array<{id: string, error: string}> }}
+     * @returns > }}
      */
     deployAll(mode, { filter } = {}) {
         const applicable = MANIFEST.filter((entry) => {
@@ -73,19 +70,14 @@ export class FileDeployer {
         }
         return { deployed, skipped, errors };
     }
-    /**
-     * 按 category 部署
-     * @param {string} category
-     * @param {'setup'|'upgrade'} mode
-     */
+    /** 按 category 部署 */
     deployCategory(category, mode) {
         return this.deployAll(mode, { filter: [category] });
     }
     /* ═══ 单文件部署路由 ═════════════════════════════════ */
     /**
-     * @param {object} entry - Manifest 条目
-     * @param {'setup'|'upgrade'} mode
-     * @returns {boolean} 是否实际写入了文件
+     * @param entry Manifest 条目
+     * @returns 是否实际写入了文件
      */
     _deployOne(entry, mode) {
         switch (entry.strategy) {
@@ -542,4 +534,3 @@ export class FileDeployer {
     }
 }
 export default FileDeployer;
-//# sourceMappingURL=FileDeployer.js.map

package/dist/lib/cli/deploy/FileManifest.d.ts

@@ -183,18 +183,12 @@ export declare const GITIGNORE_RULES: ({
     comment?: undefined;
     negation?: undefined;
 })[];
-/**
- * .gitignore 迁移规则 — 升级时清理旧格式
- */
+/** .gitignore 迁移规则 — 升级时清理旧格式 */
 export declare const GITIGNORE_MIGRATIONS: {
     find: RegExp;
     replace: string;
 }[];
-/**
- * MCP Server 配置生成器
- * @param {string} projectRoot
- * @param {'cursor'|'vscode'} ide
- */
+/** MCP Server 配置生成器 */
 export declare function buildMcpServerEntry(projectRoot: string, ide: 'cursor' | 'vscode'): {
     command: string;
     env: {
@@ -207,4 +201,3 @@ export declare function buildMcpServerEntry(projectRoot: string, ide: 'cursor' |
     };
     type: string;
 };
-//# sourceMappingURL=FileManifest.d.ts.map

package/dist/lib/cli/deploy/FileManifest.js

@@ -226,20 +226,14 @@ export const GITIGNORE_RULES = [
     { pattern: 'nohup.out' },
     { pattern: '*.sw[a-p]' },
 ];
-/**
- * .gitignore 迁移规则 — 升级时清理旧格式
- */
+/** .gitignore 迁移规则 — 升级时清理旧格式 */
 export const GITIGNORE_MIGRATIONS = [
     // v2.4.0: ".autosnippet/" → ".autosnippet/*"
     { find: /^\.autosnippet\/$/m, replace: '.autosnippet/*' },
     // Skills 已迁移到 AutoSnippet/skills/，清理旧 negation
     { find: /^!?\.autosnippet\/skills\/.*\n?/gm, replace: '' },
 ];
-/**
- * MCP Server 配置生成器
- * @param {string} projectRoot
- * @param {'cursor'|'vscode'} ide
- */
+/** MCP Server 配置生成器 */
 export function buildMcpServerEntry(projectRoot, ide) {
     const base = {
         command: 'asd-mcp',
@@ -250,4 +244,3 @@ export function buildMcpServerEntry(projectRoot, ide) {
     }
     return base;
 }
-//# sourceMappingURL=FileManifest.js.map

package/dist/lib/core/AstAnalyzer.d.ts

@@ -185,46 +185,33 @@ interface ProjectAnalysisResult {
 }
 /**
  * 注册语言 AST 插件
- * @param {string} langId 语言标识 (e.g. 'objectivec', 'swift', 'typescript')
- * @param {LangPlugin} plugin
+ * @param langId 语言标识 (e.g. 'objectivec', 'swift', 'typescript')
  */
 export declare function registerLanguage(langId: string, plugin: LangPlugin): void;
 /**
  * 分析单个源文件，返回结构化 AST 摘要
- * @param {string} source  源代码文本
- * @param {string} lang    语言标识 'objectivec' | 'swift' | 'typescript' | 'javascript' | 'python' | 'java' | 'kotlin' | 'go' | 'dart' | 'rust' | 'tsx'
- * @param {object} [options]
- * @param {boolean} [options.extractCallSites=true] 是否提取调用点 (Phase 5)
- * @returns {AstSummary | null}
+ * @param source 源代码文本
+ * @param lang 语言标识 'objectivec' | 'swift' | 'typescript' | 'javascript' | 'python' | 'java' | 'kotlin' | 'go' | 'dart' | 'rust' | 'tsx'
+ * @param [options.extractCallSites=true] 是否提取调用点 (Phase 5)
  */
 declare function analyzeFile(source: string, lang: string, options?: AnalyzeFileOptions): AstFileSummary | null;
 /**
  * 批量分析多文件，返回项目级汇总
  * @param {{ name: string, relativePath: string, content: string }[]} files
- * @param {string} lang
- * @param {{ preprocessFile?: (content: string, ext: string) => { content: string, lang: string } | null }} [options]
- * @returns {ProjectAstSummary}
+ * @param | null }} [options]
  */
 declare function analyzeProject(files: FileInput[], lang: string, options: AnalyzeProjectOptions): ProjectAnalysisResult;
-/**
- * 为 Agent 生成结构化上下文摘要（Markdown）
- * @param {ProjectAstSummary} projectSummary
- * @returns {string}
- */
+/** 为 Agent 生成结构化上下文摘要（Markdown） */
 declare function generateContextForAgent(projectSummary: ProjectAnalysisResult): string;
-/**
- * 检查 Tree-sitter 是否可用（至少有一个语言插件注册）
- */
+/** 检查 Tree-sitter 是否可用（至少有一个语言插件注册） */
 declare function isAvailable(): boolean;
-/**
- * 获取支持的语言列表
- */
+/** 获取支持的语言列表 */
 declare function supportedLanguages(): string[];
 /**
  * 解析源代码为 AST 树 (供 ASTChunker 等外部模块使用)
- * @param {string} source 源代码
- * @param {string} lang 语言 ID (如 'javascript', 'typescript', 'python' 等)
- * @returns {{ rootNode: object, tree: object } | null} tree-sitter 的 rootNode, 或 null (不支持/解析失败)
+ * @param source 源代码
+ * @param lang 语言 ID (如 'javascript', 'typescript', 'python' 等)
+ * @returns | null} tree-sitter 的 rootNode, 或 null (不支持/解析失败)
  */
 declare function parseToTree(source: string, lang: string): {
     rootNode: TreeSitterNode;
@@ -232,10 +219,10 @@ declare function parseToTree(source: string, lang: string): {
 } | null;
 /**
  * 在 AST 中搜索特定调用表达式
- * @param {string} source  源代码
- * @param {string} lang    'objectivec' | 'swift'
- * @param {string} targetCallee  目标调用，如 'URLSession.shared', 'dispatch_sync'
- * @returns {Array<{ line: number, snippet: string, enclosingClass: string|null }>}
+ * @param source 源代码
+ * @param lang 'objectivec' | 'swift'
+ * @param targetCallee 目标调用，如 'URLSession.shared', 'dispatch_sync'
+ * @returns >}
  */
 declare function findCallExpressions(source: string, lang: string, targetCallee: string): {
     line: number;
@@ -244,13 +231,13 @@ declare function findCallExpressions(source: string, lang: string, targetCallee:
 }[];
 /**
  * 搜索特定模式在特定上下文中的出现
- * @param {string} source  源代码
- * @param {string} lang    'objectivec' | 'swift'
- * @param {string} pattern  要查找的文本模式（普通字符串匹配）
+ * @param source 源代码
+ * @param lang 'objectivec' | 'swift'
+ * @param pattern 要查找的文本模式（普通字符串匹配）
  * @param {{ forbiddenContext?: string, requiredContext?: string }} contextFilter
  *   forbiddenContext: 如果在此上下文中出现则报告 (如 'dealloc')
  *   requiredContext: 如果不在此上下文中出现则报告
- * @returns {Array<{ line: number, snippet: string, context: string|null }>}
+ * @returns >}
  */
 declare function findPatternInContext(source: string, lang: string, pattern: string, contextFilter?: ContextFilter): {
     line: number;
@@ -259,11 +246,11 @@ declare function findPatternInContext(source: string, lang: string, pattern: str
 }[];
 /**
  * 检查类是否遵循指定协议
- * @param {string} source  源代码
- * @param {string} lang    'objectivec' | 'swift'
- * @param {string} className  类名
- * @param {string} protocolName  协议名
- * @returns {{ conforms: boolean, classFound: boolean, classDeclLine: number|null }}
+ * @param source 源代码
+ * @param lang 'objectivec' | 'swift'
+ * @param className 类名
+ * @param protocolName 协议名
+ * @returns }
  */
 declare function checkProtocolConformance(source: string, lang: string, className: string, protocolName: string): {
     conforms: boolean;
@@ -275,4 +262,3 @@ declare function checkProtocolConformance(source: string, lang: string, classNam
     classDeclLine: number | undefined;
 };
 export { analyzeFile, analyzeProject, generateContextForAgent, isAvailable, supportedLanguages, findCallExpressions, findPatternInContext, checkProtocolConformance, parseToTree, };
-//# sourceMappingURL=AstAnalyzer.d.ts.map

package/dist/lib/core/AstAnalyzer.js

@@ -17,19 +17,10 @@ import { getParserClass, isParserReady } from './ast/parser-init.js';
 // ──────────────────────────────────────────────────────────────────
 // 插件注册表
 // ──────────────────────────────────────────────────────────────────
-/**
- * @typedef {object} LangPlugin
- * @property {Function} getGrammar  - () => tree-sitter Language Module (lazy load)
- * @property {Function} walk        - (rootNode, ctx) => void  (AST 遍历)
- * @property {Function} [detectPatterns] - (root, lang, methods, properties, classes) => Pattern[]
- * @property {string[]} [extensions] 关联的文件扩展名
- */
-/** @type {Map<string, LangPlugin>} */
 const _langPlugins = new Map();
 /**
  * 注册语言 AST 插件
- * @param {string} langId 语言标识 (e.g. 'objectivec', 'swift', 'typescript')
- * @param {LangPlugin} plugin
+ * @param langId 语言标识 (e.g. 'objectivec', 'swift', 'typescript')
  */
 export function registerLanguage(langId, plugin) {
     _langPlugins.set(langId, plugin);
@@ -41,11 +32,9 @@ export function registerLanguage(langId, plugin) {
 // ──────────────────────────────────────────────────────────────────
 /**
  * 分析单个源文件，返回结构化 AST 摘要
- * @param {string} source  源代码文本
- * @param {string} lang    语言标识 'objectivec' | 'swift' | 'typescript' | 'javascript' | 'python' | 'java' | 'kotlin' | 'go' | 'dart' | 'rust' | 'tsx'
- * @param {object} [options]
- * @param {boolean} [options.extractCallSites=true] 是否提取调用点 (Phase 5)
- * @returns {AstSummary | null}
+ * @param source 源代码文本
+ * @param lang 语言标识 'objectivec' | 'swift' | 'typescript' | 'javascript' | 'python' | 'java' | 'kotlin' | 'go' | 'dart' | 'rust' | 'tsx'
+ * @param [options.extractCallSites=true] 是否提取调用点 (Phase 5)
  */
 function analyzeFile(source, lang, options = {}) {
     const plugin = _langPlugins.get(lang);
@@ -110,9 +99,7 @@ function analyzeFile(source, lang, options = {}) {
 /**
  * 批量分析多文件，返回项目级汇总
  * @param {{ name: string, relativePath: string, content: string }[]} files
- * @param {string} lang
- * @param {{ preprocessFile?: (content: string, ext: string) => { content: string, lang: string } | null }} [options]
- * @returns {ProjectAstSummary}
+ * @param | null }} [options]
  */
 function analyzeProject(files, lang, options) {
     const fileSummaries = [];
@@ -187,11 +174,7 @@ function analyzeProject(files, lang, options) {
         fileSummaries,
     };
 }
-/**
- * 为 Agent 生成结构化上下文摘要（Markdown）
- * @param {ProjectAstSummary} projectSummary
- * @returns {string}
- */
+/** 为 Agent 生成结构化上下文摘要（Markdown） */
 function generateContextForAgent(projectSummary) {
     const lines = ['## 项目代码结构分析（AST）', ''];
     // 类型声明概览
@@ -265,15 +248,11 @@ function generateContextForAgent(projectSummary) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 检查 Tree-sitter 是否可用（至少有一个语言插件注册）
- */
+/** 检查 Tree-sitter 是否可用（至少有一个语言插件注册） */
 function isAvailable() {
     return isParserReady() && _langPlugins.size > 0;
 }
-/**
- * 获取支持的语言列表
- */
+/** 获取支持的语言列表 */
 function supportedLanguages() {
     return [..._langPlugins.keys()];
 }
@@ -309,9 +288,9 @@ function _getParser(lang) {
 }
 /**
  * 解析源代码为 AST 树 (供 ASTChunker 等外部模块使用)
- * @param {string} source 源代码
- * @param {string} lang 语言 ID (如 'javascript', 'typescript', 'python' 等)
- * @returns {{ rootNode: object, tree: object } | null} tree-sitter 的 rootNode, 或 null (不支持/解析失败)
+ * @param source 源代码
+ * @param lang 语言 ID (如 'javascript', 'typescript', 'python' 等)
+ * @returns | null} tree-sitter 的 rootNode, 或 null (不支持/解析失败)
  */
 function parseToTree(source, lang) {
     const parser = _getParser(lang);
@@ -584,10 +563,10 @@ function _findIdentifier(node) {
 // ──────────────────────────────────────────────────────────────────
 /**
  * 在 AST 中搜索特定调用表达式
- * @param {string} source  源代码
- * @param {string} lang    'objectivec' | 'swift'
- * @param {string} targetCallee  目标调用，如 'URLSession.shared', 'dispatch_sync'
- * @returns {Array<{ line: number, snippet: string, enclosingClass: string|null }>}
+ * @param source 源代码
+ * @param lang 'objectivec' | 'swift'
+ * @param targetCallee 目标调用，如 'URLSession.shared', 'dispatch_sync'
+ * @returns >}
  */
 function findCallExpressions(source, lang, targetCallee) {
     const parser = _getParser(lang);
@@ -651,13 +630,13 @@ function findCallExpressions(source, lang, targetCallee) {
 }
 /**
  * 搜索特定模式在特定上下文中的出现
- * @param {string} source  源代码
- * @param {string} lang    'objectivec' | 'swift'
- * @param {string} pattern  要查找的文本模式（普通字符串匹配）
+ * @param source 源代码
+ * @param lang 'objectivec' | 'swift'
+ * @param pattern 要查找的文本模式（普通字符串匹配）
  * @param {{ forbiddenContext?: string, requiredContext?: string }} contextFilter
  *   forbiddenContext: 如果在此上下文中出现则报告 (如 'dealloc')
  *   requiredContext: 如果不在此上下文中出现则报告
- * @returns {Array<{ line: number, snippet: string, context: string|null }>}
+ * @returns >}
  */
 function findPatternInContext(source, lang, pattern, contextFilter = {}) {
     const parser = _getParser(lang);
@@ -735,11 +714,11 @@ function findPatternInContext(source, lang, pattern, contextFilter = {}) {
 }
 /**
  * 检查类是否遵循指定协议
- * @param {string} source  源代码
- * @param {string} lang    'objectivec' | 'swift'
- * @param {string} className  类名
- * @param {string} protocolName  协议名
- * @returns {{ conforms: boolean, classFound: boolean, classDeclLine: number|null }}
+ * @param source 源代码
+ * @param lang 'objectivec' | 'swift'
+ * @param className 类名
+ * @param protocolName 协议名
+ * @returns }
  */
 function checkProtocolConformance(source, lang, className, protocolName) {
     const summary = analyzeFile(source, lang);
@@ -771,4 +750,3 @@ export { analyzeFile, analyzeProject, generateContextForAgent, isAvailable, supp
 findCallExpressions, findPatternInContext, checkProtocolConformance, 
 // ASTChunker 使用的低级 API
 parseToTree, };
-//# sourceMappingURL=AstAnalyzer.js.map

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

@@ -71,22 +71,17 @@ export declare class CallEdgeResolver {
     propertyTypes: Map<string, Map<string, string>>;
     symbolTable: SymbolTable;
     /**
-     * @param {import('./SymbolTableBuilder.js').SymbolTable} symbolTable
-     * @param {import('./ImportPathResolver.js').ImportPathResolver} importResolver
      * @param {Array<{from: string, to: string, type: string}>} [inheritanceGraph=[]] 继承图边
      */
     constructor(symbolTable: SymbolTable, importResolver: ImportPathResolver, inheritanceGraph?: InheritanceEdge[]);
     /**
      * 解析一个文件中的所有调用点为边
      *
-     * @param {import('./CallSiteExtractor.js').CallSite[]} callSites 来自某个文件的所有调用点
-     * @param {string} callerFile 调用者文件路径 (相对)
-     * @returns {ResolvedEdge[]}
+     * @param callSites 来自某个文件的所有调用点
+     * @param callerFile 调用者文件路径 (相对)
      */
     resolveFile(callSites: CallSite[], callerFile: string): ResolvedEdge[];
-    /**
-     * @private 构建局部 import 映射
-     */
+    /** @private 构建局部 import 映射 */
     _buildImportMap(fileImports: Array<{
         path?: string;
         symbols?: string[];
@@ -96,9 +91,7 @@ export declare class CallEdgeResolver {
         file: string;
         namespace: boolean;
     }>;
-    /**
-     * @private 解析单个调用点
-     */
+    /** @private 解析单个调用点 */
     _resolveCallSite(cs: CallSite, callerFile: string, importedSymbols: Map<string, {
         file: string;
         namespace: boolean;
@@ -109,9 +102,9 @@ export declare 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: string, className: string): string | null;
     /**
@@ -124,22 +117,15 @@ export declare class CallEdgeResolver {
      *   - _userRepo → UserRepo (Java/Kotlin private field)
      *
      * 只在符号表中存在匹配类时返回
-     *
-     * @param {string} fieldName
-     * @returns {string|null}
      */
     _inferFieldType(fieldName: string): string | null;
     /**
      * @private 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
-     * @param {string} name 符号名 (可以是 "ClassName.methodName" 或 "functionName")
-     * @param {string} file
-     * @returns {string[]} 匹配的 FQN 列表
+     * @param name 符号名 (可以是 "ClassName.methodName" 或 "functionName")
+     * @returns 匹配的 FQN 列表
      */
     _findInFile(name: string, file: string): string[];
-    /**
-     * @private 构建 ResolvedEdge
-     */
+    /** @private 构建 ResolvedEdge */
     _makeEdge(callerFqn: string, calleeFqn: string, resolveMethod: string, cs: CallSite, callerFile: string): ResolvedEdge;
 }
 export default CallEdgeResolver;
-//# sourceMappingURL=CallEdgeResolver.d.ts.map