@shell-shock/plugin-help 0.2.34 → 0.2.36

package/dist/components/display.cjs

@@ -19,25 +19,8 @@ function HelpUsageDisplay(props) {
 	const theme = (0, _shell_shock_plugin_theme_contexts_theme.useTheme)();
 	return [
 		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(
-        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
       );`),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return command.alias.length > 0;
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-					get each() {
-						return command.alias;
-					},
-					hardline: true,
-					children: (alias) => _alloy_js_core.code`writeLine(
-        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 1 ? ` ${command.segments.slice(0, -1).map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""} \${textColors.usage.command("${alias}")}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
-      );`
-				});
-			}
-		}),
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			get when() {
@@ -48,12 +31,43 @@ function HelpUsageDisplay(props) {
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
       writeLine(
-        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
       );`),
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 				];
 			}
-		})
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return command.alias.length > 0;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+					get each() {
+						return command.alias;
+					},
+					hardline: true,
+					children: (alias) => [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 1 ? ` ${command.segments.slice(0, -1).map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""} \${textColors.usage.command("${alias}")}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
+      );`), (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.memo)(() => _alloy_js_core.code`
+      writeLine(
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${(0, _shell_shock_core_plugin_utils.getAppBin)(context)}")}${command.segments.length > 1 ? ` ${command.segments.slice(0, -1).map((segment) => `\${textColors.usage.${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_snake_case.snakeCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""} \${textColors.usage.command("${alias}")}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => (0, _stryke_string_format_snake_case.snakeCase)(String(choice))).join("|") : arg.type === "string" && arg.format ? (0, _stryke_string_format_snake_case.snakeCase)(arg.format) : (0, _stryke_string_format_snake_case.snakeCase)(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
+      );`),
+								(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+							];
+						}
+					})]
+				});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 	];
 }
 /**
@@ -67,7 +81,7 @@ function HelpOptionsDisplay(props) {
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 			get each() {
-				return (0, _shell_shock_core_plugin_utils.sortOptions)(options);
+				return (0, _shell_shock_core_plugin_utils.sortOptions)(options, false);
 			},
 			hardline: true,
 			children: (option) => {
@@ -114,7 +128,7 @@ function BaseHelpDisplay(props) {
 	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
 	const options = (0, _alloy_js_core.computed)(() => filterGlobalOptions ? Object.values(command.options) : [...Object.values(command.options), ...context.globalOptions.filter((globalOption) => !Object.values(command.options).some((option) => option.name.toLowerCase() === globalOption.name.toLowerCase()) && !globalOption.alias.some((alias) => Object.values(command.options).some((option) => option.alias.some((a) => a.toLowerCase() === alias.toLowerCase()))))]);
 	return [
-		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(bold(textColors.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(bold(textColors.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${(theme.padding.app ?? 1) * indent} }` : ""});`),
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(HelpUsageDisplay, {
 			command,
@@ -128,7 +142,7 @@ function BaseHelpDisplay(props) {
 			get children() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine("");
-      writeLine(bold(textColors.heading.secondary("Options:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(bold(textColors.heading.secondary("Options:"))${indent > 1 ? `, { padding: ${(theme.padding.app ?? 1) * indent} }` : ""});`),
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(HelpOptionsDisplay, { get options() {
 						return options.value;
@@ -144,7 +158,7 @@ function BaseHelpDisplay(props) {
 			get children() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine("");
-      writeLine(bold(textColors.heading.secondary("Commands:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(bold(textColors.heading.secondary("Commands:"))${indent > 1 ? `, { padding: ${(theme.padding.app ?? 1) * indent} }` : ""});`),
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(HelpCommandsDisplay, { get commands() {
 						return command.children;

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

@@ -1 +1 @@
-{"version":3,"file":"display.d.cts","names":[],"sources":["../../src/components/display.tsx"],"mappings":";;;UAqCiB,qBAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;EAAA;;;;;AAUd;AAMR;;EANE,MAAA;AAAA;;;;iBAMc,gBAAA,CAAiB,KAAA,EAAO,qBAAqB,4BAAA,QAAA;AAAA,UA0K5C,uBAAA;EAAA;;;EAIf,OAAA,EAAS,aAAa;AAAA;AAMxB;;;AAAA,iBAAgB,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA;AAAA,UAoFhD,wBAAA;EApFkB;;;EAwFjC,QAAA,EAAU,MAAM,SAAS,WAAA;AAAA;;;;iBAMX,mBAAA,CAAoB,KAAA,EAAO,wBAAwB,4BAAA,QAAA;AAAA,UA+BlD,oBAAA;EArCU;;AAAW;EAyCpC,OAAA,EAAS,WAAW;EAnCa;;;;;;;AAAgC;EA6CjE,mBAAA;EAdmC;;;;;;;;EAwBnC,MAAA;AAAA;;;;iBAMc,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA;AAAA,UA0D1C,8BAAA;EA1D0C;;AAAA;EA8DzD,OAAA,EAAS,aAAA;EAJoC;;;EAS7C,QAAA,EAAU,MAAA,SAAe,WAAA;EAAf;;;;;;EAQV,QAAA;AAAA;;;AAAQ;iBA4CM,yBAAA,CACd,KAAA,EAAO,8BAA8B,4BAAA,QAAA;AAAA,UA8DtB,uBAAA;;;;EAIf,OAAA,EAAS,WAAW;AAAA;;AAlEiB;AA8DvC;iBAUgB,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA"}
+{"version":3,"file":"display.d.cts","names":[],"sources":["../../src/components/display.tsx"],"mappings":";;;UAqCiB,qBAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;EAAA;;;;;AAUd;AAMR;;EANE,MAAA;AAAA;;;;iBAMc,gBAAA,CAAiB,KAAA,EAAO,qBAAqB,4BAAA,QAAA;AAAA,UAkO5C,uBAAA;EAAA;;;EAIf,OAAA,EAAS,aAAa;AAAA;AAMxB;;;AAAA,iBAAgB,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA;AAAA,UAoFhD,wBAAA;EApFkB;;;EAwFjC,QAAA,EAAU,MAAM,SAAS,WAAA;AAAA;;;;iBAMX,mBAAA,CAAoB,KAAA,EAAO,wBAAwB,4BAAA,QAAA;AAAA,UA+BlD,oBAAA;EArCU;;AAAW;EAyCpC,OAAA,EAAS,WAAW;EAnCa;;;;;;;AAAgC;EA6CjE,mBAAA;EAdmC;;;;;;;;EAwBnC,MAAA;AAAA;;;;iBAMc,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA;AAAA,UA0D1C,8BAAA;EA1D0C;;AAAA;EA8DzD,OAAA,EAAS,aAAA;EAJoC;;;EAS7C,QAAA,EAAU,MAAA,SAAe,WAAA;EAAf;;;;;;EAQV,QAAA;AAAA;;;AAAQ;iBA4CM,yBAAA,CACd,KAAA,EAAO,8BAA8B,4BAAA,QAAA;AAAA,UA8DtB,uBAAA;;;;EAIf,OAAA,EAAS,WAAW;AAAA;;AAlEiB;AA8DvC;iBAUgB,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA"}

package/dist/components/display.mjs

@@ -18,25 +18,8 @@ function HelpUsageDisplay(props) {
 	const theme = useTheme();
 	return [
 		memo(() => code`writeLine(
-        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
       );`),
-		createIntrinsic("hbr", {}),
-		createComponent(Show, {
-			get when() {
-				return command.alias.length > 0;
-			},
-			get children() {
-				return createComponent(For, {
-					get each() {
-						return command.alias;
-					},
-					hardline: true,
-					children: (alias) => code`writeLine(
-        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 1 ? ` ${command.segments.slice(0, -1).map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""} \${textColors.usage.command("${alias}")}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
-      );`
-				});
-			}
-		}),
 		createIntrinsic("hbr", {}),
 		createComponent(Show, {
 			get when() {
@@ -47,12 +30,43 @@ function HelpUsageDisplay(props) {
 					createIntrinsic("hbr", {}),
 					memo(() => code`
       writeLine(
-        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
       );`),
 					createIntrinsic("hbr", {})
 				];
 			}
-		})
+		}),
+		createComponent(Show, {
+			get when() {
+				return command.alias.length > 0;
+			},
+			get children() {
+				return createComponent(For, {
+					get each() {
+						return command.alias;
+					},
+					hardline: true,
+					children: (alias) => [memo(() => code`writeLine(
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 1 ? ` ${command.segments.slice(0, -1).map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""} \${textColors.usage.command("${alias}")}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
+      );`), createComponent(Show, {
+						get when() {
+							return command.args.length > 0;
+						},
+						get children() {
+							return [
+								createIntrinsic("hbr", {}),
+								memo(() => code`
+      writeLine(
+        textColors.body.secondary(\`\${textColors.usage.bin(">_ ${getAppBin(context)}")}${command.segments.length > 1 ? ` ${command.segments.slice(0, -1).map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""} \${textColors.usage.command("${alias}")}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("<command>")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${(arg.type === "string" || arg.type === "number") && arg.choices && arg.choices.length > 0 ? arg.choices.map((choice) => snakeCase(String(choice))).join("|") : arg.type === "string" && arg.format ? snakeCase(arg.format) : snakeCase(arg.name)}${(arg.type === "string" || arg.type === "number") && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${(theme.padding.app ?? 1) * indent} }
+      );`),
+								createIntrinsic("hbr", {})
+							];
+						}
+					})]
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
 	];
 }
 /**
@@ -66,7 +80,7 @@ function HelpOptionsDisplay(props) {
 		createIntrinsic("hbr", {}),
 		createComponent(For, {
 			get each() {
-				return sortOptions(options);
+				return sortOptions(options, false);
 			},
 			hardline: true,
 			children: (option) => {
@@ -113,7 +127,7 @@ function BaseHelpDisplay(props) {
 	const context = usePowerlines();
 	const options = computed(() => filterGlobalOptions ? Object.values(command.options) : [...Object.values(command.options), ...context.globalOptions.filter((globalOption) => !Object.values(command.options).some((option) => option.name.toLowerCase() === globalOption.name.toLowerCase()) && !globalOption.alias.some((alias) => Object.values(command.options).some((option) => option.alias.some((a) => a.toLowerCase() === alias.toLowerCase()))))]);
 	return [
-		memo(() => code`writeLine(bold(textColors.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+		memo(() => code`writeLine(bold(textColors.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${(theme.padding.app ?? 1) * indent} }` : ""});`),
 		createIntrinsic("hbr", {}),
 		createComponent(HelpUsageDisplay, {
 			command,
@@ -127,7 +141,7 @@ function BaseHelpDisplay(props) {
 			get children() {
 				return [
 					memo(() => code`writeLine("");
-      writeLine(bold(textColors.heading.secondary("Options:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(bold(textColors.heading.secondary("Options:"))${indent > 1 ? `, { padding: ${(theme.padding.app ?? 1) * indent} }` : ""});`),
 					createIntrinsic("hbr", {}),
 					createComponent(HelpOptionsDisplay, { get options() {
 						return options.value;
@@ -143,7 +157,7 @@ function BaseHelpDisplay(props) {
 			get children() {
 				return [
 					memo(() => code`writeLine("");
-      writeLine(bold(textColors.heading.secondary("Commands:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(bold(textColors.heading.secondary("Commands:"))${indent > 1 ? `, { padding: ${(theme.padding.app ?? 1) * indent} }` : ""});`),
 					createIntrinsic("hbr", {}),
 					createComponent(HelpCommandsDisplay, { get commands() {
 						return command.children;

package/dist/components/help-builtin.cjs

@@ -74,7 +74,7 @@ function HelpBuiltin(props) {
 									return command.tags && command.tags.length > 0;
 								},
 								get children() {
-									return _alloy_js_core.code`writeLine(\`\${bold(textColors.heading.secondary("Tags: "))} ${command.tags.map((tag) => `\${textColors.tags.${(0, _stryke_string_format_camel_case.camelCase)(tag)} ? textColors.tags.${(0, _stryke_string_format_camel_case.camelCase)(tag)}(inverse(" ${tag} ")) : textColors.tags.$default(inverse(" ${tag} "))}`).join(" ")}\`, { padding: ${theme.padding.app * 2} }); `;
+									return _alloy_js_core.code`writeLine(\`\${bold(textColors.heading.secondary("Tags: "))} ${command.tags.map((tag) => `\${textColors.tags.${(0, _stryke_string_format_camel_case.camelCase)(tag)} ? textColors.tags.${(0, _stryke_string_format_camel_case.camelCase)(tag)}(inverse(" ${tag} ")) : textColors.tags.$default(inverse(" ${tag} "))}`).join(" ")}\`, { padding: ${(theme.padding.app ?? 1) * 2} }); `;
 								}
 							}),
 							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -100,7 +100,7 @@ function HelpBuiltin(props) {
 									return (0, _stryke_type_checks_is_set_string.isSetString)(command.docs);
 								},
 								get children() {
-									return [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(textColors.body.tertiary(\`More information can be found in the ${command.path ? `${command.title} command` : (0, _shell_shock_core_plugin_utils.getAppTitle)(context, false)} documentation at \${link("${command.docs}")}\${textColors.body.tertiary(".")}\`), { padding: ${theme.padding.app * 2} });
+									return [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(textColors.body.tertiary(\`More information can be found in the ${command.path ? `${command.title} command` : (0, _shell_shock_core_plugin_utils.getAppTitle)(context, false)} documentation at \${link("${command.docs}")}\${textColors.body.tertiary(".")}\`), { padding: ${(theme.padding.app ?? 1) * 2} });
           writeLine(""); `), (0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
 								}
 							}),

package/dist/components/help-builtin.mjs

@@ -71,7 +71,7 @@ function HelpBuiltin(props) {
 									return command.tags && command.tags.length > 0;
 								},
 								get children() {
-									return code`writeLine(\`\${bold(textColors.heading.secondary("Tags: "))} ${command.tags.map((tag) => `\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(" ${tag} ")) : textColors.tags.$default(inverse(" ${tag} "))}`).join(" ")}\`, { padding: ${theme.padding.app * 2} }); `;
+									return code`writeLine(\`\${bold(textColors.heading.secondary("Tags: "))} ${command.tags.map((tag) => `\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(" ${tag} ")) : textColors.tags.$default(inverse(" ${tag} "))}`).join(" ")}\`, { padding: ${(theme.padding.app ?? 1) * 2} }); `;
 								}
 							}),
 							createComponent(Show, {
@@ -97,7 +97,7 @@ function HelpBuiltin(props) {
 									return isSetString(command.docs);
 								},
 								get children() {
-									return [memo(() => code`writeLine(textColors.body.tertiary(\`More information can be found in the ${command.path ? `${command.title} command` : getAppTitle(context, false)} documentation at \${link("${command.docs}")}\${textColors.body.tertiary(".")}\`), { padding: ${theme.padding.app * 2} });
+									return [memo(() => code`writeLine(textColors.body.tertiary(\`More information can be found in the ${command.path ? `${command.title} command` : getAppTitle(context, false)} documentation at \${link("${command.docs}")}\${textColors.body.tertiary(".")}\`), { padding: ${(theme.padding.app ?? 1) * 2} });
           writeLine(""); `), createIntrinsic("hbr", {})];
 								}
 							}),

package/dist/components/help-command.cjs

@@ -27,8 +27,8 @@ function TemporaryHelpCommand() {
 					heading: "Display command usage details and other useful information to the user.",
 					get children() {
 						return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
-							name: "segments",
-							children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
+							name: "commands",
+							children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no commands are provided, general help information about the CLI application will be displayed.`
 						});
 					}
 				}),
@@ -38,7 +38,7 @@ function TemporaryHelpCommand() {
 					async: true,
 					name: "handler",
 					parameters: [{
-						name: "segments",
+						name: "commands",
 						type: "string[]",
 						default: "[]"
 					}]
@@ -52,10 +52,10 @@ function TemporaryHelpCommand() {
 */
 function HelpCommand(props) {
 	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const helpImports = (0, _alloy_js_core.computed)(() => props.commands ? props.commands.reduce((ret, segments) => {
-		ret[(0, _stryke_path.joinPaths)("help", ...segments)] = [{
+	const helpImports = (0, _alloy_js_core.computed)(() => props.commands ? props.commands.reduce((ret, commands) => {
+		ret[(0, _stryke_path.joinPaths)("help", ...commands)] = [{
 			name: "showHelp",
-			alias: `showHelp${segments.map((segment) => (0, _stryke_string_format_pascal_case.pascalCase)(segment.replace(/-/g, ""))).join("")}`
+			alias: `showHelp${commands.map((command) => (0, _stryke_string_format_pascal_case.pascalCase)(command.replace(/-/g, ""))).join("")}`
 		}];
 		return ret;
 	}, {}) : {});
@@ -91,8 +91,8 @@ function HelpCommand(props) {
 				heading: "Display command usage details and other useful information to the user.",
 				get children() {
 					return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
-						name: "segments",
-						children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
+						name: "commands",
+						children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no commands are provided, general help information about the CLI application will be displayed.`
 					});
 				}
 			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
@@ -101,7 +101,7 @@ function HelpCommand(props) {
 				async: true,
 				name: "handler",
 				parameters: [{
-					name: "segments",
+					name: "commands",
 					type: "string[]",
 					default: "[]"
 				}],
@@ -115,25 +115,25 @@ function HelpCommand(props) {
 							return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 								each: commandSegmentsList,
 								doubleHardline: true,
-								children: (segments, index) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+								children: (commands, index) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 									when: index > 0,
 									get fallback() {
 										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
 											get condition() {
-												return _alloy_js_core.code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
+												return _alloy_js_core.code`commands.join("/").toLowerCase() === "${commands.join("/").toLowerCase()}"`;
 											},
 											get children() {
-												return _alloy_js_core.code` showHelp${segments.map((segment) => (0, _stryke_string_format_pascal_case.pascalCase)(segment)).join("")}(); `;
+												return _alloy_js_core.code` showHelp${commands.map((command) => (0, _stryke_string_format_pascal_case.pascalCase)(command)).join("")}(); `;
 											}
 										});
 									},
 									get children() {
 										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
 											get condition() {
-												return _alloy_js_core.code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
+												return _alloy_js_core.code`commands.join("/").toLowerCase() === "${commands.join("/").toLowerCase()}"`;
 											},
 											get children() {
-												return _alloy_js_core.code` showHelp${segments.map((segment) => (0, _stryke_string_format_pascal_case.pascalCase)(segment)).join("")}(); `;
+												return _alloy_js_core.code` showHelp${commands.map((command) => (0, _stryke_string_format_pascal_case.pascalCase)(command)).join("")}(); `;
 											}
 										});
 									}

package/dist/components/help-command.mjs

@@ -26,8 +26,8 @@ function TemporaryHelpCommand() {
 					heading: "Display command usage details and other useful information to the user.",
 					get children() {
 						return createComponent(TSDocParam, {
-							name: "segments",
-							children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
+							name: "commands",
+							children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no commands are provided, general help information about the CLI application will be displayed.`
 						});
 					}
 				}),
@@ -37,7 +37,7 @@ function TemporaryHelpCommand() {
 					async: true,
 					name: "handler",
 					parameters: [{
-						name: "segments",
+						name: "commands",
 						type: "string[]",
 						default: "[]"
 					}]
@@ -51,10 +51,10 @@ function TemporaryHelpCommand() {
 */
 function HelpCommand(props) {
 	const context = usePowerlines();
-	const helpImports = computed(() => props.commands ? props.commands.reduce((ret, segments) => {
-		ret[joinPaths("help", ...segments)] = [{
+	const helpImports = computed(() => props.commands ? props.commands.reduce((ret, commands) => {
+		ret[joinPaths("help", ...commands)] = [{
 			name: "showHelp",
-			alias: `showHelp${segments.map((segment) => pascalCase(segment.replace(/-/g, ""))).join("")}`
+			alias: `showHelp${commands.map((command) => pascalCase(command.replace(/-/g, ""))).join("")}`
 		}];
 		return ret;
 	}, {}) : {});
@@ -90,8 +90,8 @@ function HelpCommand(props) {
 				heading: "Display command usage details and other useful information to the user.",
 				get children() {
 					return createComponent(TSDocParam, {
-						name: "segments",
-						children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
+						name: "commands",
+						children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no commands are provided, general help information about the CLI application will be displayed.`
 					});
 				}
 			}), createComponent(FunctionDeclaration, {
@@ -100,7 +100,7 @@ function HelpCommand(props) {
 				async: true,
 				name: "handler",
 				parameters: [{
-					name: "segments",
+					name: "commands",
 					type: "string[]",
 					default: "[]"
 				}],
@@ -114,25 +114,25 @@ function HelpCommand(props) {
 							return [createComponent(For, {
 								each: commandSegmentsList,
 								doubleHardline: true,
-								children: (segments, index) => createComponent(Show, {
+								children: (commands, index) => createComponent(Show, {
 									when: index > 0,
 									get fallback() {
 										return createComponent(IfStatement, {
 											get condition() {
-												return code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
+												return code`commands.join("/").toLowerCase() === "${commands.join("/").toLowerCase()}"`;
 											},
 											get children() {
-												return code` showHelp${segments.map((segment) => pascalCase(segment)).join("")}(); `;
+												return code` showHelp${commands.map((command) => pascalCase(command)).join("")}(); `;
 											}
 										});
 									},
 									get children() {
 										return createComponent(ElseIfClause, {
 											get condition() {
-												return code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
+												return code`commands.join("/").toLowerCase() === "${commands.join("/").toLowerCase()}"`;
 											},
 											get children() {
-												return code` showHelp${segments.map((segment) => pascalCase(segment)).join("")}(); `;
+												return code` showHelp${commands.map((command) => pascalCase(command)).join("")}(); `;
 											}
 										});
 									}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/plugin-help",
-  "version": "0.2.34",
+  "version": "0.2.36",
   "private": false,
   "description": "A package containing a Shell Shock plugin to provide help and documentation for the local application's commands.",
   "keywords": [
@@ -156,9 +156,9 @@
     "@powerlines/deepkit": "^0.9.81",
     "@powerlines/plugin-alloy": "^0.26.220",
     "@powerlines/plugin-plugin": "^0.12.539",
-    "@shell-shock/core": "0.17.16",
-    "@shell-shock/plugin-console": "0.2.20",
-    "@shell-shock/plugin-theme": "0.4.29",
+    "@shell-shock/core": "0.17.18",
+    "@shell-shock/plugin-console": "0.2.22",
+    "@shell-shock/plugin-theme": "0.4.31",
     "@stryke/helpers": "^0.10.24",
     "@stryke/path": "^0.29.11",
     "@stryke/string-format": "^0.17.26",
@@ -172,5 +172,5 @@
     "@types/node": "^25.9.2"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "fb690df8ec51cb881e90d3bb9b347f7f15b06e07"
+  "gitHead": "4ca0ac0ff9ada03aea6667c89a04b54dc73ff40b"
 }