cli-forge 0.5.0 → 0.7.0

package/src/lib/interactive-shell.d.ts

@@ -0,0 +1,13 @@
+import { InternalCLI } from './cli-forge';
+export interface InteractiveShellOptions {
+    prompt?: string;
+    prependArgs?: string[];
+}
+export declare let INTERACTIVE_SHELL: InteractiveShell | undefined;
+export declare class InteractiveShell {
+    private readonly rl;
+    private listeners;
+    constructor(cli: InternalCLI<any>, opts?: InteractiveShellOptions);
+    registerLineListener(callback: (line: string) => Promise<void>): void;
+    close(): void;
+}

package/src/lib/interactive-shell.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractiveShell = exports.INTERACTIVE_SHELL = void 0;
+const readline = require("readline");
+const utils_1 = require("./utils");
+const child_process_1 = require("child_process");
+const parser_1 = require("@cli-forge/parser");
+function normalizeShellOptions(cli, options) {
+    return {
+        prompt: options?.prompt ??
+            (() => {
+                const chain = [cli.name];
+                if (cli.commandChain.length > 2) {
+                    chain.push('...', ...cli.commandChain[cli.command.length - 1]);
+                }
+                else {
+                    chain.push(...cli.commandChain);
+                }
+                return chain.join(' ') + '> ';
+            })(),
+        prependArgs: options?.prependArgs ?? [],
+    };
+}
+class InteractiveShell {
+    rl;
+    listeners = [];
+    constructor(cli, opts) {
+        if (exports.INTERACTIVE_SHELL) {
+            throw new Error('Only one interactive shell can be created at a time. Make sure the other instance is closed.');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        exports.INTERACTIVE_SHELL = this;
+        const { prompt, prependArgs } = normalizeShellOptions(cli, opts);
+        this.rl = readline
+            .createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: prompt,
+        })
+            .on('SIGINT', () => {
+            process.emit('SIGINT');
+        });
+        this.rl.prompt();
+        this.registerLineListener(async (line) => {
+            const nextArgs = (0, utils_1.stringToArgs)(line);
+            let currentCommand = cli;
+            for (const subcommand of cli.commandChain) {
+                currentCommand = currentCommand.registeredCommands[subcommand];
+            }
+            if (currentCommand.registeredCommands[nextArgs[0]]) {
+                (0, child_process_1.spawnSync)(process.execPath, [
+                    ...process.execArgv,
+                    (0, parser_1.getBin)(process.argv),
+                    ...prependArgs,
+                    ...nextArgs,
+                ], { stdio: 'inherit' });
+            }
+            else if (line.trim()) {
+                try {
+                    (0, child_process_1.execSync)(line, { stdio: 'inherit' });
+                }
+                catch {
+                    // ignore
+                }
+            }
+        });
+    }
+    registerLineListener(callback) {
+        const wrapped = async (line) => {
+            this.rl.pause();
+            await callback(line);
+            this.rl.prompt();
+        };
+        this.listeners.push(wrapped);
+        this.rl.on('line', wrapped);
+    }
+    close() {
+        this.listeners.forEach((listener) => this.rl.off('line', listener));
+        this.rl.close();
+        readline.moveCursor(process.stdout, -1 * this.rl.getCursorPos().cols, 0);
+        readline.clearScreenDown(process.stdout);
+        if (exports.INTERACTIVE_SHELL === this) {
+            exports.INTERACTIVE_SHELL = undefined;
+        }
+    }
+}
+exports.InteractiveShell = InteractiveShell;
+//# sourceMappingURL=interactive-shell.js.map

package/src/lib/interactive-shell.js.map

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

package/src/lib/public-api.d.ts

@@ -0,0 +1,212 @@
+import { ArrayOptionConfig, OptionConfig, ParsedArgs } from '@cli-forge/parser';
+/**
+ * The interface for a CLI application or subcommands.
+ *
+ * {@link cli} is provided as a small helper function to create a new CLI instance.
+ *
+ * @example
+ * ```ts
+ * import { cli } from 'cli-forge';
+ *
+ * cli('basic-cli').command('hello', {
+ *   builder: (args) =>
+ *    args.option('name', {
+ *      type: 'string',
+ *    }),
+ *   handler: (args) => {
+ *     console.log(`Hello, ${args.name}!`);
+ *   }).forge();
+ * ```
+ */
+export interface CLI<TArgs extends ParsedArgs = ParsedArgs> {
+    command<TCommandArgs extends TArgs>(cmd: Command<TArgs, TCommandArgs>): CLI<TArgs>;
+    /**
+     * Registers a new command with the CLI.
+     * @param key What should the new command be called?
+     * @param options Settings for the new command. See {@link CLICommandOptions}.
+     * @returns Updated CLI instance with the new command registered.
+     */
+    command<TCommandArgs extends TArgs>(key: string, options: CLICommandOptions<TArgs, TCommandArgs>): CLI<TArgs>;
+    /**
+     * Registers multiple subcommands with the CLI.
+     * @param commands Several commands to register. Can be the result of a call to {@link cli} or a configuration object.
+     */
+    commands(commands: Command[]): CLI<TArgs>;
+    /**
+     * Registers multiple subcommands with the CLI.
+     * @param commands Several commands to register. Can be the result of a call to {@link cli} or a configuration object.
+     */
+    commands(...commands: Command[]): CLI<TArgs>;
+    /**
+     * Enables the ability to run CLI commands that contain subcommands as an interactive shell.
+     * This presents as a small shell that only knows the current command and its subcommands.
+     * Any flags already consumed by the command will be passed to every subcommand invocation.
+     */
+    enableInteractiveShell(): CLI<TArgs>;
+    /**
+     * Registers a custom global error handler for the CLI. This handler will be called when an error is thrown
+     * during the execution of the CLI and not otherwise handled. Error handlers should re-throw the error if they
+     * cannot handle it, s.t. the next error handler can attempt to handle it.
+     *
+     * @param handler Typically called with an Error object, but you should be prepared to handle any type of error.
+     * @param actions Actions that can be taken by the error handler. Prefer using these over process.exit for better support of interactive shells.
+     */
+    errorHandler(handler: ErrorHandler): CLI<TArgs>;
+    /**
+     * Registers a new option for the CLI command. This option will be accessible
+     * within the command handler, as well as any subcommands.
+     *
+     * @param name The name of the option.
+     * @param config Configuration for the option. See {@link OptionConfig}.
+     * @returns Updated CLI instance with the new option registered.
+     */
+    option<TOption extends string, TOptionConfig extends OptionConfig>(name: TOption, config: TOptionConfig): CLI<TArgs & {
+        [key in TOption]: TOptionConfig['coerce'] extends (value: string) => infer TCoerce ? TCoerce : {
+            string: string;
+            number: number;
+            boolean: boolean;
+            array: (TOptionConfig extends ArrayOptionConfig<string | number> ? TOptionConfig['items'] extends 'string' ? string : number : never)[];
+        }[TOptionConfig['type']];
+    }>;
+    /**
+     * Registers a new positional argument for the CLI command. This argument will be accessible
+     * within the command handler, as well as any subcommands.
+     * @param name The name of the positional argument.
+     * @param config Configuration for the positional argument. See {@link OptionConfig}.
+     * @returns Updated CLI instance with the new positional argument registered.
+     */
+    positional<TOption extends string, TOptionConfig extends OptionConfig>(name: TOption, config: TOptionConfig): CLI<TArgs & {
+        [key in TOption]: TOptionConfig['coerce'] extends (value: string) => infer TCoerce ? TCoerce : {
+            string: string;
+            number: number;
+            boolean: boolean;
+            array: (TOptionConfig extends ArrayOptionConfig<string | number> ? TOptionConfig['items'] extends 'string' ? string : number : never)[];
+        }[TOptionConfig['type']];
+    }>;
+    /**
+     * Adds support for reading CLI options from environment variables.
+     * @param prefix The prefix to use when looking up environment variables. Defaults to the command name.
+     */
+    env(prefix?: string): CLI<TArgs>;
+    /**
+     * Sets a group of options as mutually exclusive. If more than one option is provided, there will be a validation error.
+     * @param options The options that should be mutually exclusive.
+     */
+    conflicts(...options: [string, string, ...string[]]): CLI<TArgs>;
+    /**
+     * Sets a group of options as mutually inclusive. If one option is provided, all other options must also be provided.
+     * @param option The option that implies the other options.
+     * @param impliedOptions The options which become required when the option is provided.
+     */
+    implies(option: string, ...impliedOptions: string[]): CLI<TArgs>;
+    /**
+     * Requires a command to be provided when executing the CLI. Useful if your parent command
+     * cannot be executed on its own.
+     * @returns Updated CLI instance.
+     */
+    demandCommand(): CLI<TArgs>;
+    /**
+     * Sets the usage text for the CLI. This text will be displayed in place of the default usage text
+     * @param usageText Text displayed in place of the default usage text for `--help` and in generated docs.
+     */
+    usage(usageText: string): CLI<TArgs>;
+    /**
+     * Sets the description for the CLI. This text will be displayed in the help text and generated docs.
+     * @param examples Examples to display in the help text and generated docs.
+     */
+    examples(...examples: string[]): CLI<TArgs>;
+    /**
+     * Allows overriding the version displayed when passing `--version`. Defaults to crawling
+     * the file system to get the package.json of the currently executing command.
+     * @param override
+     */
+    version(override?: string): CLI<TArgs>;
+    /**
+     * Prints help text to stdout.
+     */
+    printHelp(): void;
+    group({ label, keys, sortOrder, }: {
+        label: string;
+        keys: (keyof TArgs)[];
+        sortOrder: number;
+    }): CLI<TArgs>;
+    group(label: string, keys: (keyof TArgs)[]): CLI<TArgs>;
+    middleware(callback: (args: TArgs) => void): CLI<TArgs>;
+    /**
+     * Parses argv and executes the CLI
+     * @param args argv. Defaults to process.argv.slice(2)
+     * @returns Promise that resolves when the handler completes.
+     */
+    forge(args?: string[]): Promise<TArgs>;
+}
+export interface CLIHandlerContext {
+    command: CLI<any>;
+}
+/**
+ * Represents the configuration needed to create a CLI command.
+ */
+export interface CLICommandOptions<
+/**
+ * The type of the arguments that are already registered before `builder` is invoked.
+ */
+TInitial extends ParsedArgs, 
+/**
+ * The type of the arguments that are registered after `builder` is invoked, and the type that is passed to the handler.
+ */
+TArgs extends TInitial = TInitial> {
+    /**
+     * The command description. This will be displayed in the help text and generated docs.
+     */
+    description?: string;
+    /**
+     * The command builder. This function is called before the command is executed, and is used to register options and positional parameters.
+     * @param parser The parser instance to register options and positionals with.
+     */
+    builder?: (parser: CLI<TInitial>) => CLI<TArgs>;
+    /**
+     * The command handler. This function is called when the command is executed.
+     * @param args The parsed arguments.
+     * @param context Context for the handler. Contains the command instance.
+     */
+    handler?: (args: TArgs, context: CLIHandlerContext) => void | Promise<void>;
+    /**
+     * The usage text for the command. This text will be displayed in place of the default usage text in the help text and generated docs.
+     */
+    usage?: string;
+    /**
+     * Examples to display in the help text and generated docs.
+     */
+    examples?: string[];
+    /**
+     * Hides the command from the help text and generated docs. Useful primarily for experimental or internal commands.
+     */
+    hidden?: boolean;
+    /**
+     * The epilogue text for the command. This text will be displayed at the end of the help text and generated docs.
+     */
+    epilogue?: string;
+}
+export type Command<TInitial extends ParsedArgs = any, TArgs extends TInitial = TInitial> = ({
+    name: string;
+} & CLICommandOptions<TInitial, TArgs>) | CLI<TArgs>;
+/**
+ * Error Handler for CLI applications. Error handlers should re-throw the error if they cannot handle it.
+ *
+ * @param e The error that was thrown.
+ * @param actions Actions that can be taken by the error handler. Prefer using these over process.exit for better support of interactive shells.
+ */
+export type ErrorHandler = (e: unknown, actions: {
+    /**
+     * Exits the process immediately.
+     * @param code
+     */
+    exit: (code?: number) => void;
+}) => void;
+/**
+ * Constructs a CLI instance. See {@link InternalCLI} for more information.
+ * @param name Name for the top level CLI
+ * @param rootCommandConfiguration Configuration used when running the bare CLI. e.g. npx my-cli, rather than npx my-cli [cmd]
+ * @returns A {@link InternalCLI} instance.
+ */
+export declare function cli<TArgs extends ParsedArgs>(name: string, rootCommandConfiguration?: CLICommandOptions<ParsedArgs, TArgs>): CLI<TArgs>;
+export default cli;

package/src/lib/public-api.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cli = cli;
+const cli_forge_1 = require("./cli-forge");
+/**
+ * Constructs a CLI instance. See {@link InternalCLI} for more information.
+ * @param name Name for the top level CLI
+ * @param rootCommandConfiguration Configuration used when running the bare CLI. e.g. npx my-cli, rather than npx my-cli [cmd]
+ * @returns A {@link InternalCLI} instance.
+ */
+function cli(name, rootCommandConfiguration) {
+    return new cli_forge_1.InternalCLI(name, rootCommandConfiguration);
+}
+exports.default = cli;
+//# sourceMappingURL=public-api.js.map

package/src/lib/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/public-api.ts"],"names":[],"mappings":";;AA4RA,kBAKC;AAhSD,2CAA0C;AAqR1C;;;;;GAKG;AACH,SAAgB,GAAG,CACjB,IAAY,EACZ,wBAA+D;IAE/D,OAAO,IAAI,uBAAW,CAAC,IAAI,EAAE,wBAAwB,CAAsB,CAAC;AAC9E,CAAC;AAED,kBAAe,GAAG,CAAC"}

package/src/lib/test-harness.d.ts

@@ -1,5 +1,5 @@
 import { ParsedArgs } from '@cli-forge/parser';
-import { CLI } from './cli-forge';
+import { CLI } from './public-api';
 export type TestHarnessParseResult<T extends ParsedArgs> = {
     /**
      * Parsed arguments. Note the the typing of this is based on the CLI typings,

package/src/lib/test-harness.js

@@ -28,7 +28,9 @@ class TestHarness {
 exports.TestHarness = TestHarness;
 function mockHandler(cli) {
     if (cli.configuration?.handler) {
-        cli.configuration.handler = () => { };
+        cli.configuration.handler = () => {
+            // Mocked, should do nothing.
+        };
     }
     for (const command in cli.registeredCommands) {
         mockHandler(cli.registeredCommands[command]);

package/src/lib/test-harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-harness.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/test-harness.ts"],"names":[],"mappings":";;;AACA,2CAA+C;AA6B/C;;;GAGG;AACH,MAAa,WAAW;IACd,GAAG,CAAiB;IAE5B,YAAY,GAAW;QACrB,IAAI,GAAG,YAAY,uBAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;YACf,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,WAAW,CAAC,GAAgB;IACnC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC/B,GAAG,CAAC,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC7C,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}
+{"version":3,"file":"test-harness.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/test-harness.ts"],"names":[],"mappings":";;;AACA,2CAA0C;AA8B1C;;;GAGG;AACH,MAAa,WAAW;IACd,GAAG,CAAiB;IAE5B,YAAY,GAAW;QACrB,IAAI,GAAG,YAAY,uBAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;YACf,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,WAAW,CAAC,GAAgB;IACnC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC/B,GAAG,CAAC,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE;YAC/B,6BAA6B;QAC/B,CAAC,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC7C,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/src/lib/utils.d.ts

@@ -0,0 +1,10 @@
+export declare function getCallingFile(): string | undefined;
+export declare function getParentPackageJson(searchPath: string): {
+    name: string;
+    version: string;
+    bin?: {
+        [cmd: string]: string;
+    };
+    dependencies?: Record<string, string>;
+};
+export declare function stringToArgs(str: string): string[];

package/src/lib/utils.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCallingFile = getCallingFile;
+exports.getParentPackageJson = getParentPackageJson;
+exports.stringToArgs = stringToArgs;
+const fs_1 = require("fs");
+const path_1 = require("path");
+function getCallingFile() {
+    // Since this function lives in a utility file, the parent file
+    // would just be the file that invokes getCallingFile... We actually
+    // want the parent of the file that calls this, which is this file's
+    // grandparent.
+    let grandparentFile;
+    // Overrides prepare stack trace to be an identity fn, to get the callsites
+    // associated with the current error.
+    const _pst = Error.prepareStackTrace;
+    Error.prepareStackTrace = function (err, stack) {
+        return stack;
+    };
+    try {
+        const err = new Error();
+        const callsites = err.stack;
+        let currentfile = callsites.shift().getFileName();
+        let parentfile;
+        while (callsites.length) {
+            const callerfile = callsites.shift().getFileName();
+            // We've reached the parent file
+            if (currentfile !== callerfile) {
+                // We've reached the grandparent file
+                if (parentfile && parentfile !== callerfile) {
+                    grandparentFile = parentfile;
+                    break;
+                }
+                parentfile = callerfile;
+            }
+        }
+    }
+    finally {
+        Error.prepareStackTrace = _pst;
+    }
+    return grandparentFile;
+}
+function getParentPackageJson(searchPath) {
+    let currentPath = searchPath;
+    let packageJsonPath;
+    while (true) {
+        const packagePath = (0, path_1.join)(currentPath, 'package.json');
+        if ((0, fs_1.existsSync)(packagePath)) {
+            packageJsonPath = packagePath;
+            break;
+        }
+        const nextPath = (0, path_1.resolve)(currentPath, '..');
+        if (nextPath === currentPath) {
+            break;
+        }
+        currentPath = nextPath;
+    }
+    if (!packageJsonPath) {
+        throw new Error('Could not find package.json');
+    }
+    return require(packageJsonPath);
+}
+function stringToArgs(str) {
+    const quotePairs = new Map([
+        ['"', '"'],
+        ["'", "'"],
+        ['`', '`'],
+    ]);
+    const escapeChars = new Set(['\\']);
+    let activeQuote;
+    const args = [];
+    let currentArg = '';
+    let prev;
+    for (let i = 0; i < str.length; i++) {
+        const char = str[i];
+        if (activeQuote) {
+            while (true) {
+                if (i >= str.length) {
+                    break;
+                }
+                else if (str[i] === quotePairs.get(activeQuote) &&
+                    !(prev && escapeChars.has(prev))) {
+                    break;
+                }
+                if (!escapeChars.has(str[i])) {
+                    currentArg += str[i];
+                }
+                prev = str[i];
+                i++;
+            }
+            activeQuote = undefined;
+        }
+        else if (quotePairs.has(char) && !(prev && escapeChars.has(prev))) {
+            activeQuote = char;
+        }
+        else if (char === ' ' &&
+            prev !== ' ' &&
+            !(prev && escapeChars.has(prev))) {
+            args.push(currentArg);
+            currentArg = '';
+        }
+        else if (!escapeChars.has(char) || (prev && escapeChars.has(prev))) {
+            currentArg += char;
+        }
+        prev = char;
+    }
+    args.push(currentArg);
+    return args;
+}
+//# sourceMappingURL=utils.js.map

package/src/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/utils.ts"],"names":[],"mappings":";;AAGA,wCAuCC;AAED,oDAiCC;AAED,oCAiDC;AAhID,2BAAgC;AAChC,+BAAqC;AAErC,SAAgB,cAAc;IAC5B,+DAA+D;IAC/D,oEAAoE;IACpE,oEAAoE;IACpE,eAAe;IACf,IAAI,eAAmC,CAAC;IAExC,2EAA2E;IAC3E,qCAAqC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACrC,KAAK,CAAC,iBAAiB,GAAG,UAAU,GAAG,EAAE,KAAK;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAiC,CAAC;QAExD,IAAI,WAAW,GAAG,SAAS,CAAC,KAAK,EAAG,CAAC,WAAW,EAAE,CAAC;QACnD,IAAI,UAA8B,CAAC;QAEnC,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,EAAG,CAAC,WAAW,EAAE,CAAC;YAEpD,gCAAgC;YAChC,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;gBAC/B,qCAAqC;gBACrC,IAAI,UAAU,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC5C,eAAe,GAAG,UAAU,CAAC;oBAC7B,MAAM;gBACR,CAAC;gBACD,UAAU,GAAG,UAAU,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACjC,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAgB,oBAAoB,CAAC,UAAkB;IACrD,IAAI,WAAW,GAAG,UAAU,CAAC;IAC7B,IAAI,eAAmC,CAAC;IAExC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAEtD,IAAI,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,eAAe,GAAG,WAAW,CAAC;YAC9B,MAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAE5C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QAED,WAAW,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC,eAAe,CAO7B,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW;IACtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAiB;QACzC,CAAC,GAAG,EAAE,GAAG,CAAC;QACV,CAAC,GAAG,EAAE,GAAG,CAAC;QACV,CAAC,GAAG,EAAE,GAAG,CAAC;KACX,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpC,IAAI,WAA+B,CAAC;IAEpC,MAAM,IAAI,GAAG,EAAE,CAAC;IAChB,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,IAAI,IAAwB,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,EAAE,CAAC;gBACZ,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;oBACpB,MAAM;gBACR,CAAC;qBAAM,IACL,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;oBACtC,CAAC,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAChC,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7B,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;gBACvB,CAAC;gBACD,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBACd,CAAC,EAAE,CAAC;YACN,CAAC;YACD,WAAW,GAAG,SAAS,CAAC;QAC1B,CAAC;aAAM,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACpE,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,IACL,IAAI,KAAK,GAAG;YACZ,IAAI,KAAK,GAAG;YACZ,CAAC,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAChC,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtB,UAAU,GAAG,EAAE,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACrE,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}