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

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};

package/dist/commands/readme-command.d.ts

@@ -1,4 +1,4 @@
-import { C as Command } from "../packem_shared/plugin-manager.d-Du-YXFui.js";
+import { C as Command } from "../packem_shared/plugin-manager.d-Dz-wu1tI.js";
 import '@visulima/tabular';
 /**
 * Generates README documentation for cerebro CLI commands.

package/dist/commands/readme-command.js

@@ -1,252 +1,36 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  existsSync
-} = __cjs_getBuiltinModule("node:fs");
-const {
-  readFile,
-  mkdir,
-  writeFile
-} = __cjs_getBuiltinModule("node:fs/promises");
-const {
-  resolve,
-  join,
-  dirname
-} = __cjs_getBuiltinModule("node:path");
-import GithubSlugger from 'github-slugger';
-import { c as commandLineUsage } from '../packem_shared/index--1UArng3.js';
-import { g as getCwd, a as getVersions, b as getPlatform, c as getArch } from '../packem_shared/runtime-process-B6ZplyWn.js';
-
-const slugger = new GithubSlugger();
-const slugify = (text) => slugger.slug(text);
-const compact = (array) => array.filter(Boolean);
-const uniqBy = (array, keyFunction) => {
-  const seen = /* @__PURE__ */ new Set();
-  const result = [];
-  for (const item of array) {
-    const key = keyFunction(item);
-    if (!seen.has(key)) {
-      seen.add(key);
-      result.push(item);
-    }
-  }
-  return result;
-};
-const formatCommandUsage = (command, cliName) => {
-  const fullPath = command.commandPath ? [...command.commandPath, command.name] : [command.name];
-  const commandId = fullPath.join(" ");
-  if (command.argument) {
-    const argumentName = command.argument.name.toUpperCase();
-    const argumentString = command.argument.required ? argumentName : `[${argumentName}]`;
-    return `${cliName} ${commandId} ${argumentString}`;
-  }
-  return `${cliName} ${commandId}`;
-};
-const addEnvironmentVariables = (command, usageGroups) => {
-  if (!Array.isArray(command.env) || command.env.length === 0) {
-    return;
-  }
-  const visibleEnvVariables = command.env.filter((envVariable) => !envVariable.hidden);
-  if (visibleEnvVariables.length > 0) {
-    usageGroups.push({
-      content: visibleEnvVariables.map((envVariable) => [envVariable.name, envVariable.description ?? ""]),
-      header: " Environment Variables "
-    });
-  }
-};
-const formatCommandHelp = (command, cliName) => {
-  const usageGroups = [];
-  const fullCommandPath = command.commandPath ? [...command.commandPath, command.name] : [command.name];
-  const commandDisplay = fullCommandPath.join(" ");
-  const hasArgument = Boolean(command.argument);
-  const hasOptions = Boolean(command.options);
-  usageGroups.push({
-    content: `${cliName} ${commandDisplay}${hasArgument ? " [positional arguments]" : ""}${hasOptions ? " [options]" : ""}`,
-    header: " Usage "
-  });
-  if (command.description) {
-    usageGroups.push({ content: command.description, header: " 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: " Command Options ",
-      optionList: command.options.filter((option) => !option.hidden)
-    });
-  }
-  addEnvironmentVariables(command, usageGroups);
-  if (command.alias !== void 0 && command.alias.length > 0) {
-    const alias = Array.isArray(command.alias) ? command.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"
-    });
-  }
-  return commandLineUsage(usageGroups);
-};
-const renderCommand = (command, cliName) => {
-  const title = command.description?.trim().split("\n")[0] ?? "";
-  const usage = formatCommandUsage(command, cliName);
-  const helpText = formatCommandHelp(command, cliName);
-  return compact([`## \`${usage}\``, title, `\`\`\`
-${helpText.trim()}
-\`\`\``]).join("\n\n");
-};
-const generateUsage = (cliName, packageName, version, nodeVersion) => {
-  const versionFlags = ["--version", "-V"];
-  const versionFlagsString = `(${versionFlags.join("|")})`;
-  const platform = getPlatform();
-  const arch = getArch();
-  return `\`\`\`sh-session
-$ npm install -g ${packageName}
-$ ${cliName} COMMAND
+var O=Object.defineProperty;var f=(e,t)=>O(e,"name",{value:t,configurable:!0});import{createRequire as L}from"node:module";import U from"github-slugger";import{p as G}from"../packem_shared/index-B0BiusY7.js";import{g as F,a as M,b as W,c as z}from"../packem_shared/runtime-process-DKHFvYkv.js";const N=L(import.meta.url),g=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,A=f(e=>{if(typeof g<"u"&&g.versions&&g.versions.node){const[t,n]=g.versions.node.split(".").map(Number);if(t>22||t===22&&n>=3||t===20&&n>=16)return g.getBuiltinModule(e)}return N(e)},"__cjs_getBuiltinModule"),{existsSync:v}=A("node:fs"),{readFile:T,mkdir:k,writeFile:B}=A("node:fs/promises"),{resolve:P,join:V,dirname:q}=A("node:path");var H=Object.defineProperty,c=f((e,t)=>H(e,"name",{value:t,configurable:!0}),"m");const I=new U,C=c(e=>I.slug(e),"slugify"),J=c(e=>e.filter(Boolean),"compact"),K=c((e,t)=>{const n=new Set,o=[];for(const r of e){const i=t(r);n.has(i)||(n.add(i),o.push(r))}return o},"uniqBy"),D=c((e,t)=>{const n=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" ");if(e.argument){const o=e.argument.name.toUpperCase(),r=e.argument.required?o:`[${o}]`;return`${t} ${n} ${r}`}return`${t} ${n}`},"formatCommandUsage"),Q=c((e,t)=>{if(!Array.isArray(e.env)||e.env.length===0)return;const n=e.env.filter(o=>!o.hidden);n.length>0&&t.push({content:n.map(o=>[o.name,o.description??""]),header:" Environment Variables "})},"addEnvironmentVariables"),X=c((e,t)=>{const n=[],o=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" "),r=!!e.argument,i=!!e.options;if(n.push({content:`${t} ${o}${r?" [positional arguments]":""}${i?" [options]":""}`,header:" Usage "}),e.description&&n.push({content:e.description,header:" Description "}),e.argument&&n.push({header:"Command Positional Arguments",isArgument:!0,optionList:[e.argument]}),Array.isArray(e.options)&&e.options.length>0&&n.push({header:" Command Options ",optionList:e.options.filter(a=>!a.hidden)}),Q(e,n),e.alias!==void 0&&e.alias.length>0){const a=Array.isArray(e.alias)?e.alias:[e.alias];n.splice(1,0,{content:a,header:"Alias(es)"})}return Array.isArray(e.examples)&&e.examples.length>0&&n.push({content:e.examples,header:"Examples"}),G(n)},"formatCommandHelp"),Y=c((e,t)=>{const n=e.description?.trim().split(`
+`)[0]??"",o=D(e,t),r=X(e,t);return J([`## \`${o}\``,n,`\`\`\`
+${r.trim()}
+\`\`\``]).join(`
+
+`)},"renderCommand"),Z=c((e,t,n,o)=>{const r=`(${["--version","-V"].join("|")})`,i=W(),a=z();return`\`\`\`sh-session
+$ npm install -g ${t}
+$ ${e} COMMAND
 running command...
-$ ${cliName} ${versionFlagsString}
-${packageName}/${version ?? "unknown"} ${platform}-${arch} node-v${nodeVersion}
-$ ${cliName} --help [COMMAND]
+$ ${e} ${r}
+${t}/${n??"unknown"} ${i}-${a} node-v${o}
+$ ${e} --help [COMMAND]
 USAGE
-  $ ${cliName} COMMAND
+  $ ${e} COMMAND
 ...
 \`\`\`
-`;
-};
-const generateCommands = (commands, cliName, _options) => {
-  const commandList = commands.map((command) => {
-    const usage = formatCommandUsage(command, cliName);
-    return `* [\`${usage}\`](#${slugify(usage)})`;
-  });
-  const commandDocumentation = commands.map((command) => renderCommand(command, cliName)).map((s) => `${s.trim()}
-`);
-  return [...commandList, "", ...commandDocumentation].join("\n").trim();
-};
-const writeFileWithDirectory = async (filePath, content) => {
-  const directory = dirname(filePath);
-  if (!existsSync(directory)) {
-    await mkdir(directory, { recursive: true });
-  }
-  await writeFile(filePath, content, "utf8");
-};
-const generateMultiCommands = async (commands, outputDirectory, cliName, options) => {
-  const groupedCommands = /* @__PURE__ */ new Map();
-  for (const command of commands) {
-    const group = command.group ?? "__Other";
-    const groupCommands = groupedCommands.get(group) ?? [];
-    groupCommands.push(command);
-    groupedCommands.set(group, groupCommands);
-  }
-  const groups = Array.from(groupedCommands.entries(), ([group, groupCommands]) => {
-    if (group === "__Other") {
-      return ["Other", groupCommands];
-    }
-    return [group, groupCommands];
-  });
-  await Promise.all(
-    groups.map(async ([group, groupCommands]) => {
-      const groupPath = group.replaceAll(":", "/");
-      const filePath = join(".", outputDirectory, `${groupPath}.md`);
-      const bin = `\`${cliName} ${group}\``;
-      const document = `${[bin, "=".repeat(bin.length), "", `Commands in the ${group} group.`, "", generateCommands(groupCommands, cliName)].join("\n").trim()}
-`;
-      if (!options.dryRun) {
-        await writeFileWithDirectory(resolve(getCwd(), filePath), document);
-      }
-    })
-  );
-  const topicLinks = groups.map(([group]) => {
-    const groupPath = group.replaceAll(":", "/");
-    return `* [\`${cliName} ${group}\`](${outputDirectory}/${groupPath}.md)`;
-  });
-  return `${["# Command Topics\n", ...topicLinks].join("\n").trim()}
-`;
-};
-const normalizeLineEndings = (text) => text.replaceAll("\r\n", "\n").replaceAll("\r", "\n");
-const generateTableOfContents = (readme) => {
-  const normalizedReadme = normalizeLineEndings(readme);
-  const toc = normalizedReadme.split("\n").filter((line) => line.startsWith("# ")).map((line) => line.trim().slice(2)).map((line) => `* [${line}](#${slugify(line)})`);
-  return toc.join("\n");
-};
-const escapeRegex = (string_) => string_.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
-const replaceTag = (readme, tag, body) => {
-  const normalizedReadme = normalizeLineEndings(readme);
-  const tagStart = `<!-- ${tag} -->`;
-  const tagStop = `<!-- ${tag}stop -->`;
-  if (normalizedReadme.includes(tagStart) && normalizedReadme.includes(tagStop)) {
-    const escapedStart = escapeRegex(tagStart);
-    const escapedStop = escapeRegex(tagStop);
-    const tagPattern = new RegExp(String.raw`${escapedStart}(.|\n)*${escapedStop}`, "m");
-    return normalizedReadme.replace(tagPattern, `${tagStart}
-${body}
-${tagStop}`);
-  }
-  return normalizedReadme.replace(tagStart, `${tagStart}
-${body}
-${tagStop}`);
-};
-const readmeCommand = {
-  description: "Generate README documentation for CLI commands",
-  execute: async ({ logger, options, runtime }) => {
-    const cliName = runtime.getCliName();
-    const packageName = runtime.getPackageName() ?? cliName;
-    const packageVersion = runtime.getPackageVersion();
-    const versions = getVersions();
-    const nodeVersion = versions.node ?? "unknown";
-    const readmeOptions = {
-      aliases: options.aliases,
-      dryRun: options.dryRun,
-      multi: options.multi,
-      outputDir: options.outputDir ?? "docs",
-      readmePath: options.readmePath ?? "README.md",
-      version: options.version ?? packageVersion ?? void 0
-    };
-    const commandsMap = runtime.getCommands();
-    const commands = [...commandsMap.values()].filter((c) => !c.hidden).filter((c) => {
-      if (readmeOptions.aliases) {
-        return true;
-      }
-      return c.name === commandsMap.get(c.name)?.name;
-    }).toSorted((a, b) => {
-      const aPath = a.commandPath ? [...a.commandPath, a.name].join(" ") : a.name;
-      const bPath = b.commandPath ? [...b.commandPath, b.name].join(" ") : b.name;
-      return aPath.localeCompare(bPath);
-    });
-    const uniqueCommands = uniqBy(commands, (c) => {
-      const path = c.commandPath ? [...c.commandPath, c.name].join(" ") : c.name;
-      return path;
-    });
-    logger.debug(`Processing ${String(uniqueCommands.length)} commands for README generation`);
-    let readme;
-    const readmePath = resolve(getCwd(), readmeOptions.readmePath ?? "README.md");
-    if (existsSync(readmePath)) {
-      const rawReadme = await readFile(readmePath, "utf8");
-      readme = normalizeLineEndings(rawReadme);
-    } else {
-      logger.warn(`README file not found at ${readmePath}, creating template`);
-      readme = `# ${packageName}
+`},"generateUsage"),b=c((e,t,n)=>{const o=e.map(i=>{const a=D(i,t);return`* [\`${a}\`](#${C(a)})`}),r=e.map(i=>Y(i,t)).map(i=>`${i.trim()}
+`);return[...o,"",...r].join(`
+`).trim()},"generateCommands"),R=c(async(e,t)=>{const n=q(e);v(n)||await k(n,{recursive:!0}),await B(e,t,"utf8")},"writeFileWithDirectory"),ee=c(async(e,t,n,o)=>{const r=new Map;for(const a of e){const s=a.group??"__Other",l=r.get(s)??[];l.push(a),r.set(s,l)}const i=Array.from(r.entries(),([a,s])=>a==="__Other"?["Other",s]:[a,s]);return await Promise.all(i.map(async([a,s])=>{const l=a.replaceAll(":","/"),$=V(".",t,`${l}.md`),d=`\`${n} ${a}\``,p=`${[d,"=".repeat(d.length),"",`Commands in the ${a} group.`,"",b(s,n,o)].join(`
+`).trim()}
+`;o.dryRun||await R(P(M(),$),p)})),`${[`# Command Topics
+`,...i.map(([a])=>{const s=a.replaceAll(":","/");return`* [\`${n} ${a}\`](${t}/${s}.md)`})].join(`
+`).trim()}
+`},"generateMultiCommands"),w=c(e=>e.replaceAll(`\r
+`,`
+`).replaceAll("\r",`
+`),"normalizeLineEndings"),te=c(e=>w(e).split(`
+`).filter(t=>t.startsWith("# ")).map(t=>t.trim().slice(2)).map(t=>`* [${t}](#${C(t)})`).join(`
+`),"generateTableOfContents"),E=c(e=>e.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`),"escapeRegex"),y=c((e,t,n)=>{const o=w(e),r=`<!-- ${t} -->`,i=`<!-- ${t}stop -->`;if(o.includes(r)&&o.includes(i)){const a=E(r),s=E(i),l=new RegExp(String.raw`${a}(.|\n)*${s}`,"m");return o.replace(l,`${r}
+${n}
+${i}`)}return o.replace(r,`${r}
+${n}
+${i}`)},"replaceTag"),se={description:"Generate README documentation for CLI commands",execute:c(async({logger:e,options:t,runtime:n})=>{const o=n.getCliName(),r=n.getPackageName()??o,i=n.getPackageVersion(),a=F().node??"unknown",s={aliases:t.aliases,dryRun:t.dryRun,multi:t.multi,nestedTopicsDepth:t.nestedTopicsDepth,outputDir:t.outputDir??"docs",readmePath:t.readmePath??"README.md",repositoryPrefix:t.repositoryPrefix,version:t.version??i??void 0},l=n.getCommands(),$=[...l.values()].filter(m=>!m.hidden).filter(m=>s.aliases?!0:m.name===l.get(m.name)?.name).toSorted((m,h)=>{const _=m.commandPath?[...m.commandPath,m.name].join(" "):m.name,S=h.commandPath?[...h.commandPath,h.name].join(" "):h.name;return _.localeCompare(S)}),d=K($,m=>m.commandPath?[...m.commandPath,m.name].join(" "):m.name);e.debug(`Processing ${String(d.length)} commands for README generation`);let p;const u=P(M(),s.readmePath??"README.md");if(v(u)){const m=await T(u,"utf8");p=w(m)}else e.warn(`README file not found at ${u}, creating template`),p=`# ${r}
 
 <!-- usage -->
 <!-- usagestop -->
@@ -256,75 +40,6 @@ const readmeCommand = {
 
 <!-- toc -->
 <!-- tocstop -->
-`;
-    }
-    const outputDirectory = readmeOptions.outputDir ?? "docs";
-    const version = readmeOptions.version ?? packageVersion ?? "unknown";
-    readme = replaceTag(readme, "usage", generateUsage(cliName, packageName, version, nodeVersion));
-    readme = replaceTag(
-      readme,
-      "commands",
-      readmeOptions.multi ? await generateMultiCommands(uniqueCommands, outputDirectory, cliName, readmeOptions) : generateCommands(uniqueCommands, cliName)
-    );
-    readme = replaceTag(readme, "toc", generateTableOfContents(readme));
-    readme = `${readme.trimEnd()}
-`;
-    if (readmeOptions.dryRun) {
-      logger.info("Dry run mode - README not written");
-      logger.info(`Generated README content:
-${readme}`);
-    } else {
-      await writeFileWithDirectory(readmePath, readme);
-      logger.info(`README generated successfully at ${readmePath}`);
-    }
-  },
-  name: "readme",
-  options: [
-    {
-      description: "Include aliases in command list",
-      name: "aliases",
-      type: Boolean
-    },
-    {
-      description: "Show what would be generated without writing files",
-      name: "dry-run",
-      type: Boolean
-    },
-    {
-      description: "Generate multi-file documentation by command groups",
-      name: "multi",
-      type: Boolean
-    },
-    {
-      description: "Maximum depth for nested topics when using multi-file mode",
-      name: "nested-topics-depth",
-      type: Number
-    },
-    {
-      description: "Output directory for multi-file documentation",
-      name: "output-dir",
-      type: String,
-      typeLabel: "{underline directory}"
-    },
-    {
-      description: "Path to README file to generate",
-      name: "readme-path",
-      type: String,
-      typeLabel: "{underline path}"
-    },
-    {
-      description: "Repository prefix for code links",
-      name: "repository-prefix",
-      type: String,
-      typeLabel: "{underline prefix}"
-    },
-    {
-      description: "Version to use in generated documentation",
-      name: "version",
-      type: String,
-      typeLabel: "{underline version}"
-    }
-  ]
-};
-
-export { readmeCommand as default };
+`;const j=s.outputDir??"docs",x=s.version??i??"unknown";p=y(p,"usage",Z(o,r,x,a)),p=y(p,"commands",s.multi?await ee(d,j,o,s):b(d,o,s)),p=y(p,"toc",te(p)),p=`${p.trimEnd()}
+`,s.dryRun?(e.info("Dry run mode - README not written"),e.info(`Generated README content:
+${p}`)):(await R(u,p),e.info(`README generated successfully at ${u}`))},"execute"),name:"readme",options:[{description:"Include aliases in command list",name:"aliases",type:Boolean},{description:"Show what would be generated without writing files",name:"dry-run",type:Boolean},{description:"Generate multi-file documentation by command groups",name:"multi",type:Boolean},{description:"Maximum depth for nested topics when using multi-file mode",name:"nested-topics-depth",type:Number},{description:"Output directory for multi-file documentation",name:"output-dir",type:String,typeLabel:"{underline directory}"},{description:"Path to README file to generate",name:"readme-path",type:String,typeLabel:"{underline path}"},{description:"Repository prefix for code links",name:"repository-prefix",type:String,typeLabel:"{underline prefix}"},{description:"Version to use in generated documentation",name:"version",type:String,typeLabel:"{underline version}"}]};export{se as default};

package/dist/commands/version-command.d.ts

@@ -1,4 +1,4 @@
-import { C as Command } from "../packem_shared/plugin-manager.d-Du-YXFui.js";
+import { C as Command } from "../packem_shared/plugin-manager.d-Dz-wu1tI.js";
 import '@visulima/tabular';
 declare const _default: Command;
 export { _default as default };