@masuidrive/procman 0.1.0

package/dist/src/cli/signal-handler.js

@@ -0,0 +1,129 @@
+/**
+ * CLI Signal Handler - CLIプロセスのシグナル処理専門クラス
+ *
+ * t_wadaとUncle Bobの教えに従い、Single Responsibility Principleを適用。
+ * CLIプロセスのグレースフルシャットダウンを管理する。
+ */
+/**
+ * CLI Signal Handler
+ *
+ * CLIプロセスのシグナル処理を管理し、適切なクリーンアップを実行する。
+ * デーモンのSignalHandlerとは異なり、CLIの短期実行プロセスに特化。
+ */
+export class CLISignalHandler {
+    isShuttingDown = false;
+    forceExitTimeout;
+    asyncCleanupFn;
+    sigintHandler;
+    sigtermHandler;
+    /**
+     * Setup signal handlers with optional cleanup function
+     * @param asyncCleanup - Optional async cleanup function to call before exit
+     */
+    setup(asyncCleanup) {
+        this.asyncCleanupFn = asyncCleanup;
+        this.setupSignalHandlers();
+    }
+    /**
+     * Clean up signal handlers and timeouts
+     */
+    cleanup() {
+        // Remove signal listeners
+        if (this.sigintHandler) {
+            process.removeListener('SIGINT', this.sigintHandler);
+            this.sigintHandler = undefined;
+        }
+        if (this.sigtermHandler) {
+            process.removeListener('SIGTERM', this.sigtermHandler);
+            this.sigtermHandler = undefined;
+        }
+        // Clear timeout
+        if (this.forceExitTimeout) {
+            clearTimeout(this.forceExitTimeout);
+            this.forceExitTimeout = undefined;
+        }
+    }
+    /**
+     * Check if currently shutting down
+     */
+    isShutdownInProgress() {
+        return this.isShuttingDown;
+    }
+    /**
+     * Setup SIGINT and SIGTERM handlers
+     */
+    setupSignalHandlers() {
+        const handleSignal = async (signal) => {
+            if (this.isShuttingDown) {
+                // Already shutting down, ignore subsequent signals
+                return;
+            }
+            this.isShuttingDown = true;
+            console.log(`\\nReceived ${signal}, shutting down...`);
+            // Set force exit timeout (CLI should exit quickly)
+            this.forceExitTimeout = setTimeout(() => {
+                console.error('CLI cleanup timeout exceeded, forcing exit...');
+                process.exit(1);
+            }, 2000); // 2 seconds timeout for CLI
+            try {
+                // Execute async cleanup if provided
+                if (this.asyncCleanupFn) {
+                    await this.asyncCleanupFn();
+                }
+                // Clean up signal handlers
+                this.cleanup();
+                // Exit successfully
+                process.exit(0);
+            }
+            catch (error) {
+                console.error('Error during cleanup:', error);
+                this.cleanup();
+                process.exit(1);
+            }
+        };
+        // Setup SIGINT handler (Ctrl+C)
+        this.sigintHandler = () => {
+            handleSignal('SIGINT').catch((error) => {
+                console.error('Error in SIGINT handler:', error);
+                process.exit(1);
+            });
+        };
+        process.on('SIGINT', this.sigintHandler);
+        // Setup SIGTERM handler
+        this.sigtermHandler = () => {
+            handleSignal('SIGTERM').catch((error) => {
+                console.error('Error in SIGTERM handler:', error);
+                process.exit(1);
+            });
+        };
+        process.on('SIGTERM', this.sigtermHandler);
+    }
+}
+// Global instance for CLI signal handling
+let globalCliSignalHandler = null;
+/**
+ * Setup global CLI signal handling
+ * @param asyncCleanup - Optional async cleanup function
+ */
+export function setupGlobalCLISignalHandling(asyncCleanup) {
+    if (!globalCliSignalHandler) {
+        globalCliSignalHandler = new CLISignalHandler();
+    }
+    globalCliSignalHandler.setup(asyncCleanup);
+}
+/**
+ * Cleanup global CLI signal handling
+ */
+export function cleanupGlobalCLISignalHandling() {
+    if (globalCliSignalHandler) {
+        globalCliSignalHandler.cleanup();
+        globalCliSignalHandler = null;
+    }
+}
+/**
+ * Check if global CLI signal handler is shutting down
+ */
+export function isGlobalCLIShuttingDown() {
+    return globalCliSignalHandler?.isShutdownInProgress() ?? false;
+}
+//# sourceMappingURL=signal-handler.js.map

package/dist/src/cli/signal-handler.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * Error handler utilities for CLI
+ *
+ * Provides enhanced error handling with verbose debugging support
+ */
+import { ProcmanError } from '../../shared/errors.js';
+/**
+ * Set verbose mode
+ */
+export declare function setVerboseMode(enabled: boolean): void;
+/**
+ * Get verbose mode status
+ */
+export declare function isVerboseMode(): boolean;
+/**
+ * Format error message with appropriate styling
+ */
+export declare function formatError(error: Error | ProcmanError | unknown): string;
+/**
+ * Get helpful suggestions based on error code
+ */
+export declare function getErrorSuggestion(error: Error | ProcmanError | unknown): string | null;
+/**
+ * Display verbose debug information
+ */
+export declare function displayDebugInfo(context: string, data: unknown): void;
+/**
+ * Handle CLI error and exit
+ */
+export declare function handleCLIError(error: Error | ProcmanError | unknown, context?: string, exitCode?: number): void;
+/**
+ * Check daemon connectivity and provide helpful message
+ */
+export declare function checkDaemonConnectivity(): Promise<boolean>;
+/**
+ * Wrap async function with error handling
+ */
+export declare function wrapWithErrorHandler<T extends Array<unknown>>(fn: (...args: T) => Promise<void>, context: string): (...args: T) => Promise<void>;
+//# sourceMappingURL=error-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EAGb,MAAM,wBAAwB,CAAC;AAShC;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CASzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,GACpC,MAAM,GAAG,IAAI,CAgEf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CA4CrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,EACrC,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,SAAI,GACX,IAAI,CA0BN;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAkBhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,EAC3D,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ/B"}

package/dist/src/cli/utils/error-handler.js

@@ -0,0 +1,200 @@
+/**
+ * Error handler utilities for CLI
+ *
+ * Provides enhanced error handling with verbose debugging support
+ */
+import chalk from 'chalk';
+import { ProcmanError, ERROR_MESSAGES, } from '../../shared/errors.js';
+import * as fs from 'fs';
+import * as os from 'os';
+/**
+ * Global verbose flag
+ */
+let verboseMode = false;
+/**
+ * Set verbose mode
+ */
+export function setVerboseMode(enabled) {
+    verboseMode = enabled;
+}
+/**
+ * Get verbose mode status
+ */
+export function isVerboseMode() {
+    return verboseMode;
+}
+/**
+ * Format error message with appropriate styling
+ */
+export function formatError(error) {
+    if (error instanceof ProcmanError) {
+        const message = ERROR_MESSAGES[error.code] || error.message;
+        return `${chalk.red('Error:')} [${error.code}] ${message}`;
+    }
+    else if (error instanceof Error) {
+        return `${chalk.red('Error:')} ${error.message}`;
+    }
+    else {
+        return `${chalk.red('Error:')} ${String(error)}`;
+    }
+}
+/**
+ * Get helpful suggestions based on error code
+ */
+export function getErrorSuggestion(error) {
+    if (!(error instanceof ProcmanError)) {
+        if (error instanceof Error) {
+            // Check for common Node.js errors
+            if (error.message.includes('ENOENT')) {
+                return 'File or directory not found. Check the path and try again.';
+            }
+            else if (error.message.includes('EACCES') ||
+                error.message.includes('EPERM')) {
+                return 'Permission denied. Try running with appropriate permissions or check file ownership.';
+            }
+            else if (error.message.includes('EADDRINUSE')) {
+                return 'Port or socket already in use. Check if another instance is running.';
+            }
+            else if (error.message.includes('ECONNREFUSED')) {
+                return 'Connection refused. Make sure the daemon is running: procman load <config>';
+            }
+        }
+        return null;
+    }
+    switch (error.code) {
+        case 'DAEMON_NOT_RUNNING':
+            return `The daemon is not running. Start it with: ${chalk.cyan('procman load <config-file>')}`;
+        case 'DAEMON_ALREADY_RUNNING':
+            return `A daemon is already running. Stop it first with: ${chalk.cyan('procman exit')}`;
+        case 'CONFIG_NOT_FOUND':
+            return 'Configuration file not found. Check the file path and ensure it exists.';
+        case 'CONFIG_INVALID':
+            return 'Invalid configuration format. Check the configuration syntax and required fields.';
+        case 'PROCESS_NOT_FOUND':
+            return `Process not found. List available processes with: ${chalk.cyan('procman list')}`;
+        case 'PROCESS_ALREADY_RUNNING':
+            return 'Process is already running. No action needed.';
+        case 'PROCESS_NOT_RUNNING':
+            return 'Process is not running. Start it first before attempting this operation.';
+        case 'PERMISSION_DENIED':
+            if (os.platform() === 'win32') {
+                return 'Permission denied. Check Named Pipe permissions in Windows.';
+            }
+            else {
+                return `Permission denied. Check socket permissions at ${chalk.yellow('/tmp/.procman.sock')}`;
+            }
+        case 'IPC_CONNECTION_FAILED':
+            return 'Failed to connect to daemon. Ensure the daemon is running and accessible.';
+        case 'IPC_TIMEOUT':
+            return 'Connection timed out. The daemon might be overloaded or not responding.';
+        case 'MEMORY_LIMIT_EXCEEDED':
+            return 'Process exceeded memory limit. Increase max_memory_restart in config or optimize the application.';
+        case 'VALIDATION_ERROR':
+            return 'Invalid input. Check command syntax and required parameters.';
+        default:
+            return null;
+    }
+}
+/**
+ * Display verbose debug information
+ */
+export function displayDebugInfo(context, data) {
+    if (!verboseMode)
+        return;
+    console.log(chalk.gray('\n--- Debug Information ---'));
+    console.log(chalk.gray(`Context: ${context}`));
+    console.log(chalk.gray(`Timestamp: ${new Date().toISOString()}`));
+    if (data instanceof Error) {
+        console.log(chalk.gray('Error Type:'), data.constructor.name);
+        console.log(chalk.gray('Message:'), data.message);
+        if (data.stack) {
+            console.log(chalk.gray('Stack Trace:'));
+            const stackLines = data.stack.split('\n').slice(1, 6); // Show first 5 stack frames
+            for (const line of stackLines) {
+                console.log(chalk.gray(line));
+            }
+        }
+    }
+    else if (typeof data === 'object' && data !== null) {
+        console.log(chalk.gray('Data:'), JSON.stringify(data, null, 2));
+    }
+    else {
+        console.log(chalk.gray('Data:'), data);
+    }
+    // System information
+    console.log(chalk.gray('\n--- System Information ---'));
+    console.log(chalk.gray('Platform:'), os.platform());
+    console.log(chalk.gray('Node Version:'), process.version);
+    console.log(chalk.gray('Working Directory:'), process.cwd());
+    // Check daemon status
+    const socketPath = os.platform() === 'win32' ? '\\\\.\\pipe\\procman' : '/tmp/.procman.sock';
+    if (os.platform() !== 'win32') {
+        try {
+            const stats = fs.statSync(socketPath);
+            console.log(chalk.gray('Socket Exists:'), 'Yes');
+            console.log(chalk.gray('Socket Mode:'), stats.mode.toString(8));
+        }
+        catch {
+            console.log(chalk.gray('Socket Exists:'), 'No');
+        }
+    }
+    console.log(chalk.gray('-------------------------\n'));
+}
+/**
+ * Handle CLI error and exit
+ */
+export function handleCLIError(error, context, exitCode = 1) {
+    // Display main error
+    console.error(formatError(error));
+    // Display suggestion if available
+    const suggestion = getErrorSuggestion(error);
+    if (suggestion) {
+        console.log(chalk.yellow('\n💡 Suggestion:'), suggestion);
+    }
+    // Display debug information in verbose mode
+    if (verboseMode && context) {
+        displayDebugInfo(context, error);
+    }
+    else if (verboseMode) {
+        displayDebugInfo('Unknown Context', error);
+    }
+    // Suggest using verbose mode if not enabled
+    if (!verboseMode) {
+        console.log(chalk.gray('\nFor more details, run the command with'), chalk.cyan('--verbose'));
+    }
+    process.exit(exitCode);
+}
+/**
+ * Check daemon connectivity and provide helpful message
+ */
+export async function checkDaemonConnectivity() {
+    const socketPath = os.platform() === 'win32' ? '\\\\.\\pipe\\procman' : '/tmp/.procman.sock';
+    if (os.platform() !== 'win32') {
+        try {
+            fs.accessSync(socketPath, fs.constants.R_OK | fs.constants.W_OK);
+            return true;
+        }
+        catch (error) {
+            if (verboseMode) {
+                displayDebugInfo('Daemon Connectivity Check', error);
+            }
+            return false;
+        }
+    }
+    // For Windows, we'll assume it's accessible if we can't check
+    return true;
+}
+/**
+ * Wrap async function with error handling
+ */
+export function wrapWithErrorHandler(fn, context) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (error) {
+            handleCLIError(error, context);
+        }
+    };
+}
+//# sourceMappingURL=error-handler.js.map

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

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

package/dist/src/cli/utils/error-utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Error utilities for CLI commands
+ */
+/**
+ * Handle CLI errors with proper type safety
+ */
+export declare function handleCLIError(error: unknown, defaultMessage?: string): never;
+/**
+ * Extract error message from unknown error
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Type guard for Error objects
+ */
+export declare function isError(error: unknown): error is Error;
+//# sourceMappingURL=error-utils.d.ts.map

package/dist/src/cli/utils/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/error-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,cAAc,SAAsB,GACnC,KAAK,CAeP;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD"}

package/dist/src/cli/utils/error-utils.js

@@ -0,0 +1,48 @@
+/**
+ * Error utilities for CLI commands
+ */
+import chalk from 'chalk';
+/**
+ * Handle CLI errors with proper type safety
+ */
+export function handleCLIError(error, defaultMessage = 'An error occurred') {
+    let errorMessage;
+    if (error instanceof Error) {
+        errorMessage = error.message;
+    }
+    else if (typeof error === 'string') {
+        errorMessage = error;
+    }
+    else if (error && typeof error === 'object' && 'message' in error) {
+        errorMessage = String(error.message);
+    }
+    else {
+        errorMessage = defaultMessage;
+    }
+    console.error(chalk.red('Error:'), errorMessage);
+    process.exit(1);
+}
+/**
+ * Extract error message from unknown error
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    else if (typeof error === 'string') {
+        return error;
+    }
+    else if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    else {
+        return 'Unknown error';
+    }
+}
+/**
+ * Type guard for Error objects
+ */
+export function isError(error) {
+    return error instanceof Error;
+}
+//# sourceMappingURL=error-utils.js.map

package/dist/src/cli/utils/error-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.js","sourceRoot":"","sources":["../../../../src/cli/utils/error-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,cAAc,GAAG,mBAAmB;IAEpC,IAAI,YAAoB,CAAC;IAEzB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,YAAY,GAAG,KAAK,CAAC;IACvB,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACpE,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,cAAc,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACpE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC"}

package/dist/src/cli/utils/ipc-client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * IPC Client Utility for CLI Commands
+ *
+ * Provides a unified interface for CLI commands to communicate with the daemon
+ * through IPC (Inter-Process Communication).
+ */
+import { IPCClientBase } from '../../daemon/ipc-client-base.js';
+import { CommandType, IPCResponse, IPCCommandPayloadMap, ResponseData } from '../../shared/ipc.js';
+/**
+ * CLI IPC Client
+ * Manages IPC connection and communication with the daemon
+ */
+export declare class CLIIPCClient {
+    private client;
+    private isConnected;
+    /**
+     * Connect to the daemon
+     * @param timeout Connection timeout in milliseconds (default: 5000)
+     */
+    connect(timeout?: number): Promise<void>;
+    /**
+     * Send a command to the daemon and wait for response
+     * @param command The command type to send
+     * @param payload The command payload
+     * @returns The response from the daemon
+     */
+    sendCommand<T extends CommandType>(command: T, payload?: IPCCommandPayloadMap[T]): Promise<IPCResponse<ResponseData>>;
+    /**
+     * Disconnect from the daemon
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if client is connected
+     */
+    isClientConnected(): boolean;
+    /**
+     * Get the underlying IPC client for event handling
+     * Used for streaming operations that need direct event access
+     */
+    getInternalClient(): IPCClientBase | null;
+    /**
+     * Handle connection errors
+     */
+    private handleConnectionError;
+    /**
+     * Handle command execution errors
+     */
+    private handleCommandError;
+    /**
+     * Handle error response from daemon
+     */
+    private handleErrorResponse;
+}
+/**
+ * Create a new CLI IPC client instance
+ */
+export declare function createCLIClient(): CLIIPCClient;
+/**
+ * Execute a command with automatic connection management
+ * @param command The command type
+ * @param payload The command payload
+ * @param options Execution options
+ */
+export declare function executeCommand<T extends CommandType>(command: T, payload?: IPCCommandPayloadMap[T], options?: {
+    timeout?: number;
+}): Promise<IPCResponse<ResponseData>>;
+/**
+ * Parse namespace:target format
+ * @param target Target string (e.g., "app:worker")
+ * @returns Parsed namespace and name
+ */
+export declare function parseTarget(target: string): {
+    namespace?: string;
+    name: string;
+};
+/**
+ * Format process info for display
+ */
+export declare function formatProcessInfo(info: any): string;
+//# sourceMappingURL=ipc-client.d.ts.map

package/dist/src/cli/utils/ipc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-client.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/ipc-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EACL,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAS7B;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACG,OAAO,CAAC,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4F5C;;;;;OAKG;IACG,WAAW,CAAC,CAAC,SAAS,WAAW,EACrC,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IA8BrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;OAGG;IACH,iBAAiB,IAAI,aAAa,GAAG,IAAI;IAIzC;;OAEG;IAEH,OAAO,CAAC,qBAAqB;IA4B7B;;OAEG;IAEH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAa5B;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,WAAW,EACxD,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACjC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAmCpC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAMA;AAED;;GAEG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CASnD"}