Version Update with new features

Author: sameer52718

README.md

@@ -1,39 +1,114 @@
+To create a `README.md` file for your `fancy-progress-cli` project, I'll help refine the provided content into a polished, professional, and Markdown-formatted README. The content you shared is already well-structured, so I'll enhance it with clearer sections, improved formatting, and additional details commonly found in a README to make it more complete and user-friendly.
 
-# 🎉 fancy-progress-cli
+Below is the `README.md` content:
 
-A customizable, emoji-themed CLI progress bar tool for Node.js.
+```markdown
+# 🎉 Fancy Progress CLI
+
+A customizable, emoji-themed CLI progress bar tool for Node.js. Add some flair to your terminal with visually engaging progress bars, perfect for scripts, automation tasks, or just for fun!
 
 ## 📦 Installation
 
+Install the package globally using npm:
+
 ```bash
 npm install -g fancy-progress-cli
-````
+```
 
 ## 🚀 Usage
 
+Run the CLI with customizable options to display a progress bar with your preferred theme and settings:
+
 ```bash
 fancy-progress --total 50 --speed 80 --theme hearts --message "All done!"
 ```
 
+This command creates a progress bar with 50 steps, updates every 80ms, uses the `hearts` theme, and displays "All done!" when complete.
+
 ## 🔧 Options
 
-| Flag        | Alias | Description                  | Default       |
-| ----------- | ----- | ---------------------------- | ------------- |
-| `--total`   | `-t`  | Total steps to complete      | `50`          |
-| `--speed`   | `-s`  | Milliseconds between steps   | `100`         |
-| `--theme`   | `-m`  | Theme for the progress bar   | `classic`     |
-| `--message` |       | Final message after complete | `✅ Complete!` |
+Customize the progress bar using the following command-line flags:
+
+| Flag            | Alias | Description                              | Default            |
+|-----------------|-------|------------------------------------------|--------------------|
+| `--total`       | `-t`  | Total number of steps in the progress bar | `50`               |
+| `--speed`       | `-s`  | Interval between updates (milliseconds)  | `100`              |
+| `--theme`       | `-m`  | Theme for the progress bar (or `random`) | `classic`          |
+| `--message`     | `-msg`| Final message after completion           | `✅ All done!`      |
+| `--list-themes` |       | List all available themes with previews  |                    |
+
+Use `--help` or `-h` to see the help menu:
+
+```bash
+fancy-progress --help
+```
 
 ## 🎨 Themes
 
-* `classic` → █ / ░
-* `stars` → ★ / ☆
-* `hearts` → ❤ / ♡
-* `dots` → ● / ○
-* `blocks` → ▓ / ▒
+Choose from a variety of themes to style your progress bar. Use the `--theme` flag to select one, or use `random` for a surprise!
+
+| Theme      | Complete / Incomplete |
+|------------|----------------------|
+| `classic`  | █ / ░                |
+| `stars`    | ★ / ☆                |
+| `hearts`   | ❤ / ♡                |
+| `dots`     | ● / ○                |
+| `blocks`   | ▓ / ▒                |
+| `arrows`   | ➤ / ➞                |
+| `flames`   | 🔥 / ·                |
+| `bouncy`   | ⣿ / ⣀               |
+| `emoji`    | 🟩 / ⬜               |
+| `tech`     | # / -                |
+| `zen`      | ✦ / ⋆                |
+| `sushi`    | 🍣 / 🥢               |
+| `moon`     | 🌕 / 🌑               |
+| `plants`   | 🌱 / 🌿               |
 
-## 💻 Example
+Preview all themes with:
 
 ```bash
-fancy-progress -t 40 -s 60 -m stars --message "✨ Finished!"
+fancy-progress --list-themes
+```
+
+## 💻 Examples
+
+1. Use the `stars` theme with a custom message:
+
+```bash
+fancy-progress --total 40 --speed 60 --theme stars --message "✨ Finished!"
+```
+
+2. Try a random theme with 30 steps:
+
+```bash
+fancy-progress --total 30 --theme random --message "Surprise complete!"
+```
+
+3. Fast progress with the `flames` theme:
+
+```bash
+fancy-progress --total 30 --speed 50 --theme flames --message "🔥 Burn complete!"
+```
+
+## 🛠️ Dependencies
+
+- [cli-progress](https://www.npmjs.com/package/cli-progress): For rendering the progress bar.
+- [chalk](https://www.npmjs.com/package/chalk): For colorful terminal output.
+- [yargs](https://www.npmjs.com/package/yargs): For parsing command-line arguments.
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests on the [GitHub repository](https://github.com/sameer52718/fancy-progress-cli).
+
+## 📬 Contact
+
+For questions or feedback, reach out via [GitHub Issues](https://github.com/sameer52718/fancy-progress-cli/issues).
+
+---
+
+Happy progressing! 🚀
 ```

cli.js

@@ -5,55 +5,82 @@ const chalk = require("chalk");
 const yargs = require("yargs");
 const themes = require("./themes");
 
+const themeKeys = Object.keys(themes);
+
+// Parse CLI arguments
 const argv = yargs
   .option("total", {
     alias: "t",
     type: "number",
     default: 50,
-    describe: "Total number of steps",
+    describe: "Total number of steps in the progress bar",
   })
   .option("speed", {
     alias: "s",
     type: "number",
     default: 100,
-    describe: "Interval speed in ms",
+    describe: "Interval speed in milliseconds",
   })
   .option("theme", {
     alias: "m",
-    choices: Object.keys(themes),
+    type: "string",
     default: "classic",
-    describe: "Progress bar theme",
+    describe: "Theme name or 'random' for a surprise",
+    choices: [...themeKeys, "random"],
   })
   .option("message", {
     alias: "msg",
     type: "string",
-    describe: "Completion message",
+    describe: "Final message after progress completes",
+  })
+  .option("list-themes", {
+    type: "boolean",
+    describe: "List all available themes with preview",
   })
-  .help().argv;
+  .help()
+  .alias("help", "h").argv;
 
-const theme = themes[argv.theme];
+// Handle --list-themes command
+if (argv["list-themes"]) {
+  console.log(chalk.bold("\n🎨 Available Themes:\n"));
+  themeKeys.forEach((key) => {
+    const t = themes[key];
+    console.log(
+      `${key.padEnd(10)} → ${chalk.green(t.complete.repeat(3))}${chalk.gray(" ")}${chalk.white(t.incomplete.repeat(3))}`
+    );
+  });
+  console.log();
+  process.exit(0);
+}
 
+// Select theme
+const selectedTheme =
+  argv.theme === "random"
+    ? themes[themeKeys[Math.floor(Math.random() * themeKeys.length)]]
+    : themes[argv.theme] || themes.classic;
+
+// Create and start the progress bar
 const bar = new cliProgress.SingleBar({
-  format: `{bar} | ${chalk.cyan("{percentage}%")} | ${chalk.green("{value}/{total}")}`,
-  barCompleteChar: theme.complete,
-  barIncompleteChar: theme.incomplete,
+  format: `${chalk.magenta("{bar}")} | ${chalk.cyan("{percentage}%")} | ${chalk.green("{value}/{total}")}`,
+  barCompleteChar: selectedTheme.complete,
+  barIncompleteChar: selectedTheme.incomplete,
   hideCursor: true,
 });
 
 const total = argv.total;
+let value = 0;
+
 bar.start(total, 0);
 
-let value = 0;
 const interval = setInterval(() => {
   value++;
   bar.update(value);
+
   if (value >= total) {
-    bar.stop();
     clearInterval(interval);
-    if (argv.message) {
-      console.log(chalk.green(`🎉 ${argv.message}`));
-    } else {
-      console.log(chalk.cyan("✅ All done!"));
-    }
+    bar.stop();
+    console.log(
+      chalk.green(`\n${argv.message ? `🎉 ${argv.message}` : "✅ All done!"}`)
+    );
   }
 }, argv.speed);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "fancy-progress-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A customizable emoji-themed CLI progress bar tool",
   "main": "cli.js",
   "bin": {

themes.js

@@ -1,23 +1,58 @@
 module.exports = {
-    classic: {
-      complete: '█',
-      incomplete: '░'
-    },
-    stars: {
-      complete: '★',
-      incomplete: '☆'
-    },
-    hearts: {
-      complete: '❤',
-      incomplete: '♡'
-    },
-    dots: {
-      complete: '●',
-      incomplete: '○'
-    },
-    blocks: {
-      complete: '▓',
-      incomplete: '▒'
-    }
-  };
-  
+  classic: {
+    complete: '█',
+    incomplete: '░'
+  },
+  stars: {
+    complete: '★',
+    incomplete: '☆'
+  },
+  hearts: {
+    complete: '❤',
+    incomplete: '♡'
+  },
+  dots: {
+    complete: '●',
+    incomplete: '○'
+  },
+  blocks: {
+    complete: '▓',
+    incomplete: '▒'
+  },
+  arrows: {
+    complete: '➤',
+    incomplete: '➞'
+  },
+  flames: {
+    complete: '🔥',
+    incomplete: '·'
+  },
+  bouncy: {
+    complete: '⣿',
+    incomplete: '⣀'
+  },
+  emoji: {
+    complete: '🟩',
+    incomplete: '⬜'
+  },
+  tech: {
+    complete: '#',
+    incomplete: '-'
+  },
+  zen: {
+    complete: '✦',
+    incomplete: '⋆'
+  },
+  sushi: {
+    complete: '🍣',
+    incomplete: '🥢'
+  },
+  moon: {
+    complete: '🌕',
+    incomplete: '🌑'
+  },
+  plants: {
+    complete: '🌱',
+    incomplete: '🌿'
+  }
+};