agent-ide 0.8.2 → 0.9.1

package/dist/core/move-member/reference-updater.js

@@ -0,0 +1,288 @@
+/**
+ * Reference Updater
+ * 負責掃描和更新引用（import 語句）
+ */
+import * as path from 'path';
+/**
+ * Reference Updater
+ * 負責掃描專案檔案中的 import 語句並準備更新
+ */
+export class ReferenceUpdater {
+    fileSystem;
+    constructor(fileSystem) {
+        this.fileSystem = fileSystem;
+    }
+    /**
+     * 準備引用更新
+     * 直接掃描 import 語句，不依賴 SymbolFinder 的引用類型
+     * 支援分離 import 語句：當 import 包含多個成員時，只更新被移動的成員
+     */
+    async prepareReferenceUpdates(options, member) {
+        const updates = [];
+        const projectFiles = await this.getProjectFiles(options.projectRoot);
+        for (const filePath of projectFiles) {
+            // 跳過來源檔案和目標檔案
+            if (filePath === options.sourceFile || filePath === options.target.filePath) {
+                continue;
+            }
+            const content = await this.readFile(filePath);
+            if (!content) {
+                continue;
+            }
+            const lines = content.split('\n');
+            // 掃描每一行找 import 語句
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // 檢查是否是 import 語句且包含成員名稱和來源路徑
+                const importPathMatch = this.extractImportPath(line);
+                if (!importPathMatch) {
+                    continue;
+                }
+                // 解析 import 路徑為絕對路徑並比較
+                const resolvedImportPath = this.resolveImportPathToAbsolute(importPathMatch, filePath, options.projectRoot);
+                const normalizedSourceFile = path.normalize(options.sourceFile);
+                // 比較路徑（考慮副檔名）
+                if (!this.pathsMatch(resolvedImportPath, normalizedSourceFile)) {
+                    continue;
+                }
+                // 解析 import 中的所有成員
+                const importedMembers = this.parseImportedMembers(line);
+                if (importedMembers.length === 0) {
+                    continue;
+                }
+                // 找出需要移動的成員（可能帶別名）
+                const memberToMove = importedMembers.find(m => m.name === member.name);
+                if (!memberToMove) {
+                    continue;
+                }
+                // 計算新的相對路徑
+                const newRelativePath = this.calculateRelativePath(filePath, options.target.filePath);
+                const quoteChar = this.detectQuoteChar(line);
+                // 根據是否有其他成員決定如何更新 import
+                const otherMembers = importedMembers.filter(m => m.name !== member.name);
+                let newImport;
+                if (otherMembers.length === 0) {
+                    // 只有一個成員，直接替換路徑
+                    newImport = line.replace(new RegExp(`(['"\`])${this.escapeRegex(importPathMatch)}\\1`), `$1${newRelativePath}$1`);
+                }
+                else {
+                    // 有多個成員，需要分離 import
+                    // 生成保留在原位置的 import
+                    const remainingMembersStr = otherMembers.map(m => m.alias ? `${m.name} as ${m.alias}` : m.name).join(', ');
+                    const remainingImport = `import { ${remainingMembersStr} } from ${quoteChar}${importPathMatch}${quoteChar};`;
+                    // 生成移動到新位置的 import
+                    const movedMemberStr = memberToMove.alias
+                        ? `${memberToMove.name} as ${memberToMove.alias}`
+                        : memberToMove.name;
+                    const newLocationImport = `import { ${movedMemberStr} } from ${quoteChar}${newRelativePath}${quoteChar};`;
+                    // 合併成新的 import（新位置的 import 在前）
+                    newImport = `${newLocationImport}\n${remainingImport}`;
+                }
+                if (newImport !== line) {
+                    updates.push({
+                        filePath,
+                        originalImport: line,
+                        newImport,
+                        location: {
+                            filePath,
+                            range: {
+                                start: { line: i + 1, column: 1 },
+                                end: { line: i + 1, column: line.length + 1 }
+                            }
+                        }
+                    });
+                }
+            }
+        }
+        return updates;
+    }
+    /**
+     * 解析 import 語句中的成員列表
+     */
+    parseImportedMembers(line) {
+        const members = [];
+        // 匹配 { A, B as C, D } 形式
+        const match = line.match(/import\s*\{([^}]+)\}\s*from/);
+        if (!match) {
+            return members;
+        }
+        const membersStr = match[1];
+        const memberParts = membersStr.split(',');
+        for (const part of memberParts) {
+            const trimmed = part.trim();
+            if (!trimmed) {
+                continue;
+            }
+            // 檢查是否有別名 (name as alias)
+            const aliasMatch = trimmed.match(/^(\w+)\s+as\s+(\w+)$/);
+            if (aliasMatch) {
+                members.push({ name: aliasMatch[1], alias: aliasMatch[2] });
+            }
+            else {
+                members.push({ name: trimmed });
+            }
+        }
+        return members;
+    }
+    /**
+     * 檢測 import 語句使用的引號類型
+     */
+    detectQuoteChar(line) {
+        if (line.includes('\'')) {
+            return '\'';
+        }
+        if (line.includes('"')) {
+            return '"';
+        }
+        return '\'';
+    }
+    /**
+     * 從 import/export 語句中提取路徑
+     */
+    extractImportPath(line) {
+        const trimmed = line.trim();
+        // 檢查是否是 import/export 語句
+        if (!trimmed.startsWith('import ') && !(trimmed.startsWith('export ') && trimmed.includes('from'))) {
+            return null;
+        }
+        // 提取引號內的路徑
+        const match = line.match(/from\s+['"`]([^'"`]+)['"`]/);
+        if (!match) {
+            // 嘗試匹配 import 'path' 形式
+            const directImport = line.match(/import\s+['"`]([^'"`]+)['"`]/);
+            return directImport ? directImport[1] : null;
+        }
+        return match[1];
+    }
+    /**
+     * 解析 import 路徑為絕對路徑
+     *
+     * @param importPath import 語句中的路徑
+     * @param fromFile 包含 import 語句的檔案路徑
+     * @param projectRoot 專案根目錄（用於解析路徑別名）
+     */
+    resolveImportPathToAbsolute(importPath, fromFile, projectRoot) {
+        if (importPath.startsWith('.')) {
+            // 相對路徑
+            const fromDir = path.dirname(fromFile);
+            return path.normalize(path.resolve(fromDir, importPath));
+        }
+        // 處理常見的路徑別名（src/*, @/*）
+        if (projectRoot) {
+            // src/* -> {projectRoot}/src/*
+            if (importPath.startsWith('src/')) {
+                return path.normalize(path.join(projectRoot, importPath));
+            }
+            // @/* -> {projectRoot}/src/* (常見配置)
+            if (importPath.startsWith('@/')) {
+                return path.normalize(path.join(projectRoot, 'src', importPath.slice(2)));
+            }
+        }
+        // 非相對路徑且無法解析（可能是 node_modules）
+        return importPath;
+    }
+    /**
+     * 比較兩個路徑是否指向同一檔案（考慮副檔名和 index.ts）
+     */
+    pathsMatch(path1, path2) {
+        const normalized1 = path.normalize(path1);
+        const normalized2 = path.normalize(path2);
+        // 完全匹配
+        if (normalized1 === normalized2) {
+            return true;
+        }
+        // 移除副檔名後比較
+        const withoutExt1 = this.removeExtension(normalized1);
+        const withoutExt2 = this.removeExtension(normalized2);
+        if (withoutExt1 === withoutExt2) {
+            return true;
+        }
+        // 處理目錄 -> index.ts 對應
+        // 例如 src/utils 應該匹配 src/utils/index.ts
+        if (withoutExt2.endsWith('/index') && withoutExt1 === path.dirname(withoutExt2)) {
+            return true;
+        }
+        if (withoutExt1.endsWith('/index') && withoutExt2 === path.dirname(withoutExt1)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 移除檔案副檔名
+     */
+    removeExtension(filePath) {
+        const ext = path.extname(filePath);
+        if (['.js', '.ts', '.jsx', '.tsx'].includes(ext)) {
+            return filePath.slice(0, -ext.length);
+        }
+        return filePath;
+    }
+    /**
+     * 跳脫正則表達式特殊字元
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * 計算相對路徑
+     */
+    calculateRelativePath(from, to) {
+        const fromDir = path.dirname(from);
+        let relativePath = path.relative(fromDir, to);
+        // 移除副檔名
+        relativePath = relativePath.replace(/\.(ts|tsx|js|jsx)$/, '');
+        // 確保以 ./ 開頭
+        if (!relativePath.startsWith('.')) {
+            relativePath = './' + relativePath;
+        }
+        return relativePath;
+    }
+    /**
+     * 取得專案檔案
+     */
+    async getProjectFiles(projectRoot) {
+        const files = [];
+        await this.collectFiles(projectRoot, files);
+        return files;
+    }
+    /**
+     * 遞迴收集檔案
+     */
+    async collectFiles(dirPath, files) {
+        const entries = await this.fileSystem.readDirectory(dirPath);
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            // 跳過 node_modules、build 輸出目錄和隱藏目錄
+            const skipDirs = ['node_modules', 'dist', 'build', 'coverage', '.git'];
+            if (skipDirs.includes(entry.name) || entry.name.startsWith('.')) {
+                continue;
+            }
+            if (entry.isDirectory) {
+                await this.collectFiles(fullPath, files);
+            }
+            else if (entry.isFile && this.isSupportedFile(entry.name)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    /**
+     * 檢查是否為支援的檔案類型
+     */
+    isSupportedFile(filename) {
+        const supportedExtensions = ['.ts', '.tsx', '.js', '.jsx'];
+        return supportedExtensions.some(ext => filename.endsWith(ext));
+    }
+    /**
+     * 讀取檔案內容
+     */
+    async readFile(filePath) {
+        try {
+            const content = await this.fileSystem.readFile(filePath, 'utf-8');
+            return typeof content === 'string' ? content : content.toString('utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=reference-updater.js.map

package/dist/core/move-member/reference-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-updater.js","sourceRoot":"","sources":["../../../src/core/move-member/reference-updater.ts"],"names":[],"mappings":"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"}

package/dist/core/move-member/types.d.ts

@@ -69,18 +69,33 @@ export interface MoveTarget {
     /** 插入位置（行號，0 表示檔案開頭，-1 表示檔案結尾） */
     readonly insertPosition?: number;
 }
+/**
+ * 來源位置（用於 by-position 定位）
+ */
+export interface SourcePosition {
+    /** 行號（1-based） */
+    readonly line: number;
+    /** 欄位（1-based，可選） */
+    readonly column?: number;
+}
 /**
  * Move Member 選項
+ *
+ * 支援兩種定位方式：
+ * 1. by-name：使用 memberName + memberType + sourceClassName
+ * 2. by-position：使用 sourcePosition（優先於 by-name）
  */
 export interface MoveMemberOptions {
     /** 來源檔案路徑 */
     readonly sourceFile: string;
-    /** 成員名稱 */
-    readonly memberName: string;
+    /** 成員名稱（by-name 模式必須） */
+    readonly memberName?: string;
     /** 成員類型（可選，用於區分同名成員） */
     readonly memberType?: MemberType;
     /** 所屬類別（若為類別成員） */
     readonly sourceClassName?: string;
+    /** 來源位置（by-position 模式，優先於 memberName） */
+    readonly sourcePosition?: SourcePosition;
     /** 移動目標 */
     readonly target: MoveTarget;
     /** 專案根目錄 */

package/dist/core/move-member/types.d.ts.map

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

package/dist/core/move-member/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/move-member/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,CAAN,IAAY,UAiBX;AAjBD,WAAY,UAAU;IACpB,SAAS;IACT,+BAAiB,CAAA;IACjB,SAAS;IACT,mCAAqB,CAAA;IACrB,eAAe;IACf,mCAAqB,CAAA;IACrB,SAAS;IACT,6BAAe,CAAA;IACf,SAAS;IACT,qCAAuB,CAAA;IACvB,WAAW;IACX,sCAAwB,CAAA;IACxB,SAAS;IACT,mCAAqB,CAAA;IACrB,SAAS;IACT,2BAAa,CAAA;AACf,CAAC,EAjBW,UAAU,KAAV,UAAU,QAiBrB;AAwBD;;GAEG;AACH,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,cAAc;IACd,gDAA8B,CAAA;IAC9B,aAAa;IACb,sCAAoB,CAAA;IACpB,cAAc;IACd,kDAAgC,CAAA;AAClC,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAoID;;GAEG;AACH,MAAM,CAAN,IAAY,mBAmBX;AAnBD,WAAY,mBAAmB;IAC7B,YAAY;IACZ,0DAAmC,CAAA;IACnC,cAAc;IACd,mEAA4C,CAAA;IAC5C,kBAAkB;IAClB,6EAAsD,CAAA;IACtD,cAAc;IACd,qEAA8C,CAAA;IAC9C,WAAW;IACX,iEAA0C,CAAA;IAC1C,eAAe;IACf,wEAAiD,CAAA;IACjD,aAAa;IACb,mEAA4C,CAAA;IAC5C,WAAW;IACX,iDAA0B,CAAA;IAC1B,wBAAwB;IACxB,mEAA4C,CAAA;AAC9C,CAAC,EAnBW,mBAAmB,KAAnB,mBAAmB,QAmB9B;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAC5C,MAAM,IAAI,GAAG,IAAI,OAAQ,GAAwB,CAAC,IAAI,KAAK,QAAQ;QACnE,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAE,GAAwB,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAC5C,SAAS,IAAI,GAAG,IAAI,OAAQ,GAAwB,CAAC,OAAO,KAAK,SAAS,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/move-member/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,CAAN,IAAY,UAiBX;AAjBD,WAAY,UAAU;IACpB,SAAS;IACT,+BAAiB,CAAA;IACjB,SAAS;IACT,mCAAqB,CAAA;IACrB,eAAe;IACf,mCAAqB,CAAA;IACrB,SAAS;IACT,6BAAe,CAAA;IACf,SAAS;IACT,qCAAuB,CAAA;IACvB,WAAW;IACX,sCAAwB,CAAA;IACxB,SAAS;IACT,mCAAqB,CAAA;IACrB,SAAS;IACT,2BAAa,CAAA;AACf,CAAC,EAjBW,UAAU,KAAV,UAAU,QAiBrB;AAwBD;;GAEG;AACH,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,cAAc;IACd,gDAA8B,CAAA;IAC9B,aAAa;IACb,sCAAoB,CAAA;IACpB,cAAc;IACd,kDAAgC,CAAA;AAClC,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAoJD;;GAEG;AACH,MAAM,CAAN,IAAY,mBAmBX;AAnBD,WAAY,mBAAmB;IAC7B,YAAY;IACZ,0DAAmC,CAAA;IACnC,cAAc;IACd,mEAA4C,CAAA;IAC5C,kBAAkB;IAClB,6EAAsD,CAAA;IACtD,cAAc;IACd,qEAA8C,CAAA;IAC9C,WAAW;IACX,iEAA0C,CAAA;IAC1C,eAAe;IACf,wEAAiD,CAAA;IACjD,aAAa;IACb,mEAA4C,CAAA;IAC5C,WAAW;IACX,iDAA0B,CAAA;IAC1B,wBAAwB;IACxB,mEAA4C,CAAA;AAC9C,CAAC,EAnBW,mBAAmB,KAAnB,mBAAmB,QAmB9B;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAC5C,MAAM,IAAI,GAAG,IAAI,OAAQ,GAAwB,CAAC,IAAI,KAAK,QAAQ;QACnE,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAE,GAAwB,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAC5C,SAAS,IAAI,GAAG,IAAI,OAAQ,GAAwB,CAAC,OAAO,KAAK,SAAS,CAAC;AAC/E,CAAC"}

package/dist/core/move-member/utils/range-finder.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Range Finder
+ * 程式碼區塊範圍查找工具
+ */
+/**
+ * 找到程式碼區塊結尾（大括號配對）
+ *
+ * @param lines 程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 區塊結束行索引
+ */
+export declare function findBlockEnd(lines: string[], startLine: number): number;
+/**
+ * 在類別內找到程式碼區塊結尾
+ * 與 findBlockEnd 邏輯相同，語義上用於類別內部成員
+ *
+ * @param lines 類別內部程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 區塊結束行索引
+ */
+export declare function findBlockEndInClass(lines: string[], startLine: number): number;
+/**
+ * 找到類型別名結尾
+ * 支援多行 union/intersection 型別
+ *
+ * @param lines 程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 型別別名結束行索引
+ */
+export declare function findTypeAliasEnd(lines: string[], startLine: number): number;
+/**
+ * 找到陳述句結尾
+ * 處理多行箭頭函式：追蹤括號深度，避免將參數預設值的 `=` 誤判為語句結束
+ *
+ * @param lines 程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 陳述句結束行索引
+ */
+export declare function findStatementEnd(lines: string[], startLine: number): number;
+//# sourceMappingURL=range-finder.d.ts.map

package/dist/core/move-member/utils/range-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-finder.d.ts","sourceRoot":"","sources":["../../../../src/core/move-member/utils/range-finder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAmBvE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY3E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAiC3E"}

package/dist/core/move-member/utils/range-finder.js

@@ -0,0 +1,101 @@
+/**
+ * Range Finder
+ * 程式碼區塊範圍查找工具
+ */
+/**
+ * 找到程式碼區塊結尾（大括號配對）
+ *
+ * @param lines 程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 區塊結束行索引
+ */
+export function findBlockEnd(lines, startLine) {
+    let depth = 0;
+    let foundStart = false;
+    for (let i = startLine; i < lines.length; i++) {
+        for (const char of lines[i]) {
+            if (char === '{') {
+                depth++;
+                foundStart = true;
+            }
+            else if (char === '}') {
+                depth--;
+                if (foundStart && depth === 0) {
+                    return i;
+                }
+            }
+        }
+    }
+    return startLine;
+}
+/**
+ * 在類別內找到程式碼區塊結尾
+ * 與 findBlockEnd 邏輯相同，語義上用於類別內部成員
+ *
+ * @param lines 類別內部程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 區塊結束行索引
+ */
+export function findBlockEndInClass(lines, startLine) {
+    return findBlockEnd(lines, startLine);
+}
+/**
+ * 找到類型別名結尾
+ * 支援多行 union/intersection 型別
+ *
+ * @param lines 程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 型別別名結束行索引
+ */
+export function findTypeAliasEnd(lines, startLine) {
+    for (let i = startLine; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.includes(';')) {
+            return i;
+        }
+        // 非起始行且不是 union/intersection 續行
+        if (i > startLine && !line.trim().startsWith('|') && !line.trim().startsWith('&')) {
+            return i;
+        }
+    }
+    return startLine;
+}
+/**
+ * 找到陳述句結尾
+ * 處理多行箭頭函式：追蹤括號深度，避免將參數預設值的 `=` 誤判為語句結束
+ *
+ * @param lines 程式碼行陣列
+ * @param startLine 起始行索引（0-based）
+ * @returns 陳述句結束行索引
+ */
+export function findStatementEnd(lines, startLine) {
+    let parenDepth = 0;
+    for (let i = startLine; i < lines.length; i++) {
+        const line = lines[i];
+        // 追蹤括號深度
+        for (const char of line) {
+            if (char === '(') {
+                parenDepth++;
+            }
+            else if (char === ')') {
+                parenDepth--;
+            }
+        }
+        // 只有括號外的 `;` 或 `=` 才是語句結束
+        if (parenDepth === 0) {
+            if (line.includes(';')) {
+                return i;
+            }
+            // 非箭頭函式的賦值（且不是起始行）
+            if (line.includes('=') && !line.includes('=>') && i > startLine) {
+                return i;
+            }
+        }
+        // 檢查是否是多行箭頭函式或物件（括號必須已閉合）
+        if (parenDepth === 0 && line.includes('{')) {
+            return findBlockEnd(lines, i);
+        }
+    }
+    return startLine;
+}
+//# sourceMappingURL=range-finder.js.map

package/dist/core/move-member/utils/range-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-finder.js","sourceRoot":"","sources":["../../../../src/core/move-member/utils/range-finder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe,EAAE,SAAiB;IAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,KAAK,EAAE,CAAC;gBACR,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACxB,KAAK,EAAE,CAAC;gBACR,IAAI,UAAU,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAC9B,OAAO,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAe,EAAE,SAAiB;IACpE,OAAO,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAe,EAAE,SAAiB;IACjE,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,gCAAgC;QAChC,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAe,EAAE,SAAiB;IACjE,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,SAAS;QACT,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,UAAU,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACxB,UAAU,EAAE,CAAC;YACf,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,CAAC;YACX,CAAC;YACD,mBAAmB;YACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC;gBAChE,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,UAAU,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/rename/reference-updater.d.ts

@@ -15,6 +15,7 @@ export declare class ReferenceUpdater {
     private readonly fileCache;
     private readonly fileSystem;
     private readonly symbolFinder?;
+    private readonly fileUtils?;
     constructor(parserRegistry?: ParserRegistry, fileSystem?: IFileSystem);
     /**
      * 尋找檔案中的符號引用
@@ -62,6 +63,10 @@ export declare class ReferenceUpdater {
      * 取得檔案內容
      */
     private getFileContent;
+    /**
+     * 降級檔案讀取方法（當 FileUtils 不可用時）
+     */
+    private readFileFallback;
     /**
      * 檢查是否在註解中
      */

package/dist/core/rename/reference-updater.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference-updater.d.ts","sourceRoot":"","sources":["../../../src/core/rename/reference-updater.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;gBAEjC,cAAc,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,WAAW;IASrE;;;OAGG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC;IAgC7B;;;;;;;;;OASG;IACG,8BAA8B,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC;IA2B7B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;YACW,0BAA0B;IA6CxC;;;;;;OAMG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,EAAE,CAAC;IA2DzD;;OAEG;IACG,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;OAEG;YACW,cAAc;IAe5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"reference-updater.d.ts","sourceRoot":"","sources":["../../../src/core/rename/reference-updater.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAY;gBAE3B,cAAc,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,WAAW;IAUrE;;;OAGG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC;IAgC7B;;;;;;;;;OASG;IACG,8BAA8B,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC;IA2B7B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;YACW,0BAA0B;IAiDxC;;;;;;OAMG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,EAAE,CAAC;IA2DzD;;OAEG;IACG,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;OAEG;YACW,cAAc;IAgB5B;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/core/rename/reference-updater.js

@@ -4,7 +4,7 @@
  * 使用 SymbolFinder 進行精確的 AST 分析
  */
 import { FileSystem } from '../../infrastructure/storage/index.js';
-import { createSymbolFinder, SymbolReferenceType } from '../shared/symbol-finder/index.js';
+import { createSymbolFinder, SymbolReferenceType, createFileUtils } from '../foundations/index.js';
 /**
  * 引用更新器類別
  * 使用 SymbolFinder 進行精確的 AST 分析
@@ -13,11 +13,13 @@ export class ReferenceUpdater {
     fileCache = new Map();
     fileSystem;
     symbolFinder;
+    fileUtils;
     constructor(parserRegistry, fileSystem) {
         // eslint-disable-next-line custom/no-new-filesystem, custom/no-default-instance-in-constructor -- 需要向後相容
         this.fileSystem = fileSystem ?? new FileSystem();
         if (parserRegistry) {
             this.symbolFinder = createSymbolFinder(parserRegistry, this.fileSystem);
+            this.fileUtils = createFileUtils(this.fileSystem, parserRegistry);
         }
     }
     /**
@@ -33,7 +35,7 @@ export class ReferenceUpdater {
         if (this.symbolFinder) {
             try {
                 const refs = await this.symbolFinder.findReferencesInFile(filePath, symbolName);
-                // 轉換 SymbolFinder 的 SymbolReference (@core/shared/symbol-finder)
+                // 轉換 SymbolFinder 的 SymbolReference (@core/foundations/symbol-finder)
                 // 為本地型別 SymbolReference (@core/rename/types)
                 // 兩者差異：
                 // - SymbolFinder 版本：{ symbolName, location: Location, type: SymbolReferenceType, context? }
@@ -116,9 +118,12 @@ export class ReferenceUpdater {
         }
         const references = [];
         const lines = content.split('\n');
+        // 快取 RegExp 避免重複編譯
+        const regex = new RegExp(`\\b${this.escapeRegex(symbolName)}\\b`, 'g');
         for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
             const line = lines[lineIndex];
-            const regex = new RegExp(`\\b${this.escapeRegex(symbolName)}\\b`, 'g');
+            // 重置 lastIndex 以便在每行重新匹配
+            regex.lastIndex = 0;
             let match;
             while ((match = regex.exec(line)) !== null) {
                 // 跳過字串字面值內的匹配
@@ -223,10 +228,21 @@ export class ReferenceUpdater {
         if (this.fileCache.has(filePath)) {
             return this.fileCache.get(filePath);
         }
+        // 優先使用 FileUtils，降級使用 fileSystem
+        const content = this.fileUtils
+            ? await this.fileUtils.readFile(filePath)
+            : await this.readFileFallback(filePath);
+        if (content) {
+            this.fileCache.set(filePath, content);
+        }
+        return content;
+    }
+    /**
+     * 降級檔案讀取方法（當 FileUtils 不可用時）
+     */
+    async readFileFallback(filePath) {
         try {
-            // 使用注入的 fileSystem 讀取檔案
             const content = await this.fileSystem.readFile(filePath, 'utf-8');
-            this.fileCache.set(filePath, content);
             return content;
         }
         catch {