@eui/mcp 1.0.3

package/dist/utils/credential-masking.js

@@ -0,0 +1,202 @@
+/**
+ * Credential masking utilities for secure logging
+ *
+ * This module provides functions to mask sensitive credentials in logs and error messages
+ * to prevent accidental exposure of tokens, passwords, and other secrets.
+ */
+/**
+ * Common patterns for credentials that should be masked
+ */
+const CREDENTIAL_PATTERNS = [
+    // npm tokens (npm_xxx format) - at least 20 characters after prefix
+    /npm_[a-zA-Z0-9]{20,}/gi,
+    // Generic tokens (various formats) - capture the token value
+    /(?:token|key|secret|password|auth)["'\s:=]+([a-zA-Z0-9_\-\.]{20,})/gi,
+    // Bearer tokens - at least 15 characters
+    /Bearer\s+[a-zA-Z0-9_\-\.]{15,}/gi,
+    // GitLab tokens (glpat- prefix)
+    /glpat-[a-zA-Z0-9_\-]{20,}/gi,
+    // GitHub tokens (ghp_, gho_, ghs_, ghr_ prefixes)
+    /gh[psor]_[a-zA-Z0-9]{20,}/gi,
+    // AWS access keys
+    /AKIA[0-9A-Z]{16}/gi,
+    // Generic API keys in JSON (32+ alphanumeric characters in quotes)
+    /"[a-zA-Z0-9_\-]{32,}"/g,
+];
+/**
+ * Mask replacement string
+ */
+const MASK = '***REDACTED***';
+/**
+ * Masks credentials in a string by replacing them with a redacted placeholder
+ *
+ * @param text - The text that may contain credentials
+ * @param customPatterns - Additional regex patterns to match credentials
+ * @returns The text with credentials masked
+ *
+ * @example
+ * ```typescript
+ * const log = "Using token: npm_abc123def456";
+ * const masked = maskCredentials(log);
+ * // Returns: "Using token: ***REDACTED***"
+ * ```
+ */
+export function maskCredentials(text, customPatterns = []) {
+    if (!text) {
+        return text;
+    }
+    let maskedText = text;
+    const allPatterns = [...CREDENTIAL_PATTERNS, ...customPatterns];
+    for (const pattern of allPatterns) {
+        maskedText = maskedText.replace(pattern, MASK);
+    }
+    return maskedText;
+}
+/**
+ * Sanitizes an error message by masking any credentials it may contain
+ *
+ * @param error - The error object or message to sanitize
+ * @returns A sanitized error message safe for logging
+ *
+ * @example
+ * ```typescript
+ * const error = new Error("Auth failed with token npm_abc123");
+ * const sanitized = sanitizeErrorMessage(error);
+ * // Returns: "Auth failed with token ***REDACTED***"
+ * ```
+ */
+export function sanitizeErrorMessage(error) {
+    if (!error) {
+        return 'Unknown error';
+    }
+    let message;
+    if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (typeof error === 'string') {
+        message = error;
+    }
+    else if (typeof error === 'object') {
+        message = JSON.stringify(error);
+    }
+    else {
+        message = String(error);
+    }
+    return maskCredentials(message);
+}
+/**
+ * Sanitizes an entire error object, masking credentials in message, stack, and details
+ *
+ * @param error - The error object to sanitize
+ * @returns A sanitized error object safe for logging
+ *
+ * @example
+ * ```typescript
+ * const error = new Error("Failed with token npm_abc123");
+ * const sanitized = sanitizeError(error);
+ * // Returns error with masked message and stack
+ * ```
+ */
+export function sanitizeError(error) {
+    if (!(error instanceof Error)) {
+        const sanitizedMessage = sanitizeErrorMessage(error);
+        return new Error(sanitizedMessage);
+    }
+    // Create a new error with sanitized message
+    const sanitizedError = new Error(maskCredentials(error.message));
+    sanitizedError.name = error.name;
+    // Sanitize stack trace if present
+    if (error.stack) {
+        sanitizedError.stack = maskCredentials(error.stack);
+    }
+    // Copy other properties while sanitizing them
+    const errorObj = error;
+    for (const key in errorObj) {
+        if (key !== 'message' && key !== 'stack' && key !== 'name') {
+            const value = errorObj[key];
+            if (typeof value === 'string') {
+                sanitizedError[key] = maskCredentials(value);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitizedError[key] = JSON.parse(maskCredentials(JSON.stringify(value)));
+            }
+            else {
+                sanitizedError[key] = value;
+            }
+        }
+    }
+    return sanitizedError;
+}
+/**
+ * Masks credentials in log arguments before logging
+ *
+ * @param args - The arguments to be logged
+ * @returns Sanitized arguments safe for logging
+ *
+ * @example
+ * ```typescript
+ * const args = ["User logged in", { token: "npm_abc123" }];
+ * const sanitized = maskLogArguments(args);
+ * // Returns: ["User logged in", { token: "***REDACTED***" }]
+ * ```
+ */
+export function maskLogArguments(args) {
+    return args.map((arg) => {
+        if (typeof arg === 'string') {
+            return maskCredentials(arg);
+        }
+        else if (arg instanceof Error) {
+            return sanitizeError(arg);
+        }
+        else if (typeof arg === 'object' && arg !== null) {
+            try {
+                const jsonString = JSON.stringify(arg);
+                const maskedString = maskCredentials(jsonString);
+                return JSON.parse(maskedString);
+            }
+            catch {
+                // If JSON parsing fails, return as-is
+                return arg;
+            }
+        }
+        return arg;
+    });
+}
+/**
+ * Creates a safe error message for authentication failures without exposing credentials
+ *
+ * @param operation - The operation that failed (e.g., "npm publish", "git push")
+ * @returns A generic authentication error message
+ *
+ * @example
+ * ```typescript
+ * const message = createAuthErrorMessage("npm publish");
+ * // Returns: "Authentication failed for npm publish. Please check your credentials."
+ * ```
+ */
+export function createAuthErrorMessage(operation) {
+    return `Authentication failed for ${operation}. Please check your credentials.`;
+}
+/**
+ * Checks if a string contains potential credentials
+ *
+ * @param text - The text to check
+ * @returns True if the text likely contains credentials
+ *
+ * @example
+ * ```typescript
+ * containsCredentials("npm_abc123def456"); // true
+ * containsCredentials("Hello world"); // false
+ * ```
+ */
+export function containsCredentials(text) {
+    if (!text) {
+        return false;
+    }
+    return CREDENTIAL_PATTERNS.some((pattern) => {
+        // Reset regex state
+        pattern.lastIndex = 0;
+        return pattern.test(text);
+    });
+}
+//# sourceMappingURL=credential-masking.js.map

package/dist/utils/credential-masking.js.map

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

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Global error handler to ensure errors don't crash the server
+ */
+import { AppError } from './errors.js';
+/**
+ * Error handler options
+ */
+export interface ErrorHandlerOptions {
+    exitOnUnhandledRejection?: boolean;
+    exitOnUncaughtException?: boolean;
+}
+/**
+ * Global error handler class
+ */
+export declare class ErrorHandler {
+    private options;
+    private isShuttingDown;
+    constructor(options?: Partial<ErrorHandlerOptions>);
+    /**
+     * Initializes global error handlers
+     */
+    initialize(): void;
+    /**
+     * Handles unhandled promise rejections
+     */
+    private handleUnhandledRejection;
+    /**
+     * Handles uncaught exceptions
+     */
+    private handleUncaughtException;
+    /**
+     * Handles graceful shutdown
+     */
+    private handleShutdown;
+    /**
+     * Exits the process
+     */
+    private exitProcess;
+    /**
+     * Handles an error and returns a safe response
+     */
+    handleError(error: unknown): AppError;
+    /**
+     * Wraps an async function with error handling
+     */
+    wrapAsync<T extends unknown[], R>(fn: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+    /**
+     * Wraps a sync function with error handling
+     */
+    wrapSync<T extends unknown[], R>(fn: (...args: T) => R): (...args: T) => R;
+}
+/**
+ * Initializes the global error handler
+ */
+export declare function initErrorHandler(options?: Partial<ErrorHandlerOptions>): ErrorHandler;
+/**
+ * Gets the global error handler
+ */
+export declare function getErrorHandler(): ErrorHandler;
+/**
+ * Safely executes an async function and handles errors
+ */
+export declare function safeAsync<T>(fn: () => Promise<T>, fallback?: T): Promise<T | undefined>;
+/**
+ * Safely executes a sync function and handles errors
+ */
+export declare function safeSync<T>(fn: () => T, fallback?: T): T | undefined;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAkC,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAOD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAkB;gBAE5B,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAItD;;OAEG;IACH,UAAU,IAAI,IAAI;IAqBlB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ;IAmBrC;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC9B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAW7B;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC7B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GACpB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC;CAUrB;AAOD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAIrF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAM9C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAOxB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,CAAC,EACX,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,GAAG,SAAS,CAOf"}

package/dist/utils/error-handler.js

@@ -0,0 +1,184 @@
+/**
+ * Global error handler to ensure errors don't crash the server
+ */
+import { getLogger } from './logger.js';
+import { isOperationalError, toAppError } from './errors.js';
+const DEFAULT_OPTIONS = {
+    exitOnUnhandledRejection: false,
+    exitOnUncaughtException: false,
+};
+/**
+ * Global error handler class
+ */
+export class ErrorHandler {
+    options;
+    isShuttingDown = false;
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Initializes global error handlers
+     */
+    initialize() {
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', (reason) => {
+            this.handleUnhandledRejection(reason);
+        });
+        // Handle uncaught exceptions
+        process.on('uncaughtException', (error) => {
+            this.handleUncaughtException(error);
+        });
+        // Handle process termination signals
+        process.on('SIGTERM', () => {
+            this.handleShutdown('SIGTERM');
+        });
+        process.on('SIGINT', () => {
+            this.handleShutdown('SIGINT');
+        });
+    }
+    /**
+     * Handles unhandled promise rejections
+     */
+    handleUnhandledRejection(reason) {
+        const logger = getLogger();
+        const error = toAppError(reason);
+        logger.error('Unhandled promise rejection', error, {
+            isOperational: error.isOperational,
+        });
+        if (!isOperationalError(error) && this.options.exitOnUnhandledRejection) {
+            this.exitProcess(1);
+        }
+    }
+    /**
+     * Handles uncaught exceptions
+     */
+    handleUncaughtException(error) {
+        const logger = getLogger();
+        const appError = toAppError(error);
+        logger.error('Uncaught exception', appError, {
+            isOperational: appError.isOperational,
+        });
+        if (!isOperationalError(appError) && this.options.exitOnUncaughtException) {
+            this.exitProcess(1);
+        }
+    }
+    /**
+     * Handles graceful shutdown
+     */
+    handleShutdown(signal) {
+        const logger = getLogger();
+        if (this.isShuttingDown) {
+            logger.warn('Shutdown already in progress, forcing exit');
+            this.exitProcess(1);
+            return;
+        }
+        this.isShuttingDown = true;
+        logger.info(`Received ${signal}, starting graceful shutdown`);
+        // Give the application time to clean up
+        setTimeout(() => {
+            logger.info('Graceful shutdown complete');
+            this.exitProcess(0);
+        }, 5000);
+    }
+    /**
+     * Exits the process
+     */
+    exitProcess(code) {
+        process.exit(code);
+    }
+    /**
+     * Handles an error and returns a safe response
+     */
+    handleError(error) {
+        const logger = getLogger();
+        const appError = toAppError(error);
+        // Log the error
+        if (isOperationalError(appError)) {
+            logger.warn('Operational error occurred', {
+                code: appError.code,
+                message: appError.message,
+            });
+        }
+        else {
+            logger.error('Non-operational error occurred', appError, {
+                code: appError.code,
+            });
+        }
+        return appError;
+    }
+    /**
+     * Wraps an async function with error handling
+     */
+    wrapAsync(fn) {
+        return async (...args) => {
+            try {
+                return await fn(...args);
+            }
+            catch (error) {
+                const appError = this.handleError(error);
+                throw appError;
+            }
+        };
+    }
+    /**
+     * Wraps a sync function with error handling
+     */
+    wrapSync(fn) {
+        return (...args) => {
+            try {
+                return fn(...args);
+            }
+            catch (error) {
+                const appError = this.handleError(error);
+                throw appError;
+            }
+        };
+    }
+}
+/**
+ * Global error handler instance
+ */
+let globalErrorHandler = null;
+/**
+ * Initializes the global error handler
+ */
+export function initErrorHandler(options) {
+    globalErrorHandler = new ErrorHandler(options);
+    globalErrorHandler.initialize();
+    return globalErrorHandler;
+}
+/**
+ * Gets the global error handler
+ */
+export function getErrorHandler() {
+    if (!globalErrorHandler) {
+        globalErrorHandler = new ErrorHandler();
+        globalErrorHandler.initialize();
+    }
+    return globalErrorHandler;
+}
+/**
+ * Safely executes an async function and handles errors
+ */
+export async function safeAsync(fn, fallback) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        getErrorHandler().handleError(error);
+        return fallback;
+    }
+}
+/**
+ * Safely executes a sync function and handles errors
+ */
+export function safeSync(fn, fallback) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        getErrorHandler().handleError(error);
+        return fallback;
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Custom error classes for different error types
+ */
+/**
+ * Base error class for all application errors
+ */
+export declare class AppError extends Error {
+    code: string;
+    statusCode: number;
+    readonly isOperational: boolean;
+    readonly details?: unknown;
+    constructor(message: string, code: string, statusCode?: number, isOperational?: boolean, details?: unknown);
+    /**
+     * Converts error to JSON format for MCP responses
+     */
+    toJSON(): {
+        error: {
+            code: string;
+            message: string;
+            details: unknown;
+        };
+    };
+}
+/**
+ * File system related errors
+ */
+export declare class FileSystemError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * File not found error
+ */
+export declare class FileNotFoundError extends FileSystemError {
+    constructor(filePath: string);
+}
+/**
+ * Permission denied error
+ */
+export declare class PermissionDeniedError extends FileSystemError {
+    constructor(filePath: string);
+}
+/**
+ * Parsing related errors
+ */
+export declare class ParsingError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Invalid JSON error
+ */
+export declare class InvalidJsonError extends ParsingError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Invalid structure error
+ */
+export declare class InvalidStructureError extends ParsingError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Validation related errors
+ */
+export declare class ValidationError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Duplicate name error
+ */
+export declare class DuplicateNameError extends ValidationError {
+    constructor(name: string, types: string[]);
+}
+/**
+ * Invalid component structure error
+ */
+export declare class InvalidComponentError extends ValidationError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Query related errors
+ */
+export declare class QueryError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Component not found error
+ */
+export declare class ComponentNotFoundError extends QueryError {
+    constructor(name: string);
+}
+/**
+ * Invalid search query error
+ */
+export declare class InvalidSearchQueryError extends QueryError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Invalid pagination parameters error
+ */
+export declare class InvalidPaginationError extends QueryError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * MCP protocol related errors
+ */
+export declare class McpError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Invalid tool name error
+ */
+export declare class InvalidToolError extends McpError {
+    constructor(toolName: string);
+}
+/**
+ * Missing required parameter error
+ */
+export declare class MissingParameterError extends McpError {
+    constructor(parameterName: string, toolName: string);
+}
+/**
+ * Invalid parameter type error
+ */
+export declare class InvalidParameterError extends McpError {
+    constructor(parameterName: string, expectedType: string, actualType: string);
+}
+/**
+ * Runtime errors
+ */
+export declare class RuntimeError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Out of memory error
+ */
+export declare class OutOfMemoryError extends RuntimeError {
+    constructor(details?: unknown);
+}
+/**
+ * Unexpected error
+ */
+export declare class UnexpectedError extends RuntimeError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Type guard to check if an error is an AppError
+ */
+export declare function isAppError(error: unknown): error is AppError;
+/**
+ * Type guard to check if an error is operational
+ */
+export declare function isOperationalError(error: unknown): boolean;
+/**
+ * Converts any error to an AppError
+ */
+export declare function toAppError(error: unknown): AppError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IAC1B,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,aAAa,GAAE,OAAc,EAC7B,OAAO,CAAC,EAAE,OAAO;IAanB;;OAEG;IACH,MAAM;;;;;;;CASP;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,QAAQ,EAAE,MAAM;CAK7B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,QAAQ,EAAE,MAAM;CAK7B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;CAO1C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,IAAI,EAAE,MAAM;CAKzB;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;gBACxB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;gBAChC,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAOpD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAO5E;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,CAAC,EAAE,OAAO;CAI9B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAanD"}