agent-ide 0.2.0 → 0.3.3

package/dist/core/transform/shared/code-editor.js

@@ -0,0 +1,206 @@
+/**
+ * 統一的程式碼編輯器
+ * 處理所有 TextChange 的應用，確保位置偏移正確
+ */
+/**
+ * 程式碼編輯器
+ * 提供統一的文字變更應用機制
+ */
+export class CodeEditor {
+    /**
+     * 應用多個文字變更到內容
+     * 自動處理位置偏移（從後往前應用）
+     */
+    applyChanges(content, changes) {
+        if (changes.length === 0) {
+            return content;
+        }
+        // 排序：從後往前應用，避免位置偏移問題
+        const sortedChanges = [...changes].sort((a, b) => {
+            const lineDiff = b.range.start.line - a.range.start.line;
+            if (lineDiff !== 0) {
+                return lineDiff;
+            }
+            return b.range.start.column - a.range.start.column;
+        });
+        let result = content;
+        for (const change of sortedChanges) {
+            result = this.applySingleChange(result, change);
+        }
+        return result;
+    }
+    /**
+     * 建立 FileChange 物件
+     */
+    createFileChange(filePath, originalContent, changes) {
+        const newContent = this.applyChanges(originalContent, changes);
+        return {
+            filePath,
+            originalContent,
+            newContent,
+            textChanges: changes
+        };
+    }
+    /**
+     * 計算變更的預覽（不實際應用）
+     */
+    previewChanges(content, changes) {
+        const lines = content.split('\n');
+        return changes.map(change => {
+            const startLine = change.range.start.line - 1; // 轉為 0-based
+            const endLine = change.range.end.line - 1;
+            const contextStart = Math.max(0, startLine - 2);
+            const contextEnd = Math.min(lines.length - 1, endLine + 2);
+            return {
+                change,
+                contextBefore: lines.slice(contextStart, startLine).join('\n'),
+                affectedLines: lines.slice(startLine, endLine + 1).join('\n'),
+                contextAfter: lines.slice(endLine + 1, contextEnd + 1).join('\n')
+            };
+        });
+    }
+    /**
+     * 合併重疊的變更
+     */
+    mergeOverlappingChanges(changes) {
+        if (changes.length <= 1) {
+            return [...changes];
+        }
+        // 按位置排序
+        const sorted = [...changes].sort((a, b) => {
+            const lineDiff = a.range.start.line - b.range.start.line;
+            if (lineDiff !== 0) {
+                return lineDiff;
+            }
+            return a.range.start.column - b.range.start.column;
+        });
+        const merged = [];
+        let current = sorted[0];
+        for (let i = 1; i < sorted.length; i++) {
+            const next = sorted[i];
+            if (this.rangesOverlap(current.range, next.range)) {
+                // 合併重疊的變更
+                current = this.mergeChanges(current, next);
+            }
+            else {
+                merged.push(current);
+                current = next;
+            }
+        }
+        merged.push(current);
+        return merged;
+    }
+    /**
+     * 驗證變更是否有效
+     */
+    validateChanges(content, changes) {
+        const lines = content.split('\n');
+        const errors = [];
+        for (const change of changes) {
+            // 檢查行號範圍
+            if (change.range.start.line < 1 || change.range.start.line > lines.length + 1) {
+                errors.push(`無效的起始行號: ${change.range.start.line}`);
+            }
+            if (change.range.end.line < 1 || change.range.end.line > lines.length + 1) {
+                errors.push(`無效的結束行號: ${change.range.end.line}`);
+            }
+            // 檢查行號順序
+            if (change.range.start.line > change.range.end.line) {
+                errors.push(`起始行號大於結束行號: ${change.range.start.line} > ${change.range.end.line}`);
+            }
+            // 檢查同一行時的列號順序
+            if (change.range.start.line === change.range.end.line
+                && change.range.start.column > change.range.end.column) {
+                errors.push(`起始列號大於結束列號: ${change.range.start.column} > ${change.range.end.column}`);
+            }
+        }
+        return {
+            isValid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * 應用單一變更
+     */
+    applySingleChange(content, change) {
+        const lines = content.split('\n');
+        const startLine = change.range.start.line - 1; // 轉為 0-based
+        const endLine = change.range.end.line - 1;
+        const startColumn = change.range.start.column - 1;
+        const endColumn = change.range.end.column - 1;
+        // 處理邊界情況
+        if (startLine < 0 || startLine >= lines.length) {
+            return content;
+        }
+        // 取得要替換的範圍前後的內容
+        const beforeStart = lines.slice(0, startLine).join('\n');
+        const afterEnd = lines.slice(endLine + 1).join('\n');
+        // 取得起始行和結束行
+        const startLineContent = lines[startLine] || '';
+        const endLineContent = lines[Math.min(endLine, lines.length - 1)] || '';
+        // 組合新內容
+        const prefix = startLineContent.substring(0, startColumn);
+        const suffix = endLineContent.substring(endColumn);
+        const newLineContent = prefix + change.newText + suffix;
+        // 重組整個內容
+        const parts = [];
+        if (beforeStart) {
+            parts.push(beforeStart);
+        }
+        parts.push(newLineContent);
+        if (afterEnd) {
+            parts.push(afterEnd);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * 檢查兩個範圍是否重疊
+     */
+    rangesOverlap(a, b) {
+        // a 完全在 b 之後
+        if (a.start.line > b.end.line
+            || (a.start.line === b.end.line && a.start.column > b.end.column)) {
+            return false;
+        }
+        // a 完全在 b 之前
+        if (a.end.line < b.start.line
+            || (a.end.line === b.start.line && a.end.column < b.start.column)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 合併兩個重疊的變更
+     */
+    mergeChanges(a, b) {
+        // 取較早的起始位置
+        const start = this.isPositionBefore(a.range.start, b.range.start)
+            ? a.range.start
+            : b.range.start;
+        // 取較晚的結束位置
+        const end = this.isPositionBefore(a.range.end, b.range.end)
+            ? b.range.end
+            : a.range.end;
+        return {
+            range: { start, end },
+            oldText: a.oldText + b.oldText, // 簡化合併
+            newText: a.newText + b.newText
+        };
+    }
+    /**
+     * 比較兩個位置的先後
+     */
+    isPositionBefore(a, b) {
+        if (a.line !== b.line) {
+            return a.line < b.line;
+        }
+        return a.column < b.column;
+    }
+}
+/**
+ * 建立 CodeEditor 實例
+ */
+export function createCodeEditor() {
+    return new CodeEditor();
+}
+//# sourceMappingURL=code-editor.js.map

package/dist/core/transform/shared/code-editor.js.map

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

package/dist/core/transform/shared/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transform 共享元件
+ * 提供跨子模組共用的工具類別
+ */
+export * from './code-editor.js';
+export * from './symbol-finder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/transform/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/transform/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/core/transform/shared/index.js

@@ -0,0 +1,7 @@
+/**
+ * Transform 共享元件
+ * 提供跨子模組共用的工具類別
+ */
+export * from './code-editor.js';
+export * from './symbol-finder.js';
+//# sourceMappingURL=index.js.map

package/dist/core/transform/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/transform/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,154 @@
+/**
+ * 統一的符號查找器
+ * 整合 AST 分析和文字匹配，提供跨檔案符號查找能力
+ */
+import type { Range, Location } from '../../../shared/types/core.js';
+import type { Symbol } from '../../../shared/types/symbol.js';
+import type { ParserRegistry } from '../../../infrastructure/parser/registry.js';
+import type { IFileSystem } from '../../../infrastructure/storage/file-system.interface.js';
+/**
+ * 符號引用
+ */
+export interface SymbolReference {
+    readonly symbolName: string;
+    readonly location: Location;
+    readonly type: SymbolReferenceType;
+    readonly context?: 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;
+}
+/**
+ * 符號查找器
+ */
+export declare class SymbolFinder {
+    private readonly parserRegistry;
+    private readonly fileSystem;
+    constructor(parserRegistry: ParserRegistry, fileSystem: IFileSystem);
+    /**
+     * 查找符號定義
+     */
+    findDefinition(filePath: string, symbolName: string): Promise<SymbolDefinition | null>;
+    /**
+     * 查找所有引用
+     */
+    findReferences(symbolName: string, projectFiles: readonly string[]): Promise<SymbolReference[]>;
+    /**
+     * 查找檔案中的符號引用
+     */
+    findReferencesInFile(filePath: string, symbolName: string): Promise<SymbolReference[]>;
+    /**
+     * 查找函式的所有呼叫點
+     */
+    findCallSites(functionName: string, projectFiles: readonly string[]): Promise<CallSite[]>;
+    /**
+     * 查找檔案中的函式呼叫點
+     */
+    findCallSitesInFile(filePath: string, functionName: string): Promise<CallSite[]>;
+    /**
+     * 查找類別成員
+     */
+    findClassMembers(filePath: string, className: string): Promise<ClassMember[]>;
+    /**
+     * 讀取檔案內容
+     */
+    private readFile;
+    /**
+     * 取得對應的 Parser
+     */
+    private getParser;
+    /**
+     * 取得檔案副檔名
+     */
+    private getFileExtension;
+    /**
+     * 使用文字匹配查找引用（降級方法）
+     */
+    private findReferencesByText;
+    /**
+     * 提取函式簽名
+     */
+    private extractSignature;
+    /**
+     * 提取文件註解
+     */
+    private extractDocumentation;
+    /**
+     * 提取參數字串
+     */
+    private extractArgumentsString;
+    /**
+     * 解析參數
+     */
+    private parseArguments;
+    /**
+     * 分割參數（考慮巢狀括號）
+     */
+    private splitArguments;
+    /**
+     * 符號類型轉換為成員類型
+     */
+    private symbolTypeToMemberType;
+    /**
+     * 跳脫正則表達式特殊字元
+     */
+    private escapeRegex;
+}
+/**
+ * 建立 SymbolFinder 實例
+ */
+export declare function createSymbolFinder(parserRegistry: ParserRegistry, fileSystem: IFileSystem): SymbolFinder;
+//# sourceMappingURL=symbol-finder.d.ts.map

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

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