@milo4jo/contextkit 0.3.0 → 0.5.1

package/dist/parsers/index.js

@@ -0,0 +1,71 @@
+/**
+ * Parser Registry
+ *
+ * Central registry for language-specific parsers.
+ * Determines which parser to use based on file extension.
+ */
+import { parseTypeScript, isTypeScriptOrJavaScript, } from './typescript.js';
+/** Registered parsers mapped by extension */
+const parsers = new Map();
+// Register TypeScript/JavaScript parser for all supported extensions
+const tsExtensions = ['ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs', 'mts', 'cts'];
+for (const ext of tsExtensions) {
+    parsers.set(ext, parseTypeScript);
+}
+/**
+ * Get the parser for a file based on its extension.
+ *
+ * @param filePath - Path to the file
+ * @returns Parser function or undefined if no parser is available
+ */
+export function getParser(filePath) {
+    const ext = filePath.toLowerCase().split('.').pop();
+    if (!ext)
+        return undefined;
+    return parsers.get(ext);
+}
+/**
+ * Check if a file can be parsed by any registered parser.
+ *
+ * @param filePath - Path to the file
+ * @returns True if a parser is available for this file type
+ */
+export function canParse(filePath) {
+    return getParser(filePath) !== undefined;
+}
+/**
+ * Parse a file and extract code boundaries.
+ *
+ * @param content - File content
+ * @param filePath - Path to the file (used to determine parser)
+ * @returns Parse result with boundaries, or failure result if no parser available
+ */
+export function parseFile(content, filePath) {
+    const parser = getParser(filePath);
+    if (!parser) {
+        return {
+            success: false,
+            boundaries: [],
+            error: `No parser available for file type: ${filePath}`,
+        };
+    }
+    return parser(content, filePath);
+}
+/**
+ * Register a custom parser for a file extension.
+ *
+ * @param extension - File extension (without dot)
+ * @param parser - Parser function
+ */
+export function registerParser(extension, parser) {
+    parsers.set(extension.toLowerCase(), parser);
+}
+/**
+ * Get list of supported file extensions.
+ */
+export function getSupportedExtensions() {
+    return Array.from(parsers.keys());
+}
+// Re-export utility functions
+export { isTypeScriptOrJavaScript };
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,wBAAwB,GAIzB,MAAM,iBAAiB,CAAC;AAOzB,6CAA6C;AAC7C,MAAM,OAAO,GAA0B,IAAI,GAAG,EAAE,CAAC;AAEjD,qEAAqE;AACrE,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC5E,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,QAAgB;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,EAAE;YACd,KAAK,EAAE,sCAAsC,QAAQ,EAAE;SACxD,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,MAAgB;IAChE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,8BAA8B;AAC9B,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/parsers/typescript.d.ts

@@ -0,0 +1,43 @@
+/**
+ * TypeScript/JavaScript AST Parser
+ *
+ * Parses TS/JS files to identify code boundaries for intelligent chunking.
+ * Uses acorn for parsing JavaScript (ignores TypeScript-specific syntax).
+ */
+/** Type of code unit identified by the parser */
+export type CodeUnitType = 'function' | 'class' | 'method' | 'constant' | 'block';
+/** A code boundary identified by the parser */
+export interface CodeBoundary {
+    /** Type of code unit */
+    type: CodeUnitType;
+    /** Name of the unit (function name, class name, etc.) */
+    name: string;
+    /** Start line (1-indexed) */
+    startLine: number;
+    /** End line (1-indexed, inclusive) */
+    endLine: number;
+    /** Whether this is exported */
+    exported: boolean;
+}
+/** Result of parsing a file */
+export interface ParseResult {
+    /** Whether parsing succeeded */
+    success: boolean;
+    /** Identified code boundaries */
+    boundaries: CodeBoundary[];
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Parse TypeScript/JavaScript code and extract code boundaries.
+ *
+ * @param content - The file content to parse
+ * @param _filePath - Path to the file (for error messages, unused currently)
+ * @returns Parse result with boundaries or error
+ */
+export declare function parseTypeScript(content: string, _filePath?: string): ParseResult;
+/**
+ * Check if a file extension is supported by this parser.
+ */
+export declare function isTypeScriptOrJavaScript(filePath: string): boolean;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/parsers/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/parsers/typescript.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAElF,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0HD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAsPhF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGlE"}

package/dist/parsers/typescript.js

@@ -0,0 +1,306 @@
+/**
+ * TypeScript/JavaScript AST Parser
+ *
+ * Parses TS/JS files to identify code boundaries for intelligent chunking.
+ * Uses acorn for parsing JavaScript (ignores TypeScript-specific syntax).
+ */
+import * as acorn from 'acorn';
+/**
+ * Strip TypeScript-specific syntax to make the code parseable by acorn.
+ * This is a simple preprocessing step that handles common TS patterns.
+ */
+function stripTypeScript(code) {
+    // Remove type annotations: `: Type`, `: Type[]`, `: Type<Generic>`
+    // This regex handles common cases but isn't perfect for all TS syntax
+    let stripped = code;
+    // Remove type imports: import type { ... } from '...'
+    stripped = stripped.replace(/import\s+type\s+\{[^}]*\}\s+from\s+['"][^'"]*['"];?/g, '');
+    stripped = stripped.replace(/import\s+type\s+\w+\s+from\s+['"][^'"]*['"];?/g, '');
+    // Remove "type" keyword in imports: import { type Foo, Bar } from '...'
+    stripped = stripped.replace(/,\s*type\s+\w+/g, '');
+    stripped = stripped.replace(/\{\s*type\s+\w+\s*,/g, '{');
+    stripped = stripped.replace(/\{\s*type\s+\w+\s*\}/g, '{}');
+    // Remove interface declarations
+    stripped = stripped.replace(/interface\s+\w+(?:<[^>]*>)?\s*(?:extends[^{]*)?\{[^}]*\}/gs, '');
+    // Remove type aliases
+    stripped = stripped.replace(/type\s+\w+(?:<[^>]*>)?\s*=\s*[^;]+;/g, '');
+    // Remove type assertions: as Type, as const
+    stripped = stripped.replace(/\s+as\s+(?:const|\w+(?:<[^>]*>)?)/g, '');
+    // Remove generic type parameters from functions/classes: <T, U>
+    stripped = stripped.replace(/<[^<>()]*(?:<[^<>]*>[^<>()]*)*>\s*(?=\()/g, '');
+    // Remove type annotations from parameters: (x: Type) => (x)
+    // This is tricky - we need to be careful not to break the code
+    stripped = stripped.replace(/:\s*\w+(?:<[^>]*>)?(?:\[\])?(?:\s*\|\s*\w+(?:<[^>]*>)?(?:\[\])?)*(?=\s*[,)=])/g, '');
+    // Remove return type annotations: ): Type {
+    stripped = stripped.replace(/\):\s*\w+(?:<[^>]*>)?(?:\[\])?(?:\s*\|\s*\w+(?:<[^>]*>)?(?:\[\])?)*\s*(?=\{|=>)/g, ') ');
+    // Remove non-null assertions: foo!.bar -> foo.bar
+    stripped = stripped.replace(/!(?=\.|\[)/g, '');
+    // Remove declare keyword
+    stripped = stripped.replace(/declare\s+/g, '');
+    // Remove readonly keyword
+    stripped = stripped.replace(/readonly\s+/g, '');
+    // Remove abstract keyword
+    stripped = stripped.replace(/abstract\s+/g, '');
+    // Remove public/private/protected modifiers
+    stripped = stripped.replace(/(?:public|private|protected)\s+/g, '');
+    // Remove implements clause
+    stripped = stripped.replace(/implements\s+[\w,\s<>]+(?=\s*\{)/g, '');
+    return stripped;
+}
+/**
+ * Parse TypeScript/JavaScript code and extract code boundaries.
+ *
+ * @param content - The file content to parse
+ * @param _filePath - Path to the file (for error messages, unused currently)
+ * @returns Parse result with boundaries or error
+ */
+export function parseTypeScript(content, _filePath) {
+    const boundaries = [];
+    // Try to parse as JavaScript first, then try stripping TypeScript syntax
+    let ast;
+    try {
+        ast = acorn.parse(content, {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            locations: true,
+            allowHashBang: true,
+            allowAwaitOutsideFunction: true,
+            allowImportExportEverywhere: true,
+        });
+    }
+    catch {
+        // Try stripping TypeScript syntax and parse again
+        try {
+            const stripped = stripTypeScript(content);
+            ast = acorn.parse(stripped, {
+                ecmaVersion: 'latest',
+                sourceType: 'module',
+                locations: true,
+                allowHashBang: true,
+                allowAwaitOutsideFunction: true,
+                allowImportExportEverywhere: true,
+            });
+        }
+        catch (e) {
+            return {
+                success: false,
+                boundaries: [],
+                error: e instanceof Error ? e.message : 'Parse error',
+            };
+        }
+    }
+    // Track what's been exported
+    const exportedNames = new Set();
+    // First pass: collect exports
+    for (const node of ast.body) {
+        if (node.type === 'ExportNamedDeclaration') {
+            const exportNode = node;
+            if (exportNode.declaration) {
+                const decl = exportNode.declaration;
+                if (decl.type === 'FunctionDeclaration') {
+                    const fn = decl;
+                    if (fn.id?.name)
+                        exportedNames.add(fn.id.name);
+                }
+                else if (decl.type === 'ClassDeclaration') {
+                    const cls = decl;
+                    if (cls.id?.name)
+                        exportedNames.add(cls.id.name);
+                }
+                else if (decl.type === 'VariableDeclaration') {
+                    const varDecl = decl;
+                    for (const declarator of varDecl.declarations) {
+                        if (declarator.id.type === 'Identifier') {
+                            exportedNames.add(declarator.id.name);
+                        }
+                    }
+                }
+            }
+        }
+        else if (node.type === 'ExportDefaultDeclaration') {
+            exportedNames.add('default');
+        }
+    }
+    // Second pass: extract boundaries
+    for (const node of ast.body) {
+        if (!node.loc)
+            continue;
+        const startLine = node.loc.start.line;
+        const endLine = node.loc.end.line;
+        if (node.type === 'FunctionDeclaration') {
+            const fn = node;
+            const name = fn.id?.name || 'anonymous';
+            boundaries.push({
+                type: 'function',
+                name,
+                startLine,
+                endLine,
+                exported: exportedNames.has(name),
+            });
+        }
+        else if (node.type === 'ClassDeclaration') {
+            const cls = node;
+            const className = cls.id?.name || 'AnonymousClass';
+            // Add the class itself
+            boundaries.push({
+                type: 'class',
+                name: className,
+                startLine,
+                endLine,
+                exported: exportedNames.has(className),
+            });
+            // Also add methods as separate boundaries (for large classes)
+            if (cls.body?.body) {
+                for (const member of cls.body.body) {
+                    if (member.type === 'MethodDefinition' && member.loc) {
+                        const method = member;
+                        let methodName = 'anonymous';
+                        if (method.key.type === 'Identifier') {
+                            methodName = method.key.name;
+                        }
+                        boundaries.push({
+                            type: 'method',
+                            name: `${className}.${methodName}`,
+                            startLine: member.loc.start.line,
+                            endLine: member.loc.end.line,
+                            exported: false,
+                        });
+                    }
+                }
+            }
+        }
+        else if (node.type === 'VariableDeclaration') {
+            const varDecl = node;
+            // Only track const declarations (likely to be important exports/configs)
+            if (varDecl.kind === 'const') {
+                for (const declarator of varDecl.declarations) {
+                    if (declarator.id.type === 'Identifier') {
+                        const name = declarator.id.name;
+                        // Check if it's an arrow function or function expression
+                        const init = declarator.init;
+                        const isFunction = init?.type === 'ArrowFunctionExpression' ||
+                            init?.type === 'FunctionExpression';
+                        boundaries.push({
+                            type: isFunction ? 'function' : 'constant',
+                            name,
+                            startLine,
+                            endLine,
+                            exported: exportedNames.has(name),
+                        });
+                    }
+                }
+            }
+        }
+        else if (node.type === 'ExportNamedDeclaration') {
+            const exportNode = node;
+            if (exportNode.declaration) {
+                // The declaration inside the export has already been processed above
+                // due to our pre-pass. Mark the boundaries as exported.
+                const decl = exportNode.declaration;
+                if (decl.type === 'FunctionDeclaration') {
+                    const fn = decl;
+                    const name = fn.id?.name || 'anonymous';
+                    boundaries.push({
+                        type: 'function',
+                        name,
+                        startLine,
+                        endLine,
+                        exported: true,
+                    });
+                }
+                else if (decl.type === 'ClassDeclaration') {
+                    const cls = decl;
+                    const className = cls.id?.name || 'AnonymousClass';
+                    boundaries.push({
+                        type: 'class',
+                        name: className,
+                        startLine,
+                        endLine,
+                        exported: true,
+                    });
+                    // Add methods
+                    if (cls.body?.body) {
+                        for (const member of cls.body.body) {
+                            if (member.type === 'MethodDefinition' && member.loc) {
+                                const method = member;
+                                let methodName = 'anonymous';
+                                if (method.key.type === 'Identifier') {
+                                    methodName = method.key.name;
+                                }
+                                boundaries.push({
+                                    type: 'method',
+                                    name: `${className}.${methodName}`,
+                                    startLine: member.loc.start.line,
+                                    endLine: member.loc.end.line,
+                                    exported: false,
+                                });
+                            }
+                        }
+                    }
+                }
+                else if (decl.type === 'VariableDeclaration') {
+                    const varDecl = decl;
+                    if (varDecl.kind === 'const') {
+                        for (const declarator of varDecl.declarations) {
+                            if (declarator.id.type === 'Identifier') {
+                                const name = declarator.id.name;
+                                const init = declarator.init;
+                                const isFunction = init?.type === 'ArrowFunctionExpression' ||
+                                    init?.type === 'FunctionExpression';
+                                boundaries.push({
+                                    type: isFunction ? 'function' : 'constant',
+                                    name,
+                                    startLine,
+                                    endLine,
+                                    exported: true,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        else if (node.type === 'ExportDefaultDeclaration') {
+            const exportDefault = node;
+            const decl = exportDefault.declaration;
+            let type = 'block';
+            let name = 'default';
+            if (decl.type === 'FunctionDeclaration' || decl.type === 'FunctionExpression') {
+                type = 'function';
+                if (decl.id?.name) {
+                    name = decl.id.name;
+                }
+            }
+            else if (decl.type === 'ClassDeclaration') {
+                type = 'class';
+                if (decl.id?.name) {
+                    name = decl.id.name;
+                }
+            }
+            else if (decl.type === 'ArrowFunctionExpression') {
+                type = 'function';
+            }
+            boundaries.push({
+                type,
+                name,
+                startLine,
+                endLine,
+                exported: true,
+            });
+        }
+    }
+    // Sort boundaries by start line
+    boundaries.sort((a, b) => a.startLine - b.startLine);
+    return {
+        success: true,
+        boundaries,
+    };
+}
+/**
+ * Check if a file extension is supported by this parser.
+ */
+export function isTypeScriptOrJavaScript(filePath) {
+    const ext = filePath.toLowerCase().split('.').pop();
+    return ['ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs', 'mts', 'cts'].includes(ext || '');
+}
+//# sourceMappingURL=typescript.js.map

package/dist/parsers/typescript.js.map

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

package/dist/retrieval/imports.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Import Parser Module
+ *
+ * Parses TypeScript/JavaScript import statements to find related files.
+ * Uses regex patterns instead of AST parsing for simplicity and speed.
+ */
+/** Parsed import statement */
+export interface ParsedImport {
+    /** Original import specifier (e.g., './utils', 'lodash') */
+    specifier: string;
+    /** Type of import */
+    type: 'relative' | 'absolute' | 'package';
+    /** Line number where import appears (1-indexed) */
+    line: number;
+    /** Named imports (e.g., ['foo', 'bar'] from `import { foo, bar } from ...`) */
+    namedImports?: string[];
+    /** Default import name */
+    defaultImport?: string;
+    /** Whether it's a type-only import */
+    isTypeOnly: boolean;
+}
+/** Result of import parsing */
+export interface ImportParseResult {
+    /** All parsed imports */
+    imports: ParsedImport[];
+    /** Resolved relative paths to related files */
+    relatedFiles: string[];
+}
+/**
+ * Supported import patterns:
+ * - import { foo, bar } from './module'
+ * - import * as name from './module'
+ * - import name from './module'
+ * - import './module'
+ * - import type { Foo } from './module'
+ * - export { foo } from './module'
+ * - export * from './module'
+ * - const x = require('./module')
+ * - const x = await import('./module')
+ */
+/**
+ * Parse imports from source code
+ */
+export declare function parseImports(content: string): ParsedImport[];
+/**
+ * Classify import type based on specifier
+ */
+export declare function classifyImportType(specifier: string): 'relative' | 'absolute' | 'package';
+/**
+ * Resolve a relative import specifier to an actual file path
+ */
+export declare function resolveImport(specifier: string, fromFile: string, basePath: string): string | null;
+/**
+ * Parse imports and resolve related files
+ */
+export declare function parseImportsWithResolution(content: string, filePath: string, basePath: string): ImportParseResult;
+/**
+ * Extract all import specifiers from content (quick extraction without full parsing)
+ */
+export declare function extractImportSpecifiers(content: string): string[];
+/**
+ * Check if a file is TypeScript/JavaScript
+ */
+export declare function isJsTsFile(filePath: string): boolean;
+/**
+ * Build a simple dependency graph for files
+ */
+export declare function buildDependencyGraph(files: Array<{
+    path: string;
+    content: string;
+}>, basePath: string): Map<string, string[]>;
+/**
+ * Find files that import a given file (reverse dependencies)
+ */
+export declare function findImporters(targetFile: string, dependencyGraph: Map<string, string[]>): string[];
+//# sourceMappingURL=imports.d.ts.map

package/dist/retrieval/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/retrieval/imports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAiB5D;AA8HD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAQzF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CA+Bf;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAcnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAejE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAcvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,MAAM,EAAE,CAUV"}