@eui/mcp 1.0.3

package/dist/mcp/server.js

@@ -0,0 +1,224 @@
+/**
+ * CompodocMcpServer - Main MCP server implementation
+ * Handles tool registration, request routing, and error handling
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ComponentQuery } from '../query/component-query.js';
+import { SearchEngine } from '../query/search-engine.js';
+import { ResultFormatter } from '../query/result-formatter.js';
+import { ListComponentsTool, GetComponentDocsTool, SearchComponentsTool, GetComponentInputsTool, GetComponentOutputsTool, GetComponentExamplesTool, } from '../tools/index.js';
+/**
+ * CompodocMcpServer class
+ * Manages the MCP server lifecycle and tool registration
+ */
+export class CompodocMcpServer {
+    server;
+    index;
+    query;
+    searchEngine;
+    formatter;
+    tools;
+    isRunning = false;
+    constructor(config, index) {
+        this.index = index;
+        this.query = new ComponentQuery(index);
+        this.searchEngine = new SearchEngine(index);
+        this.formatter = new ResultFormatter();
+        this.tools = new Map();
+        // Initialize MCP server
+        this.server = new Server({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Register tools
+        this.registerTools();
+        // Set up request handlers
+        this.setupHandlers();
+    }
+    /**
+     * Register all available tools
+     */
+    registerTools() {
+        // Create tool instances
+        const listComponentsTool = new ListComponentsTool(this.query, this.formatter);
+        const getComponentDocsTool = new GetComponentDocsTool(this.query, this.formatter);
+        const searchComponentsTool = new SearchComponentsTool(this.searchEngine, this.formatter);
+        const getComponentInputsTool = new GetComponentInputsTool(this.query, this.formatter);
+        const getComponentOutputsTool = new GetComponentOutputsTool(this.query, this.formatter);
+        const getComponentExamplesTool = new GetComponentExamplesTool(this.query, this.formatter);
+        // Store tool instances
+        this.tools.set('list-components', listComponentsTool);
+        this.tools.set('get-component-docs', getComponentDocsTool);
+        this.tools.set('search-components', searchComponentsTool);
+        this.tools.set('get-component-inputs', getComponentInputsTool);
+        this.tools.set('get-component-outputs', getComponentOutputsTool);
+        this.tools.set('get-component-examples', getComponentExamplesTool);
+    }
+    /**
+     * Set up MCP request handlers
+     */
+    setupHandlers() {
+        // Handle list tools request
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const toolDefinitions = [
+                ListComponentsTool.getToolDefinition(),
+                GetComponentDocsTool.getToolDefinition(),
+                SearchComponentsTool.getToolDefinition(),
+                GetComponentInputsTool.getToolDefinition(),
+                GetComponentOutputsTool.getToolDefinition(),
+                GetComponentExamplesTool.getToolDefinition(),
+            ];
+            return {
+                tools: toolDefinitions,
+            };
+        });
+        // Handle call tool request
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                // Validate tool exists
+                const tool = this.tools.get(name);
+                if (!tool) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'TOOL_NOT_FOUND',
+                                        message: `Tool '${name}' does not exist. Available tools: ${Array.from(this.tools.keys()).join(', ')}`,
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Validate parameters (basic check - tools will do detailed validation)
+                if (args === undefined || args === null) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_PARAMETERS',
+                                        message: 'Tool parameters are required',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Execute tool
+                const result = tool.execute(args);
+                // Format response
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                // Handle errors gracefully
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+                const errorCode = this.categorizeError(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: {
+                                    code: errorCode,
+                                    message: errorMessage,
+                                },
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Categorize errors for appropriate error codes
+     */
+    categorizeError(error) {
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            if (message.includes('not found') || message.includes('does not exist')) {
+                return 'NOT_FOUND';
+            }
+            if (message.includes('invalid') ||
+                message.includes('must be') ||
+                message.includes('required')) {
+                return 'INVALID_PARAMETERS';
+            }
+            if (message.includes('limit') || message.includes('offset')) {
+                return 'INVALID_PARAMETERS';
+            }
+        }
+        return 'INTERNAL_ERROR';
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        if (this.isRunning) {
+            throw new Error('Server is already running');
+        }
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        this.isRunning = true;
+    }
+    /**
+     * Stop the MCP server
+     */
+    async stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        await this.server.close();
+        this.isRunning = false;
+    }
+    /**
+     * Check if server is running
+     */
+    isHealthy() {
+        return this.isRunning;
+    }
+    /**
+     * Get server statistics
+     */
+    getStats() {
+        return {
+            isRunning: this.isRunning,
+            toolCount: this.tools.size,
+            indexStats: {
+                totalComponents: this.index.totalCount,
+                lastUpdated: this.index.lastUpdated,
+            },
+        };
+    }
+    /**
+     * Update the index (for hot reloading)
+     */
+    updateIndex(newIndex) {
+        this.index = newIndex;
+        this.query = new ComponentQuery(newIndex);
+        this.searchEngine = new SearchEngine(newIndex);
+        // Re-register tools with new index
+        this.registerTools();
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/publish/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Publishing module
+ *
+ * Provides utilities for npm package publishing, authentication validation,
+ * and error handling with credential sanitization.
+ */
+export { validateNpmToken, sanitizeErrorMessage, isAuthenticationError, isVersionConflictError, extractVersionFromError, createAuthenticationErrorMessage, createVersionConflictErrorMessage, createPublishErrorMessage, } from './publish-utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/publish/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publish/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/dist/publish/index.js

@@ -0,0 +1,8 @@
+/**
+ * Publishing module
+ *
+ * Provides utilities for npm package publishing, authentication validation,
+ * and error handling with credential sanitization.
+ */
+export { validateNpmToken, sanitizeErrorMessage, isAuthenticationError, isVersionConflictError, extractVersionFromError, createAuthenticationErrorMessage, createVersionConflictErrorMessage, createPublishErrorMessage, } from './publish-utils';
+//# sourceMappingURL=index.js.map

package/dist/publish/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publish/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/dist/publish/publish-utils.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Publishing Utilities
+ *
+ * Provides functions for npm package publishing, authentication validation,
+ * and error handling with credential sanitization.
+ */
+/**
+ * Validates that the NPM authentication token is set and non-empty.
+ *
+ * @param token - The NPM_TOKEN value from environment variables
+ * @returns true if token is valid, false otherwise
+ */
+export declare function validateNpmToken(token: string | undefined): boolean;
+/**
+ * Sanitizes error messages to remove any credential information.
+ *
+ * This function masks authentication tokens and other sensitive data
+ * that might appear in error messages or logs.
+ *
+ * @param message - The error message to sanitize
+ * @returns Sanitized error message with credentials masked
+ */
+export declare function sanitizeErrorMessage(message: string): string;
+/**
+ * Determines if an npm publish error is due to authentication failure.
+ *
+ * Checks error messages and status codes to identify authentication-related failures.
+ *
+ * @param error - The error object or message from npm publish
+ * @returns true if the error is authentication-related, false otherwise
+ */
+export declare function isAuthenticationError(error: Error | string): boolean;
+/**
+ * Determines if an npm publish error is due to a version conflict.
+ *
+ * Checks error messages and status codes to identify version conflict failures.
+ *
+ * @param error - The error object or message from npm publish
+ * @returns true if the error is a version conflict, false otherwise
+ */
+export declare function isVersionConflictError(error: Error | string): boolean;
+/**
+ * Creates a user-friendly error message for authentication failures.
+ *
+ * Provides actionable guidance without exposing credential values.
+ *
+ * @returns Formatted authentication error message
+ */
+export declare function createAuthenticationErrorMessage(): string;
+/**
+ * Extracts version number from a version conflict error message.
+ *
+ * Searches for semantic version patterns (MAJOR.MINOR.PATCH) in error messages
+ * to identify the conflicting version.
+ *
+ * @param error - The error object or message from npm publish
+ * @returns The extracted version string, or null if no version found
+ */
+export declare function extractVersionFromError(error: Error | string): string | null;
+/**
+ * Creates a user-friendly error message for version conflicts.
+ *
+ * @param version - The version that conflicts
+ * @returns Formatted version conflict error message
+ */
+export declare function createVersionConflictErrorMessage(version: string): string;
+/**
+ * Creates a generic error message for npm publish failures.
+ *
+ * @param error - The original error
+ * @returns Formatted error message with sanitized credentials
+ */
+export declare function createPublishErrorMessage(error: Error | string): string;
+//# sourceMappingURL=publish-utils.d.ts.map

package/dist/publish/publish-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-utils.d.ts","sourceRoot":"","sources":["../../src/publish/publish-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAwBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAerE;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAezD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAazE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAiBvE"}

package/dist/publish/publish-utils.js

@@ -0,0 +1,170 @@
+/**
+ * Publishing Utilities
+ *
+ * Provides functions for npm package publishing, authentication validation,
+ * and error handling with credential sanitization.
+ */
+import { maskCredentials } from '../utils/credential-masking.js';
+/**
+ * Validates that the NPM authentication token is set and non-empty.
+ *
+ * @param token - The NPM_TOKEN value from environment variables
+ * @returns true if token is valid, false otherwise
+ */
+export function validateNpmToken(token) {
+    return typeof token === 'string' && token.trim().length > 0;
+}
+/**
+ * Sanitizes error messages to remove any credential information.
+ *
+ * This function masks authentication tokens and other sensitive data
+ * that might appear in error messages or logs.
+ *
+ * @param message - The error message to sanitize
+ * @returns Sanitized error message with credentials masked
+ */
+export function sanitizeErrorMessage(message) {
+    // Use the centralized credential masking utility
+    return maskCredentials(message);
+}
+/**
+ * Determines if an npm publish error is due to authentication failure.
+ *
+ * Checks error messages and status codes to identify authentication-related failures.
+ *
+ * @param error - The error object or message from npm publish
+ * @returns true if the error is authentication-related, false otherwise
+ */
+export function isAuthenticationError(error) {
+    const errorMessage = typeof error === 'string' ? error : error.message;
+    const lowerMessage = errorMessage.toLowerCase();
+    // Common authentication error patterns from npm
+    const authPatterns = [
+        'authentication',
+        'unauthorized',
+        '401',
+        'forbidden',
+        '403',
+        'token',
+        'credentials',
+        'login',
+        'auth',
+        'permission denied',
+        'access denied',
+        'not authorized',
+        'authentication required',
+        'invalid token',
+        'expired token',
+    ];
+    return authPatterns.some(pattern => lowerMessage.includes(pattern));
+}
+/**
+ * Determines if an npm publish error is due to a version conflict.
+ *
+ * Checks error messages and status codes to identify version conflict failures.
+ *
+ * @param error - The error object or message from npm publish
+ * @returns true if the error is a version conflict, false otherwise
+ */
+export function isVersionConflictError(error) {
+    const errorMessage = typeof error === 'string' ? error : error.message;
+    const lowerMessage = errorMessage.toLowerCase();
+    // Common version conflict error patterns from npm
+    const conflictPatterns = [
+        'already exists',
+        'cannot publish over',
+        'already published',
+        'version conflict',
+        'duplicate version',
+        'already in use',
+    ];
+    return conflictPatterns.some(pattern => lowerMessage.includes(pattern));
+}
+/**
+ * Creates a user-friendly error message for authentication failures.
+ *
+ * Provides actionable guidance without exposing credential values.
+ *
+ * @returns Formatted authentication error message
+ */
+export function createAuthenticationErrorMessage() {
+    return [
+        'ERROR: npm authentication failed',
+        '',
+        'This could be due to:',
+        '  - Invalid or expired NPM_TOKEN',
+        '  - Insufficient permissions for the package',
+        '  - Token not configured in GitLab CI/CD variables',
+        '',
+        'To resolve:',
+        '  1. Verify NPM_TOKEN is set in GitLab CI/CD variables',
+        '  2. Ensure the token has publish permissions',
+        '  3. Check that the token has not expired',
+        '  4. Verify you have ownership/maintainer access to the package',
+    ].join('\n');
+}
+/**
+ * Extracts version number from a version conflict error message.
+ *
+ * Searches for semantic version patterns (MAJOR.MINOR.PATCH) in error messages
+ * to identify the conflicting version.
+ *
+ * @param error - The error object or message from npm publish
+ * @returns The extracted version string, or null if no version found
+ */
+export function extractVersionFromError(error) {
+    const errorMessage = typeof error === 'string' ? error : error.message;
+    // Match semantic version pattern: digits.digits.digits (with optional 'v' prefix)
+    // This regex matches versions like "1.2.3", "v1.2.3", "10.20.30", etc.
+    const versionPattern = /v?(\d+\.\d+\.\d+)/;
+    const match = errorMessage.match(versionPattern);
+    if (match) {
+        // Return the version without the 'v' prefix if present
+        return match[1];
+    }
+    return null;
+}
+/**
+ * Creates a user-friendly error message for version conflicts.
+ *
+ * @param version - The version that conflicts
+ * @returns Formatted version conflict error message
+ */
+export function createVersionConflictErrorMessage(version) {
+    return [
+        `ERROR: Version ${version} has already been published to npm`,
+        '',
+        'This could be due to:',
+        '  - The version was published in a previous release',
+        '  - Another pipeline published this version concurrently',
+        '',
+        'To resolve:',
+        '  1. Verify the current published version on npm',
+        '  2. Bump to the next version using the appropriate release type',
+        '  3. Ensure version tags are synchronized with npm',
+    ].join('\n');
+}
+/**
+ * Creates a generic error message for npm publish failures.
+ *
+ * @param error - The original error
+ * @returns Formatted error message with sanitized credentials
+ */
+export function createPublishErrorMessage(error) {
+    const errorMessage = typeof error === 'string' ? error : error.message;
+    // Use centralized credential masking - no need to pass credentials explicitly
+    const sanitized = maskCredentials(errorMessage);
+    return [
+        'ERROR: Failed to publish package to npm',
+        '',
+        'Error details:',
+        `  ${sanitized}`,
+        '',
+        'This could be due to:',
+        '  - Network connectivity issues',
+        '  - npm registry unavailable',
+        '  - Package validation errors',
+        '  - Insufficient permissions',
+    ].join('\n');
+}
+//# sourceMappingURL=publish-utils.js.map

package/dist/publish/publish-utils.js.map

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

package/dist/query/component-query.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ComponentQuery - Handles component lookups by name and selector
+ */
+import { ComponentIndex, IndexableDoc } from './index-builder.js';
+/**
+ * ComponentQuery class
+ * Provides methods for querying components by name and selector
+ */
+export declare class ComponentQuery {
+    private index;
+    constructor(index: ComponentIndex);
+    /**
+     * Get a component by name (case-sensitive)
+     */
+    getByName(name: string): IndexableDoc | undefined;
+    /**
+     * Get a component by selector (case-sensitive)
+     */
+    getBySelector(selector: string): IndexableDoc | undefined;
+    /**
+     * Get all components of a specific type
+     */
+    getByType(type: 'component' | 'directive' | 'pipe' | 'service' | 'all'): IndexableDoc[];
+    /**
+     * Get all components, optionally filtering deprecated ones
+     */
+    getAll(includeDeprecated?: boolean): IndexableDoc[];
+    /**
+     * Update the index
+     */
+    updateIndex(index: ComponentIndex): void;
+}
+//# sourceMappingURL=component-query.d.ts.map

package/dist/query/component-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-query.d.ts","sourceRoot":"","sources":["../../src/query/component-query.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAiB;gBAElB,KAAK,EAAE,cAAc;IAIjC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,EAAE;IAsBvF;;OAEG;IACH,MAAM,CAAC,iBAAiB,GAAE,OAAe,GAAG,YAAY,EAAE;IAQ1D;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;CAGzC"}

package/dist/query/component-query.js

@@ -0,0 +1,63 @@
+/**
+ * ComponentQuery class
+ * Provides methods for querying components by name and selector
+ */
+export class ComponentQuery {
+    index;
+    constructor(index) {
+        this.index = index;
+    }
+    /**
+     * Get a component by name (case-sensitive)
+     */
+    getByName(name) {
+        return this.index.byName.get(name);
+    }
+    /**
+     * Get a component by selector (case-sensitive)
+     */
+    getBySelector(selector) {
+        return this.index.bySelector.get(selector);
+    }
+    /**
+     * Get all components of a specific type
+     */
+    getByType(type) {
+        switch (type) {
+            case 'component':
+                return this.index.components;
+            case 'directive':
+                return this.index.directives;
+            case 'pipe':
+                return this.index.pipes;
+            case 'service':
+                return this.index.services;
+            case 'all':
+                return [
+                    ...this.index.components,
+                    ...this.index.directives,
+                    ...this.index.pipes,
+                    ...this.index.services,
+                ];
+            default:
+                return [];
+        }
+    }
+    /**
+     * Get all components, optionally filtering deprecated ones
+     */
+    getAll(includeDeprecated = false) {
+        const all = this.getByType('all');
+        if (includeDeprecated) {
+            return all;
+        }
+        return all.filter((doc) => !doc.deprecated);
+    }
+    /**
+     * Update the index
+     */
+    updateIndex(index) {
+        this.index = index;
+    }
+}
+//# sourceMappingURL=component-query.js.map

package/dist/query/component-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-query.js","sourceRoot":"","sources":["../../src/query/component-query.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,KAAK,CAAiB;IAE9B,YAAY,KAAqB;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAA4D;QACpE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC/B,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC/B,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;YAC1B,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7B,KAAK,KAAK;gBACR,OAAO;oBACL,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU;oBACxB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU;oBACxB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK;oBACnB,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ;iBACvB,CAAC;YACJ;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAA6B,KAAK;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAqB;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}