@elsikora/commitizen-plugin-commitlint-ai 1.1.0 → 2.0.0-dev.1

package/dist/cjs/infrastructure/service/node-command.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-command.service.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/service/node-command.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAgBhG;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACzD,iDAAiD;IACjD,QAAQ,CAAC,qBAAqB,EAAE,oBAAoB,CAAC;IAErD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuF;gBAEtG,mBAAmB,EAAE,oBAAoB;IAIrD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYzD;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAmD9B;;;;;OAKG;YACW,uBAAuB;CAuCrC"}

package/dist/cjs/infrastructure/service/node-command.service.js

@@ -0,0 +1,152 @@
+'use strict';
+
+var node_child_process = require('node:child_process');
+var node_util = require('node:util');
+var chalk = require('chalk');
+
+/**
+ * Implementation of the command service using Node.js child_process.
+ * Provides functionality to execute shell commands.
+ */
+class NodeCommandService {
+    /** CLI interface service for user interaction */
+    CLI_INTERFACE_SERVICE;
+    /**
+     * Promisified version of the exec function from child_process.
+     * Allows for async/await usage of command execution.
+     */
+    EXEC_ASYNC = node_util.promisify(node_child_process.exec);
+    constructor(cliInterfaceService) {
+        this.CLI_INTERFACE_SERVICE = cliInterfaceService;
+    }
+    /**
+     * Executes a shell command.
+     * @param command - The shell command to execute
+     * @returns Promise that resolves when the command completes successfully
+     * @throws Will throw an error if the command execution fails, except for npm install which offers retry options
+     */
+    async execute(command) {
+        try {
+            await this.EXEC_ASYNC(command);
+        }
+        catch (error) {
+            // Check if the failed command is npm
+            if (command.trim().startsWith("npm install") || command.trim().startsWith("npm ci") || command.trim().startsWith("npm update") || command.trim().startsWith("npm uninstall")) {
+                this.formatAndParseNpmError(command, error);
+                await this.handleNpmInstallFailure(command);
+            }
+            else {
+                // For non-npm commands, throw the error as before
+                throw error;
+            }
+        }
+    }
+    /**
+     * Execute a command and return its output
+     * @param command - The command to execute
+     * @returns Promise that resolves to the command output
+     */
+    async executeWithOutput(command) {
+        try {
+            const { stdout } = await this.EXEC_ASYNC(command);
+            return stdout.trim();
+        }
+        catch (error) {
+            this.CLI_INTERFACE_SERVICE.handleError(`Failed to execute command: ${command}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Formate and parse npm error to readable format
+     * @param command - The original npm command that failed
+     * @param error - Error npm object
+     * @returns void
+     */
+    formatAndParseNpmError(command, error) {
+        // Форматируем и выводим ошибку
+        console.error(chalk.red.bold("🚨 NPM Command Failed"));
+        console.error(chalk.gray(`Command: ${command}`));
+        console.error(chalk.red("Error Details:"));
+        // Парсим stderr для структурированного вывода
+        if (error.stderr) {
+            const lines = error.stderr.split("\n").filter((line) => line.trim());
+            let errorCode = null;
+            const conflictDetails = [];
+            let resolutionAdvice = null;
+            let logFile = null;
+            for (const line of lines) {
+                if (line.includes("npm error code")) {
+                    errorCode = line.replace("npm error code", "").trim();
+                }
+                else if (line.includes("While resolving") || line.includes("Found") || line.includes("Could not resolve dependency") || line.includes("Conflicting peer dependency")) {
+                    conflictDetails.push(line.replace("npm error", "").trim());
+                }
+                else if (line.includes("Fix the upstream dependency conflict") || line.includes("--force") || line.includes("--legacy-peer-deps")) {
+                    resolutionAdvice = line.replace("npm error", "").trim();
+                }
+                else if (line.includes("A complete log of this run can be found in")) {
+                    logFile = line.replace("npm error", "").trim();
+                }
+            }
+            // Выводим структурированную ошибку
+            if (errorCode) {
+                console.error(chalk.red(`  Code: ${errorCode}`));
+            }
+            if (conflictDetails.length > 0) {
+                console.error(chalk.yellow("  Dependency Conflict:"));
+                for (const detail of conflictDetails)
+                    console.error(chalk.yellow(`    - ${detail}`));
+            }
+            if (resolutionAdvice) {
+                console.error(chalk.cyan("  Resolution:"));
+                console.error(chalk.cyan(`    ${resolutionAdvice}`));
+            }
+            if (logFile) {
+                console.error(chalk.gray(`  Log File: ${logFile}`));
+            }
+        }
+        else {
+            // Если stderr пустой, выводим общую информацию об ошибке
+            console.error(chalk.red("Unknown error occurred"));
+        }
+    }
+    /**
+     * Handles npm install command failures by offering retry options to the user.
+     * @param originalCommand - The original npm command that failed
+     * @returns Promise that resolves when the chosen action completes
+     * @throws Will throw an error if the user chooses to cancel or if retried command still fails
+     */
+    async handleNpmInstallFailure(originalCommand) {
+        this.CLI_INTERFACE_SERVICE.warn("npm command exection failed.");
+        const options = [
+            { label: "Retry with --force", value: "force" },
+            { label: "Retry with --legacy-peer-deps", value: "legacy-peer-deps" },
+            { label: "Cancel command execution", value: "cancel" },
+        ];
+        const choice = await this.CLI_INTERFACE_SERVICE.select("How would you like to proceed?", options);
+        switch (choice) {
+            case "force": {
+                this.CLI_INTERFACE_SERVICE.info("Retrying with --force flag...");
+                await this.EXEC_ASYNC(`${originalCommand} --force`);
+                this.CLI_INTERFACE_SERVICE.success("Execution completed with --force flag.");
+                break;
+            }
+            case "legacy-peer-deps": {
+                this.CLI_INTERFACE_SERVICE.info("Retrying with --legacy-peer-deps flag...");
+                await this.EXEC_ASYNC(`${originalCommand} --legacy-peer-deps`);
+                this.CLI_INTERFACE_SERVICE.success("Execution completed with --legacy-peer-deps flag.");
+                break;
+            }
+            case "cancel": {
+                this.CLI_INTERFACE_SERVICE.info("Execution cancelled by user.");
+                throw new Error("npm command execution was cancelled by user.");
+            }
+            default: {
+                throw new Error("Invalid option selected.");
+            }
+        }
+    }
+}
+
+exports.NodeCommandService = NodeCommandService;
+//# sourceMappingURL=node-command.service.js.map

package/dist/cjs/infrastructure/service/node-command.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-command.service.js","sources":["../../../../../src/infrastructure/service/node-command.service.ts"],"sourcesContent":[null],"names":["promisify","exec"],"mappings":"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"}

package/dist/cjs/infrastructure/service/node-file-system.service.d.ts

@@ -0,0 +1,63 @@
+import type { IFileSystemService } from "../../application/interface/file-system-service.interface.js";
+/**
+ * Implementation of the file system service using Node.js fs/promises API.
+ * Provides methods for managing files and directories.
+ */
+export declare class NodeFileSystemService implements IFileSystemService {
+    /**
+     * Creates a directory at the specified path.
+     * @param directoryPath - The path to the directory to create
+     * @param options - Optional configuration for directory creation
+     * @param options.isRecursive - Whether to create parent directories if they don't exist
+     * @returns Promise that resolves when the directory is created
+     */
+    createDirectory(directoryPath: string, options?: {
+        isRecursive: boolean;
+    }): Promise<void>;
+    /**
+     * Deletes a file at the specified path.
+     * @param filePath - The path to the file to delete
+     * @returns Promise that resolves when the file is deleted
+     */
+    deleteFile(filePath: string): Promise<void>;
+    /**
+     * Gets the directory name from a file path.
+     * @param filePath
+     * @returns The directory name
+     */
+    getDirectoryNameFromFilePath(filePath: string): string;
+    /**
+     * Gets the extension from a file path.
+     * @param filePath
+     * @returns The file extension
+     */
+    getExtensionFromFilePath(filePath: string): string;
+    /**
+     * Checks if any of the provided paths exist and returns the first existing path.
+     * @param paths - Array of paths to check
+     * @returns Promise that resolves to the first existing path or undefined if none exist
+     */
+    isOneOfPathsExists(paths: Array<string>): Promise<string | undefined>;
+    /**
+     * Checks if a file or directory exists at the specified path.
+     * @param filePath - The path to check
+     * @returns Promise that resolves to true if the path exists, false otherwise
+     */
+    isPathExists(filePath: string): Promise<boolean>;
+    /**
+     * Reads the contents of a file.
+     * @param filePath - The path to the file to read
+     * @param encoding - The encoding to use when reading the file, defaults to "utf8"
+     * @returns Promise that resolves to the file contents as a string
+     */
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Writes content to a file, creating the file and parent directories if they don't exist.
+     * @param filePath - The path to the file to write
+     * @param content - The content to write to the file
+     * @param encoding - The encoding to use when writing the file, defaults to "utf8"
+     * @returns Promise that resolves when the file is written
+     */
+    writeFile(filePath: string, content: string, encoding?: BufferEncoding): Promise<void>;
+}
+//# sourceMappingURL=node-file-system.service.d.ts.map

package/dist/cjs/infrastructure/service/node-file-system.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-file-system.service.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/service/node-file-system.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AAKvG;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC/D;;;;;;OAMG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/F;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;OAIG;IACH,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAItD;;;;OAIG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIlD;;;;OAIG;IACG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAc3E;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtD;;;;;OAKG;IAEG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpF;;;;;;OAMG;IAEG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKpG"}

package/dist/cjs/infrastructure/service/node-file-system.service.js

@@ -0,0 +1,102 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+var path = require('node:path');
+
+/**
+ * Implementation of the file system service using Node.js fs/promises API.
+ * Provides methods for managing files and directories.
+ */
+class NodeFileSystemService {
+    /**
+     * Creates a directory at the specified path.
+     * @param directoryPath - The path to the directory to create
+     * @param options - Optional configuration for directory creation
+     * @param options.isRecursive - Whether to create parent directories if they don't exist
+     * @returns Promise that resolves when the directory is created
+     */
+    async createDirectory(directoryPath, options) {
+        directoryPath = path.dirname(directoryPath);
+        // eslint-disable-next-line @elsikora/typescript/naming-convention
+        await fs.mkdir(directoryPath, { recursive: options?.isRecursive });
+    }
+    /**
+     * Deletes a file at the specified path.
+     * @param filePath - The path to the file to delete
+     * @returns Promise that resolves when the file is deleted
+     */
+    async deleteFile(filePath) {
+        await fs.unlink(filePath);
+    }
+    /**
+     * Gets the directory name from a file path.
+     * @param filePath
+     * @returns The directory name
+     */
+    getDirectoryNameFromFilePath(filePath) {
+        return path.dirname(filePath);
+    }
+    /**
+     * Gets the extension from a file path.
+     * @param filePath
+     * @returns The file extension
+     */
+    getExtensionFromFilePath(filePath) {
+        return path.extname(filePath);
+    }
+    /**
+     * Checks if any of the provided paths exist and returns the first existing path.
+     * @param paths - Array of paths to check
+     * @returns Promise that resolves to the first existing path or undefined if none exist
+     */
+    async isOneOfPathsExists(paths) {
+        let existingFilePath = undefined;
+        for (const path of paths) {
+            if (await this.isPathExists(path)) {
+                existingFilePath = path;
+                break;
+            }
+        }
+        return existingFilePath;
+    }
+    /**
+     * Checks if a file or directory exists at the specified path.
+     * @param filePath - The path to check
+     * @returns Promise that resolves to true if the path exists, false otherwise
+     */
+    async isPathExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Reads the contents of a file.
+     * @param filePath - The path to the file to read
+     * @param encoding - The encoding to use when reading the file, defaults to "utf8"
+     * @returns Promise that resolves to the file contents as a string
+     */
+    // eslint-disable-next-line @elsikora/javascript/no-undef
+    async readFile(filePath, encoding = "utf8") {
+        return await fs.readFile(filePath, { encoding });
+    }
+    /**
+     * Writes content to a file, creating the file and parent directories if they don't exist.
+     * @param filePath - The path to the file to write
+     * @param content - The content to write to the file
+     * @param encoding - The encoding to use when writing the file, defaults to "utf8"
+     * @returns Promise that resolves when the file is written
+     */
+    // eslint-disable-next-line @elsikora/javascript/no-undef
+    async writeFile(filePath, content, encoding = "utf8") {
+        // eslint-disable-next-line @elsikora/typescript/naming-convention
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content, { encoding });
+    }
+}
+
+exports.NodeFileSystemService = NodeFileSystemService;
+//# sourceMappingURL=node-file-system.service.js.map

package/dist/cjs/infrastructure/service/node-file-system.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-file-system.service.js","sources":["../../../../../src/infrastructure/service/node-file-system.service.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAKA;;;AAGG;MACU,qBAAqB,CAAA;AACjC;;;;;;AAMG;AACH,IAAA,MAAM,eAAe,CAAC,aAAqB,EAAE,OAAkC,EAAA;AAC9E,QAAA,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;;AAE3C,QAAA,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;;AAGnE;;;;AAIG;IACH,MAAM,UAAU,CAAC,QAAgB,EAAA;AAChC,QAAA,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;;AAG1B;;;;AAIG;AACH,IAAA,4BAA4B,CAAC,QAAgB,EAAA;AAC5C,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;;AAG9B;;;;AAIG;AACH,IAAA,wBAAwB,CAAC,QAAgB,EAAA;AACxC,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;;AAG9B;;;;AAIG;IACH,MAAM,kBAAkB,CAAC,KAAoB,EAAA;QAC5C,IAAI,gBAAgB,GAAuB,SAAS;AAEpD,QAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACzB,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;gBAClC,gBAAgB,GAAG,IAAI;gBAEvB;;;AAIF,QAAA,OAAO,gBAAgB;;AAGxB;;;;AAIG;IACH,MAAM,YAAY,CAAC,QAAgB,EAAA;AAClC,QAAA,IAAI;AACH,YAAA,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;AAEzB,YAAA,OAAO,IAAI;;AACV,QAAA,MAAM;AACP,YAAA,OAAO,KAAK;;;AAId;;;;;AAKG;;AAEH,IAAA,MAAM,QAAQ,CAAC,QAAgB,EAAE,WAA2B,MAAM,EAAA;QACjE,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC;;AAGjD;;;;;;AAMG;;IAEH,MAAM,SAAS,CAAC,QAAgB,EAAE,OAAe,EAAE,WAA2B,MAAM,EAAA;;AAEnF,QAAA,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC3D,QAAA,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC;;AAEpD;;;;"}

package/dist/cjs/infrastructure/service/prompts-cli-interface.service.d.ts

@@ -0,0 +1,115 @@
+import type { ICliInterfaceServiceSelectOptions } from "../../application/interface/cli-interface-service-select-options.interface.js";
+import type { ICliInterfaceService } from "../../application/interface/cli-interface-service.interface.js";
+/**
+ * Implementation of the CLI interface service using the prompts library.
+ * Provides methods for interacting with the user through the command line.
+ */
+export declare class PromptsCliInterface implements ICliInterfaceService {
+    /** Reference to the active spinner instance */
+    private spinner;
+    /**
+     * Initializes a new instance of the PromptsCliInterface.
+     * Sets up the spinner for providing visual feedback during operations.
+     */
+    constructor();
+    /**
+     * Clears the console screen.
+     */
+    clear(): void;
+    /**
+     * Displays a confirmation prompt to the user.
+     * @param message - The message to display to the user
+     * @param isConfirmedByDefault - The default value for the confirmation, defaults to false
+     * @returns Promise that resolves to the user's response (true for confirmed, false for declined)
+     */
+    confirm(message: string, isConfirmedByDefault?: boolean): Promise<boolean>;
+    /**
+     * Displays an error message to the user.
+     * @param message - The error message to display
+     */
+    error(message: string): void;
+    /**
+     * Displays a grouped multi-select prompt to the user.
+     * @param message - The message to display to the user
+     * @param options - Record of groups and their options
+     * @param isRequired - Whether a selection is required, defaults to false
+     * @param initialValues - Initial selected values
+     * @returns Promise that resolves to an array of selected values
+     */
+    groupMultiselect<T>(message: string, options: Record<string, Array<ICliInterfaceServiceSelectOptions>>, isRequired?: boolean, initialValues?: Array<string>): Promise<Array<T>>;
+    /**
+     * Handles and displays an error message with additional error details.
+     * @param message - The error message to display
+     * @param error - The error object or details
+     */
+    handleError(message: string, error: unknown): void;
+    /**
+     * Displays an informational message to the user.
+     * @param message - The info message to display
+     */
+    info(message: string): void;
+    /**
+     * Displays a standard message to the user.
+     * @param message - The message to display
+     */
+    log(message: string): void;
+    /**
+     * Displays a multi-select prompt to the user.
+     * @param message - The message to display to the user
+     * @param options - Array of options to select from
+     * @param isRequired - Whether a selection is required, defaults to false
+     * @param initialValues - Initial selected values
+     * @returns Promise that resolves to an array of selected values
+     */
+    multiselect<T>(message: string, options: Array<ICliInterfaceServiceSelectOptions>, isRequired?: boolean, initialValues?: Array<string>): Promise<Array<T>>;
+    /**
+     * Displays a note to the user with a title and message.
+     * @param title - The title of the note
+     * @param message - The message content of the note
+     */
+    note(title: string, message: string): void;
+    /**
+     * Displays a single select prompt to the user.
+     * @param message - The message to display to the user
+     * @param options - Array of options to select from
+     * @param initialValue - Initial selected value
+     * @returns Promise that resolves to the selected value
+     */
+    select<T>(message: string, options: Array<ICliInterfaceServiceSelectOptions>, initialValue?: string): Promise<T>;
+    /**
+     * Starts a spinner with the specified message.
+     * Stops any existing spinner first.
+     * @param message - The message to display while the spinner is active
+     */
+    startSpinner(message: string): void;
+    /**
+     * Stops the current spinner with an optional completion message.
+     * @param message - Optional message to display when the spinner stops
+     */
+    stopSpinner(message?: string): void;
+    /**
+     * Displays a success message to the user.
+     * @param message - The success message to display
+     */
+    success(message: string): void;
+    /**
+     * Displays a text input prompt to the user.
+     * @param message - The message to display to the user
+     * @param placeholder - Optional placeholder text for the input field
+     * @param initialValue - Optional initial value for the input field
+     * @param validate - Optional validation function for the input
+     * @returns Promise that resolves to the user's input text
+     */
+    text(message: string, _placeholder?: string, initialValue?: string, validate?: (value: string) => Error | string | undefined): Promise<string>;
+    /**
+     * Update the spinner message without stopping it.
+     * @param message - The new message to display
+     */
+    updateSpinner(message: string): void;
+    /**
+     * Displays a warning message to the user.
+     * @param message - The warning message to display
+     */
+    warn(message: string): void;
+}
+//# sourceMappingURL=prompts-cli-interface.service.d.ts.map

package/dist/cjs/infrastructure/service/prompts-cli-interface.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts-cli-interface.service.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/service/prompts-cli-interface.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,+EAA+E,CAAC;AACvI,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAC;AAc3G;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC/D,+CAA+C;IAE/C,OAAO,CAAC,OAAO,CAAW;IAE1B;;;OAGG;;IAKH;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBvF;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;;;;;;OAOG;IACG,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,iCAAiC,CAAC,CAAC,EAAE,UAAU,GAAE,OAAe,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAuC5L;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKlD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1B;;;;;;;OAOG;IACG,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,iCAAiC,CAAC,EAAE,UAAU,GAAE,OAAe,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAiCvK;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiC1C;;;;;;OAMG;IACG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,iCAAiC,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BtH;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC;;;OAGG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQnC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAsCpJ;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMpC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3B"}