@clerc/plugin-help 1.0.3 → 1.1.1

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.mjs

@@ -0,0 +1,8 @@
+import{DOUBLE_DASH as e,NoSuchCommandError as t,definePlugin as n,normalizeFlagValue as r,normalizeParameterValue as i,resolveCommand as a}from"@clerc/core";import{formatFlagName as o,formatVersion as s,isTruthy as c,objectIsEmpty as l,toArray as u}from"@clerc/utils";import*as d from"@uttr/tint";import f from"string-width";import p from"text-table";function m(e){if(typeof e==`function`)return e.display??e.name;let t=e[0];return`Array<${t.displayName??t.name}>`}function h(e){return typeof e==`function`&&`display`in e&&e.display?e.display:String(e)}function g(e){return e===``?`(root)`:e}const _={formatTypeValue:m,formatFlagDefault:h},v=`default`,y=e=>p(e,{stringLength:f}),b=e=>y(e).split(`
+`),x=` `.repeat(2),S=e=>`${x}${e}`;function C(e){let t=new Map;if(e)for(let[n,r]of e)t.set(n,r);return t}function w(e,t,n,r){if(e&&e!==v&&!t.has(e))throw Error(`Unknown ${n} group "${e}" for "${r}". Available groups: ${[...t.keys()].join(`, `)||`(none)`}`)}var T=class{_command;get _commandGroups(){return C(this._getGroups().commands)}get _flagGroups(){return C(this._getGroups().flags)}get _globalFlagGroups(){return C(this._getGroups().globalFlags)}constructor(e,t,n,r,i,a){this._formatters=e,this._cli=t,this._globalFlags=n,this._getGroups=r,this._examples=i,this._notes=a}setCommand(e){e&&(this._command=e,this._examples=e?.help?.examples,this._notes=e?.help?.notes)}renderSections(e){return e.filter(c).map(e=>{let t=Array.isArray(e.body)?e.body.filter(e=>e!==void 0).join(`
+`):e.body;return e.title?`${d.underline.bold(e.title)}\n${t.split(`
+`).map(S).join(`
+`)}`:t}).join(`
+
+`)}render(){let e=[this.renderHeader(),this.renderUsage(),this.renderParameters(),this.renderCommandFlags(),this.renderGlobalFlags(),this.renderCommands(),this.renderExamples(),this.renderNotes()];return this.renderSections(e)}renderHeader(){let{_scriptName:e,_version:t,_description:n}=this._cli,r=this._command,i=r?r.description:n,a=`${!r||r.name===``?d.bold(e):d.dim(e)}${r?.name?` ${d.bold(r.name)}`:``}${r?``:` ${s(t)}`}`,o=r?.alias?`Alias${u(r.alias).length>1?`es`:``}: ${u(r.alias).map(e=>d.bold(e)).join(`, `)}`:void 0;return{body:[`${a}${i?` - ${i}`:``}`,o]}}renderUsage(){let{_scriptName:t}=this._cli,n=this._command,r=`$ ${t}`;if(n){if(n.name&&(r+=` ${n.name}`),n.parameters){let t=n.parameters.indexOf(e),i=t!==-1&&n.parameters.slice(t+1).some(e=>(typeof e==`string`?e:e.key).startsWith(`<`)),a=n.parameters.map(t=>{let n=typeof t==`string`?t:t.key;return t===e&&(n=i?e:`[${e}]`),n});r+=` ${a.join(` `)}`}}else this._cli._commands.size>0&&(!this._cli._commands.has(``)||this._cli._commands.size!==1)&&(r+=this._cli._commands.has(``)?` ${d.dim(`[command]`)}`:` ${d.dim(`<command>`)}`);return(n?.flags&&!l(n.flags)||!l(this._globalFlags))&&(r+=` ${d.dim(`[flags]`)}`),{title:`Usage`,body:[r]}}renderParameters(){let t=this._command;if(!(!t?.parameters||t.parameters.length===0))return{title:`Parameters`,body:b(t.parameters.filter(t=>t!==e).map(i).map(({key:e,type:t,description:n})=>{let r=t?this._formatters.formatTypeValue(t):`string`;return[d.bold(e),d.dim(r),n].filter(c)}))}}getSubcommands(e){let t=new Map;if(e===``)return t;let n=`${e} `;for(let[e,r]of this._cli._commands)if(e.startsWith(n)){let i=e.slice(n.length);t.set(i,r)}return t}buildGroupedCommandsBody(e,t){let n=new Map,r=[],i=[];for(let a of e.values()){if(a.__isAlias||a.help?.show===!1)continue;let e=a.help?.group;w(e,this._commandGroups,`command`,a.name);let o=[`${d.bold(g(a.name.slice(t.length)))}${a.alias?` (${u(a.alias).join(`, `)})`:``}`,a.description].filter(c);if(a.name===``)i=o;else if(e&&e!==v){let t=n.get(e)??[];t.push(o),n.set(e,t)}else r.push(o)}let a=[],o=[];i.length>0&&o.push(i),r.length>0&&o.push(...r),o.length>0&&a.push(...b(o));for(let[e,t]of this._commandGroups){let r=n.get(e);r&&r.length>0&&(a.length>0&&a.push(``),a.push(`${d.dim(t)}`),a.push(...b(r).map(S)))}return a}renderAvailableSubcommands(e){let t=this.getSubcommands(e);if(t.size===0)return null;let n=`${e} `,r=this.buildGroupedCommandsBody(t,n);if(r.length===0)return null;let i=[{body:`${this._cli._scriptName} ${d.bold(e)} not found`},{title:`Available Subcommands`,body:r}];return this.renderSections(i)}renderCommands(){let e=this._cli._commands,t,n=`Commands`,r=``;if(this._command){if(r=this._command.name?`${this._command.name} `:``,n=`Subcommands`,t=this.getSubcommands(this._command.name),t.size===0)return}else t=e;if(t.size===0)return;let i=this.buildGroupedCommandsBody(t,r);return{title:n,body:i}}renderFlagItem(e,t){t=r(t);let n=o(e);t.short&&(n+=`, ${o(t.short)}`);let i=this._formatters.formatTypeValue(t.type),a=t.default!==void 0&&d.dim(`[default: ${d.bold(this._formatters.formatFlagDefault(t.default))}]`);return[d.bold(n),d.dim(i),t.description,a].filter(c)}renderGroupedFlags(e,t,n){let r=new Map,i=[];for(let[a,o]of Object.entries(e)){let e=o.help?.group;w(e,t,n,a);let s=this.renderFlagItem(a,o);if(e&&e!==v){let t=r.get(e)??[];t.push(s),r.set(e,t)}else i.push(s)}let a=[];i.length>0&&a.push(...b(i));for(let[e,n]of t){let t=r.get(e);t&&t.length>0&&(a.length>0&&a.push(``),a.push(`${d.dim(n)}`),a.push(...b(t).map(S)))}return a}renderCommandFlags(){let e=this._command;if(!(!e?.flags||l(e.flags)))return{title:`Flags`,body:this.renderGroupedFlags(e.flags,this._flagGroups,`flag`)}}renderGlobalFlags(){if(!(!this._globalFlags||l(this._globalFlags)))return{title:`Global Flags`,body:this.renderGroupedFlags(this._globalFlags,this._globalFlagGroups,`global flag`)}}renderNotes(){if(this._notes?.length)return{title:`Notes`,body:this._notes}}renderExamples(){if(this._examples?.length)return{title:`Examples`,body:b(this._examples.map(([e,t])=>[e,`-`,t]))}}};function E(e,{groups:t}){e.store.help={addGroup:e=>{e.commands&&(t.commands=[...t.commands??[],...e.commands]),e.flags&&(t.flags=[...t.flags??[],...e.flags]),e.globalFlags&&(t.globalFlags=[...t.globalFlags??[],...e.globalFlags])}}}const D=({command:e=!0,flag:r=!0,showHelpWhenNoCommandSpecified:i=!0,notes:o,examples:s,header:l,footer:u,formatters:d,groups:f={}}={})=>n({setup:n=>{E(n,{groups:f});let p={..._,...d};function m(e){l&&console.log(l),console.log(e),u&&console.log(u)}let h=new T(p,n,n._globalFlags,()=>f,s,o);function g(e){let t=h.renderAvailableSubcommands(e);return t?(m(t),!0):!1}e&&n.command(`help`,`Show help`,{parameters:[`[command...]`],help:{notes:[`If no command is specified, show help for the CLI.`,`If a command is specified, show help for the command.`,r&&`-h is an alias for --help.`].filter(c),examples:[e&&[`$ ${n._scriptName} help`,`Show help`],e&&[`$ ${n._scriptName} help <command>`,`Show help for a specific command`],r&&[`$ ${n._scriptName} <command> --help`,`Show help for a specific command`]].filter(c)}}).on(`help`,e=>{let r=e.parameters.command,i;if(r.length>0&&([i]=a(n._commands,r),!i)){let e=r.join(` `);if(g(e))return;throw new t(e)}h.setCommand(i),m(h.render())}),r&&n.globalFlag(`help`,`Show help`,{short:`h`,type:Boolean,default:!1}),n.interceptor({enforce:`post`,handler:async(e,t)=>{if(e.flags.help){let n=e.command;if(!n&&e.rawParsed.parameters.length>0){if(g(e.rawParsed.parameters.join(` `)))return;await t()}h.setCommand(n),m(h.render())}else i&&!e.command&&e.rawParsed.parameters.length===0?(console.log(`No command specified. Showing help:
+`),m(h.render())):await t()}})}});export{_ as defaultFormatters,D as helpPlugin};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/plugin-help",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "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.1"
   },
   "devDependencies": {
     "@types/text-table": "^0.2.5",
     "kons": "^0.7.1",
-    "@clerc/core": "1.0.3",
-    "@clerc/parser": "1.0.3"
+    "@clerc/core": "1.1.1",
+    "@clerc/parser": "1.1.1"
   },
   "peerDependencies": {
     "@clerc/core": "*"

package/dist/index.js

@@ -1,370 +0,0 @@
-import { DOUBLE_DASH, NoSuchCommandError, definePlugin, normalizeFlagValue, normalizeParameterValue, resolveCommand } from "@clerc/core";
-import { formatFlagName, formatVersion, isTruthy, objectIsEmpty, toArray } from "@clerc/utils";
-import * as tint from "@uttr/tint";
-import stringWidth from "string-width";
-import textTable from "text-table";
-
-//#region src/utils.ts
-function formatTypeValue(type) {
-	if (typeof type === "function") return type.display ?? type.name;
-	const innerType = type[0];
-	return `Array<${innerType.displayName ?? innerType.name}>`;
-}
-function formatFlagDefault(value) {
-	if (typeof value === "function" && "display" in value && value.display) return value.display;
-	return String(value);
-}
-function formatCommandName(name) {
-	if (name === "") return "(root)";
-	return name;
-}
-
-//#endregion
-//#region src/formatters.ts
-const defaultFormatters = {
-	formatTypeValue,
-	formatFlagDefault
-};
-
-//#endregion
-//#region src/renderer.ts
-const DEFAULT_GROUP_KEY = "default";
-const table = (items) => textTable(items, { stringLength: stringWidth });
-const splitTable = (items) => table(items).split("\n");
-const DELIMITER = "-";
-const INDENT = " ".repeat(2);
-const withIndent = (str) => `${INDENT}${str}`;
-function groupDefinitionsToMap(definitions) {
-	const map = /* @__PURE__ */ new Map();
-	if (definitions) for (const [key, name] of definitions) map.set(key, name);
-	return map;
-}
-function validateGroup(group, groupMap, itemType, itemName) {
-	if (group && group !== DEFAULT_GROUP_KEY && !groupMap.has(group)) throw new Error(`Unknown ${itemType} group "${group}" for "${itemName}". Available groups: ${[...groupMap.keys()].join(", ") || "(none)"}`);
-}
-var HelpRenderer = class {
-	_command;
-	get _commandGroups() {
-		return groupDefinitionsToMap(this._getGroups().commands);
-	}
-	get _flagGroups() {
-		return groupDefinitionsToMap(this._getGroups().flags);
-	}
-	get _globalFlagGroups() {
-		return groupDefinitionsToMap(this._getGroups().globalFlags);
-	}
-	constructor(_formatters, _cli, _globalFlags, _getGroups, _examples, _notes) {
-		this._formatters = _formatters;
-		this._cli = _cli;
-		this._globalFlags = _globalFlags;
-		this._getGroups = _getGroups;
-		this._examples = _examples;
-		this._notes = _notes;
-	}
-	setCommand(command) {
-		if (command) {
-			this._command = command;
-			this._examples = command?.help?.examples;
-			this._notes = command?.help?.notes;
-		}
-	}
-	renderSections(sections) {
-		return sections.filter(isTruthy).map((section) => {
-			const body = Array.isArray(section.body) ? section.body.filter((s) => s !== void 0).join("\n") : section.body;
-			if (!section.title) return body;
-			return `${tint.underline.bold(section.title)}\n${body.split("\n").map(withIndent).join("\n")}`;
-		}).join("\n\n");
-	}
-	render() {
-		const sections = [
-			this.renderHeader(),
-			this.renderUsage(),
-			this.renderParameters(),
-			this.renderCommandFlags(),
-			this.renderGlobalFlags(),
-			this.renderCommands(),
-			this.renderExamples(),
-			this.renderNotes()
-		];
-		return this.renderSections(sections);
-	}
-	renderHeader() {
-		const { _scriptName, _version, _description } = this._cli;
-		const command = this._command;
-		const description = command ? command.description : _description;
-		const headerLine = `${!command || command.name === "" ? tint.bold(_scriptName) : tint.dim(_scriptName)}${command?.name ? ` ${tint.bold(command.name)}` : ""}${command ? "" : ` ${formatVersion(_version)}`}`;
-		const alias = command?.alias ? `Alias${toArray(command.alias).length > 1 ? "es" : ""}: ${toArray(command.alias).map((a) => tint.bold(a)).join(", ")}` : void 0;
-		return { body: [`${headerLine}${description ? ` ${DELIMITER} ${description}` : ""}`, alias] };
-	}
-	renderUsage() {
-		const { _scriptName } = this._cli;
-		const command = this._command;
-		let usage = `$ ${_scriptName}`;
-		if (command) {
-			if (command.name) usage += ` ${command.name}`;
-			if (command.parameters) {
-				const doubleDashIndex = command.parameters.indexOf(DOUBLE_DASH);
-				const hasRequiredAfterDoubleDash = doubleDashIndex !== -1 && command.parameters.slice(doubleDashIndex + 1).some((parameter) => {
-					return (typeof parameter === "string" ? parameter : parameter.key).startsWith("<");
-				});
-				const items = command.parameters.map((parameter) => {
-					let key = typeof parameter === "string" ? parameter : parameter.key;
-					if (parameter === DOUBLE_DASH) key = hasRequiredAfterDoubleDash ? DOUBLE_DASH : `[${DOUBLE_DASH}]`;
-					return key;
-				});
-				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>")}`;
-		if (command?.flags && !objectIsEmpty(command.flags) || !objectIsEmpty(this._globalFlags)) usage += ` ${tint.dim("[flags]")}`;
-		return {
-			title: "Usage",
-			body: [usage]
-		};
-	}
-	renderParameters() {
-		const command = this._command;
-		if (!command?.parameters || command.parameters.length === 0) return;
-		return {
-			title: "Parameters",
-			body: splitTable(command.parameters.filter((parameter) => parameter !== DOUBLE_DASH).map(normalizeParameterValue).map(({ key, type, description }) => {
-				const formattedType = type ? this._formatters.formatTypeValue(type) : "string";
-				return [
-					tint.bold(key),
-					tint.dim(formattedType),
-					description
-				].filter(isTruthy);
-			}))
-		};
-	}
-	getSubcommands(parentCommandName) {
-		const subcommands = /* @__PURE__ */ new Map();
-		if (parentCommandName === "") return subcommands;
-		const prefix = `${parentCommandName} `;
-		for (const [name, command] of this._cli._commands) if (name.startsWith(prefix)) {
-			const subcommandName = name.slice(prefix.length);
-			subcommands.set(subcommandName, command);
-		}
-		return subcommands;
-	}
-	buildGroupedCommandsBody(commandsToShow, prefix) {
-		const groupedCommands = /* @__PURE__ */ new Map();
-		const defaultCommands = [];
-		let rootCommand = [];
-		for (const command of commandsToShow.values()) {
-			if (command.__isAlias || command.help?.show === false) continue;
-			const group = command.help?.group;
-			validateGroup(group, this._commandGroups, "command", command.name);
-			const item = [`${tint.bold(formatCommandName(command.name.slice(prefix.length)))}${command.alias ? ` (${toArray(command.alias).join(", ")})` : ""}`, command.description].filter(isTruthy);
-			if (command.name === "") rootCommand = item;
-			else if (group && group !== DEFAULT_GROUP_KEY) {
-				const groupItems = groupedCommands.get(group) ?? [];
-				groupItems.push(item);
-				groupedCommands.set(group, groupItems);
-			} else defaultCommands.push(item);
-		}
-		const body = [];
-		const defaultGroup = [];
-		if (rootCommand.length > 0) defaultGroup.push(rootCommand);
-		if (defaultCommands.length > 0) defaultGroup.push(...defaultCommands);
-		if (defaultGroup.length > 0) body.push(...splitTable(defaultGroup));
-		for (const [key, name] of this._commandGroups) {
-			const items = groupedCommands.get(key);
-			if (items && items.length > 0) {
-				if (body.length > 0) body.push("");
-				body.push(`${tint.dim(name)}`);
-				body.push(...splitTable(items).map(withIndent));
-			}
-		}
-		return body;
-	}
-	renderAvailableSubcommands(parentCommandName) {
-		const subcommands = this.getSubcommands(parentCommandName);
-		if (subcommands.size === 0) return null;
-		const prefix = `${parentCommandName} `;
-		const body = this.buildGroupedCommandsBody(subcommands, prefix);
-		if (body.length === 0) return null;
-		const sections = [{ body: `${this._cli._scriptName} ${tint.bold(parentCommandName)} not found` }, {
-			title: "Available Subcommands",
-			body
-		}];
-		return this.renderSections(sections);
-	}
-	renderCommands() {
-		const commands = this._cli._commands;
-		let commandsToShow;
-		let title = "Commands";
-		let prefix = "";
-		if (this._command) {
-			prefix = this._command.name ? `${this._command.name} ` : "";
-			title = "Subcommands";
-			commandsToShow = this.getSubcommands(this._command.name);
-			if (commandsToShow.size === 0) return;
-		} else commandsToShow = commands;
-		if (commandsToShow.size === 0) return;
-		const body = this.buildGroupedCommandsBody(commandsToShow, prefix);
-		return {
-			title,
-			body
-		};
-	}
-	renderFlagItem(name, flag) {
-		flag = normalizeFlagValue(flag);
-		let flagName = formatFlagName(name);
-		if (flag.short) flagName += `, ${formatFlagName(flag.short)}`;
-		const type = this._formatters.formatTypeValue(flag.type);
-		const default_ = flag.default !== void 0 && tint.dim(`[default: ${tint.bold(this._formatters.formatFlagDefault(flag.default))}]`);
-		return [
-			tint.bold(flagName),
-			tint.dim(type),
-			flag.description,
-			default_
-		].filter(isTruthy);
-	}
-	renderGroupedFlags(flags, groupMap, itemType) {
-		const groupedFlags = /* @__PURE__ */ new Map();
-		const defaultFlags = [];
-		for (const [name, flag] of Object.entries(flags)) {
-			const group = flag.help?.group;
-			validateGroup(group, groupMap, itemType, name);
-			const item = this.renderFlagItem(name, flag);
-			if (group && group !== DEFAULT_GROUP_KEY) {
-				const groupItems = groupedFlags.get(group) ?? [];
-				groupItems.push(item);
-				groupedFlags.set(group, groupItems);
-			} else defaultFlags.push(item);
-		}
-		const body = [];
-		if (defaultFlags.length > 0) body.push(...splitTable(defaultFlags));
-		for (const [key, name] of groupMap) {
-			const items = groupedFlags.get(key);
-			if (items && items.length > 0) {
-				if (body.length > 0) body.push("");
-				body.push(`${tint.dim(name)}`);
-				body.push(...splitTable(items).map(withIndent));
-			}
-		}
-		return body;
-	}
-	renderCommandFlags() {
-		const command = this._command;
-		if (!command?.flags || objectIsEmpty(command.flags)) return;
-		return {
-			title: "Flags",
-			body: this.renderGroupedFlags(command.flags, this._flagGroups, "flag")
-		};
-	}
-	renderGlobalFlags() {
-		if (!this._globalFlags || objectIsEmpty(this._globalFlags)) return;
-		return {
-			title: "Global Flags",
-			body: this.renderGroupedFlags(this._globalFlags, this._globalFlagGroups, "global flag")
-		};
-	}
-	renderNotes() {
-		if (!this._notes?.length) return;
-		return {
-			title: "Notes",
-			body: this._notes
-		};
-	}
-	renderExamples() {
-		if (!this._examples?.length) return;
-		return {
-			title: "Examples",
-			body: splitTable(this._examples.map(([command, description]) => {
-				return [
-					command,
-					DELIMITER,
-					description
-				];
-			}))
-		};
-	}
-};
-
-//#endregion
-//#region src/store.ts
-function addStoreApi(cli, { groups }) {
-	cli.store.help = { addGroup: (options) => {
-		if (options.commands) groups.commands = [...groups.commands ?? [], ...options.commands];
-		if (options.flags) groups.flags = [...groups.flags ?? [], ...options.flags];
-		if (options.globalFlags) groups.globalFlags = [...groups.globalFlags ?? [], ...options.globalFlags];
-	} };
-}
-
-//#endregion
-//#region src/index.ts
-const helpPlugin = ({ command = true, flag = true, showHelpWhenNoCommandSpecified = true, notes, examples, header, footer, formatters, groups = {} } = {}) => definePlugin({ setup: (cli) => {
-	addStoreApi(cli, { groups });
-	const mergedFormatters = {
-		...defaultFormatters,
-		...formatters
-	};
-	function printHelp(s) {
-		if (header) console.log(header);
-		console.log(s);
-		if (footer) console.log(footer);
-	}
-	const renderer = new HelpRenderer(mergedFormatters, cli, cli._globalFlags, () => groups, examples, notes);
-	function tryPrintSubcommandsHelp(commandName) {
-		const subcommandsOutput = renderer.renderAvailableSubcommands(commandName);
-		if (subcommandsOutput) {
-			printHelp(subcommandsOutput);
-			return true;
-		}
-		return false;
-	}
-	if (command) cli.command("help", "Show help", {
-		parameters: ["[command...]"],
-		help: {
-			notes: [
-				"If no command is specified, show help for the CLI.",
-				"If a command is specified, show help for the command.",
-				flag && "-h is an alias for --help."
-			].filter(isTruthy),
-			examples: [
-				command && [`$ ${cli._scriptName} help`, "Show help"],
-				command && [`$ ${cli._scriptName} help <command>`, "Show help for a specific command"],
-				flag && [`$ ${cli._scriptName} <command> --help`, "Show help for a specific command"]
-			].filter(isTruthy)
-		}
-	}).on("help", (ctx) => {
-		const commandName = ctx.parameters.command;
-		let command$1;
-		if (commandName.length > 0) {
-			[command$1] = resolveCommand(cli._commands, commandName);
-			if (!command$1) {
-				const parentCommandName = commandName.join(" ");
-				if (tryPrintSubcommandsHelp(parentCommandName)) return;
-				throw new NoSuchCommandError(parentCommandName);
-			}
-		}
-		renderer.setCommand(command$1);
-		printHelp(renderer.render());
-	});
-	if (flag) cli.globalFlag("help", "Show help", {
-		short: "h",
-		type: Boolean,
-		default: false
-	});
-	cli.interceptor({
-		enforce: "post",
-		handler: async (ctx, next) => {
-			if (ctx.flags.help) {
-				const command$1 = ctx.command;
-				if (!command$1 && ctx.rawParsed.parameters.length > 0) {
-					if (tryPrintSubcommandsHelp(ctx.rawParsed.parameters.join(" "))) return;
-					await next();
-				}
-				renderer.setCommand(command$1);
-				printHelp(renderer.render());
-			} else if (showHelpWhenNoCommandSpecified && !ctx.command && ctx.rawParsed.parameters.length === 0) {
-				console.log("No command specified. Showing help:\n");
-				printHelp(renderer.render());
-			} else await next();
-		}
-	});
-} });
-
-//#endregion
-export { defaultFormatters, helpPlugin };