cli-forge 0.2.0 → 0.3.0

package/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+declare const mycli: import("../src").CLI<import("dist/packages/parser/src").ParsedArgs, import("dist/packages/parser/src").ParsedArgs>;
+export default mycli;

package/bin/cli.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const src_1 = require("../src");
+const generate_documentation_1 = require("./commands/generate-documentation");
+const init_1 = require("./commands/init");
+const mycli = (0, init_1.withInit)((0, generate_documentation_1.withGenerateDocumentation)((0, src_1.cli)('cli-forge')));
+exports.default = mycli;
+mycli.forge();
+//# sourceMappingURL=cli.js.map

package/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../../packages/cli-forge/bin/cli.ts"],"names":[],"mappings":";;;AAEA,gCAA6B;AAC7B,8EAA8E;AAC9E,0CAA2C;AAE3C,MAAM,KAAK,GAAG,IAAA,eAAQ,EAAC,IAAA,kDAAyB,EAAC,IAAA,SAAG,EAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAEpE,kBAAe,KAAK,CAAC;AAErB,KAAK,CAAC,KAAK,EAAE,CAAC"}

package/bin/commands/generate-documentation.d.ts

@@ -0,0 +1,27 @@
+import type { ParsedArgs } from '@cli-forge/parser';
+import { CLI } from '../../src';
+type GenerateDocsArgs = {
+    cli: string;
+    output: string;
+    format: string;
+    export: string;
+};
+export declare function withGenerateDocumentationArgs<T extends ParsedArgs>(cmd: CLI<T, T & GenerateDocsArgs>): CLI<T & {
+    cli: string;
+} & {
+    output: string;
+} & {
+    format: string;
+} & {
+    export: string;
+}, T & {
+    cli: string;
+} & {
+    output: string;
+} & {
+    format: string;
+} & {
+    export: string;
+}>;
+export declare function withGenerateDocumentation<T extends ParsedArgs>(cli: CLI<T>): CLI<T, T>;
+export {};

package/bin/commands/generate-documentation.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withGenerateDocumentationArgs = withGenerateDocumentationArgs;
+exports.withGenerateDocumentation = withGenerateDocumentation;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const src_1 = require("../../src");
+const documentation_1 = require("../../src/lib/documentation");
+const fs_1 = require("../utils/fs");
+function withGenerateDocumentationArgs(cmd) {
+    return cmd
+        .positional('cli', {
+        type: 'string',
+        description: 'Path to the cli that docs should be generated for.',
+        required: true,
+    })
+        .option('output', {
+        alias: ['o'],
+        type: 'string',
+        description: 'Where should the documentation be output?',
+        default: 'docs',
+    })
+        .option('format', {
+        type: 'string',
+        description: 'What format should the documentation be output in? (json, md)',
+        default: 'md',
+    })
+        .option('export', {
+        type: 'string',
+        description: 'The name of the export that contains the CLI instance. By default, docs will be generated for the default export.',
+    });
+}
+function withGenerateDocumentation(cli) {
+    return cli.command('generate-documentation', {
+        description: 'Generate documentation for the given CLI',
+        builder: withGenerateDocumentationArgs,
+        handler: async (args) => {
+            if (args.cli.startsWith('./')) {
+                args.cli = (0, node_path_1.join)(process.cwd(), args.cli);
+            }
+            const cliModule = await Promise.resolve(`${args.cli}`).then(s => require(s));
+            const cli = cliModule[args.export || 'default'] ?? cliModule;
+            if (!(cli instanceof src_1.CLI)) {
+                throw new Error(`${args.cli}${args.export ? '#' + args.export : ''} is not a CLI.`);
+            }
+            const documentation = (0, documentation_1.generateDocumentation)(cli);
+            if (args.format === 'md') {
+                await generateMarkdownDocumentation(documentation, args);
+            }
+            else if (args.format === 'json') {
+                const outfile = args.output.endsWith('json')
+                    ? args.output
+                    : (0, node_path_1.join)(args.output, cli.name + '.json');
+                const outdir = (0, node_path_1.dirname)(outfile);
+                (0, fs_1.ensureDirSync)(outdir);
+                (0, node_fs_1.writeFileSync)(outfile, JSON.stringify(documentation, null, 2));
+            }
+        },
+    });
+}
+async function generateMarkdownDocumentation(docs, args) {
+    const md = await importMarkdownFactory();
+    await generateMarkdownForSingleCommand(docs, (0, node_path_1.join)(args.output, docs.name), md);
+}
+async function generateMarkdownForSingleCommand(docs, out, md) {
+    const subcommands = docs.subcommands;
+    const outdir = subcommands.length ? out : (0, node_path_1.dirname)(out);
+    const outname = subcommands.length ? 'index' : docs.name;
+    (0, fs_1.ensureDirSync)(outdir);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outdir, outname + '.md'), md.h1(docs.name, ...[
+        docs.description,
+        getPositionalArgsFragment(docs.positionals, md),
+        getFlagArgsFragment(docs.options, md),
+        getSubcommandsFragment(docs.subcommands, md),
+    ].filter(isTruthy)));
+    for (const subcommand of docs.subcommands) {
+        await generateMarkdownForSingleCommand(subcommand, (0, node_path_1.join)(outdir, subcommand.name), md);
+    }
+}
+function formatOption(option, md) {
+    return md.h3(option.key, ...[
+        md.bold('Type:') +
+            ' ' +
+            (option.type === 'array'
+                ? `${option.items}[]`
+                : option.type),
+        option.description,
+        option.default ? md.bold('Default:') + ' ' + option.default : undefined,
+        option.required ? md.bold('Required') : undefined,
+        option.alias?.length
+            ? md.h4('Aliases', md.ul(...option.alias))
+            : undefined,
+    ].filter(isTruthy));
+}
+function getPositionalArgsFragment(positionals, md) {
+    if (positionals?.length === 0) {
+        return undefined;
+    }
+    return md.h2('Positional Arguments', ...positionals.map((positional) => formatOption(positional, md)));
+}
+function getFlagArgsFragment(options, md) {
+    if (Object.keys(options).length === 0) {
+        return undefined;
+    }
+    return md.h2('Flags', ...Object.values(options).map((option) => formatOption(option, md)));
+}
+function getSubcommandsFragment(subcommands, md) {
+    if (subcommands.length === 0) {
+        return undefined;
+    }
+    return md.h2('Subcommands', ...subcommands.map((subcommand) => md.link(`./${subcommand.name}`, subcommand.name)));
+}
+function isTruthy(value) {
+    return !!value;
+}
+async function importMarkdownFactory() {
+    try {
+        return await Promise.resolve().then(() => require('markdown-factory'));
+    }
+    catch {
+        throw new Error('Could not find markdown-factory. Please install it to generate markdown documentation.');
+    }
+}
+//# sourceMappingURL=generate-documentation.js.map

package/bin/commands/generate-documentation.js.map

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

package/bin/commands/init.d.ts

@@ -0,0 +1,22 @@
+import type { ParsedArgs } from '@cli-forge/parser';
+import { CLI } from '../../src';
+type InitArgs = {
+    cliName: string;
+    output: string;
+    format: string;
+};
+export declare function withInitArgs<T extends ParsedArgs>(cmd: CLI<T, T & InitArgs>): CLI<T & {
+    cliName: string;
+} & {
+    output: string;
+} & {
+    format: string;
+}, T & {
+    cliName: string;
+} & {
+    output: string;
+} & {
+    format: string;
+}>;
+export declare function withInit<T extends ParsedArgs>(cli: CLI<T>): CLI<T, T>;
+export {};

package/bin/commands/init.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withInitArgs = withInitArgs;
+exports.withInit = withInit;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const fs_1 = require("../utils/fs");
+const package_json_1 = require("../../package.json");
+const node_child_process_1 = require("node:child_process");
+function withInitArgs(cmd) {
+    return cmd
+        .positional('cliName', {
+        type: 'string',
+        description: 'Name of the CLI to generate.',
+        required: true,
+    })
+        .option('output', {
+        alias: ['o'],
+        type: 'string',
+        description: 'Where should the CLI be created?',
+    })
+        .option('format', {
+        type: 'string',
+        default: 'ts',
+        description: 'What format should the CLI be in? (js, ts)',
+    });
+}
+function withInit(cli) {
+    return cli.command('init', {
+        description: 'Generate a new CLI',
+        builder: withInitArgs,
+        handler: async (args) => {
+            args.output ??= process.cwd();
+            (0, fs_1.ensureDirSync)(args.output);
+            const packageJsonPath = (0, node_path_1.join)(args.output, 'package.json');
+            const cliPath = (0, node_path_1.join)(args.output, 'bin', `${args.cliName}.${args.format}`);
+            const packageJsonContent = readJsonOr(packageJsonPath, { name: args.cliName });
+            packageJsonContent.bin ??= {};
+            packageJsonContent.bin[args.cliName] = (0, node_path_1.relative)(args.output, cliPath);
+            packageJsonContent.dependencies ??= {};
+            packageJsonContent.dependencies['cli-forge'] ??= package_json_1.version;
+            (0, node_fs_1.writeFileSync)(packageJsonPath, JSON.stringify(packageJsonContent, null, 2));
+            (0, fs_1.ensureDirSync)((0, node_path_1.dirname)(cliPath));
+            (0, node_fs_1.writeFileSync)(cliPath, args.format === 'ts'
+                ? TS_CLI_CONTENTS(args.cliName)
+                : JS_CLI_CONTENTS(args.cliName));
+            const installCommand = (0, node_fs_1.existsSync)((0, node_path_1.join)(args.output, 'yarn.lock'))
+                ? 'yarn'
+                : (0, node_fs_1.existsSync)((0, node_path_1.join)(args.output, 'pnpm-lock.yaml'))
+                    ? 'pnpm'
+                    : (0, node_fs_1.existsSync)((0, node_path_1.join)(args.output, 'bun.lockb'))
+                        ? 'bun'
+                        : 'npm';
+            (0, node_child_process_1.execSync)(`${installCommand} install`);
+        },
+    });
+}
+const COMMON_CONTENTS = (name) => `const myCLI = cli('${name}')
+  .command('hello', {
+    builder: (args) => args.positional('name', {type: 'string'}),
+    handler: (args) => {
+      console.log('hello', args.name);
+    }
+  })`;
+const JS_CLI_CONTENTS = (name) => `const { cli } = require('cli-forge');
+
+${COMMON_CONTENTS(name)}
+
+module.exports = myCLI;
+
+if (require.main === module) {
+  myCLI.forge();
+}
+`;
+const TS_CLI_CONTENTS = (name) => `import { cli } from 'cli-forge';
+
+${COMMON_CONTENTS(name)}
+
+export default myCLI;
+
+if (require.main === module) {
+  myCLI.forge();
+}
+`;
+function readJsonOr(filePath, alt) {
+    try {
+        const contents = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+        return JSON.parse(contents);
+    }
+    catch {
+        return alt;
+    }
+}
+//# sourceMappingURL=init.js.map

package/bin/commands/init.js.map

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

package/bin/utils/fs.d.ts

@@ -0,0 +1 @@
+export declare function ensureDirSync(dir: string): void;

package/bin/utils/fs.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirSync = ensureDirSync;
+const node_fs_1 = require("node:fs");
+function ensureDirSync(dir) {
+    try {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    catch (e) {
+        if (!(0, node_fs_1.existsSync)(dir)) {
+            throw new Error(`Could not create directory: ${dir}`, { cause: e });
+        }
+    }
+}
+//# sourceMappingURL=fs.js.map

package/bin/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/bin/utils/fs.ts"],"names":[],"mappings":";;AAEA,sCAQC;AAVD,qCAAgD;AAEhD,SAAgB,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,IAAA,oBAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "cli-forge",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "dependencies": {
     "tslib": "^2.3.0",
-    "@cli-forge/parser": "0.2.0"
+    "@cli-forge/parser": "0.3.0"
+  },
+  "peerDependencies": {
+    "markdown-factory": "0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "markdown-factory": {
+      "optional": true
+    }
   },
   "type": "commonjs",
   "main": "./src/index.js",
@@ -14,6 +22,9 @@
     "directory": "packages/cli-forge",
     "url": "https://github.com/AgentEnder/cli-forge"
   },
+  "bin": {
+    "cli-forge": "./bin/cli.js"
+  },
   "publishConfig": {
     "access": "public"
   },

package/src/index.d.ts

@@ -1 +1,2 @@
 export * from './lib/cli-forge';
+export { default } from './lib/cli-forge';

package/src/index.js

@@ -1,5 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/cli-forge"), exports);
+var cli_forge_1 = require("./lib/cli-forge");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return cli_forge_1.default; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/cli-forge/src/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/cli-forge/src/index.ts"],"names":[],"mappings":";;;;AAAA,0DAAgC;AAChC,6CAA0C;AAAjC,oGAAA,OAAO,OAAA"}

package/src/lib/cli-forge.d.ts

@@ -4,6 +4,11 @@ export type CLICommandOptions<TInitial extends ParsedArgs, TArgs extends TInitia
     builder?: (parser: CLI<TInitial>) => CLI<TArgs>;
     handler: (args: TArgs) => void | Promise<void>;
 };
+export type ArgsOf<T extends CLI> = T extends {
+    configuration: {
+        handler: (args: infer TArgs) => void;
+    };
+} ? TArgs : never;
 /**
  * The base class for a CLI application. This class is used to define the structure of the CLI.
  *
@@ -23,9 +28,9 @@ export type CLICommandOptions<TInitial extends ParsedArgs, TArgs extends TInitia
  *   }).forge();
  * ```
  */
-export declare class CLI<T extends ParsedArgs = ParsedArgs> {
+export declare class CLI<T extends ParsedArgs = ParsedArgs, T2 extends T = T> {
     name: string;
-    protected configuration?: CLICommandOptions<T, T> | undefined;
+    configuration?: CLICommandOptions<T, T2> | undefined;
     private commands;
     private commandChain;
     private requiresCommand;
@@ -34,7 +39,7 @@ export declare class CLI<T extends ParsedArgs = ParsedArgs> {
      * @param name What should the name of the cli command be?
      * @param configuration Configuration for the current CLI command.
      */
-    constructor(name: string, configuration?: CLICommandOptions<T, T> | undefined);
+    constructor(name: string, configuration?: CLICommandOptions<T, T2> | undefined);
     /**
      * Registers a new command with the CLI.
      * @param key What should the new command be called?
@@ -63,7 +68,7 @@ export declare class CLI<T extends ParsedArgs = ParsedArgs> {
      * @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<T & { [key in TOption]: {
+    positional<TOption extends string, TOptionConfig extends OptionConfig>(name: TOption, config: TOptionConfig): CLI<T & { [key in TOption]: TOptionConfig["coerce"] extends (value: string) => infer TCoerce ? TCoerce : {
         string: string;
         number: number;
         boolean: boolean;
@@ -96,11 +101,16 @@ export declare class CLI<T extends ParsedArgs = ParsedArgs> {
      * @returns Promise that resolves when the handler completes.
      */
     forge(args?: string[]): Promise<void>;
+    getParser(): import("@cli-forge/parser").ReadonlyArgvParser<T & {
+        help: boolean;
+    }>;
+    getSubcommands(): Readonly<Record<string, CLI>>;
+    clone(): CLI<T, T2>;
 }
 /**
  * Constructs a CLI instance. See {@link CLI} for more information.
  * @param name Name for the top level CLI
  * @returns
  */
-export declare function cli(name: string): CLI<ParsedArgs>;
+export declare function cli(name: string): CLI<ParsedArgs, ParsedArgs>;
 export default cli;

package/src/lib/cli-forge.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLI = void 0;
 exports.cli = cli;
-const tslib_1 = require("tslib");
 const parser_1 = require("@cli-forge/parser");
 /**
  * The base class for a CLI application. This class is used to define the structure of the CLI.
@@ -24,6 +23,31 @@ const parser_1 = require("@cli-forge/parser");
  * ```
  */
 class CLI {
+    name;
+    configuration;
+    commands = {};
+    commandChain = [];
+    requiresCommand = false;
+    parser = new parser_1.ArgvParser({
+        unmatchedParser: (arg) => {
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            let currentCommand = this;
+            for (const command of this.commandChain) {
+                currentCommand = currentCommand.commands[command];
+            }
+            const command = currentCommand.commands[arg];
+            if (command && command.configuration) {
+                command.configuration.builder?.(command);
+                this.commandChain.push(arg);
+                return true;
+            }
+            return false;
+        },
+    }).option('help', {
+        type: 'boolean',
+        alias: ['h'],
+        description: 'Show help for the current command',
+    });
     /**
      * @param name What should the name of the cli command be?
      * @param configuration Configuration for the current CLI command.
@@ -31,31 +55,6 @@ class CLI {
     constructor(name, configuration) {
         this.name = name;
         this.configuration = configuration;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.commands = {};
-        this.commandChain = [];
-        this.requiresCommand = false;
-        this.parser = new parser_1.ArgvParser({
-            unmatchedParser: (arg) => {
-                var _a, _b;
-                // eslint-disable-next-line @typescript-eslint/no-this-alias, @typescript-eslint/no-explicit-any
-                let currentCommand = this;
-                for (const command of this.commandChain) {
-                    currentCommand = currentCommand.commands[command];
-                }
-                const command = currentCommand.commands[arg];
-                if (command && command.configuration) {
-                    (_b = (_a = command.configuration).builder) === null || _b === void 0 ? void 0 : _b.call(_a, command);
-                    this.commandChain.push(arg);
-                    return true;
-                }
-                return false;
-            },
-        }).option('help', {
-            type: 'boolean',
-            alias: ['-h'],
-            description: 'Show help for the current command',
-        });
     }
     /**
      * Registers a new command with the CLI.
@@ -65,11 +64,12 @@ class CLI {
      */
     command(key, options) {
         if (key === '$0') {
-            this.configuration = Object.assign(Object.assign({}, this.configuration), { 
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                builder: options.builder, 
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                handler: options.handler, description: options.description });
+            this.configuration = {
+                ...this.configuration,
+                builder: options.builder,
+                handler: options.handler,
+                description: options.description,
+            };
         }
         this.commands[key] = new CLI(key, options);
         this.commands[key].parser = this.parser;
@@ -85,7 +85,6 @@ class CLI {
      */
     option(name, config) {
         this.parser.option(name, config);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return this;
     }
     /**
@@ -96,8 +95,7 @@ class CLI {
      * @returns Updated CLI instance with the new positional argument registered.
      */
     positional(name, config) {
-        this.parser.option(name, config);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.parser.positional(name, config);
         return this;
     }
     /**
@@ -114,15 +112,18 @@ class CLI {
      * @returns Help text for the current command.
      */
     formatHelp() {
-        var _a, _b;
         const help = [];
         // eslint-disable-next-line @typescript-eslint/no-this-alias
         let command = this;
         for (const key of this.commandChain) {
             command = command.commands[key];
         }
-        help.push(`Usage: ${[this.name, ...this.commandChain].join(' ')}`);
-        if ((_a = command.configuration) === null || _a === void 0 ? void 0 : _a.description) {
+        help.push(`Usage: ${[
+            this.name,
+            ...this.commandChain,
+            ...command.parser.configuredPositionals.map((p) => `[${p.key}]`),
+        ].join(' ')}`);
+        if (command.configuration?.description) {
             help.push(command.configuration.description);
         }
         if (Object.keys(command.commands).length > 0) {
@@ -131,7 +132,7 @@ class CLI {
         }
         for (const key in command.commands) {
             const subcommand = command.commands[key];
-            help.push(`  ${key}${((_b = subcommand.configuration) === null || _b === void 0 ? void 0 : _b.description)
+            help.push(`  ${key}${subcommand.configuration?.description
                 ? ' - ' + subcommand.configuration.description
                 : ''}`);
         }
@@ -140,7 +141,6 @@ class CLI {
             help.push('Options:');
         }
         for (const key in this.parser.configuredOptions) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const option = this.parser.configuredOptions[key];
             help.push(`  --${key}${option.description ? ' - ' + option.description : ''}`);
         }
@@ -161,52 +161,61 @@ class CLI {
      * @param cmd The command to run.
      * @param args The arguments to pass to the command.
      */
-    runCommand(cmd, args) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            var _a;
-            try {
-                if (cmd.requiresCommand) {
-                    throw new Error(`${[this.name, ...this.commandChain].join(' ')} requires a command`);
-                }
-                if ((_a = cmd.configuration) === null || _a === void 0 ? void 0 : _a.handler) {
-                    yield cmd.configuration.handler(args);
-                }
-                else {
-                    throw new Error(`${[this.name, ...this.commandChain].join(' ')} is not implemented.`);
-                }
+    async runCommand(cmd, args) {
+        try {
+            if (cmd.requiresCommand) {
+                throw new Error(`${[this.name, ...this.commandChain].join(' ')} requires a command`);
+            }
+            if (cmd.configuration?.handler) {
+                await cmd.configuration.handler(args);
             }
-            catch (_b) {
-                process.exitCode = 1;
-                this.printHelp();
+            else {
+                throw new Error(`${[this.name, ...this.commandChain].join(' ')} is not implemented.`);
             }
-        });
+        }
+        catch (e) {
+            process.exitCode = 1;
+            console.error(e);
+            this.printHelp();
+        }
     }
     /**
      * Parses argv and executes the CLI
      * @param args argv. Defaults to process.argv.slice(2)
      * @returns Promise that resolves when the handler completes.
      */
-    forge() {
-        return tslib_1.__awaiter(this, arguments, void 0, function* (args = process.argv.slice(2)) {
-            var _a, _b, _c;
-            // Parsing the args does two things:
-            // - builds argv to pass to handler
-            // - fills the command chain + registers commands
-            const argv = this.parser.parse(args);
-            // eslint-disable-next-line @typescript-eslint/no-this-alias, @typescript-eslint/no-explicit-any
-            let currentCommand = this;
-            for (const command of this.commandChain) {
-                currentCommand = currentCommand.commands[command];
-            }
-            if (argv.help) {
-                this.printHelp();
-                return;
-            }
-            const finalArgV = currentCommand === this
-                ? ((_c = (_b = (_a = this.configuration) === null || _a === void 0 ? void 0 : _a.builder) === null || _b === void 0 ? void 0 : _b.call(_a, this).parser) !== null && _c !== void 0 ? _c : this.parser).parse(args)
-                : argv;
-            yield this.runCommand(currentCommand, finalArgV);
-        });
+    async forge(args = process.argv.slice(2)) {
+        // Parsing the args does two things:
+        // - builds argv to pass to handler
+        // - fills the command chain + registers commands
+        const argv = this.parser.parse(args);
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        let currentCommand = this;
+        for (const command of this.commandChain) {
+            currentCommand = currentCommand.commands[command];
+        }
+        if (argv.help) {
+            this.printHelp();
+            return;
+        }
+        const finalArgV = currentCommand === this
+            ? (this.configuration?.builder?.(this).parser ?? this.parser).parse(args)
+            : argv;
+        await this.runCommand(currentCommand, finalArgV);
+    }
+    getParser() {
+        return this.parser.asReadonly();
+    }
+    getSubcommands() {
+        return this.commands;
+    }
+    clone() {
+        const clone = new CLI(this.name, this.configuration);
+        clone.commands = { ...this.commands };
+        clone.commandChain = [...this.commandChain];
+        clone.requiresCommand = this.requiresCommand;
+        clone.parser = this.parser.clone();
+        return clone;
     }
 }
 exports.CLI = CLI;

package/src/lib/cli-forge.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-forge.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/cli-forge.ts"],"names":[],"mappings":";;;AAgSA,kBAEC;;AAlSD,8CAK2B;AAW3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,GAAG;IA0Bd;;;OAGG;IACH,YACS,IAAY,EACT,aAAuC;QAD1C,SAAI,GAAJ,IAAI,CAAQ;QACT,kBAAa,GAAb,aAAa,CAA0B;QA/BnD,8DAA8D;QACtD,aAAQ,GAA6B,EAAE,CAAC;QACxC,iBAAY,GAAa,EAAE,CAAC;QAC5B,oBAAe,GAAG,KAAK,CAAC;QACxB,WAAM,GAAG,IAAI,mBAAU,CAAI;YACjC,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;;gBACvB,gGAAgG;gBAChG,IAAI,cAAc,GAAa,IAAI,CAAC;gBACpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACxC,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACpD,CAAC;gBACD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC7C,IAAI,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;oBACrC,MAAA,MAAA,OAAO,CAAC,aAAa,EAAC,OAAO,mDAAG,OAAO,CAAC,CAAC;oBACzC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC5B,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,CAAC,IAAI,CAAC;YACb,WAAW,EAAE,mCAAmC;SACjD,CAAC,CAAC;IASA,CAAC;IAEJ;;;;;OAKG;IACH,OAAO,CAAkB,GAAW,EAAE,OAAoC;QACxE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,aAAa,mCACb,IAAI,CAAC,aAAa;gBACrB,8DAA8D;gBAC9D,OAAO,EAAE,OAAO,CAAC,OAAc;gBAC/B,8DAA8D;gBAC9D,OAAO,EAAE,OAAO,CAAC,OAAc,EAC/B,WAAW,EAAE,OAAO,CAAC,WAAW,GACjC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAQ,GAAG,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,IAAa,EACb,MAAqB;QAErB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,8DAA8D;QAC9D,OAAO,IAiBN,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CACR,IAAa,EACb,MAAqB;QAErB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,8DAA8D;QAC9D,OAAO,IAaN,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,UAAU;;QACR,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,4DAA4D;QAC5D,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,MAAA,OAAO,CAAC,aAAa,0CAAE,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,CACP,KAAK,GAAG,GACN,CAAA,MAAA,UAAU,CAAC,aAAa,0CAAE,WAAW;gBACnC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,WAAW;gBAC9C,CAAC,CAAC,EACN,EAAE,CACH,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAChD,8DAA8D;YAC9D,MAAM,MAAM,GAAI,IAAI,CAAC,MAAM,CAAC,iBAAyB,CACnD,GAAG,CACY,CAAC;YAClB,IAAI,CAAC,IAAI,CACP,OAAO,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CACpE,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,CACP,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAC7C,GAAG,CACJ,uDAAuD,CACzD,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACG,UAAU,CAAuB,GAAW,EAAE,IAAO;;;YACzD,IAAI,CAAC;gBACH,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;oBACxB,MAAM,IAAI,KAAK,CACb,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,CACpE,CAAC;gBACJ,CAAC;gBACD,IAAI,MAAA,GAAG,CAAC,aAAa,0CAAE,OAAO,EAAE,CAAC;oBAC/B,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CACb,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CACrE,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,WAAM,CAAC;gBACP,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;KAAA;IAED;;;;OAIG;IACG,KAAK;qEAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;;YAChD,oCAAoC;YACpC,mCAAmC;YACnC,iDAAiD;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,gGAAgG;YAChG,IAAI,cAAc,GAAa,IAAI,CAAC;YACpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxC,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GACb,cAAc,KAAK,IAAI;gBACrB,CAAC,CAAC,CAAC,MAAA,MAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,OAAO,mDAAG,IAAI,EAAE,MAAM,mCAAI,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAC/D,IAAI,CACL;gBACH,CAAC,CAAC,IAAI,CAAC;YAEX,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;KAAA;CACF;AAtPD,kBAsPC;AAED;;;;GAIG;AACH,SAAgB,GAAG,CAAC,IAAY;IAC9B,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,kBAAe,GAAG,CAAC"}
+{"version":3,"file":"cli-forge.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/cli-forge.ts"],"names":[],"mappings":"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"}

package/src/lib/documentation.d.ts

@@ -0,0 +1,36 @@
+import { OptionConfig } from '@cli-forge/parser';
+import { CLI } from './cli-forge';
+export type Documentation = {
+    name: string;
+    description?: string;
+    options: Readonly<Record<string, OptionConfig & {
+        key: string;
+    }>>;
+    positionals: readonly Readonly<OptionConfig & {
+        key: string;
+    }>[];
+    subcommands: Documentation[];
+};
+export declare function generateDocumentation(cli: CLI): {
+    name: string;
+    description: string | undefined;
+    options: Readonly<{
+        unmatched: OptionConfig<any> & {
+            key: string;
+            position?: number;
+        };
+        '--'?: (OptionConfig<any> & {
+            key: string;
+            position?: number;
+        }) | undefined;
+        help: OptionConfig<any> & {
+            key: string;
+            position?: number;
+        };
+    }>;
+    positionals: readonly Readonly<OptionConfig<any> & {
+        key: string;
+        position?: number;
+    }>[];
+    subcommands: Documentation[];
+};

package/src/lib/documentation.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDocumentation = generateDocumentation;
+function generateDocumentation(cli) {
+    // Ensure current command's options are built.
+    if (cli.configuration?.builder) {
+        cli.configuration.builder(cli);
+    }
+    const parser = cli.getParser();
+    const options = parser.configuredOptions;
+    const positionals = parser.configuredPositionals;
+    const subcommands = Object.values(cli.getSubcommands()).map((cmd) => generateDocumentation(cmd.clone()));
+    return {
+        name: cli.name,
+        description: cli.configuration?.description,
+        options,
+        positionals,
+        subcommands,
+    };
+}
+//# sourceMappingURL=documentation.js.map

package/src/lib/documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.js","sourceRoot":"","sources":["../../../../../packages/cli-forge/src/lib/documentation.ts"],"names":[],"mappings":";;AAWA,sDAoBC;AApBD,SAAgB,qBAAqB,CAAC,GAAQ;IAC5C,8CAA8C;IAC9C,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC/B,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,CAAC,qBAAqB,CAAC;IACjD,MAAM,WAAW,GAAoB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,CAC1E,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAC5C,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,aAAa,EAAE,WAAW;QAC3C,OAAO;QACP,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC"}