ai-prompt-guide-mcp 1.0.0

package/dist/fingerprint-index.test.js

@@ -0,0 +1,482 @@
+/**
+ * Comprehensive unit tests for FingerprintIndex
+ *
+ * Test coverage:
+ * - Index initialization and building
+ * - Keyword extraction from document previews
+ * - Candidate filtering with various queries
+ * - Document invalidation and reindexing
+ * - File watcher integration
+ * - Performance benchmarks
+ * - Edge cases and error handling
+ * - Memory usage validation
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { FingerprintIndex } from './fingerprint-index.js';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { watch } from 'chokidar';
+describe('FingerprintIndex', () => {
+    let tempDir;
+    let index;
+    let watcher;
+    beforeEach(async () => {
+        // Create temporary directory for test documents
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fingerprint-index-test-'));
+        index = new FingerprintIndex(tempDir);
+    });
+    afterEach(async () => {
+        // Clean up
+        if (watcher != null) {
+            await watcher.close();
+            watcher = undefined;
+        }
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    /**
+     * Helper: Create test document
+     */
+    async function createTestDoc(relativePath, content) {
+        const fullPath = path.join(tempDir, relativePath);
+        const dir = path.dirname(fullPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(fullPath, content, 'utf8');
+        return fullPath;
+    }
+    describe('Initialization', () => {
+        it('should initialize empty index successfully', async () => {
+            await index.initialize();
+            expect(index.isInitialized()).toBe(true);
+            const stats = index.getStats();
+            expect(stats.documents).toBe(0);
+            expect(stats.keywords).toBe(0);
+        });
+        it('should build index from existing documents', async () => {
+            // Create test documents
+            await createTestDoc('doc1.md', '# Authentication\n\nThis document covers authentication methods.');
+            await createTestDoc('doc2.md', '# Authorization\n\nThis document covers authorization policies.');
+            await createTestDoc('api/doc3.md', '# API Reference\n\nAPI documentation for developers.');
+            await index.initialize();
+            expect(index.isInitialized()).toBe(true);
+            const stats = index.getStats();
+            expect(stats.documents).toBe(3);
+            expect(stats.keywords).toBeGreaterThan(0);
+            expect(stats.avgKeywordsPerDoc).toBeGreaterThan(0);
+        });
+        it('should skip non-markdown files', async () => {
+            await createTestDoc('readme.txt', 'Not markdown');
+            await createTestDoc('doc.md', '# Markdown');
+            await fs.writeFile(path.join(tempDir, 'image.png'), Buffer.from(''));
+            await index.initialize();
+            const stats = index.getStats();
+            expect(stats.documents).toBe(1); // Only markdown file
+        });
+        it('should skip hidden directories', async () => {
+            await createTestDoc('.git/doc.md', '# Hidden');
+            await createTestDoc('visible/doc.md', '# Visible');
+            await index.initialize();
+            const stats = index.getStats();
+            expect(stats.documents).toBe(1); // Only visible directory
+        });
+        it('should warn on re-initialization', async () => {
+            await index.initialize();
+            const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            await index.initialize();
+            expect(index.isInitialized()).toBe(true);
+            consoleSpy.mockRestore();
+        });
+        it('should handle documents without headings', async () => {
+            await createTestDoc('no-heading.md', 'Just plain text content');
+            await index.initialize();
+            const stats = index.getStats();
+            expect(stats.documents).toBe(1);
+            const fingerprint = index.getFingerprint('/no-heading.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords.length).toBeGreaterThan(0);
+        });
+        it('should handle empty documents', async () => {
+            await createTestDoc('empty.md', '');
+            await index.initialize();
+            const stats = index.getStats();
+            expect(stats.documents).toBe(1);
+            const fingerprint = index.getFingerprint('/empty.md');
+            expect(fingerprint).toBeDefined();
+            // Empty document gets filename as title which may produce keywords
+            expect(fingerprint?.keywords.length).toBeGreaterThanOrEqual(0);
+        });
+    });
+    describe('Keyword Extraction', () => {
+        it('should extract keywords from title and content', async () => {
+            await createTestDoc('auth.md', `# Authentication Guide\n\nThis guide covers OAuth2 and JWT tokens for secure authentication.`);
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/auth.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords).toContain('authentication');
+            expect(fingerprint?.keywords).toContain('guide');
+            expect(fingerprint?.keywords).toContain('oauth2');
+            expect(fingerprint?.keywords).toContain('jwt');
+            expect(fingerprint?.keywords).toContain('tokens');
+        });
+        it('should filter stop words', async () => {
+            await createTestDoc('doc.md', '# The Guide\n\nThis is the documentation for the API.');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/doc.md');
+            expect(fingerprint).toBeDefined();
+            // Stop words should not be included
+            expect(fingerprint?.keywords).not.toContain('the');
+            expect(fingerprint?.keywords).not.toContain('is');
+            expect(fingerprint?.keywords).not.toContain('for');
+            // Meaningful words should be included
+            expect(fingerprint?.keywords).toContain('guide');
+            expect(fingerprint?.keywords).toContain('documentation');
+            expect(fingerprint?.keywords).toContain('api');
+        });
+        it('should limit keywords to 20 per document', async () => {
+            const longContent = `# Test\n\n${Array.from({ length: 100 }, (_, i) => `keyword${i}`).join(' ')}`;
+            await createTestDoc('long.md', longContent);
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/long.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords.length).toBeLessThanOrEqual(20);
+        });
+        it('should normalize keywords to lowercase', async () => {
+            await createTestDoc('mixed.md', '# UPPERCASE lowercase MixedCase');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/mixed.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords).toContain('uppercase');
+            expect(fingerprint?.keywords).toContain('lowercase');
+            expect(fingerprint?.keywords).toContain('mixedcase');
+        });
+        it('should filter out pure numbers and symbols', async () => {
+            await createTestDoc('symbols.md', '# Guide 123 !@# $%^ meaningful-word');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/symbols.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords).toContain('guide');
+            expect(fingerprint?.keywords).toContain('meaningful-word');
+            expect(fingerprint?.keywords).not.toContain('123');
+        });
+        it('should handle Unicode content', async () => {
+            await createTestDoc('unicode.md', '# Guide\n\nCafé naïve résumé');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/unicode.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords.length).toBeGreaterThan(0);
+        });
+    });
+    describe('Candidate Filtering', () => {
+        beforeEach(async () => {
+            // Create diverse test documents
+            await createTestDoc('auth.md', '# Authentication\n\nOAuth2 JWT tokens security');
+            await createTestDoc('api.md', '# API Reference\n\nREST endpoints documentation');
+            await createTestDoc('db.md', '# Database\n\nPostgreSQL schema migrations');
+            await createTestDoc('testing.md', '# Testing Guide\n\nUnit tests integration tests');
+            await index.initialize();
+        });
+        it('should find candidates matching single keyword', () => {
+            const candidates = index.findCandidates('authentication');
+            expect(candidates).toContain('/auth.md');
+            expect(candidates.length).toBeGreaterThanOrEqual(1);
+        });
+        it('should find candidates matching multiple keywords (union)', () => {
+            const candidates = index.findCandidates('authentication database');
+            expect(candidates).toContain('/auth.md');
+            expect(candidates).toContain('/db.md');
+            expect(candidates.length).toBeGreaterThanOrEqual(2);
+        });
+        it('should return empty array when no keywords match', () => {
+            const candidates = index.findCandidates('nonexistent keyword xyz');
+            expect(candidates).toEqual([]);
+        });
+        it('should return all documents when query has only stop words', () => {
+            const candidates = index.findCandidates('the and for with');
+            expect(candidates.length).toBe(4); // All documents
+        });
+        it('should return all documents when query is empty', () => {
+            const candidates = index.findCandidates('');
+            expect(candidates.length).toBe(4); // All documents
+        });
+        it('should filter by partial keyword match', () => {
+            const candidates = index.findCandidates('oauth2');
+            expect(candidates).toContain('/auth.md');
+        });
+        it('should be case-insensitive', () => {
+            const candidates1 = index.findCandidates('AUTHENTICATION');
+            const candidates2 = index.findCandidates('authentication');
+            const candidates3 = index.findCandidates('AuThEnTiCaTiOn');
+            expect(candidates1).toEqual(candidates2);
+            expect(candidates2).toEqual(candidates3);
+        });
+        it('should handle queries with extra whitespace', () => {
+            const candidates = index.findCandidates('  authentication   database  ');
+            expect(candidates).toContain('/auth.md');
+            expect(candidates).toContain('/db.md');
+        });
+        it('should warn and return all documents when not initialized', () => {
+            const uninitializedIndex = new FingerprintIndex(tempDir);
+            const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            const candidates = uninitializedIndex.findCandidates('test');
+            expect(candidates.length).toBe(0); // No documents indexed yet
+            consoleSpy.mockRestore();
+        });
+    });
+    describe('Document Invalidation', () => {
+        beforeEach(async () => {
+            await createTestDoc('doc1.md', '# Document 1\n\nKeyword alpha beta');
+            await createTestDoc('doc2.md', '# Document 2\n\nKeyword gamma delta');
+            await index.initialize();
+        });
+        it('should remove document from fingerprints', () => {
+            expect(index.getFingerprint('/doc1.md')).toBeDefined();
+            index.invalidateDocument('/doc1.md');
+            expect(index.getFingerprint('/doc1.md')).toBeUndefined();
+        });
+        it('should remove document from keyword index', () => {
+            const beforeCandidates = index.findCandidates('alpha');
+            expect(beforeCandidates).toContain('/doc1.md');
+            index.invalidateDocument('/doc1.md');
+            const afterCandidates = index.findCandidates('alpha');
+            expect(afterCandidates).not.toContain('/doc1.md');
+        });
+        it('should remove empty keyword entries', () => {
+            const statsBefore = index.getStats();
+            index.invalidateDocument('/doc1.md');
+            index.invalidateDocument('/doc2.md');
+            const statsAfter = index.getStats();
+            expect(statsAfter.keywords).toBeLessThan(statsBefore.keywords);
+        });
+        it('should handle invalidation of non-existent document', () => {
+            expect(() => {
+                index.invalidateDocument('/nonexistent.md');
+            }).not.toThrow();
+        });
+        it('should handle invalidation multiple times', () => {
+            index.invalidateDocument('/doc1.md');
+            expect(() => {
+                index.invalidateDocument('/doc1.md');
+            }).not.toThrow();
+        });
+    });
+    describe('File Watcher Integration', () => {
+        it('should reindex document on change event', async () => {
+            const docPath = await createTestDoc('watch.md', '# Original\n\nOriginal content keyword');
+            await index.initialize();
+            // Setup watcher
+            watcher = watch(tempDir, { ignoreInitial: true });
+            index.watchFiles(watcher);
+            // Wait for watcher to be ready
+            await new Promise(resolve => {
+                watcher?.on('ready', () => resolve());
+            });
+            // Change document
+            await fs.writeFile(docPath, '# Updated\n\nUpdated content newkeyword', 'utf8');
+            // Wait for change event to be processed
+            await new Promise(resolve => setTimeout(resolve, 500));
+            // Verify reindexing
+            const candidates = index.findCandidates('newkeyword');
+            expect(candidates).toContain('/watch.md');
+        });
+        it('should remove document on unlink event', async () => {
+            const docPath = await createTestDoc('unlink.md', '# To Delete\n\nDelete me');
+            await index.initialize();
+            expect(index.getFingerprint('/unlink.md')).toBeDefined();
+            // Setup watcher
+            watcher = watch(tempDir, { ignoreInitial: true });
+            index.watchFiles(watcher);
+            await new Promise(resolve => {
+                watcher?.on('ready', () => resolve());
+            });
+            // Delete document
+            await fs.unlink(docPath);
+            // Wait for unlink event
+            await new Promise(resolve => setTimeout(resolve, 500));
+            // Verify removal
+            expect(index.getFingerprint('/unlink.md')).toBeUndefined();
+        });
+        it('should add document on add event', async () => {
+            await index.initialize();
+            // Setup watcher
+            watcher = watch(tempDir, { ignoreInitial: true });
+            index.watchFiles(watcher);
+            await new Promise(resolve => {
+                watcher?.on('ready', () => resolve());
+            });
+            // Add new document
+            await createTestDoc('new.md', '# New Document\n\nFresh content');
+            // Wait for add event
+            await new Promise(resolve => setTimeout(resolve, 500));
+            // Verify addition
+            expect(index.getFingerprint('/new.md')).toBeDefined();
+        });
+        it('should ignore non-markdown files in watcher', async () => {
+            await index.initialize();
+            const statsBefore = index.getStats();
+            watcher = watch(tempDir, { ignoreInitial: true });
+            index.watchFiles(watcher);
+            await new Promise(resolve => {
+                watcher?.on('ready', () => resolve());
+            });
+            // Create non-markdown file
+            await fs.writeFile(path.join(tempDir, 'test.txt'), 'Text file');
+            await new Promise(resolve => setTimeout(resolve, 500));
+            const statsAfter = index.getStats();
+            expect(statsAfter.documents).toBe(statsBefore.documents);
+        });
+    });
+    describe('Statistics', () => {
+        it('should return accurate statistics', async () => {
+            await createTestDoc('doc1.md', '# Doc 1\n\nKeyword one two three');
+            await createTestDoc('doc2.md', '# Doc 2\n\nKeyword four five');
+            await index.initialize();
+            const stats = index.getStats();
+            expect(stats.documents).toBe(2);
+            expect(stats.keywords).toBeGreaterThan(0);
+            expect(stats.avgKeywordsPerDoc).toBeGreaterThan(0);
+            expect(stats.avgKeywordsPerDoc).toBeLessThanOrEqual(20);
+        });
+        it('should handle empty index statistics', () => {
+            const stats = index.getStats();
+            expect(stats.documents).toBe(0);
+            expect(stats.keywords).toBe(0);
+            expect(stats.avgKeywordsPerDoc).toBe(0);
+        });
+    });
+    describe('Clear', () => {
+        it('should clear all data', async () => {
+            await createTestDoc('doc.md', '# Document\n\nContent');
+            await index.initialize();
+            expect(index.isInitialized()).toBe(true);
+            expect(index.getStats().documents).toBeGreaterThan(0);
+            index.clear();
+            expect(index.isInitialized()).toBe(false);
+            expect(index.getStats().documents).toBe(0);
+            expect(index.getStats().keywords).toBe(0);
+        });
+        it('should allow re-initialization after clear', async () => {
+            await createTestDoc('doc.md', '# Document\n\nContent');
+            await index.initialize();
+            index.clear();
+            await index.initialize();
+            expect(index.isInitialized()).toBe(true);
+            expect(index.getStats().documents).toBeGreaterThan(0);
+        });
+    });
+    describe('Performance', () => {
+        it('should build index for 100 documents in under 200ms', async () => {
+            // Create 100 test documents
+            const promises = Array.from({ length: 100 }, (_, i) => createTestDoc(`perf/doc${i}.md`, `# Document ${i}\n\nContent for document ${i} with keywords test performance benchmark`));
+            await Promise.all(promises);
+            const startTime = performance.now();
+            await index.initialize();
+            const duration = performance.now() - startTime;
+            expect(duration).toBeLessThan(200);
+            expect(index.getStats().documents).toBe(100);
+        });
+        it('should find candidates in under 1ms', async () => {
+            // Create test documents
+            const promises = Array.from({ length: 50 }, (_, i) => createTestDoc(`search/doc${i}.md`, `# Document ${i}\n\nKeyword${i % 10} content`));
+            await Promise.all(promises);
+            await index.initialize();
+            const startTime = performance.now();
+            index.findCandidates('keyword5 keyword7');
+            const duration = performance.now() - startTime;
+            expect(duration).toBeLessThan(1);
+        });
+        it('should use reasonable memory per document', async () => {
+            // Create 100 documents
+            const promises = Array.from({ length: 100 }, (_, i) => createTestDoc(`mem/doc${i}.md`, `# Document ${i}\n\nContent for memory test`));
+            await Promise.all(promises);
+            await index.initialize();
+            const stats = index.getStats();
+            // Verify index was built successfully
+            expect(stats.documents).toBe(100);
+            expect(stats.keywords).toBeGreaterThan(0);
+            // Memory footprint validation:
+            // This test validates we're not loading full documents into memory.
+            // We read only 1500 bytes per doc and store lightweight fingerprints.
+            // The actual memory usage is difficult to measure precisely in JS due to:
+            // - V8's memory management and GC timing
+            // - String interning and deduplication
+            // - Map/Set overhead
+            // Rather than precise measurement, we verify the index is functional
+            // and contains expected data structures.
+            const fingerprint = index.getFingerprint('/mem/doc0.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.keywords.length).toBeLessThanOrEqual(20);
+        });
+    });
+    describe('Edge Cases', () => {
+        it('should handle very long documents (only reads first 1500 bytes)', async () => {
+            const longContent = `# Long Document\n\n${'a'.repeat(10000)}`;
+            await createTestDoc('long.md', longContent);
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/long.md');
+            expect(fingerprint).toBeDefined();
+        });
+        it('should handle documents with special characters in filename', async () => {
+            await createTestDoc('special-chars_123.md', '# Special\n\nContent');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/special-chars_123.md');
+            expect(fingerprint).toBeDefined();
+        });
+        it('should handle nested directory structures', async () => {
+            await createTestDoc('a/b/c/d/deep.md', '# Deep\n\nNested document');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/a/b/c/d/deep.md');
+            expect(fingerprint).toBeDefined();
+        });
+        it('should handle concurrent initialization (idempotent)', async () => {
+            await createTestDoc('doc.md', '# Document\n\nContent');
+            // Start multiple initializations concurrently
+            const results = await Promise.all([
+                index.initialize(),
+                index.initialize(),
+                index.initialize()
+            ]);
+            expect(index.isInitialized()).toBe(true);
+            expect(results).toHaveLength(3);
+        });
+        it('should handle file read errors gracefully', async () => {
+            await createTestDoc('good.md', '# Good\n\nContent');
+            await index.initialize();
+            // Index should still work for readable documents
+            expect(index.getStats().documents).toBeGreaterThan(0);
+        });
+    });
+    describe('Fingerprint Metadata', () => {
+        it('should include namespace in fingerprint', async () => {
+            await createTestDoc('api/auth/oauth.md', '# OAuth\n\nContent');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/api/auth/oauth.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.namespace).toBe('api/auth');
+        });
+        it('should include lastModified timestamp', async () => {
+            await createTestDoc('dated.md', '# Dated\n\nContent');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/dated.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.lastModified).toBeInstanceOf(Date);
+        });
+        it('should include contentHash', async () => {
+            await createTestDoc('hash.md', '# Hash\n\nContent');
+            await index.initialize();
+            const fingerprint = index.getFingerprint('/hash.md');
+            expect(fingerprint).toBeDefined();
+            expect(fingerprint?.contentHash).toBeTruthy();
+            expect(typeof fingerprint?.contentHash).toBe('string');
+            expect(fingerprint?.contentHash.length).toBe(16);
+        });
+        it('should have different hashes for different content', async () => {
+            await createTestDoc('doc1.md', '# Document 1\n\nContent A');
+            await createTestDoc('doc2.md', '# Document 2\n\nContent B');
+            await index.initialize();
+            const fp1 = index.getFingerprint('/doc1.md');
+            const fp2 = index.getFingerprint('/doc2.md');
+            expect(fp1?.contentHash).not.toBe(fp2?.contentHash);
+        });
+    });
+});
+//# sourceMappingURL=fingerprint-index.test.js.map

package/dist/fingerprint-index.test.js.map

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

package/dist/fsio.d.ts

@@ -0,0 +1,76 @@
+/**
+ * File I/O utilities with comprehensive security validation and mtime precondition checking
+ *
+ * Security Features:
+ * - Path traversal protection (prevents ../ and absolute paths outside docs root)
+ * - File size limits and validation
+ * - File name sanitization (removes dangerous characters)
+ * - File extension validation
+ * - Content length validation
+ * - Path length validation
+ * - Character encoding normalization
+ */
+import type { FileSnapshot } from './types/index.js';
+/**
+ * Reads a file and returns its content with modification time
+ *
+ * Security Features:
+ * - Path validation and sanitization
+ * - File size validation
+ * - Extension validation
+ * - Path traversal protection
+ *
+ * @param path - File path to read (will be validated and sanitized)
+ * @param options - Optional configuration for trusted internal callers
+ * @returns FileSnapshot with content and modification time
+ * @throws SpecDocsError for security violations or file system errors
+ */
+export declare function readFileSnapshot(path: string, options?: {
+    bypassValidation?: boolean;
+}): Promise<FileSnapshot>;
+/**
+ * Writes a file only if the modification time matches the expected value
+ * This prevents concurrent modification conflicts
+ *
+ * Security Features:
+ * - Path validation and sanitization
+ * - Content size validation
+ * - Extension validation
+ * - Path traversal protection
+ * - Atomic write operations
+ *
+ * @param path - File path to write (will be validated and sanitized)
+ * @param expectedMtimeMs - Expected modification time to prevent conflicts
+ * @param content - Content to write (will be validated for size)
+ * @param options - Optional configuration for trusted internal callers
+ * @throws SpecDocsError for security violations or file system errors
+ */
+export declare function writeFileIfUnchanged(path: string, expectedMtimeMs: number, content: string, options?: {
+    bypassValidation?: boolean;
+}): Promise<void>;
+/**
+ * Checks if a file exists and is readable
+ *
+ * Security Features:
+ * - Path validation and sanitization
+ * - Extension validation
+ * - Path traversal protection
+ *
+ * @param path - File path to check (will be validated and sanitized)
+ * @returns Promise<boolean> indicating if file exists and is readable
+ * @throws SpecDocsError for security violations
+ */
+export declare function fileExists(path: string): Promise<boolean>;
+/**
+ * Creates directory if it doesn't exist
+ *
+ * Security Features:
+ * - Path validation and sanitization
+ * - Path traversal protection
+ * - Parent directory validation
+ *
+ * @param dirPath - Directory path to create (will be validated and sanitized)
+ * @throws SpecDocsError for security violations or file system errors
+ */
+export declare function ensureDirectoryExists(dirPath: string): Promise<void>;
+//# sourceMappingURL=fsio.d.ts.map

package/dist/fsio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsio.d.ts","sourceRoot":"","sources":["../src/fsio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AAqUpE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAAC,YAAY,CAAC,CAWvB;AAgID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB/D;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0E1E"}