@shell-shock/core 0.17.18 → 0.17.19

package/dist/components/command-validation-logic.cjs

@@ -3,8 +3,8 @@ let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_core = require("@alloy-js/core");
 let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
 let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
-let _alloy_js_typescript = require("@alloy-js/typescript");
 let _stryke_string_format_list = require("@stryke/string-format/list");
+let _alloy_js_typescript = require("@alloy-js/typescript");
 
 //#region src/components/command-validation-logic.tsx
 function __assignType(fn, args) {

package/dist/components/command-validation-logic.mjs

@@ -2,8 +2,8 @@ import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code } from "@alloy-js/core";
 import { camelCase } from "@stryke/string-format/camel-case";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
-import { ElseIfClause, IfStatement, VarDeclaration } from "@alloy-js/typescript";
 import { list } from "@stryke/string-format/list";
+import { ElseIfClause, IfStatement, VarDeclaration } from "@alloy-js/typescript";
 
 //#region src/components/command-validation-logic.tsx
 function __assignType(fn, args) {

package/dist/components/docs.cjs

@@ -13,6 +13,7 @@ let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin
 let _powerlines_plugin_alloy_markdown_components_markdown_file = require("@powerlines/plugin-alloy/markdown/components/markdown-file");
 let _powerlines_plugin_alloy_markdown_components_markdown_table = require("@powerlines/plugin-alloy/markdown/components/markdown-table");
 let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_list = require("@stryke/string-format/list");
 let _stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
 
 //#region src/components/docs.tsx
@@ -30,14 +31,44 @@ function __assignType(fn, args) {
 	fn.__type = args;
 	return fn;
 }
-const __ΩCommandOptionsDocsProps = [
+const __ΩCommandParametersDocsProps = [
 	"CommandTree",
 	"command",
 	"The command to generate options documentation for.",
-	"CommandOptionsDocsProps",
+	"CommandParametersDocsProps",
 	"P\"w!4\"?#Mw$y"
 ];
 /**
+* Generates the arguments markdown documentation for a command.
+*/
+function CommandArgumentDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return _alloy_js_core.code`This command does not have any arguments.`;
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+		return require_reflect.sortOptions(Object.values(command.options)).reduce(__assignType((ret, option) => {
+			ret.push({
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: (0, _stryke_type_checks_is_undefined.isUndefined)(option.default) ? "" : JSON.stringify(option.default),
+				required: !option.required || option.default ? "" : "✔"
+			});
+			return ret;
+		}, [
+			"ret",
+			"option",
+			"",
+			"P\"2!\"2\"\"/#"
+		]), []);
+	} });
+}
+CommandArgumentDocs.__type = [
+	() => __ΩCommandParametersDocsProps,
+	"props",
+	"CommandArgumentDocs",
+	"Generates the arguments markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+/**
 * Generates the options markdown documentation for a command.
 */
 function CommandOptionsDocs(props) {
@@ -61,7 +92,7 @@ function CommandOptionsDocs(props) {
 	} });
 }
 CommandOptionsDocs.__type = [
-	() => __ΩCommandOptionsDocsProps,
+	() => __ΩCommandParametersDocsProps,
 	"props",
 	"CommandOptionsDocs",
 	"Generates the options markdown documentation for a command.",
@@ -88,15 +119,20 @@ const __ΩCommandDocsUsageExampleProps = [
 * Generates the markdown documentation for a command.
 */
 function CommandDocsUsageExample(props) {
-	const { packageManager = "npm", command, expand = true } = props;
+	const { packageManager = "npm", command, expand = false } = props;
 	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
 	return [
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			when: expand,
-			fallback: _alloy_js_core.code`\`\`\`bash `,
-			children: _alloy_js_core.code`<details>
-        <summary>Using ${packageManager}</summary>
-        \`\`\`bash `
+			fallback: _alloy_js_core.code`\`\`\`sh `,
+			get children() {
+				return [
+					_alloy_js_core.code`<details>
+        <summary>Using ${packageManager}:</summary>`,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`\`\`\`sh `
+				];
+			}
 		}),
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_usage.Usage, {
@@ -110,10 +146,14 @@ function CommandDocsUsageExample(props) {
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			when: expand,
 			fallback: _alloy_js_core.code`\`\`\` `,
-			children: _alloy_js_core.code`\`\`\`
-        </details> `
-		}),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+			get children() {
+				return [
+					_alloy_js_core.code`\`\`\``,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`</details>`
+				];
+			}
+		})
 	];
 }
 CommandDocsUsageExample.__type = [
@@ -148,18 +188,40 @@ function CommandDocs(props) {
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
 			level: 1 + levelOffset,
 			get children() {
-				return command.title;
+				return `${command.title}${command.tags.includes("deprecated") ? " (Deprecated)" : command.tags.includes("beta") ? " (Beta)" : command.tags.includes("alpha") ? " (Alpha)" : command.tags.includes("experimental") ? " (Experimental)" : ""}`;
 			}
 		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`${command.description}`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return command.alias && command.alias.length > 0;
+			},
+			get children() {
+				return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return command.alias.length > 1;
+					},
+					get fallback() {
+						return _alloy_js_core.code`The \`${command.name}\` command can also be invoked using the alias \`${command.alias[0]}\`.`;
+					},
+					get children() {
+						return _alloy_js_core.code`The \`${command.name}\` command can also be invoked using the following aliases: ${(0, _stryke_string_format_list.list)(command.alias.map(__assignType((alias) => `\`${alias}\``, [
+							"alias",
+							"",
+							"P\"2!\"/\""
+						])), { conjunction: "or" })}.`;
+					}
+				})];
+			}
+		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
 			level: 2 + levelOffset,
 			children: "Usage"
 		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The ${command.name} command can be executed using the following syntax: `),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The \`${command.name}\` command can be executed using the following syntax: `),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			get when() {
@@ -174,11 +236,14 @@ function CommandDocs(props) {
 			get children() {
 				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 					each: usageExamples,
-					hardline: true,
+					doubleHardline: true,
 					get children() {
 						return __assignType((packageManager) => (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
 							packageManager,
-							command
+							command,
+							get expand() {
+								return usageExamples && usageExamples.length > 1;
+							}
 						}), [
 							"packageManager",
 							"",
@@ -189,12 +254,31 @@ function CommandDocs(props) {
 			}
 		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return command.args.length > 0;
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+						level: 2 + levelOffset,
+						children: "Positional Arguments"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following positional arguments are available for the \`${command.name}\` command:`),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(CommandArgumentDocs, { command }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+				];
+			}
+		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
 			level: 2 + levelOffset,
 			children: "Options"
 		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following options are available for the ${command.name} command:`),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following options are available for the \`${command.name}\` command:`),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(CommandOptionsDocs, { command }),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
@@ -270,6 +354,7 @@ CommandDocsFile.__type = [
 ];
 
 //#endregion
+exports.CommandArgumentDocs = CommandArgumentDocs;
 exports.CommandDocs = CommandDocs;
 exports.CommandDocsFile = CommandDocsFile;
 exports.CommandDocsUsageExample = CommandDocsUsageExample;
@@ -277,5 +362,5 @@ exports.CommandOptionsDocs = CommandOptionsDocs;
 exports.__ΩCommandDocsFileProps = __ΩCommandDocsFileProps;
 exports.__ΩCommandDocsProps = __ΩCommandDocsProps;
 exports.__ΩCommandDocsUsageExampleProps = __ΩCommandDocsUsageExampleProps;
-exports.__ΩCommandOptionsDocsProps = __ΩCommandOptionsDocsProps;
+exports.__ΩCommandParametersDocsProps = __ΩCommandParametersDocsProps;
 //# sourceMappingURL=docs.cjs.map

package/dist/components/docs.d.cts

@@ -2,16 +2,20 @@ import { CommandTree } from "../types/command.cjs";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
-interface CommandOptionsDocsProps {
+interface CommandParametersDocsProps {
   /**
    * The command to generate options documentation for.
    */
   command: CommandTree;
 }
+/**
+ * Generates the arguments markdown documentation for a command.
+ */
+declare function CommandArgumentDocs(props: CommandParametersDocsProps): import("@alloy-js/core").Children;
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): import("@alloy-js/core").Children;
+declare function CommandOptionsDocs(props: CommandParametersDocsProps): import("@alloy-js/core").Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -29,7 +33,7 @@ interface CommandDocsUsageExampleProps {
   /**
    * Whether to add expand/collapse details tags around the usage example. This is useful for hiding long usage examples by default.
    *
-   * @defaultValue true
+   * @defaultValue false
    */
   expand?: boolean;
 }
@@ -82,5 +86,5 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
  */
 declare function CommandDocsFile(props: CommandDocsFileProps): import("@alloy-js/core").Children;
 //#endregion
-export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
+export { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandParametersDocsProps };
 //# sourceMappingURL=docs.d.cts.map

package/dist/components/docs.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;UAoCiB,uBAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;AAAA;AAAA;AAMtB;;AANsB,iBAMN,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA;AAAA,UAgChD,4BAAA;EAhCyB;;;;AAAuB;AAgCjE;;;EASE,cAAA;EAAA;;;EAKA,OAAA,EAAS,WAAW;EAOd;AAAA;AAMR;;;EANE,MAAA;AAAA;;;;iBAMc,uBAAA,CAAwB,KAAA,EAAO,4BAA4B,4BAAA,QAAA;AAAA,UA4B1D,gBAAA;EAAgB;;;;;;;;EAS/B,WAAA;EAKS;;;EAAT,OAAA,EAAS,WAAA;EAO4C;AAAA;AAMvD;;;EANE,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;;;;iBAMX,WAAA,CAAY,KAAA,EAAO,gBAAgB,4BAAA,QAAA;AAAA,UAwClC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAAhB;;;;;;;;EASpC,WAAA;EAAA;;;EAKA,OAAA,EAAS,WAAA;AAAA;AAMX;;;AAAA,iBAAgB,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA"}
+{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;UAqCiB,0BAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;AAAA;AAAA;AAMtB;;AANsB,iBAMN,mBAAA,CAAoB,KAAA,EAAO,0BAA0B,4BAAA,QAAA;;;;iBAmCrD,kBAAA,CAAmB,KAAA,EAAO,0BAA0B,4BAAA,QAAA;AAAA,UAgCnD,4BAAA;EAnEoD;AAmCrE;;;;;;;EAyCE,cAAA;EAzCkE;AAgCpE;;EAcE,OAAA,EAAS,WAAW;EAAA;;;;;EAOpB,MAAA;AAAA;AAMF;;;AAAA,iBAAgB,uBAAA,CAAwB,KAAA,EAAO,4BAA4B,4BAAA,QAAA;AAAA,UA6B1D,gBAAA;EA7BuB;;;AAAmC;AA6B3E;;;;EASE,WAAA;EAYgB;;;EAPhB,OAAA,EAAS,WAAA;EAAT;;;;;EAOA,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;AAM3B;;;AAAA,iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAgB,4BAAA,QAAA;AAAA,UAyElC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAzE1B;;;AAAuB;AAyEnD;;;;EASE,WAAA;EAT4C;;;EAc5C,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA"}

package/dist/components/docs.d.mts

@@ -2,16 +2,20 @@ import { CommandTree } from "../types/command.mjs";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
-interface CommandOptionsDocsProps {
+interface CommandParametersDocsProps {
   /**
    * The command to generate options documentation for.
    */
   command: CommandTree;
 }
+/**
+ * Generates the arguments markdown documentation for a command.
+ */
+declare function CommandArgumentDocs(props: CommandParametersDocsProps): import("@alloy-js/core").Children;
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): import("@alloy-js/core").Children;
+declare function CommandOptionsDocs(props: CommandParametersDocsProps): import("@alloy-js/core").Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -29,7 +33,7 @@ interface CommandDocsUsageExampleProps {
   /**
    * Whether to add expand/collapse details tags around the usage example. This is useful for hiding long usage examples by default.
    *
-   * @defaultValue true
+   * @defaultValue false
    */
   expand?: boolean;
 }
@@ -82,5 +86,5 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
  */
 declare function CommandDocsFile(props: CommandDocsFileProps): import("@alloy-js/core").Children;
 //#endregion
-export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
+export { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandParametersDocsProps };
 //# sourceMappingURL=docs.d.mts.map

package/dist/components/docs.mjs

@@ -12,6 +12,7 @@ import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/markdown-table";
 import { joinPaths } from "@stryke/path/join";
+import { list } from "@stryke/string-format/list";
 import { isUndefined } from "@stryke/type-checks/is-undefined";
 
 //#region src/components/docs.tsx
@@ -29,14 +30,44 @@ function __assignType(fn, args) {
 	fn.__type = args;
 	return fn;
 }
-const __ΩCommandOptionsDocsProps = [
+const __ΩCommandParametersDocsProps = [
 	"CommandTree",
 	"command",
 	"The command to generate options documentation for.",
-	"CommandOptionsDocsProps",
+	"CommandParametersDocsProps",
 	"P\"w!4\"?#Mw$y"
 ];
 /**
+* Generates the arguments markdown documentation for a command.
+*/
+function CommandArgumentDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return code`This command does not have any arguments.`;
+	return createComponent(MarkdownTable, { get data() {
+		return sortOptions(Object.values(command.options)).reduce(__assignType((ret, option) => {
+			ret.push({
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: isUndefined(option.default) ? "" : JSON.stringify(option.default),
+				required: !option.required || option.default ? "" : "✔"
+			});
+			return ret;
+		}, [
+			"ret",
+			"option",
+			"",
+			"P\"2!\"2\"\"/#"
+		]), []);
+	} });
+}
+CommandArgumentDocs.__type = [
+	() => __ΩCommandParametersDocsProps,
+	"props",
+	"CommandArgumentDocs",
+	"Generates the arguments markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+/**
 * Generates the options markdown documentation for a command.
 */
 function CommandOptionsDocs(props) {
@@ -60,7 +91,7 @@ function CommandOptionsDocs(props) {
 	} });
 }
 CommandOptionsDocs.__type = [
-	() => __ΩCommandOptionsDocsProps,
+	() => __ΩCommandParametersDocsProps,
 	"props",
 	"CommandOptionsDocs",
 	"Generates the options markdown documentation for a command.",
@@ -87,15 +118,20 @@ const __ΩCommandDocsUsageExampleProps = [
 * Generates the markdown documentation for a command.
 */
 function CommandDocsUsageExample(props) {
-	const { packageManager = "npm", command, expand = true } = props;
+	const { packageManager = "npm", command, expand = false } = props;
 	const context = (usePowerlines.Ω = [["Context", "\"w!"]], usePowerlines());
 	return [
 		createComponent(Show, {
 			when: expand,
-			fallback: code`\`\`\`bash `,
-			children: code`<details>
-        <summary>Using ${packageManager}</summary>
-        \`\`\`bash `
+			fallback: code`\`\`\`sh `,
+			get children() {
+				return [
+					code`<details>
+        <summary>Using ${packageManager}:</summary>`,
+					createComponent(Spacing, {}),
+					code`\`\`\`sh `
+				];
+			}
 		}),
 		createIntrinsic("hbr", {}),
 		createComponent(Usage, {
@@ -109,10 +145,14 @@ function CommandDocsUsageExample(props) {
 		createComponent(Show, {
 			when: expand,
 			fallback: code`\`\`\` `,
-			children: code`\`\`\`
-        </details> `
-		}),
-		createIntrinsic("hbr", {})
+			get children() {
+				return [
+					code`\`\`\``,
+					createComponent(Spacing, {}),
+					code`</details>`
+				];
+			}
+		})
 	];
 }
 CommandDocsUsageExample.__type = [
@@ -147,18 +187,40 @@ function CommandDocs(props) {
 		createComponent(Heading, {
 			level: 1 + levelOffset,
 			get children() {
-				return command.title;
+				return `${command.title}${command.tags.includes("deprecated") ? " (Deprecated)" : command.tags.includes("beta") ? " (Beta)" : command.tags.includes("alpha") ? " (Alpha)" : command.tags.includes("experimental") ? " (Experimental)" : ""}`;
 			}
 		}),
 		createComponent(Spacing, {}),
 		memo(() => code`${command.description}`),
+		createComponent(Show, {
+			get when() {
+				return command.alias && command.alias.length > 0;
+			},
+			get children() {
+				return [createComponent(Spacing, {}), createComponent(Show, {
+					get when() {
+						return command.alias.length > 1;
+					},
+					get fallback() {
+						return code`The \`${command.name}\` command can also be invoked using the alias \`${command.alias[0]}\`.`;
+					},
+					get children() {
+						return code`The \`${command.name}\` command can also be invoked using the following aliases: ${list(command.alias.map(__assignType((alias) => `\`${alias}\``, [
+							"alias",
+							"",
+							"P\"2!\"/\""
+						])), { conjunction: "or" })}.`;
+					}
+				})];
+			}
+		}),
 		createComponent(Spacing, {}),
 		createComponent(Heading, {
 			level: 2 + levelOffset,
 			children: "Usage"
 		}),
 		createComponent(Spacing, {}),
-		memo(() => code`The ${command.name} command can be executed using the following syntax: `),
+		memo(() => code`The \`${command.name}\` command can be executed using the following syntax: `),
 		createComponent(Spacing, {}),
 		createComponent(Show, {
 			get when() {
@@ -173,11 +235,14 @@ function CommandDocs(props) {
 			get children() {
 				return createComponent(For, {
 					each: usageExamples,
-					hardline: true,
+					doubleHardline: true,
 					get children() {
 						return __assignType((packageManager) => createComponent(CommandDocsUsageExample, {
 							packageManager,
-							command
+							command,
+							get expand() {
+								return usageExamples && usageExamples.length > 1;
+							}
 						}), [
 							"packageManager",
 							"",
@@ -188,12 +253,31 @@ function CommandDocs(props) {
 			}
 		}),
 		createComponent(Spacing, {}),
+		createComponent(Show, {
+			get when() {
+				return command.args.length > 0;
+			},
+			get children() {
+				return [
+					createComponent(Spacing, {}),
+					createComponent(Heading, {
+						level: 2 + levelOffset,
+						children: "Positional Arguments"
+					}),
+					createComponent(Spacing, {}),
+					memo(() => code`The following positional arguments are available for the \`${command.name}\` command:`),
+					createComponent(Spacing, {}),
+					createComponent(CommandArgumentDocs, { command }),
+					createComponent(Spacing, {})
+				];
+			}
+		}),
 		createComponent(Heading, {
 			level: 2 + levelOffset,
 			children: "Options"
 		}),
 		createComponent(Spacing, {}),
-		memo(() => code`The following options are available for the ${command.name} command:`),
+		memo(() => code`The following options are available for the \`${command.name}\` command:`),
 		createComponent(Spacing, {}),
 		createComponent(CommandOptionsDocs, { command }),
 		createComponent(Spacing, {})
@@ -269,5 +353,5 @@ CommandDocsFile.__type = [
 ];
 
 //#endregion
-export { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandOptionsDocsProps };
+export { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandParametersDocsProps };
 //# sourceMappingURL=docs.mjs.map

package/dist/components/index.cjs

@@ -12,6 +12,7 @@ exports.ArgsUtilities = require_components_state_builtin.ArgsUtilities;
 exports.ArgumentsParserLogic = require_components_options_parser_logic.ArgumentsParserLogic;
 exports.BooleanInputParserLogic = require_components_helpers.BooleanInputParserLogic;
 exports.ColorSupportUtilities = require_components_utils_builtin.ColorSupportUtilities;
+exports.CommandArgumentDocs = require_components_docs.CommandArgumentDocs;
 exports.CommandDocs = require_components_docs.CommandDocs;
 exports.CommandDocsFile = require_components_docs.CommandDocsFile;
 exports.CommandDocsUsageExample = require_components_docs.CommandDocsUsageExample;
@@ -45,7 +46,7 @@ exports.__ΩBooleanInputParserLogicProps = require_components_helpers.__ΩBoolea
 exports.__ΩCommandDocsFileProps = require_components_docs.__ΩCommandDocsFileProps;
 exports.__ΩCommandDocsProps = require_components_docs.__ΩCommandDocsProps;
 exports.__ΩCommandDocsUsageExampleProps = require_components_docs.__ΩCommandDocsUsageExampleProps;
-exports.__ΩCommandOptionsDocsProps = require_components_docs.__ΩCommandOptionsDocsProps;
+exports.__ΩCommandParametersDocsProps = require_components_docs.__ΩCommandParametersDocsProps;
 exports.__ΩCommandParserLogicProps = require_components_options_parser_logic.__ΩCommandParserLogicProps;
 exports.__ΩCommandValidationLogicProps = require_components_command_validation_logic.__ΩCommandValidationLogicProps;
 exports.__ΩDynamicSegmentsParserLogicProps = require_components_options_parser_logic.__ΩDynamicSegmentsParserLogicProps;

package/dist/components/index.d.cts

@@ -1,9 +1,9 @@
 import { CommandValidationLogic, CommandValidationLogicProps } from "./command-validation-logic.cjs";
-import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps } from "./docs.cjs";
+import { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandParametersDocsProps } from "./docs.cjs";
 import { ExecBuiltin, ExecBuiltinProps } from "./exec-builtin.cjs";
 import { BooleanInputParserLogic, BooleanInputParserLogicProps, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.cjs";
 import { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps } from "./options-parser-logic.cjs";
 import { ArgsUtilities, ContextUtilities, GlobalTypeDefinitions, StateBuiltin, StateBuiltinProps } from "./state-builtin.cjs";
 import { Usage, UsageProps } from "./usage.cjs";
 import { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
-export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParameterType, CommandParserLogic, CommandParserLogicProps, CommandValidationLogic, CommandValidationLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, ExecBuiltin, ExecBuiltinProps, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, ResolveModuleFunctionDeclaration, StateBuiltin, StateBuiltinProps, TerminalSizeDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };
+export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandParameterType, CommandParametersDocsProps, CommandParserLogic, CommandParserLogicProps, CommandValidationLogic, CommandValidationLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, ExecBuiltin, ExecBuiltinProps, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, ResolveModuleFunctionDeclaration, StateBuiltin, StateBuiltinProps, TerminalSizeDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };

package/dist/components/index.d.mts

@@ -1,9 +1,9 @@
 import { CommandValidationLogic, CommandValidationLogicProps } from "./command-validation-logic.mjs";
-import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps } from "./docs.mjs";
+import { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandParametersDocsProps } from "./docs.mjs";
 import { ExecBuiltin, ExecBuiltinProps } from "./exec-builtin.mjs";
 import { BooleanInputParserLogic, BooleanInputParserLogicProps, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
 import { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps } from "./options-parser-logic.mjs";
 import { ArgsUtilities, ContextUtilities, GlobalTypeDefinitions, StateBuiltin, StateBuiltinProps } from "./state-builtin.mjs";
 import { Usage, UsageProps } from "./usage.mjs";
 import { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
-export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParameterType, CommandParserLogic, CommandParserLogicProps, CommandValidationLogic, CommandValidationLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, ExecBuiltin, ExecBuiltinProps, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, ResolveModuleFunctionDeclaration, StateBuiltin, StateBuiltinProps, TerminalSizeDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };
+export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandParameterType, CommandParametersDocsProps, CommandParserLogic, CommandParserLogicProps, CommandValidationLogic, CommandValidationLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, ExecBuiltin, ExecBuiltinProps, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, ResolveModuleFunctionDeclaration, StateBuiltin, StateBuiltinProps, TerminalSizeDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };

package/dist/components/index.mjs

@@ -1,5 +1,5 @@
 import { Usage, __ΩUsageProps } from "./usage.mjs";
-import { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandOptionsDocsProps } from "./docs.mjs";
+import { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandParametersDocsProps } from "./docs.mjs";
 import { ExecBuiltin, __ΩExecBuiltinProps } from "./exec-builtin.mjs";
 import { BooleanInputParserLogic, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, __ΩBooleanInputParserLogicProps } from "./helpers.mjs";
 import { ArgumentsParserLogic, CommandParserLogic, DynamicSegmentsParserLogic, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, __ΩArgumentsParserLogicProps, __ΩCommandParserLogicProps, __ΩDynamicSegmentsParserLogicProps, __ΩOptionsMemberParserConditionProps, __ΩOptionsMemberParserLogicProps, __ΩOptionsParserLogicProps } from "./options-parser-logic.mjs";
@@ -7,4 +7,4 @@ import { ArgsUtilities, ContextUtilities, GlobalTypeDefinitions, StateBuiltin, _
 import { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, __ΩUtilsBuiltinProps } from "./utils-builtin.mjs";
 import { CommandValidationLogic, __ΩCommandValidationLogicProps } from "./command-validation-logic.mjs";
 
-export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParameterType, CommandParserLogic, CommandValidationLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, ExecBuiltin, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, ResolveModuleFunctionDeclaration, StateBuiltin, TerminalSizeDeclaration, Usage, UtilsBuiltin, __ΩArgumentsParserLogicProps, __ΩBooleanInputParserLogicProps, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandOptionsDocsProps, __ΩCommandParserLogicProps, __ΩCommandValidationLogicProps, __ΩDynamicSegmentsParserLogicProps, __ΩExecBuiltinProps, __ΩOptionsMemberParserConditionProps, __ΩOptionsMemberParserLogicProps, __ΩOptionsParserLogicProps, __ΩStateBuiltinProps, __ΩUsageProps, __ΩUtilsBuiltinProps };
+export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParameterType, CommandParserLogic, CommandValidationLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, ExecBuiltin, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, ResolveModuleFunctionDeclaration, StateBuiltin, TerminalSizeDeclaration, Usage, UtilsBuiltin, __ΩArgumentsParserLogicProps, __ΩBooleanInputParserLogicProps, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandParametersDocsProps, __ΩCommandParserLogicProps, __ΩCommandValidationLogicProps, __ΩDynamicSegmentsParserLogicProps, __ΩExecBuiltinProps, __ΩOptionsMemberParserConditionProps, __ΩOptionsMemberParserLogicProps, __ΩOptionsParserLogicProps, __ΩStateBuiltinProps, __ΩUsageProps, __ΩUtilsBuiltinProps };

package/dist/components/usage.cjs

@@ -54,20 +54,17 @@ function Usage(props) {
 			"segment",
 			"",
 			"P\"2!\"/\""
-		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""}${command.args.length > 0 ? command.args.map(__assignType((param) => `<${(0, _stryke_string_format_snake_case.snakeCase)(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
+		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""}${command.args.length > 0 ? ` ${command.args.map(__assignType((param) => `<${(0, _stryke_string_format_snake_case.snakeCase)(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
 			"param",
 			"",
 			"P\"2!\"/\""
-		])).join(" ") : ""} [options]`),
+		])).join(" ")}` : ""} [options]`),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			get when() {
 				return command.args.length > 0;
 			},
 			get children() {
 				return [
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					_alloy_js_core.code`# or with options before arguments: `,
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Switch, { get children() {
 						return [

package/dist/components/usage.mjs

@@ -53,20 +53,17 @@ function Usage(props) {
 			"segment",
 			"",
 			"P\"2!\"/\""
-		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""}${command.args.length > 0 ? command.args.map(__assignType((param) => `<${snakeCase(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
+		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""}${command.args.length > 0 ? ` ${command.args.map(__assignType((param) => `<${snakeCase(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
 			"param",
 			"",
 			"P\"2!\"/\""
-		])).join(" ") : ""} [options]`),
+		])).join(" ")}` : ""} [options]`),
 		createComponent(Show, {
 			get when() {
 				return command.args.length > 0;
 			},
 			get children() {
 				return [
-					createIntrinsic("hbr", {}),
-					createIntrinsic("hbr", {}),
-					code`# or with options before arguments: `,
 					createIntrinsic("hbr", {}),
 					createComponent(Switch, { get children() {
 						return [

package/dist/helpers/automd.cjs

@@ -23,19 +23,35 @@ function __assignType(fn, args) {
 */
 const commands = __assignType((context) => (0, automd.defineGenerator)({
 	name: "commands",
-	async generate() {
+	async generate(ctx) {
+		let commands = Object.values(context.commands).filter(__assignType((cmd) => !cmd.virtual, [
+			"cmd",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (ctx.args.command) {
+			if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+			commands = [context.commands[ctx.args.command]];
+		}
 		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, [
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
-				level: 2,
-				children: "Commands"
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return !ctx.args.command;
+				},
+				get children() {
+					return [
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+							level: 2,
+							children: "Commands"
+						}),
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+						(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following commands are available in the ${require_context_helpers.getAppTitle(context, true)} command-line interface application:`),
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+					];
+				}
 			}),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-			(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following commands are available in the ${require_context_helpers.getAppTitle(context, true)} command-line interface application:`),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-				get each() {
-					return Object.values(context.commands);
-				},
+				each: commands,
 				doubleHardline: true,
 				get children() {
 					return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -64,7 +80,114 @@ const commands = __assignType((context) => (0, automd.defineGenerator)({
 	"",
 	"P\"w!2\"\"/#"
 ]);
+/**
+* AutoMD generator to generate usage examples for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated usage content.
+*/
+const usage = __assignType((context) => (0, automd.defineGenerator)({
+	name: "usage",
+	async generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'usage' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		let packageManagers = [
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		];
+		if (ctx.args.packageManager) packageManagers = [String(ctx.args.packageManager)];
+		if (packageManagers.some(__assignType((pm) => ![
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		].includes(pm), [
+			"pm",
+			"",
+			"P\"2!\"/\""
+		]))) throw new Error(`Invalid package manager specified. Supported package managers are: npm, yarn, pnpm, and bun.`);
+		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+			each: packageManagers,
+			doubleHardline: true,
+			get children() {
+				return __assignType((packageManager) => [(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsUsageExample, {
+					packageManager,
+					get command() {
+						return context.commands[ctx.args.command];
+					},
+					get expand() {
+						return packageManagers && packageManagers.length > 1;
+					}
+				})], [
+					"packageManager",
+					"",
+					"P\"2!\"/\""
+				]);
+			}
+		})]) };
+	}
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate options for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated options content.
+*/
+const options = __assignType((context) => (0, automd.defineGenerator)({
+	name: "options",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'options' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandOptionsDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate arguments for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated arguments content.
+*/
+const args = __assignType((context) => (0, automd.defineGenerator)({
+	name: "args",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'args' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandArgumentDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
 
 //#endregion
+exports.args = args;
 exports.commands = commands;
+exports.options = options;
+exports.usage = usage;
 //# sourceMappingURL=automd.cjs.map

package/dist/helpers/automd.mjs

@@ -1,5 +1,5 @@
 import { getAppTitle } from "../plugin-utils/context-helpers.mjs";
-import { CommandDocs } from "../components/docs.mjs";
+import { CommandArgumentDocs, CommandDocs, CommandDocsUsageExample, CommandOptionsDocs } from "../components/docs.mjs";
 import "../plugin-utils/index.mjs";
 import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code } from "@alloy-js/core";
@@ -23,19 +23,35 @@ function __assignType(fn, args) {
 */
 const commands = __assignType((context) => defineGenerator({
 	name: "commands",
-	async generate() {
+	async generate(ctx) {
+		let commands = Object.values(context.commands).filter(__assignType((cmd) => !cmd.virtual, [
+			"cmd",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (ctx.args.command) {
+			if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+			commands = [context.commands[ctx.args.command]];
+		}
 		return { contents: renderString(context, [
-			createComponent(Heading, {
-				level: 2,
-				children: "Commands"
+			createComponent(Show, {
+				get when() {
+					return !ctx.args.command;
+				},
+				get children() {
+					return [
+						createComponent(Heading, {
+							level: 2,
+							children: "Commands"
+						}),
+						createComponent(Spacing, {}),
+						memo(() => code`The following commands are available in the ${getAppTitle(context, true)} command-line interface application:`),
+						createComponent(Spacing, {})
+					];
+				}
 			}),
-			createComponent(Spacing, {}),
-			memo(() => code`The following commands are available in the ${getAppTitle(context, true)} command-line interface application:`),
-			createComponent(Spacing, {}),
 			createComponent(For, {
-				get each() {
-					return Object.values(context.commands);
-				},
+				each: commands,
 				doubleHardline: true,
 				get children() {
 					return __assignType((child) => createComponent(Show, {
@@ -64,7 +80,111 @@ const commands = __assignType((context) => defineGenerator({
 	"",
 	"P\"w!2\"\"/#"
 ]);
+/**
+* AutoMD generator to generate usage examples for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated usage content.
+*/
+const usage = __assignType((context) => defineGenerator({
+	name: "usage",
+	async generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'usage' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		let packageManagers = [
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		];
+		if (ctx.args.packageManager) packageManagers = [String(ctx.args.packageManager)];
+		if (packageManagers.some(__assignType((pm) => ![
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		].includes(pm), [
+			"pm",
+			"",
+			"P\"2!\"/\""
+		]))) throw new Error(`Invalid package manager specified. Supported package managers are: npm, yarn, pnpm, and bun.`);
+		return { contents: renderString(context, [createComponent(For, {
+			each: packageManagers,
+			doubleHardline: true,
+			get children() {
+				return __assignType((packageManager) => [createComponent(CommandDocsUsageExample, {
+					packageManager,
+					get command() {
+						return context.commands[ctx.args.command];
+					},
+					get expand() {
+						return packageManagers && packageManagers.length > 1;
+					}
+				})], [
+					"packageManager",
+					"",
+					"P\"2!\"/\""
+				]);
+			}
+		})]) };
+	}
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate options for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated options content.
+*/
+const options = __assignType((context) => defineGenerator({
+	name: "options",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'options' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: renderString(context, createComponent(CommandOptionsDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate arguments for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated arguments content.
+*/
+const args = __assignType((context) => defineGenerator({
+	name: "args",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'args' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: renderString(context, createComponent(CommandArgumentDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
 
 //#endregion
-export { commands };
+export { args, commands, options, usage };
 //# sourceMappingURL=automd.mjs.map

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "0.17.17";
+var version = "0.17.18";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.17.17";
+var version = "0.17.18";
 
 //#endregion
 export { version };

package/dist/plugin.cjs

@@ -53,7 +53,7 @@ const MAX_DEPTH = 50;
 /**
 * The core Powerlines plugin to build Shell Shock projects.
 */
-const plugin = __assignType((options = {}) => {
+const plugin = __assignType((options$1 = {}) => {
 	return [
 		(_powerlines_plugin_tsdown.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_tsdown.default)()),
 		(_powerlines_plugin_automd.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_automd.default)()),
@@ -61,7 +61,7 @@ const plugin = __assignType((options = {}) => {
 			name: "shell-shock/core:config",
 			config: __assignType(async function config() {
 				this.debug("Resolving the Shell Shock configuration.");
-				return (0, defu.defu)(options, {
+				return (0, defu.defu)(options$1, {
 					name: require_context_helpers.getAppName(this),
 					title: require_context_helpers.getAppTitle(this),
 					description: require_context_helpers.getAppDescription(this),
@@ -125,7 +125,7 @@ const plugin = __assignType((options = {}) => {
 				}
 			}
 		},
-		...(_powerlines_plugin_nodejs.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_nodejs.default)((0, defu.defu)(options ?? {}, { env: {
+		...(_powerlines_plugin_nodejs.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_nodejs.default)((0, defu.defu)(options$1 ?? {}, { env: {
 			config: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} }))),
@@ -446,11 +446,14 @@ const plugin = __assignType((options = {}) => {
 				this.config.automd ??= {};
 				this.config.automd.generators = {
 					...this.config.automd.generators ?? {},
-					commands: require_automd.commands(this)
+					commands: require_automd.commands(this),
+					usage: require_automd.usage(this),
+					options: require_automd.options(this),
+					args: require_automd.args(this)
 				};
 			}, ["configResolved", "P\"/!"]),
 			async docs() {
-				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				this.debug("Rendering CLI command reference documentation and writing to the output directory.");
 				const commands = this.inputs.map(__assignType((input) => require_get_command_tree.getCommandTree(this, input.segments), [
 					"input",
 					"",

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAwFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AA6FA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/plugin.mjs

@@ -5,7 +5,7 @@ import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
 import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
 import { StateBuiltin } from "./components/state-builtin.mjs";
 import { UtilsBuiltin } from "./components/utils-builtin.mjs";
-import { commands } from "./helpers/automd.mjs";
+import { args, commands, options, usage } from "./helpers/automd.mjs";
 import { getFramework } from "./helpers/get-framework.mjs";
 import { findCommandsRoot, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/paths.mjs";
 import { writeCommandsPersistence } from "./helpers/persistence.mjs";
@@ -48,7 +48,7 @@ const MAX_DEPTH = 50;
 /**
 * The core Powerlines plugin to build Shell Shock projects.
 */
-const plugin = __assignType((options = {}) => {
+const plugin = __assignType((options$1 = {}) => {
 	return [
 		(tsdown.Ω = [["Context", "\"w!"]], tsdown()),
 		(automd.Ω = [["Context", "\"w!"]], automd()),
@@ -56,7 +56,7 @@ const plugin = __assignType((options = {}) => {
 			name: "shell-shock/core:config",
 			config: __assignType(async function config() {
 				this.debug("Resolving the Shell Shock configuration.");
-				return defu(options, {
+				return defu(options$1, {
 					name: getAppName(this),
 					title: getAppTitle(this),
 					description: getAppDescription(this),
@@ -120,7 +120,7 @@ const plugin = __assignType((options = {}) => {
 				}
 			}
 		},
-		...(nodejs.Ω = [["Context", "\"w!"]], nodejs(defu(options ?? {}, { env: {
+		...(nodejs.Ω = [["Context", "\"w!"]], nodejs(defu(options$1 ?? {}, { env: {
 			config: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} }))),
@@ -441,11 +441,14 @@ const plugin = __assignType((options = {}) => {
 				this.config.automd ??= {};
 				this.config.automd.generators = {
 					...this.config.automd.generators ?? {},
-					commands: commands(this)
+					commands: commands(this),
+					usage: usage(this),
+					options: options(this),
+					args: args(this)
 				};
 			}, ["configResolved", "P\"/!"]),
 			async docs() {
-				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				this.debug("Rendering CLI command reference documentation and writing to the output directory.");
 				const commands = this.inputs.map(__assignType((input) => getCommandTree(this, input.segments), [
 					"input",
 					"",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.17.18",
+  "version": "0.17.19",
   "private": false,
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "keywords": ["shell-shock", "powerlines", "storm-software"],
@@ -407,5 +407,5 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "4ca0ac0ff9ada03aea6667c89a04b54dc73ff40b"
+  "gitHead": "f65ed318b22c10407fc4f3770b3f1f742d02ab35"
 }