cli-forge 0.10.1 → 0.12.0

package/{src → dist}/lib/interactive-shell.d.ts

@@ -8,6 +8,6 @@ export declare class InteractiveShell {
     private readonly rl;
     private listeners;
     constructor(cli: InternalCLI<any>, opts?: InteractiveShellOptions);
-    registerLineListener(callback: (line: string) => Promise<void>): void;
+    registerLineListener(callback: (line: string) => Promise<boolean | void>): void;
     close(): void;
 }

package/{src → dist}/lib/interactive-shell.js

@@ -38,7 +38,7 @@ class InteractiveShell {
             output: process.stdout,
             prompt: prompt,
         })
-            .on('SIGINT', () => {
+            .once('SIGINT', () => {
             process.emit('SIGINT');
         });
         this.rl.prompt();
@@ -61,6 +61,7 @@ class InteractiveShell {
             }
             else if (nextArgs[0] === 'exit') {
                 this.close();
+                return true;
             }
             else if (line.trim()) {
                 try {
@@ -70,13 +71,15 @@ class InteractiveShell {
                     // ignore
                 }
             }
+            return false;
         });
     }
     registerLineListener(callback) {
         const wrapped = async (line) => {
             this.rl.pause();
-            await callback(line);
-            this.rl.prompt();
+            const shouldHalt = await callback(line);
+            if (!shouldHalt)
+                this.rl.prompt();
         };
         this.listeners.push(wrapped);
         this.rl.on('line', wrapped);

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

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

package/{src → dist}/lib/internal-cli.d.ts

@@ -19,16 +19,21 @@ import { CLI, CLICommandOptions, Command, ErrorHandler } from './public-api';
  *   }).forge();
  * ```
  */
-export declare class InternalCLI<TArgs extends ParsedArgs = ParsedArgs> implements CLI<TArgs> {
+export declare class InternalCLI<TArgs extends ParsedArgs = ParsedArgs, THandlerReturn = void, TChildren = {}, TParent = undefined> implements CLI<TArgs, THandlerReturn, TChildren, TParent> {
     name: string;
     /**
      * For internal use only. Stick to properties available on {@link CLI}.
      */
-    registeredCommands: Record<string, InternalCLI<any>>;
+    registeredCommands: Record<string, InternalCLI<any, any, any, any>>;
     /**
      * For internal use only. Stick to properties available on {@link CLI}.
      */
     commandChain: string[];
+    /**
+     * Reference to the parent CLI instance, if this command was registered as a subcommand.
+     * For internal use only. Use `getParent()` instead.
+     */
+    private _parent?;
     private requiresCommand;
     private _configuration?;
     private _versionOverride?;
@@ -68,19 +73,24 @@ export declare class InternalCLI<TArgs extends ParsedArgs = ParsedArgs> implemen
      * @param name What should the name of the cli command be?
      * @param configuration Configuration for the current CLI command.
      */
-    constructor(name: string, rootCommandConfiguration?: CLICommandOptions<TArgs>);
-    withRootCommandConfiguration<TRootCommandArgs extends TArgs>(configuration: CLICommandOptions<TArgs, TRootCommandArgs>): InternalCLI<TArgs>;
-    command<TCommandArgs extends TArgs>(keyOrCommand: string | Command<TArgs, TCommandArgs>, options?: CLICommandOptions<TArgs, TCommandArgs>): CLI<TArgs>;
-    commands(...a0: Command[] | Command[][]): CLI<TArgs>;
-    option<TOption extends string, TOptionConfig extends OptionConfig>(name: TOption, config: TOptionConfig): any;
-    positional<TOption extends string, TOptionConfig extends OptionConfig>(name: TOption, config: TOptionConfig): any;
-    conflicts(...args: [string, string, ...string[]]): CLI<TArgs>;
-    implies(option: string, ...impliedOptions: string[]): CLI<TArgs>;
-    env(a0?: string | EnvOptionConfig | undefined): this;
-    demandCommand(): this;
-    usage(usageText: string): this;
-    examples(...examples: string[]): this;
-    version(version?: string): this;
+    constructor(name: string, rootCommandConfiguration?: CLICommandOptions<TArgs, any, THandlerReturn, TChildren>);
+    withRootCommandConfiguration<TRootCommandArgs extends TArgs>(configuration: CLICommandOptions<TArgs, TRootCommandArgs>): InternalCLI<TArgs, THandlerReturn, TChildren, TParent>;
+    command<TCommandArgs extends TArgs>(cmd: Command<TArgs, TCommandArgs>): CLI<TArgs, THandlerReturn, TChildren & (typeof cmd extends Command<TArgs, infer TCmdArgs, infer TCmdName> ? {
+        [key in TCmdName]: CLI<TCmdArgs, void, {}, CLI<TArgs, THandlerReturn, TChildren, TParent>>;
+    } : {}), TParent>;
+    command<TCommandArgs extends TArgs, TChildHandlerReturn = void, TCommandName extends string = string>(key: TCommandName, options: CLICommandOptions<TArgs, TCommandArgs, TChildHandlerReturn>): CLI<TArgs, THandlerReturn, TChildren & {
+        [key in TCommandName]: CLI<TCommandArgs, TChildHandlerReturn, {}, CLI<TArgs, THandlerReturn, TChildren, TParent>>;
+    }, TParent>;
+    commands(...a0: Command[] | Command[][]): any;
+    option<TOption extends string, const TOptionConfig extends OptionConfig<any, any, any, any>>(name: TOption, config: TOptionConfig): any;
+    positional<TOption extends string, const TOptionConfig extends OptionConfig<any, any, any, any>>(name: TOption, config: TOptionConfig): any;
+    conflicts(...args: [string, string, ...string[]]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    implies(option: string, ...impliedOptions: string[]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    env(a0?: string | EnvOptionConfig | undefined): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    demandCommand(): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    usage(usageText: string): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    examples(...examples: string[]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    version(version?: string): CLI<TArgs, THandlerReturn, TChildren, TParent>;
     /**
      * Gets help text for the current command as a string.
      * @returns Help text for the current command.
@@ -90,23 +100,30 @@ export declare class InternalCLI<TArgs extends ParsedArgs = ParsedArgs> implemen
      * Prints help text for the current command to the console.
      */
     printHelp(): void;
-    middleware(callback: (args: TArgs) => void): CLI<TArgs>;
+    middleware<TArgs2>(callback: (args: TArgs) => TArgs2 | Promise<TArgs2>): CLI<TArgs2 extends void ? TArgs : TArgs & TArgs2, THandlerReturn, TChildren, TParent>;
     /**
      * Runs the current command.
      * @param cmd The command to run.
      * @param args The arguments to pass to the command.
      */
     runCommand<T extends ParsedArgs>(args: T, originalArgV: string[]): Promise<void>;
-    enableInteractiveShell(): this;
+    getChildren(): TChildren;
+    getParent(): TParent;
+    getBuilder<T extends ParsedArgs = {
+        unmatched: string[];
+        '--'?: string[];
+    }>(_?: CLI<T, any, any> | undefined): ((parser: CLI<T, any, any>) => CLI<TArgs, THandlerReturn, TChildren>) | undefined;
+    getHandler(): ((args: Omit<TArgs, keyof ParsedArgs>) => THandlerReturn) | undefined;
+    enableInteractiveShell(): CLI<TArgs, THandlerReturn, TChildren, TParent>;
     private versionHandler;
     private withErrorHandlers;
-    errorHandler(handler: ErrorHandler): this;
+    errorHandler(handler: ErrorHandler): CLI<TArgs, THandlerReturn, TChildren, TParent>;
     group(labelOrConfigObject: string | {
         label: string;
         keys: (keyof TArgs)[];
         sortOrder: number;
-    }, keys?: (keyof TArgs)[]): CLI<TArgs>;
-    config(provider: ConfigurationFiles.ConfigurationProvider<TArgs>): CLI<TArgs>;
+    }, keys?: (keyof TArgs)[]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    config(provider: ConfigurationFiles.ConfigurationProvider<TArgs>): CLI<TArgs, THandlerReturn, TChildren, TParent>;
     /**
      * Parses argv and executes the CLI
      * @param args argv. Defaults to process.argv.slice(2)
@@ -119,5 +136,5 @@ export declare class InternalCLI<TArgs extends ParsedArgs = ParsedArgs> implemen
         version: boolean | undefined;
     }>;
     getSubcommands(): Readonly<Record<string, InternalCLI>>;
-    clone(): InternalCLI<TArgs>;
+    clone(): InternalCLI<TArgs, THandlerReturn, TChildren, TParent>;
 }

package/{src → dist}/lib/internal-cli.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalCLI = void 0;
+/* eslint-disable @typescript-eslint/ban-types */
 const parser_1 = require("@cli-forge/parser");
 const utils_1 = require("./utils");
 const interactive_shell_1 = require("./interactive-shell");
@@ -35,6 +36,11 @@ class InternalCLI {
      * For internal use only. Stick to properties available on {@link CLI}.
      */
     commandChain = [];
+    /**
+     * Reference to the parent CLI instance, if this command was registered as a subcommand.
+     * For internal use only. Use `getParent()` instead.
+     */
+    _parent;
     requiresCommand = 'IMPLICIT';
     _configuration;
     _versionOverride;
@@ -132,6 +138,7 @@ class InternalCLI {
                 });
             }
             const cmd = new InternalCLI(key).withRootCommandConfiguration(options);
+            cmd._parent = this;
             this.registeredCommands[key] = cmd;
             if (options.alias) {
                 for (const alias of options.alias) {
@@ -141,6 +148,7 @@ class InternalCLI {
         }
         else if (keyOrCommand instanceof InternalCLI) {
             const cmd = keyOrCommand;
+            cmd._parent = this;
             this.registeredCommands[cmd.name] = cmd;
             if (cmd.configuration?.alias) {
                 for (const alias of cmd.configuration.alias) {
@@ -158,6 +166,7 @@ class InternalCLI {
         const commands = a0.flat();
         for (const val of commands) {
             if (val instanceof InternalCLI) {
+                val._parent = this;
                 this.registeredCommands[val.name] = val;
                 // Include any options that were defined via cli(...).option() instead of via builder
                 this.parser.augment(val.parser);
@@ -231,6 +240,9 @@ class InternalCLI {
     }
     middleware(callback) {
         this.registeredMiddleware.push(callback);
+        // If middleware returns void, TArgs doesn't change...
+        // If it returns something, we need to merge it into TArgs...
+        // that's not here though, its where we apply the middleware results.
         return this;
     }
     /**
@@ -254,9 +266,13 @@ class InternalCLI {
             }
             if (cmd.configuration?.handler) {
                 for (const middleware of middlewares) {
-                    await middleware(args);
+                    const middlewareResult = await middleware(args);
+                    if (middlewareResult !== void 0 &&
+                        typeof middlewareResult === 'object') {
+                        args = middlewareResult;
+                    }
                 }
-                await cmd.configuration.handler(args, {
+                return cmd.configuration.handler(args, {
                     command: cmd,
                 });
             }
@@ -292,6 +308,36 @@ class InternalCLI {
             this.printHelp();
         }
     }
+    getChildren() {
+        // Return a copy of registered commands, excluding aliases (same command registered under different keys)
+        const children = {};
+        const seen = new Set();
+        for (const [key, cmd] of Object.entries(this.registeredCommands)) {
+            if (!seen.has(cmd)) {
+                seen.add(cmd);
+                children[key] = cmd;
+            }
+        }
+        return children;
+    }
+    getParent() {
+        return this._parent;
+    }
+    getBuilder(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- This is used to help TS infer T correctly
+    _) {
+        return this.configuration?.builder;
+    }
+    getHandler() {
+        const context = {
+            command: this,
+        };
+        const handler = this._configuration?.handler;
+        if (!handler) {
+            return undefined;
+        }
+        return (args) => handler(args, context);
+    }
     enableInteractiveShell() {
         if (this.requiresCommand === 'EXPLICIT') {
             throw new Error('Interactive shell is not supported for commands that require a command.');
@@ -419,7 +465,6 @@ class InternalCLI {
         clone.registeredCommands = {};
         for (const command in this.registeredCommands ?? {}) {
             clone.command(this.registeredCommands[command].clone());
-            // this.registeredCommands[command].clone();
         }
         clone.commandChain = [...this.commandChain];
         clone.requiresCommand = this.requiresCommand;

package/dist/lib/internal-cli.js.map

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

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

@@ -0,0 +1,332 @@
+import { type ConfigurationFiles, OptionConfig, OptionConfigToType, ParsedArgs, EnvOptionConfig, ObjectOptionConfig, StringOptionConfig, NumberOptionConfig, BooleanOptionConfig, ArrayOptionConfig, ResolveProperties, WithOptional, MakeUndefinedPropertiesOptional, WithAdditionalProperties } from '@cli-forge/parser';
+import { InternalCLI } from './internal-cli';
+/**
+ * Extracts the command name from a Command type.
+ * Works with both CLI instances and command config objects.
+ */
+export type ExtractCommandName<T> = T extends CLI<any, any, any> ? T extends InternalCLI<any, any, any> ? string : string : T extends {
+    name: infer N;
+} ? N extends string ? N : string : string;
+/**
+ * Extracts the args type from a Command.
+ * Works with both CLI instances and command config objects.
+ */
+export type ExtractCommandArgs<T> = T extends CLI<infer A, any, any> ? A : T extends CLICommandOptions<any, infer A, any, any> ? A : ParsedArgs;
+/**
+ * Extracts the handler return type from a Command.
+ */
+export type ExtractCommandHandlerReturn<T> = T extends CLI<any, infer R, any> ? R : T extends CLICommandOptions<any, any, infer R, any> ? R : void;
+/**
+ * Converts a Command to its child CLI entry for TChildren tracking.
+ * TParentCLI is the parent CLI type that will be set as the child's TParent.
+ */
+export type CommandToChildEntry<T, TParentCLI = undefined> = {
+    [K in ExtractCommandName<T>]: CLI<ExtractCommandArgs<T>, ExtractCommandHandlerReturn<T>, {}, TParentCLI>;
+};
+/**
+ * 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, THandlerReturn = void, TChildren = {}, TParent = undefined> {
+    command<TCommandArgs extends TArgs>(cmd: Command<TArgs, TCommandArgs>): CLI<TArgs, THandlerReturn, TChildren & (typeof cmd extends Command<TArgs, infer TCommandArgs, infer TCmdName> ? {
+        [key in TCmdName]: CLI<TCommandArgs, void, {}, CLI<TArgs, THandlerReturn, TChildren, TParent>>;
+    } : {}), TParent>;
+    /**
+     * 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, TChildHandlerReturn, TKey extends string, TChildChildren = {}>(key: TKey, options: CLICommandOptions<TArgs, TCommandArgs, TChildHandlerReturn, any, CLI<TArgs, THandlerReturn, TChildren, TParent>, TChildChildren>): CLI<TArgs, THandlerReturn, TChildren & {
+        [key in TKey]: CLI<TCommandArgs, TChildHandlerReturn, TChildChildren, CLI<TArgs, THandlerReturn, TChildren, TParent>>;
+    }, TParent>;
+    /**
+     * 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.
+     * @returns Updated CLI instance with the commands registered and their types tracked in TChildren.
+     */
+    commands<C1 extends Command>(c1: C1): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command>(c1: C1, c2: C2): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command>(c1: C1, c2: C2, c3: C3): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command, C5 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4, c5: C5): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C5, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command, C5 extends Command, C6 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4, c5: C5, c6: C6): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C5, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C6, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command, C5 extends Command, C6 extends Command, C7 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4, c5: C5, c6: C6, c7: C7): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C5, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C6, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C7, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command, C5 extends Command, C6 extends Command, C7 extends Command, C8 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4, c5: C5, c6: C6, c7: C7, c8: C8): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C5, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C6, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C7, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C8, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command, C5 extends Command, C6 extends Command, C7 extends Command, C8 extends Command, C9 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4, c5: C5, c6: C6, c7: C7, c8: C8, c9: C9): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C5, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C6, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C7, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C8, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C9, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands<C1 extends Command, C2 extends Command, C3 extends Command, C4 extends Command, C5 extends Command, C6 extends Command, C7 extends Command, C8 extends Command, C9 extends Command, C10 extends Command>(c1: C1, c2: C2, c3: C3, c4: C4, c5: C5, c6: C6, c7: C7, c8: C8, c9: C9, c10: C10): CLI<TArgs, THandlerReturn, TChildren & CommandToChildEntry<C1, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C2, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C3, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C4, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C5, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C6, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C7, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C8, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C9, CLI<TArgs, THandlerReturn, TChildren, TParent>> & CommandToChildEntry<C10, CLI<TArgs, THandlerReturn, TChildren, TParent>>, TParent>;
+    commands(commands: Command[]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    commands(...commands: Command[]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    /**
+     * Register's a configuration provider for the CLI. See {@link ConfigurationProviders} for built-in providers.
+     *
+     * @param provider Provider to register.
+     */
+    config(provider: ConfigurationFiles.ConfigurationProvider<TArgs>): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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 UnknownOptionConfig}.
+     * @returns Updated CLI instance with the new option registered.
+     */
+    option<TOption extends string, TCoerce, const TProps extends Record<string, {
+        type: string;
+    }>, TAdditionalProps extends false | 'string' | 'number' | 'boolean' = false>(name: TOption, config: ObjectOptionConfig<TCoerce, TProps, TAdditionalProps>): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: WithOptional<unknown extends TCoerce ? WithAdditionalProperties<ResolveProperties<TProps>, TAdditionalProps> : TCoerce, ObjectOptionConfig<TCoerce, TProps, TAdditionalProps>>;
+    }>, THandlerReturn, TChildren, TParent>;
+    option<TOption extends string, const TConfig extends StringOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    option<TOption extends string, const TConfig extends NumberOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    option<TOption extends string, const TConfig extends BooleanOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    option<TOption extends string, const TConfig extends ArrayOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    option<TOption extends string, const TOptionConfig extends OptionConfig<any, any, any, any>>(name: TOption, config: TOptionConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TOptionConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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 UnknownOptionConfig}.
+     * @returns Updated CLI instance with the new positional argument registered.
+     */
+    positional<TOption extends string, TCoerce, const TProps extends Record<string, {
+        type: string;
+    }>, TAdditionalProps extends false | 'string' | 'number' | 'boolean' = false>(name: TOption, config: ObjectOptionConfig<TCoerce, TProps, TAdditionalProps>): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: WithOptional<unknown extends TCoerce ? WithAdditionalProperties<ResolveProperties<TProps>, TAdditionalProps> : TCoerce, ObjectOptionConfig<TCoerce, TProps, TAdditionalProps>>;
+    }>, THandlerReturn, TChildren, TParent>;
+    positional<TOption extends string, const TConfig extends StringOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    positional<TOption extends string, const TConfig extends NumberOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    positional<TOption extends string, const TConfig extends BooleanOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    positional<TOption extends string, const TConfig extends ArrayOptionConfig<any, any>>(name: TOption, config: TConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    positional<TOption extends string, const TOptionConfig extends OptionConfig<any, any, any, any>>(name: TOption, config: TOptionConfig): CLI<TArgs & MakeUndefinedPropertiesOptional<{
+        [key in TOption]: OptionConfigToType<TOptionConfig>;
+    }>, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    env(options: EnvOptionConfig): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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, THandlerReturn, TChildren, TParent>;
+    /**
+     * Prints help text to stdout.
+     */
+    printHelp(): void;
+    group({ label, keys, sortOrder, }: {
+        label: string;
+        keys: (keyof TArgs)[];
+        sortOrder: number;
+    }): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    group(label: string, keys: (keyof TArgs)[]): CLI<TArgs, THandlerReturn, TChildren, TParent>;
+    middleware<TArgs2>(callback: MiddlewareFunction<TArgs, TArgs2>): CLI<TArgs2 extends void ? TArgs : TArgs & TArgs2, THandlerReturn, TChildren, TParent>;
+    /**
+     * 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>;
+    /**
+     * Returns the typed children commands registered with this CLI.
+     * The return type is determined by the commands registered via `command()` or `commands()`.
+     *
+     * @example
+     * ```ts
+     * const app = cli('app')
+     *   .command('init', { ... })
+     *   .command('build', { ... });
+     *
+     * const children = app.getChildren();
+     * // children.init and children.build are typed CLI instances
+     * const initHandler = children.init.getHandler();
+     * ```
+     */
+    getChildren(): TChildren;
+    /**
+     * Returns the parent CLI instance, if this command was registered as a subcommand.
+     * Returns undefined for root-level CLI instances.
+     *
+     * @example
+     * ```ts
+     * const build = cli('build', {
+     *   handler: (args, ctx) => {
+     *     const parent = ctx.command.getParent();
+     *     const siblings = parent?.getChildren();
+     *     // Access sibling commands
+     *   }
+     * });
+     * ```
+     */
+    getParent(): TParent;
+    getBuilder<T extends ParsedArgs = ParsedArgs>(initialCli?: CLI<T, any, any>): ((parser: CLI<T, any, any>) => CLI<TArgs, THandlerReturn, TChildren>) | undefined;
+    getHandler(): ((args: Omit<TArgs, keyof ParsedArgs>) => THandlerReturn) | undefined;
+}
+export interface CLIHandlerContext<TChildren = {}, TParent = any> {
+    command: CLI<any, any, TChildren, TParent>;
+}
+/**
+ * Extracts the TChildren type parameter from a CLI type.
+ */
+export type ExtractCLIChildren<T> = T extends CLI<any, any, infer C, any> ? C : {};
+/**
+ * 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, THandlerReturn = void, 
+/**
+ * The children commands that exist before the builder runs.
+ */
+TInitialChildren = {}, TParent = any, 
+/**
+ * The children commands after the builder runs (includes TInitialChildren plus any added by builder).
+ */
+TChildren = {}> {
+    /**
+     * If set the command will be registered under the provided name and any aliases.
+     *
+     * This can be useful if a command should be executed under more than one name, e.g. `npx my-cli` and `npx my-cli hello`.
+     */
+    alias?: string[];
+    /**
+     * 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, any, TInitialChildren, TParent>) => CLI<TArgs, any, TChildren, any>;
+    /**
+     * 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: NoInfer<TArgs>, context: CLIHandlerContext<NoInfer<TChildren>, TParent>) => THandlerReturn;
+    /**
+     * 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, TCommandName extends string = string> = ({
+    name: TCommandName;
+} & 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;
+export type UnknownCLI = CLI<ParsedArgs, any, any, any>;
+export type MiddlewareFunction<TArgs extends ParsedArgs, TArgs2> = (args: TArgs) => TArgs2 | Promise<TArgs2>;
+/**
+ * Constructs a CLI instance. See {@link CLI} 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 CLI} instance.
+ */
+export declare function cli<TArgs extends ParsedArgs, THandlerReturn = void, TChildren = {}, TName extends string = string>(name: TName, rootCommandConfiguration?: CLICommandOptions<ParsedArgs, TArgs, THandlerReturn, {}, any, TChildren>): CLI<TArgs, THandlerReturn, TChildren>;
+export default cli;

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/lib/public-api.ts"],"names":[],"mappings":";;AAs5BA,kBAsBC;AA15BD,iDAA6C;AA83B7C;;;;;GAKG;AACH,SAAgB,GAAG,CAOjB,IAAW,EACX,wBAOC;IAED,OAAO,IAAI,0BAAW,CAAC,IAAI,EAAE,wBAA+B,CAI3D,CAAC;AACJ,CAAC;AAED,kBAAe,GAAG,CAAC"}