@shell-shock/preset-script 0.6.77 → 0.6.78

package/dist/command-entry-BlT9_UEL.cjs

@@ -0,0 +1,367 @@
+const require_components_command_router = require('./components/command-router.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 _power_plant_alloy_js_core_components = require("@power-plant/alloy-js/core/components");
+let _power_plant_alloy_js_core_components_spacing = require("@power-plant/alloy-js/core/components/spacing");
+let _power_plant_alloy_js_typescript_components_tsdoc = require("@power-plant/alloy-js/typescript/components/tsdoc");
+let _shell_shock_core_contexts_power_plant = require("@shell-shock/core/contexts/power-plant");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let defu = require("defu");
+let _shell_shock_core_components_command_validation_logic = require("@shell-shock/core/components/command-validation-logic");
+let _shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
+let _shell_shock_core_components_options_parser_logic = require("@shell-shock/core/components/options-parser-logic");
+let _stryke_path_find = require("@stryke/path/find");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let _power_plant_alloy_js_typescript_components_typescript_file = require("@power-plant/alloy-js/typescript/components/typescript-file");
+
+//#region src/components/virtual-command-entry.tsx
+/**
+* A component that generates the `handler` function declaration for a command.
+*/
+function VirtualCommandHandlerDeclaration(props) {
+	const { command, children, banner } = props;
+	const context = (0, _shell_shock_core_contexts_power_plant.usePowerlines)();
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+		get heading() {
+			return `The ${command.title} (${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_constant_case.constantCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment).join(" ")}) virtual command.`;
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocRemarks, { get children() {
+					return `${command.description.replace(/\.+$/, "")}.`;
+				} }),
+				(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocTitle, { get children() {
+					return command.title;
+				} }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+					name: "args",
+					children: `The command-line arguments passed to the command.`
+				})
+			];
+		}
+	}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+		"export": true,
+		async: true,
+		name: "handler",
+		parameters: [{
+			name: "args",
+			type: "string[]",
+			default: "useArgs()"
+		}],
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components.Spacing, {}),
+				children,
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return Boolean(banner);
+					},
+					children: banner
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components.Spacing, {}),
+				_alloy_js_core.code`return showHelp(); `
+			];
+		}
+	})];
+}
+/**
+* The virtual command entry point for the Shell Shock project.
+*/
+function VirtualCommandEntry(props) {
+	const { command, imports, builtinImports, ...rest } = props;
+	const context = (0, _shell_shock_core_contexts_power_plant.usePowerlines)();
+	const filePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_join.joinPaths)(context.entryPath, command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)).join("/"), "index.ts"));
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_typescript_file.TypescriptFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get path() {
+			return filePath.value;
+		},
+		get imports() {
+			return (0, defu.defu)(imports ?? {}, Object.entries(command.children).filter(([, child]) => child.virtual).reduce((ret, [name, child]) => {
+				ret[`./${child.name}`] = [{
+					name: "handler",
+					alias: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(name)}`
+				}];
+				return ret;
+			}, {}));
+		},
+		get builtinImports() {
+			return (0, defu.defu)(builtinImports ?? {}, {
+				env: ["isDevelopment", "isDebug"],
+				console: [
+					"warn",
+					"error",
+					"writeLine",
+					"textColors"
+				],
+				utils: [
+					"isMinimal",
+					"isUnicodeSupported",
+					"findSuggestions"
+				],
+				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
+					"useGlobal",
+					"useGlobalOptions",
+					"withCommand",
+					"useArgs",
+					"hasFlag"
+				],
+				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"],
+				[(0, _stryke_path_join.joinPaths)("banner", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showBanner"]
+			});
+		},
+		get children() {
+			return [(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components.Spacing, {}), (0, _alloy_js_core_jsx_runtime.createComponent)(VirtualCommandHandlerDeclaration, {
+				command,
+				banner: _alloy_js_core.code`await showBanner(); `,
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_command_router.CommandRouter, {
+						get segments() {
+							return command.segments;
+						},
+						get commands() {
+							return command.children;
+						}
+					});
+				}
+			})];
+		}
+	})), (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, {
+			get when() {
+				return child.virtual;
+			},
+			get fallback() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandEntry, { command: child });
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(VirtualCommandEntry, { command: child });
+			}
+		})
+	})];
+}
+
+//#endregion
+//#region src/components/command-entry.tsx
+function CommandInvocation(props) {
+	const { command } = props;
+	return [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code` return withCommand("${command.path}", [${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? (0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment)) : `"${segment}"`).join(", ")}], [${Object.keys(command.options).length > 0 ? `options` : ""}${command.args.length > 0 ? `${Object.keys(command.options).length > 0 ? ", " : ""}${command.args.map((arg) => (0, _stryke_string_format_camel_case.camelCase)(arg.name)).join(", ")}` : ""}], handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}); `), (0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+}
+/**
+* A component that generates the `handler` function declaration for a command.
+*/
+function CommandHandlerDeclaration(props) {
+	const { command, banner, children } = props;
+	const context = (0, _shell_shock_core_contexts_power_plant.usePowerlines)();
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `The ${command.title} (${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_constant_case.constantCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment).join(" ")}) command.`;
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocRemarks, { get children() {
+						return `${command.description.replace(/\.+$/, "")}.`;
+					} }),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocTitle, { get children() {
+						return command.title;
+					} }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+						name: "args",
+						children: `The command-line arguments passed to the command.`
+					})
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			async: true,
+			name: "handler",
+			parameters: [{
+				name: "args",
+				type: "string[]",
+				default: "useArgs()"
+			}],
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.CommandParserLogic, {
+						command,
+						get appSpecificEnvPrefix() {
+							return context.config.appSpecificEnvPrefix;
+						},
+						get isCaseSensitive() {
+							return context.config.isCaseSensitive;
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+						get when() {
+							return Boolean(banner);
+						},
+						children: banner
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`!isHelp()`,
+						get children() {
+							return [_alloy_js_core.code`writeLine("");`, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+								get condition() {
+									return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_helpers.IsDebug, {});
+								},
+								children: _alloy_js_core.code`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console.")); `
+							})];
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					children,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`options.help`,
+						children: _alloy_js_core.code`return showHelp(); `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { get children() {
+						return [(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), (0, _alloy_js_core_jsx_runtime.createComponent)(CommandInvocation, { command })];
+					} })
+				];
+			}
+		})
+	];
+}
+/**
+* The command entry point for the Shell Shock project.
+*/
+function CommandEntry(props) {
+	const { command, imports, builtinImports, ...rest } = props;
+	const context = (0, _shell_shock_core_contexts_power_plant.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)(_shell_shock_core_contexts_power_plant.EntryFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get path() {
+			return filePath.value;
+		},
+		get typeDefinition() {
+			return typeDefinition.value;
+		},
+		get imports() {
+			return (0, defu.defu)(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}` });
+		},
+		get builtinImports() {
+			return (0, defu.defu)(builtinImports ?? {}, {
+				env: [
+					"env",
+					"isDevelopment",
+					"isDebug"
+				],
+				console: [
+					"debug",
+					"warn",
+					"error",
+					"writeLine",
+					"textColors"
+				],
+				utils: ["isMinimal", "isUnicodeSupported"],
+				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
+					"useGlobal",
+					"useGlobalOptions",
+					"useArgs",
+					"hasFlag",
+					"isHelp",
+					"withCommand"
+				],
+				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"],
+				[(0, _stryke_path_join.joinPaths)("banner", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showBanner"]
+			});
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(CommandHandlerDeclaration, {
+					command,
+					banner: _alloy_js_core.code`await showBanner(); `,
+					get children() {
+						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_typescript.IfStatement, {
+							condition: _alloy_js_core.code`failures.length > 0`,
+							get children() {
+								return _alloy_js_core.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; `;
+							}
+						})];
+					}
+				})
+			];
+		}
+	})), (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, {
+			get when() {
+				return child.virtual;
+			},
+			get fallback() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandEntry, { command: child });
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(VirtualCommandEntry, { command: child });
+			}
+		})
+	})];
+}
+
+//#endregion
+Object.defineProperty(exports, 'CommandEntry', {
+  enumerable: true,
+  get: function () {
+    return CommandEntry;
+  }
+});
+Object.defineProperty(exports, 'CommandHandlerDeclaration', {
+  enumerable: true,
+  get: function () {
+    return CommandHandlerDeclaration;
+  }
+});
+Object.defineProperty(exports, 'CommandInvocation', {
+  enumerable: true,
+  get: function () {
+    return CommandInvocation;
+  }
+});
+Object.defineProperty(exports, 'VirtualCommandEntry', {
+  enumerable: true,
+  get: function () {
+    return VirtualCommandEntry;
+  }
+});
+Object.defineProperty(exports, 'VirtualCommandHandlerDeclaration', {
+  enumerable: true,
+  get: function () {
+    return VirtualCommandHandlerDeclaration;
+  }
+});