agent-ide 0.1.0

package/dist/core/rename/scope-analyzer.js

@@ -0,0 +1,269 @@
+/**
+ * 作用域分析器實作
+ * 負責分析程式碼的作用域結構和符號可見性
+ */
+import { SymbolType, createSymbol } from '../../shared/types/symbol.js';
+import { createLocation, isPositionInRange } from '../../shared/types/core.js';
+/**
+ * 作用域分析器類別
+ */
+export class ScopeAnalyzer {
+    currentScopes = [];
+    symbolTable = new Map();
+    /**
+     * 分析 AST 的作用域結構
+     */
+    async analyzeScopes(ast) {
+        this.currentScopes = [];
+        this.symbolTable.clear();
+        // 檢查 AST 是否有效
+        if (!ast || !ast.root) {
+            // 返回空的作用域列表
+            return [];
+        }
+        // 建立全域作用域
+        const globalScope = {
+            type: 'global',
+            symbols: [],
+            range: ast.root.range || {
+                start: { line: 1, column: 0 },
+                end: { line: 1, column: 0 }
+            }
+        };
+        this.currentScopes.push(globalScope);
+        // 遞歸分析 AST 節點
+        await this.analyzeNode(ast.root, globalScope);
+        return this.currentScopes;
+    }
+    /**
+     * 尋找被遮蔽的變數
+     */
+    async findShadowedVariables(ast) {
+        const scopes = await this.analyzeScopes(ast);
+        const shadowedVars = [];
+        // 檢查每個作用域的符號
+        for (const scope of scopes) {
+            for (const symbol of scope.symbols) {
+                const shadows = this.findShadowingSymbols(symbol, scopes, scope);
+                if (shadows.length > 0) {
+                    const existing = shadowedVars.find(sv => sv.name === symbol.name);
+                    if (existing) {
+                        existing.shadowedBy.push(...shadows);
+                    }
+                    else {
+                        shadowedVars.push({
+                            name: symbol.name,
+                            originalSymbol: symbol,
+                            shadowedBy: shadows
+                        });
+                    }
+                }
+            }
+        }
+        return shadowedVars;
+    }
+    /**
+     * 根據位置取得對應的作用域
+     */
+    async getScopeAtPosition(position) {
+        // 找到包含該位置的最具體的作用域
+        let targetScope = null;
+        let bestDepth = -1;
+        for (const scope of this.currentScopes) {
+            if (isPositionInRange(position, scope.range)) {
+                const depth = this.getScopeDepth(scope);
+                if (depth > bestDepth) {
+                    bestDepth = depth;
+                    targetScope = scope;
+                }
+            }
+        }
+        return targetScope;
+    }
+    /**
+     * 檢查符號在特定作用域中是否可見
+     */
+    async isSymbolVisible(symbolName, scope) {
+        // 檢查當前作用域
+        if (scope.symbols.some(s => s.name === symbolName)) {
+            return true;
+        }
+        // 檢查父作用域（向上遍歷）
+        let currentScope = scope.parent;
+        while (currentScope) {
+            if (currentScope.symbols.some(s => s.name === symbolName)) {
+                return true;
+            }
+            currentScope = currentScope.parent;
+        }
+        return false;
+    }
+    /**
+     * 遞歸分析 AST 節點
+     */
+    async analyzeNode(node, parentScope) {
+        let currentScope = parentScope;
+        // 函式宣告需要特殊處理：函式名加到父作用域，但參數和內容在新作用域
+        if (node.type === 'FunctionDeclaration') {
+            // 把函式名加到父作用域
+            const symbol = this.createSymbolFromNode(node);
+            if (symbol) {
+                parentScope.symbols.push(symbol);
+                this.addToSymbolTable(symbol);
+            }
+            // 建立函式作用域
+            currentScope = this.createScope(node, parentScope);
+            this.currentScopes.push(currentScope);
+        }
+        else if (this.shouldCreateScope(node)) {
+            // 其他類型的作用域
+            currentScope = this.createScope(node, parentScope);
+            this.currentScopes.push(currentScope);
+        }
+        else if (this.isSymbolDefinition(node)) {
+            // 一般符號定義
+            const symbol = this.createSymbolFromNode(node);
+            if (symbol) {
+                currentScope.symbols.push(symbol);
+                this.addToSymbolTable(symbol);
+            }
+        }
+        // 遞歸處理子節點
+        for (const child of node.children) {
+            await this.analyzeNode(child, currentScope);
+        }
+    }
+    /**
+     * 檢查是否應該為節點建立新的作用域
+     */
+    shouldCreateScope(node) {
+        const scopeTypes = [
+            'FunctionDeclaration',
+            'FunctionExpression',
+            'ArrowFunctionExpression',
+            'BlockStatement',
+            'ClassDeclaration'
+        ];
+        return scopeTypes.includes(node.type);
+    }
+    /**
+     * 為節點建立作用域
+     */
+    createScope(node, parent) {
+        const scopeType = this.getScopeType(node.type);
+        const name = node.properties.name;
+        return {
+            type: scopeType,
+            name,
+            parent,
+            symbols: [],
+            range: node.range
+        };
+    }
+    /**
+     * 取得作用域類型
+     */
+    getScopeType(nodeType) {
+        const typeMap = {
+            'FunctionDeclaration': 'function',
+            'FunctionExpression': 'function',
+            'ArrowFunctionExpression': 'function',
+            'ClassDeclaration': 'class',
+            'BlockStatement': 'block'
+        };
+        return typeMap[nodeType] || 'block';
+    }
+    /**
+     * 檢查是否為符號定義
+     */
+    isSymbolDefinition(node) {
+        const definitionTypes = [
+            'VariableDeclaration',
+            'FunctionDeclaration',
+            'ClassDeclaration',
+            'Parameter'
+        ];
+        return definitionTypes.includes(node.type);
+    }
+    /**
+     * 從 AST 節點建立符號
+     */
+    createSymbolFromNode(node) {
+        const name = node.properties.name;
+        if (!name) {
+            return null;
+        }
+        const symbolType = this.getSymbolType(node.type);
+        const location = createLocation('/test/file.ts', node.range); // 暫時使用測試檔案路徑
+        return createSymbol(name, symbolType, location);
+    }
+    /**
+     * 取得符號類型
+     */
+    getSymbolType(nodeType) {
+        const typeMap = {
+            'VariableDeclaration': SymbolType.Variable,
+            'FunctionDeclaration': SymbolType.Function,
+            'ClassDeclaration': SymbolType.Class,
+            'Parameter': SymbolType.Variable
+        };
+        return typeMap[nodeType] || SymbolType.Variable;
+    }
+    /**
+     * 添加符號到符號表
+     */
+    addToSymbolTable(symbol) {
+        const existing = this.symbolTable.get(symbol.name) || [];
+        existing.push(symbol);
+        this.symbolTable.set(symbol.name, existing);
+    }
+    /**
+     * 找到遮蔽指定符號的其他符號
+     */
+    findShadowingSymbols(symbol, allScopes, symbolScope) {
+        const shadows = [];
+        for (const scope of allScopes) {
+            // 跳過符號所在的作用域
+            if (scope === symbolScope) {
+                continue;
+            }
+            // 檢查是否為子作用域（會遮蔽父作用域的符號）
+            if (this.isChildScope(scope, symbolScope)) {
+                const shadowingSymbol = scope.symbols.find(s => s.name === symbol.name);
+                if (shadowingSymbol) {
+                    shadows.push({
+                        symbol: shadowingSymbol,
+                        scope
+                    });
+                }
+            }
+        }
+        return shadows;
+    }
+    /**
+     * 檢查是否為子作用域
+     */
+    isChildScope(child, parent) {
+        let currentParent = child.parent;
+        while (currentParent) {
+            if (currentParent === parent) {
+                return true;
+            }
+            currentParent = currentParent.parent;
+        }
+        return false;
+    }
+    /**
+     * 取得作用域深度
+     */
+    getScopeDepth(scope) {
+        let depth = 0;
+        let current = scope.parent;
+        while (current) {
+            depth++;
+            current = current.parent;
+        }
+        return depth;
+    }
+}
+//# sourceMappingURL=scope-analyzer.js.map

package/dist/core/rename/scope-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-analyzer.js","sourceRoot":"","sources":["../../../src/core/rename/scope-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAU,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/E;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,aAAa,GAA0B,EAAE,CAAC;IAC1C,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,GAAQ;QAC1B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAEzB,cAAc;QACd,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtB,YAAY;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,UAAU;QACV,MAAM,WAAW,GAAwB;YACvC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI;gBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC7B,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;aAC5B;SACF,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAErC,cAAc;QACd,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,GAAQ;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAuB,EAAE,CAAC;QAE5C,aAAa;QACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;gBACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;oBAClE,IAAI,QAAQ,EAAE,CAAC;wBACZ,QAAQ,CAAC,UAA2B,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;oBACzD,CAAC;yBAAM,CAAC;wBACN,YAAY,CAAC,IAAI,CAAC;4BAChB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,cAAc,EAAE,MAAM;4BACtB,UAAU,EAAE,OAAO;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,QAAkB;QACzC,kBAAkB;QAClB,IAAI,WAAW,GAA+B,IAAI,CAAC;QACnD,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;QAEnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,IAAI,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBACxC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;oBACtB,SAAS,GAAG,KAAK,CAAC;oBAClB,WAAW,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,KAA0B;QAClE,UAAU;QACV,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,eAAe;QACf,IAAI,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;QAChC,OAAO,YAAY,EAAE,CAAC;YACpB,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC;YACd,CAAC;YACD,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;QACrC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,IAAa,EAAE,WAAgC;QACvE,IAAI,YAAY,GAAG,WAAW,CAAC;QAE/B,mCAAmC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACxC,aAAa;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,MAAM,EAAE,CAAC;gBACV,WAAW,CAAC,OAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,UAAU;YACV,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACnD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,WAAW;YACX,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACnD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,SAAS;YACT,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,MAAM,EAAE,CAAC;gBACV,YAAY,CAAC,OAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,UAAU;QACV,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAa;QACrC,MAAM,UAAU,GAAG;YACjB,qBAAqB;YACrB,oBAAoB;YACpB,yBAAyB;YACzB,gBAAgB;YAChB,kBAAkB;SACnB,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAa,EAAE,MAA2B;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAA0B,CAAC;QAExD,OAAO;YACL,IAAI,EAAE,SAAS;YACf,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAgB;QACnC,MAAM,OAAO,GAA2B;YACtC,qBAAqB,EAAE,UAAU;YACjC,oBAAoB,EAAE,UAAU;YAChC,yBAAyB,EAAE,UAAU;YACrC,kBAAkB,EAAE,OAAO;YAC3B,gBAAgB,EAAE,OAAO;SAC1B,CAAC;QAEF,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC;IACtC,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,IAAa;QACtC,MAAM,eAAe,GAAG;YACtB,qBAAqB;YACrB,qBAAqB;YACrB,kBAAkB;YAClB,WAAW;SACZ,CAAC;QACF,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAa;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAc,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,OAAO,IAAI,CAAC;QAAA,CAAC;QAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa;QAE3E,OAAO,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAgB;QACpC,MAAM,OAAO,GAA+B;YAC1C,qBAAqB,EAAE,UAAU,CAAC,QAAQ;YAC1C,qBAAqB,EAAE,UAAU,CAAC,QAAQ;YAC1C,kBAAkB,EAAE,UAAU,CAAC,KAAK;YACpC,WAAW,EAAE,UAAU,CAAC,QAAQ;SACjC,CAAC;QAEF,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAc;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACK,oBAAoB,CAC1B,MAAc,EACd,SAAgC,EAChC,WAAgC;QAEhC,MAAM,OAAO,GAAiB,EAAE,CAAC;QAEjC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,aAAa;YACb,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;gBAAA,SAAS;YAAA,CAAC;YAEtC,wBAAwB;YACxB,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC1C,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;gBACxE,IAAI,eAAe,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,eAAe;wBACvB,KAAK;qBACN,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAA0B,EAAE,MAA2B;QAC1E,IAAI,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,OAAO,aAAa,EAAE,CAAC;YACrB,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAA0B;QAC9C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,OAAO,OAAO,EAAE,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/core/rename/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * 重新命名引擎相關型別定義
+ * 包含 RenameOptions、RenameResult、ValidationResult 等型別
+ */
+import { Location, Position, Range } from '../../shared/types/core.js';
+import { Symbol } from '../../shared/types/symbol.js';
+/**
+ * 重新命名選項
+ */
+export interface RenameOptions {
+    readonly symbol: Symbol;
+    readonly newName: string;
+    readonly filePaths: readonly string[];
+    readonly position?: Position;
+}
+/**
+ * 重新命名操作
+ */
+export interface RenameOperation {
+    readonly filePath: string;
+    readonly oldText: string;
+    readonly newText: string;
+    readonly range: Range;
+}
+/**
+ * 重新命名結果
+ */
+export interface RenameResult {
+    readonly success: boolean;
+    readonly operations: readonly RenameOperation[];
+    readonly affectedFiles: readonly string[];
+    readonly renameId: string;
+    readonly errors?: readonly string[];
+}
+/**
+ * 批次重新命名結果
+ */
+export interface BatchRenameResult {
+    readonly success: boolean;
+    readonly results: readonly RenameResult[];
+    readonly totalOperations: number;
+    readonly errors?: readonly string[];
+}
+/**
+ * 驗證結果
+ */
+export interface ValidationResult {
+    readonly isValid: boolean;
+    readonly conflicts: readonly ConflictInfo[];
+    readonly warnings?: readonly string[];
+    readonly errors?: readonly string[];
+}
+/**
+ * 衝突資訊
+ */
+export interface ConflictInfo {
+    readonly type: ConflictType;
+    readonly message: string;
+    readonly location: Location;
+    readonly existingSymbol?: Symbol;
+}
+/**
+ * 衝突類型
+ */
+export declare enum ConflictType {
+    NameCollision = "name_collision",// 名稱衝突
+    ScopeConflict = "scope_conflict",// 作用域衝突
+    ReservedKeyword = "reserved_keyword",// 保留字衝突
+    InvalidIdentifier = "invalid_identifier"
+}
+/**
+ * 重新命名預覽
+ */
+export interface RenamePreview {
+    readonly operations: readonly RenameOperation[];
+    readonly affectedFiles: readonly string[];
+    readonly conflicts: readonly ConflictInfo[];
+    readonly summary: RenameSummary;
+}
+/**
+ * 重新命名摘要
+ */
+export interface RenameSummary {
+    readonly totalReferences: number;
+    readonly totalFiles: number;
+    readonly conflictCount: number;
+    readonly estimatedTime: number;
+}
+/**
+ * 建立 RenameOptions 的工廠函式
+ */
+export declare function createRenameOptions(symbol: Symbol, newName: string, filePaths: string[], position?: Position): RenameOptions;
+/**
+ * 建立 RenameOperation 的工廠函式
+ */
+export declare function createRenameOperation(filePath: string, oldText: string, newText: string, range: Range): RenameOperation;
+/**
+ * 建立 ConflictInfo 的工廠函式
+ */
+export declare function createConflictInfo(type: ConflictType, message: string, location: Location, existingSymbol?: Symbol): ConflictInfo;
+/**
+ * 作用域分析結果
+ */
+export interface ScopeAnalysisResult {
+    readonly type: string;
+    readonly name?: string;
+    readonly parent?: ScopeAnalysisResult;
+    readonly symbols: readonly Symbol[];
+    readonly range: Range;
+}
+/**
+ * 變數遮蔽資訊
+ */
+export interface ShadowedVariable {
+    readonly name: string;
+    readonly originalSymbol: Symbol;
+    readonly shadowedBy: readonly ShadowInfo[];
+}
+/**
+ * 遮蔽資訊
+ */
+export interface ShadowInfo {
+    readonly symbol: Symbol;
+    readonly scope: ScopeAnalysisResult;
+}
+/**
+ * 引用更新結果
+ */
+export interface UpdateResult {
+    readonly success: boolean;
+    readonly updatedFiles: readonly UpdatedFile[];
+    readonly errors?: readonly string[];
+}
+/**
+ * 更新後的檔案
+ */
+export interface UpdatedFile {
+    readonly filePath: string;
+    readonly originalContent: string;
+    readonly newContent: string;
+    readonly changes: readonly TextChange[];
+}
+/**
+ * 文字變更
+ */
+export interface TextChange {
+    readonly range: Range;
+    readonly oldText: string;
+    readonly newText: string;
+}
+/**
+ * 符號引用
+ */
+export interface SymbolReference {
+    readonly symbolName: string;
+    readonly range: Range;
+    readonly type: 'definition' | 'usage' | 'comment';
+}
+/**
+ * RenameOptions 型別守衛
+ */
+export declare function isRenameOptions(value: unknown): value is RenameOptions;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/rename/types.d.ts.map

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

package/dist/core/rename/types.js

@@ -0,0 +1,80 @@
+/**
+ * 重新命名引擎相關型別定義
+ * 包含 RenameOptions、RenameResult、ValidationResult 等型別
+ */
+/**
+ * 衝突類型
+ */
+export var ConflictType;
+(function (ConflictType) {
+    ConflictType["NameCollision"] = "name_collision";
+    ConflictType["ScopeConflict"] = "scope_conflict";
+    ConflictType["ReservedKeyword"] = "reserved_keyword";
+    ConflictType["InvalidIdentifier"] = "invalid_identifier"; // 無效識別符
+})(ConflictType || (ConflictType = {}));
+/**
+ * 建立 RenameOptions 的工廠函式
+ */
+export function createRenameOptions(symbol, newName, filePaths, position) {
+    if (!newName.trim()) {
+        throw new Error('新名稱不能為空');
+    }
+    if (filePaths.length === 0) {
+        throw new Error('必須指定至少一個檔案路徑');
+    }
+    return {
+        symbol,
+        newName: newName.trim(),
+        filePaths,
+        position
+    };
+}
+/**
+ * 建立 RenameOperation 的工廠函式
+ */
+export function createRenameOperation(filePath, oldText, newText, range) {
+    if (!filePath.trim()) {
+        throw new Error('檔案路徑不能為空');
+    }
+    if (!oldText.trim()) {
+        throw new Error('舊文字不能為空');
+    }
+    if (!newText.trim()) {
+        throw new Error('新文字不能為空');
+    }
+    return {
+        filePath,
+        oldText,
+        newText,
+        range
+    };
+}
+/**
+ * 建立 ConflictInfo 的工廠函式
+ */
+export function createConflictInfo(type, message, location, existingSymbol) {
+    if (!message.trim()) {
+        throw new Error('衝突訊息不能為空');
+    }
+    return {
+        type,
+        message,
+        location,
+        existingSymbol
+    };
+}
+/**
+ * RenameOptions 型別守衛
+ */
+export function isRenameOptions(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return !!(obj.symbol && typeof obj.symbol === 'object' &&
+        typeof obj.newName === 'string' &&
+        obj.newName.trim().length > 0 &&
+        Array.isArray(obj.filePaths) &&
+        obj.filePaths.length > 0);
+}
+//# sourceMappingURL=types.js.map

package/dist/core/rename/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/rename/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkEH;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,gDAAgC,CAAA;IAChC,gDAAgC,CAAA;IAChC,oDAAoC,CAAA;IACpC,wDAAwC,CAAA,CAAC,QAAQ;AACnD,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAsBD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,OAAe,EACf,SAAmB,EACnB,QAAmB;IAEnB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACvB,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,OAAe,EACf,OAAe,EACf,KAAY;IAEZ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,OAAe,EACf,QAAkB,EAClB,cAAuB;IAEvB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,cAAc;KACf,CAAC;AACJ,CAAC;AAmED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,OAAO,CAAC,CAAC,CACP,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC5C,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAC5B,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CACzB,CAAC;AACJ,CAAC"}

package/dist/core/search/engines/text-engine.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 文字搜尋引擎實作
+ * 提供高效的文字搜尋功能，支援正則表達式、模糊匹配等
+ */
+import type { TextQuery, SearchResult } from '../types.js';
+/**
+ * 文字搜尋引擎
+ */
+export declare class TextSearchEngine {
+    private readonly defaultOptions;
+    /**
+     * 執行文字搜尋
+     */
+    search(query: TextQuery): Promise<SearchResult>;
+    /**
+     * 在單個檔案中搜尋
+     */
+    private searchInFile;
+    /**
+     * 建立搜尋正則表達式
+     */
+    private buildSearchRegex;
+    /**
+     * 建立匹配上下文
+     */
+    private buildContext;
+    /**
+     * 尋找包圍的函式名稱
+     */
+    private findEnclosingFunction;
+    /**
+     * 尋找包圍的類別名稱
+     */
+    private findEnclosingClass;
+    /**
+     * 計算字符偏移量
+     */
+    private calculateOffset;
+    /**
+     * 計算匹配分數
+     */
+    private calculateScore;
+    /**
+     * 排序匹配結果
+     */
+    private sortMatches;
+    /**
+     * 獲取要搜尋的檔案列表
+     */
+    private getSearchFiles;
+}
+//# sourceMappingURL=text-engine.d.ts.map

package/dist/core/search/engines/text-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/search/engines/text-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,SAAS,EAET,YAAY,EAIb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAe7B;IAEF;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAgErD;;OAEG;YACW,YAAY;IAuE1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4CxB;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;YACW,cAAc;CAmG7B"}