@shell-shock/preset-cli 0.9.33 → 0.9.35

package/README.md

@@ -5,9 +5,9 @@
 
 <div align="center">
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/shell-shock/banner-1280x640-dark.gif">
-  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/shell-shock/banner-1280x640-light.gif">
-<img src="https://public.storm-cdn.com/shell-shock/banner-1280x640-dark.gif" width="100%" alt="Storm Software" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/shell-shock/media/banner-1280x640-dark.gif">
+  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/shell-shock/media/banner-1280x640-light.gif">
+<img src="https://public.storm-cdn.com/shell-shock/media/banner-1280x640-dark.gif" width="100%" alt="Storm Software" />
 </picture>
 </div>
 <br />
@@ -213,9 +213,9 @@ specification. Contributions of any kind welcome!
 
 <div align="center">
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x320-dark.webp">
-  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x320-light.webp">
-<img src="https://public.storm-cdn.com/storm-software/banner-1280x320-dark.webp" width="100%" alt="Storm Software" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/media/banner-1280x320-dark.webp">
+  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/media/banner-1280x320-light.webp">
+<img src="https://public.storm-cdn.com/storm-software/media/banner-1280x320-dark.webp" width="100%" alt="Storm Software" />
 </picture>
 </div>
 <br />
@@ -247,8 +247,17 @@ generation of development tools, please reach out on our
 
 <br />
 
-<div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://public.storm-cdn.com/storm-software/icon-circle-fill-dark.png" alt="Storm Software" width="200px"/></a></div>
+<div align="center">
+<a href="https://stormsoftware.com" target="_blank">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/icons/circle-dark.webp">
+  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/icons/circle-light.webp">
+<img src="https://public.storm-cdn.com/storm-software/icons/circle-dark.webp" width="200px" alt="Storm Software" />
+</picture>
+</a>
+</div>
 <br />
+
 <div align="center"><a href="https://stormsoftware.com" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/misc/text/visit-us-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/misc/text/visit-us-light.png"><img src="https://public.storm-cdn.com/misc/text/visit-us-dark.png" height="90px" alt="Visit us at stormsoftware.com" /></picture></a></div>
 
 <br />

package/dist/command-entry-BCDDI3RN.mjs

@@ -0,0 +1,548 @@
+import { CommandRouter } from "./components/command-router.mjs";
+import { formatDescription, formatShortDescription, isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
+import { joinPaths } from "@stryke/path/join";
+import { createComponent, 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 { Spacing } from "@power-plant/alloy-js/core/components";
+import { Spacing as Spacing$1 } from "@power-plant/alloy-js/core/components/spacing";
+import { EntryFile, usePowerlines } from "@shell-shock/core/contexts/power-plant";
+import { defu } from "defu";
+import { CommandValidationLogic } from "@shell-shock/core/components/command-validation-logic";
+import { CommandHandlerDeclaration } from "@shell-shock/preset-script/components/command-entry";
+import { findFilePath, relativePath } from "@stryke/path/find";
+import { replaceExtension } from "@stryke/path/replace";
+import { camelCase } from "@stryke/string-format/camel-case";
+import { pascalCase } from "@stryke/string-format/pascal-case";
+import { TypescriptFile } from "@power-plant/alloy-js/typescript/components/typescript-file";
+import { VirtualCommandHandlerDeclaration } from "@shell-shock/preset-script/components/virtual-command-entry";
+
+//#region src/components/virtual-command-entry.tsx
+/**
+* The virtual command entry point for the Shell Shock project.
+*/
+function VirtualCommandEntry(props) {
+	const { command, imports, builtinImports, ...rest } = props;
+	const context = usePowerlines();
+	const filePath = computed(() => joinPaths(context.entryPath, command.segments.filter((segment) => !isDynamicPathSegment(segment)).join("/"), "index.ts"));
+	return [createComponent(TypescriptFile, mergeProps(rest, {
+		get path() {
+			return filePath.value;
+		},
+		get imports() {
+			return defu(imports ?? {}, Object.entries(command.children).filter(([, child]) => child.virtual).reduce((ret, [name, child]) => {
+				ret[`./${child.name}`] = [{
+					name: "handler",
+					alias: `handle${pascalCase(name)}`
+				}];
+				return ret;
+			}, {}));
+		},
+		get builtinImports() {
+			return defu(builtinImports ?? {}, {
+				env: ["isDevelopment", "isDebug"],
+				console: [
+					"warn",
+					"error",
+					"info",
+					"help",
+					"table",
+					"writeLine",
+					"splitText",
+					"textColors",
+					"stripAnsi"
+				],
+				utils: [
+					"isMinimal",
+					"isUnicodeSupported",
+					"isInteractive",
+					"findSuggestions",
+					"sleep"
+				],
+				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
+					"useGlobal",
+					"useGlobalOptions",
+					"withCommand",
+					"useArgs",
+					"hasFlag",
+					"isHelp"
+				],
+				prompts: [
+					"text",
+					"numeric",
+					"toggle",
+					"select",
+					"isCancel"
+				],
+				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"],
+				[joinPaths("banner", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showBanner"]
+			});
+		},
+		get children() {
+			return [createComponent(Spacing, {}), createComponent(VirtualCommandHandlerDeclaration, {
+				command,
+				get children() {
+					return createComponent(CommandRouter, {
+						get segments() {
+							return command.segments;
+						},
+						get commands() {
+							return command.children;
+						}
+					});
+				}
+			})];
+		}
+	})), createComponent(For, {
+		get each() {
+			return Object.values(command.children);
+		},
+		children: (child) => createComponent(Show, {
+			get when() {
+				return child.virtual;
+			},
+			get fallback() {
+				return createComponent(CommandEntry, { command: child });
+			},
+			get children() {
+				return createComponent(VirtualCommandEntry, { command: child });
+			}
+		})
+	})];
+}
+
+//#endregion
+//#region src/components/command-entry.tsx
+/**
+* The command entry point for the Shell Shock project.
+*/
+function CommandEntry(props) {
+	const { command, imports, builtinImports, ...rest } = props;
+	const context = usePowerlines();
+	const filePath = computed(() => joinPaths(command.segments.filter((segment) => !isDynamicPathSegment(segment)).join("/"), "index.ts"));
+	const commandSourcePath = computed(() => replaceExtension(relativePath(joinPaths(context.entryPath, findFilePath(filePath.value)), command.entry.input?.file || command.entry.file)));
+	const typeDefinition = computed(() => ({
+		...command.entry,
+		output: command.id
+	}));
+	return [createComponent(EntryFile, mergeProps(rest, {
+		get path() {
+			return filePath.value;
+		},
+		get typeDefinition() {
+			return typeDefinition.value;
+		},
+		get imports() {
+			return defu(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${pascalCase(command.name)}` });
+		},
+		get builtinImports() {
+			return defu(builtinImports ?? {}, {
+				env: [
+					"env",
+					"isDevelopment",
+					"isDebug",
+					"paths"
+				],
+				console: [
+					"debug",
+					"info",
+					"help",
+					"warn",
+					"error",
+					"table",
+					"italic",
+					"cursor",
+					"stripAnsi",
+					"writeLine",
+					"splitText",
+					"textColors",
+					"createSpinner"
+				],
+				utils: [
+					"sleep",
+					"isMinimal",
+					"isInteractive",
+					"isUnicodeSupported"
+				],
+				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
+					"useGlobal",
+					"useGlobalOptions",
+					"withCommand",
+					"useArgs",
+					"hasFlag",
+					"isHelp"
+				],
+				prompts: [
+					"text",
+					"numeric",
+					"toggle",
+					"select",
+					"confirm",
+					"waitForKeyPress",
+					"isCancel"
+				],
+				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"],
+				[joinPaths("banner", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showBanner"],
+				update: ["executeUpdate"]
+			});
+		},
+		get children() {
+			return [createComponent(Spacing$1, {}), createComponent(CommandHandlerDeclaration, {
+				command,
+				banner: code`await showBanner();
+          await executeUpdate(); `,
+				get children() {
+					return [createComponent(IfStatement, {
+						condition: code`!isInteractive`,
+						get children() {
+							return createComponent(CommandValidationLogic, { command });
+						}
+					}), createComponent(Show, {
+						get when() {
+							return Object.values(command.options ?? {}).filter((option) => option.required).length > 0 || Object.values(command.args ?? {}).filter((arg) => arg.required).length > 0;
+						},
+						get children() {
+							return createComponent(ElseIfClause, {
+								get condition() {
+									return code`!isHelp() && (${Object.values(command.options ?? {}).filter((option) => option.required).map((option) => (option.type === "string" || option.type === "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.required).length > 0 && Object.values(command.args ?? {}).filter((arg) => arg.required).length > 0 ? " || " : ""}${Object.values(command.args ?? {}).filter((arg) => arg.required).map((arg) => (arg.type === "string" || arg.type === "number") && arg.variadic ? `(!${camelCase(arg.name)} || ${camelCase(arg.name)}.length === 0)` : `${camelCase(arg.name)} === undefined`).join(" || ")}) `;
+								},
+								get children() {
+									return [
+										code`writeLine(""); `,
+										createComponent(Spacing$1, {}),
+										createComponent(For, {
+											get each() {
+												return Object.values(command.options ?? {});
+											},
+											doubleHardline: true,
+											children: (option) => [createComponent(Show, {
+												get when() {
+													return option.required;
+												},
+												get children() {
+													return [createComponent(IfStatement, {
+														get condition() {
+															return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}`;
+														},
+														get children() {
+															return createComponent(Show, {
+																get when() {
+																	return option.type === "boolean" || !option.choices || option.choices.length === 0;
+																},
+																get fallback() {
+																	return code`const value = await select({
+                              message: \`Please select a value for the \${italic("${option.name}")} option\`, ${option.description ? `description: \`${formatDescription(option.description)}\`,
+                              ` : ""}options: [ ${option.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${option.description ? `description: \`${formatShortDescription(option.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
+                          `;
+																},
+																get children() {
+																	return createComponent(Switch, { get children() {
+																		return [
+																			createComponent(Match, {
+																				get when() {
+																					return option.type === "string";
+																				},
+																				get children() {
+																					return code`
+                            const value = await text({
+                              message: \`Please provide a value for the \${italic("${option.name}")} option\`,
+                              ${option.description ? `description: \`${formatDescription(option.description)}\`,
+                              ` : ""}validate(val) {
+                                if (!val || val.trim() === "") {
+                                  return "A value must be provided for this option";
+                                }
+
+                                return null;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
+                          `;
+																				}
+																			}),
+																			createComponent(Match, {
+																				get when() {
+																					return option.type === "number";
+																				},
+																				get children() {
+																					return code`
+                            const value = await numeric({
+                              message: \`Please provide a numeric value for the \${italic("${option.name}")} option\`,
+                              ${option.description ? `description: \`${formatDescription(option.description)}\`,
+                              ` : ""}
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
+                          `;
+																				}
+																			}),
+																			createComponent(Match, {
+																				get when() {
+																					return option.type === "boolean";
+																				},
+																				get children() {
+																					return code`
+                            const value = await toggle({
+                              message: \`Please select a value for the \${italic("${option.name}")} option\`,
+                            ${option.description ? `description: \`${formatDescription(option.description)}\`,
+                              ` : ""}
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
+                          `;
+																				}
+																			})
+																		];
+																	} });
+																}
+															});
+														}
+													}), createComponent(Show, {
+														get when() {
+															return (option.type === "string" || option.type === "number") && option.variadic;
+														},
+														get children() {
+															return createComponent(ElseIfClause, {
+																get condition() {
+																	return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.length === 0`;
+																},
+																get children() {
+																	return code`
+                            const value = await text({
+                              message: \`Please provide one or more${option.type === "number" ? " numeric" : ""} values for the \${italic("${option.name}")} option (values are separated by a \\",\\" character)\`,
+                              ${option.description ? `description: \`${formatDescription(option.description)}\`,
+                              ` : ""}validate(val) {
+                                if (!val || val.trim() === "") {
+                                  return "A value must be provided for this option";
+                                }
+                                if (val.split(",").map(v => v.trim()).filter(Boolean).length === 0) {
+                                  return "At least one value must be provided for this option";
+                                }
+                                ${option.type === "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\`;
+                                    } ` : ""}
+                                return undefined;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value.split(",").map(value => value.trim()).filter(Boolean)${option.type === "number" ? `.map(Number)` : ""} ;
+                          `;
+																}
+															});
+														}
+													})];
+												}
+											})]
+										}),
+										createComponent(Spacing$1, {}),
+										createComponent(For, {
+											get each() {
+												return command.args;
+											},
+											doubleHardline: true,
+											children: (arg) => [createComponent(Show, {
+												get when() {
+													return arg.required;
+												},
+												get children() {
+													return [createComponent(IfStatement, {
+														get condition() {
+															return code`!${camelCase(arg.name)}`;
+														},
+														get children() {
+															return createComponent(Show, {
+																get when() {
+																	return arg.type === "boolean" || !arg.choices || arg.choices.length === 0;
+																},
+																get fallback() {
+																	return code`const value = await select({
+                              message: \`Please select a value for the \${italic("${arg.name}")} argument\`,${arg.description ? `description: \`${formatDescription(arg.description)}\`,
+                              ` : ""}
+                              options: [ ${arg.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(arg.name)} = value;
+                          `;
+																},
+																get children() {
+																	return createComponent(Switch, { get children() {
+																		return [
+																			createComponent(Match, {
+																				get when() {
+																					return arg.type === "string";
+																				},
+																				get children() {
+																					return code`
+                            const value = await text({
+                              message: \`Please provide a value for the \${italic("${arg.name}")} argument\`,
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
+                              ` : ""}validate(val) {
+                                if (!val || val.trim() === "") {
+                                  return "A value must be provided for this argument";
+                                }
+
+                                return null;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(arg.name)} = value;
+                          `;
+																				}
+																			}),
+																			createComponent(Match, {
+																				get when() {
+																					return arg.type === "number";
+																				},
+																				get children() {
+																					return code`
+                            const value = await numeric({
+                              message: \`Please provide a numeric value for the \${italic("${arg.name}")} argument\`,
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
+                              ` : ""}
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(arg.name)} = value;
+                          `;
+																				}
+																			}),
+																			createComponent(Match, {
+																				get when() {
+																					return arg.type === "boolean";
+																				},
+																				get children() {
+																					return code`
+                            const value = await toggle({
+                              message: \`Please select a value for the \${italic("${arg.name}")} argument\`,
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
+                              ` : ""}
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(arg.name)} = value;
+                          `;
+																				}
+																			})
+																		];
+																	} });
+																}
+															});
+														}
+													}), createComponent(Show, {
+														get when() {
+															return arg.variadic;
+														},
+														get children() {
+															return createComponent(ElseIfClause, {
+																get condition() {
+																	return code`${camelCase(arg.name)}.length === 0`;
+																},
+																get children() {
+																	return code`
+                            const value = await text({
+                              message: \`Please provide one or more${arg.type === "number" ? " numeric" : ""} values for the \${italic("${arg.name}")} argument (values are separated by a \\",\\" character)\`,
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
+                              ` : ""}validate(val) {
+                                if (!val || val.trim() === "") {
+                                  return "A value must be provided for this argument";
+                                }
+                                if (val.split(",").map(v => v.trim()).filter(Boolean).length === 0) {
+                                  return "At least one value must be provided for this argument";
+                                }
+                                ${arg.type === "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\`;
+                                    } ` : ""}
+
+                                return undefined;
+                              }
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(arg.name)} = value.split(",").map(value => value.trim()).filter(Boolean)${arg.type === "number" ? `.map(Number)` : arg.type === "boolean" ? `.map(Boolean)` : ""} ;
+                          `;
+																}
+															});
+														}
+													})];
+												}
+											})]
+										}),
+										code`writeLine(""); `,
+										createComponent(Spacing$1, {}),
+										createComponent(CommandValidationLogic, { command }),
+										createComponent(IfStatement, {
+											condition: code`failures.length > 0`,
+											get children() {
+												return code`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${command.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
+                options.help = true; `;
+											}
+										})
+									];
+								}
+							});
+						}
+					})];
+				}
+			})];
+		}
+	})), createComponent(For, {
+		get each() {
+			return Object.values(command.children);
+		},
+		children: (child) => createComponent(Show, {
+			get when() {
+				return child.virtual;
+			},
+			get fallback() {
+				return createComponent(CommandEntry, { command: child });
+			},
+			get children() {
+				return createComponent(VirtualCommandEntry, { command: child });
+			}
+		})
+	})];
+}
+
+//#endregion
+export { VirtualCommandEntry as n, CommandEntry as t };
+//# sourceMappingURL=command-entry-BCDDI3RN.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-entry-BCDDI3RN.mjs","names":[],"sources":[],"mappings":""}