feat: added help description for single command

bin/paragon-scripts.js

@@ -173,7 +173,7 @@ const COMMANDS = {
   }
 
   if (command === HELP_COMMAND) {
-    helpCommand(COMMANDS);
+    helpCommand(COMMANDS, commandArgs);
     return;
   }
 

lib/build-scss.js

@@ -9,8 +9,8 @@ const { pathToFileURL } = require('url');
 const path = require('path');
 const minimist = require('minimist');
 const chalk = require('chalk');
-const capitalize = require('lodash.capitalize');
 const ora = require('ora');
+const { capitalize } = require('./utils');
 
 const paragonThemeOutputFilename = 'theme-urls.json';
 

lib/help.js

@@ -1,18 +1,35 @@
 /* eslint-disable no-console */
 const chalk = require('chalk');
 
+/**
+ * Finds a command based on the given name in the commands object.
+ *
+ * @param {Array} commandName - The name to find the command.
+ * @param {Object} commands - The object containing commands to search in.
+ * @returns {Object|null} - The found command or null if the command is not found.
+ */
+const findCommandByName = (commandName, commands) => ((commandName in commands)
+  ? { [commandName]: commands[commandName] } : null);
+
 /**
  * Displays a help message for available commands, including descriptions, parameters, and options.
  *
  * @param {Object} commands - An object containing information about available commands.
+ * @param {Array} commandArgs - An array containing the command name.
  */
-function helpCommand(commands) {
+function helpCommand(commands, commandArgs) {
+  const retrievedCommands = commandArgs.length ? findCommandByName(commandArgs, commands) : commands;
+  if (!retrievedCommands) {
+    console.error(chalk.red.bold('Unknown command. Usage: paragon help <command>.'));
+    return;
+  }
+
   console.log(chalk.yellow.bold('Paragon Help'));
   console.log();
-  console.log('Available commands:');
+  console.log(`Available ${commandArgs.length ? 'command' : 'commands'}:`);
   console.log();
 
-  Object.entries(commands).forEach(([command, { parameters, description, options }]) => {
+  Object.entries(retrievedCommands).forEach(([command, { parameters, description, options }]) => {
     console.log(`  ${chalk.green.underline.bold(command)}`);
     if (description) {
       console.log(`      ${description}`);

lib/utils.js

@@ -0,0 +1,9 @@
+// eslint-disable-next-line import/prefer-default-export
+function capitalize(str) {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+module.exports = { capitalize };

package.json

@@ -65,7 +65,6 @@
     "file-selector": "^0.6.0",
     "glob": "^8.0.3",
     "inquirer": "^8.2.5",
-    "lodash.capitalize": "^4.2.1",
     "lodash.uniqby": "^4.7.0",
     "log-update": "^4.0.0",
     "mailto-link": "^2.0.0",