mcp-hydrocoder-image 1.0.0

package/dist/business/structuredPromptGenerator.js

@@ -0,0 +1,218 @@
+/**
+ * Structured Prompt Generator
+ * Uses Gemini Flash to generate optimized prompts for image generation
+ * Applies 7 best practices and 3 feature perspectives through intelligent selection
+ */
+import { Err, Ok } from '../types/result.js';
+import { GeminiAPIError } from '../utils/errors.js';
+/**
+ * System prompt for structured prompt generation optimized for image generation
+ * Follows Google's recommended Subject-Context-Style structure
+ */
+const SYSTEM_PROMPT = `You are an expert at crafting prompts for image generation models. Your role is to transform user requests into rich, detailed prompts that maximize image generation quality.
+
+Structure your enhancement around three core elements:
+
+1. SUBJECT (What): The main focus of the image
+   - Physical characteristics: textures, materials, colors, scale
+   - Actions, poses, expressions if applicable
+   - Distinctive features that define the subject
+
+2. CONTEXT (Where/When): The environment and conditions
+   - Setting, background, spatial relationships (foreground, midground, background)
+   - Time of day, weather, atmospheric conditions
+   - Mood and emotional tone of the scene
+
+3. STYLE (How): The visual treatment
+   - Artistic or photographic approach: reference specific artists, movements, or styles
+   - Lighting design: direction, quality, color temperature, shadows
+   - Camera/lens choices: specify focal length, aperture, and shooting angle when photographic
+
+Core principles:
+- Preserve the user's original intent while enhancing detail
+- Focus on what should be present rather than what should be absent
+- Include photographic or artistic terminology when appropriate
+- Maintain clarity while adding richness and specificity
+
+Your output should weave these elements into a single, natural flowing description - not a structured list. Make it vivid, engaging, and unambiguous.`;
+/**
+ * Additional system prompt for image editing mode (when input image is provided)
+ */
+const IMAGE_EDITING_CONTEXT = `
+
+IMPORTANT: An input image has been provided. Your task is to:
+1. Analyze the visual context, style, and atmosphere of the input image
+2. Preserve the original image's core characteristics (color palette, lighting style, composition) while applying the requested changes
+3. Focus on maintaining visual consistency - describe modifications relative to the existing image
+4. Be specific about what to keep unchanged vs what to modify
+5. Use phrases like "maintain the existing...", "preserve the original...", "keep the same..." to ensure fidelity to source`;
+/**
+ * Implementation of StructuredPromptGenerator using Gemini Flash
+ */
+export class StructuredPromptGeneratorImpl {
+    constructor(geminiTextClient) {
+        this.geminiTextClient = geminiTextClient;
+    }
+    async generateStructuredPrompt(userPrompt, features = {}, inputImageData, purpose) {
+        try {
+            // Validate input
+            if (!userPrompt || userPrompt.trim().length === 0) {
+                return Err(new GeminiAPIError('User prompt cannot be empty'));
+            }
+            // Build complete prompt with system instruction and meta-prompt
+            const completePrompt = this.buildCompletePrompt(userPrompt, features, !!inputImageData, purpose);
+            // Combine system prompts for image editing mode
+            const systemInstruction = inputImageData
+                ? SYSTEM_PROMPT + IMAGE_EDITING_CONTEXT
+                : SYSTEM_PROMPT;
+            // Generate structured prompt via pure API call
+            const config = {
+                temperature: 0.7,
+                maxTokens: 1000,
+                systemInstruction,
+                ...(inputImageData && { inputImage: inputImageData }), // Only include if available
+            };
+            const result = await this.geminiTextClient.generateText(completePrompt, config);
+            if (!result.success) {
+                return Err(result.error);
+            }
+            // Extract selected practices from the response
+            const selectedPractices = this.inferSelectedPractices(result.data, features);
+            return Ok({
+                originalPrompt: userPrompt,
+                structuredPrompt: result.data,
+                selectedPractices,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return Err(new GeminiAPIError(`Failed to generate structured prompt: ${errorMessage}`));
+        }
+    }
+    /**
+     * Build complete prompt with all optimization context
+     */
+    buildCompletePrompt(userPrompt, features, hasInputImage, purpose) {
+        const featureContext = this.buildEnhancedFeatureContext(features);
+        // Add image editing context if an input image is provided
+        const imageEditingInstruction = hasInputImage
+            ? `\nNOTE: An input image has been provided. Focus on preserving its original characteristics while applying the requested modifications. Maintain consistency with the source image's style, colors, and atmosphere.\n`
+            : '';
+        // Add purpose context if provided
+        const purposeContext = purpose
+            ? `\nINTENDED USE: ${purpose}\nTailor the visual style, quality level, and details to match this purpose.\n`
+            : '';
+        return `Transform this image generation request into a detailed, vivid prompt that will produce high-quality results:
+
+"${userPrompt}"
+${imageEditingInstruction}
+${purposeContext}
+${featureContext}
+
+Consider these aspects as you enhance the prompt:
+- Visual details: textures, lighting, colors, materials, composition
+- Spatial relationships and scale between elements
+- Artistic or photographic style that fits the subject
+- Emotional tone and atmosphere
+- Technical specifications if relevant (lens type, camera angle, etc.)
+
+Create a natural, flowing description that brings the scene to life. Focus on what should be present rather than what should be absent.
+
+Example of a well-enhanced prompt:
+Input: "A happy dog in a park"
+Enhanced: "Golden retriever mid-leap catching a red frisbee, ears flying, tongue out in joy, in a sunlit urban park. Soft morning light filtering through oak trees creates dappled shadows on emerald grass. Background shows families on picnic blankets, slightly out of focus. Shot from low angle emphasizing the dog's athletic movement, with motion blur on the paws suggesting speed."
+
+Now transform the user's request with similar attention to detail and creative enhancement.`;
+    }
+    /**
+     * Build enhanced feature context based on flags with explicit requirements
+     */
+    buildEnhancedFeatureContext(features) {
+        const requirements = [];
+        if (features.maintainCharacterConsistency) {
+            requirements.push('Character consistency is CRITICAL - MUST include distinctive character features: This character needs at least 3 recognizable visual markers that would identify them across different scenes. Include specific details like "distinctive scar", "signature clothing item", "unique hairstyle", or "characteristic accessory". Use words like "signature", "distinctive", "always wears/has" to emphasize these consistent features.');
+        }
+        if (features.blendImages) {
+            requirements.push('MUST describe seamless integration: Multiple visual elements need to blend naturally. Use spatial relationship terms like "seamlessly blending", "harmoniously composed", "naturally integrated". Clearly describe foreground (X% of frame), midground, and background elements with their relative scales and how they interact within the composition.');
+        }
+        if (features.useWorldKnowledge) {
+            requirements.push('Apply accurate real-world knowledge - MUST incorporate authentic details: Apply accurate real-world knowledge about cultures, locations, or historical elements. Use specific terminology like "traditional [culture] style", "authentic [location] architecture", "typical of [region]", "historically accurate [period]". Be precise about cultural elements, geographical features, and factual details.');
+        }
+        if (requirements.length > 0) {
+            return `\nMANDATORY REQUIREMENTS - These MUST be clearly reflected in your enhanced prompt:\n\n${requirements.join('\n\n')}\n`;
+        }
+        return '';
+    }
+    /**
+     * Infer which best practices were selected based on the generated prompt
+     */
+    inferSelectedPractices(structuredPrompt, features) {
+        const selected = [];
+        const promptLower = structuredPrompt.toLowerCase();
+        // Check for detailed visual descriptions
+        if (promptLower.includes('lighting') ||
+            promptLower.includes('texture') ||
+            promptLower.includes('atmosphere') ||
+            promptLower.includes('shadow') ||
+            promptLower.includes('material')) {
+            selected.push('Hyper-Specific Details');
+        }
+        // Check for character consistency markers
+        if (features.maintainCharacterConsistency ||
+            promptLower.includes('distinctive') ||
+            promptLower.includes('signature') ||
+            promptLower.includes('characteristic') ||
+            promptLower.includes('always wears') ||
+            promptLower.includes('always has')) {
+            selected.push('Character Consistency');
+        }
+        // Check for multi-element blending
+        if (features.blendImages ||
+            promptLower.includes('seamlessly') ||
+            promptLower.includes('harmoniously') ||
+            promptLower.includes('naturally integrated') ||
+            promptLower.includes('foreground') ||
+            promptLower.includes('midground') ||
+            promptLower.includes('background')) {
+            selected.push('Compositional Integration');
+        }
+        // Check for world knowledge application
+        if (features.useWorldKnowledge ||
+            promptLower.includes('authentic') ||
+            promptLower.includes('traditional') ||
+            promptLower.includes('typical of') ||
+            promptLower.includes('historically accurate') ||
+            promptLower.includes('culturally')) {
+            selected.push('Real-World Accuracy');
+        }
+        // Check for photographic/artistic terminology
+        if (promptLower.includes('lens') ||
+            promptLower.includes('aperture') ||
+            promptLower.includes('f/') ||
+            promptLower.includes('mm ') ||
+            promptLower.includes('angle') ||
+            promptLower.includes('shot') ||
+            promptLower.includes('depth of field')) {
+            selected.push('Camera Control Terminology');
+        }
+        // Check for atmospheric and mood enhancement
+        if (promptLower.includes('mood') ||
+            promptLower.includes('emotion') ||
+            promptLower.includes('feeling') ||
+            promptLower.includes('ambiance')) {
+            selected.push('Atmospheric Enhancement');
+        }
+        // Ensure we have at least some practices selected
+        if (selected.length === 0) {
+            selected.push('General Enhancement');
+        }
+        return selected;
+    }
+}
+/**
+ * Factory function to create StructuredPromptGenerator
+ */
+export function createStructuredPromptGenerator(geminiTextClient) {
+    return new StructuredPromptGeneratorImpl(geminiTextClient);
+}
+//# sourceMappingURL=structuredPromptGenerator.js.map

package/dist/business/structuredPromptGenerator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * MCP Image Generator - Entry Point Router
+ *
+ * Routes to:
+ * - skills install  → bin/install-skills.js
+ * - (default)       → MCP server startup
+ */
+export type { GeneratedImageResult } from './api/geminiClient.js';
+export { createMCPServer, MCPServerImpl } from './server/mcpServer.js';
+export type { GenerateImageParams, MCPServerConfig } from './types/mcp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAwBH,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * MCP Image Generator - Entry Point Router
+ *
+ * Routes to:
+ * - skills install  → bin/install-skills.js
+ * - (default)       → MCP server startup
+ */
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const args = process.argv.slice(2);
+if (args[0] === 'skills') {
+    if (args[1] === 'install') {
+        const { run } = await import(resolve(__dirname, '..', 'bin', 'install-skills.js'));
+        run(args.slice(2));
+        process.exit(0);
+    }
+    else {
+        console.error('Unknown skills subcommand. Usage: npx mcp-image skills install --path <path>');
+        console.error('Run "npx mcp-image skills install --help" for more information.');
+        process.exit(1);
+    }
+}
+else {
+    await import('./server-main.js');
+}
+export { createMCPServer, MCPServerImpl } from './server/mcpServer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAElC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAClF,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAA;QAC7F,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAA;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAClC,CAAC;AAGD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/server/errorHandler.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Error Handler utility for unified error processing
+ * Provides centralized error handling and Result type wrapping
+ */
+import type { McpToolResponse } from '../types/mcp.js';
+import { type Result } from '../utils/errors.js';
+/**
+ * Handle an error and convert it to a structured MCP tool response
+ * @param error Error to handle
+ * @returns MCP tool response with structured error content
+ */
+declare function handleError(error: Error): McpToolResponse;
+/**
+ * Wrap an operation with Result type for safe error handling
+ * @param operation Operation to execute
+ * @param context Optional context for logging
+ * @returns Promise resolving to Result type
+ */
+declare function wrapWithResultType<T>(operation: () => Promise<T>, context?: string): Promise<Result<T, Error>>;
+/**
+ * Error Handler utilities for unified error processing and Result type wrapping
+ * Maintains backward compatibility with static class API
+ */
+export declare const ErrorHandler: {
+    readonly handleError: typeof handleError;
+    readonly wrapWithResultType: typeof wrapWithResultType;
+};
+export {};
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/server/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/server/errorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAA;AAM3B;;;;GAIG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAqBlD;AAED;;;;;GAKG;AACH,iBAAe,kBAAkB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAa3B;AA2DD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAA"}

package/dist/server/errorHandler.js

@@ -0,0 +1,99 @@
+/**
+ * Error Handler utility for unified error processing
+ * Provides centralized error handling and Result type wrapping
+ */
+import { ConfigError, FileOperationError, GeminiAPIError, InputValidationError, NetworkError, } from '../utils/errors.js';
+import { Logger } from '../utils/logger.js';
+// Create logger instance for error handling
+const logger = new Logger();
+/**
+ * Handle an error and convert it to a structured MCP tool response
+ * @param error Error to handle
+ * @returns MCP tool response with structured error content
+ */
+function handleError(error) {
+    // Log the error with context
+    logger.error('error-handler', 'Error occurred', error, {
+        errorType: error.constructor.name,
+        stack: error.stack,
+    });
+    // Convert error to structured format
+    const structuredError = {
+        error: convertErrorToStructured(error),
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(structuredError),
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Wrap an operation with Result type for safe error handling
+ * @param operation Operation to execute
+ * @param context Optional context for logging
+ * @returns Promise resolving to Result type
+ */
+async function wrapWithResultType(operation, context) {
+    try {
+        const result = await operation();
+        return { ok: true, value: result };
+    }
+    catch (error) {
+        const finalError = error instanceof Error ? error : new Error('Unknown error');
+        if (context) {
+            logger.error(context, 'Operation failed', finalError);
+        }
+        return { ok: false, error: finalError };
+    }
+}
+/**
+ * Convert various error types to structured error format
+ * @param error Error to convert
+ * @returns Structured error object
+ */
+function convertErrorToStructured(error) {
+    const baseError = {
+        timestamp: new Date().toISOString(),
+    };
+    if (error instanceof InputValidationError ||
+        error instanceof FileOperationError ||
+        error instanceof GeminiAPIError ||
+        error instanceof NetworkError ||
+        error instanceof ConfigError) {
+        const errorResponse = {
+            ...baseError,
+            code: error.code,
+            message: error.message,
+            suggestion: error.suggestion,
+        };
+        // Include context details for GeminiAPIError to provide better debugging info
+        if (error instanceof GeminiAPIError && error.context) {
+            // Add non-sensitive context information
+            const { suggestion, ...otherContext } = error.context;
+            if (Object.keys(otherContext).length > 0) {
+                errorResponse['details'] = otherContext;
+            }
+        }
+        return errorResponse;
+    }
+    // Handle unknown errors
+    return {
+        ...baseError,
+        code: 'INTERNAL_ERROR',
+        message: error.message || 'An unknown error occurred',
+        suggestion: 'Contact system administrator',
+    };
+}
+/**
+ * Error Handler utilities for unified error processing and Result type wrapping
+ * Maintains backward compatibility with static class API
+ */
+export const ErrorHandler = {
+    handleError,
+    wrapWithResultType,
+};
+//# sourceMappingURL=errorHandler.js.map

package/dist/server/errorHandler.js.map

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

package/dist/server/mcpServer.d.ts

@@ -0,0 +1,159 @@
+/**
+ * MCP Server implementation
+ * Simplified architecture with direct Gemini integration
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { MCPServerConfig } from '../types/mcp.js';
+/**
+ * Simplified MCP server
+ */
+export declare class MCPServerImpl {
+    private config;
+    private server;
+    private logger;
+    private fileManager;
+    private responseBuilder;
+    private securityManager;
+    private structuredPromptGenerator;
+    private geminiTextClient;
+    private geminiClient;
+    constructor(config?: Partial<MCPServerConfig>);
+    /**
+     * Get server info
+     */
+    getServerInfo(): {
+        name: string;
+        version: string;
+    };
+    /**
+     * Get list of registered tools
+     */
+    getToolsList(): {
+        tools: {
+            name: string;
+            description: string;
+            inputSchema: {
+                type: "object";
+                properties: {
+                    prompt: {
+                        type: "string";
+                        description: string;
+                    };
+                    fileName: {
+                        type: "string";
+                        description: string;
+                    };
+                    inputImagePath: {
+                        type: "string";
+                        description: string;
+                    };
+                    inputImage: {
+                        type: "string";
+                        description: string;
+                    };
+                    inputImageMimeType: {
+                        type: "string";
+                        description: string;
+                        enum: string[];
+                    };
+                    inputImages: {
+                        type: "array";
+                        description: string;
+                        items: {
+                            type: "object";
+                            properties: {
+                                data: {
+                                    type: "string";
+                                    description: string;
+                                };
+                                mimeType: {
+                                    type: "string";
+                                    description: string;
+                                    enum: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    };
+                    inputImagePaths: {
+                        type: "array";
+                        description: string;
+                        items: {
+                            type: "string";
+                            description: string;
+                        };
+                    };
+                    returnBase64: {
+                        type: "boolean";
+                        description: string;
+                    };
+                    blendImages: {
+                        type: "boolean";
+                        description: string;
+                    };
+                    maintainCharacterConsistency: {
+                        type: "boolean";
+                        description: string;
+                    };
+                    useWorldKnowledge: {
+                        type: "boolean";
+                        description: string;
+                    };
+                    useGoogleSearch: {
+                        type: "boolean";
+                        description: string;
+                    };
+                    aspectRatio: {
+                        type: "string";
+                        description: string;
+                        enum: string[];
+                    };
+                    imageSize: {
+                        type: "string";
+                        description: string;
+                        enum: string[];
+                    };
+                    purpose: {
+                        type: "string";
+                        description: string;
+                    };
+                    quality: {
+                        type: "string";
+                        description: string;
+                        enum: string[];
+                    };
+                    skipPromptEnhancement: {
+                        type: "boolean";
+                        description: string;
+                    };
+                };
+                required: string[];
+            };
+        }[];
+    };
+    /**
+     * Tool execution
+     */
+    callTool(name: string, args: unknown): Promise<import("../types/mcp.js").McpToolResponse>;
+    /**
+     * Initialize Gemini clients lazily
+     */
+    private initializeClients;
+    /**
+     * Simplified image generation handler
+     */
+    private handleGenerateImage;
+    /**
+     * Initialize MCP server with tool handlers
+     */
+    initialize(): Server;
+    /**
+     * Setup MCP protocol handlers
+     */
+    private setupHandlers;
+}
+/**
+ * Factory function to create MCP server
+ */
+export declare function createMCPServer(config?: Partial<MCPServerConfig>): MCPServerImpl;
+//# sourceMappingURL=mcpServer.d.ts.map

package/dist/server/mcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../src/server/mcpServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAoBlE,OAAO,KAAK,EAAuB,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAiB3E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,yBAAyB,CAAyC;IAC1E,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,YAAY,CAA4B;gBAEpC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD;;OAEG;IACI,aAAa;;;;IAOpB;;OAEG;IACI,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwJnB;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAYjD;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,mBAAmB;IA2KjC;;OAEG;IACI,UAAU,IAAI,MAAM;IAmB3B;;OAEG;IACH,OAAO,CAAC,aAAa;CA0BtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,iBAEpE"}