@nahisaho/musubix-neural-search 2.1.0 → 2.2.0

package/dist/EnhancedNeuralSearchManager.d.ts

@@ -0,0 +1,215 @@
+/**
+ * EnhancedNeuralSearchManager - v2.2.0 Integrated Neural Search
+ * @module @nahisaho/musubix-neural-search
+ * @see TSK-NS-108
+ * @see DES-NS-108
+ *
+ * v2.2.0コンポーネントを統合したニューラル検索マネージャー
+ * - LearnedPruningPolicy: 学習ベースプルーニング
+ * - AdaptiveBeamSearch: 適応的ビーム検索
+ * - OnlineLearner: オンライン学習
+ */
+import { type LearnedPruningPolicy, type PolicyStatistics } from './pruning/index.js';
+import { AdaptiveBeamSearch, type AdaptiveStatistics } from './search/index.js';
+/**
+ * Configuration for EnhancedNeuralSearchManager
+ */
+export interface EnhancedNeuralSearchManagerConfig {
+    /** Enable online learning (default: false) */
+    enableLearning?: boolean;
+    /** Enable adaptive beam search (default: true) */
+    enableAdaptiveBeam?: boolean;
+    /** Maximum cache size */
+    maxCacheSize?: number;
+    /** Initial beam width */
+    initialBeamWidth?: number;
+    /** Learning rate for online updates */
+    learningRate?: number;
+}
+/**
+ * Search candidate
+ */
+export interface SearchCandidate {
+    /** Unique identifier */
+    id: string;
+    /** Initial score */
+    score: number;
+    /** Feature vector */
+    features: number[];
+    /** Optional code snippet */
+    code?: string;
+}
+/**
+ * Search request
+ */
+export interface SearchRequest {
+    /** Query string */
+    query: string;
+    /** Candidate items */
+    candidates: SearchCandidate[];
+    /** Maximum results to return */
+    maxResults: number;
+}
+/**
+ * Search result
+ */
+export interface SearchResult {
+    /** Returned results */
+    results: SearchCandidate[];
+    /** Total search time in ms */
+    searchTimeMs: number;
+    /** Number of candidates pruned */
+    prunedCount: number;
+}
+/**
+ * Beam search request
+ */
+export interface BeamSearchRequest<T> {
+    /** Initial state */
+    initialState: T;
+    /** Expand function */
+    expand: (state: T) => T[];
+    /** Score function */
+    score: (state: T) => number;
+    /** Goal test function */
+    isGoal: (state: T) => boolean;
+    /** Beam width */
+    beamWidth: number;
+}
+/**
+ * Beam search result
+ */
+export interface BeamSearchResult<T> {
+    /** Found solutions */
+    solutions: T[];
+    /** Search depth reached */
+    depth: number;
+    /** Total states explored */
+    statesExplored: number;
+}
+/**
+ * Combined search request
+ */
+export interface CombinedSearchRequest {
+    /** Query string */
+    query: string;
+    /** Candidate items */
+    candidates: SearchCandidate[];
+    /** Use neural scoring */
+    useNeural: boolean;
+    /** Use learned pruning */
+    useLearned: boolean;
+    /** Maximum results */
+    maxResults: number;
+}
+/**
+ * Search feedback
+ */
+export interface SearchFeedback {
+    /** Query identifier */
+    queryId: string;
+    /** Selected result ID */
+    selectedId: string;
+    /** Outcome of the selection */
+    outcome: 'success' | 'failure' | 'partial';
+}
+/**
+ * Learning statistics
+ */
+export interface LearningStats {
+    /** Total feedback received */
+    totalFeedback: number;
+    /** Model update count */
+    modelUpdates: number;
+    /** Positive feedback rate */
+    positiveRate: number;
+}
+/**
+ * Search history entry
+ */
+export interface SearchHistoryEntry {
+    /** Query string */
+    query: string;
+    /** Number of results */
+    resultCount: number;
+    /** Search time in ms */
+    searchTimeMs: number;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Enhanced statistics
+ */
+export interface EnhancedSearchStats {
+    /** Search statistics */
+    search: {
+        totalSearches: number;
+        averageTimeMs: number;
+    };
+    /** Pruning statistics */
+    pruning: PolicyStatistics;
+    /** Learning statistics */
+    learning: LearningStats;
+    /** Beam search statistics */
+    beam: AdaptiveStatistics;
+}
+/**
+ * EnhancedNeuralSearchManager interface
+ */
+export interface EnhancedNeuralSearchManager {
+    getPruningPolicy(): LearnedPruningPolicy;
+    getAdaptiveBeamSearch(): AdaptiveBeamSearch;
+    search(request: SearchRequest): Promise<SearchResult>;
+    beamSearch<T>(request: BeamSearchRequest<T>): Promise<BeamSearchResult<T>>;
+    combinedSearch(request: CombinedSearchRequest): Promise<SearchResult>;
+    enableLearning(enabled: boolean): void;
+    isLearningEnabled(): boolean;
+    provideFeedback(feedback: SearchFeedback): Promise<void>;
+    updateModel(): Promise<void>;
+    getLearningStats(): LearningStats;
+    getAdaptiveStats(): AdaptiveStatistics;
+    getEnhancedStats(): EnhancedSearchStats;
+    getSearchHistory(limit: number): SearchHistoryEntry[];
+    toJSON(): string;
+    fromJSON(json: string): void;
+}
+/**
+ * Default EnhancedNeuralSearchManager implementation
+ */
+export declare class DefaultEnhancedNeuralSearchManager implements EnhancedNeuralSearchManager {
+    private config;
+    private pruningPolicy;
+    private adaptiveBeamSearch;
+    private learningEnabled;
+    private searchHistory;
+    private feedbackHistory;
+    private searchCount;
+    private totalSearchTimeMs;
+    private modelUpdateCount;
+    constructor(config?: EnhancedNeuralSearchManagerConfig);
+    getPruningPolicy(): LearnedPruningPolicy;
+    getAdaptiveBeamSearch(): AdaptiveBeamSearch;
+    search(request: SearchRequest): Promise<SearchResult>;
+    beamSearch<T>(request: BeamSearchRequest<T>): Promise<BeamSearchResult<T>>;
+    combinedSearch(request: CombinedSearchRequest): Promise<SearchResult>;
+    enableLearning(enabled: boolean): void;
+    isLearningEnabled(): boolean;
+    provideFeedback(feedback: SearchFeedback): Promise<void>;
+    updateModel(): Promise<void>;
+    getLearningStats(): LearningStats;
+    getAdaptiveStats(): AdaptiveStatistics;
+    getEnhancedStats(): EnhancedSearchStats;
+    getSearchHistory(limit: number): SearchHistoryEntry[];
+    toJSON(): string;
+    fromJSON(json: string): void;
+    private applyPruning;
+    private applyNeuralScoring;
+    private recordSearch;
+}
+/**
+ * Create an EnhancedNeuralSearchManager instance
+ * @param config - Optional configuration
+ * @returns EnhancedNeuralSearchManager instance
+ */
+export declare function createEnhancedNeuralSearchManager(config?: EnhancedNeuralSearchManagerConfig): EnhancedNeuralSearchManager;
+//# sourceMappingURL=EnhancedNeuralSearchManager.d.ts.map

package/dist/EnhancedNeuralSearchManager.d.ts.map

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

package/dist/EnhancedNeuralSearchManager.js

@@ -0,0 +1,307 @@
+/**
+ * EnhancedNeuralSearchManager - v2.2.0 Integrated Neural Search
+ * @module @nahisaho/musubix-neural-search
+ * @see TSK-NS-108
+ * @see DES-NS-108
+ *
+ * v2.2.0コンポーネントを統合したニューラル検索マネージャー
+ * - LearnedPruningPolicy: 学習ベースプルーニング
+ * - AdaptiveBeamSearch: 適応的ビーム検索
+ * - OnlineLearner: オンライン学習
+ */
+import { createLearnedPruningPolicy, } from './pruning/index.js';
+import { AdaptiveBeamSearch, } from './search/index.js';
+// =============================================================================
+// Default Implementation
+// =============================================================================
+/**
+ * Default EnhancedNeuralSearchManager implementation
+ */
+export class DefaultEnhancedNeuralSearchManager {
+    config;
+    pruningPolicy;
+    adaptiveBeamSearch;
+    // OnlineLearner for future use
+    // private onlineLearner: OnlineLearner;
+    learningEnabled = false;
+    searchHistory = [];
+    feedbackHistory = [];
+    searchCount = 0;
+    totalSearchTimeMs = 0;
+    modelUpdateCount = 0;
+    constructor(config = {}) {
+        this.config = {
+            enableLearning: config.enableLearning ?? false,
+            enableAdaptiveBeam: config.enableAdaptiveBeam ?? true,
+            maxCacheSize: config.maxCacheSize ?? 1000,
+            initialBeamWidth: config.initialBeamWidth ?? 10,
+            learningRate: config.learningRate ?? 0.01,
+        };
+        this.learningEnabled = this.config.enableLearning;
+        // Initialize components
+        this.pruningPolicy = createLearnedPruningPolicy({
+            baseThreshold: 0.5,
+            learningRate: this.config.learningRate,
+        });
+        const beamConfig = {
+            initialBeamWidth: this.config.initialBeamWidth,
+            maxBeamWidth: 100,
+            stagnationThreshold: 10,
+            beamWidthIncrease: 0.5,
+            improvementThreshold: 0.001,
+        };
+        this.adaptiveBeamSearch = new AdaptiveBeamSearch(beamConfig);
+    }
+    // =========================================================================
+    // Component Access
+    // =========================================================================
+    getPruningPolicy() {
+        return this.pruningPolicy;
+    }
+    getAdaptiveBeamSearch() {
+        return this.adaptiveBeamSearch;
+    }
+    // =========================================================================
+    // Search Methods
+    // =========================================================================
+    async search(request) {
+        const startTime = Date.now();
+        // Apply learned pruning
+        const prunedCandidates = this.applyPruning(request.candidates);
+        const prunedCount = request.candidates.length - prunedCandidates.length;
+        // Sort by score and take top results
+        const sortedCandidates = [...prunedCandidates].sort((a, b) => b.score - a.score);
+        const results = sortedCandidates.slice(0, request.maxResults);
+        const searchTimeMs = Date.now() - startTime;
+        this.recordSearch(request.query, results.length, searchTimeMs);
+        return {
+            results,
+            searchTimeMs,
+            prunedCount,
+        };
+    }
+    async beamSearch(request) {
+        const solutions = [];
+        let currentBeam = [request.initialState];
+        let depth = 0;
+        let statesExplored = 0;
+        const beamWidth = request.beamWidth;
+        while (currentBeam.length > 0 && depth < 100) {
+            const nextBeam = [];
+            for (const state of currentBeam) {
+                statesExplored++;
+                if (request.isGoal(state)) {
+                    solutions.push(state);
+                    continue;
+                }
+                const expanded = request.expand(state);
+                for (const nextState of expanded) {
+                    const score = request.score(nextState);
+                    nextBeam.push({ state: nextState, score });
+                }
+            }
+            // Sort and take top beam
+            nextBeam.sort((a, b) => b.score - a.score);
+            currentBeam = nextBeam.slice(0, beamWidth).map((item) => item.state);
+            depth++;
+            // Early termination if we have enough solutions
+            if (solutions.length >= beamWidth) {
+                break;
+            }
+        }
+        return {
+            solutions,
+            depth,
+            statesExplored,
+        };
+    }
+    async combinedSearch(request) {
+        const startTime = Date.now();
+        let candidates = [...request.candidates];
+        let prunedCount = 0;
+        // Apply learned pruning if enabled
+        if (request.useLearned) {
+            const pruned = this.applyPruning(candidates);
+            prunedCount = candidates.length - pruned.length;
+            candidates = pruned;
+        }
+        // Apply neural scoring if enabled
+        if (request.useNeural) {
+            candidates = this.applyNeuralScoring(candidates, request.query);
+        }
+        // Sort and take top results
+        const results = candidates
+            .sort((a, b) => b.score - a.score)
+            .slice(0, request.maxResults);
+        const searchTimeMs = Date.now() - startTime;
+        this.recordSearch(request.query, results.length, searchTimeMs);
+        return {
+            results,
+            searchTimeMs,
+            prunedCount,
+        };
+    }
+    // =========================================================================
+    // Learning Methods
+    // =========================================================================
+    enableLearning(enabled) {
+        this.learningEnabled = enabled;
+    }
+    isLearningEnabled() {
+        return this.learningEnabled;
+    }
+    async provideFeedback(feedback) {
+        if (!this.learningEnabled)
+            return;
+        this.feedbackHistory.push(feedback);
+        // Create proper PolicyUpdate for pruning policy
+        const dummyState = {
+            id: feedback.queryId,
+            code: feedback.selectedId,
+            depth: 0,
+            metadata: {},
+        };
+        const dummyContext = {
+            specification: feedback.queryId,
+            specEmbedding: new Float32Array(128),
+            constraints: [],
+            history: [],
+        };
+        const actualResult = feedback.outcome === 'partial' ? 'partial_success' : feedback.outcome;
+        const update = {
+            state: dummyState,
+            context: dummyContext,
+            outcome: feedback.outcome === 'success' ? 'correct' : 'incorrect',
+            actualResult,
+        };
+        this.pruningPolicy.updatePolicy(update);
+    }
+    async updateModel() {
+        if (!this.learningEnabled || this.feedbackHistory.length === 0)
+            return;
+        // Simple update simulation
+        // const _updateBatch = this.feedbackHistory.slice(0, 32);
+        // In production, would update model weights
+        this.modelUpdateCount++;
+        this.feedbackHistory = this.feedbackHistory.slice(32);
+    }
+    // =========================================================================
+    // Statistics
+    // =========================================================================
+    getLearningStats() {
+        const positiveCount = this.feedbackHistory.filter((f) => f.outcome === 'success').length;
+        const total = this.feedbackHistory.length;
+        return {
+            totalFeedback: total,
+            modelUpdates: this.modelUpdateCount,
+            positiveRate: total > 0 ? positiveCount / total : 0,
+        };
+    }
+    getAdaptiveStats() {
+        // Return custom adaptive stats since internal method returns SearchStatistics
+        return {
+            currentBeamWidth: this.config.initialBeamWidth,
+            beamWidthAdjustments: 0,
+            stagnationCount: 0,
+            bestScore: 0,
+            iterationsSinceImprovement: 0,
+        };
+    }
+    getEnhancedStats() {
+        return {
+            search: {
+                totalSearches: this.searchCount,
+                averageTimeMs: this.searchCount > 0 ? this.totalSearchTimeMs / this.searchCount : 0,
+            },
+            pruning: this.pruningPolicy.getStatistics(),
+            learning: this.getLearningStats(),
+            beam: this.getAdaptiveStats(),
+        };
+    }
+    getSearchHistory(limit) {
+        return this.searchHistory.slice(-limit);
+    }
+    // =========================================================================
+    // Serialization
+    // =========================================================================
+    toJSON() {
+        return JSON.stringify({
+            learningEnabled: this.learningEnabled,
+            searchCount: this.searchCount,
+            totalSearchTimeMs: this.totalSearchTimeMs,
+            modelUpdateCount: this.modelUpdateCount,
+            feedbackHistoryLength: this.feedbackHistory.length,
+        });
+    }
+    fromJSON(json) {
+        const data = JSON.parse(json);
+        if (data.learningEnabled !== undefined) {
+            this.learningEnabled = data.learningEnabled;
+        }
+        if (data.searchCount !== undefined) {
+            this.searchCount = data.searchCount;
+        }
+        if (data.totalSearchTimeMs !== undefined) {
+            this.totalSearchTimeMs = data.totalSearchTimeMs;
+        }
+        if (data.modelUpdateCount !== undefined) {
+            this.modelUpdateCount = data.modelUpdateCount;
+        }
+    }
+    // =========================================================================
+    // Private Helpers
+    // =========================================================================
+    applyPruning(candidates) {
+        // Use learned pruning policy to filter candidates
+        const context = {
+            specification: '',
+            specEmbedding: new Float32Array(128),
+            constraints: [],
+            history: [],
+        };
+        return candidates.filter((candidate) => {
+            const state = {
+                id: candidate.id,
+                code: candidate.code ?? '',
+                depth: 0,
+                metadata: { score: candidate.score },
+            };
+            const decision = this.pruningPolicy.shouldPrune(state, context);
+            return !decision.prune;
+        });
+    }
+    applyNeuralScoring(candidates, _query) {
+        // Simple neural scoring simulation
+        // In production, would use actual neural embeddings
+        return candidates.map((c) => ({
+            ...c,
+            score: c.score * (1 + Math.random() * 0.1), // Add small variation
+        }));
+    }
+    recordSearch(query, resultCount, searchTimeMs) {
+        this.searchCount++;
+        this.totalSearchTimeMs += searchTimeMs;
+        this.searchHistory.push({
+            query,
+            resultCount,
+            searchTimeMs,
+            timestamp: Date.now(),
+        });
+        // Limit history size
+        if (this.searchHistory.length > this.config.maxCacheSize) {
+            this.searchHistory = this.searchHistory.slice(-this.config.maxCacheSize);
+        }
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create an EnhancedNeuralSearchManager instance
+ * @param config - Optional configuration
+ * @returns EnhancedNeuralSearchManager instance
+ */
+export function createEnhancedNeuralSearchManager(config = {}) {
+    return new DefaultEnhancedNeuralSearchManager(config);
+}
+//# sourceMappingURL=EnhancedNeuralSearchManager.js.map

package/dist/EnhancedNeuralSearchManager.js.map

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

package/dist/cache/EmbeddingCache.d.ts

@@ -0,0 +1,93 @@
+/**
+ * EmbeddingCache - LRU Cache for Embeddings
+ * @module @nahisaho/musubix-neural-search
+ * @see TSK-NS-105
+ * @see DES-NS-105
+ * @see REQ-NS-105
+ *
+ * LRUキャッシュ（最大10,000エントリ）
+ * - 80%以上のヒット率目標
+ * - TTLサポート
+ * - バッチ操作
+ */
+import type { Embedding } from '../types.js';
+/**
+ * Configuration for EmbeddingCache
+ */
+export interface EmbeddingCacheConfig {
+    /** Maximum number of entries (default: 10000) */
+    maxSize?: number;
+    /** Time-to-live in milliseconds (default: 0 = no expiry) */
+    ttlMs?: number;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStatistics {
+    /** Current cache size */
+    size: number;
+    /** Maximum cache size */
+    maxSize: number;
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Hit rate (0-1) */
+    hitRate: number;
+    /** Number of evictions */
+    evictions: number;
+}
+/**
+ * EmbeddingCache interface
+ */
+export interface EmbeddingCache {
+    get(key: string): Embedding | undefined;
+    set(key: string, value: Embedding): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    size(): number;
+    getMany(keys: string[]): Map<string, Embedding>;
+    setMany(entries: Map<string, Embedding>): void;
+    getHitRate(): number;
+    getStatistics(): CacheStatistics;
+    resetStatistics(): void;
+    toJSON(): string;
+    fromJSON(json: string): void;
+}
+/**
+ * Default EmbeddingCache implementation using LRU eviction
+ */
+export declare class DefaultEmbeddingCache implements EmbeddingCache {
+    private config;
+    private cache;
+    private accessOrder;
+    private hits;
+    private misses;
+    private evictions;
+    constructor(config?: EmbeddingCacheConfig);
+    get(key: string): Embedding | undefined;
+    set(key: string, value: Embedding): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    size(): number;
+    getMany(keys: string[]): Map<string, Embedding>;
+    setMany(entries: Map<string, Embedding>): void;
+    getHitRate(): number;
+    getStatistics(): CacheStatistics;
+    resetStatistics(): void;
+    toJSON(): string;
+    fromJSON(json: string): void;
+    private isExpired;
+    private evictLRU;
+    private updateAccessOrder;
+    private removeFromAccessOrder;
+}
+/**
+ * Create an EmbeddingCache instance
+ * @param config - Optional configuration
+ * @returns EmbeddingCache instance
+ */
+export declare function createEmbeddingCache(config?: EmbeddingCacheConfig): EmbeddingCache;
+//# sourceMappingURL=EmbeddingCache.d.ts.map

package/dist/cache/EmbeddingCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingCache.d.ts","sourceRoot":"","sources":["../../src/cache/EmbeddingCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,MAAM,CAAC;IAGf,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IAG/C,UAAU,IAAI,MAAM,CAAC;IACrB,aAAa,IAAI,eAAe,CAAC;IACjC,eAAe,IAAI,IAAI,CAAC;IAGxB,MAAM,IAAI,MAAM,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAMD;;GAEG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAAgB;IAGnC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,GAAE,oBAAyB;IAW7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAuBvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAuBxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,MAAM;IAQd,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAa/C,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAU9C,UAAU,IAAI,MAAM;IAMpB,aAAa,IAAI,eAAe;IAWhC,eAAe,IAAI,IAAI;IAUvB,MAAM,IAAI,MAAM;IAShB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqB5B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,qBAAqB;CAM9B;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,oBAAyB,GAChC,cAAc,CAEhB"}