@shell-shock/plugin-help 0.2.24 → 0.2.26

package/README.md

@@ -249,7 +249,7 @@ generation of development tools, please reach out on our
 
 <div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://public.storm-cdn.com/storm-software/icon-circle-fill-dark.png" alt="Storm Software" width="200px"/></a></div>
 <br />
-<div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://public.storm-cdn.com/visit-us-text.svg" alt="Visit us at stormsoftware.com" height="90px"/></a></div>
+<div align="center"><a href="https://stormsoftware.com" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/misc/text/visit-us-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/misc/text/visit-us-light.png"><img src="https://public.storm-cdn.com/misc/text/visit-us-dark.png" height="90px" alt="Visit us at stormsoftware.com" /></picture></a></div>
 
 <br />
 

package/dist/_virtual/_rolldown/runtime.cjs

@@ -1,29 +1 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-
-exports.__toESM = __toESM;
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;

package/dist/components/display.cjs

@@ -1,282 +1,22 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let _alloy_js_core = require("@alloy-js/core");
-let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
-let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
-let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
-let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let _shell_shock_core = require("@shell-shock/core");
-let _shell_shock_plugin_theme_contexts_theme = require("@shell-shock/plugin-theme/contexts/theme");
-let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
-let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
-let _stryke_string_format_snake_case = require("@stryke/string-format/snake-case");
-
-//#region src/components/display.tsx
-/**
-* A component that generates the usage display for a command.
-*/
-function HelpUsageDisplay(props) {
-	const { command, indent = 2 } = props;
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const theme = (0, _shell_shock_plugin_theme_contexts_theme.useTheme)();
-	return [
-		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core/jsx-runtime`),t=require(`@alloy-js/core`),n=require(`@shell-shock/core/plugin-utils`),r=require(`@stryke/type-checks/is-set-string`),i=require(`@powerlines/plugin-alloy/core/components/spacing`),a=require(`@powerlines/plugin-alloy/core/contexts/context`),o=require(`@shell-shock/core`),s=require(`@shell-shock/plugin-theme/contexts/theme`),c=require(`@stryke/string-format/camel-case`),l=require(`@stryke/string-format/kebab-case`),u=require(`@stryke/string-format/snake-case`);function d(r){let{command:i,indent:c=2}=r,l=(0,a.usePowerlines)(),d=(0,s.useTheme)();return[(0,e.memo)(()=>t.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("<${(0, _stryke_string_format_snake_case.snakeCase)((arg.kind === _shell_shock_core.CommandParameterKinds.string || arg.kind === _shell_shock_core.CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === _shell_shock_core.CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === _shell_shock_core.CommandParameterKinds.string || arg.kind === _shell_shock_core.CommandParameterKinds.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() {
-				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`
+        textColors.body.secondary(\`\${textColors.usage.bin("$_ ${(0,n.getAppBin)(l)}")}${i.segments.length>0?` ${i.segments.map(e=>`\${textColors.usage.${(0,n.isDynamicPathSegment)(e)?`dynamic`:`command`}("${(0,n.isDynamicPathSegment)(e)?`[${(0,u.snakeCase)((0,n.getDynamicPathSegmentName)(e))}]`:e}")}`).join(` `)}`:``}${Object.values(i.children).length>0?' ${textColors.usage.dynamic("[command]")}':``}${i.args.length>0?` ${i.args.map(e=>`\${textColors.usage.args("<${(0,u.snakeCase)((e.kind===o.CommandParameterKinds.string||e.kind===o.CommandParameterKinds.number)&&e.choices&&e.choices.length>0?e.choices.join(`|`):e.kind===o.CommandParameterKinds.string&&e.format?e.format:e.name)}${(e.kind===o.CommandParameterKinds.string||e.kind===o.CommandParameterKinds.number)&&e.variadic?`...`:``}>")}`).join(` `)}`:``} \${textColors.usage.options("[options]")}\`), { padding: ${d.padding.app*c} }
+      );`),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(t.Show,{get when(){return i.args.length>0},get children(){return[(0,e.createIntrinsic)(`hbr`,{}),(0,e.memo)(()=>t.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("<${(0, _stryke_string_format_snake_case.snakeCase)((arg.kind === _shell_shock_core.CommandParameterKinds.string || arg.kind === _shell_shock_core.CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === _shell_shock_core.CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === _shell_shock_core.CommandParameterKinds.string || arg.kind === _shell_shock_core.CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
-      );`),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
-				];
-			}
-		})
-	];
-}
-/**
-* A component that generates the options table display for a command.
-*/
-function HelpOptionsDisplay(props) {
-	const { options } = props;
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return [
-		_alloy_js_core.code`table([ `,
-		(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);
-			},
-			hardline: true,
-			children: (option) => {
-				const flags = [];
-				const names = [];
-				if (option.name.length === 1) flags.push(`-${option.name}`);
-				else names.push(`--${(0, _stryke_string_format_kebab_case.kebabCase)(option.name)}`);
-				option.alias.forEach((alias) => {
-					if (alias.length === 1) flags.push(`-${alias}`);
-					else names.push(`--${(0, _stryke_string_format_kebab_case.kebabCase)(alias)}`);
-				});
-				return _alloy_js_core.code`[{ value: textColors.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === _shell_shock_core.CommandParameterKinds.string ? ` <${(0, _stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === _shell_shock_core.CommandParameterKinds.number ? ` <${(0, _stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: textColors.body.tertiary(\`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(option.description, { length: 200 }).replace(/\.+$/, "").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}.\`), align: "left", border: "none" }], `;
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		_alloy_js_core.code` ]); `
-	];
-}
-/**
-* A component that generates the commands table display for a command.
-*/
-function HelpCommandsDisplay(props) {
-	const { commands } = props;
-	return [
-		_alloy_js_core.code`table([ `,
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-			get each() {
-				return Object.values(commands);
-			},
-			hardline: true,
-			children: (child) => _alloy_js_core.code`[{ value: textColors.body.primary("${child.name}"), align: "right", border: "none" }, { value: textColors.body.tertiary(\`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(child.description, { length: 200 }).replace(/\.+$/, "").trim()}.\`), align: "left", border: "none" }], `
-		}),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		_alloy_js_core.code` ]); `
-	];
-}
-/**
-* A component that generates the `help` function declaration for a command.
-*/
-function BaseHelpDisplay(props) {
-	const { command, indent = 1, filterGlobalOptions = false } = props;
-	const theme = (0, _shell_shock_plugin_theme_contexts_theme.useTheme)();
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const options = (0, _alloy_js_core.computed)(() => filterGlobalOptions ? Object.values(command.options).filter((option) => !context.options.some((globalOption) => globalOption.name === option.name || option.alias.includes(globalOption.name) || globalOption.alias?.includes(option.name) || globalOption.alias?.some((alias) => option.alias.includes(alias)))) : Object.values(command.options));
-	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.createIntrinsic)("hbr", {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(HelpUsageDisplay, {
-			command,
-			indent
-		}),
-		(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 options.value.length > 0;
-			},
-			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} }` : ""});`),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(HelpOptionsDisplay, { get options() {
-						return options.value;
-					} }),
-					(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 Object.keys(command.children).length > 0;
-			},
-			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} }` : ""});`),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(HelpCommandsDisplay, { get commands() {
-						return command.children;
-					} }),
-					(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 (0, _stryke_type_checks_is_set_string.isSetString)(command.reference);
-			},
-			get children() {
-				return [
-					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine("");
-      writeLine(textColors.heading.tertiary(\`More information about this command can be found in the reference documentation at \${link("${command.reference}")}\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
-				];
-			}
-		})
-	];
-}
-function sortCommands(commands) {
-	return Object.values(commands).sort((a, b) => {
-		if (a.tags.some((tag) => tag.toLowerCase() === "deprecated") && !b.tags.some((tag) => tag.toLowerCase() === "deprecated")) return 1;
-		else if (!a.tags.some((tag) => tag.toLowerCase() === "deprecated") && b.tags.some((tag) => tag.toLowerCase() === "deprecated")) return -1;
-		else if (a.tags.some((tag) => tag.toLowerCase() === "experimental") && !b.tags.some((tag) => tag.toLowerCase() === "experimental")) return 1;
-		else if (!a.tags.some((tag) => tag.toLowerCase() === "experimental") && b.tags.some((tag) => tag.toLowerCase() === "experimental")) return -1;
-		else if (a.tags.some((tag) => tag.toLowerCase() === "utility") && !b.tags.some((tag) => tag.toLowerCase() === "utility")) return 1;
-		else if (!a.tags.some((tag) => tag.toLowerCase() === "utility") && b.tags.some((tag) => tag.toLowerCase() === "utility")) return -1;
-		return a.name.localeCompare(b.name);
-	});
-}
-/**
-* A component that generates the invocation of the `help` function for a command.
-*/
-function VirtualCommandHelpDisplay(props) {
-	const { options, segments, commands } = props;
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return [
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		_alloy_js_core.code`writeLine(bold(textColors.heading.secondary("Common Options:")));`,
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(HelpOptionsDisplay, { options }),
-		_alloy_js_core.code`writeLine(""); `,
-		(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 Object.keys(commands).length > 0;
-			},
-			get children() {
-				return [
-					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(textColors.body.tertiary("The following commands are available through the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} command-line interface:"));
-        writeLine(""); `),
-					(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 sortCommands(commands);
-						},
-						doubleHardline: true,
-						joiner: _alloy_js_core.code`writeLine(""); `,
-						ender: _alloy_js_core.code`writeLine(""); `,
-						children: (child) => [
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
-                writeLine(textColors.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon}  " : "") + ` : ""}\`${child.title} ${child.isVirtual ? "" : "Command"}${child.tags?.length > 0 ? ` - ${child.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(" ")}` : ""}\`));
+        textColors.body.secondary(\`\${textColors.usage.bin("$_ ${(0,n.getAppBin)(l)}")}${i.segments.length>0?` ${i.segments.map(e=>`\${textColors.usage.${(0,n.isDynamicPathSegment)(e)?`dynamic`:`command`}("${(0,n.isDynamicPathSegment)(e)?`[${(0,u.snakeCase)((0,n.getDynamicPathSegmentName)(e))}]`:e}")}`).join(` `)}`:``}${Object.values(i.children).length>0?' ${textColors.usage.dynamic("[command]")}':``} \${textColors.usage.options("[options]")}${i.args.length>0?` ${i.args.map(e=>`\${textColors.usage.args("<${(0,u.snakeCase)((e.kind===o.CommandParameterKinds.string||e.kind===o.CommandParameterKinds.number)&&e.choices&&e.choices.length>0?e.choices.join(`|`):e.kind===o.CommandParameterKinds.string&&e.format?e.format:e.name)}${(e.kind===o.CommandParameterKinds.string||e.kind===o.CommandParameterKinds.number)&&e.variadic?`...`:``}>")}`).join(` `)}`:``}\`), { padding: ${d.padding.app*c} }
+      );`),(0,e.createIntrinsic)(`hbr`,{})]}})]}function f(r){let{options:i}=r,s=(0,a.usePowerlines)();return[t.code`table([ `,(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(t.For,{get each(){return(0,n.sortOptions)(i)},hardline:!0,children:e=>{let r=[],i=[];return e.name.length===1?r.push(`-${e.name}`):i.push(`--${(0,l.kebabCase)(e.name)}`),e.alias.forEach(e=>{e.length===1?r.push(`-${e}`):i.push(`--${(0,l.kebabCase)(e)}`)}),t.code`[{ value: textColors.body.primary("${r.length>0?`${r.sort().join(`, `)}${i.length>0?`, `:``}`:``}${i.length>0?i.sort().join(`, `):``}${e.kind===o.CommandParameterKinds.string?` <${(0,u.snakeCase)(e.choices&&e.choices.length>0?e.choices.join(`|`):e.format?e.format:e.name)}${e.variadic?`...`:``}>`:e.kind===o.CommandParameterKinds.number?` <${(0,u.snakeCase)(e.choices&&e.choices.length>0?e.choices.join(`|`):e.name)}${e.variadic?`...`:``}>`:``}"), align: "right", border: "none", maxWidth: "1/3" }, { value: textColors.body.tertiary(\`${(0,n.formatShortDescription)(e.description,{length:200}).replace(/\.+$/,``).trim()}${e.env||e.default!==void 0?` (${e.env?`env: ${s.config.appSpecificEnvPrefix}_${e.env}${e.default===void 0?``:`, `}`:``}${e.default===void 0?``:`default: ${JSON.stringify(e.default).replace(/"/g,`\\"`)}`})`:``}.\`), align: "left", border: "none" }], `}}),(0,e.createIntrinsic)(`hbr`,{}),t.code` ]); `]}function p(r){let{commands:i}=r;return[t.code`table([ `,(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(t.For,{get each(){return Object.values(i)},hardline:!0,children:e=>t.code`[{ value: textColors.body.primary("${e.name}"), align: "right", border: "none" }, { value: textColors.body.tertiary(\`${(0,n.formatShortDescription)(e.description,{length:200}).replace(/\.+$/,``).trim()}.\`), align: "left", border: "none" }], `}),(0,e.createIntrinsic)(`hbr`,{}),t.code` ]); `]}function m(n){let{command:o,indent:c=1,filterGlobalOptions:l=!1}=n,u=(0,s.useTheme)(),m=(0,a.usePowerlines)(),h=(0,t.computed)(()=>l?Object.values(o.options).filter(e=>!m.globalOptions.some(t=>t.name===e.name||e.alias.includes(t.name)||t.alias?.includes(e.name)||t.alias?.some(t=>e.alias.includes(t)))):Object.values(o.options));return[(0,e.memo)(()=>t.code`writeLine(bold(textColors.heading.secondary("Usage:"))${c>1?`, { padding: ${u.padding.app*c} }`:``});`),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(d,{command:o,indent:c}),(0,e.createComponent)(i.Spacing,{}),(0,e.createComponent)(t.Show,{get when(){return h.value.length>0},get children(){return[(0,e.memo)(()=>t.code`writeLine("");
+      writeLine(bold(textColors.heading.secondary("Options:"))${c>1?`, { padding: ${u.padding.app*c} }`:``});`),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(f,{get options(){return h.value}}),(0,e.createComponent)(i.Spacing,{})]}}),(0,e.createComponent)(t.Show,{get when(){return Object.keys(o.children).length>0},get children(){return[(0,e.memo)(()=>t.code`writeLine("");
+      writeLine(bold(textColors.heading.secondary("Commands:"))${c>1?`, { padding: ${u.padding.app*c} }`:``});`),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(p,{get commands(){return o.children}}),(0,e.createComponent)(i.Spacing,{})]}}),(0,e.createComponent)(t.Show,{get when(){return(0,r.isSetString)(o.reference)},get children(){return[(0,e.memo)(()=>t.code`writeLine("");
+      writeLine(textColors.heading.tertiary(\`More information about this command can be found in the reference documentation at \${link("${o.reference}")}\`)${c>1?`, { padding: ${u.padding.app*c} }`:``});`),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(i.Spacing,{})]}})]}function h(e){return Object.values(e).sort((e,t)=>e.tags.some(e=>e.toLowerCase()===`deprecated`)&&!t.tags.some(e=>e.toLowerCase()===`deprecated`)?1:!e.tags.some(e=>e.toLowerCase()===`deprecated`)&&t.tags.some(e=>e.toLowerCase()===`deprecated`)?-1:e.tags.some(e=>e.toLowerCase()===`experimental`)&&!t.tags.some(e=>e.toLowerCase()===`experimental`)?1:!e.tags.some(e=>e.toLowerCase()===`experimental`)&&t.tags.some(e=>e.toLowerCase()===`experimental`)?-1:e.tags.some(e=>e.toLowerCase()===`utility`)&&!t.tags.some(e=>e.toLowerCase()===`utility`)?1:!e.tags.some(e=>e.toLowerCase()===`utility`)&&t.tags.some(e=>e.toLowerCase()===`utility`)?-1:e.name.localeCompare(t.name))}function g(r){let{options:o,segments:s,commands:l}=r,u=(0,a.usePowerlines)();return[(0,e.createIntrinsic)(`hbr`,{}),t.code`writeLine(bold(textColors.heading.secondary("Common Options:")));`,(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(f,{options:o}),t.code`writeLine(""); `,(0,e.createComponent)(i.Spacing,{}),(0,e.createComponent)(t.Show,{get when(){return Object.keys(l).length>0},get children(){return[(0,e.memo)(()=>t.code`writeLine(textColors.body.tertiary("The following commands are available through the ${(0,n.getAppTitle)(u,!0)} command-line interface:"));
+        writeLine(""); `),(0,e.createComponent)(i.Spacing,{}),(0,e.createComponent)(t.For,{get each(){return h(l)},doubleHardline:!0,joiner:t.code`writeLine(""); `,ender:t.code`writeLine(""); `,children:r=>[(0,e.createIntrinsic)(`hbr`,{}),(0,e.memo)(()=>t.code`
+                writeLine(textColors.heading.primary(${r.icon?`(isUnicodeSupported ? " ${r.icon}  " : "") + `:``}\`${r.title} ${r.isVirtual?``:`Command`}${r.tags?.length>0?` - ${r.tags.map(e=>`\${textColors.tags.${(0,c.camelCase)(e)} ? textColors.tags.${(0,c.camelCase)(e)}(inverse(" ${e} ")) : textColors.tags.$default(inverse(" ${e} "))}`).join(` `)}`:``}\`));
                 writeLine("");
-                writeLine(textColors.body.tertiary(splitText(\`${(0, _shell_shock_core_plugin_utils.formatDescription)(child.description).replace(/\.+$/, "").trim()}.\`)));
-                writeLine(""); `),
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(BaseHelpDisplay, {
-								command: child,
-								indent: 2,
-								filterGlobalOptions: true
-							}),
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
-						]
-					}),
-					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`help(\`Running a specific command with the help flag (via: \${inlineCode("${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} ${segments && segments.length > 0 ? ` ${segments.join(" ")}` : ""} <specific command> --help")}) or the help command with the specific command as arguments (via: \${inlineCode("${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} ${segments && segments.length > 0 ? ` ${segments.join(" ")}` : ""} help <specific command>")}) will provide additional information that is specific to that command.\`);
-        writeLine("");`)
-				];
-			}
-		})
-	];
-}
-/**
-* A component that generates the invocation of the `help` function for a command.
-*/
-function CommandHelpDisplay(props) {
-	const { command } = props;
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return [
-		_alloy_js_core.code`writeLine(""); `,
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(BaseHelpDisplay, {
-			command,
-			filterGlobalOptions: false
-		}),
-		_alloy_js_core.code`writeLine(""); `,
-		(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 Object.keys(command.children).length > 0;
-			},
-			get children() {
-				return [
-					_alloy_js_core.code`writeLine(textColors.body.tertiary("The following sub-commands are available:"));
-        writeLine(""); `,
-					(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 sortCommands(command.children);
-						},
-						doubleHardline: true,
-						joiner: _alloy_js_core.code`writeLine(""); `,
-						ender: _alloy_js_core.code`writeLine(""); `,
-						children: (child) => [
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
-                writeLine(textColors.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon}  " : "") + ` : ""}\`${child.title} ${child.isVirtual ? "" : "Command"}${child.tags?.length > 0 ? ` - ${child.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(" ")}` : ""}\`));
+                writeLine(textColors.body.tertiary(splitText(\`${(0,n.formatDescription)(r.description).replace(/\.+$/,``).trim()}.\`)));
+                writeLine(""); `),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(m,{command:r,indent:2,filterGlobalOptions:!0}),(0,e.createIntrinsic)(`hbr`,{})]}),(0,e.memo)(()=>t.code`help(\`Running a specific command with the help flag (via: \${inlineCode("${(0,n.getAppBin)(u)} ${s&&s.length>0?` ${s.join(` `)}`:``} <specific command> --help")}) or the help command with the specific command as arguments (via: \${inlineCode("${(0,n.getAppBin)(u)} ${s&&s.length>0?` ${s.join(` `)}`:``} help <specific command>")}) will provide additional information that is specific to that command.\`);
+        writeLine("");`)]}})]}function _(r){let{command:o}=r,s=(0,a.usePowerlines)();return[t.code`writeLine(""); `,(0,e.createComponent)(i.Spacing,{}),(0,e.createComponent)(m,{command:o,filterGlobalOptions:!1}),t.code`writeLine(""); `,(0,e.createComponent)(i.Spacing,{}),(0,e.createComponent)(t.Show,{get when(){return Object.keys(o.children).length>0},get children(){return[t.code`writeLine(textColors.body.tertiary("The following sub-commands are available:"));
+        writeLine(""); `,(0,e.createComponent)(i.Spacing,{}),(0,e.createComponent)(t.For,{get each(){return h(o.children)},doubleHardline:!0,joiner:t.code`writeLine(""); `,ender:t.code`writeLine(""); `,children:r=>[(0,e.createIntrinsic)(`hbr`,{}),(0,e.memo)(()=>t.code`
+                writeLine(textColors.heading.primary(${r.icon?`(isUnicodeSupported ? " ${r.icon}  " : "") + `:``}\`${r.title} ${r.isVirtual?``:`Command`}${r.tags?.length>0?` - ${r.tags.map(e=>`\${textColors.tags.${(0,c.camelCase)(e)} ? textColors.tags.${(0,c.camelCase)(e)}(inverse(" ${e} ")) : textColors.tags.$default(inverse(" ${e} "))}`).join(` `)}`:``}\`));
                 writeLine("");
-                writeLine(textColors.body.tertiary(splitText(\`${(0, _shell_shock_core_plugin_utils.formatDescription)(child.description).replace(/\.+$/, "").trim()}.\`)));
-                writeLine(""); `),
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(BaseHelpDisplay, {
-								command: child,
-								indent: 2,
-								filterGlobalOptions: true
-							}),
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
-						]
-					}),
-					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`help(\`Running a specific command with the help flag (via: \${inlineCode("${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} ${command.segments.join(" ")} <specific command> --help")}) will provide additional information that is specific to that command.\`);
-        writeLine("");`)
-				];
-			}
-		})
-	];
-}
-
-//#endregion
-exports.BaseHelpDisplay = BaseHelpDisplay;
-exports.CommandHelpDisplay = CommandHelpDisplay;
-exports.HelpCommandsDisplay = HelpCommandsDisplay;
-exports.HelpOptionsDisplay = HelpOptionsDisplay;
-exports.HelpUsageDisplay = HelpUsageDisplay;
-exports.VirtualCommandHelpDisplay = VirtualCommandHelpDisplay;
+                writeLine(textColors.body.tertiary(splitText(\`${(0,n.formatDescription)(r.description).replace(/\.+$/,``).trim()}.\`)));
+                writeLine(""); `),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(m,{command:r,indent:2,filterGlobalOptions:!0}),(0,e.createIntrinsic)(`hbr`,{})]}),(0,e.memo)(()=>t.code`help(\`Running a specific command with the help flag (via: \${inlineCode("${(0,n.getAppBin)(s)} ${o.segments.join(` `)} <specific command> --help")}) will provide additional information that is specific to that command.\`);
+        writeLine("");`)]}})]}exports.BaseHelpDisplay=m,exports.CommandHelpDisplay=_,exports.HelpCommandsDisplay=p,exports.HelpOptionsDisplay=f,exports.HelpUsageDisplay=d,exports.VirtualCommandHelpDisplay=g;