@shell-shock/preset-script 0.2.0 → 0.3.0

package/dist/components/help.cjs

@@ -23,27 +23,26 @@ function HelpUsage(props) {
 			return Object.keys(context.config.bin);
 		},
 		hardline: true,
-		children: (bin) => __alloy_js_core.code`
+		children: (bin) => [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
       writeLine(
         colors.text.body.primary(
-          "$ ${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(" ")} [options]"
+          "$ 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", {})]
 	});
 }
 /**
 * A component that generates the options table display for a command.
 */
 function HelpOptions(props) {
-	const { command } = props;
+	const { options } = props;
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
 	return [
-		__alloy_js_core.code`table([
-      [{ value: colors.text.heading.tertiary("Name"), align: "right", border: { bottom: "secondary" } }, { value: colors.text.heading.tertiary("Description"), align: "left", border: { bottom: "secondary" } }], `,
+		__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_reflect.sortOptions)(Object.values(command.options));
+				return (0, __shell_shock_core_plugin_utils_reflect.sortOptions)(options);
 			},
 			hardline: true,
 			children: (option) => {
@@ -55,7 +54,7 @@ function HelpOptions(props) {
 					if (alias.length === 1) flags.push(`-${alias}`);
 					else names.push(`--${(0, __stryke_string_format_kebab_case.kebabCase)(alias)}`);
 				});
-				return __alloy_js_core.code`[{ value: \`\${colors.text.body.primary("${option.title}")} \${colors.text.body.secondary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.name)}>${option.variadic ? "..." : ""}` : option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.name)}>${option.variadic ? "..." : ""}` : ""}")}\`, align: "right" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default)}` : ""})` : ""}."), align: "left" }], `;
+				return __alloy_js_core.code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.name)}${option.variadic ? "..." : ""}>` : option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default)}` : ""})` : ""}."), align: "left", border: "none" }], `;
 			}
 		}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
@@ -66,17 +65,16 @@ function HelpOptions(props) {
 * A component that generates the commands table display for a command.
 */
 function HelpCommands(props) {
-	const { command } = props;
+	const { commands } = props;
 	return [
-		__alloy_js_core.code`table([
-        [{ value: colors.text.heading.tertiary("Name"), align: "right", border: { bottom: "secondary" } }, { value: colors.text.heading.tertiary("Description"), align: "left", border: { bottom: "secondary" } }], `,
+		__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(command.children);
+				return Object.values(commands);
 			},
 			hardline: true,
-			children: (child) => __alloy_js_core.code`[{ value: \`\${colors.text.body.primary("${child.title}")} \${colors.text.body.secondary("(${child.name})")}\`, align: "right" }, { value: colors.text.body.tertiary("${child.description.replace(/\.+$/, "")}"), align: "left" }], `
+			children: (child) => __alloy_js_core.code`[{ value: colors.text.body.primary("${child.name}"), align: "right", border: "none" }, { value: colors.text.body.tertiary("${child.description.replace(/\.+$/, "")}"), align: "left", border: "none" }], `
 		}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		__alloy_js_core.code` ]); `
@@ -88,9 +86,10 @@ function HelpCommands(props) {
 function Help(props) {
 	const { command, indent = 1 } = props;
 	const theme = require_contexts_theme.useTheme();
+	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("");
-      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.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,
@@ -98,12 +97,23 @@ function Help(props) {
 		}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(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} }` : ""});`),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, __alloy_js_core_jsx_runtime.createComponent)(HelpOptions, { command }),
-		(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 options.value.length > 0;
+			},
+			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} }` : ""});`),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(HelpOptions, { get options() {
+						return options.value;
+					} }),
+					(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(command.children).length > 0;
@@ -111,9 +121,11 @@ 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.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, { command }),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(HelpCommands, { get commands() {
+						return command.children;
+					} }),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 				];

package/dist/components/help.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.cjs","names":["code","For","Show","ReflectionKind","usePowerlines","getVariableCommandPathName","isVariableCommandPath","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","path","segments","map","segment","variables","variadic","join","padding","app","HelpOptions","_$createIntrinsic","values","options","option","flags","names","name","length","push","alias","forEach","title","sort","kind","string","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","child","Help","_$memo","when"],"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, 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 { CommandTree } 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        code`\n      writeLine(\n        colors.text.body.primary(\n          \"$ ${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(\" \")} [options]\"\n        ), { padding: ${theme.padding.app * indent} }\n      );`\n      }\n    </For>\n  );\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([\n      [{ value: colors.text.heading.tertiary(\"Name\"), align: \"right\", border: { bottom: \"secondary\" } }, { value: colors.text.heading.tertiary(\"Description\"), align: \"left\", border: { bottom: \"secondary\" } }], `}\n      <hbr />\n      <For each={sortOptions(Object.values(command.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            option.title\n          }\")} \\${colors.text.body.secondary(\"${\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\" }, { 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\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`table([\n        [{ value: colors.text.heading.tertiary(\"Name\"), align: \"right\", border: { bottom: \"secondary\" } }, { value: colors.text.heading.tertiary(\"Description\"), align: \"left\", border: { bottom: \"secondary\" } }], `}\n      <hbr />\n      <For each={Object.values(command.children)} hardline>\n        {child =>\n          code`[{ value: \\`\\${colors.text.body.primary(\"${\n            child.title\n          }\")} \\${colors.text.body.secondary(\"(${\n            child.name\n          })\")}\\`, align: \"right\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\" }], `\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\n  return (\n    <>\n      {code`writeLine(\"\");\n      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      {code`writeLine(\"\");\n      writeLine(colors.text.heading.secondary(\"OPTIONS:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpOptions command={command} />\n      <hbr />\n      <hbr />\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 command={command} />\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","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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"}

package/dist/components/help.d.cts

@@ -1,5 +1,5 @@
-import * as _alloy_js_core5 from "@alloy-js/core";
-import { CommandTree } from "@shell-shock/core/types/command";
+import * as _alloy_js_core7 from "@alloy-js/core";
+import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/help.d.ts
 interface HelpUsageProps {
@@ -20,19 +20,27 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core5.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core7.Children;
+interface HelpOptionsProps {
+  /**
+   * The options to display help for.
+   */
+  options: CommandOption[];
+}
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: {
-  command: CommandTree;
-}): _alloy_js_core5.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core7.Children;
+interface HelpCommandsProps {
+  /**
+   * A mapping of command names to their command definitions.
+   */
+  commands: Record<string, CommandTree>;
+}
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: {
-  command: CommandTree;
-}): _alloy_js_core5.Children;
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core7.Children;
 interface HelpProps {
   /**
    * The command to generate help for.
@@ -51,7 +59,7 @@ interface HelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function Help(props: HelpProps): _alloy_js_core5.Children;
+declare function Help(props: HelpProps): _alloy_js_core7.Children;
 //#endregion
-export { Help, HelpCommands, HelpOptions, HelpProps, HelpUsage, HelpUsageProps };
+export { Help, HelpCommands, HelpCommandsProps, 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":";;;;UAgCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA+BT;AAqEhB;AA0BA;AAoBA;;;;;;;;;;iBAlJgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;;;;iBA+B/B,WAAA;WAA8B;IAAW,eAAA,CAAE;;;;iBAqE3C,YAAA;WAA+B;IAAW,eAAA,CAAE;UA0B3C,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA"}
+{"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"}

package/dist/components/help.d.mts

@@ -1,5 +1,5 @@
-import * as _alloy_js_core7 from "@alloy-js/core";
-import { CommandTree } from "@shell-shock/core/types/command";
+import * as _alloy_js_core1 from "@alloy-js/core";
+import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/help.d.ts
 interface HelpUsageProps {
@@ -20,19 +20,27 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core7.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core1.Children;
+interface HelpOptionsProps {
+  /**
+   * The options to display help for.
+   */
+  options: CommandOption[];
+}
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: {
-  command: CommandTree;
-}): _alloy_js_core7.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core1.Children;
+interface HelpCommandsProps {
+  /**
+   * A mapping of command names to their command definitions.
+   */
+  commands: Record<string, CommandTree>;
+}
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: {
-  command: CommandTree;
-}): _alloy_js_core7.Children;
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core1.Children;
 interface HelpProps {
   /**
    * The command to generate help for.
@@ -51,7 +59,7 @@ interface HelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function Help(props: HelpProps): _alloy_js_core7.Children;
+declare function Help(props: HelpProps): _alloy_js_core1.Children;
 //#endregion
-export { Help, HelpCommands, HelpOptions, HelpProps, HelpUsage, HelpUsageProps };
+export { Help, HelpCommands, HelpCommandsProps, 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":";;;;UAgCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA+BT;AAqEhB;AA0BA;AAoBA;;;;;;;;;;iBAlJgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;;;;iBA+B/B,WAAA;WAA8B;IAAW,eAAA,CAAE;;;;iBAqE3C,YAAA;WAA+B;IAAW,eAAA,CAAE;UA0B3C,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA"}
+{"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"}

package/dist/components/help.mjs

@@ -1,7 +1,7 @@
 import { useTheme } from "../contexts/theme.mjs";
 import "../contexts/index.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
-import { For, Show, code } from "@alloy-js/core";
+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 { ReflectionKind } from "@powerlines/deepkit/vendor/type";
@@ -22,27 +22,26 @@ function HelpUsage(props) {
 			return Object.keys(context.config.bin);
 		},
 		hardline: true,
-		children: (bin) => code`
+		children: (bin) => [memo(() => code`
       writeLine(
         colors.text.body.primary(
-          "$ ${bin} ${command.path.segments.map((segment) => isVariableCommandPath(segment) ? `<${command.path.variables[segment]?.variadic ? "..." : ""}${kebabCase(getVariableCommandPathName(segment))}>` : segment).join(" ")} [options]"
+          "$ 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", {})]
 	});
 }
 /**
 * A component that generates the options table display for a command.
 */
 function HelpOptions(props) {
-	const { command } = props;
+	const { options } = props;
 	const context = usePowerlines();
 	return [
-		code`table([
-      [{ value: colors.text.heading.tertiary("Name"), align: "right", border: { bottom: "secondary" } }, { value: colors.text.heading.tertiary("Description"), align: "left", border: { bottom: "secondary" } }], `,
+		code`table([ `,
 		createIntrinsic("hbr", {}),
 		createComponent(For, {
 			get each() {
-				return sortOptions(Object.values(command.options));
+				return sortOptions(options);
 			},
 			hardline: true,
 			children: (option) => {
@@ -54,7 +53,7 @@ function HelpOptions(props) {
 					if (alias.length === 1) flags.push(`-${alias}`);
 					else names.push(`--${kebabCase(alias)}`);
 				});
-				return code`[{ value: \`\${colors.text.body.primary("${option.title}")} \${colors.text.body.secondary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === ReflectionKind.string ? ` <${snakeCase(option.name)}>${option.variadic ? "..." : ""}` : option.kind === ReflectionKind.number ? ` <${snakeCase(option.name)}>${option.variadic ? "..." : ""}` : ""}")}\`, align: "right" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default)}` : ""})` : ""}."), align: "left" }], `;
+				return code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === ReflectionKind.string ? ` <${snakeCase(option.name)}${option.variadic ? "..." : ""}>` : option.kind === ReflectionKind.number ? ` <${snakeCase(option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default)}` : ""})` : ""}."), align: "left", border: "none" }], `;
 			}
 		}),
 		createIntrinsic("hbr", {}),
@@ -65,17 +64,16 @@ function HelpOptions(props) {
 * A component that generates the commands table display for a command.
 */
 function HelpCommands(props) {
-	const { command } = props;
+	const { commands } = props;
 	return [
-		code`table([
-        [{ value: colors.text.heading.tertiary("Name"), align: "right", border: { bottom: "secondary" } }, { value: colors.text.heading.tertiary("Description"), align: "left", border: { bottom: "secondary" } }], `,
+		code`table([ `,
 		createIntrinsic("hbr", {}),
 		createComponent(For, {
 			get each() {
-				return Object.values(command.children);
+				return Object.values(commands);
 			},
 			hardline: true,
-			children: (child) => code`[{ value: \`\${colors.text.body.primary("${child.title}")} \${colors.text.body.secondary("(${child.name})")}\`, align: "right" }, { value: colors.text.body.tertiary("${child.description.replace(/\.+$/, "")}"), align: "left" }], `
+			children: (child) => code`[{ value: colors.text.body.primary("${child.name}"), align: "right", border: "none" }, { value: colors.text.body.tertiary("${child.description.replace(/\.+$/, "")}"), align: "left", border: "none" }], `
 		}),
 		createIntrinsic("hbr", {}),
 		code` ]); `
@@ -87,9 +85,10 @@ function HelpCommands(props) {
 function Help(props) {
 	const { command, indent = 1 } = props;
 	const theme = useTheme();
+	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("");
-      writeLine(colors.text.heading.secondary("USAGE:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+		memo(() => code`writeLine(colors.text.heading.secondary("Usage:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
 		createIntrinsic("hbr", {}),
 		createComponent(HelpUsage, {
 			command,
@@ -97,12 +96,23 @@ function Help(props) {
 		}),
 		createIntrinsic("hbr", {}),
 		createIntrinsic("hbr", {}),
-		memo(() => code`writeLine("");
-      writeLine(colors.text.heading.secondary("OPTIONS:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
-		createIntrinsic("hbr", {}),
-		createComponent(HelpOptions, { command }),
-		createIntrinsic("hbr", {}),
-		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			get when() {
+				return options.value.length > 0;
+			},
+			get children() {
+				return [
+					memo(() => code`writeLine("");
+      writeLine(colors.text.heading.secondary("Options:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+					createIntrinsic("hbr", {}),
+					createComponent(HelpOptions, { get options() {
+						return options.value;
+					} }),
+					createIntrinsic("hbr", {}),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
 		createComponent(Show, {
 			get when() {
 				return Object.keys(command.children).length > 0;
@@ -110,9 +120,11 @@ function Help(props) {
 			get children() {
 				return [
 					memo(() => code`writeLine("");
-      writeLine(colors.text.heading.secondary("COMMANDS:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+      writeLine(colors.text.heading.secondary("Commands:")${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
 					createIntrinsic("hbr", {}),
-					createComponent(HelpCommands, { command }),
+					createComponent(HelpCommands, { get commands() {
+						return command.children;
+					} }),
 					createIntrinsic("hbr", {}),
 					createIntrinsic("hbr", {})
 				];

package/dist/components/help.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.mjs","names":["code","For","Show","ReflectionKind","usePowerlines","getVariableCommandPathName","isVariableCommandPath","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","path","segments","map","segment","variables","variadic","join","padding","app","HelpOptions","_$createIntrinsic","values","options","option","flags","names","name","length","push","alias","forEach","title","sort","kind","string","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","child","Help","_$memo","when"],"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, 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 { CommandTree } 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        code`\n      writeLine(\n        colors.text.body.primary(\n          \"$ ${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(\" \")} [options]\"\n        ), { padding: ${theme.padding.app * indent} }\n      );`\n      }\n    </For>\n  );\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([\n      [{ value: colors.text.heading.tertiary(\"Name\"), align: \"right\", border: { bottom: \"secondary\" } }, { value: colors.text.heading.tertiary(\"Description\"), align: \"left\", border: { bottom: \"secondary\" } }], `}\n      <hbr />\n      <For each={sortOptions(Object.values(command.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            option.title\n          }\")} \\${colors.text.body.secondary(\"${\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\" }, { 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\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`table([\n        [{ value: colors.text.heading.tertiary(\"Name\"), align: \"right\", border: { bottom: \"secondary\" } }, { value: colors.text.heading.tertiary(\"Description\"), align: \"left\", border: { bottom: \"secondary\" } }], `}\n      <hbr />\n      <For each={Object.values(command.children)} hardline>\n        {child =>\n          code`[{ value: \\`\\${colors.text.body.primary(\"${\n            child.title\n          }\")} \\${colors.text.body.secondary(\"(${\n            child.name\n          })\")}\\`, align: \"right\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\" }], `\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\n  return (\n    <>\n      {code`writeLine(\"\");\n      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      {code`writeLine(\"\");\n      writeLine(colors.text.heading.secondary(\"OPTIONS:\")${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpOptions command={command} />\n      <hbr />\n      <hbr />\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 command={command} />\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","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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"}

package/dist/components/index.cjs

@@ -8,6 +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.BinEntry = require_components_bin_entry.BinEntry;
 exports.ColorSupportUtilities = require_components_utils_builtin.ColorSupportUtilities;
 exports.ColorsDeclaration = require_components_console_builtin.ColorsDeclaration;

package/dist/components/index.d.cts

@@ -2,8 +2,8 @@ import { OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, O
 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 { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.cjs";
-import { Help, HelpCommands, HelpOptions, HelpProps, HelpUsage, HelpUsageProps } from "./help.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 { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
 import { VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration } from "./virtual-command-entry.cjs";
-export { ArgsUtilities, BinEntry, BinEntryProps, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterProps, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpOptions, 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, 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 };

package/dist/components/index.d.mts

@@ -2,8 +2,8 @@ import { OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, O
 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 { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.mjs";
-import { Help, HelpCommands, HelpOptions, HelpProps, HelpUsage, HelpUsageProps } from "./help.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 { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
 import { VirtualCommandEntry, VirtualCommandEntryProps, VirtualCommandHandlerDeclaration } from "./virtual-command-entry.mjs";
-export { ArgsUtilities, BinEntry, BinEntryProps, ColorSupportUtilities, ColorsDeclaration, CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterProps, CommandRouterRoute, ConsoleBuiltin, DividerFunctionDeclaration, EnvSupportUtilities, ExitFunctionDeclaration, Help, HelpCommands, HelpOptions, 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, 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 };

package/dist/components/index.mjs

@@ -4,7 +4,7 @@ import { Help, HelpCommands, 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 { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, StripAnsiFunctionDeclaration, TableFunctionDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration } from "./console-builtin.mjs";
+import { BannerFunctionDeclaration, 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, 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, HelpOptions, HelpUsage, HyperlinkSupportUtilities, LinkFunctionDeclaration, MessageFunctionDeclaration, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserLogic, OptionsParserLogic, ParamsParserLogic, RunApplication, StripAnsiFunctionDeclaration, TableFunctionDeclaration, UtilsBuiltin, VariablePathsParserLogic, VirtualCommandEntry, VirtualCommandHandlerDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };