@shell-shock/preset-script 0.6.63 → 0.6.65

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

@@ -1 +1 @@
-{"version":3,"file":"command-router.mjs","names":[],"sources":["../../src/components/command-router.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\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 { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <Spacing />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <Spacing />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <IfStatement condition={code`!command.startsWith(\"-\")`}>\n        <For each={Object.values(commands ?? {})}>\n          {(subcommand, idx) => (\n            <CommandContext.Provider value={subcommand}>\n              <Show\n                when={Boolean(idx)}\n                fallback={\n                  <IfStatement\n                    condition={code`${\n                      context.config.isCaseSensitive\n                        ? \"command\"\n                        : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                    } === \"${\n                      context.config.isCaseSensitive\n                        ? subcommand.name\n                        : subcommand.name\n                            .toLowerCase()\n                            .replaceAll(\"-\", \"\")\n                            .replaceAll(\"_\", \"\")\n                    }\"${\n                      subcommand.alias && subcommand.alias.length > 0\n                        ? ` || ${subcommand.alias\n                            .map(\n                              alias =>\n                                `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                  context.config.isCaseSensitive\n                                    ? alias\n                                    : alias\n                                        .toLowerCase()\n                                        .replaceAll(\"-\", \"\")\n                                        .replaceAll(\"_\", \"\")\n                                }\"`\n                            )\n                            .join(\" || \")}`\n                        : \"\"\n                    }`}>\n                    <Show\n                      when={Boolean(route)}\n                      fallback={<CommandRouterRoute />}>\n                      {route}\n                    </Show>\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </ElseIfClause>\n              </Show>\n            </CommandContext.Provider>\n          )}\n        </For>\n        <ElseIfClause\n          condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = findSuggestions(command, [${Object.values(\n          commands ?? {}\n        )\n          .map(\n            cmd =>\n              `\"${cmd.name}\"${(cmd.alias ?? []).map(alias => `, \"${alias}\"`).join(\"\")}`\n          )\n          .join(\", \")}]).slice(0, 3);\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n      </IfStatement>\n    </Show>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-router.mjs","names":[],"sources":["../../src/components/command-router.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\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 { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <Spacing />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <Spacing />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <IfStatement condition={code`!command.startsWith(\"-\")`}>\n        <For each={Object.values(commands ?? {})}>\n          {(subcommand, idx) => (\n            <CommandContext.Provider value={subcommand}>\n              <Show\n                when={Boolean(idx)}\n                fallback={\n                  <IfStatement\n                    condition={code`${\n                      context.config.isCaseSensitive\n                        ? \"command\"\n                        : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                    } === \"${\n                      context.config.isCaseSensitive\n                        ? subcommand.name\n                        : subcommand.name\n                            .toLowerCase()\n                            .replaceAll(\"-\", \"\")\n                            .replaceAll(\"_\", \"\")\n                    }\"${\n                      subcommand.alias && subcommand.alias.length > 0\n                        ? ` || ${subcommand.alias\n                            .map(\n                              alias =>\n                                `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                  context.config.isCaseSensitive\n                                    ? alias\n                                    : alias\n                                        .toLowerCase()\n                                        .replaceAll(\"-\", \"\")\n                                        .replaceAll(\"_\", \"\")\n                                }\"`\n                            )\n                            .join(\" || \")}`\n                        : \"\"\n                    }`}>\n                    <Show\n                      when={Boolean(route)}\n                      fallback={<CommandRouterRoute />}>\n                      {route}\n                    </Show>\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </ElseIfClause>\n              </Show>\n            </CommandContext.Provider>\n          )}\n        </For>\n        <ElseIfClause\n          condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = findSuggestions(command, [${Object.values(\n          commands ?? {}\n        )\n          .map(\n            cmd =>\n              `\"${cmd.name}\"${(cmd.alias ?? []).map(alias => `, \"${alias}\"`).join(\"\")}`\n          )\n          .join(\", \")}]).slice(0, 3);\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n      </IfStatement>\n    </Show>\n  );\n}\n"],"mappings":"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"}

package/dist/components/exit-function-declaration.cjs

@@ -1,4 +1,95 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core/jsx-runtime`),t=require(`@alloy-js/core`),n=require(`@alloy-js/typescript`),r=require(`@powerlines/plugin-alloy/core/components/spacing`),i=require(`@powerlines/plugin-alloy/core/contexts/context`),a=require(`@shell-shock/core/plugin-utils`),o=require(`@shell-shock/core/components/helpers`);function s(){let s=(0,i.usePowerlines)();return[(0,e.createComponent)(n.InterfaceDeclaration,{export:!0,name:`ExitOptions`,doc:`Options for the exit handler function.`,get children(){return[(0,e.createComponent)(n.InterfaceMember,{name:`exception`,optional:!0,type:`string | Error`,doc:`An optional exception that caused the exit. This can be a string message or an Error object.`}),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(n.InterfaceMember,{name:`skipProcessExit`,optional:!0,type:`boolean`,doc:`Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.`}),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(n.InterfaceMember,{name:`isSynchronous`,optional:!0,type:`boolean`,doc:`Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.`}),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(n.InterfaceMember,{name:`signal`,optional:!0,type:`number`,doc:`The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).`}),(0,e.createIntrinsic)(`hbr`,{}),(0,e.createComponent)(n.InterfaceMember,{name:`startDate`,optional:!0,type:`Date`,doc:`A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.`})]}}),(0,e.createComponent)(r.Spacing,{}),(0,e.createComponent)(n.VarDeclaration,{let:!0,name:`isExiting`,type:`boolean`,initializer:t.code`false;`}),(0,e.createComponent)(n.VarDeclaration,{const:!0,name:`callbackAsyncQueue`,type:`Array<[(code: number | string) => Promise<void> | void, number]>`,initializer:t.code`[];`}),(0,e.createComponent)(n.VarDeclaration,{const:!0,name:`callbackSyncQueue`,type:`Array<(code: number | string) => void>`,initializer:t.code`[];`}),(0,e.createComponent)(r.Spacing,{}),(0,e.createComponent)(n.FunctionDeclaration,{export:!0,async:!0,name:`exit`,parameters:[{name:`options`,type:`ExitOptions`,default:`{}`}],get children(){return[(0,e.memo)(()=>t.code`
+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 _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
+
+//#region src/components/exit-function-declaration.tsx
+/**
+* The `exit` handler function declaration code for the Shell Shock project.
+*/
+function ExitFunctionDeclaration() {
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+			"export": true,
+			name: "ExitOptions",
+			doc: "Options for the exit handler function.",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "exception",
+						optional: true,
+						type: "string | Error",
+						doc: "An optional exception that caused the exit. This can be a string message or an Error object."
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "skipProcessExit",
+						optional: true,
+						type: "boolean",
+						doc: "Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application."
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "isSynchronous",
+						optional: true,
+						type: "boolean",
+						doc: "Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed."
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "signal",
+						optional: true,
+						type: "number",
+						doc: "The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM)."
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "startDate",
+						optional: true,
+						type: "Date",
+						doc: "A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process."
+					})
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"let": true,
+			name: "isExiting",
+			type: "boolean",
+			initializer: _alloy_js_core.code`false;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"const": true,
+			name: "callbackAsyncQueue",
+			type: "Array<[(code: number | string) => Promise<void> | void, number]>",
+			initializer: _alloy_js_core.code`[];`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"const": true,
+			name: "callbackSyncQueue",
+			type: "Array<(code: number | string) => void>",
+			initializer: _alloy_js_core.code`[];`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			async: true,
+			name: "exit",
+			parameters: [{
+				name: "options",
+				type: "ExitOptions",
+				default: "{}"
+			}],
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
           try {
             if (isExiting) {
               return;
@@ -14,13 +105,21 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_
             }
 
             if (options.exception) {
-              error({ message: \`A fatal error occured while running the application - please contact the ${(0,a.getAppTitle)(s)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`,
+              error({ message: \`A fatal error occured while running the application - please contact the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`,
                 ...(options.exception && typeof options.exception === "object" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})
               });
             }
 
-            const terminate = (force = false) => { `),(0,e.createComponent)(n.IfStatement,{get condition(){return(0,e.createComponent)(o.IsVerbose,{})},children:t.code`writeLine("");`}),(0,e.createIntrinsic)(`hbr`,{}),(0,e.memo)(()=>t.code`
-              verbose(\`The ${(0,a.getAppTitle)(s,!0)} application exited \${options.exception ? \`early due to an exception\` : "successfully"}\${options.startDate ? \`. Total processing time is \${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \${Date.now() - options.startDate.getTime() > 5000 ? "seconds" : "milliseconds"}\` : ""}...\`);
+            const terminate = (force = false) => { `),
+					(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.IsVerbose, {});
+						},
+						children: _alloy_js_core.code`writeLine("");`
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
+              verbose(\`The ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} application exited \${options.exception ? \`early due to an exception\` : "successfully"}\${options.startDate ? \`. Total processing time is \${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \${Date.now() - options.startDate.getTime() > 5000 ? "seconds" : "milliseconds"}\` : ""}...\`);
               if (!options.skipProcessExit) {
                 process.nextTick(() => process.exit(exitCode));
               }
@@ -47,10 +146,18 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_
 
             terminate();
           } catch (err) {
-            error(\`The exit process failed to complete\${(err as Error)?.message ? \` - \${(err as Error).message}\` : ""}. Please contact the ${(0,a.getAppTitle)(s,!0)} support team.\`);
+            error(\`The exit process failed to complete\${(err as Error)?.message ? \` - \${(err as Error).message}\` : ""}. Please contact the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} support team.\`);
 
             if (!options.skipProcessExit) {
               process.nextTick(() => process.exit(1));
             }
           }
-        `)]}})]}exports.ExitFunctionDeclaration=s;
+        `)
+				];
+			}
+		})
+	];
+}
+
+//#endregion
+exports.ExitFunctionDeclaration = ExitFunctionDeclaration;

package/dist/components/exit-function-declaration.mjs

@@ -1,4 +1,93 @@
-import{createComponent as e,createIntrinsic as t,memo as n}from"@alloy-js/core/jsx-runtime";import{code as r}from"@alloy-js/core";import{FunctionDeclaration as i,IfStatement as a,InterfaceDeclaration as o,InterfaceMember as s,VarDeclaration as c}from"@alloy-js/typescript";import{Spacing as l}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as u}from"@powerlines/plugin-alloy/core/contexts/context";import{getAppTitle as d}from"@shell-shock/core/plugin-utils";import{IsVerbose as f}from"@shell-shock/core/components/helpers";function p(){let p=u();return[e(o,{export:!0,name:`ExitOptions`,doc:`Options for the exit handler function.`,get children(){return[e(s,{name:`exception`,optional:!0,type:`string | Error`,doc:`An optional exception that caused the exit. This can be a string message or an Error object.`}),t(`hbr`,{}),e(s,{name:`skipProcessExit`,optional:!0,type:`boolean`,doc:`Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.`}),t(`hbr`,{}),e(s,{name:`isSynchronous`,optional:!0,type:`boolean`,doc:`Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.`}),t(`hbr`,{}),e(s,{name:`signal`,optional:!0,type:`number`,doc:`The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).`}),t(`hbr`,{}),e(s,{name:`startDate`,optional:!0,type:`Date`,doc:`A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.`})]}}),e(l,{}),e(c,{let:!0,name:`isExiting`,type:`boolean`,initializer:r`false;`}),e(c,{const:!0,name:`callbackAsyncQueue`,type:`Array<[(code: number | string) => Promise<void> | void, number]>`,initializer:r`[];`}),e(c,{const:!0,name:`callbackSyncQueue`,type:`Array<(code: number | string) => void>`,initializer:r`[];`}),e(l,{}),e(i,{export:!0,async:!0,name:`exit`,parameters:[{name:`options`,type:`ExitOptions`,default:`{}`}],get children(){return[n(()=>r`
+import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
+import { code } from "@alloy-js/core";
+import { FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, VarDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { IsVerbose } from "@shell-shock/core/components/helpers";
+
+//#region src/components/exit-function-declaration.tsx
+/**
+* The `exit` handler function declaration code for the Shell Shock project.
+*/
+function ExitFunctionDeclaration() {
+	const context = usePowerlines();
+	return [
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "ExitOptions",
+			doc: "Options for the exit handler function.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "exception",
+						optional: true,
+						type: "string | Error",
+						doc: "An optional exception that caused the exit. This can be a string message or an Error object."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "skipProcessExit",
+						optional: true,
+						type: "boolean",
+						doc: "Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "isSynchronous",
+						optional: true,
+						type: "boolean",
+						doc: "Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "signal",
+						optional: true,
+						type: "number",
+						doc: "The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM)."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "startDate",
+						optional: true,
+						type: "Date",
+						doc: "A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process."
+					})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(VarDeclaration, {
+			"let": true,
+			name: "isExiting",
+			type: "boolean",
+			initializer: code`false;`
+		}),
+		createComponent(VarDeclaration, {
+			"const": true,
+			name: "callbackAsyncQueue",
+			type: "Array<[(code: number | string) => Promise<void> | void, number]>",
+			initializer: code`[];`
+		}),
+		createComponent(VarDeclaration, {
+			"const": true,
+			name: "callbackSyncQueue",
+			type: "Array<(code: number | string) => void>",
+			initializer: code`[];`
+		}),
+		createComponent(Spacing, {}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			async: true,
+			name: "exit",
+			parameters: [{
+				name: "options",
+				type: "ExitOptions",
+				default: "{}"
+			}],
+			get children() {
+				return [
+					memo(() => code`
           try {
             if (isExiting) {
               return;
@@ -14,13 +103,21 @@ import{createComponent as e,createIntrinsic as t,memo as n}from"@alloy-js/core/j
             }
 
             if (options.exception) {
-              error({ message: \`A fatal error occured while running the application - please contact the ${d(p)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`,
+              error({ message: \`A fatal error occured while running the application - please contact the ${getAppTitle(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`,
                 ...(options.exception && typeof options.exception === "object" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})
               });
             }
 
-            const terminate = (force = false) => { `),e(a,{get condition(){return e(f,{})},children:r`writeLine("");`}),t(`hbr`,{}),n(()=>r`
-              verbose(\`The ${d(p,!0)} application exited \${options.exception ? \`early due to an exception\` : "successfully"}\${options.startDate ? \`. Total processing time is \${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \${Date.now() - options.startDate.getTime() > 5000 ? "seconds" : "milliseconds"}\` : ""}...\`);
+            const terminate = (force = false) => { `),
+					createComponent(IfStatement, {
+						get condition() {
+							return createComponent(IsVerbose, {});
+						},
+						children: code`writeLine("");`
+					}),
+					createIntrinsic("hbr", {}),
+					memo(() => code`
+              verbose(\`The ${getAppTitle(context, true)} application exited \${options.exception ? \`early due to an exception\` : "successfully"}\${options.startDate ? \`. Total processing time is \${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \${Date.now() - options.startDate.getTime() > 5000 ? "seconds" : "milliseconds"}\` : ""}...\`);
               if (!options.skipProcessExit) {
                 process.nextTick(() => process.exit(exitCode));
               }
@@ -47,11 +144,19 @@ import{createComponent as e,createIntrinsic as t,memo as n}from"@alloy-js/core/j
 
             terminate();
           } catch (err) {
-            error(\`The exit process failed to complete\${(err as Error)?.message ? \` - \${(err as Error).message}\` : ""}. Please contact the ${d(p,!0)} support team.\`);
+            error(\`The exit process failed to complete\${(err as Error)?.message ? \` - \${(err as Error).message}\` : ""}. Please contact the ${getAppTitle(context, true)} support team.\`);
 
             if (!options.skipProcessExit) {
               process.nextTick(() => process.exit(1));
             }
           }
-        `)]}})]}export{p as ExitFunctionDeclaration};
+        `)
+				];
+			}
+		})
+	];
+}
+
+//#endregion
+export { ExitFunctionDeclaration };
 //# sourceMappingURL=exit-function-declaration.mjs.map

package/dist/components/exit-function-declaration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"exit-function-declaration.mjs","names":[],"sources":["../../src/components/exit-function-declaration.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 } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\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 { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n                ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n              });\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context,\n                true\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context,\n              true\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":"yiBA4BA,SAAS,GAA+B,CACxC,IAAQ,EAAC,GAAqB,CAC9B,MAAO,CAAA,EAAO,EAAoC,WAEhD,KAAA,cACC,IAAK,yCACN,IAAA,UAAA,CACI,MAAC,CAAA,EAAS,EAA0B,CAClC,KAAA,wBAEA,KAAC,iBACJ,IAAA,+FACE,CAAA,CAAA,EAAA,MAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACC,KAAA,kBACA,SAAM,GACN,KAAK,UACL,IAAC,6SACF,CAAC,CAAE,EAAe,MAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACjB,KAAE,gBACF,SAAQ,GACR,KAAM,UACN,IAAC,2QACF,CAAC,CAAC,EAAK,MAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACN,KAAC,SACD,SAAQ,GACR,KAAE,SACF,IAAE,+IACH,CAAC,CAAE,EAAe,MAAQ,EAAI,CAAA,CAAA,EAAqB,EAAiB,CACnE,KAAC,YACD,SAAM,GACN,KAAC,OACD,IAAE,uIACH,CAAC,CAAC,EAEN,CAAC,CAAE,EAAkB,EAAS,EAAA,CAAG,CAAC,EAAc,EAAe,CAC9D,IAAK,GACL,KAAK,YACL,KAAK,UACL,YAAY,CAAA,SACb,CAAC,CAAE,EAAI,EAAA,CACN,MAAM,GACN,KAAM,qBACN,KAAK,mEACL,YAAU,CAAA,MACX,CAAC,CAAE,EAAG,EAAA,CACL,MAAM,GACN,KAAM,oBACN,KAAM,yCACN,YAAa,CAAI,MAClB,CAAC,CAAE,EAAG,EAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACL,OAAI,GACJ,MAAG,GACH,KAAG,OACH,WAAI,CAAA,CACF,KAAM,UACN,KAAM,cACN,QAAE,KACH,CAAC,CACF,IAAG,UAAA,CACD,MAAE,CAAA,MAAA,CAAA;;;;;;;;;;;;;;;;4GAgBY,EAAA,EAAA,CAAA;;;;;qDAKV,CAAA,EAAA,EAAA,CACF,IAAE,WAAA,CACD,OAAI,EAAA,EAAA,EAAA,CAAA,EAEL,SAAQ,CAAA,iBACT,CAAC,CAAE,EAAU,MAAA,EAAA,CAAA,CAAA,MAAA,CAAA;8BACR,EAAA,EAAA,GAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2B+H,EAAmB,EAAQ,GAAM,CAAC;;;;;;UAMnK,CAAC,EAER,CAAC,CAAC"}
+{"version":3,"file":"exit-function-declaration.mjs","names":[],"sources":["../../src/components/exit-function-declaration.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 } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\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 { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n                ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n              });\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context,\n                true\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context,\n              true\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AA4BA,SAAS,0BAA+B;CACxC,MAAQ,UAAC,eAAqB;AAC9B,QAAO;EAAA,gBAAO,sBAAoC;;GAEhD,MAAA;GACC,KAAK;GACN,IAAA,WAAA;AACI,WAAC;KAAA,gBAAS,iBAA0B;MAClC,MAAA;;MAEA,MAAC;MACJ,KAAA;MACE,CAAA;KAAA,gBAAA,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACC,MAAA;MACA,UAAM;MACN,MAAK;MACL,KAAC;MACF,CAAC;KAAE,gBAAe,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACjB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;KAAC,gBAAK,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAE,gBAAe,OAAQ,EAAI,CAAA;KAAA,gBAAqB,iBAAiB;MACnE,MAAC;MACD,UAAM;MACN,MAAC;MACD,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;EAAE,gBAAkB,SAAS,EAAA,CAAG;EAAC,gBAAc,gBAAe;GAC9D,OAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,IAAA;GACb,CAAC;EAAE,gBAAI,gBAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAU,IAAA;GACX,CAAC;EAAE,gBAAG,gBAAA;GACL,SAAM;GACN,MAAM;GACN,MAAM;GACN,aAAa,IAAI;GAClB,CAAC;EAAE,gBAAG,SAAA,EAAA,CAAA;EAAA,gBAAA,qBAAA;GACL,UAAI;GACJ,OAAG;GACH,MAAG;GACH,YAAI,CAAA;IACF,MAAM;IACN,MAAM;IACN,SAAE;IACH,CAAC;GACF,IAAG,WAAA;AACD,WAAE;KAAA,WAAA,IAAA;;;;;;;;;;;;;;;;4GAgBY,YAAA,QAAA,CAAA;;;;;qDAKV;KAAA,gBAAA,aAAA;MACF,IAAE,YAAA;AACD,cAAI,gBAAA,WAAA,EAAA,CAAA;;MAEL,UAAQ,IAAA;MACT,CAAC;KAAE,gBAAU,OAAA,EAAA,CAAA;KAAA,WAAA,IAAA;8BACR,YAAA,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2B+H,YAAmB,SAAQ,KAAM,CAAC;;;;;;UAMnK;KAAC;;GAER,CAAC;EAAC"}

package/dist/components/index.cjs

@@ -1 +1,18 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./exit-function-declaration.cjs`),t=require(`./bin-entry.cjs`),n=require(`./command-router.cjs`),r=require(`./virtual-command-entry.cjs`),i=require(`./command-entry.cjs`);exports.BinEntry=t.BinEntry,exports.CommandEntry=i.CommandEntry,exports.CommandHandlerDeclaration=i.CommandHandlerDeclaration,exports.CommandInvocation=i.CommandInvocation,exports.CommandRouter=n.CommandRouter,exports.CommandRouterBody=n.CommandRouterBody,exports.CommandRouterRoute=n.CommandRouterRoute,exports.ExitFunctionDeclaration=e.ExitFunctionDeclaration,exports.RunApplication=t.RunApplication,exports.VirtualCommandEntry=r.VirtualCommandEntry,exports.VirtualCommandHandlerDeclaration=r.VirtualCommandHandlerDeclaration;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_components_exit_function_declaration = require('./exit-function-declaration.cjs');
+const require_components_bin_entry = require('./bin-entry.cjs');
+const require_components_command_router = require('./command-router.cjs');
+const require_components_virtual_command_entry = require('./virtual-command-entry.cjs');
+const require_components_command_entry = require('./command-entry.cjs');
+
+exports.BinEntry = require_components_bin_entry.BinEntry;
+exports.CommandEntry = require_components_command_entry.CommandEntry;
+exports.CommandHandlerDeclaration = require_components_command_entry.CommandHandlerDeclaration;
+exports.CommandInvocation = require_components_command_entry.CommandInvocation;
+exports.CommandRouter = require_components_command_router.CommandRouter;
+exports.CommandRouterBody = require_components_command_router.CommandRouterBody;
+exports.CommandRouterRoute = require_components_command_router.CommandRouterRoute;
+exports.ExitFunctionDeclaration = require_components_exit_function_declaration.ExitFunctionDeclaration;
+exports.RunApplication = require_components_bin_entry.RunApplication;
+exports.VirtualCommandEntry = require_components_virtual_command_entry.VirtualCommandEntry;
+exports.VirtualCommandHandlerDeclaration = require_components_virtual_command_entry.VirtualCommandHandlerDeclaration;

package/dist/components/index.mjs

@@ -1 +1,7 @@
-import{ExitFunctionDeclaration as e}from"./exit-function-declaration.mjs";import{BinEntry as t,RunApplication as n}from"./bin-entry.mjs";import{CommandRouter as r,CommandRouterBody as i,CommandRouterRoute as a}from"./command-router.mjs";import{VirtualCommandEntry as o,VirtualCommandHandlerDeclaration as s}from"./virtual-command-entry.mjs";import{CommandEntry as c,CommandHandlerDeclaration as l,CommandInvocation as u}from"./command-entry.mjs";export{t as BinEntry,c as CommandEntry,l as CommandHandlerDeclaration,u as CommandInvocation,r as CommandRouter,i as CommandRouterBody,a as CommandRouterRoute,e as ExitFunctionDeclaration,n as RunApplication,o as VirtualCommandEntry,s as VirtualCommandHandlerDeclaration};
+import { ExitFunctionDeclaration } from "./exit-function-declaration.mjs";
+import { BinEntry, RunApplication } from "./bin-entry.mjs";
+import { CommandRouter, CommandRouterBody, CommandRouterRoute } from "./command-router.mjs";
+import { VirtualCommandEntry, VirtualCommandHandlerDeclaration } from "./virtual-command-entry.mjs";
+import { CommandEntry, CommandHandlerDeclaration, CommandInvocation } from "./command-entry.mjs";
+
+export { BinEntry, CommandEntry, CommandHandlerDeclaration, CommandInvocation, CommandRouter, CommandRouterBody, CommandRouterRoute, ExitFunctionDeclaration, RunApplication, VirtualCommandEntry, VirtualCommandHandlerDeclaration };

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

@@ -1 +1,156 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.cjs`),t=require(`./command-router.cjs`),n=require(`./command-entry.cjs`);let r=require(`@alloy-js/core/jsx-runtime`),i=require(`@alloy-js/core`),a=require(`@alloy-js/typescript`),o=require(`@powerlines/plugin-alloy/core/components`),s=require(`@powerlines/plugin-alloy/core/contexts/context`),c=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`),l=require(`@shell-shock/core/plugin-utils`),u=require(`@stryke/string-format/pascal-case`),d=require(`defu`);d=e.__toESM(d);let f=require(`@stryke/path/join`),p=require(`@stryke/string-format/constant-case`),m=require(`@powerlines/plugin-alloy/typescript/components/typescript-file`);function h(e){let{command:t,children:n,banner:u}=e,d=(0,s.usePowerlines)();return[(0,r.createComponent)(c.TSDoc,{get heading(){return`The ${t.title} (${(0,l.getAppBin)(d)} ${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?`[${(0,p.constantCase)((0,l.getDynamicPathSegmentName)(e))}]`:e).join(` `)}) virtual command.`},get children(){return[(0,r.createComponent)(c.TSDocRemarks,{get children(){return`${t.description.replace(/\.+$/,``)}.`}}),(0,r.createIntrinsic)(`hbr`,{}),(0,r.createComponent)(c.TSDocTitle,{get children(){return t.title}}),(0,r.createComponent)(c.TSDocParam,{name:`args`,children:`The command-line arguments passed to the command.`})]}}),(0,r.createComponent)(a.FunctionDeclaration,{export:!0,async:!0,name:`handler`,parameters:[{name:`args`,type:`string[]`,default:`useArgs()`}],get children(){return[(0,r.createComponent)(o.Spacing,{}),n,(0,r.createComponent)(o.Spacing,{}),(0,r.createComponent)(i.Show,{get when(){return!!u},children:u}),(0,r.createComponent)(o.Spacing,{}),i.code`return showHelp(); `]}})]}function g(e){let{command:a,imports:c,builtinImports:p,..._}=e,v=(0,s.usePowerlines)(),y=(0,i.computed)(()=>(0,f.joinPaths)(v.entryPath,a.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)).join(`/`),`index.ts`));return[(0,r.createComponent)(m.TypescriptFile,(0,r.mergeProps)(_,{get path(){return y.value},get imports(){return(0,d.default)(c??{},Object.entries(a.children).filter(([,e])=>e.isVirtual).reduce((e,[t,n])=>(e[`./${n.name}`]=[{name:`handler`,alias:`handle${(0,u.pascalCase)(t)}`}],e),{}))},get builtinImports(){return(0,d.default)(p??{},{env:[`isDevelopment`,`isDebug`],console:[`warn`,`error`,`writeLine`,`textColors`],utils:[`isMinimal`,`isUnicodeSupported`,`findSuggestions`],state:[{name:`GlobalOptions`,type:!0},`useGlobal`,`useGlobalOptions`,`withCommand`,`useArgs`,`hasFlag`],[(0,f.joinPaths)(`help`,...a.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)))]:[`showHelp`],[(0,f.joinPaths)(`banner`,...a.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)))]:[`showBanner`]})},get children(){return[(0,r.createComponent)(o.Spacing,{}),(0,r.createComponent)(h,{command:a,banner:i.code`await showBanner(); `,get children(){return(0,r.createComponent)(t.CommandRouter,{get segments(){return a.segments},get commands(){return a.children}})}})]}})),(0,r.createComponent)(i.For,{get each(){return Object.values(a.children)},children:e=>(0,r.createComponent)(i.Show,{get when(){return e.isVirtual},get fallback(){return(0,r.createComponent)(n.CommandEntry,{command:e})},get children(){return(0,r.createComponent)(g,{command:e})}})})]}exports.VirtualCommandEntry=g,exports.VirtualCommandHandlerDeclaration=h;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.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 _alloy_js_typescript = require("@alloy-js/typescript");
+let _powerlines_plugin_alloy_core_components = require("@powerlines/plugin-alloy/core/components");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let _powerlines_plugin_alloy_typescript_components_typescript_file = require("@powerlines/plugin-alloy/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, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_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)(_powerlines_plugin_alloy_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)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocTitle, { get children() {
+					return command.title;
+				} }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_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)(_powerlines_plugin_alloy_core_components.Spacing, {}),
+				children,
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_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)(_powerlines_plugin_alloy_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, _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;
+		},
+		get imports() {
+			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)}`
+				}];
+				return ret;
+			}, {}));
+		},
+		get builtinImports() {
+			return (0, defu.default)(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)(_powerlines_plugin_alloy_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.isVirtual;
+			},
+			get fallback() {
+				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 });
+			}
+		})
+	})];
+}
+
+//#endregion
+exports.VirtualCommandEntry = VirtualCommandEntry;
+exports.VirtualCommandHandlerDeclaration = VirtualCommandHandlerDeclaration;