@justscale/core 0.1.0

package/dist/cli/runner.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Executes CLI commands. Supports both terminal execution and programmatic invocation.
+ */
+import type { App } from '../index.js';
+import type { z } from 'zod';
+import { type CliIO } from './io.js';
+import { type ArgDef } from './parser.js';
+/** Route with CLI-specific metadata */
+interface CliRoute {
+    path: string;
+    prefix: string;
+    fullCommand: string;
+    route: any;
+    argDefs: ArgDef[];
+    inputSchema?: z.ZodType;
+    resultSchema?: z.ZodType;
+    /** One-line summary from `Cli(...).describe(...)`. */
+    description?: string;
+}
+/** Result of running a command */
+export interface RunResult {
+    success: boolean;
+    result?: unknown;
+    error?: Error;
+    output?: string[];
+}
+/** Options for the CLI runner */
+export interface RunOptions {
+    /** Custom argv (default: process.argv.slice(2)) */
+    argv?: string[];
+    /** Enable verbose output */
+    verbose?: boolean;
+    /** Custom IO implementation */
+    io?: CliIO<unknown>;
+    /** Exit process on error (default: true) */
+    exitOnError?: boolean;
+    /** Show help with --help (default: true) */
+    helpFlag?: boolean;
+    /** Application name for help text */
+    name?: string;
+}
+/**
+ * Build a map of CLI routes from an app.
+ * Combines controller prefix (subcommand namespace) with route path (command).
+ */
+export declare function buildRouteMap(app: App<any>): Map<string, CliRoute & {
+    deps: Record<string, unknown>;
+}>;
+/**
+ * Generate application help text - grouped by command prefix (or by
+ * first command word when no prefix is set), with descriptions
+ * aligned so the command list is easy to scan.
+ */
+export declare function generateAppHelp(name: string, routes: Map<string, CliRoute & {
+    deps: Record<string, unknown>;
+}>): string;
+/** Run CLI commands from an app. */
+export declare function run(app: App<any>, options?: RunOptions): Promise<RunResult>;
+/**
+ * Invoke a CLI command programmatically.
+ * Returns typed result if the command has a result schema.
+ *
+ * @example
+ * ```typescript
+ * const result = await invoke(app, 'build', { src: './src', verbose: true });
+ * ```
+ */
+export declare function invoke<TResult = unknown>(app: App<any>, command: string, args?: Record<string, unknown>): Promise<TResult>;
+/** Create a programmatic CLI client from an app. */
+export declare function createClient(app: App<any>): {
+    invoke<TResult = unknown>(command: string, args?: Record<string, unknown>): Promise<TResult>;
+    routes: string[];
+};
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,KAAK,KAAK,EAAkC,MAAM,SAAS,CAAC;AACrE,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,aAAa,CAAC;AAGrB,uCAAuC;AACvC,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;IACvB,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GACZ,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAkC3D;AAoJD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAChE,MAAM,CA4DR;AAED,oCAAoC;AACpC,wBAAsB,GAAG,CACvB,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EACb,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAsJpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAG,OAAO,EAC5C,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EACb,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CA6DlB;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG;IAC3C,MAAM,CAAC,OAAO,GAAG,OAAO,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAYA"}

package/dist/cli/runner.js

@@ -0,0 +1,422 @@
+/**
+ * Executes CLI commands. Supports both terminal execution and programmatic invocation.
+ */
+import { executeRoute } from '../builder/execute.js';
+import { runInFullRequestScope } from '../core/context.js';
+import { getCliDescription, getInputSchema } from './builder/create-cli-builder.js';
+import { createMockIO, createTerminalIO } from './io.js';
+import { extractArgDefs, generateCompletions, generateHelp, generateUsage, parseArgv, } from './parser.js';
+import { getResultSchema } from './types.js';
+/**
+ * Build a map of CLI routes from an app.
+ * Combines controller prefix (subcommand namespace) with route path (command).
+ */
+export function buildRouteMap(app) {
+    const routes = new Map();
+    for (const controller of app.controllers) {
+        const prefix = controller.settings?.command ||
+            controller.settings?.prefix ||
+            '';
+        for (const compiledRoute of controller.routes) {
+            if (compiledRoute.method !== 'CLI')
+                continue;
+            const route = compiledRoute;
+            const commandName = route.path;
+            const fullCommand = prefix ? `${prefix} ${commandName}` : commandName;
+            const inputSchema = getInputSchema(route);
+            const resultSchema = getResultSchema(route);
+            const argDefs = extractArgDefs(inputSchema || route.schema);
+            routes.set(fullCommand, {
+                path: commandName,
+                prefix,
+                fullCommand,
+                route,
+                argDefs,
+                inputSchema,
+                resultSchema,
+                description: getCliDescription(route) ?? route.description,
+                deps: controller.deps,
+            });
+        }
+    }
+    return routes;
+}
+/**
+ * Prompt for missing required arguments using CLI metadata.
+ * Only prompts if the field has CLI metadata with a prompt string.
+ *
+ * @param args - Parsed arguments (will be mutated)
+ * @param argDefs - Argument definitions
+ * @param io - CLI IO for prompting
+ */
+async function promptForMissingArgs(args, argDefs, io) {
+    for (const def of argDefs) {
+        if (args[def.name] !== undefined || def.hasDefault || !def.required) {
+            continue;
+        }
+        const cliMeta = def.cliMeta;
+        const label = cliMeta?.prompt ?? def.description ?? humanizeArgName(def.name);
+        if (cliMeta?.secret) {
+            const value = await io.password(`${label}:`);
+            if (cliMeta.confirm) {
+                const confirm = await io.password(`Confirm ${label.toLowerCase()}:`);
+                if (value !== confirm) {
+                    throw new Error(`${label} confirmation does not match`);
+                }
+            }
+            args[def.name] = value;
+        }
+        else if (def.isBoolean) {
+            args[def.name] = await io.confirm(`${label}?`);
+        }
+        else {
+            args[def.name] = await io.prompt(`${label}:`);
+        }
+    }
+}
+/** "emailAddress" → "Email address"; "email" → "Email". */
+function humanizeArgName(name) {
+    const spaced = name.replace(/([a-z])([A-Z])/g, '$1 $2').toLowerCase();
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/** How the arg is addressed on the CLI - `<email>` for positional, `--name` for flag. */
+function refFor(name, def) {
+    if (!def)
+        return name;
+    if (def.type === 'positional')
+        return `<${def.name}>`;
+    return def.flags?.[0] ?? `--${def.name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}`;
+}
+/** The human-friendly label from `.describe()` / `.meta({ label })`, fallback to ref. */
+function labelFor(name, def) {
+    const described = def?.description?.trim();
+    if (described)
+        return described;
+    return refFor(name, def);
+}
+/** Turn a zod issue into a one-line CLI error. */
+function formatValidationIssue(issue, def) {
+    const name = String(issue.path[0] ?? '');
+    const ref = refFor(name, def);
+    const label = labelFor(name, def);
+    // Include the CLI-addressable ref in parens when we're leading with the
+    // description, so users can still see what to type.
+    const subject = label === ref ? ref : `${label} (${ref})`;
+    if (issue.code === 'invalid_type' && issue.input === undefined) {
+        return def?.type === 'flag' ? `missing option: ${subject}` : `missing argument: ${subject}`;
+    }
+    if (issue.code === 'invalid_type') {
+        const expected = issue.expected ?? 'valid value';
+        return `${subject}: expected ${expected}`;
+    }
+    if (issue.code === 'too_small') {
+        const min = issue.minimum;
+        const type = issue.type;
+        const unit = type === 'string' ? 'characters' : type === 'array' ? 'items' : '';
+        return `${subject}: must be at least ${min}${unit ? ` ${unit}` : ''}`;
+    }
+    if (issue.code === 'too_big') {
+        const max = issue.maximum;
+        const type = issue.type;
+        const unit = type === 'string' ? 'characters' : type === 'array' ? 'items' : '';
+        return `${subject}: must be at most ${max}${unit ? ` ${unit}` : ''}`;
+    }
+    if (issue.code === 'invalid_format') {
+        const format = issue.format;
+        return format ? `${subject}: invalid ${format}` : `${subject}: invalid format`;
+    }
+    return `${subject}: ${issue.message}`;
+}
+/**
+ * Match argv to a CLI route.
+ */
+function matchRoute(argv, routes) {
+    const sortedKeys = [...routes.keys()].sort((a, b) => {
+        const aWords = a.split(' ').length;
+        const bWords = b.split(' ').length;
+        return bWords - aWords;
+    });
+    for (const key of sortedKeys) {
+        const parts = key.split(' ');
+        let matches = true;
+        for (let i = 0; i < parts.length; i++) {
+            if (argv[i] !== parts[i]) {
+                matches = false;
+                break;
+            }
+        }
+        if (matches) {
+            return {
+                route: routes.get(key),
+                remainingArgv: argv.slice(parts.length),
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Group key for the help screen. Prefer the controller's explicit
+ * prefix; if there isn't one, fall back to the first word of a
+ * multi-word command (`user add` → group `user`). Single-word commands
+ * stay at the top level.
+ */
+function groupKey(route) {
+    if (route.prefix)
+        return route.prefix;
+    const parts = route.fullCommand.split(' ');
+    return parts.length > 1 ? parts[0] : '';
+}
+/**
+ * Generate application help text - grouped by command prefix (or by
+ * first command word when no prefix is set), with descriptions
+ * aligned so the command list is easy to scan.
+ */
+export function generateAppHelp(name, routes) {
+    const lines = [];
+    // `name === ''` is the shell-help path: we're already inside a REPL
+    // ("justscale> help"), so prefixing commands with a program name is
+    // noise. Skip the usage banner and jump straight to the command list.
+    if (name !== '') {
+        lines.push(`Usage: ${name} <command> [options]`);
+        lines.push('');
+    }
+    const byGroup = new Map();
+    for (const route of routes.values()) {
+        const key = groupKey(route);
+        if (!byGroup.has(key))
+            byGroup.set(key, []);
+        byGroup.get(key).push(route);
+    }
+    // Stable order: top-level (single-word commands) first, then
+    // namespaced groups alphabetically.
+    const ordered = [...byGroup.entries()].sort(([a], [b]) => {
+        if (a === '' && b !== '')
+            return -1;
+        if (b === '' && a !== '')
+            return 1;
+        return a.localeCompare(b);
+    });
+    const widest = Math.max(0, ...[...routes.values()].map((r) => r.fullCommand.length));
+    const colWidth = Math.min(widest, 32);
+    const padRight = (text) => text + ' '.repeat(Math.max(1, colWidth - text.length + 2));
+    let firstGroup = true;
+    for (const [group, groupRoutes] of ordered) {
+        if (!firstGroup)
+            lines.push('');
+        firstGroup = false;
+        lines.push(group === '' ? 'Commands:' : `${group}:`);
+        groupRoutes.sort((a, b) => a.fullCommand.localeCompare(b.fullCommand));
+        for (const route of groupRoutes) {
+            // Inside a named group, show the sub-command (strip the group
+            // prefix) so the repeated group noun doesn't dominate each row.
+            let shown = route.fullCommand;
+            if (group !== '' && shown.startsWith(`${group} `)) {
+                shown = shown.slice(group.length + 1);
+            }
+            const desc = route.description ? padRight(shown) + route.description : shown;
+            lines.push(`  ${desc}`);
+        }
+    }
+    lines.push('');
+    lines.push(`Run '${name} <command> --help' for details on a command.`);
+    return lines.join('\n');
+}
+/** Run CLI commands from an app. */
+export async function run(app, options = {}) {
+    const { argv = process.argv.slice(2), verbose = false, exitOnError = true, helpFlag = true, name = 'cli', } = options;
+    const routes = buildRouteMap(app);
+    const topLevelIO = options.io ??
+        createTerminalIO({
+            verbose,
+            onResult: () => { },
+        });
+    if (argv[0] === '__complete') {
+        const cursor = Number(argv[1] ?? '0');
+        const words = argv.slice(2);
+        for (const candidate of generateCompletions(words, cursor, routes.values())) {
+            topLevelIO.log(candidate);
+        }
+        return { success: true };
+    }
+    if (helpFlag &&
+        (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h')) {
+        topLevelIO.log(generateAppHelp(name, routes));
+        return { success: true };
+    }
+    const match = matchRoute(argv, routes);
+    if (!match) {
+        const error = new Error(`Unknown command: ${argv.join(' ')}`);
+        topLevelIO.error(error.message);
+        topLevelIO.error(`Run '${name} --help' for usage.`);
+        if (exitOnError)
+            process.exit(1);
+        return { success: false, error };
+    }
+    const { route: cliRoute, remainingArgv } = match;
+    // Handle --help for specific command
+    if (helpFlag && remainingArgv.includes('--help')) {
+        topLevelIO.log(generateHelp(cliRoute.fullCommand, cliRoute.argDefs, cliRoute.description));
+        return { success: true };
+    }
+    let collectedResult;
+    const io = options.io ||
+        createTerminalIO({
+            verbose,
+            resultSchema: cliRoute.resultSchema,
+            onResult: (data) => {
+                collectedResult = data;
+            },
+        });
+    const parsed = parseArgv(remainingArgv, cliRoute.argDefs);
+    if (parsed.errors.length > 0) {
+        for (const err of parsed.errors) {
+            io.error(`Error: ${err}`);
+        }
+        if (exitOnError)
+            process.exit(1);
+        return { success: false, error: new Error(parsed.errors.join('; ')) };
+    }
+    if (io.isInteractive) {
+        try {
+            await promptForMissingArgs(parsed.args, cliRoute.argDefs, io);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            io.error(err.message);
+            if (exitOnError)
+                process.exit(1);
+            return { success: false, error: err };
+        }
+    }
+    if (cliRoute.inputSchema) {
+        const result = cliRoute.inputSchema.safeParse(parsed.args);
+        if (!result.success) {
+            for (const issue of result.error.issues) {
+                const name = String(issue.path[0] ?? '');
+                const def = cliRoute.argDefs.find((d) => d.name === name);
+                io.error(`error: ${formatValidationIssue(issue, def)}`);
+                if (def?.examples && def.examples.length > 0) {
+                    const shown = def.examples.slice(0, 2).map((e) => JSON.stringify(e)).join(', ');
+                    io.error(`       example: ${shown}`);
+                }
+            }
+            io.error('');
+            io.error(generateUsage(cliRoute.fullCommand, cliRoute.argDefs));
+            io.error('');
+            io.error(`Run \`just ${cliRoute.fullCommand} --help\` for details.`);
+            if (exitOnError)
+                process.exit(1);
+            return { success: false, error: result.error };
+        }
+        Object.assign(parsed.args, result.data);
+    }
+    const context = {
+        args: parsed.args,
+        io,
+    };
+    try {
+        await runInFullRequestScope({
+            container: app.container,
+            type: 'cli',
+            name: cliRoute.fullCommand,
+            metadata: {
+                'cli.command': cliRoute.fullCommand,
+                'cli.prefix': cliRoute.prefix,
+            },
+        }, async () => {
+            const route = cliRoute.route;
+            if (route.steps && Array.isArray(route.steps)) {
+                await executeRoute(route, context);
+            }
+            else {
+                await app.execute({
+                    route: cliRoute.route,
+                    deps: cliRoute.deps,
+                    params: {},
+                }, context);
+            }
+        });
+        return { success: true, result: collectedResult };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        io.error(`Error: ${err.message}`);
+        if (verbose && err.stack) {
+            io.error(err.stack);
+        }
+        if (exitOnError)
+            process.exit(1);
+        return { success: false, error: err };
+    }
+}
+/**
+ * Invoke a CLI command programmatically.
+ * Returns typed result if the command has a result schema.
+ *
+ * @example
+ * ```typescript
+ * const result = await invoke(app, 'build', { src: './src', verbose: true });
+ * ```
+ */
+export async function invoke(app, command, args = {}) {
+    const routes = buildRouteMap(app);
+    const cliRoute = routes.get(command);
+    if (!cliRoute) {
+        throw new Error(`Unknown command: ${command}`);
+    }
+    // Validate args
+    if (cliRoute.inputSchema) {
+        const result = cliRoute.inputSchema.safeParse(args);
+        if (!result.success) {
+            throw result.error;
+        }
+        // biome-ignore lint/style/noParameterAssign: intentional transformation of validated input
+        args = result.data;
+    }
+    // Create mock IO to capture result
+    let capturedResult;
+    const io = createMockIO();
+    const originalResult = io.result.bind(io);
+    io.result = (data) => {
+        capturedResult = data;
+        originalResult(data);
+    };
+    // Build context
+    const context = {
+        args,
+        io,
+    };
+    await runInFullRequestScope({
+        container: app.container,
+        type: 'cli',
+        name: command,
+        metadata: {
+            'cli.command': command,
+            'cli.programmatic': true,
+        },
+    }, async () => {
+        const route = cliRoute.route;
+        if (route.steps && Array.isArray(route.steps)) {
+            await executeRoute(route, context);
+        }
+        else {
+            await app.execute({
+                route: cliRoute.route,
+                deps: cliRoute.deps,
+                params: {},
+            }, context);
+        }
+    });
+    return capturedResult;
+}
+/** Create a programmatic CLI client from an app. */
+export function createClient(app) {
+    const routes = buildRouteMap(app);
+    return {
+        async invoke(command, args = {}) {
+            return invoke(app, command, args);
+        },
+        routes: [...routes.keys()],
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

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

package/dist/cli/service.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Provides reflection and execution capabilities for CLI commands.
+ */
+import type { App } from '../index.js';
+import type { CliIO } from './io.js';
+/**
+ * CLI Service interface - provides command reflection and execution.
+ */
+export interface ICliService {
+    /**
+     * List all available CLI commands.
+     * Returns command names in space-separated format (e.g., "auth create-user").
+     */
+    listCommands(): string[];
+    /**
+     * Execute a CLI command with the given arguments and IO.
+     * The IO from the current handler can be passed to enable nested command output.
+     *
+     * @param command - Command name (e.g., "auth create-user")
+     * @param args - Command arguments
+     * @param io - CLI IO interface for output/input
+     * @returns The command result (if any)
+     */
+    execute(command: string, args: Record<string, unknown>, io: CliIO<unknown>): Promise<unknown>;
+    /**
+     * Render the grouped-by-prefix help text for the whole app - the
+     * same layout `just --help` shows, minus the `just ` prefix in the
+     * usage line (we're already inside a shell when calling this).
+     */
+    help(): string;
+    /**
+     * Render per-command help - the same layout `just <cmd> --help`
+     * shows. Returns null when `command` doesn't match any registered
+     * CLI route.
+     */
+    helpFor(command: string): string | null;
+}
+/**
+ * Abstract class token for dependency injection.
+ * Inject this in your controllers to access CLI capabilities.
+ */
+export declare abstract class CliService implements ICliService {
+    abstract listCommands(): string[];
+    abstract execute(command: string, args: Record<string, unknown>, io: CliIO<unknown>): Promise<unknown>;
+    abstract help(): string;
+    abstract helpFor(command: string): string | null;
+}
+/** @internal */
+export declare class LazyCliService extends CliService {
+    private _impl;
+    /** Set the real implementation. Called after app creation. */
+    setImplementation(impl: ICliService): void;
+    private get impl();
+    listCommands(): string[];
+    execute(command: string, args: Record<string, unknown>, io: CliIO<unknown>): Promise<unknown>;
+    help(): string;
+    helpFor(command: string): string | null;
+}
+/** Create a CliService instance for the given app. */
+export declare function createCliService(app: App<any>): ICliService;
+//# sourceMappingURL=service.d.ts.map

package/dist/cli/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/cli/service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAIrC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE,CAAA;IAExB;;;;;;;;OAQG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,GACjB,OAAO,CAAC,OAAO,CAAC,CAAA;IAEnB;;;;OAIG;IACH,IAAI,IAAI,MAAM,CAAA;IAEd;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CACxC;AAED;;;GAGG;AACH,8BAAsB,UAAW,YAAW,WAAW;IACrD,QAAQ,CAAC,YAAY,IAAI,MAAM,EAAE;IACjC,QAAQ,CAAC,OAAO,CACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,GACjB,OAAO,CAAC,OAAO,CAAC;IACnB,QAAQ,CAAC,IAAI,IAAI,MAAM;IACvB,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CACjD;AAED,gBAAgB;AAChB,qBAAa,cAAe,SAAQ,UAAU;IAC5C,OAAO,CAAC,KAAK,CAA4B;IAEzC,8DAA8D;IAC9D,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI1C,OAAO,KAAK,IAAI,GAKf;IAED,YAAY,IAAI,MAAM,EAAE;IAIlB,OAAO,CACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,GACjB,OAAO,CAAC,OAAO,CAAC;IAInB,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAGxC;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAmE3D"}