@shell-shock/preset-cli 0.8.0 → 0.8.3

package/dist/components/upgrade-builtin.cjs

@@ -0,0 +1,171 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_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_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let defu = require("defu");
+let _shell_shock_plugin_upgrade_components_upgrade_builtin = require("@shell-shock/plugin-upgrade/components/upgrade-builtin");
+
+//#region src/components/upgrade-builtin.tsx
+/**
+* A component to generate the `executeUpgrade` function in the `shell-shock:upgrade` builtin module.
+*/
+function ExecuteUpgradeFunctionDeclaration() {
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+		get when() {
+			return context.config.upgradeType !== false;
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+				"export": true,
+				async: true,
+				name: "executeUpgrade",
+				get doc() {
+					return `Run upgrade processing for the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} application.`;
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`await isCheckForUpdatesRequired()`,
+						get children() {
+							return [
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+									"const": true,
+									name: "spinner",
+									initializer: _alloy_js_core.code`createSpinner({
+                message: "Checking for updates..."
+              }).start(); `
+								}),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+									"const": true,
+									name: "result",
+									initializer: _alloy_js_core.code`await checkForUpdates({ force: true }); `
+								}),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+									condition: _alloy_js_core.code`(result as CheckForUpdatesErrorResult)?.isError`,
+									get children() {
+										return _alloy_js_core.code`spinner.error(\`An error occurred while checking for ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} application updates. Please try again later - if the problem persists, please contact support.\`);
+              debug(result.error); `;
+									}
+								}),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
+									condition: _alloy_js_core.code`!(result as CheckForUpdatesSuccessResult)?.isUpToDate`,
+									get children() {
+										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+											get when() {
+												return context.config.upgradeType !== false && (context.config.upgradeType === "confirm" || context.config.upgradeType === "manual");
+											},
+											get fallback() {
+												return [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`spinner.stop();
+                    info(\`A new version of ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} is available: \${colors.red(\`v\${result.currentVersion}\`)} \${colors.text.body.tertiary("➜")} \${colors.green(\`v\${result.latestVersion}\`)}\${result.package.date ? colors.text.body.tertiary(\` (updated on \${result.package.date})\`) : ""}\`);
+
+                    try {
+                      await upgrade();
+                      spinner.success("Update successful! Please restart the application to apply the update.");
+
+                      writeLine("");
+                      writeLine("Press any key to exit the application...");
+
+                      await waitForKeyPress();
+                      return;
+                    } catch (err) {
+                      spinner.error(\`An error occurred while updating ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} to v\${result.latestVersion}. Please try again later - if the problem persists, please contact support.\`);
+                      debug(err);
+                    } `), (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})];
+											},
+											get children() {
+												return [
+													(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`spinner.stop();
+                warn(\`A new version of ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} is available: \${colors.red(\`v\${result.currentVersion}\`)} \${colors.text.body.tertiary("➜")} \${colors.green(\`v\${result.latestVersion}\`)}\${result.package.date ? colors.text.body.tertiary(\` (updated on \${result.package.date})\`) : ""}${context.config.upgradeType !== false && context.config.upgradeType === "manual" ? ` \\nPlease run \`${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} update\` to upgrade to the latest version.` : ""}\`); `),
+													(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+													(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+														get when() {
+															return context.config.upgradeType !== false && context.config.upgradeType === "confirm";
+														},
+														get children() {
+															return _alloy_js_core.code`const willUpgradeNow = await confirm({
+                  message: \`Would you like to update to v\${result.latestVersion} now?\`,
+                  initialValue: true
+                });
+                if (isCancel(willUpgradeNow)) {
+                  return;
+                }
+
+                if (willUpgradeNow) {
+                  spinner.text = \`Updating ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} to v\${result.latestVersion}...\`;
+                  spinner.start();
+
+                  try {
+                    await upgrade();
+                    spinner.success("Update successful! Please restart the application to apply the update.");
+
+                    writeLine("");
+                    writeLine("Press any key to exit the application...");
+
+                    await waitForKeyPress();
+                    return;
+                  } catch (err) {
+                    spinner.error(\`An error occurred while updating ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} to v\${result.latestVersion}. Please try again later - if the problem persists, please contact support.\`);
+                    return { error: err };
+                  }
+                } else {
+                  help("Updates can be performed at any time by running the \`${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} update\` command. Please remember that keeping your application up to date is important for ensuring you have the latest features, performance improvements, and security patches.");
+                } `;
+														}
+													})
+												];
+											}
+										});
+									}
+								}),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { get children() {
+									return _alloy_js_core.code`spinner.success("Currently running the latest version of ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)}.");
+            writeLine("");
+            `;
+								} })
+							];
+						}
+					});
+				}
+			});
+		}
+	});
+}
+/**
+* A built-in upgrade module for Shell Shock.
+*/
+function UpgradeBuiltin(props) {
+	const [{ children, builtinImports }, rest] = (0, _alloy_js_core.splitProps)(props, ["children", "builtinImports"]);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_plugin_upgrade_components_upgrade_builtin.UpgradeBuiltin, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get builtinImports() {
+			return (0, defu.defu)(builtinImports ?? {}, {
+				console: [
+					"colors",
+					"createSpinner",
+					"debug",
+					"info"
+				],
+				prompts: ["waitForKeyPress"]
+			});
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(ExecuteUpgradeFunctionDeclaration, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+exports.ExecuteUpgradeFunctionDeclaration = ExecuteUpgradeFunctionDeclaration;
+exports.UpgradeBuiltin = UpgradeBuiltin;

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

@@ -0,0 +1,15 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { UpgradeBuiltinProps } from "@shell-shock/plugin-upgrade/components/upgrade-builtin";
+
+//#region src/components/upgrade-builtin.d.ts
+/**
+ * A component to generate the `executeUpgrade` function in the `shell-shock:upgrade` builtin module.
+ */
+declare function ExecuteUpgradeFunctionDeclaration(): _alloy_js_core0.Children;
+/**
+ * A built-in upgrade module for Shell Shock.
+ */
+declare function UpgradeBuiltin(props: UpgradeBuiltinProps): _alloy_js_core0.Children;
+//#endregion
+export { ExecuteUpgradeFunctionDeclaration, UpgradeBuiltin };
+//# sourceMappingURL=upgrade-builtin.d.cts.map

package/dist/components/upgrade-builtin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-builtin.d.cts","names":[],"sources":["../../src/components/upgrade-builtin.tsx"],"mappings":";;;;;;;iBAqCgB,iCAAA,CAAA,GAAiC,eAAA,CAAA,QAAA;;;;iBA6IjC,cAAA,CAAe,KAAA,EAAO,mBAAA,GAAmB,eAAA,CAAA,QAAA"}

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

@@ -0,0 +1,15 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { UpgradeBuiltinProps } from "@shell-shock/plugin-upgrade/components/upgrade-builtin";
+
+//#region src/components/upgrade-builtin.d.ts
+/**
+ * A component to generate the `executeUpgrade` function in the `shell-shock:upgrade` builtin module.
+ */
+declare function ExecuteUpgradeFunctionDeclaration(): _alloy_js_core0.Children;
+/**
+ * A built-in upgrade module for Shell Shock.
+ */
+declare function UpgradeBuiltin(props: UpgradeBuiltinProps): _alloy_js_core0.Children;
+//#endregion
+export { ExecuteUpgradeFunctionDeclaration, UpgradeBuiltin };
+//# sourceMappingURL=upgrade-builtin.d.mts.map

package/dist/components/upgrade-builtin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-builtin.d.mts","names":[],"sources":["../../src/components/upgrade-builtin.tsx"],"mappings":";;;;;;;iBAqCgB,iCAAA,CAAA,GAAiC,eAAA,CAAA,QAAA;;;;iBA6IjC,cAAA,CAAe,KAAA,EAAO,mBAAA,GAAmB,eAAA,CAAA,QAAA"}

package/dist/components/upgrade-builtin.mjs

@@ -0,0 +1,169 @@
+import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Show, code, splitProps } from "@alloy-js/core";
+import { ElseClause, ElseIfClause, FunctionDeclaration, IfStatement, VarDeclaration } from "@alloy-js/typescript";
+import { getAppBin, getAppTitle } from "@shell-shock/core/plugin-utils";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { defu as defu$1 } from "defu";
+import { UpgradeBuiltin as UpgradeBuiltin$1 } from "@shell-shock/plugin-upgrade/components/upgrade-builtin";
+
+//#region src/components/upgrade-builtin.tsx
+/**
+* A component to generate the `executeUpgrade` function in the `shell-shock:upgrade` builtin module.
+*/
+function ExecuteUpgradeFunctionDeclaration() {
+	const context = usePowerlines();
+	return createComponent(Show, {
+		get when() {
+			return context.config.upgradeType !== false;
+		},
+		get children() {
+			return createComponent(FunctionDeclaration, {
+				"export": true,
+				async: true,
+				name: "executeUpgrade",
+				get doc() {
+					return `Run upgrade processing for the ${getAppTitle(context, true)} application.`;
+				},
+				get children() {
+					return createComponent(IfStatement, {
+						condition: code`await isCheckForUpdatesRequired()`,
+						get children() {
+							return [
+								createComponent(VarDeclaration, {
+									"const": true,
+									name: "spinner",
+									initializer: code`createSpinner({
+                message: "Checking for updates..."
+              }).start(); `
+								}),
+								createComponent(VarDeclaration, {
+									"const": true,
+									name: "result",
+									initializer: code`await checkForUpdates({ force: true }); `
+								}),
+								createComponent(IfStatement, {
+									condition: code`(result as CheckForUpdatesErrorResult)?.isError`,
+									get children() {
+										return code`spinner.error(\`An error occurred while checking for ${getAppTitle(context, true)} application updates. Please try again later - if the problem persists, please contact support.\`);
+              debug(result.error); `;
+									}
+								}),
+								createComponent(ElseIfClause, {
+									condition: code`!(result as CheckForUpdatesSuccessResult)?.isUpToDate`,
+									get children() {
+										return createComponent(Show, {
+											get when() {
+												return context.config.upgradeType !== false && (context.config.upgradeType === "confirm" || context.config.upgradeType === "manual");
+											},
+											get fallback() {
+												return [memo(() => code`spinner.stop();
+                    info(\`A new version of ${getAppTitle(context, true)} is available: \${colors.red(\`v\${result.currentVersion}\`)} \${colors.text.body.tertiary("➜")} \${colors.green(\`v\${result.latestVersion}\`)}\${result.package.date ? colors.text.body.tertiary(\` (updated on \${result.package.date})\`) : ""}\`);
+
+                    try {
+                      await upgrade();
+                      spinner.success("Update successful! Please restart the application to apply the update.");
+
+                      writeLine("");
+                      writeLine("Press any key to exit the application...");
+
+                      await waitForKeyPress();
+                      return;
+                    } catch (err) {
+                      spinner.error(\`An error occurred while updating ${getAppTitle(context, true)} to v\${result.latestVersion}. Please try again later - if the problem persists, please contact support.\`);
+                      debug(err);
+                    } `), createComponent(Spacing, {})];
+											},
+											get children() {
+												return [
+													memo(() => code`spinner.stop();
+                warn(\`A new version of ${getAppTitle(context, true)} is available: \${colors.red(\`v\${result.currentVersion}\`)} \${colors.text.body.tertiary("➜")} \${colors.green(\`v\${result.latestVersion}\`)}\${result.package.date ? colors.text.body.tertiary(\` (updated on \${result.package.date})\`) : ""}${context.config.upgradeType !== false && context.config.upgradeType === "manual" ? ` \\nPlease run \`${getAppBin(context)} update\` to upgrade to the latest version.` : ""}\`); `),
+													createComponent(Spacing, {}),
+													createComponent(Show, {
+														get when() {
+															return context.config.upgradeType !== false && context.config.upgradeType === "confirm";
+														},
+														get children() {
+															return code`const willUpgradeNow = await confirm({
+                  message: \`Would you like to update to v\${result.latestVersion} now?\`,
+                  initialValue: true
+                });
+                if (isCancel(willUpgradeNow)) {
+                  return;
+                }
+
+                if (willUpgradeNow) {
+                  spinner.text = \`Updating ${getAppTitle(context, true)} to v\${result.latestVersion}...\`;
+                  spinner.start();
+
+                  try {
+                    await upgrade();
+                    spinner.success("Update successful! Please restart the application to apply the update.");
+
+                    writeLine("");
+                    writeLine("Press any key to exit the application...");
+
+                    await waitForKeyPress();
+                    return;
+                  } catch (err) {
+                    spinner.error(\`An error occurred while updating ${getAppTitle(context, true)} to v\${result.latestVersion}. Please try again later - if the problem persists, please contact support.\`);
+                    return { error: err };
+                  }
+                } else {
+                  help("Updates can be performed at any time by running the \`${getAppBin(context)} update\` command. Please remember that keeping your application up to date is important for ensuring you have the latest features, performance improvements, and security patches.");
+                } `;
+														}
+													})
+												];
+											}
+										});
+									}
+								}),
+								createComponent(ElseClause, { get children() {
+									return code`spinner.success("Currently running the latest version of ${getAppTitle(context, true)}.");
+            writeLine("");
+            `;
+								} })
+							];
+						}
+					});
+				}
+			});
+		}
+	});
+}
+/**
+* A built-in upgrade module for Shell Shock.
+*/
+function UpgradeBuiltin(props) {
+	const [{ children, builtinImports }, rest] = splitProps(props, ["children", "builtinImports"]);
+	return createComponent(UpgradeBuiltin$1, mergeProps(rest, {
+		get builtinImports() {
+			return defu$1(builtinImports ?? {}, {
+				console: [
+					"colors",
+					"createSpinner",
+					"debug",
+					"info"
+				],
+				prompts: ["waitForKeyPress"]
+			});
+		},
+		get children() {
+			return [
+				createComponent(ExecuteUpgradeFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+export { ExecuteUpgradeFunctionDeclaration, UpgradeBuiltin };
+//# sourceMappingURL=upgrade-builtin.mjs.map

package/dist/components/upgrade-builtin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-builtin.mjs","names":[],"sources":["../../src/components/upgrade-builtin.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, Show, splitProps } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { getAppBin, getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { UpgradeBuiltinProps } from \"@shell-shock/plugin-upgrade/components/upgrade-builtin\";\nimport { UpgradeBuiltin as BaseUpgradeBuiltin } from \"@shell-shock/plugin-upgrade/components/upgrade-builtin\";\nimport { defu } from \"defu\";\nimport type { CLIPresetContext } from \"../types/plugin\";\n\n/**\n * A component to generate the `executeUpgrade` function in the `shell-shock:upgrade` builtin module.\n */\nexport function ExecuteUpgradeFunctionDeclaration() {\n  const context = usePowerlines<CLIPresetContext>();\n\n  return (\n    <Show when={context.config.upgradeType !== false}>\n      <FunctionDeclaration\n        export\n        async\n        name=\"executeUpgrade\"\n        doc={`Run upgrade processing for the ${getAppTitle(\n          context,\n          true\n        )} application.`}>\n        <IfStatement condition={code`await isCheckForUpdatesRequired()`}>\n          <VarDeclaration\n            const\n            name=\"spinner\"\n            initializer={code`createSpinner({\n                message: \"Checking for updates...\"\n              }).start(); `}\n          />\n          <VarDeclaration\n            const\n            name=\"result\"\n            initializer={code`await checkForUpdates({ force: true }); `}\n          />\n          <IfStatement\n            condition={code`(result as CheckForUpdatesErrorResult)?.isError`}>\n            {code`spinner.error(\\`An error occurred while checking for ${getAppTitle(\n              context,\n              true\n            )} application updates. Please try again later - if the problem persists, please contact support.\\`);\n              debug(result.error); `}\n          </IfStatement>\n          <ElseIfClause\n            condition={code`!(result as CheckForUpdatesSuccessResult)?.isUpToDate`}>\n            <Show\n              when={\n                context.config.upgradeType !== false &&\n                (context.config.upgradeType === \"confirm\" ||\n                  context.config.upgradeType === \"manual\")\n              }\n              fallback={\n                <>\n                  {code`spinner.stop();\n                    info(\\`A new version of ${getAppTitle(\n                      context,\n                      true\n                    )} is available: \\${colors.red(\\`v\\${result.currentVersion}\\`)} \\${colors.text.body.tertiary(\"➜\")} \\${colors.green(\\`v\\${result.latestVersion}\\`)}\\${result.package.date ? colors.text.body.tertiary(\\` (updated on \\${result.package.date})\\`) : \"\"}\\`);\n\n                    try {\n                      await upgrade();\n                      spinner.success(\"Update successful! Please restart the application to apply the update.\");\n\n                      writeLine(\"\");\n                      writeLine(\"Press any key to exit the application...\");\n\n                      await waitForKeyPress();\n                      return;\n                    } catch (err) {\n                      spinner.error(\\`An error occurred while updating ${getAppTitle(\n                        context,\n                        true\n                      )} to v\\${result.latestVersion}. Please try again later - if the problem persists, please contact support.\\`);\n                      debug(err);\n                    } `}\n                  <Spacing />\n                </>\n              }>\n              {code`spinner.stop();\n                warn(\\`A new version of ${getAppTitle(\n                  context,\n                  true\n                )} is available: \\${colors.red(\\`v\\${result.currentVersion}\\`)} \\${colors.text.body.tertiary(\"➜\")} \\${colors.green(\\`v\\${result.latestVersion}\\`)}\\${result.package.date ? colors.text.body.tertiary(\\` (updated on \\${result.package.date})\\`) : \"\"}${\n                  context.config.upgradeType !== false &&\n                  context.config.upgradeType === \"manual\"\n                    ? ` \\\\nPlease run \\`${getAppBin(\n                        context\n                      )} update\\` to upgrade to the latest version.`\n                    : \"\"\n                }\\`); `}\n              <Spacing />\n              <Show\n                when={\n                  context.config.upgradeType !== false &&\n                  context.config.upgradeType === \"confirm\"\n                }>\n                {code`const willUpgradeNow = await confirm({\n                  message: \\`Would you like to update to v\\${result.latestVersion} now?\\`,\n                  initialValue: true\n                });\n                if (isCancel(willUpgradeNow)) {\n                  return;\n                }\n\n                if (willUpgradeNow) {\n                  spinner.text = \\`Updating ${getAppTitle(\n                    context,\n                    true\n                  )} to v\\${result.latestVersion}...\\`;\n                  spinner.start();\n\n                  try {\n                    await upgrade();\n                    spinner.success(\"Update successful! Please restart the application to apply the update.\");\n\n                    writeLine(\"\");\n                    writeLine(\"Press any key to exit the application...\");\n\n                    await waitForKeyPress();\n                    return;\n                  } catch (err) {\n                    spinner.error(\\`An error occurred while updating ${getAppTitle(\n                      context,\n                      true\n                    )} to v\\${result.latestVersion}. Please try again later - if the problem persists, please contact support.\\`);\n                    return { error: err };\n                  }\n                } else {\n                  help(\"Updates can be performed at any time by running the \\`${getAppBin(\n                    context\n                  )} update\\` command. Please remember that keeping your application up to date is important for ensuring you have the latest features, performance improvements, and security patches.\");\n                } `}\n              </Show>\n            </Show>\n          </ElseIfClause>\n          <ElseClause>{code`spinner.success(\"Currently running the latest version of ${getAppTitle(\n            context,\n            true\n          )}.\");\n            writeLine(\"\");\n            `}</ElseClause>\n        </IfStatement>\n      </FunctionDeclaration>\n    </Show>\n  );\n}\n\n/**\n * A built-in upgrade module for Shell Shock.\n */\nexport function UpgradeBuiltin(props: UpgradeBuiltinProps) {\n  const [{ children, builtinImports }, rest] = splitProps(props, [\n    \"children\",\n    \"builtinImports\"\n  ]);\n\n  return (\n    <BaseUpgradeBuiltin\n      {...rest}\n      builtinImports={defu(builtinImports ?? {}, {\n        console: [\"colors\", \"createSpinner\", \"debug\", \"info\"],\n        prompts: [\"waitForKeyPress\"]\n      })}>\n      <ExecuteUpgradeFunctionDeclaration />\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BaseUpgradeBuiltin>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAgCA,SAAc,oCAAkC;;AAE9C,QAAA,gBAAA,MAAA;EACE,IAAC,OAAU;AACb,UAAA,QAAA,OAAA,gBAAA;;EAEA,IAAM,WAAU;;IAEV,UAAC;IACJ,OAAU;IACR,MAAA;IACC,IAAA,MAAA;AACA,YAAA,kCAAA,YAAA,SAAA,KAAA,CAAA;;IAEA,IAAI,WAAM;AACR,YAAO,gBAAA,aAAA;MACP,WAAA,IAAA;MACC,IAAA,WAAc;AAChB,cAAY;QAAA,gBAAgB,gBAAM;SAChC,SAAA;SACC,MAAA;SACI,aAAS,IAAA;;;SAGV,CAAC;QAAC,gBAAU,gBAAA;SAChB,SAAA;SACA,MAAA;SACC,aAAA,IAAA;SACA,CAAI;QAAE,gBAAM,aAAA;SACZ,WAAa,IAAK;SACnB,IAAA,WAAA;AACA,iBAAA,IAAA,wDAAA,YAAA,SAAA,KAAA,CAAA;;;SAGG,CAAA;QAAA,gBAAO,cAAA;SACP,WAAA,IAAA;SACC,IAAA,WAAY;AACb,iBAAM,gBAAgB,MAAA;WACxB,IAAW,OAAA;AACZ,mBAAA,QAAA,OAAA,gBAAA,UAAA,QAAA,OAAA,gBAAA,aAAA,QAAA,OAAA,gBAAA;;WAEE,IAAA,WAAA;AACM,mBAAA,CAAA,WAAA,IAAA;8CAC2B,YAAQ,SAAA,KAAA,CAAA;;;;;;;;;;;;yEAY9B,YAAA,SAAA,KAAA,CAAA;;wBAEF,EAAA,gBAAiB,SAAO,EAAA,CAAU,CAAC;;WAErC,IAAE,WAAa;AACb,mBAAA;aAAA,WAAqB,IAAI;;;;cAEzB,IAAM,OAAA;AACN,sBAAM,QAAA,OAAA,gBAAA,SAAA,QAAA,OAAA,gBAAA;;cAEN,IAAA,WAAgB;AACd,sBAAO,IAAA;;;;;;;;;8CASW,YAAW,SAAA,KAAA,CAAA;;;;;;;;;;;;;uEAahC,YAAA,SAAA,KAAA,CAAA;;;;gFAIsC,UAAA,QAAA,CAAA;;;cAGzC,CAAA;aAAA;;WAEA,CAAA;;;sCAGF,IAAI,WAAA;AACF,gBAAO,IAAC,4DAA+B,YAAA,SAAA,KAAA,CAAA;;;WAI1C,CAAC;QAAC;;MAEN,CAAC;;IAEL,CAAC;;EAEL,CAAC;;;;;AAMJ,SAAgB,eAAY,OAA+B;CACzD,MAAM,CAAC,EACL,UACA,kBACC,QAAQ,WAAO,OAAS,CAAA,YAAY,iBAAA,CAAA;AACvC,QAAO,gBAAS,kBAAA,WAAA,MAAA;EACd,IAAI,iBAAe;AACjB,UAAO,OAAK,kBAAkB,EAAE,EAAC;IAC/B,SAAS;KAAC;KAAE;KAAA;KAAA;KAAA;IACZ,SAAS,CAAC,kBAAY;IACvB,CAAC;;EAEJ,IAAI,WAAU;AACZ,UAAM;IAAA,gBAAY,mCAAA,EAAA,CAAA;IAAA,gBAAA,SAAA,EAAA,CAAA;IAAA,gBAAA,MAAA;KAChB,IAAG,OAAA;AACD,aAAE,QAAO,SAAA;;KAEJ;KACR,CAAC;IAAC;;EAEN,CAAC,CAAC"}

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

@@ -1,17 +1,19 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_components_banner_function_declaration = require('./banner-function-declaration.cjs');
 const require_components_command_router = require('./command-router.cjs');
 const require_components_command_entry = require('./command-entry.cjs');
-let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let __alloy_js_core = require("@alloy-js/core");
-let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
-let __stryke_path_join = require("@stryke/path/join");
-let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _powerlines_plugin_alloy_core_components = require("@powerlines/plugin-alloy/core/components");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
 let defu = require("defu");
-defu = require_rolldown_runtime.__toESM(defu);
-let __powerlines_plugin_alloy_typescript_components_typescript_file = require("@powerlines/plugin-alloy/typescript/components/typescript-file");
-let __shell_shock_preset_script_components_virtual_command_entry = require("@shell-shock/preset-script/components/virtual-command-entry");
+defu = require_runtime.__toESM(defu);
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let _powerlines_plugin_alloy_typescript_components_typescript_file = require("@powerlines/plugin-alloy/typescript/components/typescript-file");
+let _shell_shock_preset_script_components_virtual_command_entry = require("@shell-shock/preset-script/components/virtual-command-entry");
 
 //#region src/components/virtual-command-entry.tsx
 /**
@@ -19,9 +21,9 @@ let __shell_shock_preset_script_components_virtual_command_entry = require("@she
 */
 function VirtualCommandEntry(props) {
 	const { command, imports, builtinImports, ...rest } = props;
-	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const filePath = (0, __alloy_js_core.computed)(() => (0, __stryke_path_join.joinPaths)(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)(__powerlines_plugin_alloy_typescript_components_typescript_file.TypescriptFile, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.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)(_powerlines_plugin_alloy_typescript_components_typescript_file.TypescriptFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
 		get path() {
 			return filePath.value;
 		},
@@ -29,7 +31,7 @@ function VirtualCommandEntry(props) {
 			return (0, defu.default)(imports ?? {}, Object.entries(command.children).filter(([, child]) => child.isVirtual).reduce((ret, [name, child]) => {
 				ret[`./${child.name}`] = [{
 					name: "handler",
-					alias: `handle${(0, __stryke_string_format_pascal_case.pascalCase)(name)}`
+					alias: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(name)}`
 				}];
 				return ret;
 			}, {}));
@@ -65,18 +67,18 @@ function VirtualCommandEntry(props) {
 					"select",
 					"isCancel",
 					"sleep"
-				]
+				],
+				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"]
 			});
 		},
 		get children() {
 			return [
-				(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_preset_script_components_virtual_command_entry.VirtualCommandHandlerDeclaration, {
+				(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_preset_script_components_virtual_command_entry.VirtualCommandHandlerDeclaration, {
 					command,
 					get children() {
-						return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_command_router.CommandRouter, {
+						return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_command_router.CommandRouter, {
 							get segments() {
 								return command.segments;
 							},
@@ -88,19 +90,19 @@ function VirtualCommandEntry(props) {
 				})
 			];
 		}
-	})), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+	})), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 		get each() {
 			return Object.values(command.children);
 		},
-		children: (child) => (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+		children: (child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			get when() {
 				return child.isVirtual;
 			},
 			get fallback() {
-				return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_command_entry.CommandEntry, { command: child });
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_command_entry.CommandEntry, { command: child });
 			},
 			get children() {
-				return (0, __alloy_js_core_jsx_runtime.createComponent)(VirtualCommandEntry, { command: child });
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(VirtualCommandEntry, { command: child });
 			}
 		})
 	})];

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.d.cts","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAkCiB,wBAAA,SAAiC,KAChD;WAGS;;AAJX;;;AAAkD,iBAUlC,mBAAA,CAVkC,KAAA,EAUP,wBAVO,CAAA,EAUiB,eAAA,CAAA,QAVjB"}
+{"version":3,"file":"virtual-command-entry.d.cts","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"mappings":";;;;;UAmCiB,wBAAA,SAAiC,IAAA,CAChD,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;AAJX;;;AAAA,iBAUgB,mBAAA,CAAoB,KAAA,EAAO,wBAAA,GAAwB,eAAA,CAAA,QAAA"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.d.mts","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAkCiB,wBAAA,SAAiC,KAChD;WAGS;;AAJX;;;AAAkD,iBAUlC,mBAAA,CAVkC,KAAA,EAUP,wBAVO,CAAA,EAUiB,eAAA,CAAA,QAVjB"}
+{"version":3,"file":"virtual-command-entry.d.mts","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"mappings":";;;;;UAmCiB,wBAAA,SAAiC,IAAA,CAChD,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;AAJX;;;AAAA,iBAUgB,mBAAA,CAAoB,KAAA,EAAO,wBAAA,GAAwB,eAAA,CAAA,QAAA"}

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

@@ -1,13 +1,14 @@
 import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
 import { CommandRouter } from "./command-router.mjs";
 import { CommandEntry } from "./command-entry.mjs";
-import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { For, Show, computed } from "@alloy-js/core";
-import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { Spacing } from "@powerlines/plugin-alloy/core/components";
 import { isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import defu from "defu";
 import { joinPaths } from "@stryke/path/join";
 import { pascalCase } from "@stryke/string-format/pascal-case";
-import defu from "defu";
 import { TypescriptFile } from "@powerlines/plugin-alloy/typescript/components/typescript-file";
 import { VirtualCommandHandlerDeclaration } from "@shell-shock/preset-script/components/virtual-command-entry";
 
@@ -63,14 +64,14 @@ function VirtualCommandEntry(props) {
 					"select",
 					"isCancel",
 					"sleep"
-				]
+				],
+				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"]
 			});
 		},
 		get children() {
 			return [
 				createComponent(BannerFunctionDeclaration, { command }),
-				createIntrinsic("hbr", {}),
-				createIntrinsic("hbr", {}),
+				createComponent(Spacing, {}),
 				createComponent(VirtualCommandHandlerDeclaration, {
 					command,
 					get children() {

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.mjs","names":["computed","For","Show","usePowerlines","TypescriptFile","isDynamicPathSegment","VirtualCommandHandlerDeclaration","joinPaths","pascalCase","defu","BannerFunctionDeclaration","CommandEntry","CommandRouter","VirtualCommandEntry","props","command","imports","builtinImports","rest","context","filePath","entryPath","segments","filter","segment","join","_$createComponent","_$mergeProps","path","value","Object","entries","children","child","isVirtual","reduce","ret","name","alias","env","console","utils","prompts","_$createIntrinsic","commands","each","values","when","fallback"],"sources":["../../src/components/virtual-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 { computed, For, Show } from \"@alloy-js/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport { VirtualCommandHandlerDeclaration } from \"@shell-shock/preset-script/components/virtual-command-entry\";\nimport { joinPaths } from \"@stryke/path/join\";\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 { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<CLIPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"info\",\n            \"help\",\n            \"table\",\n            \"colors\",\n            \"writeLine\",\n            \"splitText\",\n            \"stripAnsi\"\n          ],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"isInteractive\",\n            \"isHelp\",\n            \"findSuggestions\"\n          ],\n          prompts: [\"text\", \"numeric\", \"toggle\", \"select\", \"isCancel\", \"sleep\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <VirtualCommandHandlerDeclaration command={command}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\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":";;;;;;;;;;;;;;;;;AA4CA,SAAgBa,oBAAoBC,OAAiC;CACnE,MAAM,EAAEC,SAASC,SAASC,gBAAgB,GAAGC,SAASJ;CAEtD,MAAMK,UAAUhB,eAAiC;CACjD,MAAMiB,WAAWpB,eACfO,UACEY,QAAQE,WACRN,QAAQO,SACLC,QAAOC,YAAW,CAACnB,qBAAqBmB,QAAQ,CAAC,CACjDC,KAAK,IAAI,EACZ,WAEJ,CAAC;AAED,QAAA,CAAAC,gBAEKtB,gBAAcuB,WACTT,MAAI;EAAA,IACRU,OAAI;AAAA,UAAER,SAASS;;EAAK,IACpBb,UAAO;AAAA,UAAEP,KACPO,WAAW,EAAE,EACbc,OAAOC,QAAQhB,QAAQiB,SAAS,CAC7BT,QAAQ,GAAGU,WAAWA,MAAMC,UAAU,CACtCC,QAAQC,KAAK,CAACC,MAAMJ,WAAW;AAC9BG,QAAI,KAAKH,MAAMI,UAAU,CACvB;KAAEA,MAAM;KAAWC,OAAO,SAAS9B,WAAW6B,KAAK;KAAI,CACxD;AAED,WAAOD;MACN,EAA2B,CAClC,CAAC;;EAAA,IACDnB,iBAAc;AAAA,UAAER,KAAKQ,kBAAkB,EAAE,EAAE;IACzCsB,KAAK,CAAC,iBAAiB,UAAU;IACjCC,SAAS;KACP;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD;IACDC,OAAO;KACL;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD;IACDC,SAAS;KAAC;KAAQ;KAAW;KAAU;KAAU;KAAY;KAAO;IACrE,CAAC;;EAAA,IAAAV,WAAA;AAAA,UAAA;IAAAN,gBACDhB,2BAAyB,EAAUK,SAAO,CAAA;IAAA4B,gBAAA,OAAA,EAAA,CAAA;IAAAA,gBAAA,OAAA,EAAA,CAAA;IAAAjB,gBAG1CpB,kCAAgC;KAAUS;KAAO,IAAAiB,WAAA;AAAA,aAAAN,gBAC/Cd,eAAa;OAAA,IACZU,WAAQ;AAAA,eAAEP,QAAQO;;OAAQ,IAC1BsB,WAAQ;AAAA,eAAE7B,QAAQiB;;OAAQ,CAAA;;KAAA,CAAA;IAAA;;EAAA,CAAA,CAAA,EAAAN,gBAI/BzB,KAAG;EAAA,IAAC4C,OAAI;AAAA,UAAEf,OAAOgB,OAAO/B,QAAQiB,SAAS;;EAAAA,WACvCC,UAAKP,gBACHxB,MAAI;GAAA,IACH6C,OAAI;AAAA,WAAEd,MAAMC;;GAAS,IACrBc,WAAQ;AAAA,WAAAtB,gBAAGf,cAAY,EAACI,SAASkB,OAAK,CAAA;;GAAA,IAAAD,WAAA;AAAA,WAAAN,gBACrCb,qBAAmB,EAACE,SAASkB,OAAK,CAAA;;GAAA,CAAA;EAEtC,CAAA,CAAA"}
+{"version":3,"file":"virtual-command-entry.mjs","names":[],"sources":["../../src/components/virtual-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 { computed, For, Show } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport { VirtualCommandHandlerDeclaration } from \"@shell-shock/preset-script/components/virtual-command-entry\";\nimport { joinPaths } from \"@stryke/path/join\";\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 { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<CLIPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"info\",\n            \"help\",\n            \"table\",\n            \"colors\",\n            \"writeLine\",\n            \"splitText\",\n            \"stripAnsi\"\n          ],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"isInteractive\",\n            \"isHelp\",\n            \"findSuggestions\"\n          ],\n          prompts: [\"text\", \"numeric\", \"toggle\", \"select\", \"isCancel\", \"sleep\"],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <Spacing />\n        <VirtualCommandHandlerDeclaration command={command}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\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":";;;;;;;;;;;;;;;;;;AA0CA,SAAE,oBAAA,OAAA;CACA,MAAK,EACL,SACF,SACE,4BAEA;CACA,MAAM,UAAU,eAAc;CAC9B,MAAE,WAAS,eAAA,UAAA,QAAA,WAAA,QAAA,SAAA,QAAA,YAAA,CAAA,qBAAA,QAAA,CAAA,CAAA,KAAA,IAAA,EAAA,WAAA,CAAA;AACX,QAAI,CAAA,gBAAiB,gBAAA,WAAA,MAAA;EACnB,IAAE,OAAQ;AACR,UAAG,SAAO;;EAEZ,IAAG,UAAQ;AACX,UAAA,KAAA,WAAA,EAAA,EAAA,OAAA,QAAA,QAAA,SAAA,CAAA,QAAA,GAAA,WAAA,MAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,WAAA;AACD,QAAA,KAAA,MAAA,UAAA,CAAA;;KAEM,OAAA,SAAA,WAAA,KAAA;KACJ,CAAA;AACE,WAAA;MACE,EAAE,CAAK,CAAA;;EAEZ,IAAI,iBAAa;AACf,UAAI,KAAQ,kBAAK,EAAA,EAAA;IACf,KAAE,CAAA,iBAAe,UAAgB;IACjC,SAAK;KAAA;KAAW;KAAW;KAAM;KAAS;KAAA;KAAA;KAAA;KAAA;KAAA;IAC1C,OAAK;KAAA;KAAa;KAAO;KAAW;KAAA;KAAA;KAAA;KAAA;KAAA;IACpC,SAAS;KAAC;KAAK;KAAc;KAAE;KAAA;KAAA;KAAA;KAC9B,UAAS,QAAO,GAAA,QAAU,SAAQ,QAAQ,YAAW,CAAI,qBAAI,QAAA,CAAA,CAAA,GAAA,CAAA,WAAA;IAC/D,CAAC;;EAEJ,IAAI,WAAM;AACR,UAAO;IAAC,gBAAO,2BAAqB,EACjC,SACF,CAAC;IAAA,gBAAoB,SAAC,EAAA,CAAA;IAAA,gBAAsB,kCAAA;KAClC;KACT,IAAE,WAAS;AACT,aAAO,gBAAC,eAAA;OACN,IAAC,WAAM;AACN,eAAK,QAAA;;OAEN,IAAC,WAAM;AACN,eAAO,QAAA;;OAET,CAAC;;KAEL,CAAC;IAAC;;EAEN,CAAC,CAAC,EAAE,gBAAa,KAAA;EAChB,IAAI,OAAK;AACP,UAAO,OAAO,OAAC,QAAA,SAAA;;EAEjB,WAAS,UAAA,gBAAmB,MAAA;GAC1B,IAAI,OAAG;AACL,WAAK,MAAO;;GAEd,IAAI,WAAC;AACH,WAAE,gBAAmB,cAAkB,EACrC,SAAC,OACF,CAAC;;GAEJ,IAAI,WAAW;AACb,WAAI,gBAAA,qBAAA,EACF,SAAM,OACP,CAAC;;GAEL,CAAC;EACH,CAAC,CAAC"}