@visulima/cerebro 2.1.5 → 3.0.0-alpha.10

package/README.md

@@ -1,26 +1,24 @@
-<div align="center">
-  <h3>Visulima Cerebro</h3>
-  <p>
-  Cerebro is a delightful toolkit for building cross-runtime command-line interfaces (CLIs) for Node.js, Deno, and Bun, built on top of
+<!-- START_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
-[@visulima/boxen](https://github.com/visulima/visulima/tree/main/packages/boxen),
-[@visulima/colorize](https://github.com/visulima/visulima/tree/main/packages/colorize),
-[@visulima/command-line-args](https://github.com/visulima/visulima/tree/main/packages/command-line-args),
-[@visulima/tabular](https://github.com/visulima/visulima/tree/main/packages/tabular) and
-[fastest-levenshtein](https://github.com/ka-weihe/fastest-levenshtein)
+<a href="https://www.anolilab.com/open-source" align="center">
 
-<br />
+  <img src="__assets__/package-og.svg" alt="cerebro" />
 
-I would recommend reading this [guide](https://clig.dev/) on how to make user-friendly command-line tools.
+</a>
 
-  </p>
-</div>
+<h3 align="center">A delightful toolkit for building cross-runtime CLIs for Node.js, Deno, and Bun.</h3>
+
+<!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
 <br />
 
 <div align="center">
 
-[![typescript-image]][typescript-url] [![npm-image]][npm-url] [![license-image]][license-url]
+[![typescript-image][typescript-badge]][typescript-url]
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
 </div>
 
@@ -428,14 +426,23 @@ If you would like to help take a look at the [list of issues](https://github.com
 - [commander.js](https://github.com/tj/commander.js) - node.js command-line interfaces made easy
 - [yargs](https://www.npmjs.com/package/yargs) - yargs the modern, pirate-themed successor to optimist.
 
+## Made with ❤️ at Anolilab
+
+This is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Anolilab](https://www.anolilab.com/open-source) is a Development and AI Studio. Contact us at [hello@anolilab.com](mailto:hello@anolilab.com) if you need any help with these technologies or just want to say hi!
+
 ## License
 
-The visulima package is open-sourced software licensed under the [MIT][license-url]
+The visulima package is open-sourced software licensed under the [MIT][license]
 
-[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+<!-- badges -->
 
-[typescript-url]: https://www.typescriptlang.org/ "TypeScript" "typescript"
-[license-image]: https://img.shields.io/npm/l/@visulima/cerebro?color=blueviolet&style=for-the-badge
-[license-url]: LICENSE.md "license"
-[npm-image]: https://img.shields.io/npm/v/@visulima/cerebro/latest.svg?style=for-the-badge&logo=npm
-[npm-url]: https://www.npmjs.com/package/@visulima/cerebro/v/latest "npm"
+[license-badge]: https://img.shields.io/npm/l/@visulima/cerebro?style=for-the-badge
+[license]: https://github.com/visulima/visulima/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@visulima/cerebro?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@visulima/cerebro
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: https://github.com/visulima/visulima/blob/main/.github/CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/932323359193186354.svg?style=for-the-badge
+[chat]: https://discord.gg/TtFJY8xkFK
+[typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+[typescript-url]: https://www.typescriptlang.org/

package/dist/cli.d.ts

@@ -89,6 +89,28 @@ export declare class Cli<T extends Console = Console> implements ICli<T> {
      * ```
      */
     addCommand<OD extends OptionDefinition<unknown> = OptionDefinition<unknown>>(command: ICommand<OD, T>): this;
+    /**
+     * Adds a global option available to all commands.
+     *
+     * Global options are parsed alongside command-specific options and displayed
+     * in the help output under the "Global Options" section.
+     * @param option The option definition
+     * @returns The CLI instance for method chaining
+     * @example
+     * ```typescript
+     * cli.addGlobalOption({
+     *   name: 'cwd',
+     *   type: String,
+     *   description: 'Override working directory',
+     * });
+     * ```
+     */
+    addGlobalOption<V = unknown>(option: OptionDefinition<V>): this;
+    /**
+     * Gets all global options (built-in + custom).
+     * @returns Array of all global option definitions
+     */
+    getGlobalOptions(): OptionDefinition<unknown>[];
     /**
      * Adds a plugin to extend the CLI functionality.
      *

package/dist/commands/completion-command.js

@@ -1,5 +1,204 @@
-var g=Object.defineProperty;var a=(e,t)=>g(e,"name",{value:t,configurable:!0});import S from"@bomb.sh/tab";import{c as $}from"../packem_shared/cerebro-error-BnJTixb2.js";var w=Object.defineProperty,y=a((e,t)=>w(e,"name",{value:t,configurable:!0}),"n");class p extends ${static{a(this,"l")}static{y(this,"CompletionError")}troubleshooting;constructor(t,o,n=[]){super(t,o,{troubleshooting:n}),this.name="CompletionError",this.troubleshooting=n,n.length>0&&(this.hint=n.join(`
-`))}}var C=Object.defineProperty,s=a((e,t)=>C(e,"name",{value:t,configurable:!0}),"s");const h=["bash","zsh","fish","powershell"],d=["node","bun","deno"],v=s(e=>"Deno"in e,"hasDeno"),L=s(e=>"Bun"in e,"hasBun"),u=s(()=>v(globalThis)?"deno":L(globalThis)?"bun":"node","detectRuntime"),m=s(e=>{const t=e?.starshipShell??e?.shell;if(t){const r=t.toLowerCase();if(r.includes("zsh"))return"zsh";if(r.includes("bash"))return"bash";if(r.includes("fish"))return"fish"}const o=e?.psModulePath,n=e?.prompt;if(o||n?.includes("PS"))return"powershell";if(e?.comSpec?.toLowerCase().includes("cmd.exe"))return"bash"},"detectShell"),f=S,I=s((e,t)=>{for(const o of t)o.hidden||(o.name&&e.option(o.name,o.description||""),o.alias&&e.option(o.alias,o.description||""))},"registerCommandOptions"),P=s((e,t)=>{for(const[o,n]of t){if(n.name!==o||n.hidden)continue;const r=e.command(n.name,n.description||"");n.options&&I(r,n.options)}},"registerCommands"),E=s(e=>{if(!h.includes(e))throw new p(`Invalid shell type: ${e}`,"INVALID_SHELL",[`Valid shells are: ${h.join(", ")}`,"Shell will be auto-detected if not specified"])},"validateShell"),j=s(e=>{if(e&&!d.includes(e))throw new p(`Invalid runtime: ${e}`,"INVALID_RUNTIME",[`Valid runtimes are: ${d.join(", ")}`,"Runtime will be auto-detected if not specified"])},"validateRuntime"),z=s((e,t)=>{e.error("Could not detect current shell");const o=[`Usage: ${t} completion --shell=<bash|zsh|fish|powershell> [--runtime=<node|bun|deno>]`,"","Examples:","  # Install completions for zsh:",`  ${t} completion --shell=zsh > ~/.${t}-completion.zsh`,`  echo 'source ~/.${t}-completion.zsh' >> ~/.zshrc`,"","  # Install completions for bash with custom runtime:",`  ${t} completion --shell=bash --runtime=bun > ~/.${t}-completion.bash`,`  echo 'source ~/.${t}-completion.bash' >> ~/.bashrc`,"","  # Install completions for fish:",`  ${t} completion --shell=fish > ~/.config/fish/completions/${t}.fish`].join(`
-`);e.info(o)},"printUsageInstructions"),x={description:"Generate shell completion scripts",env:[{description:"Shell path (Unix-like systems). Used for shell detection.",name:"SHELL",type:String},{description:"Starship shell configuration. Takes precedence over SHELL for detection.",name:"STARSHIP_SHELL",type:String},{description:"PowerShell module path (Windows). Used for PowerShell detection.",name:"PSModulePath",type:String},{description:"Command prompt variable (Windows). Used for PowerShell detection.",name:"PROMPT",type:String},{description:"Command processor (Windows). Used for Windows Command Prompt detection.",name:"ComSpec",type:String}],execute:s(async({env:e,logger:t,options:o,runtime:n})=>{const r=n.getCliName(),c=o?.shell||m(e);if(!c){z(t,r);return}try{E(c),j(o?.runtime),P(f,n.getCommands());const i=`${o?.runtime||u()} ${r}`;f.setup(r,i,c)}catch(i){if(i instanceof p){const l=[`Failed to generate completion script: ${i.message}`,`Error code: ${i.code}`];throw i.troubleshooting.length>0&&l.push("","Troubleshooting:",...i.troubleshooting.map(b=>`  • ${b}`)),t.error(l.join(`
-`)),i}else{const l=["Failed to generate completion script",`Error: ${i instanceof Error?i.message:String(i)}`,"","Troubleshooting:","  • Ensure @bomb.sh/tab is installed: pnpm add @bomb.sh/tab",`  • Verify shell is supported: ${h.join(", ")}`,`  • Verify runtime is supported: ${d.join(", ")}`,"  • Check that your CLI name is correct"];t.error(l.join(`
-`))}}},"execute"),name:"completion",options:[{defaultOption:!0,defaultValue:m(),description:"Shell type (bash, zsh, fish, powershell). Defaults to current shell if detected.",name:"shell",type:String,typeLabel:"{underline shell}"},{defaultOption:!0,defaultValue:u(),description:"JavaScript runtime (node, bun, deno). Defaults to current runtime if detected.",name:"runtime",type:String,typeLabel:"{underline runtime}"}]};export{x as default};
+import tab from '@bomb.sh/tab';
+import { C as CerebroError } from '../packem_shared/cerebro-error-GmJ3jN7Q.js';
+
+class CompletionError extends CerebroError {
+  troubleshooting;
+  constructor(message, code, troubleshooting = []) {
+    super(message, code, { troubleshooting });
+    this.name = "CompletionError";
+    this.troubleshooting = troubleshooting;
+    if (troubleshooting.length > 0) {
+      this.hint = troubleshooting.join("\n");
+    }
+  }
+}
+
+const validShells = ["bash", "zsh", "fish", "powershell"];
+const validRuntimes = ["node", "bun", "deno"];
+const hasDeno = (global) => "Deno" in global;
+const hasBun = (global) => "Bun" in global;
+const detectRuntime = () => {
+  if (hasDeno(globalThis)) {
+    return "deno";
+  }
+  if (hasBun(globalThis)) {
+    return "bun";
+  }
+  return "node";
+};
+const detectShell = (toolboxEnv) => {
+  const starshipShell = toolboxEnv?.starshipShell;
+  const shell = starshipShell ?? toolboxEnv?.shell;
+  if (shell) {
+    const shellPath = shell.toLowerCase();
+    if (shellPath.includes("zsh")) {
+      return "zsh";
+    }
+    if (shellPath.includes("bash")) {
+      return "bash";
+    }
+    if (shellPath.includes("fish")) {
+      return "fish";
+    }
+  }
+  const psModulePath = toolboxEnv?.psModulePath;
+  const prompt = toolboxEnv?.prompt;
+  if (psModulePath || prompt?.includes("PS")) {
+    return "powershell";
+  }
+  const comSpec = toolboxEnv?.comSpec;
+  if (comSpec?.toLowerCase().includes("cmd.exe")) {
+    return "bash";
+  }
+  return void 0;
+};
+const tabInstance = tab;
+const registerCommandOptions = (cmd, options) => {
+  for (const option of options) {
+    if (option.hidden) {
+      continue;
+    }
+    if (option.name) {
+      cmd.option(option.name, option.description ?? "");
+    }
+    if (option.alias) {
+      cmd.option(option.alias, option.description ?? "");
+    }
+  }
+};
+const registerCommands = (tabInstance2, commands) => {
+  for (const [commandName, command] of commands) {
+    if (command.name !== commandName || command.hidden) {
+      continue;
+    }
+    const cmd = tabInstance2.command(command.name, command.description ?? "");
+    if (command.options) {
+      registerCommandOptions(cmd, command.options);
+    }
+  }
+};
+const validateShell = (shell) => {
+  if (!validShells.includes(shell)) {
+    throw new CompletionError(`Invalid shell type: ${shell}`, "INVALID_SHELL", [
+      `Valid shells are: ${validShells.join(", ")}`,
+      "Shell will be auto-detected if not specified"
+    ]);
+  }
+};
+const validateRuntime = (runtime) => {
+  if (runtime && !validRuntimes.includes(runtime)) {
+    throw new CompletionError(`Invalid runtime: ${runtime}`, "INVALID_RUNTIME", [
+      `Valid runtimes are: ${validRuntimes.join(", ")}`,
+      "Runtime will be auto-detected if not specified"
+    ]);
+  }
+};
+const printUsageInstructions = (logger, cliName) => {
+  logger.error("Could not detect current shell");
+  const usageInfo = [
+    `Usage: ${cliName} completion --shell=<bash|zsh|fish|powershell> [--runtime=<node|bun|deno>]`,
+    "",
+    "Examples:",
+    `  # Install completions for zsh:`,
+    `  ${cliName} completion --shell=zsh > ~/.${cliName}-completion.zsh`,
+    `  echo 'source ~/.${cliName}-completion.zsh' >> ~/.zshrc`,
+    "",
+    `  # Install completions for bash with custom runtime:`,
+    `  ${cliName} completion --shell=bash --runtime=bun > ~/.${cliName}-completion.bash`,
+    `  echo 'source ~/.${cliName}-completion.bash' >> ~/.bashrc`,
+    "",
+    `  # Install completions for fish:`,
+    `  ${cliName} completion --shell=fish > ~/.config/fish/completions/${cliName}.fish`
+  ].join("\n");
+  logger.info(usageInfo);
+};
+const completionCommand = {
+  description: "Generate shell completion scripts",
+  env: [
+    {
+      description: "Shell path (Unix-like systems). Used for shell detection.",
+      name: "SHELL",
+      type: String
+    },
+    {
+      description: "Starship shell configuration. Takes precedence over SHELL for detection.",
+      name: "STARSHIP_SHELL",
+      type: String
+    },
+    {
+      description: "PowerShell module path (Windows). Used for PowerShell detection.",
+      name: "PSModulePath",
+      type: String
+    },
+    {
+      description: "Command prompt variable (Windows). Used for PowerShell detection.",
+      name: "PROMPT",
+      type: String
+    },
+    {
+      description: "Command processor (Windows). Used for Windows Command Prompt detection.",
+      name: "ComSpec",
+      type: String
+    }
+  ],
+  // eslint-disable-next-line @typescript-eslint/require-await
+  execute: async ({ env: toolboxEnv, logger, options, runtime }) => {
+    const cliName = runtime.getCliName();
+    const shell = options.shell ?? detectShell(toolboxEnv);
+    if (!shell) {
+      printUsageInstructions(logger, cliName);
+      return;
+    }
+    try {
+      validateShell(shell);
+      validateRuntime(options.runtime);
+      registerCommands(tabInstance, runtime.getCommands());
+      const jsRuntime = options.runtime ?? detectRuntime();
+      const scriptPath = `${jsRuntime} ${cliName}`;
+      tabInstance.setup(cliName, scriptPath, shell);
+    } catch (error) {
+      if (error instanceof CompletionError) {
+        const errorMessages = [`Failed to generate completion script: ${error.message}`, `Error code: ${error.code}`];
+        if (error.troubleshooting.length > 0) {
+          errorMessages.push("", "Troubleshooting:", ...error.troubleshooting.map((tip) => `  • ${tip}`));
+        }
+        logger.error(errorMessages.join("\n"));
+        throw error;
+      } else {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorMessages = [
+          "Failed to generate completion script",
+          `Error: ${errorMessage}`,
+          "",
+          "Troubleshooting:",
+          "  • Ensure @bomb.sh/tab is installed: pnpm add @bomb.sh/tab",
+          `  • Verify shell is supported: ${validShells.join(", ")}`,
+          `  • Verify runtime is supported: ${validRuntimes.join(", ")}`,
+          "  • Check that your CLI name is correct"
+        ];
+        logger.error(errorMessages.join("\n"));
+      }
+    }
+  },
+  name: "completion",
+  options: [
+    {
+      defaultOption: true,
+      defaultValue: detectShell(),
+      description: "Shell type (bash, zsh, fish, powershell). Defaults to current shell if detected.",
+      name: "shell",
+      type: String,
+      typeLabel: "{underline shell}"
+    },
+    {
+      defaultOption: true,
+      defaultValue: detectRuntime(),
+      description: "JavaScript runtime (node, bun, deno). Defaults to current runtime if detected.",
+      name: "runtime",
+      type: String,
+      typeLabel: "{underline runtime}"
+    }
+  ]
+};
+
+export { completionCommand as default };

package/dist/commands/help-command.js

@@ -1 +1,200 @@
-import"@visulima/colorize";import{D as p}from"../packem_shared/help-command-CIRIXN03.js";import"../packem_shared/index-DQ3pvLQH.js";export{p as default};
+import { inverse, cyan, green, yellow } from '@visulima/colorize';
+import { t as templateFormat, c as commandLineUsage } from '../packem_shared/index-CS31xKFe.js';
+
+const defaultEnv = [
+  {
+    defaultValue: "32",
+    description: "Controls the verbosity level of output. Valid values: '16' (quiet), '32' (normal), '64' (verbose), '128' (debug)",
+    name: "CEREBRO_OUTPUT_LEVEL",
+    type: String
+  },
+  {
+    description: "Sets the minimum required Node.js version. Overrides the default minimum version check",
+    name: "CEREBRO_MIN_NODE_VERSION",
+    type: Number
+  },
+  {
+    defaultValue: false,
+    description: "When set, disables the update notifier check",
+    name: "NO_UPDATE_NOTIFIER",
+    type: Boolean
+  },
+  {
+    description: "Standard Node.js environment variable. When set to 'test', disables update notifier",
+    name: "NODE_ENV",
+    type: String
+  },
+  {
+    defaultValue: false,
+    description: "When set, enables debug output (same as --debug flag)",
+    name: "DEBUG",
+    type: Boolean
+  },
+  {
+    description: "Sets the terminal width for table rendering. Useful for testing and consistent output",
+    name: "CEREBRO_TERMINAL_WIDTH",
+    type: Number
+  }
+];
+
+const EMPTY_GROUP_KEY = "__Other";
+const upperFirstChar = (string_) => string_.charAt(0).toUpperCase() + string_.slice(1);
+const printGeneralHelp = (logger, runtime, commands, groupOption) => {
+  logger.debug("no command given, printing general help...");
+  let filteredCommands = [...new Set(commands.values())].filter((command) => !command.hidden);
+  if (groupOption) {
+    filteredCommands = filteredCommands.filter((command) => command.group === groupOption);
+  }
+  const groupedCommands = filteredCommands.reduce((accumulator, command) => {
+    const group = command.group ?? EMPTY_GROUP_KEY;
+    accumulator[group] ??= [];
+    accumulator[group].push(command);
+    return accumulator;
+  }, {});
+  const buildCommandList = (commandList) => commandList.map((command) => {
+    let aliases = "";
+    if (typeof command.alias === "string") {
+      aliases = command.alias;
+    } else if (Array.isArray(command.alias)) {
+      aliases = command.alias.join(", ");
+    }
+    if (aliases !== "") {
+      aliases = ` [${aliases}]`;
+    }
+    let commandDisplay = command.name;
+    if (command.commandPath && command.commandPath.length > 0) {
+      commandDisplay = `${command.commandPath.join(" ")} ${command.name}`;
+    }
+    return [`${green(commandDisplay)}${aliases}`, command.description ?? ""];
+  });
+  (logger.raw ?? logger.log)(
+    commandLineUsage(
+      [
+        {
+          content: `${cyan(runtime.getCliName())} ${green("<command>")} [positional arguments] ${yellow("[options]")}`,
+          header: inverse.cyan(" Usage ")
+        },
+        ...Object.keys(groupedCommands).map((key) => {
+          const groupOptionName = groupOption ? ` ${upperFirstChar(groupOption)}` : "";
+          return {
+            content: buildCommandList(groupedCommands[key]),
+            header: key === EMPTY_GROUP_KEY || groupOption ? inverse.green(` Available${groupOptionName} Commands `) : ` ${inverse.green(` ${upperFirstChar(key)} `)}`
+          };
+        }),
+        commands.has("help") ? {
+          header: inverse.yellow(" Command Options "),
+          optionList: commands.get("help").options?.filter((option) => !option.hidden)
+        } : void 0,
+        { header: inverse.yellow(" Global Options "), optionList: runtime.getGlobalOptions() },
+        {
+          content: defaultEnv.filter((envVariable) => !envVariable.hidden).map((envVariable) => [envVariable.name, envVariable.description ?? ""]),
+          header: inverse.magenta(" Environment Variables ")
+        },
+        {
+          content: `Run "${cyan(runtime.getCliName())} ${green("help <command>")}" or "${cyan(runtime.getCliName())} ${green("<command>")} ${yellow("--help")}" for help with a specific command.`,
+          raw: true
+        }
+      ].filter(Boolean)
+    )
+  );
+};
+const printCommandHelp = (logger, runtime, commands, name) => {
+  let command = commands.get(name);
+  if (!command) {
+    for (const cmd of commands.values()) {
+      const fullPath = cmd.commandPath ? [...cmd.commandPath, cmd.name] : [cmd.name];
+      if (fullPath.at(-1) === name || fullPath.join(" ") === name) {
+        command = cmd;
+        break;
+      }
+    }
+  }
+  if (!command) {
+    logger.error(`Command "${name}" not found`);
+    return;
+  }
+  const usageGroups = [];
+  const fullCommandPath = command.commandPath ? [...command.commandPath, command.name] : [command.name];
+  const commandDisplay = fullCommandPath.join(" ");
+  usageGroups.push({
+    content: `${cyan(runtime.getCliName())} ${green(commandDisplay)}${command.argument ? " [positional arguments]" : ""}${command.options ? " [options]" : ""}`,
+    header: inverse.cyan(" Usage ")
+  });
+  if (command.description) {
+    usageGroups.push({ content: command.description, header: inverse.green(" Description ") });
+  }
+  if (command.argument) {
+    usageGroups.push({ header: "Command Positional Arguments", isArgument: true, optionList: [command.argument] });
+  }
+  if (Array.isArray(command.options) && command.options.length > 0) {
+    usageGroups.push({
+      header: inverse.yellow(" Command Options "),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      optionList: command.options.filter((option) => !option.hidden)
+    });
+  }
+  usageGroups.push({ header: inverse.yellow(" Global Options "), optionList: runtime.getGlobalOptions() });
+  if (Array.isArray(command.env) && command.env.length > 0) {
+    const visibleEnvVariables = command.env.filter((envVariable) => !envVariable.hidden);
+    if (visibleEnvVariables.length > 0) {
+      usageGroups.push({
+        content: visibleEnvVariables.map((envVariable) => [envVariable.name, envVariable.description ?? ""]),
+        header: inverse.magenta(" Environment Variables ")
+      });
+    }
+  }
+  if (command.alias !== void 0 && command.alias.length > 0) {
+    let alias = command.alias;
+    if (typeof command.alias === "string") {
+      alias = [command.alias];
+    }
+    usageGroups.splice(1, 0, {
+      content: alias,
+      header: "Alias(es)"
+    });
+  }
+  if (Array.isArray(command.examples) && command.examples.length > 0) {
+    usageGroups.push({
+      content: command.examples,
+      header: "Examples"
+    });
+  }
+  (logger.raw ?? logger.log)(commandLineUsage(usageGroups));
+};
+class HelpCommand {
+  name = "help";
+  options = [
+    {
+      description: "Display only the specified group",
+      name: "group",
+      type: String
+    }
+  ];
+  commands;
+  constructor(commands) {
+    this.commands = commands;
+  }
+  execute(toolbox) {
+    const { commandName, logger, options, runtime } = toolbox;
+    const { footer, header } = runtime.getCommandSection();
+    if (header) {
+      (logger.raw ?? logger.log)(templateFormat(header));
+    }
+    if (commandName === "help") {
+      printGeneralHelp(
+        logger,
+        runtime,
+        this.commands,
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- options may be undefined at runtime
+        typeof options?.group === "string" ? options.group : void 0
+      );
+    } else {
+      printCommandHelp(logger, runtime, this.commands, commandName);
+    }
+    if (footer) {
+      (logger.raw ?? logger.log)(templateFormat(footer));
+    }
+  }
+}
+
+export { HelpCommand as default };