agent-ide 0.1.0

package/dist/core/dependency/types.js

@@ -0,0 +1,103 @@
+/**
+ * 依賴關係分析相關型別定義
+ */
+/**
+ * 建立預設依賴分析選項
+ */
+export function createDefaultAnalysisOptions() {
+    return {
+        includeNodeModules: false,
+        followSymlinks: true,
+        maxDepth: 100,
+        excludePatterns: ['node_modules', '.git', 'dist', 'build'],
+        includePatterns: ['**/*.ts', '**/*.js', '**/*.tsx', '**/*.jsx']
+    };
+}
+/**
+ * 建立預設查詢選項
+ */
+export function createDefaultQueryOptions() {
+    return {
+        includeTransitive: false,
+        maxDepth: 10,
+        direction: 'dependencies'
+    };
+}
+/**
+ * 建立預設循環檢測選項
+ */
+export function createDefaultCycleDetectionOptions() {
+    return {
+        maxCycleLength: 20,
+        reportAllCycles: false,
+        ignoreSelfLoops: true
+    };
+}
+/**
+ * 建立預設分析器配置
+ */
+export function createDefaultAnalyzerConfig() {
+    return {
+        analysisOptions: createDefaultAnalysisOptions(),
+        queryOptions: createDefaultQueryOptions(),
+        cycleDetectionOptions: createDefaultCycleDetectionOptions(),
+        cacheEnabled: true,
+        concurrency: 4
+    };
+}
+/**
+ * 計算循環依賴嚴重程度
+ */
+export function calculateCycleSeverity(cycleLength) {
+    if (cycleLength <= 3) {
+        return 'low';
+    }
+    if (cycleLength <= 6) {
+        return 'medium';
+    }
+    return 'high';
+}
+/**
+ * FileDependencies 型別守衛
+ */
+export function isFileDependencies(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.filePath === 'string' &&
+        obj.filePath.trim().length > 0 &&
+        Array.isArray(obj.dependencies) &&
+        obj.lastModified instanceof Date);
+}
+/**
+ * ProjectDependencies 型別守衛
+ */
+export function isProjectDependencies(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.projectPath === 'string' &&
+        obj.projectPath.trim().length > 0 &&
+        Array.isArray(obj.fileDependencies) &&
+        obj.fileDependencies.every(isFileDependencies) &&
+        obj.analyzedAt instanceof Date);
+}
+/**
+ * CircularDependency 型別守衛
+ */
+export function isCircularDependency(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    const validSeverities = ['low', 'medium', 'high'];
+    return (Array.isArray(obj.cycle) &&
+        obj.cycle.length >= 2 &&
+        obj.cycle.every((item) => typeof item === 'string') &&
+        typeof obj.length === 'number' &&
+        obj.length >= 2 &&
+        validSeverities.includes(obj.severity));
+}
+//# sourceMappingURL=types.js.map

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

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

package/dist/core/indexing/file-index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 檔案索引實作
+ * 管理檔案的索引資訊，包含符號、依賴關係等
+ */
+import type { Symbol, Dependency } from '../../shared/types/index.js';
+import type { FileInfo, FileIndexEntry, IndexConfig, IndexStats } from './types.js';
+/**
+ * 檔案索引類別
+ * 負責管理專案中所有檔案的索引資訊
+ */
+export declare class FileIndex {
+    private readonly config;
+    private readonly fileEntries;
+    private lastUpdated;
+    constructor(config: IndexConfig);
+    /**
+     * 新增檔案到索引
+     */
+    addFile(fileInfo: FileInfo): Promise<void>;
+    /**
+     * 移除檔案從索引
+     */
+    removeFile(filePath: string): Promise<void>;
+    /**
+     * 檢查檔案是否在索引中
+     */
+    hasFile(filePath: string): boolean;
+    /**
+     * 檢查檔案是否已成功索引（存在且已解析）
+     */
+    isFileIndexed(filePath: string): boolean;
+    /**
+     * 取得檔案資訊
+     */
+    getFileInfo(filePath: string): FileInfo | null;
+    /**
+     * 設定檔案的符號
+     */
+    setFileSymbols(filePath: string, symbols: readonly Symbol[]): Promise<void>;
+    /**
+     * 取得檔案的符號
+     */
+    getFileSymbols(filePath: string): readonly Symbol[];
+    /**
+     * 設定檔案的依賴關係
+     */
+    setFileDependencies(filePath: string, dependencies: readonly Dependency[]): Promise<void>;
+    /**
+     * 取得檔案的依賴關係
+     */
+    getFileDependencies(filePath: string): readonly Dependency[];
+    /**
+     * 根據副檔名查找檔案
+     */
+    findFilesByExtension(extension: string): readonly FileInfo[];
+    /**
+     * 根據語言查找檔案
+     */
+    findFilesByLanguage(language: string): readonly FileInfo[];
+    /**
+     * 取得所有檔案
+     */
+    getAllFiles(): readonly FileInfo[];
+    /**
+     * 取得檔案總數
+     */
+    getTotalFiles(): number;
+    /**
+     * 取得已索引的檔案數
+     */
+    getIndexedFilesCount(): number;
+    /**
+     * 取得索引統計資訊
+     */
+    getStats(): IndexStats;
+    /**
+     * 清空所有索引
+     */
+    clear(): Promise<void>;
+    /**
+     * 取得檔案索引項目（內部使用）
+     */
+    getFileEntry(filePath: string): FileIndexEntry | undefined;
+    /**
+     * 取得所有檔案索引項目（內部使用）
+     */
+    getAllEntries(): ReadonlyMap<string, FileIndexEntry>;
+    /**
+     * 估算索引項目的記憶體大小
+     */
+    private estimateEntrySize;
+    /**
+     * 發送更新事件（內部使用）
+     */
+    private emitUpdateEvent;
+    /**
+     * 檢查檔案是否需要重新索引
+     */
+    needsReindexing(filePath: string, currentModified: Date): boolean;
+    /**
+     * 更新檔案資訊（不影響符號和依賴）
+     */
+    updateFileInfo(filePath: string, newFileInfo: FileInfo): Promise<void>;
+    /**
+     * 設定檔案的解析錯誤
+     */
+    setFileParseErrors(filePath: string, errors: readonly string[]): Promise<void>;
+    /**
+     * 取得檔案的解析錯誤
+     */
+    getFileParseErrors(filePath: string): readonly string[];
+    /**
+     * 檢查檔案是否有解析錯誤
+     */
+    hasFileParseErrors(filePath: string): boolean;
+}
+//# sourceMappingURL=file-index.d.ts.map

package/dist/core/indexing/file-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-index.d.ts","sourceRoot":"","sources":["../../../src/core/indexing/file-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,UAAU,EAEX,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKxC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAK9C;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjF;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAKnD;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/F;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE;IAK5D;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAY5D;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAY1D;;OAEG;IACH,WAAW,IAAI,SAAS,QAAQ,EAAE;IAIlC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAU9B;;OAEG;IACH,QAAQ,IAAI,UAAU;IAqBtB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI1D;;OAEG;IACH,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC;IAIpD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,GAAG,OAAO;IAmBjE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5E;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAepF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAKvD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAI9C"}

package/dist/core/indexing/file-index.js

@@ -0,0 +1,302 @@
+/**
+ * 檔案索引實作
+ * 管理檔案的索引資訊，包含符號、依賴關係等
+ */
+import { UpdateOperation } from './types.js';
+/**
+ * 檔案索引類別
+ * 負責管理專案中所有檔案的索引資訊
+ */
+export class FileIndex {
+    config;
+    fileEntries = new Map();
+    lastUpdated = new Date();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * 新增檔案到索引
+     */
+    async addFile(fileInfo) {
+        const entry = {
+            fileInfo,
+            symbols: [],
+            dependencies: [],
+            isIndexed: false,
+            lastIndexed: undefined,
+            parseErrors: []
+        };
+        this.fileEntries.set(fileInfo.filePath, entry);
+        this.lastUpdated = new Date();
+        this.emitUpdateEvent({
+            operation: UpdateOperation.Add,
+            filePath: fileInfo.filePath,
+            timestamp: new Date(),
+            success: true,
+            error: undefined
+        });
+    }
+    /**
+     * 移除檔案從索引
+     */
+    async removeFile(filePath) {
+        const existed = this.fileEntries.has(filePath);
+        this.fileEntries.delete(filePath);
+        if (existed) {
+            this.lastUpdated = new Date();
+            this.emitUpdateEvent({
+                operation: UpdateOperation.Delete,
+                filePath,
+                timestamp: new Date(),
+                success: true,
+                error: undefined
+            });
+        }
+    }
+    /**
+     * 檢查檔案是否在索引中
+     */
+    hasFile(filePath) {
+        return this.fileEntries.has(filePath);
+    }
+    /**
+     * 檢查檔案是否已成功索引（存在且已解析）
+     */
+    isFileIndexed(filePath) {
+        const entry = this.fileEntries.get(filePath);
+        return entry ? entry.isIndexed : false;
+    }
+    /**
+     * 取得檔案資訊
+     */
+    getFileInfo(filePath) {
+        const entry = this.fileEntries.get(filePath);
+        return entry?.fileInfo || null;
+    }
+    /**
+     * 設定檔案的符號
+     */
+    async setFileSymbols(filePath, symbols) {
+        const entry = this.fileEntries.get(filePath);
+        if (!entry) {
+            throw new Error(`檔案不存在於索引中: ${filePath}`);
+        }
+        const updatedEntry = {
+            ...entry,
+            symbols: [...symbols],
+            isIndexed: true,
+            lastIndexed: new Date()
+        };
+        this.fileEntries.set(filePath, updatedEntry);
+        this.lastUpdated = new Date();
+        this.emitUpdateEvent({
+            operation: UpdateOperation.Update,
+            filePath,
+            timestamp: new Date(),
+            success: true,
+            error: undefined
+        });
+    }
+    /**
+     * 取得檔案的符號
+     */
+    getFileSymbols(filePath) {
+        const entry = this.fileEntries.get(filePath);
+        return entry?.symbols || [];
+    }
+    /**
+     * 設定檔案的依賴關係
+     */
+    async setFileDependencies(filePath, dependencies) {
+        const entry = this.fileEntries.get(filePath);
+        if (!entry) {
+            throw new Error(`檔案不存在於索引中: ${filePath}`);
+        }
+        const updatedEntry = {
+            ...entry,
+            dependencies: [...dependencies]
+        };
+        this.fileEntries.set(filePath, updatedEntry);
+        this.lastUpdated = new Date();
+    }
+    /**
+     * 取得檔案的依賴關係
+     */
+    getFileDependencies(filePath) {
+        const entry = this.fileEntries.get(filePath);
+        return entry?.dependencies || [];
+    }
+    /**
+     * 根據副檔名查找檔案
+     */
+    findFilesByExtension(extension) {
+        const result = [];
+        for (const entry of this.fileEntries.values()) {
+            if (entry.fileInfo.extension === extension) {
+                result.push(entry.fileInfo);
+            }
+        }
+        return result;
+    }
+    /**
+     * 根據語言查找檔案
+     */
+    findFilesByLanguage(language) {
+        const result = [];
+        for (const entry of this.fileEntries.values()) {
+            if (entry.fileInfo.language === language) {
+                result.push(entry.fileInfo);
+            }
+        }
+        return result;
+    }
+    /**
+     * 取得所有檔案
+     */
+    getAllFiles() {
+        return Array.from(this.fileEntries.values()).map(entry => entry.fileInfo);
+    }
+    /**
+     * 取得檔案總數
+     */
+    getTotalFiles() {
+        return this.fileEntries.size;
+    }
+    /**
+     * 取得已索引的檔案數
+     */
+    getIndexedFilesCount() {
+        let count = 0;
+        for (const entry of this.fileEntries.values()) {
+            if (entry.isIndexed) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 取得索引統計資訊
+     */
+    getStats() {
+        let totalSymbols = 0;
+        let totalDependencies = 0;
+        let indexSize = 0;
+        for (const entry of this.fileEntries.values()) {
+            totalSymbols += entry.symbols.length;
+            totalDependencies += entry.dependencies.length;
+            indexSize += this.estimateEntrySize(entry);
+        }
+        return {
+            totalFiles: this.fileEntries.size,
+            indexedFiles: this.getIndexedFilesCount(),
+            totalSymbols,
+            totalDependencies,
+            lastUpdated: this.lastUpdated,
+            indexSize
+        };
+    }
+    /**
+     * 清空所有索引
+     */
+    async clear() {
+        this.fileEntries.clear();
+        this.lastUpdated = new Date();
+    }
+    /**
+     * 取得檔案索引項目（內部使用）
+     */
+    getFileEntry(filePath) {
+        return this.fileEntries.get(filePath);
+    }
+    /**
+     * 取得所有檔案索引項目（內部使用）
+     */
+    getAllEntries() {
+        return this.fileEntries;
+    }
+    /**
+     * 估算索引項目的記憶體大小
+     */
+    estimateEntrySize(entry) {
+        // 簡化的大小估算
+        let size = 0;
+        // FileInfo 大小
+        size += entry.fileInfo.filePath.length * 2; // UTF-16
+        size += 64; // 其他屬性大約 64 bytes
+        // Symbols 大小
+        size += entry.symbols.length * 128; // 每個符號約 128 bytes
+        // Dependencies 大小
+        size += entry.dependencies.length * 64; // 每個依賴約 64 bytes
+        return size;
+    }
+    /**
+     * 發送更新事件（內部使用）
+     */
+    emitUpdateEvent(event) {
+        // 在實際實作中，這裡可以使用 EventEmitter 或其他事件機制
+        // 目前只是預留介面
+    }
+    /**
+     * 檢查檔案是否需要重新索引
+     */
+    needsReindexing(filePath, currentModified) {
+        const entry = this.fileEntries.get(filePath);
+        if (!entry) {
+            return true; // 檔案不在索引中，需要索引
+        }
+        if (!entry.isIndexed) {
+            return true; // 尚未被索引
+        }
+        // 檢查檔案修改時間
+        const currentTime = currentModified.getTime();
+        const indexedTime = entry.fileInfo.lastModified.getTime();
+        const timeDiff = currentTime - indexedTime;
+        // 只有當檔案確實變新時才需要重新索引
+        return timeDiff > 0;
+    }
+    /**
+     * 更新檔案資訊（不影響符號和依賴）
+     */
+    async updateFileInfo(filePath, newFileInfo) {
+        const entry = this.fileEntries.get(filePath);
+        if (!entry) {
+            throw new Error(`檔案不存在於索引中: ${filePath}`);
+        }
+        const updatedEntry = {
+            ...entry,
+            fileInfo: newFileInfo
+        };
+        this.fileEntries.set(filePath, updatedEntry);
+        this.lastUpdated = new Date();
+    }
+    /**
+     * 設定檔案的解析錯誤
+     */
+    async setFileParseErrors(filePath, errors) {
+        const entry = this.fileEntries.get(filePath);
+        if (!entry) {
+            throw new Error(`檔案不存在於索引中: ${filePath}`);
+        }
+        const updatedEntry = {
+            ...entry,
+            parseErrors: [...errors]
+        };
+        this.fileEntries.set(filePath, updatedEntry);
+        this.lastUpdated = new Date();
+    }
+    /**
+     * 取得檔案的解析錯誤
+     */
+    getFileParseErrors(filePath) {
+        const entry = this.fileEntries.get(filePath);
+        return entry?.parseErrors || [];
+    }
+    /**
+     * 檢查檔案是否有解析錯誤
+     */
+    hasFileParseErrors(filePath) {
+        const entry = this.fileEntries.get(filePath);
+        return entry ? entry.parseErrors.length > 0 : false;
+    }
+}
+//# sourceMappingURL=file-index.js.map

package/dist/core/indexing/file-index.js.map

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

package/dist/core/indexing/file-watcher.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 檔案監控器實作
+ * 監控檔案系統變更並觸發增量索引更新
+ */
+import { EventEmitter } from 'events';
+import type { IndexEngine } from './index-engine.js';
+/**
+ * 檔案變更類型
+ */
+export type FileChangeType = 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir';
+/**
+ * 檔案變更事件
+ */
+export interface FileChangeEvent {
+    filePath: string;
+    type: FileChangeType;
+    timestamp: Date;
+    error?: string;
+}
+/**
+ * 批次變更項目
+ */
+export interface BatchChangeItem {
+    filePath: string;
+    type: FileChangeType;
+}
+/**
+ * 批次處理選項
+ */
+export interface BatchProcessOptions {
+    maxConcurrency?: number;
+    debounceTime?: number;
+}
+/**
+ * 檔案監控器類別
+ * 監控檔案系統變更並自動更新索引
+ */
+export declare class FileWatcher extends EventEmitter {
+    private readonly indexEngine;
+    private watcher;
+    private isWatching;
+    private isPaused;
+    private pendingChanges;
+    private debounceTimer;
+    private readonly debounceTime;
+    constructor(indexEngine: IndexEngine, options?: {
+        debounceTime?: number;
+    });
+    /**
+     * 開始監控檔案變更
+     */
+    start(): Promise<void>;
+    /**
+     * 停止監控檔案變更
+     */
+    stop(): Promise<void>;
+    /**
+     * 暫停監控
+     */
+    pause(): void;
+    /**
+     * 恢復監控
+     */
+    resume(): void;
+    /**
+     * 手動處理檔案變更事件
+     */
+    handleFileChange(filePath: string, changeType: FileChangeType): Promise<void>;
+    /**
+     * 批次處理檔案變更
+     */
+    handleBatchChanges(changes: BatchChangeItem[], options?: BatchProcessOptions): Promise<void>;
+    /**
+     * 將變更加入佇列（帶防抖動）
+     */
+    private queueChange;
+    /**
+     * 處理待處理的變更
+     */
+    private processPendingChanges;
+    /**
+     * 處理單一檔案變更
+     */
+    private processFileChange;
+    /**
+     * 檢查檔案是否應該被處理
+     */
+    private shouldProcessFile;
+    /**
+     * 簡單的檔案模式匹配
+     */
+    private matchesPattern;
+    /**
+     * 將陣列分割成指定大小的塊
+     */
+    private createChunks;
+    /**
+     * 取得監控狀態
+     */
+    getStatus(): {
+        isWatching: boolean;
+        isPaused: boolean;
+        pendingChangesCount: number;
+    };
+    /**
+     * 強制處理所有待處理的變更
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/core/indexing/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/core/indexing/file-watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAMzE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BnF;;OAEG;IACG,kBAAkB,CACtB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAahB;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;YACW,qBAAqB;IAWnC;;OAEG;YACW,iBAAiB;IAyD/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,SAAS,IAAI;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,mBAAmB,EAAE,MAAM,CAAC;KAC3B;IAQH;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}