@shell-shock/preset-cli 0.1.6 → 0.3.0

package/dist/components/command-entry.mjs

@@ -1,13 +1,13 @@
 import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
 import { VirtualCommandEntry } from "./virtual-command-entry.mjs";
-import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { For, Show, code, computed } from "@alloy-js/core";
-import { ElseIfClause, IfStatement, VarDeclaration } from "@alloy-js/typescript";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, Match, Show, Switch, code, computed } from "@alloy-js/core";
+import { ElseIfClause, IfStatement } from "@alloy-js/typescript";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { isDynamicPathSegment } from "@shell-shock/core/plugin-utils/context-helpers";
 import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
-import { CommandHandlerDeclaration } from "@shell-shock/preset-script/components/command-entry";
+import { CommandHandlerDeclaration, CommandValidationLogic } from "@shell-shock/preset-script/components/command-entry";
 import { findFilePath, relativePath } from "@stryke/path/find";
 import { joinPaths } from "@stryke/path/join";
 import { replaceExtension } from "@stryke/path/replace";
@@ -36,13 +36,15 @@ function CommandEntry(props) {
 			return typeDefinition.value;
 		},
 		get imports() {
-			return defu(imports ?? {}, { [commandSourcePath.value]: `handle${pascalCase(command.name)}` });
+			return defu(imports ?? {}, {
+				[commandSourcePath.value]: `handle${pascalCase(command.name)}`,
+				prompts: "prompts"
+			});
 		},
 		get builtinImports() {
 			return defu(builtinImports ?? {}, {
 				env: [
 					"env",
-					"isCI",
 					"isDevelopment",
 					"isDebug"
 				],
@@ -54,12 +56,20 @@ function CommandEntry(props) {
 					"colors",
 					"stripAnsi",
 					"writeLine",
-					"splitText"
+					"splitText",
+					"text",
+					"confirm",
+					"isCancel",
+					"intro",
+					"outro"
 				],
 				utils: [
-					"getArgs",
+					"useApp",
+					"useArgs",
 					"hasFlag",
 					"isMinimal",
+					"isInteractive",
+					"isHelp",
 					"isUnicodeSupported",
 					"internal_commandContext"
 				]
@@ -73,153 +83,235 @@ function CommandEntry(props) {
 				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, {
+						return [createComponent(IfStatement, {
+							condition: code`!isInteractive`,
+							get children() {
+								return createComponent(CommandValidationLogic, { command });
+							}
+						}), createComponent(ElseIfClause, {
+							get condition() {
+								return code`!isHelp && (${Object.values(command.options ?? {}).filter((option) => !option.optional).map((option) => (option.kind === ReflectionKind.string || option.kind === ReflectionKind.number) && option.variadic ? `(!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} || options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.length === 0)` : `options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} === undefined`).join(" || ")}${Object.values(command.options ?? {}).filter((option) => !option.optional).length > 0 && Object.values(command.arguments ?? {}).filter((argument) => !argument.optional).length > 0 ? " || " : ""}${Object.values(command.arguments ?? {}).filter((argument) => !argument.optional).map((argument) => (argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number) && argument.variadic ? `(!${camelCase(argument.name)} || ${camelCase(argument.name)}.length === 0)` : `${camelCase(argument.name)} === undefined`).join(" || ")}) `;
+							},
+							get children() {
+								return [
+									code`writeLine("");
+
+            intro("Select required input parameters"); `,
+									createIntrinsic("hbr", {}),
+									createIntrinsic("hbr", {}),
+									createComponent(For, {
+										get each() {
+											return Object.values(command.options ?? {});
+										},
+										doubleHardline: true,
+										children: (option) => [createComponent(Show, {
 											get when() {
-												return (option.kind === ReflectionKind.string || option.kind === ReflectionKind.number) && option.variadic;
+												return !option.optional;
 											},
 											get children() {
-												return createComponent(ElseIfClause, {
+												return [createComponent(IfStatement, {
 													get condition() {
-														return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.length === 0`;
+														return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}`;
 													},
 													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");`;
+														return createComponent(Switch, { get children() {
+															return [createComponent(Match, {
+																get when() {
+																	return option.kind === ReflectionKind.string || option.kind === ReflectionKind.number;
+																},
+																get children() {
+																	return code`
+                            const value = await text({
+                              message: 'Please provide a value for the ${option.title} option:',
+                              validate(value) {
+                                if (isCancel(value)) {
+                                  return true;
+                                }
+                                if (!value || value.trim() === "") {
+                                  return "A value is required for this option";
+                                }
+                                ${option.kind === ReflectionKind.number ? `if (Number.isNaN(Number(value))) {
+                                  return "The value provided must be a valid number";
+                                }` : ""}
+                                return undefined;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = ${option.kind === ReflectionKind.number ? `Number(value)` : "value"};
+                          `;
+																}
+															}), createComponent(Match, {
+																get when() {
+																	return option.kind === ReflectionKind.boolean;
+																},
+																get children() {
+																	return code`
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = await confirm({
+                              message: 'Please select a value for the ${option.title} option:'
+                            });
+                          `;
+																}
+															})];
+														} });
 													}
-												});
-											},
-											get children() {
-												return createComponent(IfStatement, {
-													get condition() {
-														return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.some(value => Number.isNaN(value))`;
+												}), createComponent(Show, {
+													get when() {
+														return (option.kind === ReflectionKind.string || option.kind === ReflectionKind.number) && option.variadic;
 													},
 													get children() {
-														return code`failures.push("Invalid numeric value provided in the \\"${option.name}\\" array option");`;
+														return createComponent(ElseIfClause, {
+															get condition() {
+																return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.length === 0`;
+															},
+															get children() {
+																return code`
+                            const value = await text({
+                              message: 'Please provide one or more values for the ${option.title} option (values are separated by a "," character):',
+                              validate(value) {
+                                if (isCancel(value)) {
+                                  return true;
+                                }
+                                if (!value || value.trim() === "") {
+                                  return "A value is required for this option";
+                                }
+                                if (value.split(",").map(value => value.trim()).filter(Boolean).length === 0) {
+                                  return "At least one value is required for this option";
+                                }
+                                ${option.kind === ReflectionKind.number ? `const invalidIndex = value.split(",").map(value => value.trim()).filter(Boolean).findIndex(value => Number.isNaN(Number(value));
+                                    if (invalidIndex !== -1) {
+                                      return \`Invalid numeric value provided for item #\${invalidIndex + 1} - all provided items must be a valid number\`;
+                                    } ` : ""}
+                                return undefined;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value.split(",").map(value => value.trim()).filter(Boolean)${option.kind === ReflectionKind.number ? `.map(Number)` : ""} ;
+                          `;
+															}
+														});
 													}
-												});
+												})];
 											}
-										});
-									}
-								})]
-							}),
-							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, {
+										})]
+									}),
+									createIntrinsic("hbr", {}),
+									createIntrinsic("hbr", {}),
+									createComponent(For, {
+										get each() {
+											return command.arguments;
+										},
+										doubleHardline: true,
+										children: (argument) => [createComponent(Show, {
 											get when() {
-												return (argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number) && argument.variadic;
+												return !argument.optional;
 											},
 											get children() {
-												return createComponent(ElseIfClause, {
+												return [createComponent(IfStatement, {
 													get condition() {
-														return code`${camelCase(argument.name)}.length === 0`;
+														return code`!${camelCase(argument.name)}`;
 													},
 													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");`;
+														return createComponent(Switch, { get children() {
+															return [createComponent(Match, {
+																get when() {
+																	return argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number;
+																},
+																get children() {
+																	return code`
+                            const value = await text({
+                              message: 'Please provide a value for the ${argument.title} positional argument:',
+                              validate(value) {
+                                if (isCancel(value)) {
+                                  return true;
+                                }
+                                if (!value || value.trim() === "") {
+                                  return "A value is required for this positional argument";
+                                }
+                                ${argument.kind === ReflectionKind.number ? `if (Number.isNaN(Number(value))) {
+                                  return "The value provided must be a valid number";
+                                }` : ""}
+                                return undefined;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(argument.name)} = ${argument.kind === ReflectionKind.number ? `Number(value)` : "value"};
+                          `;
+																}
+															}), createComponent(Match, {
+																get when() {
+																	return argument.kind === ReflectionKind.boolean;
+																},
+																get children() {
+																	return code`
+                            ${camelCase(argument.name)} = await confirm({
+                              message: 'Please select a value for the ${argument.title} positional argument:'
+                            });
+                          `;
+																}
+															})];
+														} });
 													}
-												});
-											},
-											get children() {
-												return createComponent(IfStatement, {
-													get condition() {
-														return code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`;
+												}), createComponent(Show, {
+													get when() {
+														return (argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number) && argument.variadic;
 													},
 													get children() {
-														return code`failures.push("Invalid numeric value provided in the \\"${argument.name}\\" array positional argument");`;
+														return createComponent(ElseIfClause, {
+															get condition() {
+																return code`${camelCase(argument.name)}.length === 0`;
+															},
+															get children() {
+																return code`
+                            const value = await text({
+                              message: 'Please provide one or more values for the ${argument.title} option (values are separated by a "," character):',
+                              validate(value) {
+                                if (isCancel(value)) {
+                                  return true;
+                                }
+                                if (!value || value.trim() === "") {
+                                  return "A value is required for this option";
+                                }
+                                if (value.split(",").map(value => value.trim()).filter(Boolean).length === 0) {
+                                  return "At least one value is required for this option";
+                                }
+                                ${argument.kind === ReflectionKind.number ? `const invalidIndex = value.split(",").map(value => value.trim()).filter(Boolean).findIndex(value => Number.isNaN(Number(value));
+                                    if (invalidIndex !== -1) {
+                                      return \`Invalid numeric value provided for item #\${invalidIndex + 1} - all provided items must be a valid number\`;
+                                    } ` : ""}
+
+                                return undefined;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(argument.name)} = value.split(",").map(value => value.trim()).filter(Boolean)${argument.kind === ReflectionKind.number ? `.map(Number)` : ""} ;
+                          `;
+															}
+														});
 													}
-												});
+												})];
 											}
-										});
-									}
-								})]
-							}),
-							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; `
-							})
-						];
+										})]
+									}),
+									code`outro("Completed providing all required input parameters");
+
+            writeLine(""); `,
+									createIntrinsic("hbr", {}),
+									createIntrinsic("hbr", {})
+								];
+							}
+						})];
 					}
 				})
 			];

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseIfClause","IfStatement","VarDeclaration","ReflectionKind","usePowerlines","EntryFile","isDynamicPathSegment","CommandHandlerDeclaration","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","pascalCase","defu","BannerFunctionDeclaration","VirtualCommandEntry","CommandEntry","props","command","imports","builtinImports","rest","context","filePath","segments","filter","segment","join","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$createComponent","_$mergeProps","path","name","env","console","utils","children","_$createIntrinsic","type","initializer","each","Object","values","options","doubleHardline","option","when","optional","condition","includes","kind","string","number","variadic","fallback","arguments","argument","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 { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\nimport { CommandHandlerDeclaration } from \"@shell-shock/preset-script/components/command-entry\";\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 { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { CLIPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\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<CLIPresetContext>();\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        <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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"}
+{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Match","Show","Switch","ElseIfClause","IfStatement","ReflectionKind","usePowerlines","EntryFile","isDynamicPathSegment","CommandHandlerDeclaration","CommandValidationLogic","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","pascalCase","defu","BannerFunctionDeclaration","VirtualCommandEntry","CommandEntry","props","command","imports","builtinImports","rest","context","filePath","segments","filter","segment","join","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$createComponent","_$mergeProps","path","name","prompts","env","console","utils","children","_$createIntrinsic","condition","Object","values","options","option","optional","map","kind","string","number","variadic","includes","length","arguments","argument","each","doubleHardline","when","title","boolean","child","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 { code, computed, For, Match, Show, Switch } from \"@alloy-js/core\";\nimport { ElseIfClause, IfStatement } from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport {\n  CommandHandlerDeclaration,\n  CommandValidationLogic\n} from \"@shell-shock/preset-script/components/command-entry\";\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 { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { CLIPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\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<CLIPresetContext>();\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          prompts: \"prompts\"\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\",\n            \"text\",\n            \"confirm\",\n            \"isCancel\",\n            \"intro\",\n            \"outro\"\n          ],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isInteractive\",\n            \"isHelp\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command}>\n          <IfStatement condition={code`!isInteractive`}>\n            <CommandValidationLogic command={command} />\n          </IfStatement>\n          <ElseIfClause\n            condition={code`!isHelp && (${Object.values(command.options ?? {})\n              .filter(option => !option.optional)\n              .map(option =>\n                (option.kind === ReflectionKind.string ||\n                  option.kind === ReflectionKind.number) &&\n                option.variadic\n                  ? `(!options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } || options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    }.length === 0)`\n                  : `options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } === undefined`\n              )\n              .join(\" || \")}${\n              Object.values(command.options ?? {}).filter(\n                option => !option.optional\n              ).length > 0 &&\n              Object.values(command.arguments ?? {}).filter(\n                argument => !argument.optional\n              ).length > 0\n                ? \" || \"\n                : \"\"\n            }${Object.values(command.arguments ?? {})\n              .filter(argument => !argument.optional)\n              .map(argument =>\n                (argument.kind === ReflectionKind.string ||\n                  argument.kind === ReflectionKind.number) &&\n                argument.variadic\n                  ? `(!${camelCase(\n                      argument.name\n                    )} || ${camelCase(argument.name)}.length === 0)`\n                  : `${camelCase(argument.name)} === undefined`\n              )\n              .join(\" || \")}) `}>\n            {code`writeLine(\"\");\n\n            intro(\"Select required input parameters\"); `}\n            <hbr />\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                      <Switch>\n                        <Match\n                          when={\n                            option.kind === ReflectionKind.string ||\n                            option.kind === ReflectionKind.number\n                          }>{code`\n                            const value = await text({\n                              message: 'Please provide a value for the ${\n                                option.title\n                              } option:',\n                              validate(value) {\n                                if (isCancel(value)) {\n                                  return true;\n                                }\n                                if (!value || value.trim() === \"\") {\n                                  return \"A value is required for this option\";\n                                }\n                                ${\n                                  option.kind === ReflectionKind.number\n                                    ? `if (Number.isNaN(Number(value))) {\n                                  return \"The value provided must be a valid number\";\n                                }`\n                                    : \"\"\n                                }\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = ${\n                              option.kind === ReflectionKind.number\n                                ? `Number(value)`\n                                : \"value\"\n                            };\n                          `}</Match>\n                        <Match\n                          when={option.kind === ReflectionKind.boolean}>{code`\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = await confirm({\n                              message: 'Please select a value for the ${option.title} option:'\n                            });\n                          `}</Match>\n                      </Switch>\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`\n                            const value = await text({\n                              message: 'Please provide one or more values for the ${\n                                option.title\n                              } option (values are separated by a \",\" character):',\n                              validate(value) {\n                                if (isCancel(value)) {\n                                  return true;\n                                }\n                                if (!value || value.trim() === \"\") {\n                                  return \"A value is required for this option\";\n                                }\n                                if (value.split(\",\").map(value => value.trim()).filter(Boolean).length === 0) {\n                                  return \"At least one value is required for this option\";\n                                }\n                                ${\n                                  option.kind === ReflectionKind.number\n                                    ? `const invalidIndex = value.split(\",\").map(value => value.trim()).filter(Boolean).findIndex(value => Number.isNaN(Number(value));\n                                    if (invalidIndex !== -1) {\n                                      return \\`Invalid numeric value provided for item #\\${invalidIndex + 1} - all provided items must be a valid number\\`;\n                                    } `\n                                    : \"\"\n                                }\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value.split(\",\").map(value => value.trim()).filter(Boolean)${\n                              option.kind === ReflectionKind.number\n                                ? `.map(Number)`\n                                : \"\"\n                            } ;\n                          `}\n                      </ElseIfClause>\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                      <Switch>\n                        <Match\n                          when={\n                            argument.kind === ReflectionKind.string ||\n                            argument.kind === ReflectionKind.number\n                          }>{code`\n                            const value = await text({\n                              message: 'Please provide a value for the ${argument.title} positional argument:',\n                              validate(value) {\n                                if (isCancel(value)) {\n                                  return true;\n                                }\n                                if (!value || value.trim() === \"\") {\n                                  return \"A value is required for this positional argument\";\n                                }\n                                ${\n                                  argument.kind === ReflectionKind.number\n                                    ? `if (Number.isNaN(Number(value))) {\n                                  return \"The value provided must be a valid number\";\n                                }`\n                                    : \"\"\n                                }\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(argument.name)} = ${\n                              argument.kind === ReflectionKind.number\n                                ? `Number(value)`\n                                : \"value\"\n                            };\n                          `}</Match>\n                        <Match\n                          when={argument.kind === ReflectionKind.boolean}>{code`\n                            ${camelCase(argument.name)} = await confirm({\n                              message: 'Please select a value for the ${argument.title} positional argument:'\n                            });\n                          `}</Match>\n                      </Switch>\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`\n                            const value = await text({\n                              message: 'Please provide one or more values for the ${\n                                argument.title\n                              } option (values are separated by a \",\" character):',\n                              validate(value) {\n                                if (isCancel(value)) {\n                                  return true;\n                                }\n                                if (!value || value.trim() === \"\") {\n                                  return \"A value is required for this option\";\n                                }\n                                if (value.split(\",\").map(value => value.trim()).filter(Boolean).length === 0) {\n                                  return \"At least one value is required for this option\";\n                                }\n                                ${\n                                  argument.kind === ReflectionKind.number\n                                    ? `const invalidIndex = value.split(\",\").map(value => value.trim()).filter(Boolean).findIndex(value => Number.isNaN(Number(value));\n                                    if (invalidIndex !== -1) {\n                                      return \\`Invalid numeric value provided for item #\\${invalidIndex + 1} - all provided items must be a valid number\\`;\n                                    } `\n                                    : \"\"\n                                }\n\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(argument.name)} = value.split(\",\").map(value => value.trim()).filter(Boolean)${\n                              argument.kind === ReflectionKind.number\n                                ? `.map(Number)`\n                                : \"\"\n                            } ;\n                          `}\n                      </ElseIfClause>\n                    </Show>\n                  </Show>\n                </>\n              )}\n            </For>\n            {code`outro(\"Completed providing all required input parameters\");\n\n            writeLine(\"\"); `}\n            <hbr />\n            <hbr />\n          </ElseIfClause>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-router.cjs

@@ -0,0 +1,87 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+let __shell_shock_preset_script_components_command_router = require("@shell-shock/preset-script/components/command-router");
+
+//#region src/components/command-router.tsx
+function CommandRouterSelectOptions(props) {
+	const { commands } = props;
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+		get each() {
+			return Object.values(commands ?? {});
+		},
+		joiner: ",",
+		hardline: true,
+		children: (command) => command.isVirtual ? (0, __alloy_js_core_jsx_runtime.createComponent)(CommandRouterSelectOptions, { get commands() {
+			return command.children ?? {};
+		} }) : __alloy_js_core.code`{ value: [${command.segments.map((segment) => `"${segment}"`).join(", ")}], label: "${command.icon ? `${command.icon}  ` : ""}${command.title}", hint: "${command.description}" }`
+	});
+}
+/**
+* A component that renders a command router interface, allowing users to select and execute commands from a provided list of commands and segments. This component serves as a wrapper around the base CommandRouter, adding additional UI elements and logic for command selection.
+*/
+function CommandRouter(props) {
+	const { segments, commands } = props;
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_preset_script_components_command_router.CommandRouter, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, {
+			segments,
+			commands
+		})),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+			condition: __alloy_js_core.code`isInteractive && !isHelp`,
+			get children() {
+				return [
+					__alloy_js_core.code`
+        banner();
+        writeLine("");
+
+      intro("Command selection");
+
+      let segments = await select({
+        message: "Please select a command to execute:",
+        options: [ `,
+					(0, __alloy_js_core_jsx_runtime.createComponent)(CommandRouterSelectOptions, { commands }),
+					(0, __alloy_js_core_jsx_runtime.memo)(() => ` ],
+      });
+      if (isCancel(segments)) {
+        return;
+      }
+
+      let dynamics = {} as Record<string, string>;
+      for (const dynamic of segments.filter(segment => segment.startsWith("[") && segment.endsWith("]"))) {
+        const value = await text({
+          message: \`Please provide a value for \${dynamic.replace(/^\[+/, "").replace(/\]+$/, "")}:\`,
+        });
+        if (isCancel(value)) {
+          return;
+        }
+        dynamics[dynamic] = value;
+      }
+
+      segments = segments.map(segment => dynamics[segment] || segment);
+      const context = useApp();
+      context.set("args", [args[0], ...segments, ...args.slice(${segments.length + 2})]);
+
+      outro(\`Executing \${segments.join(" ")} command\`);
+
+      command = segments[0];
+      args = context.get("args");
+      `),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_preset_script_components_command_router.CommandRouterBody, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, {
+						segments,
+						commands
+					}))
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+
+//#endregion
+exports.CommandRouter = CommandRouter;
+exports.CommandRouterSelectOptions = CommandRouterSelectOptions;

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

@@ -0,0 +1,16 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { CommandTree } from "@shell-shock/core/types/command";
+import { CommandRouterProps } from "@shell-shock/preset-script/components/command-router";
+
+//#region src/components/command-router.d.ts
+interface CommandRouterSelectOptionsProps {
+  commands?: Record<string, CommandTree>;
+}
+declare function CommandRouterSelectOptions(props: CommandRouterSelectOptionsProps): _alloy_js_core0.Children;
+/**
+ * A component that renders a command router interface, allowing users to select and execute commands from a provided list of commands and segments. This component serves as a wrapper around the base CommandRouter, adding additional UI elements and logic for command selection.
+ */
+declare function CommandRouter(props: CommandRouterProps): _alloy_js_core0.Children;
+//#endregion
+export { CommandRouter, CommandRouterSelectOptions, CommandRouterSelectOptionsProps };
+//# sourceMappingURL=command-router.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-router.d.cts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;;UA2BiB,+BAAA;aACJ,eAAe;;AADX,iBAID,0BAAA,CAHY,KAAA,EAInB,+BAJU,CAAA,EAIqB,eAAA,CAAA,QAJrB;AAGnB;AA2BA;;iBAAgB,aAAA,QAAqB,qBAAkB,eAAA,CAAA"}