@shell-shock/preset-cli 0.7.13 → 0.8.3

package/dist/components/command-entry.cjs

@@ -1,22 +1,24 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_components_banner_function_declaration = require('./banner-function-declaration.cjs');
 const require_components_virtual_command_entry = require('./virtual-command-entry.cjs');
-let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let __alloy_js_core = require("@alloy-js/core");
-let __alloy_js_typescript = require("@alloy-js/typescript");
-let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
-let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
-let __powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
-let __shell_shock_core = require("@shell-shock/core");
-let __shell_shock_preset_script_components_command_entry = require("@shell-shock/preset-script/components/command-entry");
-let __stryke_path_find = require("@stryke/path/find");
-let __stryke_path_join = require("@stryke/path/join");
-let __stryke_path_replace = require("@stryke/path/replace");
-let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
-let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _shell_shock_core = require("@shell-shock/core");
 let defu = require("defu");
-defu = require_rolldown_runtime.__toESM(defu);
+defu = require_runtime.__toESM(defu);
+let _stryke_path_join = require("@stryke/path/join");
+let _powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
+let _shell_shock_core_components_command_validation_logic = require("@shell-shock/core/components/command-validation-logic");
+let _shell_shock_preset_script_components_command_entry = require("@shell-shock/preset-script/components/command-entry");
+let _stryke_path_find = require("@stryke/path/find");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
 
 //#region src/components/command-entry.tsx
 /**
@@ -24,14 +26,14 @@ defu = require_rolldown_runtime.__toESM(defu);
 */
 function CommandEntry(props) {
 	const { command, imports, builtinImports, ...rest } = props;
-	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const filePath = (0, __alloy_js_core.computed)(() => (0, __stryke_path_join.joinPaths)(command.segments.filter((segment) => !(0, __shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)).join("/"), "index.ts"));
-	const commandSourcePath = (0, __alloy_js_core.computed)(() => `./${(0, __stryke_path_replace.replaceExtension)((0, __stryke_path_find.relativePath)((0, __stryke_path_join.joinPaths)(context.entryPath, (0, __stryke_path_find.findFilePath)(filePath.value)), command.entry.input?.file || command.entry.file))}`);
-	const typeDefinition = (0, __alloy_js_core.computed)(() => ({
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const filePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_join.joinPaths)(command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)).join("/"), "index.ts"));
+	const commandSourcePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_replace.replaceExtension)((0, _stryke_path_find.relativePath)((0, _stryke_path_join.joinPaths)(context.entryPath, (0, _stryke_path_find.findFilePath)(filePath.value)), command.entry.input?.file || command.entry.file)));
+	const typeDefinition = (0, _alloy_js_core.computed)(() => ({
 		...command.entry,
 		output: command.id
 	}));
-	return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_entry_file.EntryFile, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_entry_file.EntryFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
 		get path() {
 			return filePath.value;
 		},
@@ -39,10 +41,7 @@ function CommandEntry(props) {
 			return typeDefinition.value;
 		},
 		get imports() {
-			return (0, defu.default)(imports ?? {}, {
-				[commandSourcePath.value]: `handle${(0, __stryke_string_format_pascal_case.pascalCase)(command.name)}`,
-				prompts: "prompts"
-			});
+			return (0, defu.default)(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}` });
 		},
 		get builtinImports() {
 			return (0, defu.default)(builtinImports ?? {}, {
@@ -86,66 +85,80 @@ function CommandEntry(props) {
 					"isCancel",
 					"sleep"
 				],
-				upgrade: [
-					"checkForUpdates",
-					"isCheckForUpdatesRequired",
-					"upgrade"
-				]
+				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"],
+				upgrade: ["executeUpgrade"]
 			});
 		},
 		get children() {
 			return [
-				(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_preset_script_components_command_entry.CommandHandlerDeclaration, {
+				(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_preset_script_components_command_entry.CommandHandlerDeclaration, {
 					command,
-					banner: __alloy_js_core.code`await banner(); `,
+					banner: _alloy_js_core.code`await banner();
+          await executeUpgrade(); `,
 					get children() {
-						return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-							condition: __alloy_js_core.code`!isInteractive`,
+						return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+							condition: _alloy_js_core.code`!isInteractive`,
 							get children() {
-								return (0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_preset_script_components_command_entry.CommandValidationLogic, { command });
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_command_validation_logic.CommandValidationLogic, { command });
 							}
-						}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 							get when() {
 								return Object.values(command.options ?? {}).filter((option) => !option.optional).length > 0 || Object.values(command.args ?? {}).filter((arg) => !arg.optional).length > 0;
 							},
 							get children() {
-								return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
 									get condition() {
-										return __alloy_js_core.code`!isHelp && (${Object.values(command.options ?? {}).filter((option) => !option.optional).map((option) => (option.kind === __shell_shock_core.CommandParameterKinds.string || option.kind === __shell_shock_core.CommandParameterKinds.number) && option.variadic ? `(!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} || options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}.length === 0)` : `options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} === undefined`).join(" || ")}${Object.values(command.options ?? {}).filter((option) => !option.optional).length > 0 && Object.values(command.args ?? {}).filter((arg) => !arg.optional).length > 0 ? " || " : ""}${Object.values(command.args ?? {}).filter((arg) => !arg.optional).map((arg) => (arg.kind === __shell_shock_core.CommandParameterKinds.string || arg.kind === __shell_shock_core.CommandParameterKinds.number) && arg.variadic ? `(!${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} || ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)}.length === 0)` : `${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} === undefined`).join(" || ")}) `;
+										return _alloy_js_core.code`!isHelp && (${Object.values(command.options ?? {}).filter((option) => !option.optional).map((option) => (option.kind === _shell_shock_core.CommandParameterKinds.string || option.kind === _shell_shock_core.CommandParameterKinds.number) && option.variadic ? `(!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} || options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}.length === 0)` : `options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} === undefined`).join(" || ")}${Object.values(command.options ?? {}).filter((option) => !option.optional).length > 0 && Object.values(command.args ?? {}).filter((arg) => !arg.optional).length > 0 ? " || " : ""}${Object.values(command.args ?? {}).filter((arg) => !arg.optional).map((arg) => (arg.kind === _shell_shock_core.CommandParameterKinds.string || arg.kind === _shell_shock_core.CommandParameterKinds.number) && arg.variadic ? `(!${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} || ${(0, _stryke_string_format_camel_case.camelCase)(arg.name)}.length === 0)` : `${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} === undefined`).join(" || ")}) `;
 									},
 									get children() {
 										return [
-											__alloy_js_core.code`writeLine(""); `,
-											(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-											(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+											_alloy_js_core.code`writeLine(""); `,
+											(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+											(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 												get each() {
 													return Object.values(command.options ?? {});
 												},
 												doubleHardline: true,
-												children: (option) => [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+												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, {
+														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)}`}`;
+																return _alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}`;
 															},
 															get children() {
-																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Switch, { get children() {
-																	return [
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return option.kind === __shell_shock_core.CommandParameterKinds.string;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+																	get when() {
+																		return option.kind === _shell_shock_core.CommandParameterKinds.boolean || !option.choices || option.choices.length === 0;
+																	},
+																	get fallback() {
+																		return _alloy_js_core.code`const value = await select({
+                              message: \`Please select a value for the \${colors.italic("${option.name}")} option\`, ${option.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
+                              ` : ""}options: [ ${option.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${option.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(option.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
+                          `;
+																	},
+																	get children() {
+																		return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Switch, { get children() {
+																			return [
+																				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
+																					get when() {
+																						return option.kind === _shell_shock_core.CommandParameterKinds.string;
+																					},
+																					get children() {
+																						return _alloy_js_core.code`
                             const value = await text({
                               message: \`Please provide a value for the \${colors.italic("${option.name}")} option\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this option";
@@ -158,65 +171,67 @@ function CommandEntry(props) {
                               return;
                             }
 
-                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return option.kind === __shell_shock_core.CommandParameterKinds.number;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
+																					get when() {
+																						return option.kind === _shell_shock_core.CommandParameterKinds.number;
+																					},
+																					get children() {
+																						return _alloy_js_core.code`
                             const value = await numeric({
                               message: \`Please provide a numeric value for the \${colors.italic("${option.name}")} option\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
                               return;
                             }
 
-                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return option.kind === __shell_shock_core.CommandParameterKinds.boolean;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
+																					get when() {
+																						return option.kind === _shell_shock_core.CommandParameterKinds.boolean;
+																					},
+																					get children() {
+																						return _alloy_js_core.code`
                             const value = await toggle({
                               message: \`Please select a value for the \${colors.italic("${option.name}")} option\`,
-                            ${option.description ? `description: "${option.description}",
+                            ${option.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
                               return;
                             }
 
-                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
                           `;
-																			}
-																		})
-																	];
-																} });
+																					}
+																				})
+																			];
+																		} });
+																	}
+																});
 															}
-														}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+														}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 															get when() {
-																return (option.kind === __shell_shock_core.CommandParameterKinds.string || option.kind === __shell_shock_core.CommandParameterKinds.number) && option.variadic;
+																return (option.kind === _shell_shock_core.CommandParameterKinds.string || option.kind === _shell_shock_core.CommandParameterKinds.number) && option.variadic;
 															},
 															get children() {
-																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+																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`;
+																		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`
+																		return _alloy_js_core.code`
                             const value = await text({
-                              message: \`Please provide one or more${option.kind === __shell_shock_core.CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${option.name}")} option (values are separated by a \\",\\" character)\`,
-                              ${option.description ? `description: "${option.description}",
+                              message: \`Please provide one or more${option.kind === _shell_shock_core.CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${option.name}")} option (values are separated by a \\",\\" character)\`,
+                              ${option.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this option";
@@ -224,7 +239,7 @@ function CommandEntry(props) {
                                 if (val.split(",").map(v => v.trim()).filter(Boolean).length === 0) {
                                   return "At least one value must be provided for this option";
                                 }
-                                ${option.kind === __shell_shock_core.CommandParameterKinds.number ? `const invalidIndex = val.split(",").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));
+                                ${option.kind === _shell_shock_core.CommandParameterKinds.number ? `const invalidIndex = val.split(",").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));
                                     if (invalidIndex !== -1) {
                                       return \`Invalid numeric value provided for item #\${invalidIndex + 1} - all provided items must be a valid number\`;
                                     } ` : ""}
@@ -235,7 +250,7 @@ function CommandEntry(props) {
                               return;
                             }
 
-                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value.split(",").map(value => value.trim()).filter(Boolean)${option.kind === __shell_shock_core.CommandParameterKinds.number ? `.map(Number)` : ""} ;
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`} = value.split(",").map(value => value.trim()).filter(Boolean)${option.kind === _shell_shock_core.CommandParameterKinds.number ? `.map(Number)` : ""} ;
                           `;
 																	}
 																});
@@ -244,33 +259,51 @@ function CommandEntry(props) {
 													}
 												})]
 											}),
-											(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-											(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+											(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+											(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 												get each() {
 													return command.args;
 												},
 												doubleHardline: true,
-												children: (arg) => [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+												children: (arg) => [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 													get when() {
 														return !arg.optional;
 													},
 													get children() {
-														return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+														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)(arg.name)}`;
+																return _alloy_js_core.code`!${(0, _stryke_string_format_camel_case.camelCase)(arg.name)}`;
 															},
 															get children() {
-																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Switch, { get children() {
-																	return [
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return arg.kind === __shell_shock_core.CommandParameterKinds.string;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+																	get when() {
+																		return arg.kind === _shell_shock_core.CommandParameterKinds.boolean || !arg.choices || arg.choices.length === 0;
+																	},
+																	get fallback() {
+																		return _alloy_js_core.code`const value = await select({
+                              message: \`Please select a value for the \${colors.italic("${arg.name}")} argument\`,${arg.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatDescription)(arg.description)}\`,
+                              ` : ""}
+                              options: [ ${arg.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${arg.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} = value;
+                          `;
+																	},
+																	get children() {
+																		return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Switch, { get children() {
+																			return [
+																				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
+																					get when() {
+																						return arg.kind === _shell_shock_core.CommandParameterKinds.string;
+																					},
+																					get children() {
+																						return _alloy_js_core.code`
                             const value = await text({
                               message: \`Please provide a value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this argument";
@@ -283,65 +316,67 @@ function CommandEntry(props) {
                               return;
                             }
 
-                            ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
+                            ${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return arg.kind === __shell_shock_core.CommandParameterKinds.number;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
+																					get when() {
+																						return arg.kind === _shell_shock_core.CommandParameterKinds.number;
+																					},
+																					get children() {
+																						return _alloy_js_core.code`
                             const value = await numeric({
                               message: \`Please provide a numeric value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
                               return;
                             }
 
-                            ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
+                            ${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return arg.kind === __shell_shock_core.CommandParameterKinds.boolean;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
+																					get when() {
+																						return arg.kind === _shell_shock_core.CommandParameterKinds.boolean;
+																					},
+																					get children() {
+																						return _alloy_js_core.code`
                             const value = await toggle({
                               message: \`Please select a value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
                               return;
                             }
 
-                            ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
+                            ${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} = value;
                           `;
-																			}
-																		})
-																	];
-																} });
+																					}
+																				})
+																			];
+																		} });
+																	}
+																});
 															}
-														}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+														}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 															get when() {
-																return (arg.kind === __shell_shock_core.CommandParameterKinds.string || arg.kind === __shell_shock_core.CommandParameterKinds.number) && arg.variadic;
+																return (arg.kind === _shell_shock_core.CommandParameterKinds.string || arg.kind === _shell_shock_core.CommandParameterKinds.number) && arg.variadic;
 															},
 															get children() {
-																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+																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)(arg.name)}.length === 0`;
+																		return _alloy_js_core.code`${(0, _stryke_string_format_camel_case.camelCase)(arg.name)}.length === 0`;
 																	},
 																	get children() {
-																		return __alloy_js_core.code`
+																		return _alloy_js_core.code`
                             const value = await text({
-                              message: \`Please provide one or more${arg.kind === __shell_shock_core.CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${arg.name}")} argument (values are separated by a \\",\\" character)\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              message: \`Please provide one or more${arg.kind === _shell_shock_core.CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${arg.name}")} argument (values are separated by a \\",\\" character)\`,
+                              ${arg.description ? `description: \`${(0, _shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this argument";
@@ -349,7 +384,7 @@ function CommandEntry(props) {
                                 if (val.split(",").map(v => v.trim()).filter(Boolean).length === 0) {
                                   return "At least one value must be provided for this argument";
                                 }
-                                ${arg.kind === __shell_shock_core.CommandParameterKinds.number ? `const invalidIndex = val.split(",").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));
+                                ${arg.kind === _shell_shock_core.CommandParameterKinds.number ? `const invalidIndex = val.split(",").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));
                                     if (invalidIndex !== -1) {
                                       return \`Invalid numeric value provided for item #\${invalidIndex + 1} - all provided items must be a valid number\`;
                                     } ` : ""}
@@ -361,7 +396,7 @@ function CommandEntry(props) {
                               return;
                             }
 
-                            ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value.split(",").map(value => value.trim()).filter(Boolean)${arg.kind === __shell_shock_core.CommandParameterKinds.number ? `.map(Number)` : ""} ;
+                            ${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} = value.split(",").map(value => value.trim()).filter(Boolean)${arg.kind === _shell_shock_core.CommandParameterKinds.number ? `.map(Number)` : ""} ;
                           `;
 																	}
 																});
@@ -370,8 +405,14 @@ function CommandEntry(props) {
 													}
 												})]
 											}),
-											__alloy_js_core.code`writeLine(""); `,
-											(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+											_alloy_js_core.code`writeLine(""); `,
+											(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+											(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_command_validation_logic.CommandValidationLogic, { command }),
+											(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("The following validation failures were found while processing the user provided input, and must be corrected before the command-line process can be executed: \\n\\n" + failures.map(failure => " - " + failure).join("\\n"));
+                options.help = true; `
+											})
 										];
 									}
 								});
@@ -381,19 +422,19 @@ function CommandEntry(props) {
 				})
 			];
 		}
-	})), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+	})), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 		get each() {
 			return Object.values(command.children);
 		},
-		children: (child) => (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+		children: (child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			get when() {
 				return child.isVirtual;
 			},
 			get fallback() {
-				return (0, __alloy_js_core_jsx_runtime.createComponent)(CommandEntry, { command: child });
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandEntry, { command: child });
 			},
 			get children() {
-				return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
 			}
 		})
 	})];

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

@@ -1,4 +1,4 @@
-import * as _alloy_js_core2 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core";
 
@@ -9,7 +9,7 @@ interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinitio
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core2.Children;
+declare function CommandEntry(props: CommandEntryProps): _alloy_js_core0.Children;
 //#endregion
 export { CommandEntry, CommandEntryProps };
 //# sourceMappingURL=command-entry.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAyCiB,iBAAA,SAA0B,KACzC;WAGS;;AAJX;;;AAA2C,iBAU3B,YAAA,CAV2B,KAAA,EAUP,iBAVO,CAAA,EAUU,eAAA,CAAA,QAVV"}
+{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"mappings":";;;;;UA+CiB,iBAAA,SAA0B,IAAA,CACzC,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;AAJX;;;AAAA,iBAUgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,eAAA,CAAA,QAAA"}

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

@@ -1,6 +1,6 @@
-import * as _alloy_js_core2 from "@alloy-js/core";
-import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
+import * as _alloy_js_core0 from "@alloy-js/core";
 import { CommandTree } from "@shell-shock/core";
+import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 
 //#region src/components/command-entry.d.ts
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
@@ -9,7 +9,7 @@ interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinitio
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core2.Children;
+declare function CommandEntry(props: CommandEntryProps): _alloy_js_core0.Children;
 //#endregion
 export { CommandEntry, CommandEntryProps };
 //# sourceMappingURL=command-entry.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAyCiB,iBAAA,SAA0B,KACzC;WAGS;;AAJX;;;AAA2C,iBAU3B,YAAA,CAV2B,KAAA,EAUP,iBAVO,CAAA,EAUU,eAAA,CAAA,QAVV"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"mappings":";;;;;UA+CiB,iBAAA,SAA0B,IAAA,CACzC,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;AAJX;;;AAAA,iBAUgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,eAAA,CAAA,QAAA"}