@angular/cli 22.2.2 → 22.3.0-next.1

package/src/commands/mcp/host.js

@@ -1,270 +0,0 @@
-"use strict";
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocalWorkspaceHost = exports.CommandError = void 0;
-exports.createRootRestrictedHost = createRootRestrictedHost;
-exports.processStreamLines = processStreamLines;
-/**
- * @fileoverview
- * This file defines an abstraction layer for operating-system or file-system operations, such as
- * command execution. This allows for easier testing by enabling the injection of mock or
- * test-specific implementations.
- */
-const fs_1 = require("fs");
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = require("node:fs");
-const promises_1 = require("node:fs/promises");
-const node_module_1 = require("node:module");
-const node_net_1 = require("node:net");
-const node_path_1 = require("node:path");
-const node_readline_1 = require("node:readline");
-const node_util_1 = require("node:util");
-/**
- * An error thrown when a command fails to execute.
- */
-class CommandError extends Error {
-    logs;
-    code;
-    constructor(message, logs, code) {
-        super(message);
-        this.logs = logs;
-        this.code = code;
-    }
-}
-exports.CommandError = CommandError;
-function resolveNgCommand(args, cwd) {
-    const defaultCommand = { command: 'ng', args };
-    if (!cwd) {
-        return defaultCommand;
-    }
-    try {
-        const workspaceRequire = (0, node_module_1.createRequire)((0, node_path_1.join)(cwd, 'package.json'));
-        const pkgJsonPath = workspaceRequire.resolve('@angular/cli/package.json');
-        const pkgJson = workspaceRequire(pkgJsonPath);
-        const binPath = typeof pkgJson.bin === 'string' ? pkgJson.bin : pkgJson.bin?.['ng'];
-        if (binPath) {
-            const ngJsPath = (0, node_path_1.resolve)((0, node_path_1.dirname)(pkgJsonPath), binPath);
-            return {
-                command: process.execPath,
-                args: [ngJsPath, ...args],
-            };
-        }
-    }
-    catch {
-        // Failed to resolve the CLI binary, fall back to assuming `ng` is on PATH.
-    }
-    return defaultCommand;
-}
-/**
- * A concrete implementation of the `Host` interface that runs on a local workspace.
- */
-exports.LocalWorkspaceHost = {
-    stat: promises_1.stat,
-    existsSync: fs_1.existsSync,
-    readFile: promises_1.readFile,
-    glob: function (pattern, options) {
-        return (0, promises_1.glob)(pattern, { ...options, withFileTypes: true });
-    },
-    executeNgCommand: async (args, options = {}) => {
-        const resolved = resolveNgCommand(args, options.cwd);
-        const signal = options.timeout ? AbortSignal.timeout(options.timeout) : undefined;
-        return new Promise((resolve, reject) => {
-            const childProcess = (0, node_child_process_1.spawn)(resolved.command, resolved.args, {
-                shell: false,
-                stdio: options.stdio ?? 'pipe',
-                signal,
-                cwd: options.cwd,
-                env: {
-                    ...process.env,
-                    ...options.env,
-                },
-            });
-            const logs = [];
-            processStreamLines(childProcess.stdout, (line) => logs.push(line));
-            processStreamLines(childProcess.stderr, (line) => logs.push(line));
-            childProcess.on('close', (code) => {
-                if (code === 0) {
-                    resolve({ logs });
-                }
-                else {
-                    const message = `Process exited with code ${code}.`;
-                    reject(new CommandError(message, logs, code));
-                }
-            });
-            childProcess.on('error', (err) => {
-                if (err.name === 'AbortError') {
-                    const message = `Process timed out.`;
-                    reject(new CommandError(message, logs, null));
-                    return;
-                }
-                const message = `Process failed with error: ${err.message}`;
-                reject(new CommandError(message, logs, null));
-            });
-        });
-    },
-    startNgProcess(args, options = {}) {
-        const resolved = resolveNgCommand(args, options.cwd);
-        return (0, node_child_process_1.spawn)(resolved.command, resolved.args, {
-            shell: false,
-            stdio: options.stdio ?? 'pipe',
-            cwd: options.cwd,
-            env: {
-                ...process.env,
-                ...options.env,
-            },
-        });
-    },
-    getAvailablePort() {
-        return new Promise((resolve, reject) => {
-            // Create a new temporary server from Node's net library.
-            const server = (0, node_net_1.createServer)();
-            server.once('error', (err) => {
-                reject(err);
-            });
-            // Listen on port 0 to let the OS assign an available port.
-            server.listen(0, () => {
-                const address = server.address();
-                // Ensure address is an object with a port property.
-                if (address && typeof address === 'object') {
-                    const port = address.port;
-                    server.close();
-                    resolve(port);
-                }
-                else {
-                    reject(new Error('Unable to retrieve address information from server.'));
-                }
-            });
-        });
-    },
-    isPortAvailable(port) {
-        return new Promise((resolve) => {
-            const server = (0, node_net_1.createServer)();
-            server.once('error', () => resolve(false));
-            server.listen(port, () => {
-                server.close(() => {
-                    resolve(true);
-                });
-            });
-        });
-    },
-    setRoots(roots) {
-        // LocalWorkspaceHost does not enforce roots, so this is a no-op.
-    },
-};
-function resolveRoots(roots) {
-    return roots.map((r) => {
-        try {
-            return (0, node_fs_1.realpathSync)((0, node_path_1.resolve)(r));
-        }
-        catch {
-            return (0, node_path_1.resolve)(r);
-        }
-    });
-}
-function createRootRestrictedHost(baseHost, initialRoots = [process.cwd()]) {
-    const defaultRoots = resolveRoots(initialRoots);
-    let roots = defaultRoots;
-    function checkPath(path) {
-        const resolvedPath = (0, node_path_1.resolve)(path);
-        let realPath;
-        try {
-            realPath = (0, node_fs_1.realpathSync)(resolvedPath);
-        }
-        catch (e) {
-            if (e.code === 'ENOENT') {
-                // Path does not exist. Find the first existing ancestor.
-                let current = resolvedPath;
-                while (current) {
-                    try {
-                        realPath = (0, node_fs_1.realpathSync)(current);
-                        break;
-                    }
-                    catch (err) {
-                        if (err.code !== 'ENOENT') {
-                            throw err;
-                        }
-                        const parent = (0, node_path_1.dirname)(current);
-                        if (parent === current) {
-                            // Reached filesystem root
-                            throw err;
-                        }
-                        current = parent;
-                    }
-                }
-            }
-            else {
-                throw e;
-            }
-        }
-        const isAllowed = roots.some((root) => {
-            const rel = (0, node_path_1.relative)(root, realPath);
-            return !rel.startsWith('..') && !(0, node_path_1.isAbsolute)(rel);
-        });
-        if (!isAllowed) {
-            throw new Error(`Access denied: path '${path}' is outside allowed roots.`);
-        }
-    }
-    return {
-        ...baseHost,
-        setRoots(newRoots) {
-            roots = newRoots.length > 0 ? resolveRoots(newRoots) : defaultRoots;
-        },
-        stat(path) {
-            checkPath(path);
-            return baseHost.stat(path);
-        },
-        existsSync(path) {
-            checkPath(path);
-            return baseHost.existsSync(path);
-        },
-        readFile(path, encoding) {
-            checkPath(path);
-            return baseHost.readFile(path, encoding);
-        },
-        glob(pattern, options) {
-            if (pattern.includes('..')) {
-                throw new Error(`Access denied: glob pattern '${pattern}' contains path traversal sequences.`);
-            }
-            checkPath(options.cwd);
-            const firstWildcardIndex = pattern.search(/[*?[{]/);
-            const basePath = firstWildcardIndex >= 0 ? pattern.substring(0, firstWildcardIndex) : pattern;
-            const targetDir = (0, node_path_1.resolve)(options.cwd, basePath);
-            checkPath(targetDir);
-            return baseHost.glob(pattern, options);
-        },
-        executeNgCommand(args, options = {}) {
-            const effectiveCwd = options?.cwd ?? process.cwd();
-            checkPath(effectiveCwd);
-            return baseHost.executeNgCommand(args, options);
-        },
-        startNgProcess(args, options = {}) {
-            const effectiveCwd = options?.cwd ?? process.cwd();
-            checkPath(effectiveCwd);
-            return baseHost.startNgProcess(args, options);
-        },
-    };
-}
-/**
- * Binds a readline interface to the given stream to process each line.
- * Sanitizes lines by removing VT/ANSI control characters, trimming trailing whitespace,
- * and preserving leading indentation.
- */
-function processStreamLines(stream, lineCallback) {
-    if (!stream) {
-        return;
-    }
-    const rl = (0, node_readline_1.createInterface)({ input: stream, terminal: false });
-    rl.on('line', (line) => {
-        const cleanLine = (0, node_util_1.stripVTControlCharacters)(line).trimEnd();
-        if (cleanLine.length > 0) {
-            lineCallback(cleanLine);
-        }
-    });
-}
-//# sourceMappingURL=host.js.map

package/src/commands/mcp/host.js.map

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

package/src/commands/mcp/mcp-server.d.ts

@@ -1,38 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-import { McpServer } from '@modelcontextprotocol/server';
-import type { AngularWorkspace } from '../../utilities/config';
-import { type AnyMcpToolDeclaration } from './tools/tool-registry';
-/**
- * The set of tools that are available but not enabled by default.
- * These tools are considered experimental and may have limitations.
- */
-export declare const EXPERIMENTAL_TOOLS: readonly AnyMcpToolDeclaration[];
-/**
- * Experimental tools that are grouped together under a single name.
- *
- * Used for enabling them as a group.
- */
-export declare const EXPERIMENTAL_TOOL_GROUPS: Record<string, readonly AnyMcpToolDeclaration[]>;
-export declare function createMcpServer(options: {
-    workspace?: AngularWorkspace;
-    readOnly?: boolean;
-    localOnly?: boolean;
-    experimentalTools?: string[];
-    roots?: string[];
-}, logger: {
-    warn(text: string): void;
-}): Promise<McpServer>;
-export declare function assembleToolDeclarations(stableDeclarations: readonly AnyMcpToolDeclaration[], experimentalDeclarations: readonly AnyMcpToolDeclaration[], options: {
-    readOnly?: boolean;
-    localOnly?: boolean;
-    experimentalTools?: string[];
-    logger: {
-        warn(text: string): void;
-    };
-}): AnyMcpToolDeclaration[];

package/src/commands/mcp/mcp-server.js

@@ -1,176 +0,0 @@
-"use strict";
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXPERIMENTAL_TOOL_GROUPS = exports.EXPERIMENTAL_TOOLS = void 0;
-exports.createMcpServer = createMcpServer;
-exports.assembleToolDeclarations = assembleToolDeclarations;
-const server_1 = require("@modelcontextprotocol/server");
-const node_path_1 = require("node:path");
-const node_url_1 = require("node:url");
-const version_1 = require("../../utilities/version");
-const host_1 = require("./host");
-const instructions_1 = require("./resources/instructions");
-const ai_tutor_1 = require("./tools/ai-tutor");
-const best_practices_1 = require("./tools/best-practices");
-const devserver_start_1 = require("./tools/devserver/devserver-start");
-const devserver_stop_1 = require("./tools/devserver/devserver-stop");
-const devserver_wait_for_build_1 = require("./tools/devserver/devserver-wait-for-build");
-const doc_search_1 = require("./tools/doc-search");
-const zoneless_migration_1 = require("./tools/onpush-zoneless-migration/zoneless-migration");
-const projects_1 = require("./tools/projects");
-const run_target_1 = require("./tools/run-target/run-target");
-const tool_registry_1 = require("./tools/tool-registry");
-/**
- * Tools to manage devservers. Should be bundled together, then added to experimental or stable as a group.
- */
-const DEVSERVER_TOOLS = [devserver_start_1.DEVSERVER_START_TOOL, devserver_stop_1.DEVSERVER_STOP_TOOL, devserver_wait_for_build_1.DEVSERVER_WAIT_FOR_BUILD_TOOL];
-/**
- * The set of tools that are enabled by default for the MCP server.
- * These tools are considered stable and suitable for general use.
- */
-const STABLE_TOOLS = [
-    ai_tutor_1.AI_TUTOR_TOOL,
-    best_practices_1.BEST_PRACTICES_TOOL,
-    doc_search_1.DOC_SEARCH_TOOL,
-    projects_1.LIST_PROJECTS_TOOL,
-    zoneless_migration_1.ZONELESS_MIGRATION_TOOL,
-    run_target_1.RUN_TARGET_TOOL,
-    ...DEVSERVER_TOOLS,
-];
-/**
- * The set of tools that are available but not enabled by default.
- * These tools are considered experimental and may have limitations.
- */
-exports.EXPERIMENTAL_TOOLS = [];
-/**
- * Experimental tools that are grouped together under a single name.
- *
- * Used for enabling them as a group.
- */
-exports.EXPERIMENTAL_TOOL_GROUPS = {
-    'all': exports.EXPERIMENTAL_TOOLS,
-    'devserver': [],
-};
-async function createMcpServer(options, logger) {
-    const server = new server_1.McpServer({
-        name: 'angular-cli-server',
-        version: version_1.VERSION.full,
-    }, {
-        capabilities: {
-            resources: {},
-            tools: {},
-            logging: {},
-        },
-        instructions: `
-<General Purpose>
-This server provides a safe, programmatic interface to the Angular CLI. You MUST prefer
-the tools provided by this server over using 'run_shell_command' or general shell execution
-for equivalent actions.
-</General Purpose>
-
-<Core Workflows & Tool Guide>
-* **1. Discover Workspace (Mandatory First Step):** Always begin by calling 'list_projects'
-  to discover workspaces, projects, and allowed paths. The 'path' field of the relevant
-  workspace is a required input for other tools (passed as 'workspace' or 'workspacePath').
-
-* **2. Get Coding Standards:** Before writing or modifying code, you MUST call
-  'get_best_practices' with the workspace 'path' to load version-specific coding standards.
-
-* **3. Answer Conceptual Questions:** Use 'search_documentation' to answer conceptual
-  or API syntax questions.
-
-* **4. Discover Schematics:** To discover available package migrations, use a shell command
-  (if available) with 'ng generate <package-name>: --help' (e.g., 'ng generate @angular/core: --help').
-</Core Workflows & Tool Guide>
-
-<Key Concepts>
-* **Workspace vs. Project:** A 'workspace' contains an 'angular.json' file and defines
-  'projects' (applications or libraries). A monorepo can contain multiple workspaces.
-
-* **Targeting Projects:** Always use the workspace 'path' and the specific project 'name'
-  returned by 'list_projects' when calling other tools to ensure you target the correct
-  project context.
-</Key Concepts>
-`,
-    });
-    (0, instructions_1.registerInstructionsResource)(server);
-    const toolDeclarations = assembleToolDeclarations(STABLE_TOOLS, exports.EXPERIMENTAL_TOOLS, {
-        ...options,
-        logger,
-    });
-    const resolvedRoots = options.roots?.map((r) => (0, node_path_1.resolve)(r));
-    const restrictedHost = (0, host_1.createRootRestrictedHost)(host_1.LocalWorkspaceHost, resolvedRoots?.length ? resolvedRoots : [process.cwd()]);
-    server.server.oninitialized = () => {
-        void (async () => {
-            try {
-                const clientCapabilities = server.server.getClientCapabilities();
-                if (clientCapabilities?.roots) {
-                    const { roots } = await server.server.listRoots();
-                    const searchRoots = roots?.map((r) => (0, node_path_1.normalize)((0, node_url_1.fileURLToPath)(r.uri))) ?? [];
-                    restrictedHost.setRoots(searchRoots);
-                    if (clientCapabilities.roots.listChanged) {
-                        server.server.setNotificationHandler('notifications/roots/list_changed', async () => {
-                            try {
-                                const { roots: updatedRoots } = await server.server.listRoots();
-                                const updatedSearchRoots = updatedRoots?.map((r) => (0, node_path_1.normalize)((0, node_url_1.fileURLToPath)(r.uri))) ?? [];
-                                restrictedHost.setRoots(updatedSearchRoots);
-                            }
-                            catch (e) {
-                                logger.warn(`Failed to update roots on notification: ${e instanceof Error ? e.message : e}`);
-                            }
-                        });
-                    }
-                }
-            }
-            catch (e) {
-                logger.warn(`Failed to initialize roots on connection: ${e instanceof Error ? e.message : e}`);
-            }
-        })();
-    };
-    await (0, tool_registry_1.registerTools)(server, {
-        workspace: options.workspace,
-        logger,
-        exampleDatabasePath: (0, node_path_1.join)(__dirname, '../../../lib/code-examples.db'),
-        devservers: new Map(),
-        host: restrictedHost,
-        roots: resolvedRoots,
-    }, toolDeclarations);
-    return server;
-}
-function assembleToolDeclarations(stableDeclarations, experimentalDeclarations, options) {
-    let toolDeclarations = [...stableDeclarations];
-    if (options.readOnly) {
-        toolDeclarations = toolDeclarations.filter((tool) => tool.isReadOnly);
-    }
-    if (options.localOnly) {
-        toolDeclarations = toolDeclarations.filter((tool) => tool.isLocalOnly);
-    }
-    const enabledExperimentalTools = new Set(options.experimentalTools);
-    for (const [toolGroupName, toolGroup] of Object.entries(exports.EXPERIMENTAL_TOOL_GROUPS)) {
-        if (enabledExperimentalTools.delete(toolGroupName)) {
-            for (const tool of toolGroup) {
-                enabledExperimentalTools.add(tool.name);
-            }
-        }
-    }
-    if (enabledExperimentalTools.size > 0) {
-        const experimentalToolsMap = new Map(experimentalDeclarations.map((tool) => [tool.name, tool]));
-        for (const toolName of enabledExperimentalTools) {
-            const tool = experimentalToolsMap.get(toolName);
-            if (tool) {
-                toolDeclarations.push(tool);
-            }
-            else if (!stableDeclarations.some((t) => t.name === toolName)) {
-                options.logger.warn(`Unknown experimental tool: ${toolName}`);
-            }
-        }
-    }
-    return toolDeclarations;
-}
-//# sourceMappingURL=mcp-server.js.map

package/src/commands/mcp/mcp-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["mcp-server.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAwDH,0CAmHC;AAED,4DA2CC;AAtND,yDAAyD;AACzD,yCAAqD;AACrD,uCAAyC;AAEzC,qDAAkD;AAElD,iCAAsE;AACtE,2DAAwE;AACxE,+CAAiD;AACjD,2DAA6D;AAC7D,uEAAyE;AACzE,qEAAuE;AACvE,yFAA2F;AAC3F,mDAAqD;AACrD,6FAA+F;AAC/F,+CAAsD;AACtD,8DAAgE;AAChE,yDAAkF;AAElF;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,sCAAoB,EAAE,oCAAmB,EAAE,wDAA6B,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,YAAY,GAAG;IACnB,wBAAa;IACb,oCAAmB;IACnB,4BAAe;IACf,6BAAkB;IAClB,4CAAuB;IACvB,4BAAe;IACf,GAAG,eAAe;CACV,CAAC;AAEX;;;GAGG;AACU,QAAA,kBAAkB,GAAqC,EAAW,CAAC;AAEhF;;;;GAIG;AACU,QAAA,wBAAwB,GAAqD;IACxF,KAAK,EAAE,0BAAkB;IACzB,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,KAAK,UAAU,eAAe,CACnC,OAMC,EACD,MAAoC;IAEpC,MAAM,MAAM,GAAG,IAAI,kBAAS,CAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,iBAAO,CAAC,IAAI;KACtB,EACD;QACE,YAAY,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;SACZ;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BnB;KACI,CACF,CAAC;IAEF,IAAA,2CAA4B,EAAC,MAAM,CAAC,CAAC;IAErC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,YAAY,EAAE,0BAAkB,EAAE;QAClF,GAAG,OAAO;QACV,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,MAAM,cAAc,GAAG,IAAA,+BAAwB,EAC7C,yBAAkB,EAClB,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CACxD,CAAC;IAEF,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,GAAG,EAAE;QACjC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;gBACjE,IAAI,kBAAkB,EAAE,KAAK,EAAE,CAAC;oBAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;oBAClD,MAAM,WAAW,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,IAAA,wBAAa,EAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC7E,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;oBAErC,IAAI,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;wBACzC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;4BAClF,IAAI,CAAC;gCACH,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gCAChE,MAAM,kBAAkB,GACtB,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,IAAA,wBAAa,EAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gCAClE,cAAc,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;4BAC9C,CAAC;4BAAC,OAAO,CAAC,EAAE,CAAC;gCACX,MAAM,CAAC,IAAI,CACT,2CAA2C,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAChF,CAAC;4BACJ,CAAC;wBACH,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,6CAA6C,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAClF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC;IAEF,MAAM,IAAA,6BAAa,EACjB,MAAM,EACN;QACE,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM;QACN,mBAAmB,EAAE,IAAA,gBAAI,EAAC,SAAS,EAAE,+BAA+B,CAAC;QACrE,UAAU,EAAE,IAAI,GAAG,EAAqB;QACxC,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,aAAa;KACrB,EACD,gBAAgB,CACjB,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,wBAAwB,CACtC,kBAAoD,EACpD,wBAA0D,EAC1D,OAKC;IAED,IAAI,gBAAgB,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gCAAwB,CAAC,EAAE,CAAC;QAClF,IAAI,wBAAwB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,wBAAwB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhG,KAAK,MAAM,QAAQ,IAAI,wBAAwB,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,IAAI,EAAE,CAAC;gBACT,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;iBAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}