@shell-shock/preset-script 0.6.22 → 0.6.26

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

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

@@ -15,13 +15,6 @@ interface CommandHandlerDeclarationProps {
  * A component that generates the `handler` function declaration for a command.
  */
 declare function CommandHandlerDeclaration(props: CommandHandlerDeclarationProps): Children;
-interface CommandValidationLogicProps {
-  command: CommandTree;
-}
-/**
- * A component that generates command validation logic for required options and arguments.
- */
-declare function CommandValidationLogic(props: CommandValidationLogicProps): Children;
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
   command: CommandTree;
 }
@@ -30,5 +23,5 @@ interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinitio
  */
 declare function CommandEntry(props: CommandEntryProps): Children;
 //#endregion
-export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation, CommandValidationLogic, CommandValidationLogicProps };
+export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation };
 //# sourceMappingURL=command-entry.d.cts.map

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":";;;;;iBA8DgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AAwCC,UAAA,8BAAA,CAA8B;EACpC,OAAA,EAAA,WAAA;EACA,MAAA,CAAA,EAAA,QAAA;EACE,QAAA,CAAA,EAAA,QAAA;;AAMb;AA0FA;AAOA;AA+HiB,iBAhOD,yBAAA,CAgOmB,KAAA,EA/N1B,8BA+N0B,CAAA,EA/NI,QA+NJ;AACjC,UAvIe,2BAAA,CAuIf;EAGS,OAAA,EAzIA,WAyIA;;;AAMX;;iBAzIgB,sBAAA,QAA8B,8BAA2B;UA+HxD,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}
+{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"mappings":";;;;;iBA4DgB,iBAAA,CAAkB,KAAA;EAAS,OAAA,EAAS,WAAA;AAAA,IAAa,QAAA;AAAA,UAwChD,8BAAA;EACf,OAAA,EAAS,WAAA;EACT,MAAA,GAAS,QAAA;EACT,QAAA,GAAW,QAAA;AAAA;;;;iBAMG,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,QAAA;AAAA,UAqFtB,iBAAA,SAA0B,IAAA,CACzC,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,QAAA"}

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

@@ -1,6 +1,6 @@
 import { Children } from "@alloy-js/core";
-import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core";
+import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 
 //#region src/components/command-entry.d.ts
 declare function CommandInvocation(props: {
@@ -15,13 +15,6 @@ interface CommandHandlerDeclarationProps {
  * A component that generates the `handler` function declaration for a command.
  */
 declare function CommandHandlerDeclaration(props: CommandHandlerDeclarationProps): Children;
-interface CommandValidationLogicProps {
-  command: CommandTree;
-}
-/**
- * A component that generates command validation logic for required options and arguments.
- */
-declare function CommandValidationLogic(props: CommandValidationLogicProps): Children;
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
   command: CommandTree;
 }
@@ -30,5 +23,5 @@ interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinitio
  */
 declare function CommandEntry(props: CommandEntryProps): Children;
 //#endregion
-export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation, CommandValidationLogic, CommandValidationLogicProps };
+export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation };
 //# sourceMappingURL=command-entry.d.mts.map

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":";;;;;iBA8DgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AAwCC,UAAA,8BAAA,CAA8B;EACpC,OAAA,EAAA,WAAA;EACA,MAAA,CAAA,EAAA,QAAA;EACE,QAAA,CAAA,EAAA,QAAA;;AAMb;AA0FA;AAOA;AA+HiB,iBAhOD,yBAAA,CAgOmB,KAAA,EA/N1B,8BA+N0B,CAAA,EA/NI,QA+NJ;AACjC,UAvIe,2BAAA,CAuIf;EAGS,OAAA,EAzIA,WAyIA;;;AAMX;;iBAzIgB,sBAAA,QAA8B,8BAA2B;UA+HxD,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"mappings":";;;;;iBA4DgB,iBAAA,CAAkB,KAAA;EAAS,OAAA,EAAS,WAAA;AAAA,IAAa,QAAA;AAAA,UAwChD,8BAAA;EACf,OAAA,EAAS,WAAA;EACT,MAAA,GAAS,QAAA;EACT,QAAA,GAAW,QAAA;AAAA;;;;iBAMG,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,QAAA;AAAA,UAqFtB,iBAAA,SAA0B,IAAA,CACzC,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,QAAA"}

package/dist/components/command-entry.mjs

@@ -1,22 +1,21 @@
 import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
-import { CommandHelp } from "./help.mjs";
 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 { ElseClause, FunctionDeclaration, IfStatement, VarDeclaration } from "@alloy-js/typescript";
+import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
 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";
-import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
+import defu from "defu";
 import { TSDoc, TSDocParam, TSDocRemarks, TSDocTitle } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { joinPaths } from "@stryke/path/join";
+import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { replaceExtension } from "@stryke/path/replace";
 import { pascalCase } from "@stryke/string-format/pascal-case";
-import defu from "defu";
 import { IsDebug } from "@shell-shock/core/components/helpers";
-import { CommandParameterKinds } from "@shell-shock/core";
+import { CommandValidationLogic } from "@shell-shock/core/components/command-validation-logic";
 import { CommandParserLogic, OptionsInterfaceDeclaration } from "@shell-shock/core/components/options-parser-logic";
 import { findFilePath, relativePath } from "@stryke/path/find";
-import { joinPaths } from "@stryke/path/join";
 import { camelCase } from "@stryke/string-format/camel-case";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { kebabCase } from "@stryke/string-format/kebab-case";
@@ -84,23 +83,21 @@ function CommandHandlerDeclaration(props) {
 				return [
 					createComponent(CommandParserLogic, {
 						command,
-						get envPrefix() {
-							return context.config.envPrefix;
+						get appSpecificEnvPrefix() {
+							return context.config.appSpecificEnvPrefix;
 						},
 						get isCaseSensitive() {
 							return context.config.isCaseSensitive;
 						}
 					}),
-					createIntrinsic("hbr", {}),
-					createIntrinsic("hbr", {}),
+					createComponent(Spacing, {}),
 					createComponent(Show, {
 						get when() {
 							return Boolean(banner);
 						},
 						children: banner
 					}),
-					createIntrinsic("hbr", {}),
-					createIntrinsic("hbr", {}),
+					createComponent(Spacing, {}),
 					createComponent(IfStatement, {
 						get condition() {
 							return createComponent(IsDebug, {});
@@ -112,16 +109,12 @@ function CommandHandlerDeclaration(props) {
           writeLine(""); `;
 						}
 					}),
-					createIntrinsic("hbr", {}),
-					createIntrinsic("hbr", {}),
+					createComponent(Spacing, {}),
 					children,
-					createIntrinsic("hbr", {}),
-					createIntrinsic("hbr", {}),
+					createComponent(Spacing, {}),
 					createComponent(IfStatement, {
 						condition: code`options.help`,
-						get children() {
-							return createComponent(CommandHelp, { command });
-						}
+						children: code`return showHelp(); `
 					}),
 					createComponent(ElseClause, { get children() {
 						return [createIntrinsic("hbr", {}), createComponent(CommandInvocation, { command })];
@@ -132,165 +125,13 @@ function CommandHandlerDeclaration(props) {
 	];
 }
 /**
-* A component that generates command validation logic for required options and arguments.
-*/
-function CommandValidationLogic(props) {
-	const { command } = props;
-	return [
-		createComponent(VarDeclaration, {
-			name: "failures",
-			type: "string[]",
-			initializer: code`[];`
-		}),
-		createIntrinsic("hbr", {}),
-		createComponent(For, {
-			get each() {
-				return Object.values(command.options ?? {});
-			},
-			doubleHardline: true,
-			children: (option) => [createComponent(Show, {
-				get when() {
-					return !option.optional;
-				},
-				get children() {
-					return [createComponent(IfStatement, {
-						get condition() {
-							return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}`;
-						},
-						get children() {
-							return code`failures.push("Missing required \\"${option.name}\\" option");`;
-						}
-					}), createComponent(Show, {
-						get when() {
-							return (option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number) && option.variadic;
-						},
-						get children() {
-							return createComponent(ElseIfClause, {
-								get condition() {
-									return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.length === 0`;
-								},
-								get children() {
-									return code`failures.push("No values were provided to the required \\"${option.name}\\" array option");`;
-								}
-							});
-						}
-					})];
-				}
-			}), createComponent(Show, {
-				get when() {
-					return option.kind === CommandParameterKinds.number;
-				},
-				get children() {
-					return createComponent(Show, {
-						get when() {
-							return option.variadic;
-						},
-						get fallback() {
-							return createComponent(IfStatement, {
-								get condition() {
-									return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} && Number.isNaN(options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`})`;
-								},
-								get children() {
-									return code`failures.push("Invalid numeric value provided for the \\"${option.name}\\" option");`;
-								}
-							});
-						},
-						get children() {
-							return createComponent(IfStatement, {
-								get condition() {
-									return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.some(value => Number.isNaN(value))`;
-								},
-								get children() {
-									return code`failures.push("Invalid numeric value provided in the \\"${option.name}\\" array option");`;
-								}
-							});
-						}
-					});
-				}
-			})]
-		}),
-		createComponent(Spacing, {}),
-		createComponent(For, {
-			get each() {
-				return command.args;
-			},
-			doubleHardline: true,
-			children: (argument) => [createComponent(Show, {
-				get when() {
-					return !argument.optional;
-				},
-				get children() {
-					return [createComponent(IfStatement, {
-						get condition() {
-							return code`!${camelCase(argument.name)}`;
-						},
-						get children() {
-							return code`failures.push("Missing required \\"${argument.name}\\" positional argument");`;
-						}
-					}), createComponent(Show, {
-						get when() {
-							return (argument.kind === CommandParameterKinds.string || argument.kind === CommandParameterKinds.number) && argument.variadic;
-						},
-						get children() {
-							return createComponent(ElseIfClause, {
-								get condition() {
-									return code`${camelCase(argument.name)}.length === 0`;
-								},
-								get children() {
-									return code`failures.push("No values were provided to the required \\"${argument.name}\\" array positional argument");`;
-								}
-							});
-						}
-					})];
-				}
-			}), createComponent(Show, {
-				get when() {
-					return argument.kind === CommandParameterKinds.number;
-				},
-				get children() {
-					return createComponent(Show, {
-						get when() {
-							return argument.variadic;
-						},
-						get fallback() {
-							return createComponent(IfStatement, {
-								get condition() {
-									return code`${camelCase(argument.name)} && Number.isNaN(${camelCase(argument.name)})`;
-								},
-								get children() {
-									return code`failures.push("Invalid numeric value provided for the \\"${argument.name}\\" positional argument");`;
-								}
-							});
-						},
-						get children() {
-							return createComponent(IfStatement, {
-								get condition() {
-									return code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`;
-								},
-								get children() {
-									return code`failures.push("Invalid numeric value provided in the \\"${argument.name}\\" array positional argument");`;
-								}
-							});
-						}
-					});
-				}
-			})]
-		}),
-		createComponent(IfStatement, {
-			condition: code`failures.length > 0`,
-			children: 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"));
-        options.help = true; `
-		})
-	];
-}
-/**
 * The command entry point for the Shell Shock project.
 */
 function CommandEntry(props) {
 	const { command, imports, builtinImports, ...rest } = props;
 	const context = usePowerlines();
 	const filePath = computed(() => joinPaths(command.segments.filter((segment) => !isDynamicPathSegment(segment)).join("/"), "index.ts"));
-	const commandSourcePath = computed(() => `./${replaceExtension(relativePath(joinPaths(context.entryPath, findFilePath(filePath.value)), command.entry.input?.file || command.entry.file))}`);
+	const commandSourcePath = computed(() => replaceExtension(relativePath(joinPaths(context.entryPath, findFilePath(filePath.value)), command.entry.input?.file || command.entry.file)));
 	const typeDefinition = computed(() => ({
 		...command.entry,
 		output: command.id
@@ -303,7 +144,7 @@ function CommandEntry(props) {
 			return typeDefinition.value;
 		},
 		get imports() {
-			return defu(imports ?? {}, { [commandSourcePath.value]: `handle${pascalCase(command.name)}` });
+			return defu(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${pascalCase(command.name)}` });
 		},
 		get builtinImports() {
 			return defu(builtinImports ?? {}, {
@@ -316,11 +157,8 @@ function CommandEntry(props) {
 					"debug",
 					"warn",
 					"error",
-					"table",
 					"colors",
-					"stripAnsi",
-					"writeLine",
-					"splitText"
+					"writeLine"
 				],
 				utils: [
 					"useArgs",
@@ -328,22 +166,25 @@ function CommandEntry(props) {
 					"isMinimal",
 					"isUnicodeSupported",
 					"internal_commandContext"
-				]
+				],
+				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"]
 			});
 		},
 		get children() {
 			return [
 				createComponent(BannerFunctionDeclaration, { command }),
-				createIntrinsic("hbr", {}),
-				createIntrinsic("hbr", {}),
+				createComponent(Spacing, {}),
 				createComponent(OptionsInterfaceDeclaration, { command }),
-				createIntrinsic("hbr", {}),
-				createIntrinsic("hbr", {}),
+				createComponent(Spacing, {}),
 				createComponent(CommandHandlerDeclaration, {
 					command,
 					banner: code`banner(); `,
 					get children() {
-						return createComponent(CommandValidationLogic, { command });
+						return [createComponent(CommandValidationLogic, { command }), createComponent(IfStatement, {
+							condition: code`failures.length > 0`,
+							children: 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"));
+            options.help = true; `
+						})];
 					}
 				})
 			];
@@ -367,5 +208,5 @@ function CommandEntry(props) {
 }
 
 //#endregion
-export { CommandEntry, CommandHandlerDeclaration, CommandInvocation, CommandValidationLogic };
+export { CommandEntry, CommandHandlerDeclaration, CommandInvocation };
 //# sourceMappingURL=command-entry.mjs.map

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

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