@shell-shock/preset-script 0.3.1 → 0.3.3

package/dist/components/help.cjs

@@ -3,9 +3,10 @@ const require_contexts_theme = require('../contexts/theme.cjs');
 require('../contexts/index.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_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __shell_shock_core_components_usage = require("@shell-shock/core/components/usage");
 let __shell_shock_core_plugin_utils_reflect = require("@shell-shock/core/plugin-utils/reflect");
 let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let __stryke_string_format_snake_case = require("@stryke/string-format/snake-case");
@@ -23,12 +24,18 @@ function HelpUsage(props) {
 			return Object.keys(context.config.bin);
 		},
 		hardline: true,
-		children: (bin) => [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
+		children: (bin) => [
+			__alloy_js_core.code`
       writeLine(
-        colors.text.body.primary(
-          "$ npx ${bin} ${command.path.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isVariableCommandPath)(segment) ? `<${command.path.variables[segment]?.variadic ? "..." : ""}${(0, __stryke_string_format_kebab_case.kebabCase)((0, __shell_shock_core_plugin_utils_context_helpers.getVariableCommandPathName)(segment))}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]"
-        ), { padding: ${theme.padding.app * indent} }
-      );`), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})]
+        colors.text.body.primary("`,
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_usage.Usage, {
+				bin,
+				command
+			}),
+			(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`"), { padding: ${theme.padding.app * indent} }
+      );`),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+		]
 	});
 }
 /**
@@ -89,7 +96,7 @@ function Help(props) {
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
 	const options = (0, __alloy_js_core.computed)(() => 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)))) ?? []);
 	return [
-		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`writeLine(colors.text.heading.secondary("Usage:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`writeLine(colors.bold(colors.text.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)(HelpUsage, {
 			command,
@@ -104,7 +111,7 @@ function Help(props) {
 			get children() {
 				return [
 					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`writeLine("");
-      writeLine(colors.text.heading.secondary("Options:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(colors.bold(colors.text.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)(HelpOptions, { get options() {
 						return options.value;
@@ -121,7 +128,7 @@ function Help(props) {
 			get children() {
 				return [
 					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`writeLine("");
-      writeLine(colors.text.heading.secondary("Commands:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(colors.bold(colors.text.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)(HelpCommands, { get commands() {
 						return command.children;
@@ -133,10 +140,69 @@ function Help(props) {
 		})
 	];
 }
+/**
+* A component that generates the invocation of the `help` function for a command.
+*/
+function HelpInvoke(props) {
+	const { options, commands } = props;
+	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [
+		__alloy_js_core.code`
+      writeLine("");
+      banner();
+      writeLine(""); `,
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		__alloy_js_core.code`writeLine(colors.bold(colors.text.heading.secondary("Global Options:")));`,
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(HelpOptions, { options }),
+		__alloy_js_core.code`writeLine(""); `,
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Object.keys(commands).length > 0;
+			},
+			get children() {
+				return [
+					__alloy_js_core.code`writeLine(colors.text.body.secondary("The following commands are available:"));
+        writeLine(""); `,
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(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);
+						},
+						doubleHardline: true,
+						joiner: __alloy_js_core.code`writeLine(""); `,
+						ender: __alloy_js_core.code`writeLine(""); `,
+						children: (child) => [
+							(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
+                writeLine(colors.text.heading.primary("${child.title} ${child.isVirtual ? "" : "Command"}"));
+                writeLine("");
+                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine("");
+                `),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(Help, {
+								command: child,
+								indent: 2
+							}),
+							(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: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} <specific command> --help') will provide additional information that is specific to that command.");
+                  writeLine("");`)
+				];
+			}
+		})
+	];
+}
 
 //#endregion
 exports.Help = Help;
 exports.HelpCommands = HelpCommands;
+exports.HelpInvoke = HelpInvoke;
 exports.HelpOptions = HelpOptions;
 exports.HelpUsage = HelpUsage;
 //# sourceMappingURL=help.cjs.map

package/dist/components/help.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.cjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","getVariableCommandPathName","isVariableCommandPath","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","path","segments","map","segment","variables","variadic","join","values","length","padding","app","_$createIntrinsic","HelpOptions","options","option","flags","names","name","push","alias","forEach","sort","kind","string","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","Help","filter","some","globalOption","includes","when","value"],"sources":["../../src/components/help.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 2\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <For each={Object.keys(context.config.bin)} hardline>\n      {bin => (\n        <>\n          {code`\n      writeLine(\n        colors.text.body.primary(\n          \"$ npx ${bin} ${command.path.segments\n            .map(segment =>\n              isVariableCommandPath(segment)\n                ? `<${command.path.variables[segment]?.variadic ? \"...\" : \"\"}${kebabCase(\n                    getVariableCommandPathName(segment)\n                  )}>`\n                : segment\n            )\n            .join(\" \")}${\n            Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n          } [options]\"\n        ), { padding: ${theme.padding.app * indent} }\n      );`}\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n\nexport interface HelpOptionsProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={sortOptions(options)} hardline>\n        {option => {\n          const flags = [] as string[];\n          const names = [] as string[];\n          if (option.name.length === 1) {\n            flags.push(`-${option.name}`);\n          } else {\n            names.push(`--${kebabCase(option.name)}`);\n          }\n\n          option.alias.forEach((alias: string) => {\n            if (alias.length === 1) {\n              flags.push(`-${alias}`);\n            } else {\n              names.push(`--${kebabCase(alias)}`);\n            }\n          });\n\n          return code`[{ value: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default)}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n  const { commands } = props;\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={Object.values(commands)} hardline>\n        {child =>\n          code`[{ value: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function Help(props: HelpProps) {\n  const { command, indent = 1 } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(\n    () =>\n      Object.values(command.options).filter(\n        option =>\n          !context.options.some(\n            globalOption =>\n              globalOption.name === option.name ||\n              option.alias.includes(globalOption.name) ||\n              globalOption.alias?.includes(option.name) ||\n              globalOption.alias?.some(alias => option.alias.includes(alias))\n          )\n      ) ?? []\n  );\n\n  return (\n    <>\n      {code`writeLine(colors.text.heading.secondary(\"Usage:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <hbr />\n      <hbr />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.text.heading.secondary(\"Options:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.text.heading.secondary(\"Commands:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"help.cjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","Usage","getAppBin","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","padding","app","_$createIntrinsic","HelpOptions","options","option","flags","names","name","length","push","alias","forEach","sort","join","kind","string","variadic","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","values","child","Help","filter","some","globalOption","includes","when","value","HelpInvoke","doubleHardline","joiner","ender","title","isVirtual"],"sources":["../../src/components/help.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { Usage } from \"@shell-shock/core/components/usage\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 2\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <For each={Object.keys(context.config.bin)} hardline>\n      {bin => (\n        <>\n          {code`\n      writeLine(\n        colors.text.body.primary(\"`}\n          <Usage bin={bin} command={command} />\n          {code`\"), { padding: ${theme.padding.app * indent} }\n      );`}\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n\nexport interface HelpOptionsProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={sortOptions(options)} hardline>\n        {option => {\n          const flags = [] as string[];\n          const names = [] as string[];\n          if (option.name.length === 1) {\n            flags.push(`-${option.name}`);\n          } else {\n            names.push(`--${kebabCase(option.name)}`);\n          }\n\n          option.alias.forEach((alias: string) => {\n            if (alias.length === 1) {\n              flags.push(`-${alias}`);\n            } else {\n              names.push(`--${kebabCase(alias)}`);\n            }\n          });\n\n          return code`[{ value: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default)}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n  const { commands } = props;\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={Object.values(commands)} hardline>\n        {child =>\n          code`[{ value: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function Help(props: HelpProps) {\n  const { command, indent = 1 } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(\n    () =>\n      Object.values(command.options).filter(\n        option =>\n          !context.options.some(\n            globalOption =>\n              globalOption.name === option.name ||\n              option.alias.includes(globalOption.name) ||\n              globalOption.alias?.includes(option.name) ||\n              globalOption.alias?.some(alias => option.alias.includes(alias))\n          )\n      ) ?? []\n  );\n\n  return (\n    <>\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <hbr />\n      <hbr />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n\nexport interface HelpInvokeProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function HelpInvoke(props: HelpInvokeProps) {\n  const { options, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`\n      writeLine(\"\");\n      banner();\n      writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      <Show when={Object.keys(commands).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(commands)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${\n                  child.isVirtual ? \"\" : \"Command\"\n                }\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <Help command={child} indent={2} />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} <specific command> --help') will provide additional information that is specific to that command.\");\n                  writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/help.d.cts

@@ -60,6 +60,20 @@ interface HelpProps {
  * A component that generates the `help` function declaration for a command.
  */
 declare function Help(props: HelpProps): _alloy_js_core7.Children;
+interface HelpInvokeProps {
+  /**
+   * The options to display help for.
+   */
+  options: CommandOption[];
+  /**
+   * A mapping of command names to their command definitions.
+   */
+  commands: Record<string, CommandTree>;
+}
+/**
+ * A component that generates the invocation of the `help` function for a command.
+ */
+declare function HelpInvoke(props: HelpInvokeProps): _alloy_js_core7.Children;
 //#endregion
-export { Help, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps };
+export { Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps };
 //# sourceMappingURL=help.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAmCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiCR;AAUjB;AA+DA;AAUA;AAuBA;AAoBA;;;;;;;;iBA/JgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;UAiC9B,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA"}
+{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAiCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAuBR;AAUjB;AA+DA;AAUA;AAuBA;AAoBA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAM3B;;iBAzNgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;UAuB9B,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA;UAqDpB,eAAA;;;;WAIN;;;;YAKC,eAAe;;;;;iBAMX,UAAA,QAAkB,kBAAe,eAAA,CAAA"}

package/dist/components/help.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core7 from "@alloy-js/core";
 import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/help.d.ts
@@ -20,7 +20,7 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core0.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core7.Children;
 interface HelpOptionsProps {
   /**
    * The options to display help for.
@@ -30,7 +30,7 @@ interface HelpOptionsProps {
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core0.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core7.Children;
 interface HelpCommandsProps {
   /**
    * A mapping of command names to their command definitions.
@@ -40,7 +40,7 @@ interface HelpCommandsProps {
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core0.Children;
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core7.Children;
 interface HelpProps {
   /**
    * The command to generate help for.
@@ -59,7 +59,21 @@ interface HelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function Help(props: HelpProps): _alloy_js_core0.Children;
+declare function Help(props: HelpProps): _alloy_js_core7.Children;
+interface HelpInvokeProps {
+  /**
+   * The options to display help for.
+   */
+  options: CommandOption[];
+  /**
+   * A mapping of command names to their command definitions.
+   */
+  commands: Record<string, CommandTree>;
+}
+/**
+ * A component that generates the invocation of the `help` function for a command.
+ */
+declare function HelpInvoke(props: HelpInvokeProps): _alloy_js_core7.Children;
 //#endregion
-export { Help, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps };
+export { Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps };
 //# sourceMappingURL=help.d.mts.map

package/dist/components/help.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAmCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiCR;AAUjB;AA+DA;AAUA;AAuBA;AAoBA;;;;;;;;iBA/JgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;UAiC9B,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA"}
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAiCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAuBR;AAUjB;AA+DA;AAUA;AAuBA;AAoBA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAM3B;;iBAzNgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;UAuB9B,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA;UAqDpB,eAAA;;;;WAIN;;;;YAKC,eAAe;;;;;iBAMX,UAAA,QAAkB,kBAAe,eAAA,CAAA"}

package/dist/components/help.mjs

@@ -2,9 +2,10 @@ import { useTheme } from "../contexts/theme.mjs";
 import "../contexts/index.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
-import { getVariableCommandPathName, isVariableCommandPath } from "@shell-shock/core/plugin-utils/context-helpers";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { getAppBin } from "@shell-shock/core/plugin-utils/context-helpers";
 import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { Usage } from "@shell-shock/core/components/usage";
 import { sortOptions } from "@shell-shock/core/plugin-utils/reflect";
 import { kebabCase } from "@stryke/string-format/kebab-case";
 import { snakeCase } from "@stryke/string-format/snake-case";
@@ -22,12 +23,18 @@ function HelpUsage(props) {
 			return Object.keys(context.config.bin);
 		},
 		hardline: true,
-		children: (bin) => [memo(() => code`
+		children: (bin) => [
+			code`
       writeLine(
-        colors.text.body.primary(
-          "$ npx ${bin} ${command.path.segments.map((segment) => isVariableCommandPath(segment) ? `<${command.path.variables[segment]?.variadic ? "..." : ""}${kebabCase(getVariableCommandPathName(segment))}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]"
-        ), { padding: ${theme.padding.app * indent} }
-      );`), createIntrinsic("hbr", {})]
+        colors.text.body.primary("`,
+			createComponent(Usage, {
+				bin,
+				command
+			}),
+			memo(() => code`"), { padding: ${theme.padding.app * indent} }
+      );`),
+			createIntrinsic("hbr", {})
+		]
 	});
 }
 /**
@@ -88,7 +95,7 @@ function Help(props) {
 	const context = usePowerlines();
 	const options = computed(() => 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)))) ?? []);
 	return [
-		memo(() => code`writeLine(colors.text.heading.secondary("Usage:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+		memo(() => code`writeLine(colors.bold(colors.text.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
 		createIntrinsic("hbr", {}),
 		createComponent(HelpUsage, {
 			command,
@@ -103,7 +110,7 @@ function Help(props) {
 			get children() {
 				return [
 					memo(() => code`writeLine("");
-      writeLine(colors.text.heading.secondary("Options:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(colors.bold(colors.text.heading.secondary("Options:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
 					createIntrinsic("hbr", {}),
 					createComponent(HelpOptions, { get options() {
 						return options.value;
@@ -120,7 +127,7 @@ function Help(props) {
 			get children() {
 				return [
 					memo(() => code`writeLine("");
-      writeLine(colors.text.heading.secondary("Commands:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(colors.bold(colors.text.heading.secondary("Commands:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
 					createIntrinsic("hbr", {}),
 					createComponent(HelpCommands, { get commands() {
 						return command.children;
@@ -132,7 +139,65 @@ function Help(props) {
 		})
 	];
 }
+/**
+* A component that generates the invocation of the `help` function for a command.
+*/
+function HelpInvoke(props) {
+	const { options, commands } = props;
+	const context = usePowerlines();
+	return [
+		code`
+      writeLine("");
+      banner();
+      writeLine(""); `,
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		code`writeLine(colors.bold(colors.text.heading.secondary("Global Options:")));`,
+		createIntrinsic("hbr", {}),
+		createComponent(HelpOptions, { options }),
+		code`writeLine(""); `,
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			get when() {
+				return Object.keys(commands).length > 0;
+			},
+			get children() {
+				return [
+					code`writeLine(colors.text.body.secondary("The following commands are available:"));
+        writeLine(""); `,
+					createIntrinsic("hbr", {}),
+					createIntrinsic("hbr", {}),
+					createComponent(For, {
+						get each() {
+							return Object.values(commands);
+						},
+						doubleHardline: true,
+						joiner: code`writeLine(""); `,
+						ender: code`writeLine(""); `,
+						children: (child) => [
+							memo(() => code`
+                writeLine(colors.text.heading.primary("${child.title} ${child.isVirtual ? "" : "Command"}"));
+                writeLine("");
+                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine("");
+                `),
+							createIntrinsic("hbr", {}),
+							createComponent(Help, {
+								command: child,
+								indent: 2
+							}),
+							createIntrinsic("hbr", {})
+						]
+					}),
+					memo(() => code`help("Running a specific command with the help flag (via: '${getAppBin(context)} <specific command> --help') will provide additional information that is specific to that command.");
+                  writeLine("");`)
+				];
+			}
+		})
+	];
+}
 
 //#endregion
-export { Help, HelpCommands, HelpOptions, HelpUsage };
+export { Help, HelpCommands, HelpInvoke, HelpOptions, HelpUsage };
 //# sourceMappingURL=help.mjs.map

package/dist/components/help.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.mjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","getVariableCommandPathName","isVariableCommandPath","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","path","segments","map","segment","variables","variadic","join","values","length","padding","app","_$createIntrinsic","HelpOptions","options","option","flags","names","name","push","alias","forEach","sort","kind","string","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","Help","filter","some","globalOption","includes","when","value"],"sources":["../../src/components/help.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 2\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <For each={Object.keys(context.config.bin)} hardline>\n      {bin => (\n        <>\n          {code`\n      writeLine(\n        colors.text.body.primary(\n          \"$ npx ${bin} ${command.path.segments\n            .map(segment =>\n              isVariableCommandPath(segment)\n                ? `<${command.path.variables[segment]?.variadic ? \"...\" : \"\"}${kebabCase(\n                    getVariableCommandPathName(segment)\n                  )}>`\n                : segment\n            )\n            .join(\" \")}${\n            Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n          } [options]\"\n        ), { padding: ${theme.padding.app * indent} }\n      );`}\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n\nexport interface HelpOptionsProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={sortOptions(options)} hardline>\n        {option => {\n          const flags = [] as string[];\n          const names = [] as string[];\n          if (option.name.length === 1) {\n            flags.push(`-${option.name}`);\n          } else {\n            names.push(`--${kebabCase(option.name)}`);\n          }\n\n          option.alias.forEach((alias: string) => {\n            if (alias.length === 1) {\n              flags.push(`-${alias}`);\n            } else {\n              names.push(`--${kebabCase(alias)}`);\n            }\n          });\n\n          return code`[{ value: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default)}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n  const { commands } = props;\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={Object.values(commands)} hardline>\n        {child =>\n          code`[{ value: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function Help(props: HelpProps) {\n  const { command, indent = 1 } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(\n    () =>\n      Object.values(command.options).filter(\n        option =>\n          !context.options.some(\n            globalOption =>\n              globalOption.name === option.name ||\n              option.alias.includes(globalOption.name) ||\n              globalOption.alias?.includes(option.name) ||\n              globalOption.alias?.some(alias => option.alias.includes(alias))\n          )\n      ) ?? []\n  );\n\n  return (\n    <>\n      {code`writeLine(colors.text.heading.secondary(\"Usage:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <hbr />\n      <hbr />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.text.heading.secondary(\"Options:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.text.heading.secondary(\"Commands:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"help.mjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","Usage","getAppBin","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","padding","app","_$createIntrinsic","HelpOptions","options","option","flags","names","name","length","push","alias","forEach","sort","join","kind","string","variadic","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","values","child","Help","filter","some","globalOption","includes","when","value","HelpInvoke","doubleHardline","joiner","ender","title","isVirtual"],"sources":["../../src/components/help.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { Usage } from \"@shell-shock/core/components/usage\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 2\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <For each={Object.keys(context.config.bin)} hardline>\n      {bin => (\n        <>\n          {code`\n      writeLine(\n        colors.text.body.primary(\"`}\n          <Usage bin={bin} command={command} />\n          {code`\"), { padding: ${theme.padding.app * indent} }\n      );`}\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n\nexport interface HelpOptionsProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={sortOptions(options)} hardline>\n        {option => {\n          const flags = [] as string[];\n          const names = [] as string[];\n          if (option.name.length === 1) {\n            flags.push(`-${option.name}`);\n          } else {\n            names.push(`--${kebabCase(option.name)}`);\n          }\n\n          option.alias.forEach((alias: string) => {\n            if (alias.length === 1) {\n              flags.push(`-${alias}`);\n            } else {\n              names.push(`--${kebabCase(alias)}`);\n            }\n          });\n\n          return code`[{ value: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default)}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n  const { commands } = props;\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={Object.values(commands)} hardline>\n        {child =>\n          code`[{ value: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function Help(props: HelpProps) {\n  const { command, indent = 1 } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(\n    () =>\n      Object.values(command.options).filter(\n        option =>\n          !context.options.some(\n            globalOption =>\n              globalOption.name === option.name ||\n              option.alias.includes(globalOption.name) ||\n              globalOption.alias?.includes(option.name) ||\n              globalOption.alias?.some(alias => option.alias.includes(alias))\n          )\n      ) ?? []\n  );\n\n  return (\n    <>\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <hbr />\n      <hbr />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n\nexport interface HelpInvokeProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function HelpInvoke(props: HelpInvokeProps) {\n  const { options, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`\n      writeLine(\"\");\n      banner();\n      writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      <Show when={Object.keys(commands).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(commands)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${\n                  child.isVirtual ? \"\" : \"Command\"\n                }\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <Help command={child} indent={2} />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} <specific command> --help') will provide additional information that is specific to that command.\");\n                  writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/index.cjs

@@ -1,5 +1,5 @@
+const require_components_banner_function_declaration = require('./banner-function-declaration.cjs');
 const require_components_bin_entry = require('./bin-entry.cjs');
-const require_components_args_parser_logic = require('./args-parser-logic.cjs');
 const require_components_help = require('./help.cjs');
 const require_components_command_router = require('./command-router.cjs');
 const require_components_virtual_command_entry = require('./virtual-command-entry.cjs');
@@ -8,7 +8,7 @@ const require_components_console_builtin = require('./console-builtin.cjs');
 const require_components_utils_builtin = require('./utils-builtin.cjs');
 
 exports.ArgsUtilities = require_components_utils_builtin.ArgsUtilities;
-exports.BannerFunctionDeclaration = require_components_console_builtin.BannerFunctionDeclaration;
+exports.BannerFunctionDeclaration = require_components_banner_function_declaration.BannerFunctionDeclaration;
 exports.BinEntry = require_components_bin_entry.BinEntry;
 exports.ColorSupportUtilities = require_components_utils_builtin.ColorSupportUtilities;
 exports.ColorsDeclaration = require_components_console_builtin.ColorsDeclaration;
@@ -23,21 +23,16 @@ exports.EnvSupportUtilities = require_components_utils_builtin.EnvSupportUtiliti
 exports.ExitFunctionDeclaration = require_components_utils_builtin.ExitFunctionDeclaration;
 exports.Help = require_components_help.Help;
 exports.HelpCommands = require_components_help.HelpCommands;
+exports.HelpInvoke = require_components_help.HelpInvoke;
 exports.HelpOptions = require_components_help.HelpOptions;
 exports.HelpUsage = require_components_help.HelpUsage;
 exports.HyperlinkSupportUtilities = require_components_utils_builtin.HyperlinkSupportUtilities;
 exports.LinkFunctionDeclaration = require_components_console_builtin.LinkFunctionDeclaration;
 exports.MessageFunctionDeclaration = require_components_console_builtin.MessageFunctionDeclaration;
-exports.OptionsInterfaceDeclaration = require_components_args_parser_logic.OptionsInterfaceDeclaration;
-exports.OptionsMember = require_components_args_parser_logic.OptionsMember;
-exports.OptionsMemberParserLogic = require_components_args_parser_logic.OptionsMemberParserLogic;
-exports.OptionsParserLogic = require_components_args_parser_logic.OptionsParserLogic;
-exports.ParamsParserLogic = require_components_args_parser_logic.ParamsParserLogic;
 exports.RunApplication = require_components_bin_entry.RunApplication;
 exports.StripAnsiFunctionDeclaration = require_components_console_builtin.StripAnsiFunctionDeclaration;
 exports.TableFunctionDeclaration = require_components_console_builtin.TableFunctionDeclaration;
 exports.UtilsBuiltin = require_components_utils_builtin.UtilsBuiltin;
-exports.VariablePathsParserLogic = require_components_args_parser_logic.VariablePathsParserLogic;
 exports.VirtualCommandEntry = require_components_virtual_command_entry.VirtualCommandEntry;
 exports.VirtualCommandHandlerDeclaration = require_components_virtual_command_entry.VirtualCommandHandlerDeclaration;
 exports.WrapAnsiFunction = require_components_console_builtin.WrapAnsiFunction;

package/dist/components/index.d.cts

@@ -1,9 +1,9 @@
-import { OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, VariablePathsParserLogic } from "./args-parser-logic.cjs";
+import { BannerFunctionDeclaration, BannerFunctionDeclarationProps } from "./banner-function-declaration.cjs";
 import { BinEntry, BinEntryProps, RunApplication } from "./bin-entry.cjs";
 import { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation } from "./command-entry.cjs";
 import { CommandRouter, CommandRouterProps, CommandRouterRoute } from "./command-router.cjs";
-import { BannerFunctionDeclaration, BannerFunctionDeclarationProps, ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.cjs";
-import { Help, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps } from "./help.cjs";
+import { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.cjs";
+import { Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps } from "./help.cjs";
 import { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
 import { VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration } from "./virtual-command-entry.cjs";
-export { ArgsUtilities, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BinEntry, BinEntryProps, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterProps, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, UtilsBuiltin, UtilsBuiltinProps, VariablePathsParserLogic, VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };
+export { ArgsUtilities, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BinEntry, BinEntryProps, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterProps, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, UtilsBuiltin, UtilsBuiltinProps, VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };

package/dist/components/index.d.mts

@@ -1,9 +1,9 @@
-import { OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, VariablePathsParserLogic } from "./args-parser-logic.mjs";
+import { BannerFunctionDeclaration, BannerFunctionDeclarationProps } from "./banner-function-declaration.mjs";
 import { BinEntry, BinEntryProps, RunApplication } from "./bin-entry.mjs";
 import { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation } from "./command-entry.mjs";
 import { CommandRouter, CommandRouterProps, CommandRouterRoute } from "./command-router.mjs";
-import { BannerFunctionDeclaration, BannerFunctionDeclarationProps, ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.mjs";
-import { Help, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps } from "./help.mjs";
+import { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.mjs";
+import { Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps } from "./help.mjs";
 import { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
 import { VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration } from "./virtual-command-entry.mjs";
-export { ArgsUtilities, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BinEntry, BinEntryProps, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterProps, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, UtilsBuiltin, UtilsBuiltinProps, VariablePathsParserLogic, VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };
+export { ArgsUtilities, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BinEntry, BinEntryProps, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterProps, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, UtilsBuiltin, UtilsBuiltinProps, VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };

package/dist/components/index.mjs

@@ -1,10 +1,10 @@
+import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
 import { BinEntry, RunApplication } from "./bin-entry.mjs";
-import { OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, VariablePathsParserLogic } from "./args-parser-logic.mjs";
-import { Help, HelpCommands, HelpOptions, HelpUsage } from "./help.mjs";
+import { Help, HelpCommands, HelpInvoke, HelpOptions, HelpUsage } from "./help.mjs";
 import { CommandRouter, CommandRouterRoute } from "./command-router.mjs";
 import { VirtualCommandEntry, VirtualCommandHandlerDeclaration } from "./virtual-command-entry.mjs";
 import { CommandEntry, CommandHandlerDeclaration, CommandInvocation } from "./command-entry.mjs";
-import { BannerFunctionDeclaration, ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, StripAnsiFunctionDeclaration, TableFunctionDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.mjs";
+import { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, StripAnsiFunctionDeclaration, TableFunctionDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.mjs";
 import { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin } from "./utils-builtin.mjs";
 
-export { ArgsUtilities, BannerFunctionDeclaration, BinEntry, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpOptions, HelpUsage, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, UtilsBuiltin, VariablePathsParserLogic, VirtualCommandEntry, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };
+export { ArgsUtilities, BannerFunctionDeclaration, BinEntry, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpInvoke, HelpOptions, HelpUsage, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, UtilsBuiltin, VirtualCommandEntry, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };

package/dist/components/utils-builtin.cjs

@@ -2,8 +2,8 @@ const require_rolldown_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 __alloy_js_typescript = require("@alloy-js/typescript");
-let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
 let defu = require("defu");
 defu = require_rolldown_runtime.__toESM(defu);
@@ -506,7 +506,7 @@ function ExitFunctionDeclaration() {
             }
 
             if (options.exception) {
-              error(\`A fatal error occured while running the application - please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team: \\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\`);
+              error(\`A fatal error occured while running the application - please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\`);
             }
 
             const terminate = (force = false) => {