agent-ide 0.1.0

package/dist/infrastructure/parser/factory.js

@@ -0,0 +1,306 @@
+/**
+ * Parser 工廠實作
+ * 負責建立和管理 Parser 實例，提供快取和配置管理功能
+ */
+import { getFileExtension } from './interface.js';
+import { ParserFactoryError } from '../../shared/errors/index.js';
+/**
+ * Parser 工廠
+ * 負責建立 Parser 實例，提供快取和配置管理
+ */
+export class ParserFactory {
+    registry;
+    /** Parser 實例快取 */
+    cache = new Map();
+    /** 延遲載入器映射 */
+    lazyLoaders = new Map();
+    /** 全域預設配置 */
+    globalDefaultOptions = {};
+    /** Parser 特定預設配置 */
+    parserDefaultOptions = new Map();
+    /** 最大快取大小 */
+    maxCacheSize = 50;
+    /** 是否已被清理 */
+    disposed = false;
+    constructor(registry) {
+        this.registry = registry;
+        if (!registry) {
+            throw new ParserFactoryError('ParserRegistry 不能為空');
+        }
+    }
+    // ===== Parser 建立 =====
+    /**
+     * 根據檔案路徑建立 Parser
+     * @param filePath 檔案路徑
+     * @param options 配置選項
+     * @returns Parser 實例或 null
+     */
+    createParser(filePath, options) {
+        this.checkNotDisposed();
+        const extension = getFileExtension(filePath);
+        return this.createParserByExtension(extension, options);
+    }
+    /**
+     * 根據副檔名建立 Parser
+     * @param extension 副檔名
+     * @param options 配置選項
+     * @returns Parser 實例或 null
+     */
+    createParserByExtension(extension, options) {
+        this.checkNotDisposed();
+        const parser = this.registry.getParser(extension);
+        if (!parser) {
+            return null;
+        }
+        return this.getCachedParser(parser.name, parser, options);
+    }
+    /**
+     * 根據語言建立 Parser
+     * @param language 語言名稱
+     * @param options 配置選項
+     * @returns Parser 實例或 null
+     */
+    createParserByLanguage(language, options) {
+        this.checkNotDisposed();
+        const parser = this.registry.getParserByLanguage(language);
+        if (!parser) {
+            return null;
+        }
+        return this.getCachedParser(parser.name, parser, options);
+    }
+    /**
+     * 根據 Parser 名稱建立 Parser
+     * @param name Parser 名稱
+     * @param options 配置選項
+     * @returns Parser 實例或 null
+     */
+    createParserByName(name, options) {
+        this.checkNotDisposed();
+        const parser = this.registry.getParserByName(name);
+        if (!parser) {
+            return null;
+        }
+        return this.getCachedParser(name, parser, options);
+    }
+    // ===== 延遲載入 =====
+    /**
+     * 註冊延遲載入器
+     * @param parserName Parser 名稱
+     * @param loader 載入器函式
+     */
+    registerLazyParser(parserName, loader) {
+        this.checkNotDisposed();
+        this.lazyLoaders.set(parserName, loader);
+    }
+    /**
+     * 延遲建立 Parser
+     * @param filePath 檔案路徑
+     * @param options 配置選項
+     * @returns Parser 實例或 null
+     */
+    async createParserLazy(filePath, options) {
+        this.checkNotDisposed();
+        const extension = getFileExtension(filePath);
+        // 先嘗試從註冊中心獲取
+        const parser = this.registry.getParser(extension);
+        if (parser) {
+            return this.getCachedParser(parser.name, parser, options);
+        }
+        // 嘗試延遲載入
+        for (const [parserName, loader] of this.lazyLoaders.entries()) {
+            try {
+                const lazyParser = await loader();
+                if (lazyParser.supportedExtensions.includes(extension)) {
+                    // 註冊到註冊中心
+                    this.registry.register(lazyParser);
+                    return this.getCachedParser(parserName, lazyParser, options);
+                }
+            }
+            catch (error) {
+                console.warn(`延遲載入 Parser ${parserName} 失敗:`, error);
+            }
+        }
+        return null;
+    }
+    // ===== 快取管理 =====
+    /**
+     * 獲取快取的 Parser 實例
+     * @param name Parser 名稱
+     * @param parser Parser 實例
+     * @param options 配置選項
+     * @returns Parser 實例
+     */
+    getCachedParser(name, parser, options) {
+        const mergedOptions = this.getMergedOptions(name, options);
+        const cacheKey = this.buildCacheKey(name, mergedOptions);
+        // 檢查快取
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            cached.lastAccessed = new Date();
+            return cached.parser;
+        }
+        // 檢查快取大小限制
+        if (this.cache.size >= this.maxCacheSize) {
+            this.evictOldestCacheItem();
+        }
+        // 建立新的快取項目
+        const cacheItem = {
+            parser,
+            lastAccessed: new Date(),
+            options: mergedOptions || undefined
+        };
+        this.cache.set(cacheKey, cacheItem);
+        return parser;
+    }
+    /**
+     * 建立快取鍵
+     * @param name Parser 名稱
+     * @param options 配置選項
+     * @returns 快取鍵
+     */
+    buildCacheKey(name, options) {
+        if (!options) {
+            return name;
+        }
+        // 將配置選項序列化為字串
+        const optionsStr = JSON.stringify(options, Object.keys(options).sort());
+        return `${name}:${optionsStr}`;
+    }
+    /**
+     * 移除最久未使用的快取項目 (LRU)
+     */
+    evictOldestCacheItem() {
+        let oldestKey = null;
+        let oldestTime = null;
+        for (const [key, item] of this.cache.entries()) {
+            if (!oldestTime || item.lastAccessed < oldestTime) {
+                oldestTime = item.lastAccessed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+        }
+    }
+    /**
+     * 清除快取
+     * @param parserName 可選，指定清除特定 Parser 的快取
+     */
+    clearCache(parserName) {
+        this.checkNotDisposed();
+        if (!parserName) {
+            this.cache.clear();
+            return;
+        }
+        // 清除指定 Parser 的所有快取項目
+        const keysToDelete = [];
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(parserName + ':') || key === parserName) {
+                keysToDelete.push(key);
+            }
+        }
+        keysToDelete.forEach(key => this.cache.delete(key));
+    }
+    /**
+     * 設定最大快取大小
+     * @param size 快取大小
+     */
+    setMaxCacheSize(size) {
+        if (size <= 0) {
+            throw new ParserFactoryError('快取大小必須大於 0');
+        }
+        this.maxCacheSize = size;
+        // 如果當前快取超出大小限制，移除舊項目
+        while (this.cache.size > this.maxCacheSize) {
+            this.evictOldestCacheItem();
+        }
+    }
+    /**
+     * 獲取快取大小
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * 獲取已快取的 Parser 名稱
+     */
+    getCachedParsers() {
+        const parserNames = new Set();
+        for (const key of this.cache.keys()) {
+            const parserName = key.split(':')[0];
+            parserNames.add(parserName);
+        }
+        return Array.from(parserNames).sort();
+    }
+    // ===== 配置管理 =====
+    /**
+     * 設定全域預設配置
+     * @param options 配置選項
+     */
+    setDefaultOptions(options) {
+        this.checkNotDisposed();
+        this.globalDefaultOptions = { ...options };
+    }
+    /**
+     * 設定特定 Parser 的預設配置
+     * @param parserName Parser 名稱
+     * @param options 配置選項
+     */
+    setParserOptions(parserName, options) {
+        this.checkNotDisposed();
+        this.parserDefaultOptions.set(parserName, { ...options });
+    }
+    /**
+     * 獲取合併後的配置選項
+     * @param parserName Parser 名稱
+     * @param options 用戶提供的配置選項
+     * @returns 合併後的配置選項
+     */
+    getMergedOptions(parserName, options) {
+        const parserDefaults = this.parserDefaultOptions.get(parserName) || {};
+        return {
+            ...this.globalDefaultOptions,
+            ...parserDefaults,
+            ...options
+        };
+    }
+    // ===== 生命週期管理 =====
+    /**
+     * 清理工廠
+     * 清理所有快取並釋放資源
+     */
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        // 清理快取中的所有 Parser
+        const disposePromises = [];
+        for (const cacheItem of this.cache.values()) {
+            disposePromises.push(cacheItem.parser.dispose().catch(error => {
+                console.warn('清理快取中的 Parser 時發生錯誤:', error);
+            }));
+        }
+        await Promise.all(disposePromises);
+        // 清空所有映射表
+        this.cache.clear();
+        this.lazyLoaders.clear();
+        this.parserDefaultOptions.clear();
+        this.disposed = true;
+    }
+    // ===== 內部工具方法 =====
+    /**
+     * 檢查工廠是否已被清理
+     */
+    checkNotDisposed() {
+        if (this.disposed) {
+            throw new ParserFactoryError('Factory已被清理');
+        }
+    }
+    /**
+     * 獲取清理狀態
+     */
+    get isDisposed() {
+        return this.disposed;
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/infrastructure/parser/factory.js.map

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

package/dist/infrastructure/parser/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Parser 基礎設施統一匯出
+ */
+export { ParserPlugin, isParserPlugin, supportsExtension, supportsLanguage, getFileExtension, findPluginForFile } from './interface.js';
+export type { CodeEdit, Definition, Usage, ValidationResult, ParserOptions, ParserCapabilities, DefinitionKind, UsageKind, ValidationError as ParserValidationError, ValidationWarning } from './types.js';
+export { createCodeEdit, createDefinition, createUsage, createValidationResult, createValidationSuccess, createValidationFailure, isCodeEdit, isDefinition, isUsage, isValidationResult, isParserCapabilities } from './types.js';
+export { BaseParserPlugin } from './base.js';
+export { ParserRegistry } from './registry.js';
+export type { ParserInfo, ParserRegistrationOptions } from './registry.js';
+export { ParserFactory } from './factory.js';
+export type { LazyLoaderFunction } from './factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/parser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxI,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,IAAI,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3M,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlO,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/infrastructure/parser/index.js

@@ -0,0 +1,12 @@
+/**
+ * Parser 基礎設施統一匯出
+ */
+// 匯出所有接口和型別
+export { isParserPlugin, supportsExtension, supportsLanguage, getFileExtension, findPluginForFile } from './interface.js';
+export { createCodeEdit, createDefinition, createUsage, createValidationResult, createValidationSuccess, createValidationFailure, isCodeEdit, isDefinition, isUsage, isValidationResult, isParserCapabilities } from './types.js';
+// 匯出基礎實作
+export { BaseParserPlugin } from './base.js';
+// 匯出註冊中心和工廠
+export { ParserRegistry } from './registry.js';
+export { ParserFactory } from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/parser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY;AACZ,OAAO,EAAgB,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExI,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElO,SAAS;AACT,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/infrastructure/parser/interface.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Parser 插件介面定義
+ * 定義所有 Parser 插件必須實作的契約
+ */
+import type { AST, Symbol, Reference, Dependency, Position, Range } from '../../shared/types/index.js';
+import type { CodeEdit, Definition, Usage, ValidationResult } from './types.js';
+/**
+ * Parser 插件主介面
+ * 所有 Parser 插件都必須實作此介面
+ */
+export interface ParserPlugin {
+    /** 插件名稱 */
+    readonly name: string;
+    /** 插件版本 */
+    readonly version: string;
+    /** 支援的副檔名列表 */
+    readonly supportedExtensions: readonly string[];
+    /** 支援的語言列表 */
+    readonly supportedLanguages: readonly string[];
+    /**
+     * 解析程式碼並生成 AST
+     * @param code 原始程式碼
+     * @param filePath 檔案路徑
+     * @returns 解析後的 AST
+     * @throws ParseError 當解析失敗時
+     */
+    parse(code: string, filePath: string): Promise<AST>;
+    /**
+     * 從 AST 中提取所有符號
+     * @param ast AST 物件
+     * @returns 符號列表
+     */
+    extractSymbols(ast: AST): Promise<Symbol[]>;
+    /**
+     * 查找符號的所有引用
+     * @param ast AST 物件
+     * @param symbol 目標符號
+     * @returns 引用列表
+     */
+    findReferences(ast: AST, symbol: Symbol): Promise<Reference[]>;
+    /**
+     * 從 AST 中提取所有依賴關係
+     * @param ast AST 物件
+     * @returns 依賴列表
+     */
+    extractDependencies(ast: AST): Promise<Dependency[]>;
+    /**
+     * 重新命名符號
+     * @param ast AST 物件
+     * @param position 重命名位置
+     * @param newName 新名稱
+     * @returns 程式碼編輯操作列表
+     */
+    rename(ast: AST, position: Position, newName: string): Promise<CodeEdit[]>;
+    /**
+     * 提取函式重構
+     * @param ast AST 物件
+     * @param selection 選取的程式碼範圍
+     * @returns 程式碼編輯操作列表
+     */
+    extractFunction(ast: AST, selection: Range): Promise<CodeEdit[]>;
+    /**
+     * 查找符號定義
+     * @param ast AST 物件
+     * @param position 查找位置
+     * @returns 定義資訊，如果找不到則返回 null
+     */
+    findDefinition(ast: AST, position: Position): Promise<Definition | null>;
+    /**
+     * 查找符號的所有使用位置
+     * @param ast AST 物件
+     * @param symbol 目標符號
+     * @returns 使用位置列表
+     */
+    findUsages(ast: AST, symbol: Symbol): Promise<Usage[]>;
+    /**
+     * 驗證插件狀態
+     * @returns 驗證結果
+     */
+    validate(): Promise<ValidationResult>;
+    /**
+     * 清理資源
+     * 應該釋放插件使用的所有資源
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Parser 插件型別守衛
+ * 檢查物件是否實作了 ParserPlugin 介面
+ */
+export declare function isParserPlugin(value: unknown): value is ParserPlugin;
+/**
+ * 檢查插件是否支援特定副檔名
+ */
+export declare function supportsExtension(plugin: ParserPlugin, extension: string): boolean;
+/**
+ * 檢查插件是否支援特定語言
+ */
+export declare function supportsLanguage(plugin: ParserPlugin, language: string): boolean;
+/**
+ * 從檔案路徑獲取副檔名
+ */
+export declare function getFileExtension(filePath: string): string;
+/**
+ * 查找可以處理特定檔案的插件
+ */
+export declare function findPluginForFile(plugins: ParserPlugin[], filePath: string): ParserPlugin | null;
+//# sourceMappingURL=interface.d.ts.map

package/dist/infrastructure/parser/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/parser/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAG3B,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,eAAe;IACf,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhD,cAAc;IACd,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAI/C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpD;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAIrD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAIjE;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAIvD;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAsCpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAElF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,YAAY,GAAG,IAAI,CAUrB"}

package/dist/infrastructure/parser/interface.js

@@ -0,0 +1,72 @@
+/**
+ * Parser 插件介面定義
+ * 定義所有 Parser 插件必須實作的契約
+ */
+/**
+ * Parser 插件型別守衛
+ * 檢查物件是否實作了 ParserPlugin 介面
+ */
+export function isParserPlugin(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    // 檢查基本屬性
+    if (typeof obj.name !== 'string' ||
+        typeof obj.version !== 'string' ||
+        !Array.isArray(obj.supportedExtensions) ||
+        !Array.isArray(obj.supportedLanguages)) {
+        return false;
+    }
+    // 檢查必要方法存在且為函式
+    const requiredMethods = [
+        'parse',
+        'extractSymbols',
+        'findReferences',
+        'extractDependencies',
+        'rename',
+        'extractFunction',
+        'findDefinition',
+        'findUsages',
+        'validate',
+        'dispose'
+    ];
+    for (const method of requiredMethods) {
+        if (typeof obj[method] !== 'function') {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 檢查插件是否支援特定副檔名
+ */
+export function supportsExtension(plugin, extension) {
+    return plugin.supportedExtensions.includes(extension);
+}
+/**
+ * 檢查插件是否支援特定語言
+ */
+export function supportsLanguage(plugin, language) {
+    return plugin.supportedLanguages.includes(language);
+}
+/**
+ * 從檔案路徑獲取副檔名
+ */
+export function getFileExtension(filePath) {
+    const lastDot = filePath.lastIndexOf('.');
+    return lastDot === -1 ? '' : filePath.substring(lastDot);
+}
+/**
+ * 查找可以處理特定檔案的插件
+ */
+export function findPluginForFile(plugins, filePath) {
+    const extension = getFileExtension(filePath);
+    for (const plugin of plugins) {
+        if (supportsExtension(plugin, extension)) {
+            return plugin;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=interface.js.map

package/dist/infrastructure/parser/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/infrastructure/parser/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6GH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,SAAS;IACT,IACE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,MAAM,eAAe,GAAG;QACtB,OAAO;QACP,gBAAgB;QAChB,gBAAgB;QAChB,qBAAqB;QACrB,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,YAAY;QACZ,UAAU;QACV,SAAS;KACV,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB,EAAE,SAAiB;IACvE,OAAQ,MAAM,CAAC,mBAAgC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,QAAgB;IACrE,OAAQ,MAAM,CAAC,kBAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,QAAgB;IAEhB,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/infrastructure/parser/registry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Parser 註冊中心實作
+ * 負責管理所有 Parser 插件的註冊、查詢和生命週期
+ */
+import type { ParserPlugin } from './interface.js';
+/**
+ * Parser 資訊
+ * 包含註冊時的元數據和優先級資訊
+ */
+export interface ParserInfo {
+    /** Parser 插件實例 */
+    readonly plugin: ParserPlugin;
+    /** 註冊時間 */
+    readonly registeredAt: Date;
+    /** 優先級（數字越大優先級越高） */
+    readonly priority: number;
+    /** Parser 名稱 */
+    readonly name: string;
+    /** Parser 版本 */
+    readonly version: string;
+    /** 支援的副檔名 */
+    readonly supportedExtensions: readonly string[];
+    /** 支援的語言 */
+    readonly supportedLanguages: readonly string[];
+}
+/**
+ * Parser 註冊選項
+ */
+export interface ParserRegistrationOptions {
+    /** 優先級（預設為 0） */
+    priority?: number;
+    /** 是否覆蓋已存在的 Parser（預設 false） */
+    override?: boolean;
+}
+/**
+ * Parser 註冊中心
+ * 單例模式，管理所有 Parser 插件的註冊和查詢
+ */
+export declare class ParserRegistry {
+    private static instance;
+    /** 以 Parser 名稱為 key 的註冊表 */
+    private readonly parsers;
+    /** 以副檔名為 key 的快速查找表 */
+    private readonly extensionMap;
+    /** 以語言為 key 的快速查找表 */
+    private readonly languageMap;
+    /** 是否已初始化 */
+    private initialized;
+    /** 是否已被清理 */
+    private disposed;
+    /**
+     * 私有建構函式，確保單例模式
+     */
+    private constructor();
+    /**
+     * 獲取單例實例
+     */
+    static getInstance(): ParserRegistry;
+    /**
+     * 重設單例實例（主要用於測試）
+     */
+    static resetInstance(): void;
+    /**
+     * 註冊 Parser 插件
+     * @param plugin Parser 插件實例
+     * @param options 註冊選項
+     */
+    register(plugin: ParserPlugin, options?: ParserRegistrationOptions): void;
+    /**
+     * 取消註冊 Parser 插件
+     * @param pluginName Parser 名稱
+     */
+    unregister(pluginName: string): void;
+    /**
+     * 根據副檔名獲取最高優先級的 Parser
+     * @param extension 副檔名（包含點，如 '.ts'）
+     * @returns Parser 插件實例或 null
+     */
+    getParser(extension: string): ParserPlugin | null;
+    /**
+     * 根據語言獲取最高優先級的 Parser
+     * @param language 語言名稱
+     * @returns Parser 插件實例或 null
+     */
+    getParserByLanguage(language: string): ParserPlugin | null;
+    /**
+     * 根據 Parser 名稱獲取 Parser
+     * @param name Parser 名稱
+     * @returns Parser 插件實例或 null
+     */
+    getParserByName(name: string): ParserPlugin | null;
+    /**
+     * 獲取所有支援的副檔名
+     * @returns 副檔名陣列
+     */
+    getSupportedExtensions(): string[];
+    /**
+     * 獲取所有支援的語言
+     * @returns 語言陣列
+     */
+    getSupportedLanguages(): string[];
+    /**
+     * 列出所有已註冊的 Parser
+     * @returns Parser 資訊陣列
+     */
+    listParsers(): ParserInfo[];
+    /**
+     * 檢查 Parser 版本相容性
+     * @param pluginName Parser 名稱
+     * @param version 期望版本
+     * @returns 是否相容
+     */
+    isCompatible(pluginName: string, version: string): boolean;
+    /**
+     * 初始化註冊中心
+     * 驗證所有已註冊的 Parser
+     */
+    initialize(): Promise<void>;
+    /**
+     * 清理註冊中心
+     * 清理所有 Parser 並釋放資源
+     */
+    dispose(): Promise<void>;
+    /**
+     * 檢查註冊中心是否已被清理
+     */
+    private checkNotDisposed;
+    /**
+     * 獲取初始化狀態
+     */
+    get isInitialized(): boolean;
+    /**
+     * 獲取清理狀態
+     */
+    get isDisposed(): boolean;
+    /**
+     * 獲取已註冊 Parser 的數量
+     */
+    get size(): number;
+}
+//# sourceMappingURL=registry.d.ts.map