specmem-hardwicksoftware 3.5.99

package/dist/watcher/changeQueue.d.ts

@@ -0,0 +1,133 @@
+/**
+ * changeQueue.ts - Queue Management for File Changes
+ *
+ * yooo batching all them file changes for performance
+ * handles queuing, deduplication, and ordered processing
+ *
+ * Features:
+ * - FIFO queue with priority support
+ * - Deduplication (dont process same file twice)
+ * - Batch processing for efficiency
+ * - Retry logic with exponential backoff
+ * - Progress tracking
+ * - Conflict resolution
+ */
+import { FileChangeEvent } from './fileWatcher.js';
+import { AutoUpdateTheMemories } from './changeHandler.js';
+export interface QueueConfig {
+    maxQueueSize?: number;
+    batchSize?: number;
+    processingIntervalMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    retryBackoffMultiplier?: number;
+    enableDeduplication?: boolean;
+}
+export interface QueuedChange {
+    event: FileChangeEvent;
+    priority: number;
+    retries: number;
+    lastError?: Error;
+    enqueuedAt: Date;
+    processedAt?: Date;
+}
+export interface QueueStats {
+    queuedCount: number;
+    processedCount: number;
+    failedCount: number;
+    retriedCount: number;
+    deduplicatedCount: number;
+    averageProcessingTimeMs: number;
+    currentQueueSize: number;
+    isProcessing: boolean;
+}
+/**
+ * queueTheChangesUp - change queue manager
+ *
+ * fr fr keeping all them changes organized
+ */
+export declare class QueueTheChangesUp {
+    private config;
+    private queue;
+    private processing;
+    private processingInterval;
+    private changeHandler;
+    private dedupMap;
+    private retryTimeouts;
+    private stats;
+    private processingTimes;
+    constructor(changeHandler: AutoUpdateTheMemories, config?: QueueConfig);
+    /**
+     * enqueue - adds a file change to the queue
+     *
+     * yooo adding this change to the queue
+     */
+    enqueue(event: FileChangeEvent, priority?: number): boolean;
+    /**
+     * startProcessing - begins processing queue
+     *
+     * fr fr lets start processing these changes
+     */
+    startProcessing(): void;
+    /**
+     * stopProcessing - stops queue processing
+     *
+     * @param flush - if true, processes all pending changes before stopping (default: true)
+     */
+    stopProcessing(flush?: boolean): Promise<void>;
+    /**
+     * processBatch - processes a batch of changes
+     *
+     * nah bruh processing this whole batch at once
+     */
+    private processBatch;
+    /**
+     * processChange - processes a single change
+     */
+    private processChange;
+    /**
+     * sortQueue - sorts queue by priority (highest first)
+     */
+    private sortQueue;
+    /**
+     * getStats - returns queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * clear - clears the queue
+     */
+    clear(): void;
+    /**
+     * flush - processes all pending changes immediately
+     *
+     * yooo flushing the whole queue rn
+     */
+    flush(): Promise<void>;
+    /**
+     * getPendingCount - returns number of pending changes
+     */
+    getPendingCount(): number;
+    /**
+     * hasPendingChanges - checks if there are pending changes
+     */
+    hasPendingChanges(): boolean;
+    /**
+     * getPendingPaths - returns paths of all pending changes
+     */
+    getPendingPaths(): string[];
+    /**
+     * getQueueHealth - returns queue health metrics
+     */
+    getQueueHealth(): {
+        healthy: boolean;
+        queueUtilization: number;
+        failureRate: number;
+        averageProcessingTimeMs: number;
+        issues: string[];
+    };
+    /**
+     * resetStats - resets statistics
+     */
+    resetStats(): void;
+}
+//# sourceMappingURL=changeQueue.d.ts.map

package/dist/watcher/changeQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeQueue.d.ts","sourceRoot":"","sources":["../../src/watcher/changeQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAE1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGhC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,aAAa,CAAwB;IAG7C,OAAO,CAAC,QAAQ,CAAmC;IAGnD,OAAO,CAAC,aAAa,CAAkC;IAGvD,OAAO,CAAC,KAAK,CASX;IAGF,OAAO,CAAC,eAAe,CAAgB;gBAGrC,aAAa,EAAE,qBAAqB,EACpC,MAAM,GAAE,WAAgB;IAc1B;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,GAAE,MAAU,GAAG,OAAO;IAwD9D;;;;OAIG;IACH,eAAe,IAAI,IAAI;IAwBvB;;;;OAIG;IACG,cAAc,CAAC,KAAK,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC1D;;;;OAIG;YACW,YAAY;IAoC1B;;OAEG;YACW,aAAa;IA8E3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,cAAc,IAAI;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,uBAAuB,EAAE,MAAM,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAiCD;;OAEG;IACH,UAAU,IAAI,IAAI;CAanB"}

package/dist/watcher/changeQueue.js

@@ -0,0 +1,355 @@
+/**
+ * changeQueue.ts - Queue Management for File Changes
+ *
+ * yooo batching all them file changes for performance
+ * handles queuing, deduplication, and ordered processing
+ *
+ * Features:
+ * - FIFO queue with priority support
+ * - Deduplication (dont process same file twice)
+ * - Batch processing for efficiency
+ * - Retry logic with exponential backoff
+ * - Progress tracking
+ * - Conflict resolution
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * queueTheChangesUp - change queue manager
+ *
+ * fr fr keeping all them changes organized
+ */
+export class QueueTheChangesUp {
+    config;
+    queue = [];
+    processing = false;
+    processingInterval = null;
+    changeHandler;
+    // deduplication map: path -> latest queued change
+    dedupMap = new Map();
+    // LOW-10 FIX: Track retry timeouts for cleanup on stop
+    retryTimeouts = new Set();
+    // stats
+    stats = {
+        queuedCount: 0,
+        processedCount: 0,
+        failedCount: 0,
+        retriedCount: 0,
+        deduplicatedCount: 0,
+        averageProcessingTimeMs: 0,
+        currentQueueSize: 0,
+        isProcessing: false
+    };
+    // processing times for average calculation
+    processingTimes = [];
+    constructor(changeHandler, config = {}) {
+        this.changeHandler = changeHandler;
+        this.config = {
+            maxQueueSize: config.maxQueueSize ?? 10000,
+            batchSize: config.batchSize ?? 50,
+            processingIntervalMs: config.processingIntervalMs ?? 2000,
+            maxRetries: config.maxRetries ?? 3,
+            retryDelayMs: config.retryDelayMs ?? 1000,
+            retryBackoffMultiplier: config.retryBackoffMultiplier ?? 2,
+            enableDeduplication: config.enableDeduplication ?? true
+        };
+    }
+    /**
+     * enqueue - adds a file change to the queue
+     *
+     * yooo adding this change to the queue
+     */
+    enqueue(event, priority = 1) {
+        // check if queue is full
+        if (this.queue.length >= this.config.maxQueueSize) {
+            logger.warn({ queueSize: this.queue.length }, 'queue is full - dropping event');
+            return false;
+        }
+        // deduplication check
+        if (this.config.enableDeduplication) {
+            const existing = this.dedupMap.get(event.path);
+            if (existing) {
+                // update existing entry with latest event
+                existing.event = event;
+                existing.priority = Math.max(existing.priority, priority);
+                this.stats.deduplicatedCount++;
+                logger.debug({
+                    path: event.path,
+                    type: event.type
+                }, 'deduplicated file change');
+                return true;
+            }
+        }
+        // create queued change
+        const queuedChange = {
+            event,
+            priority,
+            retries: 0,
+            enqueuedAt: new Date()
+        };
+        // add to queue (sorted by priority)
+        this.queue.push(queuedChange);
+        this.sortQueue();
+        // add to dedup map
+        if (this.config.enableDeduplication) {
+            this.dedupMap.set(event.path, queuedChange);
+        }
+        this.stats.queuedCount++;
+        this.stats.currentQueueSize = this.queue.length;
+        logger.debug({
+            path: event.path,
+            type: event.type,
+            priority,
+            queueSize: this.queue.length
+        }, 'file change enqueued');
+        return true;
+    }
+    /**
+     * startProcessing - begins processing queue
+     *
+     * fr fr lets start processing these changes
+     */
+    startProcessing() {
+        if (this.processing) {
+            logger.warn('queue processing already started');
+            return;
+        }
+        logger.info({
+            batchSize: this.config.batchSize,
+            intervalMs: this.config.processingIntervalMs
+        }, 'starting queue processing');
+        this.processing = true;
+        this.stats.isProcessing = true;
+        // start processing interval
+        this.processingInterval = setInterval(() => this.processBatch(), this.config.processingIntervalMs);
+        // also process immediately
+        this.processBatch();
+    }
+    /**
+     * stopProcessing - stops queue processing
+     *
+     * @param flush - if true, processes all pending changes before stopping (default: true)
+     */
+    async stopProcessing(flush = true) {
+        if (!this.processing) {
+            logger.warn('queue processing not running');
+            return;
+        }
+        logger.info({ flush, pendingCount: this.queue.length }, 'stopping queue processing');
+        // FIX MED-15: Flush pending changes before stopping to avoid data loss
+        if (flush && this.queue.length > 0) {
+            logger.info({ pendingCount: this.queue.length }, 'flushing pending changes before stop');
+            await this.flush();
+        }
+        this.processing = false;
+        this.stats.isProcessing = false;
+        if (this.processingInterval) {
+            clearInterval(this.processingInterval);
+            this.processingInterval = null;
+        }
+        // LOW-10 FIX: Cancel all pending retry timeouts to prevent memory leaks
+        for (const timeout of this.retryTimeouts) {
+            clearTimeout(timeout);
+        }
+        const cancelledCount = this.retryTimeouts.size;
+        this.retryTimeouts.clear();
+        if (cancelledCount > 0) {
+            logger.debug({ cancelledTimeouts: cancelledCount }, 'cancelled pending retry timeouts');
+        }
+    }
+    /**
+     * processBatch - processes a batch of changes
+     *
+     * nah bruh processing this whole batch at once
+     */
+    async processBatch() {
+        if (this.queue.length === 0) {
+            return;
+        }
+        logger.debug({
+            queueSize: this.queue.length,
+            batchSize: this.config.batchSize
+        }, 'processing batch');
+        // take batch from front of queue
+        const batch = this.queue.splice(0, this.config.batchSize);
+        // process each change in parallel (with concurrency limit)
+        const promises = batch.map(change => this.processChange(change));
+        try {
+            await Promise.allSettled(promises);
+        }
+        catch (error) {
+            logger.error({ error }, 'batch processing error');
+        }
+        this.stats.currentQueueSize = this.queue.length;
+        // update average processing time
+        if (this.processingTimes.length > 0) {
+            const sum = this.processingTimes.reduce((a, b) => a + b, 0);
+            this.stats.averageProcessingTimeMs = sum / this.processingTimes.length;
+            // keep only last 100 times
+            if (this.processingTimes.length > 100) {
+                this.processingTimes = this.processingTimes.slice(-100);
+            }
+        }
+    }
+    /**
+     * processChange - processes a single change
+     */
+    async processChange(change) {
+        const startTime = Date.now();
+        try {
+            // process the change
+            await this.changeHandler.handleChange(change.event);
+            // success
+            change.processedAt = new Date();
+            this.stats.processedCount++;
+            // remove from dedup map
+            if (this.config.enableDeduplication) {
+                this.dedupMap.delete(change.event.path);
+            }
+            // track processing time
+            const processingTime = Date.now() - startTime;
+            this.processingTimes.push(processingTime);
+            logger.debug({
+                path: change.event.path,
+                type: change.event.type,
+                processingTimeMs: processingTime
+            }, 'change processed successfully');
+        }
+        catch (error) {
+            // failure - retry logic
+            change.lastError = error;
+            change.retries++;
+            logger.error({
+                error,
+                path: change.event.path,
+                retries: change.retries,
+                maxRetries: this.config.maxRetries
+            }, 'failed to process change');
+            if (change.retries < this.config.maxRetries) {
+                // retry with exponential backoff
+                const delay = this.config.retryDelayMs * Math.pow(this.config.retryBackoffMultiplier, change.retries - 1);
+                logger.info({
+                    path: change.event.path,
+                    retries: change.retries,
+                    delayMs: delay
+                }, 'retrying change after delay');
+                // LOW-10 FIX: Track retry timeout for cleanup on stop
+                const retryTimeout = setTimeout(() => {
+                    this.retryTimeouts.delete(retryTimeout);
+                    // increase priority for retries
+                    this.enqueue(change.event, change.priority + 1);
+                }, delay);
+                this.retryTimeouts.add(retryTimeout);
+                this.stats.retriedCount++;
+            }
+            else {
+                // max retries exceeded - give up
+                logger.error({
+                    path: change.event.path,
+                    retries: change.retries
+                }, 'max retries exceeded - dropping change');
+                this.stats.failedCount++;
+                // remove from dedup map
+                if (this.config.enableDeduplication) {
+                    this.dedupMap.delete(change.event.path);
+                }
+            }
+        }
+    }
+    /**
+     * sortQueue - sorts queue by priority (highest first)
+     */
+    sortQueue() {
+        this.queue.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * getStats - returns queue statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * clear - clears the queue
+     */
+    clear() {
+        logger.info({ queueSize: this.queue.length }, 'clearing queue');
+        this.queue = [];
+        this.dedupMap.clear();
+        this.stats.currentQueueSize = 0;
+    }
+    /**
+     * flush - processes all pending changes immediately
+     *
+     * yooo flushing the whole queue rn
+     */
+    async flush() {
+        logger.info({ queueSize: this.queue.length }, 'flushing queue');
+        while (this.queue.length > 0) {
+            await this.processBatch();
+        }
+        logger.info('queue flushed');
+    }
+    /**
+     * getPendingCount - returns number of pending changes
+     */
+    getPendingCount() {
+        return this.queue.length;
+    }
+    /**
+     * hasPendingChanges - checks if there are pending changes
+     */
+    hasPendingChanges() {
+        return this.queue.length > 0;
+    }
+    /**
+     * getPendingPaths - returns paths of all pending changes
+     */
+    getPendingPaths() {
+        return this.queue.map(change => change.event.path);
+    }
+    /**
+     * getQueueHealth - returns queue health metrics
+     */
+    getQueueHealth() {
+        const issues = [];
+        const totalProcessed = this.stats.processedCount + this.stats.failedCount;
+        const failureRate = totalProcessed > 0
+            ? this.stats.failedCount / totalProcessed
+            : 0;
+        const queueUtilization = this.queue.length / this.config.maxQueueSize;
+        // check for issues
+        if (queueUtilization > 0.8) {
+            issues.push('Queue is >80% full');
+        }
+        if (failureRate > 0.1) {
+            issues.push(`High failure rate: ${(failureRate * 100).toFixed(1)}%`);
+        }
+        if (this.stats.averageProcessingTimeMs > 5000) {
+            issues.push(`Slow processing: ${this.stats.averageProcessingTimeMs}ms avg`);
+        }
+        const healthy = issues.length === 0;
+        return {
+            healthy,
+            queueUtilization,
+            failureRate,
+            averageProcessingTimeMs: this.stats.averageProcessingTimeMs,
+            issues
+        };
+    }
+    /**
+     * resetStats - resets statistics
+     */
+    resetStats() {
+        this.stats = {
+            queuedCount: 0,
+            processedCount: 0,
+            failedCount: 0,
+            retriedCount: 0,
+            deduplicatedCount: 0,
+            averageProcessingTimeMs: 0,
+            currentQueueSize: this.queue.length,
+            isProcessing: this.processing
+        };
+        this.processingTimes = [];
+    }
+}
+//# sourceMappingURL=changeQueue.js.map

package/dist/watcher/changeQueue.js.map

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

package/dist/watcher/fileWatcher.d.ts

@@ -0,0 +1,121 @@
+/**
+ * fileWatcher.ts - File System Watcher for Auto-Updating MCP Memories
+ *
+ * yooo watching for file changes lets goooo
+ * monitors the entire codebase and auto-updates MCP when files change
+ *
+ * Features:
+ * - Uses chokidar for reliable cross-platform watching
+ * - Respects .specmemignore exclusions
+ * - Debounces rapid changes (like during compilation)
+ * - Auto-restarts on crashes (because watcher crashes are NOT it)
+ * - Handles mass operations (git checkout, build, etc.)
+ */
+export interface WatcherConfig {
+    rootPath: string;
+    additionalPaths?: string[];
+    ignorePath?: string;
+    debounceMs?: number;
+    autoRestart?: boolean;
+    maxRestarts?: number;
+    verbose?: boolean;
+}
+export interface FileChangeEvent {
+    type: 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir';
+    path: string;
+    relativePath: string;
+    timestamp: Date;
+    stats?: {
+        size: number;
+        mtime: Date;
+    };
+}
+export type FileChangeHandler = (event: FileChangeEvent) => Promise<void>;
+/**
+ * watchForChangesNoCap - main file watcher class
+ *
+ * fr fr this is the GOAT of file watchers
+ * handles everything from rapid changes to mass git operations
+ */
+export declare class WatchForChangesNoCap {
+    private config;
+    private watcher;
+    private isWatching;
+    private restartCount;
+    private ignorePatterns;
+    private changeHandler;
+    private debouncedHandlers;
+    private pendingEventData;
+    private stats;
+    constructor(config: WatcherConfig);
+    /**
+     * startWatching - fires up the file watcher
+     *
+     * yooo lets get this watcher rolling
+     */
+    startWatching(handler: FileChangeHandler): Promise<void>;
+    /**
+     * stopWatching - gracefully shuts down the watcher
+     */
+    stopWatching(): Promise<void>;
+    /**
+     * setupEventHandlers - wires up all the chokidar events
+     *
+     * nah bruh handling ALL the file events
+     */
+    private setupEventHandlers;
+    /**
+     * handleEvent - processes a single file change event
+     *
+     * fr fr auto-updating this file rn
+     */
+    private handleEvent;
+    /**
+     * skipTheBoringShit - checks if file should be ignored
+     *
+     * nah bruh excluded file getting skipped
+     */
+    private skipTheBoringShit;
+    /**
+     * matchPattern - simple glob-style pattern matching
+     */
+    private matchPattern;
+    /**
+     * loadIgnorePatterns - loads patterns from .specmemignore
+     */
+    private loadIgnorePatterns;
+    /**
+     * restartWatcher - attempts to restart after crash
+     *
+     * skids editing files while were processing lmao
+     */
+    private restartWatcher;
+    /**
+     * getStats - returns watcher statistics
+     */
+    getStats(): typeof this.stats & {
+        isWatching: boolean;
+        rootPath: string;
+        additionalPaths: string[];
+    };
+    /**
+     * scanExistingFiles - queues all existing watched files for indexing
+     *
+     * ignoreInitial:true means existing files dont fire events on startup
+     * call this after watcher starts to index everything thats already there
+     */
+    scanExistingFiles(): Promise<{
+        scanned: number;
+        skipped: number;
+        errors: number;
+    }>;
+    /**
+     * isActive - checks if watcher is currently running
+     */
+    isActive(): boolean;
+    /**
+     * reloadIgnorePatterns - reloads .specmemignore without restart
+     */
+    reloadIgnorePatterns(): Promise<void>;
+}
+//# sourceMappingURL=fileWatcher.d.ts.map

package/dist/watcher/fileWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWatcher.d.ts","sourceRoot":"","sources":["../../src/watcher/fileWatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,MAAM,WAAW,aAAa;IAE5B,QAAQ,EAAE,MAAM,CAAC;IAGjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,IAAI,CAAC;KACb,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,aAAa,CAAkC;IAEvD,OAAO,CAAC,iBAAiB,CAA6D;IAEtF,OAAO,CAAC,gBAAgB,CAAsC;IAG9D,OAAO,CAAC,KAAK,CAOX;gBAEU,MAAM,EAAE,aAAa;IAYjC;;;;OAIG;IACG,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsJ9D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BnC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAmD1B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAyEnB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;YACW,kBAAkB;IA+BhC;;;;OAIG;YACW,cAAc;IA6B5B;;OAEG;IACH,QAAQ,IAAI,OAAO,IAAI,CAAC,KAAK,GAAG;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;IASpG;;;;;OAKG;IACG,iBAAiB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAwDxF;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5C"}