agent-ide 0.9.0 → 0.9.1

package/dist/core/snapshot/utils/bracket-balancer.js

@@ -0,0 +1,70 @@
+/**
+ * 括號平衡算法
+ * 用於解析包含巢狀泛型的簽章
+ */
+/**
+ * 使用括號平衡算法解析簽章
+ * 正確處理巢狀泛型（如 Map<K, Fn<V>>）
+ * @param signature 完整簽章字串
+ * @returns 解析結果，無法解析則返回 null
+ */
+export function parseSignatureWithBalancing(signature) {
+    // 找到第一個 '(' 的位置（跳過泛型參數 '<...>'）
+    let depth = 0;
+    let parenStart = -1;
+    for (let i = 0; i < signature.length; i++) {
+        const char = signature[i];
+        if (char === '<') {
+            depth++;
+        }
+        else if (char === '>') {
+            depth--;
+        }
+        else if (char === '(' && depth === 0) {
+            parenStart = i;
+            break;
+        }
+    }
+    if (parenStart === -1) {
+        return null;
+    }
+    // 從 parenStart 開始，使用括號平衡找到對應的 ')'
+    depth = 0;
+    let parenEnd = -1;
+    for (let i = parenStart; i < signature.length; i++) {
+        const char = signature[i];
+        if (char === '(' || char === '<' || char === '{' || char === '[') {
+            depth++;
+        }
+        else if (char === ')' || char === '>' || char === '}' || char === ']') {
+            depth--;
+            if (depth === 0 && char === ')') {
+                parenEnd = i;
+                break;
+            }
+        }
+    }
+    if (parenEnd === -1) {
+        return null;
+    }
+    // 提取參數和回傳型別
+    const params = signature.substring(parenStart + 1, parenEnd).trim();
+    const afterParen = signature.substring(parenEnd + 1).trim();
+    // 解析回傳型別（跳過 ':' 後的部分）
+    let returnType = 'void';
+    if (afterParen.startsWith(':')) {
+        returnType = afterParen.substring(1).trim();
+    }
+    return { params, returnType };
+}
+/**
+ * 格式化解析結果為簽章字串
+ * @param parsed 解析結果
+ * @returns 格式化字串 "(params) → returnType"
+ */
+export function formatParsedSignature(parsed) {
+    return parsed.params
+        ? `(${parsed.params}) → ${parsed.returnType}`
+        : `() → ${parsed.returnType}`;
+}
+//# sourceMappingURL=bracket-balancer.js.map

package/dist/core/snapshot/utils/bracket-balancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bracket-balancer.js","sourceRoot":"","sources":["../../../../src/core/snapshot/utils/bracket-balancer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,gCAAgC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvC,UAAU,GAAG,CAAC,CAAC;YACf,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,KAAK,GAAG,CAAC,CAAC;IACV,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjE,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxE,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAChC,QAAQ,GAAG,CAAC,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;IACZ,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE5D,sBAAsB;IACtB,IAAI,UAAU,GAAG,MAAM,CAAC;IACxB,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,OAAO,MAAM,CAAC,MAAM;QAClB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,UAAU,EAAE;QAC7C,CAAC,CAAC,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/snapshot/utils/factory-pattern-detector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Factory 模式識別器
+ * 使用 Parser 語義分析識別模組內的 factory 模式
+ */
+import type { IFileSystem } from '../../../infrastructure/storage/index.js';
+import type { PatternInfo } from '../../../infrastructure/parser/index.js';
+/**
+ * 識別模組內的 factory 模式
+ * @param modulePath 模組路徑
+ * @param fileSystem 檔案系統
+ * @returns Factory 模式 Map（symbolName → PatternInfo）
+ */
+export declare function identifyFactoryPatterns(modulePath: string, fileSystem: IFileSystem): Promise<Map<string, PatternInfo>>;
+/**
+ * 判斷函數是否為 factory
+ * 優先使用 Parser 語義分析結果，若無則 fallback 到名稱比對
+ * @param funcName 函數名稱
+ * @param factoryPatterns Parser 識別的 factory 模式
+ * @returns 是否為 factory
+ */
+export declare function isFactory(funcName: string, factoryPatterns: Map<string, PatternInfo>): boolean;
+//# sourceMappingURL=factory-pattern-detector.d.ts.map

package/dist/core/snapshot/utils/factory-pattern-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-pattern-detector.d.ts","sourceRoot":"","sources":["../../../../src/core/snapshot/utils/factory-pattern-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAsCnC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GACxC,OAAO,CAYT"}

package/dist/core/snapshot/utils/factory-pattern-detector.js

@@ -0,0 +1,70 @@
+/**
+ * Factory 模式識別器
+ * 使用 Parser 語義分析識別模組內的 factory 模式
+ */
+import * as path from 'path';
+import { ParserRegistry } from '../../../infrastructure/parser/index.js';
+/**
+ * 識別模組內的 factory 模式
+ * @param modulePath 模組路徑
+ * @param fileSystem 檔案系統
+ * @returns Factory 模式 Map（symbolName → PatternInfo）
+ */
+export async function identifyFactoryPatterns(modulePath, fileSystem) {
+    const factoryMap = new Map();
+    try {
+        const entries = await fileSystem.readDirectory(modulePath);
+        for (const entry of entries) {
+            if (entry.isDirectory) {
+                continue;
+            }
+            const ext = path.extname(entry.name);
+            if (!['.ts', '.js', '.tsx', '.jsx'].includes(ext)) {
+                continue;
+            }
+            const filePath = path.join(modulePath, entry.name);
+            const parser = ParserRegistry.getInstance().getParser(ext);
+            if (!parser || !parser.identifyPatterns) {
+                continue;
+            }
+            try {
+                const content = await fileSystem.readFile(filePath);
+                const codeString = typeof content === 'string' ? content : content.toString('utf-8');
+                const patterns = parser.identifyPatterns(codeString);
+                if (patterns) {
+                    for (const pattern of patterns) {
+                        if (pattern.type === 'factory') {
+                            factoryMap.set(pattern.symbolName, pattern);
+                        }
+                    }
+                }
+            }
+            catch {
+                // 忽略單一檔案的解析錯誤，繼續處理其他檔案
+            }
+        }
+    }
+    catch {
+        // 忽略目錄讀取錯誤，返回空 Map（fallback 到名稱比對）
+    }
+    return factoryMap;
+}
+/**
+ * 判斷函數是否為 factory
+ * 優先使用 Parser 語義分析結果，若無則 fallback 到名稱比對
+ * @param funcName 函數名稱
+ * @param factoryPatterns Parser 識別的 factory 模式
+ * @returns 是否為 factory
+ */
+export function isFactory(funcName, factoryPatterns) {
+    // 優先使用 Parser 語義分析結果
+    if (factoryPatterns.has(funcName)) {
+        return true;
+    }
+    // Fallback：Parser 未提供任何結果時，使用名稱比對（向後相容）
+    if (factoryPatterns.size === 0 && funcName.startsWith('create')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=factory-pattern-detector.js.map

package/dist/core/snapshot/utils/factory-pattern-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-pattern-detector.js","sourceRoot":"","sources":["../../../../src/core/snapshot/utils/factory-pattern-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB,EAClB,UAAuB;IAEvB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAE3D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAEpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAEhE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAE3D,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAEtD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACpD,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;gBAErD,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;wBAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;4BAC/B,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;wBAC9C,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,eAAyC;IAEzC,qBAAqB;IACrB,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/snapshot/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Snapshot 工具模組
+ */
+export * from './bracket-balancer.js';
+export * from './factory-pattern-detector.js';
+export * from './symbol-formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/snapshot/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/snapshot/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC"}

package/dist/core/snapshot/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Snapshot 工具模組
+ */
+export * from './bracket-balancer.js';
+export * from './factory-pattern-detector.js';
+export * from './symbol-formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/core/snapshot/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/snapshot/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC"}

package/dist/core/snapshot/utils/symbol-formatter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 符號簽章格式化器
+ * 提供統一的符號簽章格式化邏輯
+ */
+import type { Symbol } from '../../../shared/types/index.js';
+/**
+ * 擴展 Symbol 型別，包含 Parser 額外資訊
+ */
+export interface ExtendedSymbol extends Symbol {
+    readonly signature?: string;
+    readonly typeInfo?: string;
+}
+/**
+ * 格式化符號簽章（方法或函數）
+ * 優先使用 Parser AST 解析，fallback 到 simplifySignature
+ * @param symbol 符號
+ * @param fileContents 檔案內容 Map（供 Parser 使用）
+ * @returns 格式化後的簽章字串
+ */
+export declare function formatSymbolSignature(symbol: ExtendedSymbol, fileContents: Map<string, string>): string;
+/**
+ * 使用 Parser AST 格式化簽章
+ * @param filePath 檔案路徑（用於選擇 Parser）
+ * @param symbolName 符號名稱
+ * @param line 行號（1-based）
+ * @param code 檔案內容
+ * @returns 格式化後的簽章字串，如果無法解析則返回 null
+ */
+export declare function formatSignatureWithParser(filePath: string, symbolName: string, line: number, code: string): string | null;
+/**
+ * 簡化簽章格式（移除函數名稱，保留參數和回傳型別）
+ * 使用括號平衡算法處理巢狀泛型
+ * @param signature 原始簽章字串
+ * @returns 簡化後的簽章
+ */
+export declare function simplifySignature(signature: string): string;
+//# sourceMappingURL=symbol-formatter.d.ts.map

package/dist/core/snapshot/utils/symbol-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-formatter.d.ts","sourceRoot":"","sources":["../../../../src/core/snapshot/utils/symbol-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAkBR;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAqBf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAe3D"}

package/dist/core/snapshot/utils/symbol-formatter.js

@@ -0,0 +1,89 @@
+/**
+ * 符號簽章格式化器
+ * 提供統一的符號簽章格式化邏輯
+ */
+import * as path from 'path';
+import { ParserRegistry } from '../../../infrastructure/parser/index.js';
+import { parseSignatureWithBalancing, formatParsedSignature } from './bracket-balancer.js';
+/**
+ * 格式化符號簽章（方法或函數）
+ * 優先使用 Parser AST 解析，fallback 到 simplifySignature
+ * @param symbol 符號
+ * @param fileContents 檔案內容 Map（供 Parser 使用）
+ * @returns 格式化後的簽章字串
+ */
+export function formatSymbolSignature(symbol, fileContents) {
+    // 優先使用 Parser AST 解析簽章
+    const filePath = symbol.location?.filePath;
+    const line = symbol.location?.range?.start?.line;
+    const code = filePath ? fileContents.get(filePath) : undefined;
+    if (filePath && line !== undefined && code) {
+        const parserResult = formatSignatureWithParser(filePath, symbol.name, line, code);
+        if (parserResult) {
+            return parserResult;
+        }
+    }
+    // Fallback：使用 IndexEngine 提取的簽章
+    if (symbol.signature) {
+        return simplifySignature(symbol.signature);
+    }
+    return '() → unknown';
+}
+/**
+ * 使用 Parser AST 格式化簽章
+ * @param filePath 檔案路徑（用於選擇 Parser）
+ * @param symbolName 符號名稱
+ * @param line 行號（1-based）
+ * @param code 檔案內容
+ * @returns 格式化後的簽章字串，如果無法解析則返回 null
+ */
+export function formatSignatureWithParser(filePath, symbolName, line, code) {
+    const ext = path.extname(filePath);
+    const parser = ParserRegistry.getInstance().getParser(ext);
+    if (!parser?.formatSignature) {
+        return null;
+    }
+    const sig = parser.formatSignature(code, symbolName, line);
+    if (!sig) {
+        return null;
+    }
+    // 轉換 FormattedSignature → 簡化字串
+    const params = sig.parameters
+        .map(p => {
+        let str = p.name;
+        if (p.optional && !p.defaultValue) {
+            str += '?';
+        }
+        if (p.type && p.type !== 'any') {
+            str += `: ${p.type}`;
+        }
+        if (p.defaultValue) {
+            str += ` = ${p.defaultValue}`;
+        }
+        return str;
+    })
+        .join(', ');
+    return params ? `(${params}) → ${sig.returnType}` : `() → ${sig.returnType}`;
+}
+/**
+ * 簡化簽章格式（移除函數名稱，保留參數和回傳型別）
+ * 使用括號平衡算法處理巢狀泛型
+ * @param signature 原始簽章字串
+ * @returns 簡化後的簽章
+ */
+export function simplifySignature(signature) {
+    // 使用括號平衡算法找到參數列表的開始和結束位置
+    const result = parseSignatureWithBalancing(signature);
+    if (result) {
+        return formatParsedSignature(result);
+    }
+    // Fallback：原始正則邏輯（向後相容）
+    const match = signature.match(/^[^(]*\(([^)]*)\)(?:\s*:\s*(.+))?$/);
+    if (match) {
+        const params = match[1].trim();
+        const returnType = match[2]?.trim() || 'void';
+        return params ? `(${params}) → ${returnType}` : `() → ${returnType}`;
+    }
+    return signature;
+}
+//# sourceMappingURL=symbol-formatter.js.map

package/dist/core/snapshot/utils/symbol-formatter.js.map

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

package/dist/infrastructure/formatters/query-formatter.d.ts

@@ -1,6 +1,6 @@
 /**
  * 唯讀命令格式化器
- * 提供 json 和 summary 兩種輸出格式
+ * 使用策略模式路由到對應的格式化策略
  */
 import { type QueryResult } from './query-types.js';
 /** QueryFormatter 選項 */
@@ -18,7 +18,12 @@ export declare enum QueryFormat {
  */
 export declare class QueryFormatter {
     private readonly color;
+    private readonly strategies;
     constructor(options?: Partial<QueryFormatterOptions>);
+    /**
+     * 初始化策略 Map
+     */
+    private initializeStrategies;
     /**
      * 格式化結果
      */
@@ -32,72 +37,13 @@ export declare class QueryFormatter {
      */
     toSummary(result: QueryResult): string;
     /**
-     * 格式化 Search 摘要
-     */
-    private formatSearchSummary;
-    /**
-     * 格式化 Deps 摘要
-     */
-    private formatDepsSummary;
-    /**
-     * 將絕對路徑轉換為相對路徑
-     * @param filePath 檔案路徑
-     * @param basePath 專案根目錄
-     * @returns 相對路徑（若無 basePath 則返回原路徑）
-     */
-    private toRelativePath;
-    /**
-     * 格式化 Analyze 摘要
-     */
-    private formatAnalyzeSummary;
-    /**
-     * 格式化 DeadCode 摘要
-     */
-    private formatDeadCodeSummary;
-    /**
-     * 取得類型標籤
-     */
-    private getTypeLabel;
-    /**
-     * 取得 Dead Code 圖示
-     */
-    private getDeadCodeIcon;
-    /**
-     * 格式化 Snapshot 摘要
-     */
-    private formatSnapshotSummary;
-    /**
-     * 格式化增量快照摘要
-     */
-    private formatIncrementalSnapshotSummary;
-    /**
-     * 格式化 FindReferences 摘要
-     */
-    private formatFindReferencesSummary;
-    /**
-     * 按檔案分組引用
+     * 取得策略（型別安全）
      */
-    private groupReferencesByFile;
-    /**
-     * 取得引用類型圖示
-     */
-    private getReferenceTypeIcon;
-    /**
-     * 格式化 CallHierarchy 摘要
-     */
-    private formatCallHierarchySummary;
-    /**
-     * 按檔案分組呼叫項目
-     */
-    private groupCallsByFile;
+    private getStrategy;
     /**
      * 格式化預設摘要（fallback）
      */
     private formatDefaultSummary;
-    /**
-     * 套用顏色（如果啟用）
-     */
-    private colorize;
 }
 /**
  * 建立 QueryFormatter 的工廠函數

package/dist/infrastructure/formatters/query-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-formatter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/formatters/query-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAIL,KAAK,WAAW,EAcjB,MAAM,kBAAkB,CAAC;AAqB1B,wBAAwB;AACxB,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,WAAW;AACX,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIxD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM;IAO9D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAInC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAoBtC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IA+DxC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyCnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0DlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,QAAQ;CAIjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAAG,cAAc,CAKjG"}
+{"version":3,"file":"query-formatter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/formatters/query-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,WAAW,EAOjB,MAAM,kBAAkB,CAAC;AAW1B,wBAAwB;AACxB,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,WAAW;AACX,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;gBAEnD,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAKxD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM;IAO9D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAInC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAsBtC;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAqB7B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAAG,cAAc,CAKjG"}