@mycodemap/mycodemap 0.1.1 → 0.2.0

package/dist/infrastructure/storage/adapters/KuzuDBStorage.js

@@ -0,0 +1,235 @@
+// [META] since:2026-03 | owner:architecture-team | stable:false
+// [WHY] KùzuDB storage adapter - graph database backend for large projects
+// ============================================
+// KùzuDB 存储适配器 - 适用于大型项目的图数据库后端
+// ============================================
+import { join } from 'path';
+import { StorageBase, StorageError } from '../interfaces/StorageBase.js';
+/**
+ * KùzuDB 存储适配器（可选依赖）
+ *
+ * 安装：npm install kuzu
+ *
+ * 特点：
+ * - 嵌入式图数据库
+ * - 高性能图查询
+ * - 适合大型项目（>1000文件）
+ * - 支持复杂关系分析
+ *
+ * TODO-DEBT [L1] [日期:2026-03-17] [作者:AI] [原因:MVP阶段暂不实现完整功能]
+ * 问题：目前使用内存 fallback 实现
+ * 风险：无法持久化到 KùzuDB
+ * 偿还计划：V1.0 实现完整 KùzuDB 集成
+ */
+export class KuzuDBStorage extends StorageBase {
+    type = 'kuzudb';
+    /** KùzuDB 数据库实例 */
+    db = null;
+    /** 连接实例 */
+    conn = null;
+    /** 内存 fallback */
+    memoryGraph = this.createEmptyGraph();
+    /** 存储配置 */
+    dbConfig;
+    constructor(config) {
+        super();
+        this.dbConfig = config;
+    }
+    // ============================================
+    // 生命周期管理
+    // ============================================
+    async doInitialize() {
+        try {
+            // 动态导入 kuzu 以避免未安装时的错误
+            // @ts-expect-error kuzu is optional dependency
+            const kuzu = await import('kuzu');
+            const dbPath = this.dbConfig.databasePath
+                ? join(this.projectPath, this.dbConfig.databasePath)
+                : join(this.projectPath, '.codemap', 'kuzudb');
+            this.db = new kuzu.Database(dbPath);
+            this.conn = new kuzu.Connection(this.db);
+            // 初始化 schema
+            await this.initializeSchema();
+        }
+        catch {
+            // 如果 kuzu 未安装，回退到内存模式
+            // eslint-disable-next-line no-console
+            console.warn('KùzuDB not available, falling back to memory mode');
+            this.memoryGraph = this.createEmptyGraph();
+        }
+    }
+    async doClose() {
+        if (this.conn && typeof this.conn.close === 'function') {
+            await this.conn.close();
+        }
+        this.db = null;
+        this.conn = null;
+    }
+    // ============================================
+    // 项目级别操作
+    // ============================================
+    async saveCodeGraph(graph) {
+        this.ensureInitialized();
+        if (!this.db) {
+            // Fallback 到内存
+            this.memoryGraph = {
+                project: { ...graph.project },
+                modules: [...graph.modules],
+                symbols: [...graph.symbols],
+                dependencies: [...graph.dependencies],
+            };
+            return;
+        }
+        // TODO: 实现 KùzuDB 持久化
+        throw new StorageError('KùzuDB persistence not yet implemented', 'NOT_IMPLEMENTED');
+    }
+    async loadCodeGraph() {
+        this.ensureInitialized();
+        if (!this.db) {
+            return {
+                project: { ...this.memoryGraph.project },
+                modules: [...this.memoryGraph.modules],
+                symbols: [...this.memoryGraph.symbols],
+                dependencies: [...this.memoryGraph.dependencies],
+            };
+        }
+        // TODO: 实现从 KùzuDB 加载
+        throw new StorageError('KùzuDB loading not yet implemented', 'NOT_IMPLEMENTED');
+    }
+    async deleteProject() {
+        this.ensureInitialized();
+        this.memoryGraph = this.createEmptyGraph();
+        // TODO: 删除 KùzuDB 数据
+    }
+    // ============================================
+    // 增量更新
+    // ============================================
+    async updateModule(module) {
+        this.ensureInitialized();
+        if (!this.db) {
+            const index = this.memoryGraph.modules.findIndex(m => m.id === module.id);
+            if (index >= 0) {
+                this.memoryGraph.modules[index] = { ...module };
+            }
+            else {
+                this.memoryGraph.modules.push({ ...module });
+            }
+            return;
+        }
+        // TODO: 实现 KùzuDB 更新
+    }
+    async deleteModule(moduleId) {
+        this.ensureInitialized();
+        if (!this.db) {
+            this.memoryGraph.modules = this.memoryGraph.modules.filter(m => m.id !== moduleId);
+            this.memoryGraph.symbols = this.memoryGraph.symbols.filter(s => s.moduleId !== moduleId);
+            this.memoryGraph.dependencies = this.memoryGraph.dependencies.filter(d => d.sourceId !== moduleId && d.targetId !== moduleId);
+            return;
+        }
+        // TODO: 实现 KùzuDB 删除
+    }
+    // ============================================
+    // 查询操作
+    // ============================================
+    async findModuleById(id) {
+        this.ensureInitialized();
+        if (!this.db) {
+            return this.memoryGraph.modules.find(m => m.id === id) ?? null;
+        }
+        // TODO: 实现 KùzuDB 查询
+        return null;
+    }
+    async findModulesByPath(path) {
+        this.ensureInitialized();
+        if (!this.db) {
+            return this.memoryGraph.modules.filter(m => m.path.includes(path));
+        }
+        return [];
+    }
+    async findSymbolByName(name) {
+        this.ensureInitialized();
+        if (!this.db) {
+            return this.memoryGraph.symbols.filter(s => s.name.includes(name));
+        }
+        return [];
+    }
+    async findSymbolById(id) {
+        this.ensureInitialized();
+        if (!this.db) {
+            return this.memoryGraph.symbols.find(s => s.id === id) ?? null;
+        }
+        return null;
+    }
+    async findDependencies(moduleId) {
+        this.ensureInitialized();
+        if (!this.db) {
+            return this.memoryGraph.dependencies.filter(d => d.sourceId === moduleId);
+        }
+        return [];
+    }
+    async findDependents(moduleId) {
+        this.ensureInitialized();
+        if (!this.db) {
+            return this.memoryGraph.dependencies.filter(d => d.targetId === moduleId);
+        }
+        return [];
+    }
+    async findCallers(_functionId) {
+        this.ensureInitialized();
+        return []; // TODO
+    }
+    async findCallees(_functionId) {
+        this.ensureInitialized();
+        return []; // TODO
+    }
+    // ============================================
+    // 分析操作
+    // ============================================
+    async detectCycles() {
+        this.ensureInitialized();
+        return []; // TODO
+    }
+    async calculateImpact(moduleId, depth) {
+        this.ensureInitialized();
+        return {
+            rootModule: moduleId,
+            affectedModules: [],
+            depth,
+        };
+    }
+    async getStatistics() {
+        this.ensureInitialized();
+        return {
+            totalModules: this.memoryGraph.modules.length,
+            totalSymbols: this.memoryGraph.symbols.length,
+            totalDependencies: this.memoryGraph.dependencies.length,
+            totalLines: this.memoryGraph.modules.reduce((sum, m) => sum + m.stats.lines, 0),
+            averageComplexity: 0,
+        };
+    }
+    // ============================================
+    // 私有方法
+    // ============================================
+    async initializeSchema() {
+        // TODO: 创建 KùzuDB schema
+        // CREATE NODE TABLE Module(...)
+        // CREATE NODE TABLE Symbol(...)
+        // CREATE REL TABLE DependsOn(...)
+        // CREATE REL TABLE Calls(...)
+    }
+    createEmptyGraph() {
+        return {
+            project: {
+                id: '',
+                name: '',
+                rootPath: this.projectPath ?? '',
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            },
+            modules: [],
+            symbols: [],
+            dependencies: [],
+        };
+    }
+}
+//# sourceMappingURL=KuzuDBStorage.js.map

package/dist/infrastructure/storage/adapters/KuzuDBStorage.js.map

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

package/dist/infrastructure/storage/adapters/MemoryStorage.d.ts

@@ -0,0 +1,37 @@
+import type { Cycle, ImpactResult, ProjectStatistics } from '../../../interface/types/storage.js';
+import type { CodeGraph, Module, Symbol, Dependency } from '../../../interface/types/index.js';
+import { StorageBase } from '../interfaces/StorageBase.js';
+/**
+ * 内存存储适配器
+ *
+ * 特点：
+ * - 纯内存存储，无持久化
+ * - 速度最快
+ * - 进程结束数据丢失
+ * - 适合单元测试和临时分析
+ */
+export declare class MemoryStorage extends StorageBase {
+    readonly type: "memory";
+    /** 内存中的代码图 */
+    private graph;
+    protected doInitialize(): Promise<void>;
+    protected doClose(): Promise<void>;
+    saveCodeGraph(graph: CodeGraph): Promise<void>;
+    loadCodeGraph(): Promise<CodeGraph>;
+    deleteProject(): Promise<void>;
+    updateModule(module: Module): Promise<void>;
+    deleteModule(moduleId: string): Promise<void>;
+    findModuleById(id: string): Promise<Module | null>;
+    findModulesByPath(path: string): Promise<Module[]>;
+    findSymbolByName(name: string): Promise<Symbol[]>;
+    findSymbolById(id: string): Promise<Symbol | null>;
+    findDependencies(moduleId: string): Promise<Dependency[]>;
+    findDependents(moduleId: string): Promise<Dependency[]>;
+    findCallers(functionId: string): Promise<Symbol[]>;
+    findCallees(functionId: string): Promise<Symbol[]>;
+    detectCycles(): Promise<Cycle[]>;
+    calculateImpact(moduleId: string, depth: number): Promise<ImpactResult>;
+    getStatistics(): Promise<ProjectStatistics>;
+    private createEmptyGraph;
+}
+//# sourceMappingURL=MemoryStorage.d.ts.map

package/dist/infrastructure/storage/adapters/MemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorage.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/adapters/MemoryStorage.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,UAAU,EACX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAgB,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,cAAc;IACd,OAAO,CAAC,KAAK,CAAsC;cAMnC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAK7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASlC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IAUnC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKvD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBlD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBlD,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IA2ChC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoCvE,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAkBjD,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/infrastructure/storage/adapters/MemoryStorage.js

@@ -0,0 +1,229 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Memory storage adapter - in-memory storage for testing and lightweight usage
+// ============================================
+// 内存存储适配器 - 用于测试和轻量级场景的内存存储
+// ============================================
+import { StorageBase } from '../interfaces/StorageBase.js';
+/**
+ * 内存存储适配器
+ *
+ * 特点：
+ * - 纯内存存储，无持久化
+ * - 速度最快
+ * - 进程结束数据丢失
+ * - 适合单元测试和临时分析
+ */
+export class MemoryStorage extends StorageBase {
+    type = 'memory';
+    /** 内存中的代码图 */
+    graph = this.createEmptyGraph();
+    // ============================================
+    // 生命周期管理
+    // ============================================
+    async doInitialize() {
+        // 内存存储无需特殊初始化
+        this.graph = this.createEmptyGraph();
+    }
+    async doClose() {
+        // 清理内存
+        this.graph = this.createEmptyGraph();
+    }
+    // ============================================
+    // 项目级别操作
+    // ============================================
+    async saveCodeGraph(graph) {
+        this.ensureInitialized();
+        this.graph = {
+            project: { ...graph.project },
+            modules: [...graph.modules],
+            symbols: [...graph.symbols],
+            dependencies: [...graph.dependencies],
+        };
+    }
+    async loadCodeGraph() {
+        this.ensureInitialized();
+        return {
+            project: { ...this.graph.project },
+            modules: [...this.graph.modules],
+            symbols: [...this.graph.symbols],
+            dependencies: [...this.graph.dependencies],
+        };
+    }
+    async deleteProject() {
+        this.ensureInitialized();
+        this.graph = this.createEmptyGraph();
+    }
+    // ============================================
+    // 增量更新
+    // ============================================
+    async updateModule(module) {
+        this.ensureInitialized();
+        const index = this.graph.modules.findIndex(m => m.id === module.id);
+        if (index >= 0) {
+            this.graph.modules[index] = { ...module };
+        }
+        else {
+            this.graph.modules.push({ ...module });
+        }
+    }
+    async deleteModule(moduleId) {
+        this.ensureInitialized();
+        this.graph.modules = this.graph.modules.filter(m => m.id !== moduleId);
+        this.graph.symbols = this.graph.symbols.filter(s => s.moduleId !== moduleId);
+        this.graph.dependencies = this.graph.dependencies.filter(d => d.sourceId !== moduleId && d.targetId !== moduleId);
+    }
+    // ============================================
+    // 查询操作
+    // ============================================
+    async findModuleById(id) {
+        this.ensureInitialized();
+        return this.graph.modules.find(m => m.id === id) ?? null;
+    }
+    async findModulesByPath(path) {
+        this.ensureInitialized();
+        return this.graph.modules.filter(m => m.path.includes(path));
+    }
+    async findSymbolByName(name) {
+        this.ensureInitialized();
+        return this.graph.symbols.filter(s => s.name.includes(name));
+    }
+    async findSymbolById(id) {
+        this.ensureInitialized();
+        return this.graph.symbols.find(s => s.id === id) ?? null;
+    }
+    async findDependencies(moduleId) {
+        this.ensureInitialized();
+        return this.graph.dependencies.filter(d => d.sourceId === moduleId);
+    }
+    async findDependents(moduleId) {
+        this.ensureInitialized();
+        return this.graph.dependencies.filter(d => d.targetId === moduleId);
+    }
+    async findCallers(functionId) {
+        this.ensureInitialized();
+        const callerIds = new Set();
+        for (const dep of this.graph.dependencies) {
+            if (dep.targetId === functionId && dep.type === 'call') {
+                callerIds.add(dep.sourceId);
+            }
+        }
+        const results = [];
+        for (const id of callerIds) {
+            const symbol = this.graph.symbols.find(s => s.id === id);
+            if (symbol)
+                results.push(symbol);
+        }
+        return results;
+    }
+    async findCallees(functionId) {
+        this.ensureInitialized();
+        const calleeIds = new Set();
+        for (const dep of this.graph.dependencies) {
+            if (dep.sourceId === functionId && dep.type === 'call') {
+                calleeIds.add(dep.targetId);
+            }
+        }
+        const results = [];
+        for (const id of calleeIds) {
+            const symbol = this.graph.symbols.find(s => s.id === id);
+            if (symbol)
+                results.push(symbol);
+        }
+        return results;
+    }
+    // ============================================
+    // 分析操作
+    // ============================================
+    async detectCycles() {
+        this.ensureInitialized();
+        const cycles = [];
+        const visited = new Set();
+        const inStack = new Set();
+        const dfs = (nodeId, path) => {
+            if (inStack.has(nodeId)) {
+                const cycleStart = path.indexOf(nodeId);
+                const cycleModules = path.slice(cycleStart);
+                cycles.push({
+                    modules: cycleModules,
+                    length: cycleModules.length,
+                });
+                return;
+            }
+            if (visited.has(nodeId)) {
+                return;
+            }
+            visited.add(nodeId);
+            inStack.add(nodeId);
+            for (const dep of this.graph.dependencies) {
+                if (dep.sourceId === nodeId) {
+                    dfs(dep.targetId, [...path, nodeId]);
+                }
+            }
+            inStack.delete(nodeId);
+        };
+        for (const module of this.graph.modules) {
+            if (!visited.has(module.id)) {
+                dfs(module.id, []);
+            }
+        }
+        return cycles;
+    }
+    async calculateImpact(moduleId, depth) {
+        this.ensureInitialized();
+        const affectedModules = [];
+        const visited = new Set();
+        const queue = [{ id: moduleId, level: 0 }];
+        while (queue.length > 0) {
+            const { id, level } = queue.shift();
+            if (visited.has(id) || level > depth) {
+                continue;
+            }
+            visited.add(id);
+            if (level > 0) {
+                const module = this.graph.modules.find(m => m.id === id);
+                if (module) {
+                    affectedModules.push({ ...module });
+                }
+            }
+            for (const dep of this.graph.dependencies) {
+                if (dep.targetId === id && !visited.has(dep.sourceId)) {
+                    queue.push({ id: dep.sourceId, level: level + 1 });
+                }
+            }
+        }
+        return {
+            rootModule: moduleId,
+            affectedModules,
+            depth,
+        };
+    }
+    async getStatistics() {
+        this.ensureInitialized();
+        const totalLines = this.graph.modules.reduce((sum, m) => sum + m.stats.lines, 0);
+        return {
+            totalModules: this.graph.modules.length,
+            totalSymbols: this.graph.symbols.length,
+            totalDependencies: this.graph.dependencies.length,
+            totalLines,
+            averageComplexity: 0,
+        };
+    }
+    // ============================================
+    // 私有方法
+    // ============================================
+    createEmptyGraph() {
+        return {
+            project: {
+                id: '',
+                name: '',
+                rootPath: this.projectPath ?? '',
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            },
+            modules: [],
+            symbols: [],
+            dependencies: [],
+        };
+    }
+}
+//# sourceMappingURL=MemoryStorage.js.map

package/dist/infrastructure/storage/adapters/MemoryStorage.js.map

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

package/dist/infrastructure/storage/adapters/Neo4jStorage.d.ts

@@ -0,0 +1,49 @@
+import type { StorageConfig, Cycle, ImpactResult, ProjectStatistics } from '../../../interface/types/storage.js';
+import type { CodeGraph, Module, Symbol, Dependency } from '../../../interface/types/index.js';
+import { StorageBase } from '../interfaces/StorageBase.js';
+/**
+ * Neo4j 存储适配器（可选依赖）
+ *
+ * 安装：npm install neo4j-driver
+ *
+ * 特点：
+ * - 企业级图数据库
+ * - Cypher 查询语言
+ * - 分布式部署支持
+ * - 适合团队协作场景
+ *
+ * TODO-DEBT [L1] [日期:2026-03-17] [作者:AI] [原因:MVP阶段暂不实现完整功能]
+ * 问题：目前使用内存 fallback 实现
+ * 风险：无法连接真实 Neo4j 实例
+ * 偿还计划：V1.0 实现完整 Neo4j 集成
+ */
+export declare class Neo4jStorage extends StorageBase {
+    readonly type: "neo4j";
+    /** Neo4j 驱动 */
+    private driver;
+    /** 内存 fallback */
+    private memoryGraph;
+    /** 存储配置 */
+    private dbConfig;
+    constructor(config: StorageConfig);
+    protected doInitialize(): Promise<void>;
+    protected doClose(): Promise<void>;
+    saveCodeGraph(graph: CodeGraph): Promise<void>;
+    loadCodeGraph(): Promise<CodeGraph>;
+    deleteProject(): Promise<void>;
+    updateModule(module: Module): Promise<void>;
+    deleteModule(moduleId: string): Promise<void>;
+    findModuleById(id: string): Promise<Module | null>;
+    findModulesByPath(path: string): Promise<Module[]>;
+    findSymbolByName(name: string): Promise<Symbol[]>;
+    findSymbolById(id: string): Promise<Symbol | null>;
+    findDependencies(moduleId: string): Promise<Dependency[]>;
+    findDependents(moduleId: string): Promise<Dependency[]>;
+    findCallers(_functionId: string): Promise<Symbol[]>;
+    findCallees(_functionId: string): Promise<Symbol[]>;
+    detectCycles(): Promise<Cycle[]>;
+    calculateImpact(moduleId: string, depth: number): Promise<ImpactResult>;
+    getStatistics(): Promise<ProjectStatistics>;
+    private createEmptyGraph;
+}
+//# sourceMappingURL=Neo4jStorage.d.ts.map

package/dist/infrastructure/storage/adapters/Neo4jStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jStorage.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/adapters/Neo4jStorage.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,KAAK,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,UAAU,EACX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAgB,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,eAAe;IACf,OAAO,CAAC,MAAM,CAAiB;IAE/B,kBAAkB;IAClB,OAAO,CAAC,WAAW,CAAsC;IAEzD,WAAW;IACX,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,EAAE,aAAa;cASjB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAuB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAWlC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IAmBnC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUlD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUlD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUlD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUzD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUvD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASnD,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKhC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IASvE,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgBjD,OAAO,CAAC,gBAAgB;CAczB"}