agent-ide 0.8.1 → 0.9.0

package/dist/core/shared/symbol-finder/text-matcher.js

@@ -0,0 +1,195 @@
+/**
+ * 文字匹配工具類別
+ * 負責基於文字的符號引用查找（降級方法）
+ */
+import { SymbolReferenceType } from './types.js';
+/**
+ * 文字匹配器
+ * 提供基於正則表達式的符號查找能力
+ */
+export class TextMatcher {
+    /**
+     * 使用文字匹配查找引用（降級方法）
+     */
+    findReferencesByText(filePath, content, symbolName) {
+        const references = [];
+        const lines = content.split('\n');
+        const regex = new RegExp(`\\b${this.escapeRegex(symbolName)}\\b`, 'g');
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex];
+            let match;
+            while ((match = regex.exec(line)) !== null) {
+                const startColumn = match.index + 1;
+                references.push({
+                    symbolName,
+                    location: {
+                        filePath,
+                        range: {
+                            start: { line: lineIndex + 1, column: startColumn },
+                            end: { line: lineIndex + 1, column: startColumn + symbolName.length }
+                        }
+                    },
+                    type: SymbolReferenceType.Usage,
+                    // 保留原始行內容（不 trim），讓 diff 輸出保持正確的縮排
+                    context: line
+                });
+            }
+        }
+        return references;
+    }
+    /**
+     * 使用文字匹配查找引用（過濾字串和註解版本）
+     *
+     * 此方法會過濾掉：
+     * 1. 字串字面值中的符號（單引號、雙引號、模板字串）
+     * 2. 單行註解中的符號（// 和 #）
+     * 3. 多行註解中的符號
+     */
+    findReferencesByTextFiltered(filePath, content, symbolName) {
+        const references = [];
+        const lines = content.split('\n');
+        const regex = new RegExp(`\\b${this.escapeRegex(symbolName)}\\b`, 'g');
+        let inBlockComment = false;
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex];
+            let match;
+            // 追蹤多行註解狀態
+            if (inBlockComment) {
+                const closeCommentIndex = line.indexOf('*/');
+                if (closeCommentIndex >= 0) {
+                    inBlockComment = false;
+                }
+                else {
+                    continue; // 整行在多行註解中，跳過
+                }
+            }
+            while ((match = regex.exec(line)) !== null) {
+                const position = match.index;
+                // 檢查是否在字串中
+                if (this.isInString(line, position)) {
+                    continue;
+                }
+                // 檢查是否在單行註解中
+                if (this.isInSingleLineComment(line, position)) {
+                    continue;
+                }
+                // 檢查是否在多行註解開始後
+                const openCommentIndex = line.lastIndexOf('/*', position);
+                if (openCommentIndex >= 0) {
+                    const closeCommentIndex = line.indexOf('*/', openCommentIndex);
+                    if (closeCommentIndex < 0 || closeCommentIndex > position) {
+                        // 在未關閉的多行註解中
+                        if (closeCommentIndex < 0) {
+                            inBlockComment = true;
+                        }
+                        continue;
+                    }
+                }
+                const startColumn = position + 1;
+                references.push({
+                    symbolName,
+                    location: {
+                        filePath,
+                        range: {
+                            start: { line: lineIndex + 1, column: startColumn },
+                            end: { line: lineIndex + 1, column: startColumn + symbolName.length }
+                        }
+                    },
+                    type: SymbolReferenceType.Usage,
+                    // 保留原始行內容（不 trim），讓 diff 輸出保持正確的縮排
+                    context: line
+                });
+            }
+        }
+        return references;
+    }
+    /**
+     * 批次文字匹配查找（降級方法）
+     */
+    findReferencesMultipleByText(filePath, content, symbolNames, results) {
+        const lines = content.split('\n');
+        for (const symbolName of symbolNames) {
+            const regex = new RegExp(`\\b${this.escapeRegex(symbolName)}\\b`, 'g');
+            const refs = results.get(symbolName);
+            if (!refs) {
+                continue;
+            }
+            for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+                const line = lines[lineIndex];
+                let match;
+                while ((match = regex.exec(line)) !== null) {
+                    refs.push({
+                        symbolName,
+                        location: {
+                            filePath,
+                            range: {
+                                start: { line: lineIndex + 1, column: match.index + 1 },
+                                end: { line: lineIndex + 1, column: match.index + 1 + symbolName.length }
+                            }
+                        },
+                        type: SymbolReferenceType.Usage,
+                        context: line.trim()
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * 檢查位置是否在字串字面值中
+     */
+    isInString(line, position) {
+        let inSingleQuote = false;
+        let inDoubleQuote = false;
+        let inTemplate = false;
+        for (let i = 0; i < position; i++) {
+            const char = line[i];
+            const prevChar = i > 0 ? line[i - 1] : '';
+            // 跳過轉義字元
+            if (prevChar === '\\') {
+                continue;
+            }
+            if (char === '\'' && !inDoubleQuote && !inTemplate) {
+                inSingleQuote = !inSingleQuote;
+            }
+            else if (char === '"' && !inSingleQuote && !inTemplate) {
+                inDoubleQuote = !inDoubleQuote;
+            }
+            else if (char === '`' && !inSingleQuote && !inDoubleQuote) {
+                inTemplate = !inTemplate;
+            }
+        }
+        return inSingleQuote || inDoubleQuote || inTemplate;
+    }
+    /**
+     * 檢查位置是否在單行註解中
+     */
+    isInSingleLineComment(line, position) {
+        const beforePosition = line.substring(0, position);
+        // TypeScript/JavaScript 單行註解
+        if (beforePosition.includes('//')) {
+            return true;
+        }
+        // Python/Shell 單行註解
+        if (beforePosition.includes('#')) {
+            // 排除 # 在字串中的情況
+            const hashIndex = beforePosition.indexOf('#');
+            if (!this.isInString(line, hashIndex)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 跳脫正則表達式特殊字元
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+}
+/**
+ * 建立 TextMatcher 實例
+ */
+export function createTextMatcher() {
+    return new TextMatcher();
+}
+//# sourceMappingURL=text-matcher.js.map

package/dist/core/shared/symbol-finder/text-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-matcher.js","sourceRoot":"","sources":["../../../../src/core/shared/symbol-finder/text-matcher.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,108 @@
+/**
+ * 符號查找器型別定義
+ */
+import type { Range, Location } from '../../../shared/types/core.js';
+import type { Symbol } from '../../../shared/types/symbol.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;
+}
+/**
+ * 符號唯一識別鍵
+ * 用於區分不同作用域的同名符號（如 Dog.bark vs Car.bark）
+ */
+export interface SymbolKey {
+    /** 符號名稱 */
+    readonly name: string;
+    /** 所屬容器（類別、介面等）*/
+    readonly containerName: string | undefined;
+    /** 定義檔案路徑 */
+    readonly filePath: string;
+    /** 定義行號（用於同檔案同容器內的區分）*/
+    readonly line: number;
+}
+/**
+ * 將 Symbol 轉換為 SymbolKey
+ */
+export declare function symbolToKey(symbol: Symbol): SymbolKey;
+/**
+ * 將 SymbolKey 序列化為字串（用於 Map 鍵）
+ * 格式：v1:filePath:line:containerName:name
+ *
+ * 版本控制：當格式需要變更時，更新 SYMBOL_KEY_VERSION 並新增對應的解析邏輯
+ */
+export declare function serializeSymbolKey(key: SymbolKey): string;
+/**
+ * 將序列化字串反序列化為 SymbolKey
+ * 支援版本控制，可向後相容舊格式
+ */
+export declare function deserializeSymbolKey(serialized: string): SymbolKey;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/shared/symbol-finder/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,aAAa;IACb,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAOrD;AAKD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAsBlE"}

package/dist/core/shared/symbol-finder/types.js

@@ -0,0 +1,71 @@
+/**
+ * 符號查找器型別定義
+ */
+/**
+ * 符號引用類型
+ */
+export var SymbolReferenceType;
+(function (SymbolReferenceType) {
+    SymbolReferenceType["Definition"] = "definition";
+    SymbolReferenceType["Usage"] = "usage";
+    SymbolReferenceType["Import"] = "import";
+    SymbolReferenceType["Export"] = "export";
+})(SymbolReferenceType || (SymbolReferenceType = {}));
+/**
+ * 類別成員類型
+ */
+export var ClassMemberType;
+(function (ClassMemberType) {
+    ClassMemberType["Method"] = "method";
+    ClassMemberType["Property"] = "property";
+    ClassMemberType["Getter"] = "getter";
+    ClassMemberType["Setter"] = "setter";
+    ClassMemberType["Constructor"] = "constructor";
+})(ClassMemberType || (ClassMemberType = {}));
+/**
+ * 將 Symbol 轉換為 SymbolKey
+ */
+export function symbolToKey(symbol) {
+    return {
+        name: symbol.name,
+        containerName: symbol.scope?.name,
+        filePath: symbol.location.filePath,
+        line: symbol.location.range.start.line
+    };
+}
+/** SymbolKey 序列化格式版本（用於未來擴展和向後相容） */
+const SYMBOL_KEY_VERSION = 'v1';
+/**
+ * 將 SymbolKey 序列化為字串（用於 Map 鍵）
+ * 格式：v1:filePath:line:containerName:name
+ *
+ * 版本控制：當格式需要變更時，更新 SYMBOL_KEY_VERSION 並新增對應的解析邏輯
+ */
+export function serializeSymbolKey(key) {
+    return `${SYMBOL_KEY_VERSION}:${key.filePath}:${key.line}:${key.containerName ?? ''}:${key.name}`;
+}
+/**
+ * 將序列化字串反序列化為 SymbolKey
+ * 支援版本控制，可向後相容舊格式
+ */
+export function deserializeSymbolKey(serialized) {
+    const parts = serialized.split(':');
+    // 檢查版本前綴
+    const version = parts[0];
+    if (version === SYMBOL_KEY_VERSION) {
+        // v1 格式：v1:filePath:line:containerName:name
+        parts.shift(); // 移除版本前綴
+        const name = parts.pop();
+        const containerName = parts.pop() || undefined;
+        const line = parseInt(parts.pop(), 10);
+        const filePath = parts.join(':');
+        return { name, containerName, filePath, line };
+    }
+    // 向後相容：舊格式（無版本前綴）filePath:line:containerName:name
+    const name = parts.pop();
+    const containerName = parts.pop() || undefined;
+    const line = parseInt(parts.pop(), 10);
+    const filePath = parts.join(':');
+    return { name, containerName, filePath, line };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/shared/symbol-finder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/shared/symbol-finder/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH;;GAEG;AACH,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,gDAAyB,CAAA;IACzB,sCAAe,CAAA;IACf,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;AACnB,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAkCD;;GAEG;AACH,MAAM,CAAN,IAAY,eAMX;AAND,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,8CAA2B,CAAA;AAC7B,CAAC,EANW,eAAe,KAAf,eAAe,QAM1B;AA0BD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;QAClC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;KACvC,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAc;IAC/C,OAAO,GAAG,kBAAkB,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,aAAa,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;AACpG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpC,SAAS;IACT,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,kBAAkB,EAAE,CAAC;QACnC,4CAA4C;QAC5C,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC1B,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;QAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAG,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,kDAAkD;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;IAC1B,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAG,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEjC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/core/snapshot/snapshot-generator.d.ts

@@ -34,6 +34,10 @@ export declare class SnapshotGenerator {
      * 產生模組快照
      */
     private generateModuleSnapshot;
+    /**
+     * 載入模組目錄下所有檔案內容
+     */
+    private loadFileContents;
     /**
      * 使用 Parser 識別模組內的 factory 模式
      */
@@ -49,6 +53,7 @@ export declare class SnapshotGenerator {
     /**
      * 建構模組快照
      * @param factoryPatterns Parser 識別的 factory 模式（優先使用，若為空則 fallback 到名稱比對）
+     * @param fileContents 檔案內容 Map（供 Parser 簽章解析使用）
      */
     private buildModuleSnapshot;
     /**
@@ -60,13 +65,20 @@ export declare class SnapshotGenerator {
      */
     private getClassFields;
     /**
-     * 格式化方法簽章
+     * 格式化符號簽章（方法或函數）
+     * 優先使用 Parser AST 解析，fallback 到 simplifySignature
+     * @param fileContents 檔案內容 Map（供 Parser 使用）
      */
-    private formatMethodSignature;
+    private formatSymbolSignature;
     /**
-     * 格式化函數簽章
+     * 使用 Parser AST 格式化簽章
+     * @param filePath 檔案路徑（用於選擇 Parser）
+     * @param symbolName 符號名稱
+     * @param line 行號（1-based）
+     * @param code 檔案內容
+     * @returns 格式化後的簽章字串，如果無法解析則返回 null（fallback 到 simplifySignature）
      */
-    private formatFunctionSignature;
+    private formatSignatureWithParser;
     /**
      * 簡化簽章格式（移除函數名稱，保留參數和回傳型別）
      * 使用括號平衡算法處理巢狀泛型

package/dist/core/snapshot/snapshot-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-generator.d.ts","sourceRoot":"","sources":["../../../src/core/snapshot/snapshot-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAKpE,OAAO,KAAK,EAAmC,cAAc,EAAe,MAAM,YAAY,CAAC;AAG/F,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,qBAAqB,CAAC;AAQ9E;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,YAAY,CAAqC;gBAE7C,UAAU,EAAE,WAAW;IAInC;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAU3D;;;;OAIG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0C1F;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;YACW,WAAW;IA0BzB;;OAEG;YACW,sBAAsB;IAwBpC;;OAEG;YACW,uBAAuB;IAwCrC;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;YACW,cAAc;IA8B5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAqE3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAuDnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,eAAe;CAMxB"}
+{"version":3,"file":"snapshot-generator.d.ts","sourceRoot":"","sources":["../../../src/core/snapshot/snapshot-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAKpE,OAAO,KAAK,EAAmC,cAAc,EAAe,MAAM,YAAY,CAAC;AAG/F,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,qBAAqB,CAAC;AAQ9E;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,YAAY,CAAqC;gBAE7C,UAAU,EAAE,WAAW;IAInC;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAU3D;;;;OAIG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0C1F;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;YACW,WAAW;IA0BzB;;OAEG;YACW,sBAAsB;IA2BpC;;OAEG;YACW,gBAAgB;IA6B9B;;OAEG;YACW,uBAAuB;IAwCrC;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;YACW,cAAc;IA8B5B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAsE3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAuDnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,eAAe;CAMxB"}

package/dist/core/snapshot/snapshot-generator.js

@@ -123,12 +123,46 @@ export class SnapshotGenerator {
             const relativePath = path.basename(modulePath);
             // 使用 Parser 識別 factory 模式
             const factoryPatterns = await this.identifyFactoryPatterns(modulePath);
-            return this.buildModuleSnapshot(relativePath, symbols, modulePath, factoryPatterns);
+            // 預載入所有檔案內容（供 formatSignatureWithParser 使用）
+            const fileContents = await this.loadFileContents(modulePath);
+            return this.buildModuleSnapshot(relativePath, symbols, modulePath, factoryPatterns, fileContents);
         }
         finally {
             indexEngine.dispose();
         }
     }
+    /**
+     * 載入模組目錄下所有檔案內容
+     */
+    async loadFileContents(modulePath) {
+        const contents = new Map();
+        const supportedExtensions = ParserRegistry.getInstance().getSupportedExtensions();
+        try {
+            const entries = await this.fileSystem.readDirectory(modulePath);
+            for (const entry of entries) {
+                if (entry.isDirectory) {
+                    continue;
+                }
+                const ext = path.extname(entry.name);
+                if (!supportedExtensions.includes(ext)) {
+                    continue;
+                }
+                const filePath = path.join(modulePath, entry.name);
+                try {
+                    const content = await this.fileSystem.readFile(filePath);
+                    const codeString = typeof content === 'string' ? content : content.toString('utf-8');
+                    contents.set(filePath, codeString);
+                }
+                catch {
+                    // 忽略單一檔案的讀取錯誤
+                }
+            }
+        }
+        catch {
+            // 忽略目錄讀取錯誤
+        }
+        return contents;
+    }
     /**
      * 使用 Parser 識別模組內的 factory 模式
      */
@@ -219,8 +253,9 @@ export class SnapshotGenerator {
     /**
      * 建構模組快照
      * @param factoryPatterns Parser 識別的 factory 模式（優先使用，若為空則 fallback 到名稱比對）
+     * @param fileContents 檔案內容 Map（供 Parser 簽章解析使用）
      */
-    buildModuleSnapshot(moduleName, symbols, _modulePath, factoryPatterns = new Map()) {
+    buildModuleSnapshot(moduleName, symbols, _modulePath, factoryPatterns = new Map(), fileContents = new Map()) {
         // 轉型為 ExtendedSymbol 以存取 signature 和 typeInfo
         const extendedSymbols = symbols;
         const api = {};
@@ -234,7 +269,7 @@ export class SnapshotGenerator {
         const typeAliases = extendedSymbols.filter(s => s.type === SymbolType.Type);
         // 處理 class
         for (const cls of classes) {
-            const methods = this.getClassMethods(cls, extendedSymbols);
+            const methods = this.getClassMethods(cls, extendedSymbols, fileContents);
             if (Object.keys(methods).length > 0) {
                 api[cls.name] = methods;
             }
@@ -253,11 +288,11 @@ export class SnapshotGenerator {
             const parserPattern = factoryPatterns.get(func.name);
             if (parserPattern) {
                 // Parser 識別為 factory（語義分析）
-                factories[func.name] = this.formatFunctionSignature(func);
+                factories[func.name] = this.formatSymbolSignature(func, fileContents);
             }
             else if (factoryPatterns.size === 0 && func.name.startsWith('create')) {
                 // Fallback：Parser 未提供任何結果時，使用名稱比對（向後相容）
-                factories[func.name] = this.formatFunctionSignature(func);
+                factories[func.name] = this.formatSymbolSignature(func, fileContents);
             }
         }
         // 處理 interface
@@ -279,7 +314,7 @@ export class SnapshotGenerator {
     /**
      * 取得 class 的方法
      */
-    getClassMethods(cls, allSymbols) {
+    getClassMethods(cls, allSymbols, fileContents) {
         const methods = {};
         // 找出屬於此 class 的方法
         // 方法的 scope 是 function scope（方法名），其 parent 才是 class scope
@@ -289,7 +324,7 @@ export class SnapshotGenerator {
             && s.name !== 'constructor' // 排除 constructor
         );
         for (const method of classMethods) {
-            methods[method.name] = this.formatMethodSignature(method);
+            methods[method.name] = this.formatSymbolSignature(method, fileContents);
         }
         return methods;
     }
@@ -307,24 +342,62 @@ export class SnapshotGenerator {
         return fields;
     }
     /**
-     * 格式化方法簽章
+     * 格式化符號簽章（方法或函數）
+     * 優先使用 Parser AST 解析，fallback 到 simplifySignature
+     * @param fileContents 檔案內容 Map（供 Parser 使用）
      */
-    formatMethodSignature(method) {
-        // 優先使用 Parser 提取的完整簽章
-        if (method.signature) {
-            return this.simplifySignature(method.signature);
+    formatSymbolSignature(symbol, fileContents) {
+        // 優先使用 Parser AST 解析簽章
+        const filePath = symbol.location?.filePath;
+        const line = symbol.location?.range?.start?.line;
+        const code = filePath ? fileContents.get(filePath) : undefined;
+        if (filePath && line !== undefined && code) {
+            const parserResult = this.formatSignatureWithParser(filePath, symbol.name, line, code);
+            if (parserResult) {
+                return parserResult;
+            }
+        }
+        // Fallback：使用 IndexEngine 提取的簽章
+        if (symbol.signature) {
+            return this.simplifySignature(symbol.signature);
         }
         return '() → unknown';
     }
     /**
-     * 格式化函數簽章
+     * 使用 Parser AST 格式化簽章
+     * @param filePath 檔案路徑（用於選擇 Parser）
+     * @param symbolName 符號名稱
+     * @param line 行號（1-based）
+     * @param code 檔案內容
+     * @returns 格式化後的簽章字串，如果無法解析則返回 null（fallback 到 simplifySignature）
      */
-    formatFunctionSignature(func) {
-        // 優先使用 Parser 提取的完整簽章
-        if (func.signature) {
-            return this.simplifySignature(func.signature);
+    formatSignatureWithParser(filePath, symbolName, line, code) {
+        const ext = path.extname(filePath);
+        const parser = ParserRegistry.getInstance().getParser(ext);
+        if (!parser?.formatSignature) {
+            return null;
         }
-        return '() → unknown';
+        const sig = parser.formatSignature(code, symbolName, line);
+        if (!sig) {
+            return null;
+        }
+        // 轉換 FormattedSignature → 簡化字串
+        const params = sig.parameters
+            .map(p => {
+            let str = p.name;
+            if (p.optional && !p.defaultValue) {
+                str += '?';
+            }
+            if (p.type && p.type !== 'any') {
+                str += `: ${p.type}`;
+            }
+            if (p.defaultValue) {
+                str += ` = ${p.defaultValue}`;
+            }
+            return str;
+        })
+            .join(', ');
+        return params ? `(${params}) → ${sig.returnType}` : `() → ${sig.returnType}`;
     }
     /**
      * 簡化簽章格式（移除函數名稱，保留參數和回傳型別）