@reliverse/rempts 1.7.29 → 1.7.31

package/README.md

@@ -28,6 +28,7 @@
 - 🏞️ no more hacking together `inquirer`/`citty`/`commander`/`chalk`
 - 🆕 automatic command creation (`bun dler rempts --init cmd1 cmd2`)
 - 🐦‍🔥 automatic creation of `src/app/cmds.ts` file (`bun dler rempts`)
+- 🔌 tRPC/ORPC router integration - automatically generate CLI commands from your RPC procedures
 
 ## Installation
 
@@ -59,14 +60,13 @@ All main prompts APIs are available from the package root:
 ```ts
 import {
   // ...prompts
-  defineCommand, runMain, defineArgs,
   inputPrompt, selectPrompt, multiselectPrompt, numberPrompt,
   confirmPrompt, togglePrompt, taskSpinPrompt, taskProgressPrompt,
   startPrompt, endPrompt, resultPrompt, nextStepsPrompt,
   // ...hooks
   useSpinner,
   // ...launcher
-  runMain, defineCommand, defineArgs,
+  createCli, defineCommand, defineArgs,
   // ...types
   // ...more
 } from "@reliverse/rempts";
@@ -218,6 +218,8 @@ await main();
 
 ## Launcher
 
+> **Note**: `runMain` is now an alias for `createCli` and is still supported for backward compatibility. The new `createCli` API provides a more intuitive object-based configuration format.
+
 ### Terminology
 
 - **Launcher/Router**: The main entry point for your CLI. Visit [CLI Launcher (Router)](#cli-launcher-router) section to learn more.
@@ -228,12 +230,12 @@ await main();
 
 #### Launcher Usage Example
 
-**Important**: Ensure your commands don't have `await main();`, `await runMain();`, or something like that — to prevent any unexpected behavior. Only main command should have it.
+**Important**: Ensure your commands don't have `await main();`, `await createCli();`, or something like that — to prevent any unexpected behavior. Only main command should have it.
 
 ```ts
 import { relinka } from "@reliverse/relinka";
 
-import { defineCommand, runMain } from "@reliverse/rempts";
+import { defineCommand, createCli } from "@reliverse/rempts";
 
 const main = defineCommand({
   meta: {
@@ -254,12 +256,20 @@ const main = defineCommand({
   },
 });
 
-await runMain(main);
-```
+// New object format (recommended)
+await createCli({
+  mainCommand: main,
+  fileBased: {
+    enable: true,
+    cmdsRootPath: "my-cmds", // default is `./app`
+  },
+  // Optionally disable auto-exit to handle errors manually:
+  autoExit: false,
+});
 
-```ts
-await runMain(myCommand, {
-  fileBasedCmds: {
+// Legacy format (still supported)
+await createCli(main, {
+  fileBased: {
     enable: true,
     cmdsRootPath: "my-cmds", // default is `./app`
   },
@@ -355,6 +365,48 @@ See [example/launcher/app/nested](./example/launcher/app/nested/) and [example/l
 
 When playing with the example, you can run e.g. `bun dev:modern nested foo bar baz` to see the result in action.
 
+## RPC Integration
+
+Rempts now supports seamless integration with tRPC and ORPC routers, allowing you to automatically generate CLI commands from your RPC procedures. This provides a powerful way to expose your API endpoints as command-line tools.
+
+```typescript
+import { z } from "zod";
+import { initTRPC } from "@trpc/server";
+import { createCli } from "@reliverse/rempts";
+
+const t = initTRPC.create();
+
+const appRouter = t.router({
+  hello: t.procedure
+    .input(z.object({ name: z.string().optional() }))
+    .query(({ input }) => `Hello ${input.name ?? "World"}!`),
+  
+  add: t.procedure
+    .input(z.object({ a: z.number(), b: z.number() }))
+    .mutation(({ input }) => input.a + input.b)
+});
+
+// Automatically generates CLI commands from your tRPC procedures
+await createCli({
+  name: "my-cli",
+  rpc: { router: appRouter }
+});
+```
+
+**Features:**
+
+- 🚀 Automatic CLI generation from tRPC procedures
+- 🔄 Support for both tRPC v10 and v11
+- 🏗️ Nested command structures from sub-routers
+- ✅ Input validation from Zod schemas
+- 📖 Automatic help generation from procedure metadata
+- 🎯 Full TypeScript support with type inference
+- 🎨 Interactive prompts for missing arguments
+- ⌨️ Shell completion support
+- 🔧 Customizable logging and error handling
+
+See [RPC Integration Guide](./docs/launcher-rpc.md) for detailed documentation and examples.
+
 ### Playground
 
 ```bash
@@ -368,6 +420,12 @@ bun dev
 - `bun dev:modern`: This example will show you a modern CLI launcher usage with file-based commands.
 - `bun dev:classic`: This example will show you a classic CLI launcher usage with programmatic commands.
 
+### tRPC/oRPC Integration Example Commands
+
+```bash
+bun example/trpc-orpc/rempts/effect-primary.ts create-profile --name 'Jane Smith' --age 28 --bio 'Software Engineer' --tags 'developer,typescript'
+```
+
 ### Launcher Usage Examples
 
 #### Minimal Usage Example
@@ -375,9 +433,15 @@ bun dev
 **1 Create a `src/mod.ts` file:**
 
 ```ts
-import { runMain, defineCommand } from "@reliverse/rempts";
+import { createCli, defineCommand } from "@reliverse/rempts";
+
+// New object format (recommended)
+await createCli({
+  mainCommand: defineCommand({}),
+});
 
-await runMain(defineCommand({}));
+// Legacy format (still supported)
+await createCli(defineCommand({}));
 ```
 
 **2 Run the following:**
@@ -406,7 +470,7 @@ bun src/mod.ts
 #### Medium Usage Example
 
 ```ts
-import { defineCommand, runMain } from "@reliverse/rempts";
+import { defineCommand, createCli } from "@reliverse/rempts";
 
 const main = defineCommand({
   meta: {
@@ -417,7 +481,13 @@ const main = defineCommand({
   },
 });
 
-await runMain(main);
+// New object format (recommended)
+await createCli({
+  mainCommand: main,
+});
+
+// Legacy format (still supported)
+await createCli(main);
 ```
 
 #### Classic Usage Example
@@ -430,7 +500,7 @@ import {
   inputPrompt,
   selectPrompt,
   defineCommand,
-  runMain
+  createCli
 } from "@reliverse/rempts";
 
 const main = defineCommand({
@@ -469,7 +539,13 @@ const main = defineCommand({
   },
 });
 
-await runMain(main);
+// New object format (recommended)
+await createCli({
+  mainCommand: main,
+});
+
+// Legacy format (still supported)
+await createCli(main);
 ```
 
 #### Advanced Usage Example
@@ -584,7 +660,7 @@ const mainCommand = defineCommand({
 });
 
 /**
- * The `runMain()` function sets up the launcher with several advanced features:
+ * The `createCli()` function sets up the launcher with several advanced features:
  *
  * - File-Based Commands: Enables scanning for commands within the "app" directory.
  * - Alias Mapping: Shorthand flags (e.g., `-v`) are mapped to their full names (e.g., `--verbose`).
@@ -592,8 +668,28 @@ const mainCommand = defineCommand({
  * - Negated Boolean Support: Allows flags to be negated (e.g., `--no-verbose`).
  * - Custom Unknown Flag Handler: Provides custom handling for unrecognized flags.
  */
-await runMain(mainCommand, {
-  fileBasedCmds: {
+// New object format (recommended)
+await createCli({
+  mainCommand: mainCommand,
+  fileBased: {
+    enable: true, // Enables file-based command detection.
+    cmdsRootPath: "app", // Directory to scan for commands.
+  },
+  alias: {
+    v: "verbose", // Maps shorthand flag -v to --verbose.
+  },
+  strict: false, // Do not throw errors for unknown flags.
+  warnOnUnknown: false, // Warn when encountering unknown flags.
+  negatedBoolean: true, // Support for negated booleans (e.g., --no-verbose).
+  // unknown: (flagName) => {
+  //   relinka("warn", "Unknown flag encountered:", flagName);
+  //   return false;
+  // },
+});
+
+// Legacy format (still supported)
+await createCli(mainCommand, {
+  fileBased: {
     enable: true, // Enables file-based command detection.
     cmdsRootPath: "app", // Directory to scan for commands.
   },
@@ -634,7 +730,7 @@ Finally, a full-featured CLI launcher without the ceremony. `@reliverse/rempts`'
   Seamlessly combines positional and named arguments with zero configuration, auto-parsing booleans, strings, numbers, arrays, and even supporting negated flags like `--no-flag`.
 
 - **Customizable Behavior:**  
-  Options such as `fileBasedCmds.enable`, `cmdsRootPath`, and `autoExit` allow you to tailor the launcher's behavior. For example, you can choose whether the process should exit automatically on error or allow manual error handling.
+  Options such as `fileBased.enable`, `cmdsRootPath`, and `autoExit` allow you to tailor the launcher's behavior. For example, you can choose whether the process should exit automatically on error or allow manual error handling.
 
 - **Error Management & Usage Output:**  
   The launcher provides clear error messages for missing required arguments, invalid types, or command import issues, and it automatically displays usage information for your CLI.
@@ -833,7 +929,7 @@ export default defineCommand({
 Below is a demonstration of how to define and use all supported argument types in rempts: positional, boolean, string, number, and array. This includes example CLI invocations and the resulting parsed output.
 
 ```ts
-import { defineCommand, runMain } from "@reliverse/rempts";
+import { defineCommand, createCli } from "@reliverse/rempts";
 
 const main = defineCommand({
   meta: {
@@ -877,7 +973,13 @@ const main = defineCommand({
   },
 });
 
-await runMain(main);
+// New object format (recommended)
+await createCli({
+  mainCommand: main,
+});
+
+// Legacy format (still supported)
+await createCli(main);
 ```
 
 ### Example CLI Invocations
@@ -1048,13 +1150,7 @@ The validation happens after type casting, so for example with numbers, the inpu
 
 Bug report? Prompt idea? Want to build the best DX possible?
 
-You're in the right place:
-
-- ✨ [Star the repo](https://github.com/reliverse/rempts)
-- 💬 [Join the Discord](https://discord.gg/3GawfWfAPe)
-- ❤️ [Sponsor @blefnk](https://github.com/sponsors/blefnk)
-
-> *No classes. No magic. Just clean, composable tools for CLI devs.*
+You're in the right place! Please help us make the best CLI toolkit possible.
 
 ### Notices For Contributors
 
@@ -1078,6 +1174,10 @@ All APIs are fully typed. See [`src/types.ts`](./src/types.ts) for advanced cust
 
 - [CLI application with the Node.js Readline module](https://dev.to/camptocamp-geo/cli-application-with-the-nodejs-readline-module-48ic)
 
+## TODO
+
+- [ ] migrate to `dler libs` in the future (all main components will be published as separate packages; `@reliverse/rempts` will be a wrapper for all of them)
+
 ## Related
 
 - [`@reliverse/cli`](https://npmjs.com/package/@reliverse/cli) – CLI-first toolkit for fullstack workflows
@@ -1089,6 +1189,18 @@ All APIs are fully typed. See [`src/types.ts`](./src/types.ts) for advanced cust
 
 - [citty](https://github.com/unjs/citty#readme) - launcher design inspiration
 
+## Support
+
+Bug report? Prompt idea? Want to build the best DX possible?
+
+You're in the right place:
+
+- ✨ [Star the repo](https://github.com/reliverse/rempts)
+- 💬 [Join the Discord](https://discord.gg/3GawfWfAPe)
+- ❤️ [Sponsor @blefnk](https://github.com/sponsors/blefnk)
+
+> *No classes. No magic. Just clean, composable tools for CLI devs.*
+
 ## License
 
-💖 MIT © [blefnk (Nazar Kornienko)](https://github.com/blefnk)
+💖 MIT (see [LICENSE](./LICENSE) and [LICENCES](./LICENSES)) © [blefnk (Nazar Kornienko)](https://github.com/blefnk)

package/bin/{components/animate/animate.js → libs/animate/animate-mod.js}

@@ -3,10 +3,7 @@ import {
 } from "@figliolia/chalk-animation";
 import { relinka } from "@reliverse/relinka";
 import { msg } from "../msg-fmt/messages.js";
-import {
-  deleteLastLine,
-  getTerminalWidth
-} from "../msg-fmt/terminal.js";
+import { deleteLastLine, getTerminalWidth } from "../msg-fmt/terminal.js";
 export const animationMap = {
   rainbow: ChalkAnimation.rainbow,
   pulse: ChalkAnimation.pulse,

package/bin/{components → libs}/anykey/anykey-mod.js

@@ -1,8 +1,8 @@
 import logUpdate from "log-update";
 import { cursor } from "sisteransi";
 import { fmt } from "../msg-fmt/messages.js";
-import { outroPrompt } from "../outro/outro-end.js";
-import { streamText } from "../../utils/stream-text.js";
+import { outroPrompt } from "../outro/outro-mod.js";
+import { streamText } from "../utils/stream-text.js";
 const DEFAULT_MESSAGE = "Press any key to continue...";
 const CTRL_C_CODE = 3;
 const terminal = {

package/bin/libs/confirm/confirm-alias.d.ts

@@ -0,0 +1 @@
+export declare const confirm: any;

package/bin/libs/confirm/confirm-alias.js

@@ -0,0 +1,2 @@
+import { confirmPrompt } from "./confirm-mod.js";
+export const confirm = confirmPrompt;

package/bin/{components/confirm/confirm-prompt.js → libs/confirm/confirm-mod.js}

@@ -3,7 +3,7 @@ import { stdin as input, stdout as output } from "node:process";
 import readline from "node:readline/promises";
 import { bar, msg } from "../msg-fmt/messages.js";
 import { deleteLastLine } from "../msg-fmt/terminal.js";
-import { completePrompt } from "../../utils/prompt-end.js";
+import { completePrompt } from "../utils/prompt-end.js";
 function renderPrompt(params) {
   const {
     title,

package/bin/{components → libs}/editor/editor-mod.js

@@ -192,11 +192,11 @@ function renderEditor() {
       const lineNum = String(fileLineIndex + 1).padStart(3);
       term(state.theme.lineNumber(`${lineNum} `));
       const line = state.lines[fileLineIndex];
-      const displayLine = line.substring(
+      const displayLine = line?.substring(
         state.leftCol,
         state.leftCol + displayWidth
       );
-      const highlightedDisplayLine = applySyntaxHighlighting(displayLine);
+      const highlightedDisplayLine = applySyntaxHighlighting(displayLine ?? "");
       term(highlightedDisplayLine);
       term.eraseLineAfter();
     } else {
@@ -237,8 +237,8 @@ function deleteCharBackward() {
     const currentLine = state.lines.splice(state.cursorY, 1)[0];
     state.cursorY--;
     const prevLine = state.lines[state.cursorY];
-    state.cursorX = prevLine.length;
-    state.lines[state.cursorY] = prevLine + currentLine;
+    state.cursorX = prevLine?.length ?? 0;
+    state.lines[state.cursorY] = prevLine + (currentLine ?? "");
     updateModifiedStatus();
   }
 }
@@ -368,7 +368,7 @@ async function confirmAction(promptMessage = "Are you sure? (y/N)") {
       no: ["n", "N", "ENTER"]
     }).promise;
     term.moveTo(1, term.height).eraseLine();
-    return confirm;
+    return confirm ?? false;
   } catch (_error) {
     term.moveTo(1, term.height).eraseLine();
     state.statusMessage = "Cancelled";
@@ -537,7 +537,7 @@ async function findText() {
   for (let y = state.cursorY; y < state.lines.length; y++) {
     const line = state.lines[y];
     const startIdx = y === state.cursorY ? state.cursorX + 1 : 0;
-    const matchIndex = line.indexOf(termToUse, startIdx);
+    const matchIndex = line?.indexOf(termToUse, startIdx) ?? -1;
     if (matchIndex !== -1) {
       state.cursorY = y;
       state.cursorX = matchIndex;
@@ -549,8 +549,8 @@ async function findText() {
     state.statusMessage = `Search wrapped: ${termToUse}`;
     for (let y = 0; y <= state.cursorY; y++) {
       const line = state.lines[y];
-      const endIdx = y === state.cursorY ? state.cursorX + 1 : line.length;
-      const matchIndex = line.substring(0, endIdx).indexOf(termToUse);
+      const endIdx = y === state.cursorY ? state.cursorX + 1 : line?.length ?? 0;
+      const matchIndex = line?.substring(0, endIdx).indexOf(termToUse) ?? -1;
       if (matchIndex !== -1) {
         state.cursorY = y;
         state.cursorX = matchIndex;

package/bin/{components → libs}/figures/figures-mod.d.ts

@@ -229,7 +229,7 @@ export declare const mainSymbols: {
     lineSlash: string;
 };
 export declare const fallbackSymbols: Record<string, string>;
-declare const figures: {
+export declare const figures: Record<string, string> | {
     tick: string;
     info: string;
     warning: string;
@@ -458,5 +458,4 @@ declare const figures: {
     lineCross: string;
     lineBackslash: string;
     lineSlash: string;
-} | Record<string, string>;
-export default figures;
+};

package/bin/{components → libs}/figures/figures-mod.js

@@ -282,5 +282,4 @@ export const fallbackSymbols = {
   ...specialFallbackSymbols
 };
 const shouldUseMain = isUnicodeSupported();
-const figures = shouldUseMain ? mainSymbols : fallbackSymbols;
-export default figures;
+export const figures = shouldUseMain ? mainSymbols : fallbackSymbols;

package/bin/libs/input/input-alias.d.ts

@@ -0,0 +1,4 @@
+import type { InputPromptOptions } from "../../types.js";
+export declare const input: any;
+export declare const text: any;
+export declare const password: (options: Omit<InputPromptOptions, "mode">) => any;

package/bin/libs/input/input-alias.js

@@ -0,0 +1,4 @@
+import { inputPrompt } from "./input-mod.js";
+export const input = inputPrompt;
+export const text = inputPrompt;
+export const password = (options) => inputPrompt({ ...options, mode: "password" });

package/bin/{components/input/input-prompt.js → libs/input/input-mod.js}

@@ -3,8 +3,8 @@ import { isUnicodeSupported } from "@reliverse/runtime";
 import readline from "node:readline/promises";
 import { bar, msg, msgUndoAll } from "../msg-fmt/messages.js";
 import { deleteLastLine } from "../msg-fmt/terminal.js";
-import { completePrompt } from "../../utils/prompt-end.js";
-import { streamText } from "../../utils/stream-text.js";
+import { completePrompt } from "../utils/prompt-end.js";
+import { streamText } from "../utils/stream-text.js";
 const unicode = isUnicodeSupported();
 const S_MASK = unicode ? "\u258B" : "*";
 function getMaskChar(customMask) {

package/bin/libs/intro/intro-alias.d.ts

@@ -0,0 +1,2 @@
+export declare const startPrompt: any;
+export declare const intro: any;

package/bin/libs/intro/intro-alias.js

@@ -0,0 +1,3 @@
+import { introPrompt } from "./intro-mod.js";
+export const startPrompt = introPrompt;
+export const intro = introPrompt;

package/bin/{components/intro/intro-start.js → libs/intro/intro-mod.js}

@@ -1,6 +1,5 @@
 import { relinka } from "@reliverse/relinka";
 import { getCurrentTerminalName } from "@reliverse/runtime";
-import { createAsciiArt } from "../ascii-art/ascii-art.js";
 import { msg } from "../msg-fmt/messages.js";
 import {
   getExactTerminalWidth,
@@ -11,8 +10,9 @@ import {
   preventWrongTerminalSize,
   preventWindowsHomeDirRoot,
   preventUnsupportedTTY
-} from "../../utils/prevent.js";
-import { pm, reliversePrompts } from "../../utils/system.js";
+} from "../utils/prevent.js";
+import { pm, reliversePrompts } from "../utils/system.js";
+import { createAsciiArt } from "../visual/visual-mod.js";
 export async function introPrompt(optionsOrTitle) {
   const options = typeof optionsOrTitle === "string" ? { title: optionsOrTitle } : optionsOrTitle;
   const {

package/bin/libs/launcher/launcher-alias.d.ts

@@ -0,0 +1,2 @@
+import { createCli } from "./launcher-mod";
+export declare const runMain: typeof createCli;

package/bin/libs/launcher/launcher-alias.js

@@ -0,0 +1,2 @@
+import { createCli } from "./launcher-mod.js";
+export const runMain = createCli;

package/bin/libs/launcher/launcher-mod.d.ts

@@ -0,0 +1,114 @@
+import type { ReliArgParserOptions } from "@reliverse/reliarg";
+import type { ArgDefinitions, Command, DefineCommandOptions, EmptyArgs, FileBasedOptions } from "./launcher-types.js";
+import type { AnyRouter } from "./trpc-orpc-support/trpc-compat.js";
+import type { Logger, OmeletteInstanceLike, Promptable } from "./trpc-orpc-support/types.js";
+/**
+ * Defines a command with metadata, argument definitions,
+ * an execution function, and (optional) subCommands.
+ */
+export declare function defineCommand<A extends ArgDefinitions = EmptyArgs>(options: DefineCommandOptions<A>): Command<A>;
+/**
+ * Show usage for a given command.
+ */
+export declare function showUsage<A extends ArgDefinitions>(command: Command<A>, parserOptions?: ReliArgParserOptions & {
+    fileBased?: FileBasedOptions;
+    autoExit?: boolean;
+    metaSettings?: {
+        showDescriptionOnMain?: boolean;
+    };
+    _fileBasedCurrentDir?: string;
+    _fileBasedPathSegments?: string[];
+    _isSubcommand?: boolean;
+}, globalCliMeta?: {
+    name?: string;
+    version?: string;
+    description?: string;
+}): Promise<void>;
+/**
+ * Primary entry point to run a command. This function supports:
+ *
+ * - File-based Commands: scanning for commands within a given commands root.
+ * - Commands defined within the command object.
+ * - Standard flags like --help, --version, and --debug.
+ * - RPC functionality: tRPC/oRPC router integration with automatic CLI generation.
+ *
+ * This function passes along remaining arguments to command runners to ensure
+ * consistent parsing.
+ */
+export declare function createCli<A extends ArgDefinitions = EmptyArgs>(options: Command<A> | {
+    name?: string;
+    version?: string;
+    description?: string;
+    mainCommand?: Command<A>;
+    fileBased?: FileBasedOptions;
+    autoExit?: boolean;
+    metaSettings?: {
+        showDescriptionOnMain?: boolean;
+    };
+    meta?: Command<A>["meta"];
+    args?: Command<A>["args"];
+    run?: Command<A>["run"];
+    commands?: Command<A>["commands"];
+    onCmdInit?: Command<A>["onCmdInit"];
+    onCmdExit?: Command<A>["onCmdExit"];
+    onLauncherInit?: Command<A>["onLauncherInit"];
+    onLauncherExit?: Command<A>["onLauncherExit"];
+    rpc?: {
+        /** A tRPC router. Procedures will become CLI commands. */
+        router: AnyRouter;
+        /** Context to be supplied when invoking the router. */
+        context?: any;
+        /** The `@trpc/server` module to use for calling procedures. Required when using trpc v10. */
+        trpcServer?: any | Promise<any>;
+        /** Usage code examples to display in `--help` output. */
+        usage?: string | string[];
+        /** Dependencies for schema validation libraries */
+        "@valibot/to-json-schema"?: {
+            toJsonSchema: (input: unknown, options?: {
+                errorMode?: "throw" | "ignore" | "warn";
+            }) => any;
+        };
+        effect?: {
+            Schema: {
+                isSchema: (input: unknown) => input is "JSONSchemaMakeable";
+            };
+            JSONSchema: {
+                make: (input: "JSONSchemaMakeable") => any;
+            };
+        };
+    };
+    rpcRunParams?: {
+        argv?: string[];
+        logger?: Logger;
+        completion?: OmeletteInstanceLike | (() => Promise<OmeletteInstanceLike>);
+        prompts?: Promptable;
+        /** Format an error thrown by the root procedure before logging to `logger.error` */
+        formatError?: (error: unknown) => string;
+        process?: {
+            exit: (code: number) => never;
+        };
+    };
+}, legacyParserOptions?: ReliArgParserOptions & {
+    fileBased?: FileBasedOptions;
+    autoExit?: boolean;
+    metaSettings?: {
+        showDescriptionOnMain?: boolean;
+    };
+}): Promise<void> & {
+    run(_ctx?: any): Promise<void>;
+};
+/**
+ * Helper to define argument definitions with improved type inference
+ * for IntelliSense and validation for array defaults against options.
+ */
+export declare function defineArgs<A extends ArgDefinitions>(args: A): A;
+/**
+ * Programmatically run a command's run() handler with parsed arguments.
+ * Does not handle subcommands, file-based commands, or global hooks.
+ * Suitable for use in demos, tests, or programmatic invocation.
+ *
+ * @param command The command definition (from defineCommand)
+ * @param argv The argv array to parse (default: [])
+ * @param parserOptions Optional reliArgParser options
+ */
+export declare function runCmd<A extends ArgDefinitions = EmptyArgs>(command: Command<A>, argv?: string[], parserOptions?: ReliArgParserOptions): Promise<void>;