memento-mcp-server 1.16.3-a → 1.16.3-c

package/dist/domains/search/algorithms/vector-search-engine-migration.d.ts

@@ -2,23 +2,28 @@
  * 기존 코드에서 리팩토링된 코드로의 점진적 전환을 지원합니다.
  * 마이그레이션 가이드와 헬퍼를 제공하여 안전한 전환을 보장합니다.
  */
-import { VectorSearchEngineRefactored } from './vector-search-engine-refactored';
-import type { VectorSearchEngine } from './vector-search-engine';
+import { VectorSearchEngine } from './vector-search-engine.js';
 /**
- * 기존 VectorSearchEngine에서 새로운 VectorSearchEngineRefactored로 안전하게 전환합니다.
- * 마이그레이션 헬퍼를 제공하여 데이터 손실 없이 점진적 전환을 지원합니다.
+ * 기존 VectorSearchEngine에서 새로운 구조로의 전환을 지원합니다.
+ * 마이그레이션 헬퍼를 제공하여 안전한 전환을 보장합니다.
+ *
+ * @deprecated 리팩토링이 완료되어 더 이상 필요하지 않습니다.
  */
 export declare class VectorSearchEngineMigration {
     /**
      * 기존 엔진을 새로운 엔진으로 교체하여 개선된 구현을 사용합니다.
      * 데이터베이스 연결 상태를 유지하여 중단 없는 전환을 보장합니다.
+     *
+     * @deprecated 리팩토링이 완료되어 더 이상 필요하지 않습니다.
      */
-    static migrate(oldEngine: VectorSearchEngine): VectorSearchEngineRefactored;
+    static migrate(oldEngine: VectorSearchEngine): VectorSearchEngine;
     /**
      * 점진적 마이그레이션을 위해 어댑터 패턴을 사용하여 기존 코드 수정 없이 전환합니다.
      * 기존 인터페이스를 유지하면서 내부적으로는 새로운 구현을 사용합니다.
+     *
+     * @deprecated 리팩토링이 완료되어 더 이상 필요하지 않습니다.
      */
-    static createAdapter(oldEngine: VectorSearchEngine): VectorSearchEngineRefactored;
+    static createAdapter(oldEngine: VectorSearchEngine): VectorSearchEngine;
 }
 /**
  * 마이그레이션 체크리스트
@@ -56,11 +61,11 @@ export declare class MigrationValidator {
     /**
      * 기존 기능과 새 기능의 호환성 검증
      */
-    static validateCompatibility(oldEngine: VectorSearchEngine, newEngine: VectorSearchEngineRefactored): Promise<boolean>;
+    static validateCompatibility(oldEngine: VectorSearchEngine, newEngine: VectorSearchEngine): Promise<boolean>;
     /**
      * 성능 비교 테스트
      */
-    static comparePerformance(oldEngine: VectorSearchEngine, newEngine: VectorSearchEngineRefactored, testVector: number[]): Promise<{
+    static comparePerformance(oldEngine: VectorSearchEngine, newEngine: VectorSearchEngine, testVector: number[]): Promise<{
         oldPerformance: any;
         newPerformance: any;
         improvement: number;

package/dist/domains/search/algorithms/vector-search-engine-migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-search-engine-migration.d.ts","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine-migration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;GAGG;AACH,qBAAa,2BAA2B;IACtC;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,kBAAkB,GAAG,4BAA4B;IAa3E;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,kBAAkB,GAAG,4BAA4B;CA2ClF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAc/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;CA6D3B,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;WACU,qBAAqB,CAChC,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,4BAA4B,GACtC,OAAO,CAAC,OAAO,CAAC;IAiCnB;;OAEG;WACU,kBAAkB,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,4BAA4B,EACvC,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;QACT,cAAc,EAAE,GAAG,CAAC;QACpB,cAAc,EAAE,GAAG,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CAqBH"}
+{"version":3,"file":"vector-search-engine-migration.d.ts","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine-migration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;;;GAKG;AACH,qBAAa,2BAA2B;IACtC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,kBAAkB,GAAG,kBAAkB;IAcjE;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,kBAAkB,GAAG,kBAAkB;CAIxE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAc/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;CA6D3B,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;WACU,qBAAqB,CAChC,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,OAAO,CAAC;IAiCnB;;OAEG;WACU,kBAAkB,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;QACT,cAAc,EAAE,GAAG,CAAC;QACpB,cAAc,EAAE,GAAG,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CAqBH"}

package/dist/domains/search/algorithms/vector-search-engine-migration.js

@@ -2,19 +2,24 @@
  * 기존 코드에서 리팩토링된 코드로의 점진적 전환을 지원합니다.
  * 마이그레이션 가이드와 헬퍼를 제공하여 안전한 전환을 보장합니다.
  */
-import { VectorSearchEngineRefactored } from './vector-search-engine-refactored';
+import { VectorSearchEngine } from './vector-search-engine.js';
 import { PIIMasker } from '../../../shared/utils/pii-masker.js';
 /**
- * 기존 VectorSearchEngine에서 새로운 VectorSearchEngineRefactored로 안전하게 전환합니다.
- * 마이그레이션 헬퍼를 제공하여 데이터 손실 없이 점진적 전환을 지원합니다.
+ * 기존 VectorSearchEngine에서 새로운 구조로의 전환을 지원합니다.
+ * 마이그레이션 헬퍼를 제공하여 안전한 전환을 보장합니다.
+ *
+ * @deprecated 리팩토링이 완료되어 더 이상 필요하지 않습니다.
  */
 export class VectorSearchEngineMigration {
     /**
      * 기존 엔진을 새로운 엔진으로 교체하여 개선된 구현을 사용합니다.
      * 데이터베이스 연결 상태를 유지하여 중단 없는 전환을 보장합니다.
+     *
+     * @deprecated 리팩토링이 완료되어 더 이상 필요하지 않습니다.
      */
     static migrate(oldEngine) {
-        const newEngine = new VectorSearchEngineRefactored();
+        // 리팩토링이 완료되어 기존 엔진을 그대로 반환
+        const newEngine = new VectorSearchEngine();
         // 기존 데이터베이스 연결을 새 엔진에 전달하여 중단 없는 전환을 보장합니다.
         if (oldEngine.isConnected()) {
             // 기존 엔진의 데이터베이스 인스턴스를 가져와서 새 엔진에 설정하여 연결 상태를 유지합니다.
@@ -26,39 +31,12 @@ export class VectorSearchEngineMigration {
     /**
      * 점진적 마이그레이션을 위해 어댑터 패턴을 사용하여 기존 코드 수정 없이 전환합니다.
      * 기존 인터페이스를 유지하면서 내부적으로는 새로운 구현을 사용합니다.
+     *
+     * @deprecated 리팩토링이 완료되어 더 이상 필요하지 않습니다.
      */
     static createAdapter(oldEngine) {
-        const newEngine = new VectorSearchEngineRefactored();
-        // 기존 엔진의 메서드들을 새 엔진으로 위임하여 호환성을 유지합니다.
-        const adapter = {
-            ...newEngine,
-            // 기존 메서드들을 새 엔진으로 위임하여 점진적 전환을 지원합니다.
-            async search(queryVector, options = {}, provider = 'tfidf') {
-                return await newEngine.search(queryVector, options, provider);
-            },
-            async hybridSearch(queryVector, textQuery, options = {}, provider = 'tfidf') {
-                return await newEngine.hybridSearch(queryVector, textQuery, options, provider);
-            },
-            getIndexStatus() {
-                return newEngine.getIndexStatus();
-            },
-            async rebuildIndex() {
-                return await newEngine.rebuildIndex();
-            },
-            async performanceTest(queryVector, iterations = 10) {
-                return await newEngine.performanceTest(queryVector, iterations);
-            },
-            getDimensions() {
-                return newEngine.getDimensions();
-            },
-            isAvailable() {
-                return newEngine.isAvailable();
-            },
-            isConnected() {
-                return newEngine.isConnected();
-            }
-        };
-        return adapter;
+        // 리팩토링이 완료되어 기존 엔진을 그대로 반환
+        return new VectorSearchEngine();
     }
 }
 /**
@@ -72,8 +50,8 @@ export const MIGRATION_CHECKLIST = [
     '✅ 5. 리포지토리 구현 확인 (src/repositories/)',
     '✅ 6. 팩토리 클래스 확인 (src/factories/vector-search.factory.ts)',
     '✅ 7. 컨테이너 클래스 확인 (src/services/vector-search/vector-search-container.ts)',
-    '✅ 8. 리팩토링된 엔진 확인 (src/algorithms/vector-search-engine-refactored.ts)',
-    '✅ 9. 테스트 코드 확인 (src/algorithms/vector-search-engine-refactored.spec.ts)',
+    '✅ 8. 리팩토링 완료 (vector-search-engine.ts에 통합됨)',
+    '✅ 9. 테스트 코드 확인 완료',
     '⏳ 10. 기존 코드에서 새 코드로 교체',
     '⏳ 11. 통합 테스트 실행',
     '⏳ 12. 성능 테스트 실행',
@@ -90,8 +68,8 @@ export const MIGRATION_STEPS = {
 // 기존
 import { VectorSearchEngine } from './vector-search-engine';
 
-// 새로운
-import { VectorSearchEngineRefactored } from './vector-search-engine-refactored';
+// 새로운 (리팩토링 완료)
+import { VectorSearchEngine } from './vector-search-engine';
 import type { VectorSearchQuery, VectorSearchResult } from '../../../shared/types/vector-search.types';
     `
     },
@@ -103,8 +81,8 @@ import type { VectorSearchQuery, VectorSearchResult } from '../../../shared/type
 const engine = new VectorSearchEngine();
 engine.initialize(db);
 
-// 새로운
-const engine = new VectorSearchEngineRefactored();
+// 새로운 (리팩토링 완료)
+const engine = new VectorSearchEngine();
 engine.initialize(db);
     `
     },

package/dist/domains/search/algorithms/vector-search-engine-migration.js.map

@@ -1 +1 @@
-{"version":3,"file":"vector-search-engine-migration.js","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine-migration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vector-search-engine-migration.js","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine-migration.ts"],"names":[],"mappings":"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"}

package/dist/domains/search/algorithms/vector-search-engine.d.ts

@@ -2,6 +2,9 @@
  * 의미적 유사성을 기반으로 한 고성능 벡터 검색을 제공합니다.
  * sqlite-vec를 사용하여 대용량 벡터 데이터에서도 빠른 유사도 검색을 수행합니다.
  * Memento MCP Server의 핵심 벡터 검색 컴포넌트로서 의미 기반 검색 기능을 제공합니다.
+ *
+ * 리팩토링: VectorSearchContainer와 Facade 패턴을 사용하여 개선된 구조를 활용합니다.
+ * 기존 인터페이스는 유지하여 하위 호환성을 보장합니다.
  */
 import Database from 'better-sqlite3';
 export interface VectorSearchResult {
@@ -29,63 +32,35 @@ export interface VectorIndexStatus {
     dimensions: number;
     vecExtensionLoaded: boolean;
 }
+/**
+ * 벡터 검색 엔진
+ * 리팩토링된 구조를 사용하여 개선된 유지보수성과 테스트 가능성을 제공합니다.
+ */
 export declare class VectorSearchEngine {
-    private db;
-    private isVecAvailable;
-    private vecExtensionLoaded;
-    private readonly defaultDimensions;
-    private providerDimensions;
-    private readonly defaultThreshold;
-    private readonly defaultLimit;
+    private container;
     constructor();
-    /**
-     * 각 임베딩 provider별로 다른 벡터 테이블을 사용하여 차원 불일치를 방지합니다.
-     * provider에 따라 적절한 테이블명을 반환하여 정확한 검색을 보장합니다.
-     * SQL Injection 방지를 위해 화이트리스트 기반 검증을 수행합니다.
-     */
-    private getVectorTableName;
     /**
      * 데이터베이스 연결을 설정하고 벡터 검색 기능의 사용 가능 여부를 확인합니다.
-     * provider별 차원 정보를 갱신하여 정확한 검색을 보장합니다.
-     */
-    initialize(db: Database.Database): void;
-    /**
-     * 벡터 검색 기능이 실제로 사용 가능한지 확인하여 안전한 검색을 보장합니다.
-     * sqlite-vec 확장 로드 여부와 테이블 존재를 모두 확인하여 런타임 오류를 방지합니다.
      */
-    private checkVecAvailability;
-    /**
-     * 데이터베이스에 저장된 실제 임베딩 차원을 조회하여 정확한 벡터 검색을 보장합니다.
-     * provider별로 다른 차원을 사용할 수 있으므로 메타데이터에서 차원 정보를 갱신합니다.
-     */
-    private refreshProviderDimensions;
-    /**
-     * 특정 provider의 실제 저장된 임베딩 차원을 조회하여 벡터 검색 시 차원 불일치를 방지합니다.
-     */
-    private getActualStoredDimensions;
+    initialize(db: Database.Database | null): void;
     /**
      * 쿼리 벡터와 유사한 메모리를 검색하여 의미적으로 관련된 결과를 제공합니다.
-     * sqlite-vec의 고성능 벡터 검색 기능을 활용하여 빠르고 정확한 검색을 수행합니다.
      */
     search(queryVector: number[], options?: VectorSearchOptions, provider?: string): Promise<VectorSearchResult[]>;
     /**
      * 벡터 검색과 메타데이터 검색을 결합하여 검색 정확도와 포괄성을 동시에 확보합니다.
-     * SQLite 호환성을 위해 LEFT JOIN을 사용하여 안정적인 검색을 보장합니다.
      */
     hybridSearch(queryVector: number[], textQuery: string, options?: VectorSearchOptions, provider?: string): Promise<VectorSearchResult[]>;
     /**
      * 벡터 검색 기능의 현재 상태를 확인하여 사용 가능 여부와 인덱스 정보를 제공합니다.
-     * 시스템 모니터링과 디버깅을 위해 인덱스 상태를 조회합니다.
      */
     getIndexStatus(): VectorIndexStatus;
     /**
      * 벡터 인덱스를 재구성하여 검색 성능을 최적화합니다.
-     * sqlite-vec는 자동으로 인덱스를 관리하므로 수동 재구성이 필요 없는 경우를 처리합니다.
      */
     rebuildIndex(): Promise<boolean>;
     /**
      * 벡터 검색의 성능을 측정하여 최적화 지점을 파악합니다.
-     * 반복 실행을 통해 평균, 최소, 최대 응답 시간과 성공률을 계산합니다.
      */
     performanceTest(queryVector: number[], iterations?: number): Promise<{
         averageTime: number;
@@ -98,6 +73,14 @@ export declare class VectorSearchEngine {
      * 특정 provider의 벡터 차원을 조회하여 벡터 검색 시 차원 정보를 제공합니다.
      */
     getDimensions(provider?: string): number;
+    /**
+     * 각 임베딩 provider별로 다른 벡터 테이블을 사용하여 차원 불일치를 방지합니다.
+     * provider에 따라 적절한 테이블명을 반환하여 정확한 검색을 보장합니다.
+     * SQL Injection 방지를 위해 화이트리스트 기반 검증을 수행합니다.
+     *
+     * @internal 테스트를 위해 public으로 유지
+     */
+    getVectorTableName(provider: string): string;
     /**
      * 벡터 검색 기능이 사용 가능한지 확인하여 호출자가 적절한 처리를 할 수 있도록 합니다.
      */
@@ -106,8 +89,6 @@ export declare class VectorSearchEngine {
      * 데이터베이스 연결 상태를 확인하여 검색 실행 전 안전성을 보장합니다.
      */
     isConnected(): boolean;
-    private safeParseTags;
-    private getExpectedDimensions;
 }
 export declare function getVectorSearchEngine(): VectorSearchEngine;
 export declare function createVectorSearchEngine(): VectorSearchEngine;

package/dist/domains/search/algorithms/vector-search-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-search-engine.d.ts","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IACzC,OAAO,CAAC,kBAAkB,CAKxB;IACF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAM;;IAMnC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAMvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAsE5B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAkCjC;;OAEG;YACW,yBAAyB;IAsBvC;;;OAGG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsIhC;;;OAGG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgJhC;;;OAGG;IACH,cAAc,IAAI,iBAAiB;IAiDnC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBtC;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC;QAC7E,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAyCF;;OAEG;IACH,aAAa,CAAC,QAAQ,GAAE,MAAgB,GAAG,MAAM;IAIjD;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,qBAAqB;CAG9B;AAKD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}
+{"version":3,"file":"vector-search-engine.d.ts","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAStC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAwB;;IAMzC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI;IAS9C;;OAEG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAehC;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgBhC;;OAEG;IACH,cAAc,IAAI,iBAAiB;IA8BnC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAatC;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC;QAC7E,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAyBF;;OAEG;IACH,aAAa,CAAC,QAAQ,GAAE,MAAgB,GAAG,MAAM;IAWjD;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACH,WAAW,IAAI,OAAO;IAYtB;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB;AAKD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}