@bloomneo/appkit 1.2.9

package/dist/event/defaults.js

@@ -0,0 +1,378 @@
+/**
+ * Smart defaults and environment validation for event system with auto-strategy detection
+ * @module @bloomneo/appkit/event
+ * @file src/event/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to configure event system and connection strategy
+ * @llm-rule AVOID: Calling multiple times - expensive environment parsing, use lazy loading in get()
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ * @llm-rule NOTE: Auto-detects Redis vs Memory based on REDIS_URL environment variable
+ */
+/**
+ * Gets smart defaults using environment variables with auto-strategy detection
+ * @llm-rule WHEN: App startup to get production-ready event configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ * @llm-rule NOTE: Auto-detects strategy: REDIS_URL → Redis, no REDIS_URL → Memory
+ */
+export function getSmartDefaults() {
+    validateEnvironment();
+    const nodeEnv = process.env.NODE_ENV || 'development';
+    const isDevelopment = nodeEnv === 'development';
+    const isProduction = nodeEnv === 'production';
+    const isTest = nodeEnv === 'test';
+    // Auto-detect strategy from environment
+    const strategy = detectEventStrategy();
+    return {
+        // Strategy selection with smart detection
+        strategy,
+        // Namespace with service identification
+        namespace: process.env.VOILA_EVENT_NAMESPACE || process.env.VOILA_SERVICE_NAME || 'default',
+        // Redis configuration (only used when strategy is 'redis')
+        redis: {
+            url: process.env.REDIS_URL || 'redis://localhost:6379',
+            password: process.env.REDIS_PASSWORD,
+            maxRetries: parseInt(process.env.VOILA_EVENT_REDIS_RETRIES || '3'),
+            retryDelay: parseInt(process.env.VOILA_EVENT_REDIS_RETRY_DELAY || '1000'),
+            connectTimeout: parseInt(process.env.VOILA_EVENT_REDIS_CONNECT_TIMEOUT || '10000'),
+            commandTimeout: parseInt(process.env.VOILA_EVENT_REDIS_COMMAND_TIMEOUT || '5000'),
+            keyPrefix: process.env.VOILA_EVENT_REDIS_PREFIX || 'events',
+        },
+        // Memory configuration (only used when strategy is 'memory')
+        memory: {
+            maxListeners: parseInt(process.env.VOILA_EVENT_MEMORY_MAX_LISTENERS || '1000'),
+            maxHistory: parseInt(process.env.VOILA_EVENT_MEMORY_HISTORY || '100'),
+            checkInterval: parseInt(process.env.VOILA_EVENT_MEMORY_CHECK_INTERVAL || '30000'), // 30 seconds
+            enableGC: process.env.VOILA_EVENT_MEMORY_GC !== 'false',
+        },
+        // Event history configuration
+        history: {
+            enabled: process.env.VOILA_EVENT_HISTORY_ENABLED !== 'false',
+            maxSize: parseInt(process.env.VOILA_EVENT_HISTORY_SIZE || (isProduction ? '50' : '100')),
+        },
+        // Environment information
+        environment: {
+            isDevelopment,
+            isProduction,
+            isTest,
+            nodeEnv,
+        },
+    };
+}
+/**
+ * Auto-detect event strategy from environment variables
+ * @llm-rule WHEN: Determining which event strategy to use automatically
+ * @llm-rule AVOID: Manual strategy selection - environment detection handles most cases
+ * @llm-rule NOTE: Priority: REDIS_URL → Redis, no REDIS_URL → Memory (perfect for dev/prod)
+ */
+function detectEventStrategy() {
+    // Explicit override wins (for testing/debugging)
+    const explicit = process.env.VOILA_EVENT_STRATEGY?.toLowerCase();
+    if (explicit === 'redis' || explicit === 'memory') {
+        return explicit;
+    }
+    // Auto-detection logic
+    if (process.env.REDIS_URL) {
+        return 'redis'; // Redis URL available - use distributed events
+    }
+    // Default to memory for development/testing
+    if (process.env.NODE_ENV === 'production') {
+        console.warn('[VoilaJSX AppKit] No REDIS_URL found in production. ' +
+            'Using memory event strategy which will not work across multiple servers. ' +
+            'Set REDIS_URL for distributed events.');
+    }
+    return 'memory'; // Default to memory for single-server setups
+}
+/**
+ * Validates environment variables for event configuration
+ * @llm-rule WHEN: App startup to ensure proper event environment configuration
+ * @llm-rule AVOID: Skipping validation - improper config causes silent event failures
+ * @llm-rule NOTE: Validates Redis URLs, numeric values, and production requirements
+ */
+function validateEnvironment() {
+    // Validate event strategy if explicitly set
+    const strategy = process.env.VOILA_EVENT_STRATEGY;
+    if (strategy && !['redis', 'memory'].includes(strategy.toLowerCase())) {
+        throw new Error(`Invalid VOILA_EVENT_STRATEGY: "${strategy}". Must be "redis" or "memory"`);
+    }
+    // Validate Redis URL if provided
+    const redisUrl = process.env.REDIS_URL;
+    if (redisUrl && !isValidRedisUrl(redisUrl)) {
+        throw new Error(`Invalid REDIS_URL: "${redisUrl}". Must start with redis:// or rediss://`);
+    }
+    // Validate namespace
+    const namespace = process.env.VOILA_EVENT_NAMESPACE;
+    if (namespace && !/^[a-zA-Z0-9_-]+$/.test(namespace)) {
+        throw new Error(`Invalid VOILA_EVENT_NAMESPACE: "${namespace}". Must contain only letters, numbers, underscores, and hyphens`);
+    }
+    // Validate numeric values
+    validateNumericEnv('VOILA_EVENT_REDIS_RETRIES', 0, 10);
+    validateNumericEnv('VOILA_EVENT_REDIS_RETRY_DELAY', 100, 10000);
+    validateNumericEnv('VOILA_EVENT_REDIS_CONNECT_TIMEOUT', 1000, 60000);
+    validateNumericEnv('VOILA_EVENT_REDIS_COMMAND_TIMEOUT', 1000, 30000);
+    validateNumericEnv('VOILA_EVENT_MEMORY_MAX_LISTENERS', 10, 10000);
+    validateNumericEnv('VOILA_EVENT_MEMORY_HISTORY', 10, 1000);
+    validateNumericEnv('VOILA_EVENT_MEMORY_CHECK_INTERVAL', 5000, 300000); // 5s to 5min
+    validateNumericEnv('VOILA_EVENT_HISTORY_SIZE', 1, 1000);
+    // Validate Redis key prefix
+    const keyPrefix = process.env.VOILA_EVENT_REDIS_PREFIX;
+    if (keyPrefix && !/^[a-zA-Z0-9_-]+$/.test(keyPrefix)) {
+        throw new Error(`Invalid VOILA_EVENT_REDIS_PREFIX: "${keyPrefix}". Must contain only letters, numbers, underscores, and hyphens`);
+    }
+    // Production-specific validations
+    const nodeEnv = process.env.NODE_ENV;
+    if (nodeEnv === 'production') {
+        validateProductionConfig();
+    }
+    // Validate NODE_ENV
+    if (nodeEnv && !['development', 'production', 'test', 'staging'].includes(nodeEnv)) {
+        console.warn(`[VoilaJSX AppKit] Unusual NODE_ENV: "${nodeEnv}". ` +
+            `Expected: development, production, test, or staging`);
+    }
+}
+/**
+ * Validates Redis URL format
+ * @llm-rule WHEN: Checking Redis connection string validity
+ * @llm-rule AVOID: Using invalid Redis URLs - causes connection failures
+ */
+function isValidRedisUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return ['redis:', 'rediss:'].includes(parsed.protocol);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validates numeric environment variable within acceptable range
+ * @llm-rule WHEN: Validating event configuration numeric values
+ * @llm-rule AVOID: Using values outside safe ranges - causes performance or memory issues
+ */
+function validateNumericEnv(name, min, max) {
+    const value = process.env[name];
+    if (!value)
+        return;
+    const num = parseInt(value);
+    if (isNaN(num) || num < min || num > max) {
+        throw new Error(`Invalid ${name}: "${value}". Must be a number between ${min} and ${max}`);
+    }
+}
+/**
+ * Validates production event configuration
+ * @llm-rule WHEN: Running in production environment
+ * @llm-rule AVOID: Memory strategy in multi-server production - events won't work across servers
+ */
+function validateProductionConfig() {
+    const strategy = detectEventStrategy();
+    if (strategy === 'memory') {
+        console.warn('[VoilaJSX AppKit] Using memory event strategy in production. ' +
+            'Events will only work within single server instance. ' +
+            'Set REDIS_URL for distributed events across multiple servers.');
+    }
+    // Validate namespace is set in production
+    const namespace = process.env.VOILA_EVENT_NAMESPACE;
+    if (!namespace) {
+        console.warn('[VoilaJSX AppKit] No event namespace configured in production. ' +
+            'Set VOILA_EVENT_NAMESPACE for proper event isolation.');
+    }
+}
+/**
+ * Gets event configuration summary for debugging and health checks
+ * @llm-rule WHEN: Debugging event configuration or building health check endpoints
+ * @llm-rule AVOID: Exposing sensitive connection details - this only shows safe info
+ */
+export function getConfigSummary() {
+    const config = getSmartDefaults();
+    return {
+        strategy: config.strategy,
+        namespace: config.namespace,
+        historyEnabled: config.history.enabled,
+        redisConnected: config.strategy === 'redis' && !!config.redis?.url,
+        environment: config.environment.nodeEnv,
+    };
+}
+/**
+ * Validates that required event configuration is present for production
+ * @llm-rule WHEN: App startup validation for production deployments
+ * @llm-rule AVOID: Skipping validation - missing event config causes runtime issues
+ */
+export function validateProductionRequirements() {
+    const config = getSmartDefaults();
+    if (config.environment.isProduction) {
+        if (config.strategy === 'memory') {
+            console.warn('[VoilaJSX AppKit] Using memory event strategy in production. ' +
+                'Events will not work across multiple server instances. ' +
+                'Set REDIS_URL for distributed events.');
+        }
+        if (config.strategy === 'redis' && !config.redis?.url) {
+            throw new Error('Redis strategy selected but REDIS_URL not configured. ' +
+                'Set REDIS_URL environment variable for Redis events.');
+        }
+    }
+}
+/**
+ * Validates startup configuration and throws detailed errors
+ * @llm-rule WHEN: App startup to ensure event configuration is valid before starting
+ * @llm-rule AVOID: Skipping validation - catches config issues early
+ * @llm-rule NOTE: Comprehensive validation for production readiness
+ */
+export function validateStartupConfiguration() {
+    const warnings = [];
+    const errors = [];
+    try {
+        const config = getSmartDefaults();
+        const strategy = config.strategy;
+        // Strategy-specific validation
+        switch (strategy) {
+            case 'redis':
+                if (!config.redis?.url) {
+                    errors.push('REDIS_URL is required for Redis strategy');
+                }
+                else if (!isValidRedisUrl(config.redis.url)) {
+                    errors.push('REDIS_URL must start with redis:// or rediss://');
+                }
+                break;
+            case 'memory':
+                if (config.environment.isProduction) {
+                    warnings.push('Memory strategy in production - events will not work across servers');
+                }
+                break;
+        }
+        // Namespace validation
+        if (!config.namespace || config.namespace === 'default') {
+            if (config.environment.isProduction) {
+                warnings.push('Using default namespace in production - consider setting VOILA_EVENT_NAMESPACE');
+            }
+        }
+        // Environment-specific warnings
+        if (config.environment.isProduction && strategy === 'memory') {
+            warnings.push('No Redis configured for distributed events in production');
+        }
+        if (config.environment.isDevelopment && strategy === 'redis') {
+            warnings.push('Using Redis in development - memory strategy is faster for local development');
+        }
+        return {
+            strategy,
+            warnings,
+            errors,
+            ready: errors.length === 0,
+        };
+    }
+    catch (error) {
+        errors.push(`Configuration validation failed: ${error.message}`);
+        return {
+            strategy: 'unknown',
+            warnings,
+            errors,
+            ready: false,
+        };
+    }
+}
+/**
+ * Performs comprehensive event system health check
+ * @llm-rule WHEN: Health check endpoints or monitoring systems
+ * @llm-rule AVOID: Running in critical path - this is for monitoring only
+ * @llm-rule NOTE: Returns detailed health status without exposing sensitive data
+ */
+export function performHealthCheck() {
+    const issues = [];
+    let status = 'healthy';
+    try {
+        const validation = validateStartupConfiguration();
+        // Determine overall status
+        if (validation.errors.length > 0) {
+            status = 'error';
+            issues.push(...validation.errors);
+        }
+        else if (validation.warnings.length > 0) {
+            status = 'warning';
+            issues.push(...validation.warnings);
+        }
+        const configured = validation.strategy !== 'memory' ||
+            process.env.NODE_ENV !== 'production';
+        return {
+            status,
+            strategy: validation.strategy,
+            configured,
+            issues,
+            ready: validation.ready,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            strategy: 'unknown',
+            configured: false,
+            issues: [`Health check failed: ${error.message}`],
+            ready: false,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+/**
+ * Gets optimal event configuration for different environments
+ * @llm-rule WHEN: Setting up environment-specific event behavior
+ * @llm-rule AVOID: Manual environment handling - this provides optimal defaults
+ */
+export function getEnvironmentOptimizedConfig() {
+    const config = getSmartDefaults();
+    // Optimize for different environments
+    if (config.environment.isDevelopment) {
+        // Development: More history, frequent GC
+        config.history.maxSize = 100;
+        if (config.memory) {
+            config.memory.checkInterval = 10000; // 10 seconds
+            config.memory.enableGC = true;
+        }
+    }
+    else if (config.environment.isProduction) {
+        // Production: Less history, less frequent GC
+        config.history.maxSize = 50;
+        if (config.memory) {
+            config.memory.checkInterval = 60000; // 1 minute
+            config.memory.enableGC = true;
+        }
+    }
+    else if (config.environment.isTest) {
+        // Test: Minimal history, no GC
+        config.history.maxSize = 10;
+        if (config.memory) {
+            config.memory.checkInterval = 1000; // 1 second
+            config.memory.enableGC = false;
+        }
+    }
+    return config;
+}
+/**
+ * Checks if Redis is available and properly configured
+ * @llm-rule WHEN: Conditional logic based on event capabilities
+ * @llm-rule AVOID: Complex event detection - just use events normally, strategy handles it
+ */
+export function hasRedis() {
+    const redisUrl = process.env.REDIS_URL;
+    return !!(redisUrl && isValidRedisUrl(redisUrl));
+}
+/**
+ * Gets recommended configuration for microservices
+ * @llm-rule WHEN: Setting up events for microservices architecture
+ * @llm-rule AVOID: Default config for microservices - needs specific tuning
+ */
+export function getMicroservicesConfig() {
+    return {
+        strategy: 'redis', // Always use Redis for microservices
+        history: {
+            enabled: true,
+            maxSize: 25, // Less history per service
+        },
+        redis: {
+            url: process.env.REDIS_URL || 'redis://localhost:6379',
+            maxRetries: 5, // More retries for reliability
+            retryDelay: 2000, // Longer delays
+            connectTimeout: 15000, // Longer timeout
+            commandTimeout: 10000, // Longer command timeout
+            keyPrefix: 'microservices:events',
+        },
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/event/defaults.js.map

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

package/dist/event/event.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Core event class with automatic strategy selection and ultra-simple API
+ * @module @bloomneo/appkit/event
+ * @file src/event/event.ts
+ *
+ * @llm-rule WHEN: Building apps that need event-driven architecture with automatic Redis/Memory selection
+ * @llm-rule AVOID: Using directly - always get instance via eventClass.get()
+ * @llm-rule NOTE: Auto-detects Redis vs Memory based on environment variables
+ */
+import type { EventConfig } from './defaults.js';
+export interface EventHandler {
+    (data: any): void | Promise<void>;
+}
+export interface WildcardHandler {
+    (eventName: string, data: any): void | Promise<void>;
+}
+export interface EventHistoryEntry {
+    event: string;
+    data: any;
+    timestamp: string;
+    namespace: string;
+}
+export interface EventStrategy {
+    emit(event: string, data: any): Promise<boolean>;
+    on(event: string, handler: EventHandler): void;
+    once(event: string, handler: EventHandler): void;
+    off(event: string, handler?: EventHandler): void;
+    getListeners(event?: string): any;
+    disconnect(): Promise<void>;
+}
+export interface BatchEvent {
+    event: string;
+    data: any;
+}
+/**
+ * Event class with automatic strategy selection and ultra-simple API
+ */
+export declare class EventClass {
+    config: EventConfig;
+    namespace: string;
+    private strategy;
+    private connected;
+    private eventHistory;
+    private wildcardHandlers;
+    constructor(config: EventConfig, namespace: string);
+    /**
+     * Creates appropriate strategy based on configuration
+     * @llm-rule WHEN: Event initialization - selects Redis or Memory based on environment
+     * @llm-rule AVOID: Manual strategy creation - configuration handles strategy selection
+     */
+    private createStrategy;
+    /**
+     * Connects to event backend with automatic retry logic
+     * @llm-rule WHEN: Event initialization or reconnection after failure
+     * @llm-rule AVOID: Manual connection management - this handles connection state
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnects from event backend gracefully
+     * @llm-rule WHEN: App shutdown or event cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents data loss
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Emits an event with automatic namespacing and history tracking
+     * @llm-rule WHEN: Triggering events in your application
+     * @llm-rule AVOID: Manual event management - this handles namespacing and distribution
+     * @llm-rule NOTE: Automatically adds to history if enabled, handles wildcards
+     */
+    emit(event: string, data?: any): Promise<boolean>;
+    /**
+     * Adds event listener with automatic namespacing and wildcard support
+     * @llm-rule WHEN: Listening to events in your application
+     * @llm-rule AVOID: Manual listener management - this handles namespacing and wildcards
+     * @llm-rule NOTE: Supports wildcard patterns like 'user.*' or 'order.*.completed'
+     */
+    on(event: string, handler: EventHandler | WildcardHandler): void;
+    /**
+     * Adds one-time event listener with automatic cleanup
+     * @llm-rule WHEN: Listening to events that should only fire once
+     * @llm-rule AVOID: Manual cleanup - this handles removal after first trigger
+     */
+    once(event: string, handler: EventHandler): void;
+    /**
+     * Removes event listener(s)
+     * @llm-rule WHEN: Cleaning up event listeners to prevent memory leaks
+     * @llm-rule AVOID: Forgetting to remove listeners - causes memory leaks over time
+     */
+    off(event: string, handler?: EventHandler | WildcardHandler): void;
+    /**
+     * Emits multiple events efficiently (batch operation)
+     * @llm-rule WHEN: Emitting multiple events like bulk notifications or data sync
+     * @llm-rule AVOID: Multiple individual emit() calls - this handles batching efficiently
+     */
+    emitBatch(events: BatchEvent[]): Promise<boolean[]>;
+    /**
+     * Gets event history for debugging and replay
+     * @llm-rule WHEN: Debugging event flow or implementing event replay functionality
+     * @llm-rule AVOID: Using for business logic - history is for debugging and replay only
+     */
+    history(event?: string, limit?: number): Promise<EventHistoryEntry[]>;
+    /**
+     * Gets current event listeners for debugging
+     * @llm-rule WHEN: Debugging event listeners or building admin interfaces
+     * @llm-rule AVOID: Using for business logic - this is for debugging only
+     */
+    getListeners(event?: string): any;
+    /**
+     * Gets current event strategy name for debugging
+     * @llm-rule WHEN: Debugging or health checks to see which strategy is active
+     * @llm-rule AVOID: Using for application logic - events should be transparent
+     */
+    getStrategy(): string;
+    /**
+     * Gets event configuration summary for debugging
+     * @llm-rule WHEN: Health checks or debugging event configuration
+     * @llm-rule AVOID: Exposing sensitive details - this only shows safe info
+     */
+    getConfig(): {
+        strategy: string;
+        namespace: string;
+        historyEnabled: boolean;
+        historySize: number;
+        connected: boolean;
+    };
+    /**
+     * Ensures event system is connected before operations
+     */
+    private ensureConnected;
+    /**
+     * Builds namespaced event name
+     */
+    private buildEventName;
+    /**
+     * Validates event name format
+     */
+    private validateEventName;
+    /**
+     * Validates event handler function
+     */
+    private validateHandler;
+    /**
+     * Checks if event name is a wildcard pattern
+     */
+    private isWildcardPattern;
+    /**
+     * Adds wildcard handler
+     */
+    private addWildcardHandler;
+    /**
+     * Removes wildcard handler
+     */
+    private removeWildcardHandler;
+    /**
+     * Handles wildcard pattern matching for emitted events
+     */
+    private handleWildcardEmit;
+    /**
+     * Checks if event matches wildcard pattern
+     */
+    private matchesWildcard;
+    /**
+     * Adds event to history with size management
+     */
+    private addToHistory;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/event/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/event/event.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACjD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACX;AAED;;GAEG;AACH,qBAAa,UAAU;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,gBAAgB,CAAwC;gBAEpD,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;IAMlD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B3D;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,eAAe,GAAG,IAAI;IAYhE;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAiBhD;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,eAAe,GAAG,IAAI;IAelE;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA8BzD;;;;OAIG;IACG,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsB3E;;;;OAIG;IACH,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG;IAiBjC;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,SAAS,IAAI;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,OAAO,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB;IAYD;;OAEG;YACW,eAAe;IAM7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}