agent-ide 0.8.1 → 0.8.2

package/dist/core/shared/{symbol-finder.d.ts → symbol-finder/symbol-finder.d.ts}

@@ -2,105 +2,45 @@
  * 統一的符號查找器
  * 整合 AST 分析和文字匹配，提供跨檔案符號查找能力
  */
-import type { Range, Location } from '../../shared/types/core.js';
-import { type Symbol } from '../../shared/types/symbol.js';
-import type { ParserRegistry } from '../../infrastructure/parser/registry.js';
-import type { IFileSystem } from '../../infrastructure/storage/file-system.interface.js';
-import type { ScopedFindReferencesOptions } from '../../infrastructure/parser/interface.js';
-/**
- * 符號引用
- */
-export interface SymbolReference {
-    readonly symbolName: string;
-    readonly location: Location;
-    readonly type: SymbolReferenceType;
-    /** 引用所在行的完整程式碼（用於輸出顯示） */
-    readonly context?: string;
-    /** 所屬容器名稱（class、interface 等，用於作用域識別） */
-    readonly containerName?: string;
-    /** 是否為方法呼叫（用於區分同名方法） */
-    readonly isMethodCall?: boolean;
-    /** 呼叫者類型名稱（用於精確匹配方法所屬類別） */
-    readonly receiverType?: string;
-}
-/**
- * 符號引用類型
- */
-export declare enum SymbolReferenceType {
-    Definition = "definition",
-    Usage = "usage",
-    Import = "import",
-    Export = "export"
-}
-/**
- * 函式呼叫點
- */
-export interface CallSite {
-    readonly functionName: string;
-    readonly location: Location;
-    readonly arguments: readonly CallSiteArgument[];
-    readonly isMethodCall: boolean;
-    readonly receiver?: string;
-}
-/**
- * 呼叫點參數
- */
-export interface CallSiteArgument {
-    readonly index: number;
-    readonly name?: string;
-    readonly value: string;
-    readonly range: Range;
-}
-/**
- * 類別成員
- */
-export interface ClassMember {
-    readonly name: string;
-    readonly type: ClassMemberType;
-    readonly location: Location;
-    readonly modifiers: readonly string[];
-    readonly valueType?: string;
-}
-/**
- * 類別成員類型
- */
-export declare enum ClassMemberType {
-    Method = "method",
-    Property = "property",
-    Getter = "getter",
-    Setter = "setter",
-    Constructor = "constructor"
-}
-/**
- * 符號定義
- */
-export interface SymbolDefinition {
-    readonly symbol: Symbol;
-    readonly signature?: string;
-    readonly documentation?: string;
-}
+import { type Symbol } from '../../../shared/types/symbol.js';
+import type { ParserRegistry } from '../../../infrastructure/parser/registry.js';
+import type { IFileSystem } from '../../../infrastructure/storage/file-system.interface.js';
+import type { ScopedFindReferencesOptions } from '../../../infrastructure/parser/interface.js';
+import { type SymbolReference, type CallSite, type ClassMember, type SymbolDefinition } from './types.js';
 /**
  * 符號查找器
  */
 export declare class SymbolFinder {
     private readonly parserRegistry;
     private readonly fileSystem;
+    private readonly textMatcher;
+    private readonly callSiteParser;
     constructor(parserRegistry: ParserRegistry, fileSystem: IFileSystem);
     /**
      * 查找符號定義
      */
     findDefinition(filePath: string, symbolName: string): Promise<SymbolDefinition | null>;
     /**
-     * 批次查找符號的引用（一次遍歷所有檔案，減少重複解析）
-     * 時間複雜度：O(M × N)，M=檔案數，N=符號數
+     * 批次查找符號的引用（使用完整 Symbol 資訊，可區分同名符號）
+     *
+     * 時間複雜度：O(M x N)，M=檔案數，N=符號數
      * 優化點：M 次檔案讀取/解析（一次遍歷 M 檔查找 N 符號），
-     * 而非 N×M 次（N 符號各遍歷 M 檔）
-     */
-    findReferencesMultiple(symbolNames: ReadonlySet<string>, projectFiles: readonly string[]): Promise<Map<string, SymbolReference[]>>;
-    /**
-     * 批次文字匹配查找（降級方法）
+     * 而非 N x M 次（N 符號各遍歷 M 檔）
+     *
+     * @param symbols 要查找的符號陣列（包含完整的作用域資訊）
+     * @param projectFiles 專案檔案列表
+     * @returns Map<序列化的SymbolKey, 引用列表>，可使用 deserializeSymbolKey 還原
+     *
+     * @example
+     * ```typescript
+     * const results = await finder.findReferencesMultiple(symbols, files);
+     * for (const symbol of symbols) {
+     *   const key = serializeSymbolKey(symbolToKey(symbol));
+     *   const refs = results.get(key) ?? [];
+     * }
+     * ```
      */
-    private findReferencesMultipleByText;
+    findReferencesMultiple(symbols: ReadonlyArray<Symbol>, projectFiles: readonly string[]): Promise<Map<string, SymbolReference[]>>;
     /**
      * 查找檔案中的符號引用
      */
@@ -157,10 +97,6 @@ export declare class SymbolFinder {
      * @returns 所有找到的引用
      */
     findScopedReferences(symbolName: string, projectFiles: readonly string[], options?: ScopedFindReferencesOptions): Promise<SymbolReference[]>;
-    /**
-     * 轉換 ScopedReferenceKind 到 SymbolReferenceType
-     */
-    private scopedReferenceKindToType;
     /**
      * 查找函式的所有呼叫點
      */
@@ -186,26 +122,9 @@ export declare class SymbolFinder {
      */
     private getFileExtension;
     /**
-     * 使用文字匹配查找引用（降級方法）
-     */
-    private findReferencesByText;
-    /**
-     * 使用文字匹配查找引用（過濾字串和註解版本）
-     *
-     * 此方法會過濾掉：
-     * 1. 字串字面值中的符號（單引號、雙引號、模板字串）
-     * 2. 單行註解中的符號（// 和 #）
-     * 3. 多行註解中的符號
-     */
-    private findReferencesByTextFiltered;
-    /**
-     * 檢查位置是否在字串字面值中
-     */
-    private isInString;
-    /**
-     * 檢查位置是否在單行註解中
+     * 轉換 ScopedReferenceKind 到 SymbolReferenceType
      */
-    private isInSingleLineComment;
+    private scopedReferenceKindToType;
     /**
      * 提取函式簽名
      */
@@ -215,35 +134,10 @@ export declare class SymbolFinder {
      * 這是 fallback 方法，當 Parser 不支援 getDocumentation 時使用
      */
     private extractDocumentationByLineScanning;
-    /**
-    /**
-     * 提取參數字串（支援多行）
-     * @returns { content: 完整參數字串, endLine: 結束行索引, endColumn: 結束欄位 }
-     */
-    private extractArgumentsStringMultiline;
-    /**
-     * 解析參數（支援多行）
-     */
-    private parseArgumentsMultiline;
-    /**
-    /**
-     * 找到匹配的右括號位置（支援多行）
-     * @returns { line: 行索引, index: 該行的字元索引 }
-     */
-    private findMatchingCloseParenMultiline;
-    /**
-    /**
-     * 分割參數（考慮巢狀括號）
-     */
-    private splitArguments;
     /**
      * 符號類型轉換為成員類型
      */
     private symbolTypeToMemberType;
-    /**
-     * 跳脫正則表達式特殊字元
-     */
-    private escapeRegex;
 }
 /**
  * 建立 SymbolFinder 實例

package/dist/core/shared/symbol-finder/symbol-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-finder.d.ts","sourceRoot":"","sources":["../../../../src/core/shared/symbol-finder/symbol-finder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAGvF,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAG7B,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,WAAW;IAM1C;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA8C5F;;;;;;;;;;;;;;;;;;;OAmBG;IACG,sBAAsB,CAC1B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAkG1C;;OAEG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAuD5F;;;;;;;;;;;OAWG;IACG,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyClG;;;;;;OAMG;IACG,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAa3G;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,0BAA0B,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,eAAe,EAAE,CAAC;IA2C7B;;;;;;;OAOG;IACG,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,eAAe,EAAE,CAAC;IAW7B;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAW/F;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAsBtF;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6CnF;;OAEG;YACW,QAAQ;IAStB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAWjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IA2C1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAW/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,GAAG,YAAY,CAExG"}