@shell-shock/preset-script 0.6.3 → 0.6.5

package/dist/components/command-entry.cjs

@@ -6,6 +6,7 @@ const require_components_virtual_command_entry = require('./virtual-command-entr
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __alloy_js_typescript = require("@alloy-js/typescript");
+let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
 let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
@@ -32,8 +33,7 @@ function CommandInvocation(props) {
 				return __alloy_js_core.code`{ path: \`${command.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? `\${${(0, __stryke_string_format_camel_case.camelCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))}}` : segment).join("/")}\`, segments: [${command.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? (0, __stryke_string_format_camel_case.camelCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment)) : `"${segment}"`).join(", ")}] }`;
 			}
 		}),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
 
       return internal_commandContext.run(__context, () => {
@@ -48,12 +48,11 @@ function CommandInvocation(props) {
 * A component that generates the `handler` function declaration for a command.
 */
 function CommandHandlerDeclaration(props) {
-	const { command, children } = props;
+	const { command, banner, children } = props;
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
 	return [
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
 			get heading() {
 				return `The ${command.title} (${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} ${command.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? `[${(0, __stryke_string_format_constant_case.constantCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))}]` : segment).join(" ")}) command.`;
@@ -96,8 +95,12 @@ function CommandHandlerDeclaration(props) {
 					}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					__alloy_js_core.code`writeLine("");
-        banner(); `,
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						get when() {
+							return Boolean(banner);
+						},
+						children: banner
+					}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
@@ -105,10 +108,8 @@ function CommandHandlerDeclaration(props) {
 							return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_helpers.IsDebug, {});
 						},
 						get children() {
-							return __alloy_js_core.code`
+							return __alloy_js_core.code`writeLine("");
           writeLine(colors.text.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
-
-          writeLine("");
           debug(\`Command path: ${command.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? `\${${(0, __stryke_string_format_camel_case.camelCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${(0, __stryke_string_format_kebab_case.kebabCase)(option.name)}: \${options.${(0, __stryke_string_format_camel_case.camelCase)(option.name)} === undefined ? "" : JSON.stringify(options.${(0, __stryke_string_format_camel_case.camelCase)(option.name)})}`).join("\\n")}${command.arguments.length > 0 ? ` \\n\\nArguments: \\n${command.arguments.map((argument) => ` - ${(0, __stryke_string_format_kebab_case.kebabCase)(argument.name)}: \${${(0, __stryke_string_format_camel_case.camelCase)(argument.name)} === undefined ? "" : JSON.stringify(${(0, __stryke_string_format_camel_case.camelCase)(argument.name)})}`).join("\\n")}` : ""}\`);
           writeLine(""); `;
 						}
@@ -210,8 +211,7 @@ function CommandValidationLogic(props) {
 				}
 			})]
 		}),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
 			get each() {
 				return command.arguments;
@@ -343,6 +343,7 @@ function CommandEntry(props) {
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(CommandHandlerDeclaration, {
 					command,
+					banner: __alloy_js_core.code`banner(); `,
 					get children() {
 						return (0, __alloy_js_core_jsx_runtime.createComponent)(CommandValidationLogic, { command });
 					}

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","ReflectionKind","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","IsDebug","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$createIntrinsic","_$memo","arguments","length","argument","CommandHandlerDeclaration","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","when","optional","includes","kind","string","number","variadic","fallback","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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\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 {\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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { IsDebug } from \"./helpers\";\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      <hbr />\n      <hbr />\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.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\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, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <hbr />\n      <hbr />\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        {code`writeLine(\"\");\n        banner(); `}\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n\n          writeLine(\"\");\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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.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 === ReflectionKind.string ||\n                    option.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).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      <hbr />\n      <hbr />\n      <For each={command.arguments} 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 === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).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    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}>\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":";;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgBkC,kBAAkBC,OAAiC;CACjE,MAAM,EAAEC,YAAYD;AAEpB,QAAA;mDAEK3B,sCAAc;GACb8B,MAAI;GAAA,IACJC,cAAW;AAAA,WAAEvC,oBAAI,aAAaoC,QAAQI,SACnCC,KAAIC,sFACkBA,QAAQ,GACzB,sIAA0CA,QAAQ,CAAC,CAAA,KACnDA,QACL,CACAC,KAAK,IAAI,CAAA,iBAAkBP,QAAQI,SACnCC,KAAIC,sFACkBA,QAAQ,mIACWA,QAAQ,CAAC,GAC7C,IAAIA,QAAO,GAChB,CACAC,KAAK,KAAK,CAAA;;GAAK,CAAA;mDAAA,OAAA,EAAA,CAAA;mDAAA,OAAA,EAAA,CAAA;8CAInB3C,oBAAI;;;wGAIDoC,QAAQE,KACT,CAAA,uBACCF,QAAQU,UAAUC,SAAS,IACvB,KAAKX,QAAQU,UACVL,KAAIO,8DAAsBA,SAASV,KAAK,CAAC,CACzCK,KAAK,KAAK,KACb,GAAE;;;QAIT;mDAAA,OAAA,EAAA,CAAA;EAAA;;;;;AAcP,SAAgBM,0BACdd,OACA;CACA,MAAM,EAAEC,SAASc,aAAaf;CAE9B,MAAMgB,8EAA8C;AAEpD,QAAA;mDAEKlC,gFAA2B,EAAUmB,SAAO,CAAA;mDAAA,OAAA,EAAA,CAAA;mDAAA,OAAA,EAAA,CAAA;mDAG5CxB,6DAAK;GAAA,IACJwC,UAAO;AAAA,WAAE,OAAOhB,QAAQiB,MAAK,mEAAeF,QAAQ,CAAA,GAAIf,QAAQI,SAC7DC,KAAIC,sFACkBA,QAAQ,GACzB,0IAA2CA,QAAQ,CAAC,CAAA,KACpDA,QACL,CACAC,KAAK,IAAI,CAAA;;GAAY,IAAAO,WAAA;AAAA,WAAA;sDACvBpC,oEAAY,EAAA,IAAAoC,WAAA;AAAA,aAAE,GAAGd,QAAQkB,YAAYC,QAAQ,QAAQ,GAAG,CAAA;QAAG,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAE3DxC,kEAAU,EAAA,IAAAmC,WAAA;AAAA,aAAEd,QAAQiB;QAAK,CAAA;sDACzBxC,kEAAU;MAACyB,MAAI;MAAAY,UAAS;MAAmD,CAAA;KAAA;;GAAA,CAAA;mDAE7E5C,2CAAmB;GAAA,UAAA;GAElBkD,OAAK;GACLlB,MAAI;GACJmB,YAAY,CAAC;IAAEnB,MAAM;IAAQoB,MAAM;IAAYC,SAAS;IAAa,CAAC;GAAA,IAAAT,WAAA;AAAA,WAAA;sDACrElC,uEAAkB;MACRoB;MAAO,IAChBwB,YAAS;AAAA,cAAET,QAAQU,OAAOD;;MAAS,IACnCE,kBAAe;AAAA,cAAEX,QAAQU,OAAOC;;MAAe,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;KAIhD9D,oBAAI;;sDACM,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGVO,mCAAW;MAAA,IAACwD,YAAS;AAAA,+DAAG/B,oCAAO,EAAA,CAAA;;MAAA,IAAAkB,WAAA;AAAA,cAC7BlD,oBAAI;;;;kCAImBoC,QAAQI,SAC7BC,KAAIC,sFACkBA,QAAQ,GACzB,sIAA0CA,QAAQ,CAAC,CAAA,KACnDA,QACL,CACAC,KAAK,MAAM,CAAA,qBAAsBqB,OAAOC,OAAO7B,QAAQ8B,QAAQ,CAC/DzB,KACC0B,WACE,uDAAgBA,OAAO7B,KAAK,CAAA,gEAC1B6B,OAAO7B,KACR,CAAA,gGACC6B,OAAO7B,KACR,CAAA,IACJ,CACAK,KAAK,MAAM,GACZP,QAAQU,UAAUC,SAAS,IACvB,wBAAwBX,QAAQU,UAC7BL,KACCO,aACE,uDAAgBA,SAASV,KAAK,CAAA,wDAC5BU,SAASV,KACV,CAAA,wFACCU,SAASV,KACV,CAAA,IACJ,CACAK,KAAK,MAAM,KACd,GAAE;;;MAEQ,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;KAIjBO;sDAAQ,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGR3C,mCAAW;MAACwD,WAAW/D,oBAAI;MAAc,IAAAkD,WAAA;AAAA,+DACvCnB,qCAAW,EAAUK,SAAO,CAAA;;MAAA,CAAA;sDAE9BhC,kCAAU,EAAA,IAAA8C,WAAA;AAAA,aAAA,kDAAA,OAAA,EAAA,CAAA,mDAERhB,mBAAiB,EAAUE,SAAO,CAAA,CAAA;QAAA,CAAA;KAAA;;GAAA,CAAA;EAAA;;;;;AAc7C,SAAgBgC,uBAAuBjC,OAAoC;CACzE,MAAM,EAAEC,YAAYD;AAEpB,QAAA;mDAEK3B,sCAAc;GAAC8B,MAAI;GAAYoB,MAAI;GAAYnB,aAAavC,oBAAI;GAAK,CAAA;mDAAA,OAAA,EAAA,CAAA;mDAErEE,qBAAG;GAAA,IAACmE,OAAI;AAAA,WAAEL,OAAOC,OAAO7B,QAAQ8B,WAAW,EAAE,CAAC;;GAAEI,gBAAc;GAAApB,WAC5DiB,WAAM,kDAEFhE,sBAAI;IAAA,IAACoE,OAAI;AAAA,YAAE,CAACJ,OAAOK;;IAAQ,IAAAtB,WAAA;AAAA,YAAA,kDACzB3C,mCAAW;MAAA,IACVwD,YAAS;AAAA,cAAE/D,oBAAI,WACbmE,OAAO7B,KAAKmC,SAAS,IAAI,GACrB,KAAKN,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK;;MAC9B,IAAAY,WAAA;AAAA,cACDlD,oBAAI,sCAAsCmE,OAAO7B,KAAI;;MAAe,CAAA,mDAEtEnC,sBAAI;MAAA,IACHoE,OAAI;AAAA,eACDJ,OAAOO,SAASjE,gDAAekE,UAC9BR,OAAOO,SAASjE,gDAAemE,WACjCT,OAAOU;;MAAQ,IAAA3B,WAAA;AAAA,+DAEhB7C,oCAAY;QAAA,IACX0D,YAAS;AAAA,gBAAE/D,oBAAI,UACbmE,OAAO7B,KAAKmC,SAAS,IAAI,GACrB,KAAKN,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE;;QACnB,IAAAY,WAAA;AAAA,gBACdlD,oBAAI,6DACHmE,OAAO7B,KAAI;;QACQ,CAAA;;MAAA,CAAA,CAAA;;IAAA,CAAA,mDAI1BnC,sBAAI;IAAA,IAACoE,OAAI;AAAA,YAAEJ,OAAOO,SAASjE,gDAAemE;;IAAM,IAAA1B,WAAA;AAAA,6DAC9C/C,sBAAI;MAAA,IACHoE,OAAI;AAAA,cAAGJ,OAA+BU;;MAAQ,IAC9CC,WAAQ;AAAA,+DACLvE,mCAAW;QAAA,IACVwD,YAAS;AAAA,gBAAE/D,oBAAI,UACbmE,OAAO7B,KAAKmC,SAAS,IAAI,GACrB,KAAKN,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE,0BAEhC6B,OAAO7B,KAAKmC,SAAS,IAAI,GACrB,KAAKN,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE;;QAC/B,IAAAY,WAAA;AAAA,gBACFlD,oBAAI,4DACHmE,OAAO7B,KAAI;;QACE,CAAA;;MAAA,IAAAY,WAAA;AAAA,+DAGlB3C,mCAAW;QAAA,IACVwD,YAAS;AAAA,gBAAE/D,oBAAI,UACbmE,OAAO7B,KAAKmC,SAAS,IAAI,GACrB,KAAKN,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE;;QACG,IAAAY,WAAA;AAAA,gBACpClD,oBAAI,2DACHmE,OAAO7B,KAAI;;QACQ,CAAA;;MAAA,CAAA;;IAAA,CAAA,CAAA;GAK9B,CAAA;mDAAA,OAAA,EAAA,CAAA;mDAAA,OAAA,EAAA,CAAA;mDAIFpC,qBAAG;GAAA,IAACmE,OAAI;AAAA,WAAEjC,QAAQU;;GAAWwB,gBAAc;GAAApB,WACzCF,aAAQ,kDAEJ7C,sBAAI;IAAA,IAACoE,OAAI;AAAA,YAAE,CAACvB,SAASwB;;IAAQ,IAAAtB,WAAA;AAAA,YAAA,kDAC3B3C,mCAAW;MAAA,IAACwD,YAAS;AAAA,cAAE/D,oBAAI,qDAAcgD,SAASV,KAAK;;MAAE,IAAAY,WAAA;AAAA,cACvDlD,oBAAI,sCACHgD,SAASV,KAAI;;MACa,CAAA,mDAE7BnC,sBAAI;MAAA,IACHoE,OAAI;AAAA,eACDvB,SAAS0B,SAASjE,gDAAekE,UAChC3B,SAAS0B,SAASjE,gDAAemE,WACnC5B,SAAS6B;;MAAQ,IAAA3B,WAAA;AAAA,+DAElB7C,oCAAY;QAAA,IACX0D,YAAS;AAAA,gBAAE/D,oBAAI,oDAAagD,SAASV,KAAK,CAAA;;QAAe,IAAAY,WAAA;AAAA,gBACxDlD,oBAAI,6DACHgD,SAASV,KAAI;;QACmB,CAAA;;MAAA,CAAA,CAAA;;IAAA,CAAA,mDAIvCnC,sBAAI;IAAA,IAACoE,OAAI;AAAA,YAAEvB,SAAS0B,SAASjE,gDAAemE;;IAAM,IAAA1B,WAAA;AAAA,6DAChD/C,sBAAI;MAAA,IACHoE,OAAI;AAAA,cAAGvB,SAAmC6B;;MAAQ,IAClDC,WAAQ;AAAA,+DACLvE,mCAAW;QAAA,IACVwD,YAAS;AAAA,gBAAE/D,oBAAI,oDACbgD,SAASV,KACV,CAAA,oEAA8BU,SAASV,KAAK,CAAA;;QAAG,IAAAY,WAAA;AAAA,gBAC/ClD,oBAAI,4DACHgD,SAASV,KAAI;;QACa,CAAA;;MAAA,IAAAY,WAAA;AAAA,+DAG/B3C,mCAAW;QAAA,IACVwD,YAAS;AAAA,gBAAE/D,oBAAI,oDAAagD,SAASV,KAAK,CAAA;;QAAqC,IAAAY,WAAA;AAAA,gBAC9ElD,oBAAI,2DACHgD,SAASV,KAAI;;QACmB,CAAA;;MAAA,CAAA;;IAAA,CAAA,CAAA;GAK3C,CAAA;mDAEF/B,mCAAW;GAACwD,WAAW/D,oBAAI;GAAqBkD,UAC9ClD,oBAAI;;GACiB,CAAA;EAAA;;;;;AAgB9B,SAAgB+E,aAAa5C,OAA0B;CACrD,MAAM,EAAEC,SAAS4C,SAASC,gBAAgB,GAAGC,SAAS/C;CAEtD,MAAMgB,8EAA8C;CACpD,MAAMgC,iFAEF/C,QAAQI,SACL4C,QAAO1C,YAAW,2EAAsBA,QAAQ,CAAC,CACjDC,KAAK,IAAI,EACZ,WAEJ,CAAC;CACD,MAAM0C,2KAGUlC,QAAQmC,gDAAwBH,SAASI,MAAM,CAAC,EAC1DnD,QAAQoD,MAAMC,OAAOC,QAAQtD,QAAQoD,MAAME,KAE/C,CACF,CAAC;CACD,MAAMC,sDAAiC;EACrC,GAAGvD,QAAQoD;EACXI,QAAQxD,QAAQyD;EACjB,EAAE;AAEH,QAAA,kDAEKlF,kHACKuE,MAAI;EAAA,IACRa,OAAI;AAAA,UAAEZ,SAASI;;EAAK,IACpBI,iBAAc;AAAA,UAAEA,eAAeJ;;EAAK,IACpCP,UAAO;AAAA,4BAAOA,WAAW,EAAE,EAAE,GAC1BK,kBAAkBE,QAAQ,4DAAoBnD,QAAQE,KAAK,IAC7D,CAAC;;EAAA,IACF2C,iBAAc;AAAA,4BAAOA,kBAAkB,EAAE,EAAE;IACzCe,KAAK;KAAC;KAAO;KAAiB;KAAU;IACxCC,SAAS;KACP;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD;IACDC,OAAO;KACL;KACA;KACA;KACA;KACA;KAAyB;IAE5B,CAAC;;EAAA,IAAAhD,WAAA;AAAA,UAAA;qDACDpB,0EAAyB,EAAUM,SAAO,CAAA;qDAAA,OAAA,EAAA,CAAA;qDAAA,OAAA,EAAA,CAAA;qDAG1CnB,gFAA2B,EAAUmB,SAAO,CAAA;qDAAA,OAAA,EAAA,CAAA;qDAAA,OAAA,EAAA,CAAA;qDAG5Ca,2BAAyB;KAAUb;KAAO,IAAAc,WAAA;AAAA,8DACxCkB,wBAAsB,EAAUhC,SAAO,CAAA;;KAAA,CAAA;IAAA;;EAAA,CAAA,CAAA,mDAG3ClC,qBAAG;EAAA,IAACmE,OAAI;AAAA,UAAEL,OAAOC,OAAO7B,QAAQc,SAAS;;EAAAA,WACvCiD,2DACEhG,sBAAI;GAAA,IACHoE,OAAI;AAAA,WAAE4B,MAAMC;;GAAS,IACrBtB,WAAQ;AAAA,4DAAGC,cAAY,EAAC3C,SAAS+D,OAAK,CAAA;;GAAA,IAAAjD,WAAA;AAAA,4DACrCjB,8DAAmB,EAACG,SAAS+D,OAAK,CAAA;;GAAA,CAAA;EAEtC,CAAA,CAAA"}
+{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","ReflectionKind","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","IsDebug","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","arguments","length","argument","_$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","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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\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 {\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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { IsDebug } from \"./helpers\";\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.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.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 === ReflectionKind.string ||\n                    option.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).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.arguments} 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 === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).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\n  extends Omit<EntryFileProps, \"path\" | \"typeDefinition\"> {\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    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.d.cts

@@ -8,6 +8,7 @@ declare function CommandInvocation(props: {
 }): Children;
 interface CommandHandlerDeclarationProps {
   command: CommandTree;
+  banner?: Children;
   children?: Children;
 }
 /**

package/dist/components/command-entry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAiEgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AA2CC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA8FC,QAAA,CAAA,EApGJ,QAoGI;AAOjB;AAgIA;;;AAA2C,iBArO3B,yBAAA,CAqO2B,KAAA,EApOlC,8BAoOkC,CAAA,EApOJ,QAoOI;AAAI,UAvI9B,2BAAA,CAuI8B;EAU/B,OAAA,EAhJL,WAgJiB;;;;;iBA1IZ,sBAAA,QAA8B,8BAA2B;UAgIxD,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}
+{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAkEgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AA0CC,UAAA,8BAAA,CAA8B;EACpC,OAAA,EAAA,WAAA;EACA,MAAA,CAAA,EAAA,QAAA;EACE,QAAA,CAAA,EAAA,QAAA;;AAMb;AA0FA;AAOA;AA+HiB,iBAhOD,yBAAA,CAiOd,KAAA,EAhOO,8BAgOP,CAAA,EAhOqC,QAgOrC;AAAa,UAvIE,2BAAA,CAuIF;EACJ,OAAA,EAvIA,WAuIA;;;AAMX;;iBAvIgB,sBAAA,QAA8B,8BAA2B;UA+HxD,iBAAA,SACP,KAAK;WACJ;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.d.mts

@@ -8,6 +8,7 @@ declare function CommandInvocation(props: {
 }): Children;
 interface CommandHandlerDeclarationProps {
   command: CommandTree;
+  banner?: Children;
   children?: Children;
 }
 /**

package/dist/components/command-entry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAiEgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AA2CC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA8FC,QAAA,CAAA,EApGJ,QAoGI;AAOjB;AAgIA;;;AAA2C,iBArO3B,yBAAA,CAqO2B,KAAA,EApOlC,8BAoOkC,CAAA,EApOJ,QAoOI;AAAI,UAvI9B,2BAAA,CAuI8B;EAU/B,OAAA,EAhJL,WAgJiB;;;;;iBA1IZ,sBAAA,QAA8B,8BAA2B;UAgIxD,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAkEgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AA0CC,UAAA,8BAAA,CAA8B;EACpC,OAAA,EAAA,WAAA;EACA,MAAA,CAAA,EAAA,QAAA;EACE,QAAA,CAAA,EAAA,QAAA;;AAMb;AA0FA;AAOA;AA+HiB,iBAhOD,yBAAA,CAiOd,KAAA,EAhOO,8BAgOP,CAAA,EAhOqC,QAgOrC;AAAa,UAvIE,2BAAA,CAuIF;EACJ,OAAA,EAvIA,WAuIA;;;AAMX;;iBAvIgB,sBAAA,QAA8B,8BAA2B;UA+HxD,iBAAA,SACP,KAAK;WACJ;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.mjs

@@ -5,6 +5,7 @@ import { VirtualCommandEntry } from "./virtual-command-entry.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { ElseClause, ElseIfClause, FunctionDeclaration, IfStatement, VarDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment } from "@shell-shock/core/plugin-utils/context-helpers";
 import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
@@ -30,8 +31,7 @@ function CommandInvocation(props) {
 				return code`{ path: \`${command.segments.map((segment) => isDynamicPathSegment(segment) ? `\${${camelCase(getDynamicPathSegmentName(segment))}}` : segment).join("/")}\`, segments: [${command.segments.map((segment) => isDynamicPathSegment(segment) ? camelCase(getDynamicPathSegmentName(segment)) : `"${segment}"`).join(", ")}] }`;
 			}
 		}),
-		createIntrinsic("hbr", {}),
-		createIntrinsic("hbr", {}),
+		createComponent(Spacing, {}),
 		memo(() => code`
 
       return internal_commandContext.run(__context, () => {
@@ -46,12 +46,11 @@ function CommandInvocation(props) {
 * A component that generates the `handler` function declaration for a command.
 */
 function CommandHandlerDeclaration(props) {
-	const { command, children } = props;
+	const { command, banner, children } = props;
 	const context = usePowerlines();
 	return [
 		createComponent(OptionsInterfaceDeclaration, { command }),
-		createIntrinsic("hbr", {}),
-		createIntrinsic("hbr", {}),
+		createComponent(Spacing, {}),
 		createComponent(TSDoc, {
 			get heading() {
 				return `The ${command.title} (${getAppBin(context)} ${command.segments.map((segment) => isDynamicPathSegment(segment) ? `[${constantCase(getDynamicPathSegmentName(segment))}]` : segment).join(" ")}) command.`;
@@ -94,8 +93,12 @@ function CommandHandlerDeclaration(props) {
 					}),
 					createIntrinsic("hbr", {}),
 					createIntrinsic("hbr", {}),
-					code`writeLine("");
-        banner(); `,
+					createComponent(Show, {
+						get when() {
+							return Boolean(banner);
+						},
+						children: banner
+					}),
 					createIntrinsic("hbr", {}),
 					createIntrinsic("hbr", {}),
 					createComponent(IfStatement, {
@@ -103,10 +106,8 @@ function CommandHandlerDeclaration(props) {
 							return createComponent(IsDebug, {});
 						},
 						get children() {
-							return code`
+							return code`writeLine("");
           writeLine(colors.text.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
-
-          writeLine("");
           debug(\`Command path: ${command.segments.map((segment) => isDynamicPathSegment(segment) ? `\${${camelCase(getDynamicPathSegmentName(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${kebabCase(option.name)}: \${options.${camelCase(option.name)} === undefined ? "" : JSON.stringify(options.${camelCase(option.name)})}`).join("\\n")}${command.arguments.length > 0 ? ` \\n\\nArguments: \\n${command.arguments.map((argument) => ` - ${kebabCase(argument.name)}: \${${camelCase(argument.name)} === undefined ? "" : JSON.stringify(${camelCase(argument.name)})}`).join("\\n")}` : ""}\`);
           writeLine(""); `;
 						}
@@ -208,8 +209,7 @@ function CommandValidationLogic(props) {
 				}
 			})]
 		}),
-		createIntrinsic("hbr", {}),
-		createIntrinsic("hbr", {}),
+		createComponent(Spacing, {}),
 		createComponent(For, {
 			get each() {
 				return command.arguments;
@@ -341,6 +341,7 @@ function CommandEntry(props) {
 				createIntrinsic("hbr", {}),
 				createComponent(CommandHandlerDeclaration, {
 					command,
+					banner: code`banner(); `,
 					get children() {
 						return createComponent(CommandValidationLogic, { command });
 					}

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","ReflectionKind","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","IsDebug","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$createIntrinsic","_$memo","arguments","length","argument","CommandHandlerDeclaration","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","when","optional","includes","kind","string","number","variadic","fallback","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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\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 {\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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { IsDebug } from \"./helpers\";\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      <hbr />\n      <hbr />\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.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\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, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <hbr />\n      <hbr />\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        {code`writeLine(\"\");\n        banner(); `}\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n\n          writeLine(\"\");\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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.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 === ReflectionKind.string ||\n                    option.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).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      <hbr />\n      <hbr />\n      <For each={command.arguments} 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 === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).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    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}>\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","ReflectionKind","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","IsDebug","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","arguments","length","argument","_$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","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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\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 {\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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { IsDebug } from \"./helpers\";\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.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.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 === ReflectionKind.string ||\n                    option.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).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.arguments} 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 === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.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 === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).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\n  extends Omit<EntryFileProps, \"path\" | \"typeDefinition\"> {\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    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":";;;;;;;;;;;;;;;;;;;;;;;;AAkEA,SAAgBmC,kBAAkBC,OAAiC;CACjE,MAAM,EAAEC,YAAYD;AAEpB,QAAA;EAAAE,gBAEK9B,gBAAc;GACb+B,MAAI;GAAA,IACJC,cAAW;AAAA,WAAExC,IAAI,aAAaqC,QAAQI,SACnCC,KAAIC,YACHtB,qBAAqBsB,QAAQ,GACzB,MAAMjB,UAAUN,0BAA0BuB,QAAQ,CAAC,CAAA,KACnDA,QACL,CACAC,KAAK,IAAI,CAAA,iBAAkBP,QAAQI,SACnCC,KAAIC,YACHtB,qBAAqBsB,QAAQ,GACzBjB,UAAUN,0BAA0BuB,QAAQ,CAAC,GAC7C,IAAIA,QAAO,GAChB,CACAC,KAAK,KAAK,CAAA;;GAAK,CAAA;EAAAN,gBAEnB5B,SAAO,EAAA,CAAA;EAAAmC,WACP7C,IAAI;;;qDAG0C6B,WAC3CQ,QAAQE,KACT,CAAA,uBACCF,QAAQS,UAAUC,SAAS,IACvB,KAAKV,QAAQS,UACVJ,KAAIM,aAAYtB,UAAUsB,SAAST,KAAK,CAAC,CACzCK,KAAK,KAAK,KACb,GAAE;;;QAIT;EAAAK,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;AAeP,SAAgBC,0BACdd,OACA;CACA,MAAM,EAAEC,SAASc,QAAQC,aAAahB;CAEtC,MAAMiB,UAAU1C,eAAoC;AAEpD,QAAA;EAAA2B,gBAEKpB,6BAA2B,EAAUmB,SAAO,CAAA;EAAAC,gBAC5C5B,SAAO,EAAA,CAAA;EAAA4B,gBACPzB,OAAK;GAAA,IACJyC,UAAO;AAAA,WAAE,OAAOjB,QAAQkB,MAAK,IAAKpC,UAAUkC,QAAQ,CAAA,GAAIhB,QAAQI,SAC7DC,KAAIC,YACHtB,qBAAqBsB,QAAQ,GACzB,IAAIhB,aAAaP,0BAA0BuB,QAAQ,CAAC,CAAA,KACpDA,QACL,CACAC,KAAK,IAAI,CAAA;;GAAY,IAAAQ,WAAA;AAAA,WAAA;KAAAd,gBACvBvB,cAAY,EAAA,IAAAqC,WAAA;AAAA,aAAE,GAAGf,QAAQmB,YAAYC,QAAQ,QAAQ,GAAG,CAAA;QAAG,CAAA;KAAAR,gBAAA,OAAA,EAAA,CAAA;KAAAX,gBAE3DtB,YAAU,EAAA,IAAAoC,WAAA;AAAA,aAAEf,QAAQkB;QAAK,CAAA;KAAAjB,gBACzBxB,YAAU;MAACyB,MAAI;MAAAa,UAAS;MAAmD,CAAA;KAAA;;GAAA,CAAA;EAAAd,gBAE7EhC,qBAAmB;GAAA,UAAA;GAElBoD,OAAK;GACLnB,MAAI;GACJoB,YAAY,CAAC;IAAEpB,MAAM;IAAQqB,MAAM;IAAYC,SAAS;IAAa,CAAC;GAAA,IAAAT,WAAA;AAAA,WAAA;KAAAd,gBACrErB,oBAAkB;MACRoB;MAAO,IAChByB,YAAS;AAAA,cAAET,QAAQU,OAAOD;;MAAS,IACnCE,kBAAe;AAAA,cAAEX,QAAQU,OAAOC;;MAAe,CAAA;KAAAf,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAX,gBAIhDnC,MAAI;MAAA,IAAC8D,OAAI;AAAA,cAAEC,QAAQf,OAAO;;MAAAC,UAAGD;MAAM,CAAA;KAAAF,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAX,gBAGnC/B,aAAW;MAAA,IAAC4D,YAAS;AAAA,cAAA7B,gBAAGL,SAAO,EAAA,CAAA;;MAAA,IAAAmB,WAAA;AAAA,cAC7BpD,IAAI;;kCAEmBqC,QAAQI,SAC7BC,KAAIC,YACHtB,qBAAqBsB,QAAQ,GACzB,MAAMjB,UAAUN,0BAA0BuB,QAAQ,CAAC,CAAA,KACnDA,QACL,CACAC,KAAK,MAAM,CAAA,qBAAsBwB,OAAOC,OAAOhC,QAAQiC,QAAQ,CAC/D5B,KACC6B,WACE,MAAM3C,UAAU2C,OAAOhC,KAAK,CAAA,eAAgBb,UAC1C6C,OAAOhC,KACR,CAAA,+CAAgDb,UAC/C6C,OAAOhC,KACR,CAAA,IACJ,CACAK,KAAK,MAAM,GACZP,QAAQS,UAAUC,SAAS,IACvB,wBAAwBV,QAAQS,UAC7BJ,KACCM,aACE,MAAMpB,UAAUoB,SAAST,KAAK,CAAA,OAAQb,UACpCsB,SAAST,KACV,CAAA,uCAAwCb,UACvCsB,SAAST,KACV,CAAA,IACJ,CACAK,KAAK,MAAM,KACd,GAAE;;;MAEQ,CAAA;KAAAK,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAIjBG;KAAQH,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAX,gBAGR/B,aAAW;MAAC4D,WAAWnE,IAAI;MAAc,IAAAoD,WAAA;AAAA,cAAAd,gBACvCN,aAAW,EAAUK,SAAO,CAAA;;MAAA,CAAA;KAAAC,gBAE9BlC,YAAU,EAAA,IAAAgD,WAAA;AAAA,aAAA,CAAAH,gBAAA,OAAA,EAAA,CAAA,EAAAX,gBAERH,mBAAiB,EAAUE,SAAO,CAAA,CAAA;QAAA,CAAA;KAAA;;GAAA,CAAA;EAAA;;;;;AAc7C,SAAgBmC,uBAAuBpC,OAAoC;CACzE,MAAM,EAAEC,YAAYD;AAEpB,QAAA;EAAAE,gBAEK9B,gBAAc;GAAC+B,MAAI;GAAYqB,MAAI;GAAYpB,aAAaxC,IAAI;GAAK,CAAA;EAAAiD,gBAAA,OAAA,EAAA,CAAA;EAAAX,gBAErEpC,KAAG;GAAA,IAACuE,OAAI;AAAA,WAAEL,OAAOC,OAAOhC,QAAQiC,WAAW,EAAE,CAAC;;GAAEI,gBAAc;GAAAtB,WAC5DmB,WAAM,CAAAjC,gBAEFnC,MAAI;IAAA,IAAC8D,OAAI;AAAA,YAAE,CAACM,OAAOI;;IAAQ,IAAAvB,WAAA;AAAA,YAAA,CAAAd,gBACzB/B,aAAW;MAAA,IACV4D,YAAS;AAAA,cAAEnE,IAAI,WACbuE,OAAOhC,KAAKqC,SAAS,IAAI,GACrB,KAAKL,OAAOhC,KAAI,MAChB,IAAIb,UAAU6C,OAAOhC,KAAK;;MAC9B,IAAAa,WAAA;AAAA,cACDpD,IAAI,sCAAsCuE,OAAOhC,KAAI;;MAAe,CAAA,EAAAD,gBAEtEnC,MAAI;MAAA,IACH8D,OAAI;AAAA,eACDM,OAAOM,SAASpE,eAAeqE,UAC9BP,OAAOM,SAASpE,eAAesE,WACjCR,OAAOS;;MAAQ,IAAA5B,WAAA;AAAA,cAAAd,gBAEhBjC,cAAY;QAAA,IACX8D,YAAS;AAAA,gBAAEnE,IAAI,UACbuE,OAAOhC,KAAKqC,SAAS,IAAI,GACrB,KAAKL,OAAOhC,KAAI,MAChB,IAAIb,UAAU6C,OAAOhC,KAAK,GAAE;;QACnB,IAAAa,WAAA;AAAA,gBACdpD,IAAI,6DACHuE,OAAOhC,KAAI;;QACQ,CAAA;;MAAA,CAAA,CAAA;;IAAA,CAAA,EAAAD,gBAI1BnC,MAAI;IAAA,IAAC8D,OAAI;AAAA,YAAEM,OAAOM,SAASpE,eAAesE;;IAAM,IAAA3B,WAAA;AAAA,YAAAd,gBAC9CnC,MAAI;MAAA,IACH8D,OAAI;AAAA,cAAGM,OAA+BS;;MAAQ,IAC9CC,WAAQ;AAAA,cAAA3C,gBACL/B,aAAW;QAAA,IACV4D,YAAS;AAAA,gBAAEnE,IAAI,UACbuE,OAAOhC,KAAKqC,SAAS,IAAI,GACrB,KAAKL,OAAOhC,KAAI,MAChB,IAAIb,UAAU6C,OAAOhC,KAAK,GAAE,0BAEhCgC,OAAOhC,KAAKqC,SAAS,IAAI,GACrB,KAAKL,OAAOhC,KAAI,MAChB,IAAIb,UAAU6C,OAAOhC,KAAK,GAAE;;QAC/B,IAAAa,WAAA;AAAA,gBACFpD,IAAI,4DACHuE,OAAOhC,KAAI;;QACE,CAAA;;MAAA,IAAAa,WAAA;AAAA,cAAAd,gBAGlB/B,aAAW;QAAA,IACV4D,YAAS;AAAA,gBAAEnE,IAAI,UACbuE,OAAOhC,KAAKqC,SAAS,IAAI,GACrB,KAAKL,OAAOhC,KAAI,MAChB,IAAIb,UAAU6C,OAAOhC,KAAK,GAAE;;QACG,IAAAa,WAAA;AAAA,gBACpCpD,IAAI,2DACHuE,OAAOhC,KAAI;;QACQ,CAAA;;MAAA,CAAA;;IAAA,CAAA,CAAA;GAK9B,CAAA;EAAAD,gBAEF5B,SAAO,EAAA,CAAA;EAAA4B,gBACPpC,KAAG;GAAA,IAACuE,OAAI;AAAA,WAAEpC,QAAQS;;GAAW4B,gBAAc;GAAAtB,WACzCJ,aAAQ,CAAAV,gBAEJnC,MAAI;IAAA,IAAC8D,OAAI;AAAA,YAAE,CAACjB,SAAS2B;;IAAQ,IAAAvB,WAAA;AAAA,YAAA,CAAAd,gBAC3B/B,aAAW;MAAA,IAAC4D,YAAS;AAAA,cAAEnE,IAAI,IAAI0B,UAAUsB,SAAST,KAAK;;MAAE,IAAAa,WAAA;AAAA,cACvDpD,IAAI,sCACHgD,SAAST,KAAI;;MACa,CAAA,EAAAD,gBAE7BnC,MAAI;MAAA,IACH8D,OAAI;AAAA,eACDjB,SAAS6B,SAASpE,eAAeqE,UAChC9B,SAAS6B,SAASpE,eAAesE,WACnC/B,SAASgC;;MAAQ,IAAA5B,WAAA;AAAA,cAAAd,gBAElBjC,cAAY;QAAA,IACX8D,YAAS;AAAA,gBAAEnE,IAAI,GAAG0B,UAAUsB,SAAST,KAAK,CAAA;;QAAe,IAAAa,WAAA;AAAA,gBACxDpD,IAAI,6DACHgD,SAAST,KAAI;;QACmB,CAAA;;MAAA,CAAA,CAAA;;IAAA,CAAA,EAAAD,gBAIvCnC,MAAI;IAAA,IAAC8D,OAAI;AAAA,YAAEjB,SAAS6B,SAASpE,eAAesE;;IAAM,IAAA3B,WAAA;AAAA,YAAAd,gBAChDnC,MAAI;MAAA,IACH8D,OAAI;AAAA,cAAGjB,SAAmCgC;;MAAQ,IAClDC,WAAQ;AAAA,cAAA3C,gBACL/B,aAAW;QAAA,IACV4D,YAAS;AAAA,gBAAEnE,IAAI,GAAG0B,UAChBsB,SAAST,KACV,CAAA,mBAAoBb,UAAUsB,SAAST,KAAK,CAAA;;QAAG,IAAAa,WAAA;AAAA,gBAC/CpD,IAAI,4DACHgD,SAAST,KAAI;;QACa,CAAA;;MAAA,IAAAa,WAAA;AAAA,cAAAd,gBAG/B/B,aAAW;QAAA,IACV4D,YAAS;AAAA,gBAAEnE,IAAI,GAAG0B,UAAUsB,SAAST,KAAK,CAAA;;QAAqC,IAAAa,WAAA;AAAA,gBAC9EpD,IAAI,2DACHgD,SAAST,KAAI;;QACmB,CAAA;;MAAA,CAAA;;IAAA,CAAA,CAAA;GAK3C,CAAA;EAAAD,gBAEF/B,aAAW;GAAC4D,WAAWnE,IAAI;GAAqBoD,UAC9CpD,IAAI;;GACiB,CAAA;EAAA;;;;;AAc9B,SAAgBkF,aAAa9C,OAA0B;CACrD,MAAM,EAAEC,SAAS8C,SAASC,gBAAgB,GAAGC,SAASjD;CAEtD,MAAMiB,UAAU1C,eAAoC;CACpD,MAAM2E,WAAWrF,eACfuB,UACEa,QAAQI,SACL8C,QAAO5C,YAAW,CAACtB,qBAAqBsB,QAAQ,CAAC,CACjDC,KAAK,IAAI,EACZ,WAEJ,CAAC;CACD,MAAM4C,oBAAoBvF,eACxBwB,iBACEF,aACEC,UAAU6B,QAAQoC,WAAWnE,aAAagE,SAASI,MAAM,CAAC,EAC1DrD,QAAQsD,MAAMC,OAAOC,QAAQxD,QAAQsD,MAAME,KAE/C,CACF,CAAC;CACD,MAAMC,iBAAiB7F,gBAAgB;EACrC,GAAGoC,QAAQsD;EACXI,QAAQ1D,QAAQ2D;EACjB,EAAE;AAEH,QAAA,CAAA1D,gBAEK1B,WAASqF,WACJZ,MAAI;EAAA,IACRa,OAAI;AAAA,UAAEZ,SAASI;;EAAK,IACpBI,iBAAc;AAAA,UAAEA,eAAeJ;;EAAK,IACpCP,UAAO;AAAA,UAAErD,KAAKqD,WAAW,EAAE,EAAE,GAC1BK,kBAAkBE,QAAQ,SAAS7D,WAAWQ,QAAQE,KAAK,IAC7D,CAAC;;EAAA,IACF6C,iBAAc;AAAA,UAAEtD,KAAKsD,kBAAkB,EAAE,EAAE;IACzCe,KAAK;KAAC;KAAO;KAAiB;KAAU;IACxCC,SAAS;KACP;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD;IACDC,OAAO;KACL;KACA;KACA;KACA;KACA;KAAyB;IAE5B,CAAC;;EAAA,IAAAjD,WAAA;AAAA,UAAA;IAAAd,gBACDP,2BAAyB,EAAUM,SAAO,CAAA;IAAAY,gBAAA,OAAA,EAAA,CAAA;IAAAA,gBAAA,OAAA,EAAA,CAAA;IAAAX,gBAG1CpB,6BAA2B,EAAUmB,SAAO,CAAA;IAAAY,gBAAA,OAAA,EAAA,CAAA;IAAAA,gBAAA,OAAA,EAAA,CAAA;IAAAX,gBAG5CY,2BAAyB;KAAUb;KAASc,QAAQnD,IAAI;KAAY,IAAAoD,WAAA;AAAA,aAAAd,gBAClEkC,wBAAsB,EAAUnC,SAAO,CAAA;;KAAA,CAAA;IAAA;;EAAA,CAAA,CAAA,EAAAC,gBAG3CpC,KAAG;EAAA,IAACuE,OAAI;AAAA,UAAEL,OAAOC,OAAOhC,QAAQe,SAAS;;EAAAA,WACvCkD,UAAKhE,gBACHnC,MAAI;GAAA,IACH8D,OAAI;AAAA,WAAEqC,MAAMC;;GAAS,IACrBtB,WAAQ;AAAA,WAAA3C,gBAAG4C,cAAY,EAAC7C,SAASiE,OAAK,CAAA;;GAAA,IAAAlD,WAAA;AAAA,WAAAd,gBACrCJ,qBAAmB,EAACG,SAASiE,OAAK,CAAA;;GAAA,CAAA;EAEtC,CAAA,CAAA"}

package/dist/components/command-router.cjs

@@ -2,6 +2,7 @@ const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __alloy_js_typescript = require("@alloy-js/typescript");
+let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
 let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
@@ -50,8 +51,7 @@ function CommandRouter(props) {
 					type: "string",
 					initializer: __alloy_js_core.code`"";`
 				}),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 					get when() {
 						return commands && Object.keys(commands).length > 0;

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

@@ -1 +1 @@
-{"version":3,"file":"command-router.cjs","names":["code","computed","For","Show","ElseIfClause","IfStatement","VarDeclaration","usePowerlines","DynamicImportStatement","CommandContext","useCommand","isDynamicPathSegment","pascalCase","CommandRouterRoute","command","_$createComponent","when","isVirtual","children","name","importPath","segments","filter","segment","length","exportName","_$createIntrinsic","_$memo","CommandRouter","props","commands","route","index","Object","keys","type","initializer","condition","value","CommandRouterBody","context","each","values","subcommand","idx","Provider","Boolean","fallback","config","isCaseSensitive","toLowerCase","replaceAll","alias","map","join","cmd","i","JSON","stringify"],"sources":["../../src/components/command-router.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  ElseIfClause,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <hbr />\n      <hbr />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <hbr />\n        <hbr />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <For each={Object.values(commands ?? {})}>\n        {(subcommand, idx) => (\n          <CommandContext.Provider value={subcommand}>\n            <Show\n              when={Boolean(idx)}\n              fallback={\n                <IfStatement\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </IfStatement>\n              }>\n              <ElseIfClause\n                condition={code`${\n                  context.config.isCaseSensitive\n                    ? \"command\"\n                    : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                } === \"${\n                  context.config.isCaseSensitive\n                    ? subcommand.name\n                    : subcommand.name\n                        .toLowerCase()\n                        .replaceAll(\"-\", \"\")\n                        .replaceAll(\"_\", \"\")\n                }\"${\n                  subcommand.alias && subcommand.alias.length > 0\n                    ? ` || ${subcommand.alias\n                        .map(\n                          alias =>\n                            `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                              context.config.isCaseSensitive\n                                ? alias\n                                : alias\n                                    .toLowerCase()\n                                    .replaceAll(\"-\", \"\")\n                                    .replaceAll(\"_\", \"\")\n                            }\"`\n                        )\n                        .join(\" || \")}`\n                    : \"\"\n                }`}>\n                <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                  {route}\n                </Show>\n              </ElseIfClause>\n            </Show>\n          </CommandContext.Provider>\n        )}\n      </For>\n      <ElseIfClause\n        condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = didYouMean(command, [${Object.values(\n        commands ?? {}\n      )\n        .map(\n          cmd =>\n            `\"${cmd.name}\"${(cmd.alias ?? []).map((alias, i) => (i === 0 ? `, \"${alias}\"` : ` \"${alias}\"`)).join(\"\")}`\n        )\n        .join(\", \")}], {\n          caseSensitive: ${JSON.stringify(context.config.isCaseSensitive)},\n          returnType: ReturnTypeEnums.ALL_CLOSEST_MATCHES,\n          thresholdType: ThresholdTypeEnums.SIMILARITY,\n          threshold: 0.25\n        });\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n    </Show>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-router.cjs","names":["code","computed","For","Show","ElseIfClause","IfStatement","VarDeclaration","Spacing","usePowerlines","DynamicImportStatement","CommandContext","useCommand","isDynamicPathSegment","pascalCase","CommandRouterRoute","command","_$createComponent","when","isVirtual","children","name","importPath","segments","filter","segment","length","exportName","_$createIntrinsic","_$memo","CommandRouter","props","commands","route","index","Object","keys","type","initializer","condition","value","CommandRouterBody","context","each","values","subcommand","idx","Provider","Boolean","fallback","config","isCaseSensitive","toLowerCase","replaceAll","alias","map","join","cmd","i","JSON","stringify"],"sources":["../../src/components/command-router.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  ElseIfClause,\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 { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <Spacing />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <hbr />\n        <hbr />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <For each={Object.values(commands ?? {})}>\n        {(subcommand, idx) => (\n          <CommandContext.Provider value={subcommand}>\n            <Show\n              when={Boolean(idx)}\n              fallback={\n                <IfStatement\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </IfStatement>\n              }>\n              <ElseIfClause\n                condition={code`${\n                  context.config.isCaseSensitive\n                    ? \"command\"\n                    : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                } === \"${\n                  context.config.isCaseSensitive\n                    ? subcommand.name\n                    : subcommand.name\n                        .toLowerCase()\n                        .replaceAll(\"-\", \"\")\n                        .replaceAll(\"_\", \"\")\n                }\"${\n                  subcommand.alias && subcommand.alias.length > 0\n                    ? ` || ${subcommand.alias\n                        .map(\n                          alias =>\n                            `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                              context.config.isCaseSensitive\n                                ? alias\n                                : alias\n                                    .toLowerCase()\n                                    .replaceAll(\"-\", \"\")\n                                    .replaceAll(\"_\", \"\")\n                            }\"`\n                        )\n                        .join(\" || \")}`\n                    : \"\"\n                }`}>\n                <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                  {route}\n                </Show>\n              </ElseIfClause>\n            </Show>\n          </CommandContext.Provider>\n        )}\n      </For>\n      <ElseIfClause\n        condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = didYouMean(command, [${Object.values(\n        commands ?? {}\n      )\n        .map(\n          cmd =>\n            `\"${cmd.name}\"${(cmd.alias ?? []).map((alias, i) => (i === 0 ? `, \"${alias}\"` : ` \"${alias}\"`)).join(\"\")}`\n        )\n        .join(\", \")}], {\n          caseSensitive: ${JSON.stringify(context.config.isCaseSensitive)},\n          returnType: ReturnTypeEnums.ALL_CLOSEST_MATCHES,\n          thresholdType: ThresholdTypeEnums.SIMILARITY,\n          threshold: 0.25\n        });\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n    </Show>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-router.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"command-router.d.cts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;iBAiCgB,kBAAA,CAAA,GAAkB;UAuBjB,kBAAA;EAvBD,QAAA,EAAA,MAAA,EAAA;EAuBC,QAAA,CAAA,EAEJ,MAFI,CAAA,MAAkB,EAEP,WAFO,CAAA;EAEP,KAAA,CAAA,EAClB,QADkB;;;;AAO5B;AAqCgB,iBArCA,aAAA,CAqCyB,KAAA,EArCJ,kBAqCsB,CAAA,EArCJ,QAqCI;;;;iBAA3C,iBAAA,QAAyB,qBAAkB"}
+{"version":3,"file":"command-router.d.cts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;iBAkCgB,kBAAA,CAAA,GAAkB;UAuBjB,kBAAA;EAvBD,QAAA,EAAA,MAAA,EAAA;EAuBC,QAAA,CAAA,EAEJ,MAFI,CAAA,MAAkB,EAEP,WAFO,CAAA;EAEP,KAAA,CAAA,EAClB,QADkB;;;;AAO5B;AAoCgB,iBApCA,aAAA,CAoCyB,KAAA,EApCJ,kBAoCsB,CAAA,EApCJ,QAoCI;;;;iBAA3C,iBAAA,QAAyB,qBAAkB"}

package/dist/components/command-router.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-router.d.mts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;iBAiCgB,kBAAA,CAAA,GAAkB;UAuBjB,kBAAA;EAvBD,QAAA,EAAA,MAAA,EAAA;EAuBC,QAAA,CAAA,EAEJ,MAFI,CAAA,MAAkB,EAEP,WAFO,CAAA;EAEP,KAAA,CAAA,EAClB,QADkB;;;;AAO5B;AAqCgB,iBArCA,aAAA,CAqCyB,KAAA,EArCJ,kBAqCsB,CAAA,EArCJ,QAqCI;;;;iBAA3C,iBAAA,QAAyB,qBAAkB"}
+{"version":3,"file":"command-router.d.mts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;iBAkCgB,kBAAA,CAAA,GAAkB;UAuBjB,kBAAA;EAvBD,QAAA,EAAA,MAAA,EAAA;EAuBC,QAAA,CAAA,EAEJ,MAFI,CAAA,MAAkB,EAEP,WAFO,CAAA;EAEP,KAAA,CAAA,EAClB,QADkB;;;;AAO5B;AAoCgB,iBApCA,aAAA,CAoCyB,KAAA,EApCJ,kBAoCsB,CAAA,EApCJ,QAoCI;;;;iBAA3C,iBAAA,QAAyB,qBAAkB"}

package/dist/components/command-router.mjs

@@ -1,6 +1,7 @@
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { ElseIfClause, IfStatement, VarDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { isDynamicPathSegment } from "@shell-shock/core/plugin-utils/context-helpers";
 import { pascalCase } from "@stryke/string-format/pascal-case";
@@ -49,8 +50,7 @@ function CommandRouter(props) {
 					type: "string",
 					initializer: code`"";`
 				}),
-				createIntrinsic("hbr", {}),
-				createIntrinsic("hbr", {}),
+				createComponent(Spacing, {}),
 				createComponent(Show, {
 					get when() {
 						return commands && Object.keys(commands).length > 0;