@clerc/plugin-help 1.0.3 → 1.1.0

package/README.md

@@ -2,23 +2,9 @@
 
 [![NPM version](https://img.shields.io/npm/v/@clerc/plugin-help?color=a1b858&label=)](https://www.npmjs.com/package/@clerc/plugin-help)
 
-Clerc plugin to add help command to your cli.
+## Documenation
 
-## 📦 Installation
-
-```bash
-$ npm install @clerc/plugin-help
-$ yarn add @clerc/plugin-help
-$ pnpm add @clerc/plugin-help
-```
-
-## 🚀 Usage
-
-```ts
-import { helpPlugin } from "@clerc/plugin-help";
-
-cli.use(helpPlugin());
-```
+Read the [documentation](https://clerc.so1ve.dev/official-plugins/plugin-help.html) for more details.
 
 ## 📝 License
 

package/dist/{index.d.ts → index.d.mts}

@@ -7,9 +7,9 @@ interface Formatters {
   formatFlagDefault: <T>(value: FlagDefaultValue<T>) => string;
 }
 /**
-* A group definition as a tuple of [key, displayName].
-* The key is used in help options to assign items to groups.
-* The displayName is shown in the help output.
+* A group definition as a tuple of [key, displayName]. The key is used in help
+* options to assign items to groups. The displayName is shown in the help
+* output.
 */
 type GroupDefinition = [key: string, name: string];
 /**
@@ -17,18 +17,15 @@ type GroupDefinition = [key: string, name: string];
 */
 interface GroupsOptions {
   /**
-  * Groups for commands.
-  * Each group is defined as `[key, name]`.
+  * Groups for commands. Each group is defined as `[key, name]`.
   */
   commands?: GroupDefinition[];
   /**
-  * Groups for command-specific flags.
-  * Each group is defined as `[key, name]`.
+  * Groups for command-specific flags. Each group is defined as `[key, name]`.
   */
   flags?: GroupDefinition[];
   /**
-  * Groups for global flags.
-  * Each group is defined as `[key, name]`.
+  * Groups for global flags. Each group is defined as `[key, name]`.
   */
   globalFlags?: GroupDefinition[];
 }
@@ -39,8 +36,8 @@ declare const defaultFormatters: Formatters;
 //#region src/index.d.ts
 interface HelpOptions {
   /**
-  * The group this item belongs to.
-  * The group must be defined in the `groups` option of `helpPlugin()`.
+  * The group this item belongs to. The group must be defined in the `groups`
+  * option of `helpPlugin()`.
   */
   group?: string;
 }
@@ -56,8 +53,8 @@ interface CommandHelpOptions extends HelpOptions {
   */
   notes?: string[];
   /**
-  * Examples to show in the help output.
-  * Each example is a tuple of `[command, description]`.
+  * Examples to show in the help output. Each example is a tuple of `[command,
+  * description]`.
   */
   examples?: [string, string][];
 }
@@ -99,8 +96,8 @@ interface HelpPluginOptions {
   */
   notes?: string[];
   /**
-  * Examples to show in the help output.
-  * Each example is a tuple of `[command, description]`.
+  * Examples to show in the help output. Each example is a tuple of `[command,
+  * description]`.
   */
   examples?: [string, string][];
   /**
@@ -116,10 +113,10 @@ interface HelpPluginOptions {
   */
   formatters?: Partial<Formatters>;
   /**
-  * Group definitions for commands and flags.
-  * Groups allow organizing commands and flags into logical sections in help output.
-  * Each group is defined as `[key, name]` where `key` is the identifier used in help options
-  * and `name` is the display name shown in help output.
+  * Group definitions for commands and flags. Groups allow organizing commands
+  * and flags into logical sections in help output. Each group is defined as
+  * `[key, name]` where `key` is the identifier used in help options and `name`
+  * is the display name shown in help output.
   */
   groups?: GroupsOptions;
 }

package/dist/{index.js → index.mjs}

@@ -114,7 +114,7 @@ var HelpRenderer = class {
 				});
 				usage += ` ${items.join(" ")}`;
 			}
-		} else if (this._cli._commands.size > 0 && !(this._cli._commands.has("") && this._cli._commands.size === 1)) usage += this._cli._commands.has("") ? ` ${tint.dim("[command]")}` : ` ${tint.dim("<command>")}`;
+		} else if (this._cli._commands.size > 0 && (!this._cli._commands.has("") || this._cli._commands.size !== 1)) usage += this._cli._commands.has("") ? ` ${tint.dim("[command]")}` : ` ${tint.dim("<command>")}`;
 		if (command?.flags && !objectIsEmpty(command.flags) || !objectIsEmpty(this._globalFlags)) usage += ` ${tint.dim("[flags]")}`;
 		return {
 			title: "Usage",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/plugin-help",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc plugin help",
@@ -25,19 +25,12 @@
   "license": "MIT",
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "*": [
-        "./dist/*",
-        "./dist/index.d.ts"
-      ]
-    }
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
   },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
@@ -48,13 +41,13 @@
     "@uttr/tint": "^0.1.3",
     "string-width": "^8.1.0",
     "text-table": "^0.2.0",
-    "@clerc/utils": "1.0.3"
+    "@clerc/utils": "1.1.0"
   },
   "devDependencies": {
     "@types/text-table": "^0.2.5",
     "kons": "^0.7.1",
-    "@clerc/core": "1.0.3",
-    "@clerc/parser": "1.0.3"
+    "@clerc/parser": "1.1.0",
+    "@clerc/core": "1.1.0"
   },
   "peerDependencies": {
     "@clerc/core": "*"