@shell-shock/preset-script 0.6.22 → 0.6.23

package/dist/components/command-entry.cjs

@@ -86,8 +86,8 @@ function CommandHandlerDeclaration(props) {
 				return [
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.CommandParserLogic, {
 						command,
-						get envPrefix() {
-							return context.config.envPrefix;
+						get appSpecificEnvPrefix() {
+							return context.config.appSpecificEnvPrefix;
 						},
 						get isCaseSensitive() {
 							return context.config.isCaseSensitive;

package/dist/components/command-entry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParameterKinds","IsDebug","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","args","length","arg","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","argument","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"sources":["../../src/components/command-entry.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree, NumberCommandParameter } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.args.length > 0\n            ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={(option as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === CommandParameterKinds.string ||\n                    argument.kind === CommandParameterKinds.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <IfStatement condition={code`failures.length > 0`}>\n        {code`error(\"The following validation failures were found while processing the user provided input, and must be corrected before the command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(\n    () =>\n      `./${replaceExtension(\n        relativePath(\n          joinPaths(context.entryPath, findFilePath(filePath.value)),\n          command.entry.input?.file || command.entry.file\n        )\n      )}`\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParameterKinds","IsDebug","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","args","length","arg","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","appSpecificEnvPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","argument","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"sources":["../../src/components/command-entry.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree, NumberCommandParameter } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.args.length > 0\n            ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={(option as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === CommandParameterKinds.string ||\n                    argument.kind === CommandParameterKinds.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <IfStatement condition={code`failures.length > 0`}>\n        {code`error(\"The following validation failures were found while processing the user provided input, and must be corrected before the command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(\n    () =>\n      `./${replaceExtension(\n        relativePath(\n          joinPaths(context.entryPath, findFilePath(filePath.value)),\n          command.entry.input?.file || command.entry.file\n        )\n      )}`\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-entry.mjs

@@ -84,8 +84,8 @@ function CommandHandlerDeclaration(props) {
 				return [
 					createComponent(CommandParserLogic, {
 						command,
-						get envPrefix() {
-							return context.config.envPrefix;
+						get appSpecificEnvPrefix() {
+							return context.config.appSpecificEnvPrefix;
 						},
 						get isCaseSensitive() {
 							return context.config.isCaseSensitive;

package/dist/components/command-entry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParameterKinds","IsDebug","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","args","length","arg","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","argument","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"sources":["../../src/components/command-entry.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree, NumberCommandParameter } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.args.length > 0\n            ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={(option as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === CommandParameterKinds.string ||\n                    argument.kind === CommandParameterKinds.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <IfStatement condition={code`failures.length > 0`}>\n        {code`error(\"The following validation failures were found while processing the user provided input, and must be corrected before the command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(\n    () =>\n      `./${replaceExtension(\n        relativePath(\n          joinPaths(context.entryPath, findFilePath(filePath.value)),\n          command.entry.input?.file || command.entry.file\n        )\n      )}`\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParameterKinds","IsDebug","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","args","length","arg","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","appSpecificEnvPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","argument","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"sources":["../../src/components/command-entry.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree, NumberCommandParameter } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.args.length > 0\n            ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={(option as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === CommandParameterKinds.string ||\n                    argument.kind === CommandParameterKinds.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <IfStatement condition={code`failures.length > 0`}>\n        {code`error(\"The following validation failures were found while processing the user provided input, and must be corrected before the command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(\n    () =>\n      `./${replaceExtension(\n        relativePath(\n          joinPaths(context.entryPath, findFilePath(filePath.value)),\n          command.entry.input?.file || command.entry.file\n        )\n      )}`\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/help.cjs

@@ -67,7 +67,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("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === __shell_shock_core.CommandParameterKinds.string ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === __shell_shock_core.CommandParameterKinds.number ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: 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).replace(/"/g, "\\\"")}` : ""})` : ""}."), align: "left", border: "none" }], `;
+				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 === __shell_shock_core.CommandParameterKinds.string ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === __shell_shock_core.CommandParameterKinds.number ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: colors.text.body.tertiary(\`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(option.description).replace(/\.+$/, "").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}.\`), align: "left", border: "none" }], `;
 			}
 		}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
@@ -87,7 +87,7 @@ function HelpCommands(props) {
 				return Object.values(commands);
 			},
 			hardline: true,
-			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" }], `
+			children: (child) => __alloy_js_core.code`[{ value: colors.text.body.primary("${child.name}"), align: "right", border: "none" }, { value: colors.text.body.tertiary(\`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(child.description).replace(/\.+$/, "").trim()}.\`), align: "left", border: "none" }], `
 		}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		__alloy_js_core.code` ]); `
@@ -179,7 +179,7 @@ function VirtualHelp(props) {
 							(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
                 writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon}  " : "") + ` : ""}"${child.title} ${child.isVirtual ? "" : "Command"}"));
                 writeLine("");
-                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine(colors.text.body.secondary(splitText(\`${(0, __shell_shock_core_plugin_utils.formatDescription)(child.description).replace(/\.+$/, "").trim()}.\`)));
                 writeLine("");
                 `),
 							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
@@ -234,7 +234,7 @@ function CommandHelp(props) {
 							(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
                 writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon}  " : "") + ` : ""}"${child.title} ${child.isVirtual ? "" : "Command"}"));
                 writeLine("");
-                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine(colors.text.body.secondary(splitText(\`${(0, __shell_shock_core_plugin_utils.formatDescription)(child.description).replace(/\.+$/, "").trim()}.\`)));
                 writeLine("");
                 `),
 							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),

package/dist/components/help.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.cjs","names":["code","computed","For","Show","Spacing","usePowerlines","CommandParameterKinds","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","useTheme","kebabCase","snakeCase","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","args","arg","kind","string","number","choices","format","name","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"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 { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\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    <>\n      <For each={Object.keys(context.config.bin)} hardline>\n        {bin => (\n          <>\n            {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n            <hbr />\n          </>\n        )}\n      </For>\n      <Show when={command.args.length > 0}>\n        <hbr />\n        <For each={Object.keys(context.config.bin)} hardline>\n          {bin => (\n            <>\n              {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n              <hbr />\n            </>\n          )}\n        </For>\n      </Show>\n    </>\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 === CommandParameterKinds.string\n              ? ` <${snakeCase(\n                  option.choices && option.choices.length > 0\n                    ? option.choices.join(\"|\")\n                    : option.format\n                      ? option.format\n                      : option.name\n                )}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === CommandParameterKinds.number\n                ? ` <${snakeCase(\n                    option.choices && option.choices.length > 0\n                      ? option.choices.join(\"|\")\n                      : option.name\n                  )}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { 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).replace(/\"/g, '\\\\\"')}`\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 BaseHelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * Whether to filter out global options from the help display.\n   *\n   * @remarks\n   * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n   *\n   * @defaultValue false\n   */\n  filterGlobalOptions?: boolean;\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 BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\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      : Object.values(command.options)\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      <Spacing />\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 VirtualHelpProps {\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   * The command path to generate help for, used for generating the help invocation instructions.\n   *\n   * @remarks\n   * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n   */\n  segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, segments, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\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(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n        } <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n\nexport interface CommandHelpProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.segments.join(\n          \" \"\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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"}
+{"version":3,"file":"help.cjs","names":["code","computed","For","Show","Spacing","usePowerlines","CommandParameterKinds","formatDescription","formatShortDescription","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","useTheme","kebabCase","snakeCase","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","args","arg","kind","string","number","choices","format","name","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","trim","env","default","undefined","appSpecificEnvPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"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 { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n  formatDescription,\n  formatShortDescription,\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\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    <>\n      <For each={Object.keys(context.config.bin)} hardline>\n        {bin => (\n          <>\n            {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n            <hbr />\n          </>\n        )}\n      </For>\n      <Show when={command.args.length > 0}>\n        <hbr />\n        <For each={Object.keys(context.config.bin)} hardline>\n          {bin => (\n            <>\n              {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n              <hbr />\n            </>\n          )}\n        </For>\n      </Show>\n    </>\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 === CommandParameterKinds.string\n              ? ` <${snakeCase(\n                  option.choices && option.choices.length > 0\n                    ? option.choices.join(\"|\")\n                    : option.format\n                      ? option.format\n                      : option.name\n                )}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === CommandParameterKinds.number\n                ? ` <${snakeCase(\n                    option.choices && option.choices.length > 0\n                      ? option.choices.join(\"|\")\n                      : option.name\n                  )}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(\n            option.description\n          )\n            .replace(/\\.+$/, \"\")\n            .trim()}${\n            option.env || option.default !== undefined\n              ? ` (${\n                  option.env\n                    ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default).replace(/\"/g, '\\\\\"')}`\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(\\`${formatShortDescription(\n            child.description\n          )\n            .replace(/\\.+$/, \"\")\n            .trim()}.\\`), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface BaseHelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * Whether to filter out global options from the help display.\n   *\n   * @remarks\n   * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n   *\n   * @defaultValue false\n   */\n  filterGlobalOptions?: boolean;\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 BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\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      : Object.values(command.options)\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      <Spacing />\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 VirtualHelpProps {\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   * The command path to generate help for, used for generating the help invocation instructions.\n   *\n   * @remarks\n   * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n   */\n  segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, segments, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\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(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(\n                  child.description\n                )\n                  .replace(/\\.+$/, \"\")\n                  .trim()}.\\`)));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n        } <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n\nexport interface CommandHelpProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(\n                  child.description\n                )\n                  .replace(/\\.+$/, \"\")\n                  .trim()}.\\`)));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.segments.join(\n          \" \"\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.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAkCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiHR;AAUjB;AAyEA;AAUA;AAuBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAoDA;AAUgB,iBA7YA,SAAA,CA6YmB,KAAA,EA7YF,cA6YkB,CAAA,EA7YJ,eAAA,CAAA,QA6YI;UA5RlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAyElC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAoDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}
+{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAoCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiHR;AAUjB;AA0EA;AAUA;AAwBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAwDA;AAUgB,iBAnZA,SAAA,CAmZmB,KAAA,EAnZF,cAmZkB,CAAA,EAnZJ,eAAA,CAAA,QAmZI;UAlSlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA0ElC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAwBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAkCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiHR;AAUjB;AAyEA;AAUA;AAuBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAoDA;AAUgB,iBA7YA,SAAA,CA6YmB,KAAA,EA7YF,cA6YkB,CAAA,EA7YJ,eAAA,CAAA,QA6YI;UA5RlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAyElC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAoDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAoCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiHR;AAUjB;AA0EA;AAUA;AAwBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAwDA;AAUgB,iBAnZA,SAAA,CAmZmB,KAAA,EAnZF,cAmZkB,CAAA,EAnZJ,eAAA,CAAA,QAmZI;UAlSlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA0ElC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAwBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}

package/dist/components/help.mjs

@@ -2,7 +2,7 @@ import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runti
 import { For, Show, code, computed } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from "@shell-shock/core/plugin-utils";
+import { formatDescription, formatShortDescription, getAppBin, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from "@shell-shock/core/plugin-utils";
 import { useTheme } from "@shell-shock/plugin-theme/contexts/theme";
 import { CommandParameterKinds } from "@shell-shock/core";
 import { kebabCase } from "@stryke/string-format/kebab-case";
@@ -66,7 +66,7 @@ function HelpOptions(props) {
 					if (alias.length === 1) flags.push(`-${alias}`);
 					else names.push(`--${kebabCase(alias)}`);
 				});
-				return code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { 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).replace(/"/g, "\\\"")}` : ""})` : ""}."), align: "left", border: "none" }], `;
+				return code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: colors.text.body.tertiary(\`${formatShortDescription(option.description).replace(/\.+$/, "").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}.\`), align: "left", border: "none" }], `;
 			}
 		}),
 		createIntrinsic("hbr", {}),
@@ -86,7 +86,7 @@ function HelpCommands(props) {
 				return Object.values(commands);
 			},
 			hardline: true,
-			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" }], `
+			children: (child) => code`[{ value: colors.text.body.primary("${child.name}"), align: "right", border: "none" }, { value: colors.text.body.tertiary(\`${formatShortDescription(child.description).replace(/\.+$/, "").trim()}.\`), align: "left", border: "none" }], `
 		}),
 		createIntrinsic("hbr", {}),
 		code` ]); `
@@ -178,7 +178,7 @@ function VirtualHelp(props) {
 							memo(() => code`
                 writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon}  " : "") + ` : ""}"${child.title} ${child.isVirtual ? "" : "Command"}"));
                 writeLine("");
-                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine(colors.text.body.secondary(splitText(\`${formatDescription(child.description).replace(/\.+$/, "").trim()}.\`)));
                 writeLine("");
                 `),
 							createIntrinsic("hbr", {}),
@@ -233,7 +233,7 @@ function CommandHelp(props) {
 							memo(() => code`
                 writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon}  " : "") + ` : ""}"${child.title} ${child.isVirtual ? "" : "Command"}"));
                 writeLine("");
-                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine(colors.text.body.secondary(splitText(\`${formatDescription(child.description).replace(/\.+$/, "").trim()}.\`)));
                 writeLine("");
                 `),
 							createIntrinsic("hbr", {}),

package/dist/components/help.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.mjs","names":["code","computed","For","Show","Spacing","usePowerlines","CommandParameterKinds","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","useTheme","kebabCase","snakeCase","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","args","arg","kind","string","number","choices","format","name","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"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 { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\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    <>\n      <For each={Object.keys(context.config.bin)} hardline>\n        {bin => (\n          <>\n            {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n            <hbr />\n          </>\n        )}\n      </For>\n      <Show when={command.args.length > 0}>\n        <hbr />\n        <For each={Object.keys(context.config.bin)} hardline>\n          {bin => (\n            <>\n              {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n              <hbr />\n            </>\n          )}\n        </For>\n      </Show>\n    </>\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 === CommandParameterKinds.string\n              ? ` <${snakeCase(\n                  option.choices && option.choices.length > 0\n                    ? option.choices.join(\"|\")\n                    : option.format\n                      ? option.format\n                      : option.name\n                )}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === CommandParameterKinds.number\n                ? ` <${snakeCase(\n                    option.choices && option.choices.length > 0\n                      ? option.choices.join(\"|\")\n                      : option.name\n                  )}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { 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).replace(/\"/g, '\\\\\"')}`\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 BaseHelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * Whether to filter out global options from the help display.\n   *\n   * @remarks\n   * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n   *\n   * @defaultValue false\n   */\n  filterGlobalOptions?: boolean;\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 BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\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      : Object.values(command.options)\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      <Spacing />\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 VirtualHelpProps {\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   * The command path to generate help for, used for generating the help invocation instructions.\n   *\n   * @remarks\n   * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n   */\n  segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, segments, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\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(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n        } <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n\nexport interface CommandHelpProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.segments.join(\n          \" \"\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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"}
+{"version":3,"file":"help.mjs","names":["code","computed","For","Show","Spacing","usePowerlines","CommandParameterKinds","formatDescription","formatShortDescription","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","useTheme","kebabCase","snakeCase","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","args","arg","kind","string","number","choices","format","name","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","trim","env","default","undefined","appSpecificEnvPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"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 { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n  formatDescription,\n  formatShortDescription,\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\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    <>\n      <For each={Object.keys(context.config.bin)} hardline>\n        {bin => (\n          <>\n            {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n            <hbr />\n          </>\n        )}\n      </For>\n      <Show when={command.args.length > 0}>\n        <hbr />\n        <For each={Object.keys(context.config.bin)} hardline>\n          {bin => (\n            <>\n              {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n              <hbr />\n            </>\n          )}\n        </For>\n      </Show>\n    </>\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 === CommandParameterKinds.string\n              ? ` <${snakeCase(\n                  option.choices && option.choices.length > 0\n                    ? option.choices.join(\"|\")\n                    : option.format\n                      ? option.format\n                      : option.name\n                )}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === CommandParameterKinds.number\n                ? ` <${snakeCase(\n                    option.choices && option.choices.length > 0\n                      ? option.choices.join(\"|\")\n                      : option.name\n                  )}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(\n            option.description\n          )\n            .replace(/\\.+$/, \"\")\n            .trim()}${\n            option.env || option.default !== undefined\n              ? ` (${\n                  option.env\n                    ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default).replace(/\"/g, '\\\\\"')}`\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(\\`${formatShortDescription(\n            child.description\n          )\n            .replace(/\\.+$/, \"\")\n            .trim()}.\\`), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface BaseHelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * Whether to filter out global options from the help display.\n   *\n   * @remarks\n   * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n   *\n   * @defaultValue false\n   */\n  filterGlobalOptions?: boolean;\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 BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\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      : Object.values(command.options)\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      <Spacing />\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 VirtualHelpProps {\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   * The command path to generate help for, used for generating the help invocation instructions.\n   *\n   * @remarks\n   * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n   */\n  segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, segments, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\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(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(\n                  child.description\n                )\n                  .replace(/\\.+$/, \"\")\n                  .trim()}.\\`)));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n        } <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n\nexport interface CommandHelpProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(\n                  child.description\n                )\n                  .replace(/\\.+$/, \"\")\n                  .trim()}.\\`)));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.segments.join(\n          \" \"\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/types/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;UAmCiB,mBAAA,SACP,KAAK,4BAA4B,QAAQ;;AADnD;;;;;;;;;;EAmBY,cAAA,CAAA,EALN,aAK4B,EAAA,GAAA,CAAA,CAAG,OAAA,EAJpB,OAIiC,EAAA,KAAA,EAJjB,WAIoC,EAAA,GAJpB,aAIoB,EAAA,CAAA,GAAA,KAAA;AAErE;AAAyC,KAF7B,sBAAA,GAAyB,UAEI,GAFS,mBAET;AACzB,KADJ,0BAAA,GAA6B,cACzB,GAAd,QAAc,CAAL,IAAK,CAAA,mBAAA,EAAA,OAAA,CAAA,CAAA,GACd,yBADc;AAAL,KAGC,mBAHD,CAAA,wBAIe,0BAJf,GAKP,0BALO,CAAA,GAMP,kBANO,CAMY,eANZ,CAAA,GAOT,kBAPS,CAOU,eAPV,CAAA,GAQT,OARS,CAQD,eARC,CAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;UAmCiB,mBAAA,SACP,KAAK,4BAA4B,QAAQ;;AADnD;;;;;;;;;;EAmBY,cAAA,CAAA,EALN,aAK4B,EAAA,GAAA,CAAG,CAAA,OAAA,EAJpB,OAIiC,EAAA,KAAA,EAJjB,WAIoC,EAAA,GAJpB,aAIoB,EAAA,CAAA,GAAA,KAAA;AAErE;AAAyC,KAF7B,sBAAA,GAAyB,UAEI,GAFS,mBAET;AACzB,KADJ,0BAAA,GAA6B,cACzB,GAAd,QAAc,CAAL,IAAK,CAAA,mBAAA,EAAA,OAAA,CAAA,CAAA,GACd,yBADc;AAAL,KAGC,mBAHD,CAAA,wBAIe,0BAJf,GAKP,0BALO,CAAA,GAMP,kBANO,CAMY,eANZ,CAAA,GAOT,kBAPS,CAOU,eAPV,CAAA,GAQT,OARS,CAQD,eARC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-script",
-  "version": "0.6.22",
+  "version": "0.6.23",
   "private": false,
   "description": "A Shell Shock preset that generates a fully-featured script application.",
   "keywords": [
@@ -226,9 +226,9 @@
     "@powerlines/deepkit": "^0.6.90",
     "@powerlines/plugin-alloy": "^0.24.2",
     "@powerlines/plugin-plugin": "^0.12.262",
-    "@shell-shock/core": "^0.11.0",
-    "@shell-shock/plugin-console": "^0.1.7",
-    "@shell-shock/plugin-theme": "^0.3.11",
+    "@shell-shock/core": "^0.12.0",
+    "@shell-shock/plugin-console": "^0.1.8",
+    "@shell-shock/plugin-theme": "^0.3.12",
     "@stryke/helpers": "^0.9.48",
     "@stryke/path": "^0.26.12",
     "@stryke/string-format": "^0.14.8",
@@ -241,5 +241,5 @@
     "@types/node": "^25.3.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "6fbda1ffc234bdd12b5d0fd0a32e59727b369c5c"
+  "gitHead": "c38d304433a296936fb8ca58aa138a0039918931"
 }