@shell-shock/preset-script 0.5.0 → 0.6.0

package/README.md

@@ -27,7 +27,7 @@ This package is part of the ⚡<b>Shell Shock</b> monorepo. The Shell Shock pack
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.3.3-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://stormsoftware.com/projects/shell-shock/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/shell-shock/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.4.2-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://stormsoftware.com/projects/shell-shock/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/shell-shock/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/components/command-entry.cjs

@@ -14,6 +14,8 @@ let __stryke_path_replace = require("@stryke/path/replace");
 let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
 let defu = require("defu");
 defu = require_rolldown_runtime.__toESM(defu);
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __powerlines_plugin_alloy_core_components_single_line_comment = require("@powerlines/plugin-alloy/core/components/single-line-comment");
 let __shell_shock_core_components_options_parser_logic = require("@shell-shock/core/components/options-parser-logic");
 let __stryke_path_find = require("@stryke/path/find");
 let __stryke_path_join = require("@stryke/path/join");
@@ -188,7 +190,160 @@ function CommandEntry(props) {
 				(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)(CommandHandlerDeclaration, { command })
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_single_line_comment.SingleLineComment, { children: __alloy_js_core.code`Validate required options and arguments` }),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(CommandHandlerDeclaration, {
+					command,
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+								name: "failures",
+								type: "string[]",
+								initializer: __alloy_js_core.code`[];`
+							}),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+								get each() {
+									return Object.values(command.options ?? {});
+								},
+								doubleHardline: true,
+								children: (option) => [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+									get when() {
+										return !option.optional;
+									},
+									get children() {
+										return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+											get condition() {
+												return __alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}`;
+											},
+											get children() {
+												return __alloy_js_core.code`failures.push("Missing required \\"${option.name}\\" option");`;
+											}
+										}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+											get when() {
+												return (option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) && option.variadic;
+											},
+											get children() {
+												return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+													get condition() {
+														return __alloy_js_core.code`options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}.length === 0`;
+													},
+													get children() {
+														return __alloy_js_core.code`failures.push("No values were provided to the required \\"${option.name}\\" array option");`;
+													}
+												});
+											}
+										})];
+									}
+								}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+									get when() {
+										return option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number;
+									},
+									get children() {
+										return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+											get when() {
+												return option.variadic;
+											},
+											get fallback() {
+												return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+													get condition() {
+														return __alloy_js_core.code`options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} && Number.isNaN(options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`})`;
+													},
+													get children() {
+														return __alloy_js_core.code`failures.push("Invalid numeric value provided for the \\"${option.name}\\" option");`;
+													}
+												});
+											},
+											get children() {
+												return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+													get condition() {
+														return __alloy_js_core.code`options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}.some(value => Number.isNaN(value))`;
+													},
+													get children() {
+														return __alloy_js_core.code`failures.push("Invalid numeric value provided in the \\"${option.name}\\" array option");`;
+													}
+												});
+											}
+										});
+									}
+								})]
+							}),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+								get each() {
+									return command.arguments;
+								},
+								doubleHardline: true,
+								children: (argument) => [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+									get when() {
+										return !argument.optional;
+									},
+									get children() {
+										return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+											get condition() {
+												return __alloy_js_core.code`!${(0, __stryke_string_format_camel_case.camelCase)(argument.name)}`;
+											},
+											get children() {
+												return __alloy_js_core.code`failures.push("Missing required \\"${argument.name}\\" positional argument");`;
+											}
+										}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+											get when() {
+												return (argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) && argument.variadic;
+											},
+											get children() {
+												return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+													get condition() {
+														return __alloy_js_core.code`${(0, __stryke_string_format_camel_case.camelCase)(argument.name)}.length === 0`;
+													},
+													get children() {
+														return __alloy_js_core.code`failures.push("No values were provided to the required \\"${argument.name}\\" array positional argument");`;
+													}
+												});
+											}
+										})];
+									}
+								}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+									get when() {
+										return argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number;
+									},
+									get children() {
+										return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+											get when() {
+												return argument.variadic;
+											},
+											get fallback() {
+												return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+													get condition() {
+														return __alloy_js_core.code`${(0, __stryke_string_format_camel_case.camelCase)(argument.name)} && Number.isNaN(${(0, __stryke_string_format_camel_case.camelCase)(argument.name)})`;
+													},
+													get children() {
+														return __alloy_js_core.code`failures.push("Invalid numeric value provided for the \\"${argument.name}\\" positional argument");`;
+													}
+												});
+											},
+											get children() {
+												return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+													get condition() {
+														return __alloy_js_core.code`${(0, __stryke_string_format_camel_case.camelCase)(argument.name)}.some(value => Number.isNaN(value))`;
+													},
+													get children() {
+														return __alloy_js_core.code`failures.push("Invalid numeric value provided in the \\"${argument.name}\\" array positional argument");`;
+													}
+												});
+											}
+										});
+									}
+								})]
+							}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+								condition: __alloy_js_core.code`failures.length > 0`,
+								children: __alloy_js_core.code`error(colors.text.message.description.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 => colors.text.body.secondary(" - " + failure)).join("\\n"));
+            options.help = true; `
+							})
+						];
+					}
+				})
 			];
 		}
 	})), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","VarDeclaration","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","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","each","child","when","isVirtual","fallback"],"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 { 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 { CommandTree } 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      internal_commandContext.call(__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: \"getArgs()\" }]}>\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(\"\");\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        </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 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\", \"isCI\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"getArgs\",\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      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","ReflectionKind","SingleLineComment","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","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","each","doubleHardline","when","optional","includes","kind","string","number","variadic","fallback","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 { SingleLineComment } from \"@powerlines/plugin-alloy/core/components/single-line-comment\";\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      internal_commandContext.call(__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: \"getArgs()\" }]}>\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(\"\");\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        </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 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\", \"isCI\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"getArgs\",\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        <SingleLineComment>{code`Validate required options and arguments`}</SingleLineComment>\n        <hbr />\n        <CommandHandlerDeclaration command={command}>\n          <VarDeclaration\n            name=\"failures\"\n            type=\"string[]\"\n            initializer={code`[];`}\n          />\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(colors.text.message.description.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 => colors.text.body.secondary(\" - \" + 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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,SAAgBmC,kBAAkBC,OAAiC;CACjE,MAAM,EAAEC,YAAYD;AAEpB,QAAA;mDAEK5B,sCAAc;GACb+B,MAAI;GAAA,IACJC,cAAW;AAAA,WAAExC,oBAAI,aAAaqC,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;8CAInB5C,oBAAI;;;wGAIDqC,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;mDAE7E7C,2CAAmB;GAAA,UAAA;GAElBmD,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;KAIhD/D,oBAAI;;sDACM,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGVO,mCAAW;MAAA,IAACyD,YAAS;AAAA,+DAAG/B,oCAAO,EAAA,CAAA;;MAAA,IAAAkB,WAAA;AAAA,cAC7BnD,oBAAI;;;;;kCAKmBqC,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;;MACD,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;KAIRO;sDAAQ,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGR5C,mCAAW;MAACyD,WAAWhE,oBAAI;MAAc,IAAAmD,WAAA;AAAA,+DACvCnB,qCAAW,EAAUK,SAAO,CAAA;;MAAA,CAAA;sDAE9BjC,kCAAU,EAAA,IAAA+C,WAAA;AAAA,aAAA,kDAAA,OAAA,EAAA,CAAA,mDAERhB,mBAAiB,EAAUE,SAAO,CAAA,CAAA;QAAA,CAAA;KAAA;;GAAA,CAAA;EAAA;;;;;AAiB7C,SAAgBgC,aAAajC,OAA0B;CACrD,MAAM,EAAEC,SAASiC,SAASC,gBAAgB,GAAGC,SAASpC;CAEtD,MAAMgB,8EAA8C;CACpD,MAAMqB,iFAEFpC,QAAQI,SACLiC,QAAO/B,YAAW,2EAAsBA,QAAQ,CAAC,CACjDC,KAAK,IAAI,EACZ,WAEJ,CAAC;CACD,MAAM+B,2KAGUvB,QAAQwB,gDAAwBH,SAASI,MAAM,CAAC,EAC1DxC,QAAQyC,MAAMC,OAAOC,QAAQ3C,QAAQyC,MAAME,KAE/C,CACF,CAAC;CACD,MAAMC,sDAAiC;EACrC,GAAG5C,QAAQyC;EACXI,QAAQ7C,QAAQ8C;EACjB,EAAE;AAEH,QAAA,kDAEKvE,kHACK4D,MAAI;EAAA,IACRa,OAAI;AAAA,UAAEZ,SAASI;;EAAK,IACpBI,iBAAc;AAAA,UAAEA,eAAeJ;;EAAK,IACpCP,UAAO;AAAA,4BAAOA,WAAW,EAAE,EAAE,GAC1BK,kBAAkBE,QAAQ,4DAAoBxC,QAAQE,KAAK,IAC7D,CAAC;;EAAA,IACFgC,iBAAc;AAAA,4BAAOA,kBAAkB,EAAE,EAAE;IACzCe,KAAK;KAAC;KAAO;KAAQ;KAAiB;KAAU;IAChDC,SAAS;KACP;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD;IACDC,OAAO;KACL;KACA;KACA;KACA;KACA;KAAyB;IAE5B,CAAC;;EAAA,IAAArC,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;qDAG5C3B,iFAAiB,EAAAyC,UAAEnD,oBAAI,2CAAyC,CAAA;qDAAA,OAAA,EAAA,CAAA;qDAEhEkD,2BAAyB;KAAUb;KAAO,IAAAc,WAAA;AAAA,aAAA;wDACxC3C,sCAAc;QACb+B,MAAI;QACJoB,MAAI;QACJnB,aAAaxC,oBAAI;QAAK,CAAA;wDAAA,OAAA,EAAA,CAAA;wDAGvBE,qBAAG;QAAA,IAACuF,OAAI;AAAA,gBAAExB,OAAOC,OAAO7B,QAAQ8B,WAAW,EAAE,CAAC;;QAAEuB,gBAAc;QAAAvC,WAC5DiB,WAAM,kDAEFjE,sBAAI;SAAA,IAACwF,OAAI;AAAA,iBAAE,CAACvB,OAAOwB;;SAAQ,IAAAzC,WAAA;AAAA,iBAAA,kDACzB5C,mCAAW;WAAA,IACVyD,YAAS;AAAA,mBAAEhE,oBAAI,WACboE,OAAO7B,KAAKsD,SAAS,IAAI,GACrB,KAAKzB,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK;;WAC9B,IAAAY,WAAA;AAAA,mBACDnD,oBAAI,sCAAsCoE,OAAO7B,KAAI;;WAAe,CAAA,mDAEtEpC,sBAAI;WAAA,IACHwF,OAAI;AAAA,oBACDvB,OAAO0B,SAASrF,gDAAesF,UAC9B3B,OAAO0B,SAASrF,gDAAeuF,WACjC5B,OAAO6B;;WAAQ,IAAA9C,WAAA;AAAA,oEAEhB9C,oCAAY;aAAA,IACX2D,YAAS;AAAA,qBAAEhE,oBAAI,UACboE,OAAO7B,KAAKsD,SAAS,IAAI,GACrB,KAAKzB,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE;;aACnB,IAAAY,WAAA;AAAA,qBACdnD,oBAAI,6DACHoE,OAAO7B,KAAI;;aACQ,CAAA;;WAAA,CAAA,CAAA;;SAAA,CAAA,mDAI1BpC,sBAAI;SAAA,IAACwF,OAAI;AAAA,iBAAEvB,OAAO0B,SAASrF,gDAAeuF;;SAAM,IAAA7C,WAAA;AAAA,kEAC9ChD,sBAAI;WAAA,IACHwF,OAAI;AAAA,mBAAGvB,OAA+B6B;;WAAQ,IAC9CC,WAAQ;AAAA,oEACL3F,mCAAW;aAAA,IACVyD,YAAS;AAAA,qBAAEhE,oBAAI,UACboE,OAAO7B,KAAKsD,SAAS,IAAI,GACrB,KAAKzB,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE,0BAEhC6B,OAAO7B,KAAKsD,SAAS,IAAI,GACrB,KAAKzB,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE;;aAC/B,IAAAY,WAAA;AAAA,qBACFnD,oBAAI,4DACHoE,OAAO7B,KAAI;;aACE,CAAA;;WAAA,IAAAY,WAAA;AAAA,oEAGlB5C,mCAAW;aAAA,IACVyD,YAAS;AAAA,qBAAEhE,oBAAI,UACboE,OAAO7B,KAAKsD,SAAS,IAAI,GACrB,KAAKzB,OAAO7B,KAAI,MAChB,qDAAc6B,OAAO7B,KAAK,GAAE;;aACG,IAAAY,WAAA;AAAA,qBACpCnD,oBAAI,2DACHoE,OAAO7B,KAAI;;aACQ,CAAA;;WAAA,CAAA;;SAAA,CAAA,CAAA;QAK9B,CAAA;wDAAA,OAAA,EAAA,CAAA;wDAAA,OAAA,EAAA,CAAA;wDAIFrC,qBAAG;QAAA,IAACuF,OAAI;AAAA,gBAAEpD,QAAQU;;QAAW2C,gBAAc;QAAAvC,WACzCF,aAAQ,kDAEJ9C,sBAAI;SAAA,IAACwF,OAAI;AAAA,iBAAE,CAAC1C,SAAS2C;;SAAQ,IAAAzC,WAAA;AAAA,iBAAA,kDAC3B5C,mCAAW;WAAA,IAACyD,YAAS;AAAA,mBAAEhE,oBAAI,qDAAciD,SAASV,KAAK;;WAAE,IAAAY,WAAA;AAAA,mBACvDnD,oBAAI,sCACHiD,SAASV,KAAI;;WACa,CAAA,mDAE7BpC,sBAAI;WAAA,IACHwF,OAAI;AAAA,oBACD1C,SAAS6C,SAASrF,gDAAesF,UAChC9C,SAAS6C,SAASrF,gDAAeuF,WACnC/C,SAASgD;;WAAQ,IAAA9C,WAAA;AAAA,oEAElB9C,oCAAY;aAAA,IACX2D,YAAS;AAAA,qBAAEhE,oBAAI,oDAAaiD,SAASV,KAAK,CAAA;;aAAe,IAAAY,WAAA;AAAA,qBACxDnD,oBAAI,6DACHiD,SAASV,KAAI;;aACmB,CAAA;;WAAA,CAAA,CAAA;;SAAA,CAAA,mDAIvCpC,sBAAI;SAAA,IAACwF,OAAI;AAAA,iBAAE1C,SAAS6C,SAASrF,gDAAeuF;;SAAM,IAAA7C,WAAA;AAAA,kEAChDhD,sBAAI;WAAA,IACHwF,OAAI;AAAA,mBAAG1C,SAAmCgD;;WAAQ,IAClDC,WAAQ;AAAA,oEACL3F,mCAAW;aAAA,IACVyD,YAAS;AAAA,qBAAEhE,oBAAI,oDACbiD,SAASV,KACV,CAAA,oEAA8BU,SAASV,KAAK,CAAA;;aAAG,IAAAY,WAAA;AAAA,qBAC/CnD,oBAAI,4DACHiD,SAASV,KAAI;;aACa,CAAA;;WAAA,IAAAY,WAAA;AAAA,oEAG/B5C,mCAAW;aAAA,IACVyD,YAAS;AAAA,qBAAEhE,oBAAI,oDAAaiD,SAASV,KAAK,CAAA;;aAAqC,IAAAY,WAAA;AAAA,qBAC9EnD,oBAAI,2DACHiD,SAASV,KAAI;;aACmB,CAAA;;WAAA,CAAA;;SAAA,CAAA,CAAA;QAK3C,CAAA;wDAEFhC,mCAAW;QAACyD,WAAWhE,oBAAI;QAAqBmD,UAC9CnD,oBAAI;;QACiB,CAAA;OAAA;;KAAA,CAAA;IAAA;;EAAA,CAAA,CAAA,mDAI3BE,qBAAG;EAAA,IAACuF,OAAI;AAAA,UAAExB,OAAOC,OAAO7B,QAAQc,SAAS;;EAAAA,WACvCgD,2DACEhG,sBAAI;GAAA,IACHwF,OAAI;AAAA,WAAEQ,MAAMC;;GAAS,IACrBF,WAAQ;AAAA,4DAAG7B,cAAY,EAAChC,SAAS8D,OAAK,CAAA;;GAAA,IAAAhD,WAAA;AAAA,4DACrCjB,8DAAmB,EAACG,SAAS8D,OAAK,CAAA;;GAAA,CAAA;EAEtC,CAAA,CAAA"}

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":";;;;;iBA2DgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AA2CC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA8FC,QAAA,CAAA,EApGJ,QAoGI;;;;;AAUD,iBAxGA,yBAAA,CAwGqC,KAAA,EAvG5C,8BAuG4C,CAAA,EAvGd,QAuGc;UAVpC,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;AA2CC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA8FC,QAAA,CAAA,EApGJ,QAoGI;;;;;AAUD,iBAxGA,yBAAA,CAwGqC,KAAA,EAvG5C,8BAuG4C,CAAA,EAvGd,QAuGc;UAVpC,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

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":";;;;;iBA2DgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AA2CC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA8FC,QAAA,CAAA,EApGJ,QAoGI;;;;;AAUD,iBAxGA,yBAAA,CAwGqC,KAAA,EAvG5C,8BAuG4C,CAAA,EAvGd,QAuGc;UAVpC,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;AA2CC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA8FC,QAAA,CAAA,EApGJ,QAoGI;;;;;AAUD,iBAxGA,yBAAA,CAwGqC,KAAA,EAvG5C,8BAuG4C,CAAA,EAvGd,QAuGc;UAVpC,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.mjs

@@ -4,7 +4,7 @@ import { IsDebug } from "./helpers.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, FunctionDeclaration, IfStatement, VarDeclaration } from "@alloy-js/typescript";
+import { ElseClause, ElseIfClause, FunctionDeclaration, IfStatement, VarDeclaration } from "@alloy-js/typescript";
 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";
@@ -12,6 +12,8 @@ import { TSDoc, TSDocParam, TSDocRemarks, TSDocTitle } from "@powerlines/plugin-
 import { replaceExtension } from "@stryke/path/replace";
 import { pascalCase } from "@stryke/string-format/pascal-case";
 import defu from "defu";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { SingleLineComment } from "@powerlines/plugin-alloy/core/components/single-line-comment";
 import { CommandParserLogic, OptionsInterfaceDeclaration } from "@shell-shock/core/components/options-parser-logic";
 import { findFilePath, relativePath } from "@stryke/path/find";
 import { joinPaths } from "@stryke/path/join";
@@ -186,7 +188,160 @@ function CommandEntry(props) {
 				createComponent(OptionsInterfaceDeclaration, { command }),
 				createIntrinsic("hbr", {}),
 				createIntrinsic("hbr", {}),
-				createComponent(CommandHandlerDeclaration, { command })
+				createComponent(SingleLineComment, { children: code`Validate required options and arguments` }),
+				createIntrinsic("hbr", {}),
+				createComponent(CommandHandlerDeclaration, {
+					command,
+					get children() {
+						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 === ReflectionKind.string || option.kind === ReflectionKind.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 === ReflectionKind.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");`;
+													}
+												});
+											}
+										});
+									}
+								})]
+							}),
+							createIntrinsic("hbr", {}),
+							createIntrinsic("hbr", {}),
+							createComponent(For, {
+								get each() {
+									return command.arguments;
+								},
+								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 === ReflectionKind.string || argument.kind === ReflectionKind.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 === ReflectionKind.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(colors.text.message.description.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 => colors.text.body.secondary(" - " + failure)).join("\\n"));
+            options.help = true; `
+							})
+						];
+					}
+				})
 			];
 		}
 	})), createComponent(For, {

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","VarDeclaration","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","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","each","child","when","isVirtual","fallback"],"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 { 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 { CommandTree } 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      internal_commandContext.call(__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: \"getArgs()\" }]}>\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(\"\");\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        </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 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\", \"isCI\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"getArgs\",\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      </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","SingleLineComment","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","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","each","doubleHardline","when","optional","includes","kind","string","number","variadic","fallback","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 { SingleLineComment } from \"@powerlines/plugin-alloy/core/components/single-line-comment\";\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      internal_commandContext.call(__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: \"getArgs()\" }]}>\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(\"\");\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        </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 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\", \"isCI\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"getArgs\",\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        <SingleLineComment>{code`Validate required options and arguments`}</SingleLineComment>\n        <hbr />\n        <CommandHandlerDeclaration command={command}>\n          <VarDeclaration\n            name=\"failures\"\n            type=\"string[]\"\n            initializer={code`[];`}\n          />\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(colors.text.message.description.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 => colors.text.body.secondary(\" - \" + 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/help.cjs

@@ -5,8 +5,8 @@ let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 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_kebab_case = require("@stryke/string-format/kebab-case");
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let __shell_shock_core_plugin_utils_reflect = require("@shell-shock/core/plugin-utils/reflect");
 let __stryke_string_format_snake_case = require("@stryke/string-format/snake-case");
 

package/dist/components/help.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core3 from "@alloy-js/core";
+import * as _alloy_js_core10 from "@alloy-js/core";
 import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/help.d.ts
@@ -20,7 +20,7 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core3.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core10.Children;
 interface HelpOptionsProps {
   /**
    * The options to display help for.
@@ -30,7 +30,7 @@ interface HelpOptionsProps {
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core3.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core10.Children;
 interface HelpCommandsProps {
   /**
    * A mapping of command names to their command definitions.
@@ -40,7 +40,7 @@ interface HelpCommandsProps {
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core3.Children;
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core10.Children;
 interface BaseHelpProps {
   /**
    * The command to generate help for.
@@ -68,7 +68,7 @@ interface BaseHelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function BaseHelp(props: BaseHelpProps): _alloy_js_core3.Children;
+declare function BaseHelp(props: BaseHelpProps): _alloy_js_core10.Children;
 interface VirtualHelpProps {
   /**
    * The options to display help for.
@@ -89,7 +89,7 @@ interface VirtualHelpProps {
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core3.Children;
+declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core10.Children;
 interface CommandHelpProps {
   /**
    * A mapping of command names to their command definitions.
@@ -99,7 +99,7 @@ interface CommandHelpProps {
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function CommandHelp(props: CommandHelpProps): _alloy_js_core3.Children;
+declare function CommandHelp(props: CommandHelpProps): _alloy_js_core10.Children;
 //#endregion
 export { BaseHelp, BaseHelpProps, CommandHelp, CommandHelpProps, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpUsage, HelpUsageProps, VirtualHelp, VirtualHelpProps };
 //# sourceMappingURL=help.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAoCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA6FR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAsDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAwDA;AAUgB,iBApXA,SAAA,CAoXmB,KAAA,EApXF,cAoXkB,CAAA,EApXJ,eAAA,CAAA,QAoXI;UAvRlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAsD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}
+{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAoCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA6FR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAsDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAwDA;AAUgB,iBApXA,SAAA,CAoXmB,KAAA,EApXF,cAoXkB,CAAA,EApXJ,gBAAA,CAAA,QAoXI;UAvRlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,gBAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,gBAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,gBAAA,CAAA;UAsD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,gBAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,gBAAA,CAAA"}

package/dist/components/help.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core10 from "@alloy-js/core";
+import * as _alloy_js_core3 from "@alloy-js/core";
 import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/help.d.ts
@@ -20,7 +20,7 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core10.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core3.Children;
 interface HelpOptionsProps {
   /**
    * The options to display help for.
@@ -30,7 +30,7 @@ interface HelpOptionsProps {
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core10.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core3.Children;
 interface HelpCommandsProps {
   /**
    * A mapping of command names to their command definitions.
@@ -40,7 +40,7 @@ interface HelpCommandsProps {
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core10.Children;
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core3.Children;
 interface BaseHelpProps {
   /**
    * The command to generate help for.
@@ -68,7 +68,7 @@ interface BaseHelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function BaseHelp(props: BaseHelpProps): _alloy_js_core10.Children;
+declare function BaseHelp(props: BaseHelpProps): _alloy_js_core3.Children;
 interface VirtualHelpProps {
   /**
    * The options to display help for.
@@ -89,7 +89,7 @@ interface VirtualHelpProps {
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core10.Children;
+declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core3.Children;
 interface CommandHelpProps {
   /**
    * A mapping of command names to their command definitions.
@@ -99,7 +99,7 @@ interface CommandHelpProps {
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function CommandHelp(props: CommandHelpProps): _alloy_js_core10.Children;
+declare function CommandHelp(props: CommandHelpProps): _alloy_js_core3.Children;
 //#endregion
 export { BaseHelp, BaseHelpProps, CommandHelp, CommandHelpProps, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpUsage, HelpUsageProps, VirtualHelp, VirtualHelpProps };
 //# sourceMappingURL=help.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAoCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA6FR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAsDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAwDA;AAUgB,iBApXA,SAAA,CAoXmB,KAAA,EApXF,cAoXkB,CAAA,EApXJ,gBAAA,CAAA,QAoXI;UAvRlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,gBAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,gBAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,gBAAA,CAAA;UAsD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,gBAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,gBAAA,CAAA"}
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAoCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA6FR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAsDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAwDA;AAUgB,iBApXA,SAAA,CAoXmB,KAAA,EApXF,cAoXkB,CAAA,EApXJ,eAAA,CAAA,QAoXI;UAvRlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAsD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}

package/dist/components/help.mjs

@@ -4,8 +4,8 @@ import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runti
 import { For, Show, code, computed } from "@alloy-js/core";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment } from "@shell-shock/core/plugin-utils/context-helpers";
-import { kebabCase } from "@stryke/string-format/kebab-case";
 import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { kebabCase } from "@stryke/string-format/kebab-case";
 import { sortOptions } from "@shell-shock/core/plugin-utils/reflect";
 import { snakeCase } from "@stryke/string-format/snake-case";
 

package/dist/components/utils-builtin.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core9 from "@alloy-js/core";
+import * as _alloy_js_core3 from "@alloy-js/core";
 import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 
 //#region src/components/utils-builtin.d.ts
@@ -6,28 +6,28 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function EnvSupportUtilities(): _alloy_js_core9.Children;
+declare function EnvSupportUtilities(): _alloy_js_core3.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ColorSupportUtilities(): _alloy_js_core9.Children;
+declare function ColorSupportUtilities(): _alloy_js_core3.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function HyperlinkSupportUtilities(): _alloy_js_core9.Children;
+declare function HyperlinkSupportUtilities(): _alloy_js_core3.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ArgsUtilities(): _alloy_js_core9.Children;
+declare function ArgsUtilities(): _alloy_js_core3.Children;
 /**
  * The `exit` handler function declaration code for the Shell Shock project.
  */
-declare function ExitFunctionDeclaration(): _alloy_js_core9.Children;
-declare function ContextUtilities(): _alloy_js_core9.Children;
+declare function ExitFunctionDeclaration(): _alloy_js_core3.Children;
+declare function ContextUtilities(): _alloy_js_core3.Children;
 /**
  * A built-in utilities module for Shell Shock.
  */
-declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core9.Children;
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core3.Children;
 //#endregion
 export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
 //# sourceMappingURL=utils-builtin.d.cts.map

package/dist/components/utils-builtin.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core3 from "@alloy-js/core";
+import * as _alloy_js_core9 from "@alloy-js/core";
 import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 
 //#region src/components/utils-builtin.d.ts
@@ -6,28 +6,28 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function EnvSupportUtilities(): _alloy_js_core3.Children;
+declare function EnvSupportUtilities(): _alloy_js_core9.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ColorSupportUtilities(): _alloy_js_core3.Children;
+declare function ColorSupportUtilities(): _alloy_js_core9.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function HyperlinkSupportUtilities(): _alloy_js_core3.Children;
+declare function HyperlinkSupportUtilities(): _alloy_js_core9.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ArgsUtilities(): _alloy_js_core3.Children;
+declare function ArgsUtilities(): _alloy_js_core9.Children;
 /**
  * The `exit` handler function declaration code for the Shell Shock project.
  */
-declare function ExitFunctionDeclaration(): _alloy_js_core3.Children;
-declare function ContextUtilities(): _alloy_js_core3.Children;
+declare function ExitFunctionDeclaration(): _alloy_js_core9.Children;
+declare function ContextUtilities(): _alloy_js_core9.Children;
 /**
  * A built-in utilities module for Shell Shock.
  */
-declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core3.Children;
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core9.Children;
 //#endregion
 export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
 //# sourceMappingURL=utils-builtin.d.mts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-script",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "A Shell Shock preset that generates a fully-featured script application.",
   "repository": {
@@ -296,8 +296,8 @@
     "@powerlines/deepkit": "^0.6.51",
     "@powerlines/plugin-alloy": "^0.20.15",
     "@powerlines/plugin-plugin": "^0.12.222",
-    "@shell-shock/core": "^0.8.0",
-    "@shell-shock/plugin-theme": "^0.0.17",
+    "@shell-shock/core": "^0.8.1",
+    "@shell-shock/plugin-theme": "^0.0.18",
     "@stryke/path": "0.26.4",
     "@stryke/string-format": "0.13.7",
     "defu": "6.1.4",
@@ -310,5 +310,5 @@
     "@types/node": "^22.19.10"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "a3710248496a9b6251c18d6ee4af3587a0dc1fa5"
+  "gitHead": "2d179aff07a4c04d5ff4a96ceed082077a51a7e6"
 }