@visulima/cerebro 3.0.0-alpha.14 → 3.0.0-alpha.15

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## @visulima/cerebro [3.0.0-alpha.15](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.14...@visulima/cerebro@3.0.0-alpha.15) (2026-05-06)
+
+### Miscellaneous Chores
+
+* **cerebro:** apply prettier and eslint quote-style auto-fix ([31132ae](https://github.com/visulima/visulima/commit/31132aeab40b3f6fa920a37635813e14d7e8b17e))
+* **cerebro:** fix lint errors ([87649b0](https://github.com/visulima/visulima/commit/87649b0408ce3667bf1be9be795321851e6e8f15))
+* **cerebro:** housekeeping cleanup ([643b7d9](https://github.com/visulima/visulima/commit/643b7d9e268dca11544f0b9476b011a8620c04c8))
+
+### Continuous Integration
+
+* integrate codspeed for benchmark tracking ([e758f3d](https://github.com/visulima/visulima/commit/e758f3da491cc00d3f8bbf10d7ba3fdf8deb5325))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.16
+* **@visulima/pail:** upgraded to 4.0.0-alpha.13
+
 ## @visulima/cerebro [3.0.0-alpha.14](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.13...@visulima/cerebro@3.0.0-alpha.14) (2026-05-04)
 
 

package/LICENSE.md

@@ -289,11 +289,14 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 >
 > # Licenses of bundled dependencies
+>
 > The published @visulima/error artifact additionally contains code with the following licenses:
 > MIT
 >
 > # Bundled dependencies:
+>
 > ## is-plain-obj
+>
 > License: MIT
 > By: Sindre Sorhus
 > Repository: sindresorhus/is-plain-obj
@@ -1398,11 +1401,14 @@ Repository: git+https://github.com/visulima/visulima.git
 > <!-- DEPENDENCIES -->
 >
 > # Licenses of bundled dependencies
+>
 > The published @visulima/error artifact additionally contains code with the following licenses:
 > MIT
 >
 > # Bundled dependencies:
+>
 > ## is-plain-obj
+>
 > License: MIT
 > By: Sindre Sorhus
 > Repository: sindresorhus/is-plain-obj

package/dist/commands/completion-command.js

@@ -1,204 +1,5 @@
-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 };
+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};

package/dist/commands/help-command.js

@@ -1,262 +1 @@
-import { inverse, cyan, green, yellow } from '@visulima/colorize';
-import { t as templateFormat, c as commandLineUsage } from '../packem_shared/index--1UArng3.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 findChildren = (commands, parentPath) => {
-  const matches = [];
-  for (const cmd of commands.values()) {
-    if (cmd.hidden) {
-      continue;
-    }
-    const commandPath = cmd.commandPath ?? [];
-    if (commandPath.length !== parentPath.length) {
-      continue;
-    }
-    let isMatch = true;
-    for (let index = 0; index < parentPath.length; index += 1) {
-      if (commandPath[index] !== parentPath[index]) {
-        isMatch = false;
-        break;
-      }
-    }
-    if (isMatch) {
-      matches.push(cmd);
-    }
-  }
-  return matches;
-};
-const printParentHelp = (logger, runtime, parentPath, children) => {
-  const parentDisplay = parentPath.join(" ");
-  const usageGroups = [
-    {
-      content: `${cyan(runtime.getCliName())} ${green(parentDisplay)} ${green("<subcommand>")} [positional arguments] ${yellow("[options]")}`,
-      header: inverse.cyan(" Usage ")
-    },
-    {
-      content: children.map((child) => {
-        const fullPath = [...child.commandPath ?? [], child.name].join(" ");
-        return [green(fullPath), child.description ?? ""];
-      }),
-      header: inverse.green(" Subcommands ")
-    },
-    { header: inverse.yellow(" Global Options "), optionList: runtime.getGlobalOptions() },
-    {
-      content: `Run "${cyan(runtime.getCliName())} ${green(`${parentDisplay} <subcommand>`)} ${yellow("--help")}" for help with a specific subcommand.`,
-      raw: true
-    }
-  ];
-  (logger.raw ?? logger.log)(commandLineUsage(usageGroups));
-};
-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) {
-    const parentPath = name.split(" ").filter(Boolean);
-    const children = parentPath.length > 0 ? findChildren(commands, parentPath) : [];
-    if (children.length > 0) {
-      printParentHelp(logger, runtime, parentPath, children);
-      return;
-    }
-    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"
-    });
-  }
-  const ownPath = [...command.commandPath ?? [], command.name];
-  const ownChildren = findChildren(commands, ownPath);
-  if (ownChildren.length > 0) {
-    usageGroups.push({
-      content: ownChildren.map((child) => {
-        const fullPath = [...child.commandPath ?? [], child.name].join(" ");
-        return [green(fullPath), child.description ?? ""];
-      }),
-      header: inverse.green(" Subcommands ")
-    });
-  }
-  (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 };
+var O=Object.defineProperty;var f=(r,a)=>O(r,"name",{value:a,configurable:!0});import{green as c,inverse as p,cyan as u,yellow as g}from"@visulima/colorize";import{f as y,p as b}from"../packem_shared/index-B0BiusY7.js";const E=[{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:!1,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:!1,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}];var N=Object.defineProperty,h=f((r,a)=>N(r,"name",{value:a,configurable:!0}),"h");const $="__Other",v=h(r=>r.charAt(0).toUpperCase()+r.slice(1),"upperFirstChar"),w=h((r,a,l,o)=>{r.debug("no command given, printing general help...");let e=[...new Set(l.values())].filter(t=>!t.hidden);o&&(e=e.filter(t=>t.group===o));const i=e.reduce((t,s)=>{const n=s.group??$;return t[n]??=[],t[n].push(s),t},{}),d=h(t=>t.map(s=>{let n="";typeof s.alias=="string"?n=s.alias:Array.isArray(s.alias)&&(n=s.alias.join(", ")),n!==""&&(n=` [${n}]`);let m=s.name;return s.commandPath&&s.commandPath.length>0&&(m=`${s.commandPath.join(" ")} ${s.name}`),[`${c(m)}${n}`,s.description??""]}),"buildCommandList");(r.raw??r.log)(b([{content:`${u(a.getCliName())} ${c("<command>")} [positional arguments] ${g("[options]")}`,header:p.cyan(" Usage ")},...Object.keys(i).map(t=>{const s=o?` ${v(o)}`:"";return{content:d(i[t]),header:t===$||o?p.green(` Available${s} Commands `):` ${p.green(` ${v(t)} `)}`}}),l.has("help")?{header:p.yellow(" Command Options "),optionList:l.get("help").options?.filter(t=>!t.hidden)}:void 0,{header:p.yellow(" Global Options "),optionList:a.getGlobalOptions()},{content:E.filter(t=>!t.hidden).map(t=>[t.name,t.description??""]),header:p.magenta(" Environment Variables ")},{content:`Run "${u(a.getCliName())} ${c("help <command>")}" or "${u(a.getCliName())} ${c("<command>")} ${g("--help")}" for help with a specific command.`,raw:!0}].filter(Boolean)))},"printGeneralHelp"),C=h((r,a)=>{const l=[];for(const o of r.values()){if(o.hidden)continue;const e=o.commandPath??[];if(e.length!==a.length)continue;let i=!0;for(const[d,t]of a.entries())if(e[d]!==t){i=!1;break}i&&l.push(o)}return l},"findChildren"),P=h((r,a,l,o)=>{const e=l.join(" "),i=[{content:`${u(a.getCliName())} ${c(e)} ${c("<subcommand>")} [positional arguments] ${g("[options]")}`,header:p.cyan(" Usage ")},{content:o.map(d=>{const t=[...d.commandPath??[],d.name].join(" ");return[c(t),d.description??""]}),header:p.green(" Subcommands ")},{header:p.yellow(" Global Options "),optionList:a.getGlobalOptions()},{content:`Run "${u(a.getCliName())} ${c(`${e} <subcommand>`)} ${g("--help")}" for help with a specific subcommand.`,raw:!0}];(r.raw??r.log)(b(i))},"printParentHelp"),A=h((r,a,l,o)=>{let e=l.get(o);if(!e)for(const n of l.values()){const m=n.commandPath?[...n.commandPath,n.name]:[n.name];if(m.at(-1)===o||m.join(" ")===o){e=n;break}}if(!e){const n=o.split(" ").filter(Boolean),m=n.length>0?C(l,n):[];if(m.length>0){P(r,a,n,m);return}r.error(`Command "${o}" not found`);return}const i=[],d=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" ");if(i.push({content:`${u(a.getCliName())} ${c(d)}${e.argument?" [positional arguments]":""}${e.options?" [options]":""}`,header:p.cyan(" Usage ")}),e.description&&i.push({content:e.description,header:p.green(" Description ")}),e.argument&&i.push({header:"Command Positional Arguments",isArgument:!0,optionList:[e.argument]}),Array.isArray(e.options)&&e.options.length>0&&i.push({header:p.yellow(" Command Options "),optionList:e.options.filter(n=>!n.hidden)}),i.push({header:p.yellow(" Global Options "),optionList:a.getGlobalOptions()}),Array.isArray(e.env)&&e.env.length>0){const n=e.env.filter(m=>!m.hidden);n.length>0&&i.push({content:n.map(m=>[m.name,m.description??""]),header:p.magenta(" Environment Variables ")})}if(e.alias!==void 0&&e.alias.length>0){let n=e.alias;typeof e.alias=="string"&&(n=[e.alias]),i.splice(1,0,{content:n,header:"Alias(es)"})}Array.isArray(e.examples)&&e.examples.length>0&&i.push({content:e.examples,header:"Examples"});const t=[...e.commandPath??[],e.name],s=C(l,t);s.length>0&&i.push({content:s.map(n=>{const m=[...n.commandPath??[],n.name].join(" ");return[c(m),n.description??""]}),header:p.green(" Subcommands ")}),(r.raw??r.log)(b(i))},"printCommandHelp");class S{static{f(this,"x")}static{h(this,"HelpCommand")}name="help";options=[{description:"Display only the specified group",name:"group",type:String}];commands;constructor(a){this.commands=a}execute(a){const{commandName:l,logger:o,options:e,runtime:i}=a,{footer:d,header:t}=i.getCommandSection();t&&(o.raw??o.log)(y(t)),l==="help"?w(o,i,this.commands,typeof e?.group=="string"?e.group:void 0):A(o,i,this.commands,l),d&&(o.raw??o.log)(y(d))}}export{S as default};