agent-ide 0.7.5 → 0.8.0

package/dist/plugins/typescript/language-service.d.ts

@@ -0,0 +1,93 @@
+/**
+ * TypeScript Language Service 管理模組
+ * 提供 Language Service 初始化、檔案管理與符號位置查詢
+ */
+import * as ts from 'typescript';
+import type { Disposable } from '../../shared/utils/memory-monitor.js';
+import type { TypeScriptSymbol } from './types.js';
+/**
+ * 檔案資訊
+ */
+interface FileInfo {
+    version: number;
+    content: string;
+}
+/**
+ * Language Service Manager 介面
+ */
+export interface ILanguageServiceManager extends Disposable {
+    /** 取得 Language Service（可能為 null） */
+    readonly languageService: ts.LanguageService | null;
+    /** 取得 Language Service Host（可能為 null） */
+    readonly languageServiceHost: ts.LanguageServiceHost | null;
+    /** 取得檔案 Map */
+    readonly files: ReadonlyMap<string, FileInfo>;
+    /**
+     * 確保 Language Service 已初始化
+     * @param sourceFile 來源檔案
+     */
+    ensureInitialized(sourceFile: ts.SourceFile): void;
+    /**
+     * 更新檔案內容
+     * @param fileName 檔案名稱
+     * @param content 檔案內容
+     */
+    updateFile(fileName: string, content: string): void;
+    /**
+     * 根據檔案名稱取得 SourceFile
+     * @param fileName 檔案名稱
+     */
+    getSourceFileFromFileName(fileName: string): ts.SourceFile | undefined;
+    /**
+     * 取得符號在檔案中的位置
+     * @param symbol TypeScript 符號
+     * @param sourceFile 來源檔案
+     * @param getIdentifierFromSymbolNode 取得識別符的函式
+     */
+    getSymbolPosition(symbol: TypeScriptSymbol, sourceFile: ts.SourceFile, getIdentifierFromSymbolNode: (node: ts.Node) => ts.Identifier | undefined): number | undefined;
+}
+/**
+ * Language Service Manager 實作
+ * 管理 TypeScript Language Service 生命週期
+ */
+export declare class LanguageServiceManager implements ILanguageServiceManager {
+    private _languageService;
+    private _languageServiceHost;
+    private _files;
+    private compilerOptions;
+    constructor(compilerOptions: ts.CompilerOptions);
+    get languageService(): ts.LanguageService | null;
+    get languageServiceHost(): ts.LanguageServiceHost | null;
+    get files(): ReadonlyMap<string, FileInfo>;
+    /**
+     * 確保 Language Service 已初始化
+     */
+    ensureInitialized(sourceFile: ts.SourceFile): void;
+    /**
+     * 建立 Language Service Host
+     */
+    private createLanguageServiceHost;
+    /**
+     * 更新檔案內容
+     */
+    updateFile(fileName: string, content: string): void;
+    /**
+     * 根據檔案名稱取得 SourceFile
+     */
+    getSourceFileFromFileName(fileName: string): ts.SourceFile | undefined;
+    /**
+     * 取得符號在檔案中的位置
+     */
+    getSymbolPosition(symbol: TypeScriptSymbol, sourceFile: ts.SourceFile, getIdentifierFromSymbolNode: (node: ts.Node) => ts.Identifier | undefined): number | undefined;
+    /**
+     * 釋放資源
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * 建立 Language Service Manager 實例
+ * @param compilerOptions TypeScript 編譯器選項
+ */
+export declare function createLanguageServiceManager(compilerOptions: ts.CompilerOptions): ILanguageServiceManager;
+export {};
+//# sourceMappingURL=language-service.d.ts.map

package/dist/plugins/typescript/language-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-service.d.ts","sourceRoot":"","sources":["../../../src/plugins/typescript/language-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,UAAU;IACzD,oCAAoC;IACpC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,GAAG,IAAI,CAAC;IAEpD,yCAAyC;IACzC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAE5D,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE9C;;;OAGG;IACH,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;OAGG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,GAAG,SAAS,CAAC;IAEvE;;;;;OAKG;IACH,iBAAiB,CACf,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,2BAA2B,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,GAAG,SAAS,GACxE,MAAM,GAAG,SAAS,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,oBAAoB,CAAuC;IACnE,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,eAAe,CAAqB;gBAEhC,eAAe,EAAE,EAAE,CAAC,eAAe;IAI/C,IAAI,eAAe,IAAI,EAAE,CAAC,eAAe,GAAG,IAAI,CAE/C;IAED,IAAI,mBAAmB,IAAI,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAEvD;IAED,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEzC;IAED;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,IAAI;IAoBlD;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0DjC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYnD;;OAEG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,GAAG,SAAS;IAQtE;;OAEG;IACH,iBAAiB,CACf,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,2BAA2B,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,GAAG,SAAS,GACxE,MAAM,GAAG,SAAS;IAQrB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAa/B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,EAAE,CAAC,eAAe,GAClC,uBAAuB,CAEzB"}

package/dist/plugins/typescript/language-service.js

@@ -0,0 +1,159 @@
+/**
+ * TypeScript Language Service 管理模組
+ * 提供 Language Service 初始化、檔案管理與符號位置查詢
+ */
+import * as ts from 'typescript';
+/**
+ * Language Service Manager 實作
+ * 管理 TypeScript Language Service 生命週期
+ */
+export class LanguageServiceManager {
+    _languageService = null;
+    _languageServiceHost = null;
+    _files = new Map();
+    compilerOptions;
+    constructor(compilerOptions) {
+        this.compilerOptions = compilerOptions;
+    }
+    get languageService() {
+        return this._languageService;
+    }
+    get languageServiceHost() {
+        return this._languageServiceHost;
+    }
+    get files() {
+        return this._files;
+    }
+    /**
+     * 確保 Language Service 已初始化
+     */
+    ensureInitialized(sourceFile) {
+        if (this._languageService) {
+            // 更新檔案內容
+            this.updateFile(sourceFile.fileName, sourceFile.text);
+            return;
+        }
+        // 添加當前檔案到檔案列表
+        this.updateFile(sourceFile.fileName, sourceFile.text);
+        // 建立 Language Service Host
+        this._languageServiceHost = this.createLanguageServiceHost(sourceFile);
+        // 建立 Language Service
+        this._languageService = ts.createLanguageService(this._languageServiceHost, ts.createDocumentRegistry());
+    }
+    /**
+     * 建立 Language Service Host
+     */
+    createLanguageServiceHost(sourceFile) {
+        return {
+            getScriptFileNames: () => {
+                const fileNames = Array.from(this._files.keys());
+                // 確保包含當前檔案
+                if (!fileNames.includes(sourceFile.fileName)) {
+                    fileNames.push(sourceFile.fileName);
+                }
+                return fileNames;
+            },
+            getScriptVersion: (fileName) => {
+                const file = this._files.get(fileName);
+                return file ? String(file.version) : '0';
+            },
+            getScriptSnapshot: (fileName) => {
+                const file = this._files.get(fileName);
+                if (file) {
+                    return ts.ScriptSnapshot.fromString(file.content);
+                }
+                // 嘗試讀取實際檔案
+                try {
+                    const content = ts.sys.readFile(fileName);
+                    if (content) {
+                        return ts.ScriptSnapshot.fromString(content);
+                    }
+                }
+                catch {
+                    // 忽略錯誤
+                }
+                return undefined;
+            },
+            getCurrentDirectory: () => process.cwd(),
+            getCompilationSettings: () => ({
+                ...this.compilerOptions,
+                // 確保啟用必要的選項
+                allowNonTsExtensions: true,
+                noResolve: false,
+                noLib: false,
+                lib: this.compilerOptions.lib || ['lib.es2020.d.ts']
+            }),
+            getDefaultLibFileName: (options) => ts.getDefaultLibFilePath(options),
+            fileExists: (fileName) => {
+                return this._files.has(fileName) || (ts.sys.fileExists ? ts.sys.fileExists(fileName) : false);
+            },
+            readFile: (fileName) => {
+                const file = this._files.get(fileName);
+                if (file) {
+                    return file.content;
+                }
+                return ts.sys.readFile ? ts.sys.readFile(fileName) : undefined;
+            },
+            readDirectory: ts.sys.readDirectory ? ts.sys.readDirectory : () => [],
+            getDirectories: ts.sys.getDirectories ? ts.sys.getDirectories : () => [],
+            directoryExists: ts.sys.directoryExists ? ts.sys.directoryExists : () => false,
+            realpath: ts.sys.realpath ? ts.sys.realpath : (path) => path,
+            getNewLine: () => '\n'
+        };
+    }
+    /**
+     * 更新檔案內容
+     */
+    updateFile(fileName, content) {
+        const existing = this._files.get(fileName);
+        if (existing && existing.content === content) {
+            return;
+        }
+        this._files.set(fileName, {
+            version: existing ? existing.version + 1 : 0,
+            content
+        });
+    }
+    /**
+     * 根據檔案名稱取得 SourceFile
+     */
+    getSourceFileFromFileName(fileName) {
+        if (!this._languageService) {
+            return undefined;
+        }
+        const program = this._languageService.getProgram();
+        return program?.getSourceFile(fileName);
+    }
+    /**
+     * 取得符號在檔案中的位置
+     */
+    getSymbolPosition(symbol, sourceFile, getIdentifierFromSymbolNode) {
+        const identifier = getIdentifierFromSymbolNode(symbol.tsNode);
+        if (!identifier) {
+            return undefined;
+        }
+        return identifier.getStart(sourceFile);
+    }
+    /**
+     * 釋放資源
+     */
+    async dispose() {
+        // 清理 Language Service
+        if (this._languageService) {
+            this._languageService.dispose();
+            this._languageService = null;
+        }
+        // 清理 Language Service Host
+        this._languageServiceHost = null;
+        // 清理檔案快取
+        this._files.clear();
+    }
+}
+/**
+ * 建立 Language Service Manager 實例
+ * @param compilerOptions TypeScript 編譯器選項
+ */
+export function createLanguageServiceManager(compilerOptions) {
+    return new LanguageServiceManager(compilerOptions);
+}
+//# sourceMappingURL=language-service.js.map

package/dist/plugins/typescript/language-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-service.js","sourceRoot":"","sources":["../../../src/plugins/typescript/language-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAyDjC;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IACzB,gBAAgB,GAA8B,IAAI,CAAC;IACnD,oBAAoB,GAAkC,IAAI,CAAC;IAC3D,MAAM,GAA0B,IAAI,GAAG,EAAE,CAAC;IAC1C,eAAe,CAAqB;IAE5C,YAAY,eAAmC;QAC7C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,UAAyB;QACzC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,SAAS;YACT,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAEtD,2BAA2B;QAC3B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;QAEvE,sBAAsB;QACtB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC,qBAAqB,CAC9C,IAAI,CAAC,oBAAoB,EACzB,EAAE,CAAC,sBAAsB,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,UAAyB;QACzD,OAAO;YACL,kBAAkB,EAAE,GAAG,EAAE;gBACvB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,WAAW;gBACX,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7C,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACtC,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,EAAE;gBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACvC,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3C,CAAC;YACD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,EAAE;gBAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACvC,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpD,CAAC;gBACD,WAAW;gBACX,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAC1C,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBAC/C,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO;gBACT,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,mBAAmB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACxC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC7B,GAAG,IAAI,CAAC,eAAe;gBACvB,YAAY;gBACZ,oBAAoB,EAAE,IAAI;gBAC1B,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,KAAK;gBACZ,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC;aACrD,CAAC;YACF,qBAAqB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC;YACrE,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChG,CAAC;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACrB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACvC,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,IAAI,CAAC,OAAO,CAAC;gBACtB,CAAC;gBACD,OAAO,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,CAAC;YACD,aAAa,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE;YACrE,cAAc,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE;YACxE,eAAe,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK;YAC9E,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI;YAC5D,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;SACvB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAgB,EAAE,OAAe;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE;YACxB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,yBAAyB,CAAC,QAAgB;QACxC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC;QACnD,OAAO,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,MAAwB,EACxB,UAAyB,EACzB,2BAAyE;QAEzE,MAAM,UAAU,GAAG,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,sBAAsB;QACtB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;QAEjC,SAAS;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,eAAmC;IAEnC,OAAO,IAAI,sBAAsB,CAAC,eAAe,CAAC,CAAC;AACrD,CAAC"}

package/dist/plugins/typescript/parser.d.ts

@@ -3,7 +3,7 @@
  * 實作 ParserPlugin 介面
  */
 import * as ts from 'typescript';
-import { ParserPlugin, CodeEdit, Definition, Usage, ValidationResult } from '../../infrastructure/parser/index.js';
+import { ParserPlugin, CodeEdit, Definition, Usage, ValidationResult, type ImportDeclaration, type FormattedSignature, type Documentation, type PatternInfo, type ScopedFindReferencesOptions, type ScopedReference } from '../../infrastructure/parser/index.js';
 import type { AST, Symbol, Reference, Dependency, Position, Range } from '../../shared/types/index.js';
 import { type Disposable } from '../../shared/utils/memory-monitor.js';
 /**
@@ -17,9 +17,11 @@ export declare class TypeScriptParser implements ParserPlugin, Disposable {
     private symbolExtractor;
     private dependencyAnalyzer;
     private compilerOptions;
-    private languageService;
-    private languageServiceHost;
-    private files;
+    private languageServiceManager;
+    private scopeAnalyzer;
+    private declarationAnalyzer;
+    private patternAnalyzer;
+    private referenceFinder;
     constructor(compilerOptions?: ts.CompilerOptions);
     /**
      * 解析 TypeScript 程式碼
@@ -49,7 +51,7 @@ export declare class TypeScriptParser implements ParserPlugin, Disposable {
     /**
      * 提取函式重構
      */
-    extractFunction(ast: AST, selection: Range): Promise<CodeEdit[]>;
+    extractFunction(_ast: AST, _selection: Range): Promise<CodeEdit[]>;
     /**
      * 查找定義
      */
@@ -86,18 +88,7 @@ export declare class TypeScriptParser implements ParserPlugin, Disposable {
     private validateRenameInput;
     private getScriptKind;
     private getLanguageFromFilePath;
-    private getSyntacticDiagnostics;
     private findNodeAtPosition;
-    private isReferenceToSymbol;
-    private getIdentifierFromSymbolNode;
-    private getNodeScope;
-    private isInSameScope;
-    private isScopeNode;
-    private getReferenceType;
-    /**
-     * 檢查節點是否位於 import 語句內
-     */
-    private isInImportStatement;
     private isRenameableNode;
     private isDefinitionNode;
     private isDeclarationNode;
@@ -107,36 +98,38 @@ export declare class TypeScriptParser implements ParserPlugin, Disposable {
     private findSymbolAtPosition;
     private isPositionInRange;
     /**
-     * 初始化 Language Service
-     */
-    private ensureLanguageServiceInitialized;
-    /**
-     * 更新檔案內容
+     * 判斷檔案是否為測試檔案
      */
-    private updateFile;
+    isTestFile(filePath: string): boolean;
     /**
-     * 取得符號在檔案中的位置
+     * 取得符號的完整宣告範圍（包含 JSDoc、裝飾器）
+     * 委託給 DeclarationAnalyzer
      */
-    private getSymbolPosition;
+    getFullDeclarationRange(code: string, symbolName: string, symbolType: string, startLine: number): Range | null;
     /**
-     * 根據檔案名稱取得 SourceFile
+     * 解析程式碼中的所有 import 宣告
+     * 委託給 DeclarationAnalyzer
      */
-    private getSourceFileFromFileName;
+    getImportDeclarations(code: string): ImportDeclaration[] | null;
     /**
-     * 取得節點的作用域容器
+     * 格式化函數簽章
+     * 委託給 DeclarationAnalyzer
      */
-    private getScopeContainer;
+    formatSignature(code: string, functionName: string, line: number): FormattedSignature | null;
     /**
-     * 檢查節點是否在指定作用域鏈內
+     * 提取符號的 JSDoc 文件註解
+     * 委託給 DeclarationAnalyzer
      */
-    private isInScopeChain;
+    getDocumentation(code: string, symbolName: string, symbolType: string, line: number): Documentation | null;
     /**
-     * 檢查符號是否被遮蔽
+     * 識別程式碼中的設計模式
+     * 委託給 PatternAnalyzer
      */
-    private isShadowed;
+    identifyPatterns(code: string): PatternInfo[] | null;
     /**
-     * 判斷檔案是否為測試檔案
+     * 作用域感知的符號引用查找
+     * 委託給 ReferenceFinder
      */
-    isTestFile(filePath: string): boolean;
+    findScopedReferences(code: string, symbolName: string, options?: ScopedFindReferencesOptions): ScopedReference[] | null;
 }
 //# sourceMappingURL=parser.d.ts.map

package/dist/plugins/typescript/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/plugins/typescript/parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/plugins/typescript/parser.ts"],"names":[],"mappings":"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"}