agent-ide 0.8.1 → 0.9.0

package/dist/core/deadcode/import-cleaner.js

@@ -0,0 +1,229 @@
+/**
+ * Import 清理器
+ * 負責分析和清理未使用的 import
+ */
+import { createSymbolFinder, SymbolReferenceType } from '../shared/symbol-finder/index.js';
+import { ImportParser } from './import-parser.js';
+/**
+ * Import 清理器
+ */
+export class ImportCleaner {
+    fileSystem;
+    importParser;
+    symbolFinder;
+    fileCache = new Map();
+    /** 符號引用快取：key = `${filePath}:${symbolName}` */
+    referenceCache = new Map();
+    constructor(fileSystem, parserRegistry) {
+        this.fileSystem = fileSystem;
+        this.importParser = new ImportParser(parserRegistry);
+        this.symbolFinder = createSymbolFinder(parserRegistry, fileSystem);
+    }
+    /**
+     * 分析需要清理的 import
+     * 支援部分清理：當 import { A, B, C } 中只有部分符號未使用時，保留其他符號
+     */
+    async analyzeImportCleanups(removals) {
+        const cleanups = [];
+        const warnings = [];
+        const affectedFiles = new Set(removals.map(r => r.filePath));
+        const removedSymbols = new Set(removals.map(r => r.symbolName));
+        for (const filePath of affectedFiles) {
+            const content = await this.readFile(filePath);
+            if (!content) {
+                warnings.push(`跳過 import 清理：無法讀取檔案 ${filePath}`);
+                continue;
+            }
+            // 解析 import 語句（以語句為單位）
+            const importStatements = this.importParser.parseImportStatements(content, filePath);
+            const fileRemovals = removals.filter(r => r.filePath === filePath);
+            for (const stmt of importStatements) {
+                // 找出此 import 中需要清理的符號
+                const unusedSymbols = [];
+                const usedSymbols = [];
+                for (const symbol of stmt.symbols) {
+                    // 符號是否在被刪除的列表中，且刪除後不再使用
+                    if (removedSymbols.has(symbol.name)) {
+                        const stillUsed = await this.isImportStillUsed(filePath, symbol.name, fileRemovals);
+                        if (!stillUsed) {
+                            unusedSymbols.push(symbol.name);
+                        }
+                        else {
+                            usedSymbols.push(symbol.name);
+                        }
+                    }
+                    else {
+                        usedSymbols.push(symbol.name);
+                    }
+                }
+                // 沒有需要清理的符號，跳過
+                if (unusedSymbols.length === 0) {
+                    continue;
+                }
+                // 判斷清理類型
+                if (usedSymbols.length === 0) {
+                    // 所有符號都未使用，刪除整行
+                    cleanups.push({
+                        filePath,
+                        range: stmt.range,
+                        originalImport: stmt.statement,
+                        unusedSymbols,
+                        cleanupType: 'delete'
+                    });
+                }
+                else {
+                    // 部分符號仍在使用，產生新的 import 語句
+                    const newImport = this.generatePartialImport(stmt, usedSymbols);
+                    if (newImport) {
+                        cleanups.push({
+                            filePath,
+                            range: stmt.range,
+                            originalImport: stmt.statement,
+                            unusedSymbols,
+                            cleanupType: 'partial',
+                            newImport
+                        });
+                    }
+                }
+            }
+        }
+        return { cleanups, warnings };
+    }
+    /**
+     * 產生部分清理後的 import 語句
+     * 支援：純 named import、混合 default + named import
+     */
+    generatePartialImport(stmt, usedSymbols) {
+        // Namespace import 不支援部分清理（整體使用）
+        if (stmt.isNamespace) {
+            return null;
+        }
+        // 從原始語句中提取 from 路徑
+        const fromMatch = stmt.statement.match(/from\s+(['"])(.+?)\1/);
+        if (!fromMatch) {
+            return null;
+        }
+        const fromPath = fromMatch[2];
+        const quote = fromMatch[1];
+        // 分離 default 和 named symbols
+        const defaultSymbol = stmt.symbols.find(s => s.isDefault);
+        const namedSymbols = stmt.symbols.filter(s => !s.isDefault);
+        // 檢查 default import 是否仍需保留
+        const keepDefault = defaultSymbol && usedSymbols.includes(defaultSymbol.name);
+        // 過濾出需要保留的 named symbols，並保留別名資訊
+        // 同時檢查 name 和 alias，因為 usedSymbols 可能包含別名
+        const keptNamedSymbols = namedSymbols
+            .filter(s => usedSymbols.includes(s.name) || (s.alias && usedSymbols.includes(s.alias)))
+            .map(s => s.alias ? `${s.name} as ${s.alias}` : s.name);
+        // 判斷是否需要 type 關鍵字（僅對純 named import）
+        const isTypeImport = stmt.statement.match(/import\s+type\s*\{/);
+        const typePrefix = isTypeImport ? 'type ' : '';
+        // 建構新的 import 語句
+        if (keepDefault && keptNamedSymbols.length > 0) {
+            // 混合格式：import X, { Y, Z } from '...'
+            return `import ${defaultSymbol.name}, { ${keptNamedSymbols.join(', ')} } from ${quote}${fromPath}${quote};`;
+        }
+        else if (keepDefault) {
+            // 只有 default：import X from '...'
+            return `import ${defaultSymbol.name} from ${quote}${fromPath}${quote};`;
+        }
+        else if (keptNamedSymbols.length > 0) {
+            // 只有 named：import { Y, Z } from '...'
+            return `import ${typePrefix}{ ${keptNamedSymbols.join(', ')} } from ${quote}${fromPath}${quote};`;
+        }
+        // 沒有任何符號需要保留
+        return null;
+    }
+    /**
+     * 檢查 import 是否仍被使用
+     * 使用快取的引用結果進行語義分析，避免重複查詢
+     */
+    async isImportStillUsed(filePath, symbolName, removalsInFile) {
+        // 使用快取查詢引用，避免 N+1 問題
+        const references = await this.findReferencesWithCache(filePath, symbolName);
+        // 過濾掉 import 類型的引用（import 語句本身）
+        const usageRefs = references.filter(ref => ref.type === SymbolReferenceType.Usage);
+        // 過濾掉被刪除程式碼區塊內的引用（使用二分搜尋優化）
+        const sortedRemovals = this.getSortedRemovalRanges(removalsInFile);
+        const remainingRefs = usageRefs.filter(ref => {
+            const refLine = ref.location.range.start.line;
+            return !this.isLineInRemovalRange(refLine, sortedRemovals);
+        });
+        // 如果還有剩餘的使用引用，表示 import 仍需要
+        return remainingRefs.length > 0;
+    }
+    /**
+     * 使用快取查詢符號引用
+     * 確保每個 (filePath, symbolName) 組合只查詢一次
+     */
+    async findReferencesWithCache(filePath, symbolName) {
+        const cacheKey = `${filePath}:${symbolName}`;
+        if (this.referenceCache.has(cacheKey)) {
+            return this.referenceCache.get(cacheKey);
+        }
+        const references = await this.symbolFinder.findReferencesInFile(filePath, symbolName);
+        this.referenceCache.set(cacheKey, references);
+        return references;
+    }
+    /**
+     * 取得排序後的刪除範圍（用於二分搜尋）
+     */
+    getSortedRemovalRanges(removals) {
+        return removals
+            .map(r => ({ start: r.range.start.line, end: r.range.end.line }))
+            .sort((a, b) => a.start - b.start);
+    }
+    /**
+     * 使用二分搜尋檢查行號是否在刪除範圍內
+     */
+    isLineInRemovalRange(line, sortedRanges) {
+        let left = 0;
+        let right = sortedRanges.length - 1;
+        while (left <= right) {
+            const mid = Math.floor((left + right) / 2);
+            const range = sortedRanges[mid];
+            if (line >= range.start && line <= range.end) {
+                return true;
+            }
+            else if (line < range.start) {
+                right = mid - 1;
+            }
+            else {
+                left = mid + 1;
+            }
+        }
+        return false;
+    }
+    /**
+     * 讀取檔案
+     */
+    async readFile(filePath) {
+        if (this.fileCache.has(filePath)) {
+            return this.fileCache.get(filePath);
+        }
+        try {
+            const content = await this.fileSystem.readFile(filePath, 'utf-8');
+            const contentStr = typeof content === 'string' ? content : content.toString('utf-8');
+            this.fileCache.set(filePath, contentStr);
+            return contentStr;
+        }
+        catch {
+            this.fileCache.delete(filePath);
+            return null;
+        }
+    }
+    /**
+     * 清除快取
+     */
+    clearCache() {
+        this.fileCache.clear();
+        this.referenceCache.clear();
+    }
+}
+/**
+ * 建立 ImportCleaner 實例
+ */
+export function createImportCleaner(fileSystem, parserRegistry) {
+    return new ImportCleaner(fileSystem, parserRegistry);
+}
+//# sourceMappingURL=import-cleaner.js.map

package/dist/core/deadcode/import-cleaner.js.map

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

package/dist/core/deadcode/import-parser.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Import 語句解析器
+ * 負責解析 TypeScript/JavaScript 的 import 語句
+ */
+import type { Range } from '../../shared/types/core.js';
+import type { ParserRegistry } from '../../infrastructure/parser/registry.js';
+/**
+ * Import 語句中的符號資訊
+ */
+export interface ImportSymbolInfo {
+    /** 符號名稱 */
+    name: string;
+    /** 別名（如果有 as） */
+    alias?: string;
+    /** 是否為 default import */
+    isDefault?: boolean;
+    /** 是否為 namespace import */
+    isNamespace?: boolean;
+}
+/**
+ * Import 語句資訊
+ */
+export interface ImportStatementInfo {
+    /** 完整的 import 語句 */
+    statement: string;
+    /** 語句範圍 */
+    range: Range;
+    /** 包含的所有符號 */
+    symbols: ImportSymbolInfo[];
+    /** 是否有 default import */
+    hasDefault: boolean;
+    /** 是否為 namespace import */
+    isNamespace: boolean;
+}
+/**
+ * Import 語句解析器
+ */
+export declare class ImportParser {
+    private readonly parserRegistry;
+    constructor(parserRegistry: ParserRegistry);
+    /**
+     * 解析 import 語句（以語句為單位）
+     * 優先使用 Parser 的 AST 解析（精確），fallback 到字串解析（向後相容）
+     * @param content 檔案內容
+     * @param filePath 檔案路徑（用於取得對應的 Parser）
+     */
+    parseImportStatements(content: string, filePath: string): ImportStatementInfo[];
+    /**
+     * 使用 Parser AST 解析 import 語句
+     * @returns ImportStatementInfo[] 如果成功，null 如果 Parser 不支援或解析失敗
+     */
+    private parseImportStatementsWithParser;
+    /**
+     * 將 Parser 的 ImportDeclaration 轉換為內部的 ImportStatementInfo
+     */
+    private convertImportDeclaration;
+    /**
+     * Fallback：使用字串解析 import 語句
+     * 保留原有邏輯以確保向後相容
+     */
+    private parseImportStatementsFallback;
+    /**
+     * 解析單行或合併後的 import 語句
+     */
+    private parseImportStatementLine;
+    /**
+     * 解析 named import 中的符號
+     */
+    private parseNamedSymbols;
+    /**
+     * 從檔案路徑取得副檔名
+     */
+    private getFileExtension;
+}
+/**
+ * 建立 ImportParser 實例
+ */
+export declare function createImportParser(parserRegistry: ParserRegistry): ImportParser;
+//# sourceMappingURL=import-parser.d.ts.map

package/dist/core/deadcode/import-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../src/core/deadcode/import-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAwBzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,EAAE,KAAK,CAAC;IACb,cAAc;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAE3D;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAW/E;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAevC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA8BhC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAsDrC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgEhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAIzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,YAAY,CAE/E"}

package/dist/core/deadcode/import-parser.js

@@ -0,0 +1,229 @@
+/**
+ * Import 語句解析器
+ * 負責解析 TypeScript/JavaScript 的 import 語句
+ */
+/** 多行 import 的最大行數限制 */
+const MAX_MULTILINE_IMPORT = 20;
+/**
+ * Import 語句匹配 Regex 常數
+ */
+const IMPORT_PATTERNS = {
+    /** Namespace import: import * as X from '...' */
+    NAMESPACE: /import\s+\*\s+as\s+(\w+)\s+from/,
+    /** Default import with named: import X, { Y, Z } from '...' */
+    DEFAULT_WITH_NAMED: /import\s+(\w+)\s*,\s*\{([^}]+)\}\s*from/,
+    /** Default import only: import X from '...' */
+    DEFAULT_ONLY: /import\s+(\w+)\s+from\s+['"]/,
+    /** Named import: import { X, Y } from '...' or import type { X } from '...' */
+    NAMED: /import\s+(?:type\s*)?\{([^}]+)\}\s*from/,
+    /** Side-effect import: import '...' */
+    SIDE_EFFECT: /^import\s+['"][^'"]+['"]/,
+    /** As alias: X as Y */
+    AS_ALIAS: /^(\w+)\s+as\s+(\w+)$/
+};
+/**
+ * Import 語句解析器
+ */
+export class ImportParser {
+    parserRegistry;
+    constructor(parserRegistry) {
+        this.parserRegistry = parserRegistry;
+    }
+    /**
+     * 解析 import 語句（以語句為單位）
+     * 優先使用 Parser 的 AST 解析（精確），fallback 到字串解析（向後相容）
+     * @param content 檔案內容
+     * @param filePath 檔案路徑（用於取得對應的 Parser）
+     */
+    parseImportStatements(content, filePath) {
+        // 1. 優先嘗試使用 Parser 的 getImportDeclarations 方法
+        const parserResult = this.parseImportStatementsWithParser(content, filePath);
+        if (parserResult) {
+            return parserResult;
+        }
+        // 2. Fallback：使用原有的字串解析邏輯
+        return this.parseImportStatementsFallback(content);
+    }
+    /**
+     * 使用 Parser AST 解析 import 語句
+     * @returns ImportStatementInfo[] 如果成功，null 如果 Parser 不支援或解析失敗
+     */
+    parseImportStatementsWithParser(content, filePath) {
+        const parser = this.parserRegistry.getParser(this.getFileExtension(filePath));
+        if (!parser?.getImportDeclarations) {
+            return null;
+        }
+        const declarations = parser.getImportDeclarations(content);
+        if (!declarations) {
+            return null;
+        }
+        // 將 Parser 的 ImportDeclaration 轉換為內部的 ImportStatementInfo
+        return declarations.map(decl => this.convertImportDeclaration(decl));
+    }
+    /**
+     * 將 Parser 的 ImportDeclaration 轉換為內部的 ImportStatementInfo
+     */
+    convertImportDeclaration(decl) {
+        const symbols = [];
+        // 處理 default import
+        if (decl.defaultImport) {
+            symbols.push({ name: decl.defaultImport, isDefault: true });
+        }
+        // 處理 namespace import
+        if (decl.namespaceImport) {
+            symbols.push({ name: decl.namespaceImport, isNamespace: true });
+        }
+        // 處理 named imports
+        for (const named of decl.namedImports) {
+            symbols.push({
+                name: named.name,
+                alias: named.alias
+            });
+        }
+        return {
+            statement: decl.rawStatement,
+            range: decl.range,
+            symbols,
+            hasDefault: !!decl.defaultImport,
+            isNamespace: !!decl.namespaceImport
+        };
+    }
+    /**
+     * Fallback：使用字串解析 import 語句
+     * 保留原有邏輯以確保向後相容
+     */
+    parseImportStatementsFallback(content) {
+        const statements = [];
+        const lines = content.split('\n');
+        // 用於處理多行 import
+        let multiLineImport = '';
+        let multiLineStartLine = -1;
+        let multiLineCount = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNumber = i + 1;
+            // 處理多行 import
+            if (multiLineImport) {
+                multiLineImport += '\n' + line;
+                multiLineCount++;
+                // 檢測結束條件：有 from 和 引號，或超過安全限制
+                const cleanLine = line.replace(/\/\/.*/, '').replace(/\/\*[\s\S]*?\*\//g, '');
+                const isComplete = cleanLine.includes('from') && /['"]/.test(cleanLine);
+                const isOverLimit = multiLineCount > MAX_MULTILINE_IMPORT;
+                if (isComplete || isOverLimit) {
+                    // 多行 import 結束
+                    const stmt = this.parseImportStatementLine(multiLineImport, multiLineStartLine, lineNumber, lines);
+                    if (stmt) {
+                        statements.push(stmt);
+                    }
+                    multiLineImport = '';
+                    multiLineStartLine = -1;
+                    multiLineCount = 0;
+                }
+                continue;
+            }
+            // 檢查是否為多行 import 開始（有 { 但沒有 } 或沒有 from）
+            if (line.match(/^\s*import\s+(?:type\s*)?\{/) && !line.includes('}')) {
+                multiLineImport = line;
+                multiLineStartLine = lineNumber;
+                multiLineCount = 1;
+                continue;
+            }
+            // 單行處理
+            const stmt = this.parseImportStatementLine(line, lineNumber, lineNumber, lines);
+            if (stmt) {
+                statements.push(stmt);
+            }
+        }
+        return statements;
+    }
+    /**
+     * 解析單行或合併後的 import 語句
+     */
+    parseImportStatementLine(line, startLine, endLine, lines) {
+        const trimmedLine = line.replace(/\s+/g, ' ').trim();
+        // 不是 import 語句
+        if (!trimmedLine.startsWith('import ')) {
+            return null;
+        }
+        // Side-effect import: import '...' (沒有符號)
+        if (IMPORT_PATTERNS.SIDE_EFFECT.test(trimmedLine)) {
+            return null;
+        }
+        const range = {
+            start: { line: startLine, column: 1 },
+            end: { line: endLine, column: (lines[endLine - 1] || '').length + 1 }
+        };
+        const symbols = [];
+        let hasDefault = false;
+        let isNamespace = false;
+        // 1. Namespace import: import * as X from '...'
+        const namespaceMatch = trimmedLine.match(IMPORT_PATTERNS.NAMESPACE);
+        if (namespaceMatch) {
+            symbols.push({ name: namespaceMatch[1], isNamespace: true });
+            isNamespace = true;
+            return { statement: trimmedLine, range, symbols, hasDefault, isNamespace };
+        }
+        // 2. Default import with named: import X, { Y, Z } from '...'
+        const defaultWithNamedMatch = trimmedLine.match(IMPORT_PATTERNS.DEFAULT_WITH_NAMED);
+        if (defaultWithNamedMatch) {
+            hasDefault = true;
+            symbols.push({ name: defaultWithNamedMatch[1], isDefault: true });
+            this.parseNamedSymbols(defaultWithNamedMatch[2], symbols);
+            return { statement: trimmedLine, range, symbols, hasDefault, isNamespace };
+        }
+        // 3. Default import only: import X from '...'
+        const defaultMatch = trimmedLine.match(IMPORT_PATTERNS.DEFAULT_ONLY);
+        if (defaultMatch && !trimmedLine.includes('{')) {
+            hasDefault = true;
+            symbols.push({ name: defaultMatch[1], isDefault: true });
+            return { statement: trimmedLine, range, symbols, hasDefault, isNamespace };
+        }
+        // 4. Named import: import { X, Y } from '...' or import type { X } from '...'
+        const namedImportMatch = trimmedLine.match(IMPORT_PATTERNS.NAMED);
+        if (namedImportMatch) {
+            this.parseNamedSymbols(namedImportMatch[1], symbols);
+            if (symbols.length > 0) {
+                return { statement: trimmedLine, range, symbols, hasDefault, isNamespace };
+            }
+        }
+        return null;
+    }
+    /**
+     * 解析 named import 中的符號
+     */
+    parseNamedSymbols(symbolsStr, symbols) {
+        const parts = symbolsStr.split(',').map(s => s.trim());
+        for (const part of parts) {
+            // 跳過空字串和 type-only imports
+            if (!part || part.startsWith('type ')) {
+                continue;
+            }
+            // 處理 as 別名: X as Y
+            const asMatch = part.match(IMPORT_PATTERNS.AS_ALIAS);
+            if (asMatch) {
+                symbols.push({ name: asMatch[1], alias: asMatch[2] });
+            }
+            else {
+                const cleanSymbol = part.trim();
+                if (cleanSymbol) {
+                    symbols.push({ name: cleanSymbol });
+                }
+            }
+        }
+    }
+    /**
+     * 從檔案路徑取得副檔名
+     */
+    getFileExtension(filePath) {
+        const lastDot = filePath.lastIndexOf('.');
+        return lastDot === -1 ? '' : filePath.substring(lastDot);
+    }
+}
+/**
+ * 建立 ImportParser 實例
+ */
+export function createImportParser(parserRegistry) {
+    return new ImportParser(parserRegistry);
+}
+//# sourceMappingURL=import-parser.js.map

package/dist/core/deadcode/import-parser.js.map

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

package/dist/core/deadcode/range-expander.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 範圍擴展器
+ * 負責將符號範圍擴展至完整宣告（含前導註解）
+ */
+import type { Range } from '../../shared/types/core.js';
+import type { SymbolType } from '../../shared/types/symbol.js';
+import type { ParserRegistry } from '../../infrastructure/parser/registry.js';
+/**
+ * 範圍擴展器
+ */
+export declare class RangeExpander {
+    private readonly parserRegistry;
+    constructor(parserRegistry: ParserRegistry);
+    /**
+     * 擴展範圍至完整宣告（包含前導註解和空行）
+     * 優先使用 Parser 的 getFullDeclarationRange 方法（AST 精確解析）
+     * 若 Parser 不支援或回傳 null，fallback 到字串匹配邏輯
+     */
+    expandRangeToFullDeclaration(content: string, range: Range, symbolType: SymbolType, symbolName: string, filePath: string): Range;
+    /**
+     * 使用字串匹配邏輯擴展範圍（fallback 方法）
+     * 使用清理後的內容進行括號匹配，避免字串/註解中的括號干擾
+     */
+    private expandRangeByStringMatching;
+    /**
+     * 移除單行中的註解和字串（用於括號匹配）
+     */
+    private removeCommentsAndStringsFromLine;
+    /**
+     * 從檔案路徑取得副檔名
+     */
+    private getFileExtension;
+}
+/**
+ * 建立 RangeExpander 實例
+ */
+export declare function createRangeExpander(parserRegistry: ParserRegistry): RangeExpander;
+//# sourceMappingURL=range-expander.d.ts.map

package/dist/core/deadcode/range-expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-expander.d.ts","sourceRoot":"","sources":["../../../src/core/deadcode/range-expander.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAE3D;;;;OAIG;IACH,4BAA4B,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,KAAK;IAgCR;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA+GnC;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAsBxC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAIzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,cAAc,GAAG,aAAa,CAEjF"}