@shell-shock/preset-script 0.6.63 → 0.6.66

package/dist/_virtual/_rolldown/runtime.cjs

@@ -1 +1,29 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/components/bin-entry.cjs

@@ -1,4 +1,29 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.cjs`),t=require(`./exit-function-declaration.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@alloy-js/typescript`),a=require(`@powerlines/plugin-alloy/core/components/spacing`),o=require(`@powerlines/plugin-alloy/core/contexts/context`),s=require(`@powerlines/plugin-alloy/typescript/components/entry-file`),c=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`),l=require(`@shell-shock/core/plugin-utils`),u=require(`@stryke/helpers/get-unique`),d=require(`@stryke/path/file-path-fns`),f=require(`@stryke/path/replace`),p=require(`@stryke/string-format/pascal-case`),m=require(`defu`);m=e.__toESM(m);function h(){return[(0,n.createComponent)(a.Spacing,{}),r.code`// Run the application main logic inside an asynchronous IIFE
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_components_exit_function_declaration = require('./exit-function-declaration.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 _powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
+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_helpers_get_unique = require("@stryke/helpers/get-unique");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+
+//#region src/components/bin-entry.tsx
+/**
+* Runs the application main logic with proper exit handling.
+*/
+function RunApplication() {
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		_alloy_js_core.code`// Run the application main logic inside an asynchronous IIFE
       (async () => {
         const startDate = new Date();
         try {
@@ -64,5 +89,126 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=requi
           exit({ startDate, exception: err as Error });
         }
       })();
-      `,(0,n.createIntrinsic)(`hbr`,{})]}function g(e){let{prefix:g,postfix:_,builtinImports:v,imports:y,children:b,...x}=e,S=(0,o.usePowerlines)(),C=(0,r.computed)(()=>(0,u.getUnique)(Object.values(S.config.bin)));return(0,n.createComponent)(r.For,{get each(){return C.value},children:e=>(0,n.createComponent)(s.EntryFile,(0,n.mergeProps)(x,{get path(){return(0,d.findFileName)((0,f.replaceExtension)(e))},typeDefinition:{file:e,output:`bin`,input:{file:e}},get imports(){return(0,m.default)(y??{},Object.entries(S.commands).filter(([,e])=>e.isVirtual).reduce((e,[t,n])=>(e[`./${n.name}`]=[{name:`handler`,alias:`handle${(0,p.pascalCase)(t)}`}],e),{}))},get builtinImports(){return(0,m.default)(v??{},{env:[`env`,`isDevelopment`,`isDebug`],console:[`verbose`,`table`,`writeLine`,`borderColors`,`textColors`,`stripAnsi`,`error`,`warn`],utils:[`isUnicodeSupported`,`findSuggestions`],state:[`withGlobal`,`useGlobal`,`hasFlag`],help:[`showHelp`],banner:[`showBanner`]})},get children(){return[(0,n.createComponent)(t.ExitFunctionDeclaration,{}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(r.Show,{get when(){return!!g},get children(){return[g,(0,n.createComponent)(a.Spacing,{})]}}),(0,n.createComponent)(c.TSDoc,{get heading(){return`Binary entry point for the ${(0,l.getAppTitle)(S,!0)} command-line interface application.`},get children(){return[(0,n.createComponent)(c.TSDocRemarks,{get children(){return`This file serves as the main entry point for the binary executable of the ${(0,l.getAppTitle)(S,!0)} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}}),(0,n.createComponent)(c.TSDocReturns,{children:`Returns a promise that resolves to either a successful result or an error object.`})]}}),(0,n.createComponent)(i.FunctionDeclaration,{async:!0,returnType:`any | { error: string | Error }`,name:`main`,get children(){return[(0,n.createComponent)(i.IfStatement,{condition:r.code`hasFlag(["version", "v"])`,get children(){return r.code`console.log(${S?.packageJson.version?`"${S?.packageJson.version}"`:`0.0.1`});
-              return; `}}),(0,n.createComponent)(a.Spacing,{}),b,(0,n.createIntrinsic)(`hbr`,{})]}}),(0,n.createIntrinsic)(`hbr`,{}),(0,n.createIntrinsic)(`hbr`,{}),(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(r.Show,{get when(){return!!_},get fallback(){return(0,n.createComponent)(h,{})},children:_}),(0,n.createIntrinsic)(`hbr`,{})]}}))})}exports.BinEntry=g,exports.RunApplication=h;
+      `,
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+/**
+* The binary entry point for the Shell Shock project.
+*/
+function BinEntry(props) {
+	const { prefix, postfix, builtinImports, imports, children, ...rest } = props;
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const bins = (0, _alloy_js_core.computed)(() => (0, _stryke_helpers_get_unique.getUnique)(Object.values(context.config.bin)));
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+		get each() {
+			return bins.value;
+		},
+		children: (bin) => (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_entry_file.EntryFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+			get path() {
+				return (0, _stryke_path_file_path_fns.findFileName)((0, _stryke_path_replace.replaceExtension)(bin));
+			},
+			typeDefinition: {
+				file: bin,
+				output: "bin",
+				input: { file: bin }
+			},
+			get imports() {
+				return (0, defu.default)(imports ?? {}, Object.entries(context.commands).filter(([, command]) => command.virtual).reduce((ret, [name, command]) => {
+					ret[`./${command.name}`] = [{
+						name: "handler",
+						alias: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(name)}`
+					}];
+					return ret;
+				}, {}));
+			},
+			get builtinImports() {
+				return (0, defu.default)(builtinImports ?? {}, {
+					env: [
+						"env",
+						"isDevelopment",
+						"isDebug"
+					],
+					console: [
+						"verbose",
+						"table",
+						"writeLine",
+						"borderColors",
+						"textColors",
+						"stripAnsi",
+						"error",
+						"warn"
+					],
+					utils: ["isUnicodeSupported", "findSuggestions"],
+					state: [
+						"withGlobal",
+						"useGlobal",
+						"hasFlag"
+					],
+					help: ["showHelp"],
+					banner: ["showBanner"]
+				});
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_exit_function_declaration.ExitFunctionDeclaration, {}),
+					(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(prefix);
+						},
+						get children() {
+							return [prefix, (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})];
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+						get heading() {
+							return `Binary entry point for the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} command-line interface application.`;
+						},
+						get children() {
+							return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { get children() {
+								return `This file serves as the main entry point for the binary executable of the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`;
+							} }), (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `Returns a promise that resolves to either a successful result or an error object.` })];
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+						async: true,
+						returnType: "any | { error: string | Error }",
+						name: "main",
+						get children() {
+							return [
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+									condition: _alloy_js_core.code`hasFlag(["version", "v"])`,
+									get children() {
+										return _alloy_js_core.code`console.log(${context?.packageJson.version ? `"${context?.packageJson.version}"` : "0.0.1"});
+              return; `;
+									}
+								}),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+								children,
+								(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+							];
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+						get when() {
+							return Boolean(postfix);
+						},
+						get fallback() {
+							return (0, _alloy_js_core_jsx_runtime.createComponent)(RunApplication, {});
+						},
+						children: postfix
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+				];
+			}
+		}))
+	});
+}
+
+//#endregion
+exports.BinEntry = BinEntry;
+exports.RunApplication = RunApplication;

package/dist/components/bin-entry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.d.cts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA4CA;iBAAgB,cAAA,CAAA,GAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}
+{"version":3,"file":"bin-entry.d.cts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA4CA;iBAAgB,cAAA,IAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}

package/dist/components/bin-entry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.d.mts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA4CA;iBAAgB,cAAA,CAAA,GAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}
+{"version":3,"file":"bin-entry.d.mts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":""}

package/dist/components/bin-entry.mjs

@@ -1,4 +1,26 @@
-import{ExitFunctionDeclaration as e}from"./exit-function-declaration.mjs";import{createComponent as t,createIntrinsic as n,mergeProps as r}from"@alloy-js/core/jsx-runtime";import{For as i,Show as a,code as o,computed as s}from"@alloy-js/core";import{FunctionDeclaration as c,IfStatement as l}from"@alloy-js/typescript";import{Spacing as u}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as d}from"@powerlines/plugin-alloy/core/contexts/context";import{EntryFile as f}from"@powerlines/plugin-alloy/typescript/components/entry-file";import{TSDoc as p,TSDocRemarks as m,TSDocReturns as h}from"@powerlines/plugin-alloy/typescript/components/tsdoc";import{getAppTitle as g}from"@shell-shock/core/plugin-utils";import{getUnique as _}from"@stryke/helpers/get-unique";import{findFileName as v}from"@stryke/path/file-path-fns";import{replaceExtension as y}from"@stryke/path/replace";import{pascalCase as b}from"@stryke/string-format/pascal-case";import x from"defu";function S(){return[t(u,{}),o`// Run the application main logic inside an asynchronous IIFE
+import { ExitFunctionDeclaration } from "./exit-function-declaration.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, Show, code, computed } from "@alloy-js/core";
+import { FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
+import { TSDoc, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { findFileName } from "@stryke/path/file-path-fns";
+import { replaceExtension } from "@stryke/path/replace";
+import { pascalCase } from "@stryke/string-format/pascal-case";
+import defu from "defu";
+
+//#region src/components/bin-entry.tsx
+/**
+* Runs the application main logic with proper exit handling.
+*/
+function RunApplication() {
+	return [
+		createComponent(Spacing, {}),
+		code`// Run the application main logic inside an asynchronous IIFE
       (async () => {
         const startDate = new Date();
         try {
@@ -64,6 +86,126 @@ import{ExitFunctionDeclaration as e}from"./exit-function-declaration.mjs";import
           exit({ startDate, exception: err as Error });
         }
       })();
-      `,n(`hbr`,{})]}function C(C){let{prefix:w,postfix:T,builtinImports:E,imports:D,children:O,...k}=C,A=d(),j=s(()=>_(Object.values(A.config.bin)));return t(i,{get each(){return j.value},children:i=>t(f,r(k,{get path(){return v(y(i))},typeDefinition:{file:i,output:`bin`,input:{file:i}},get imports(){return x(D??{},Object.entries(A.commands).filter(([,e])=>e.isVirtual).reduce((e,[t,n])=>(e[`./${n.name}`]=[{name:`handler`,alias:`handle${b(t)}`}],e),{}))},get builtinImports(){return x(E??{},{env:[`env`,`isDevelopment`,`isDebug`],console:[`verbose`,`table`,`writeLine`,`borderColors`,`textColors`,`stripAnsi`,`error`,`warn`],utils:[`isUnicodeSupported`,`findSuggestions`],state:[`withGlobal`,`useGlobal`,`hasFlag`],help:[`showHelp`],banner:[`showBanner`]})},get children(){return[t(e,{}),t(u,{}),t(a,{get when(){return!!w},get children(){return[w,t(u,{})]}}),t(p,{get heading(){return`Binary entry point for the ${g(A,!0)} command-line interface application.`},get children(){return[t(m,{get children(){return`This file serves as the main entry point for the binary executable of the ${g(A,!0)} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}}),t(h,{children:`Returns a promise that resolves to either a successful result or an error object.`})]}}),t(c,{async:!0,returnType:`any | { error: string | Error }`,name:`main`,get children(){return[t(l,{condition:o`hasFlag(["version", "v"])`,get children(){return o`console.log(${A?.packageJson.version?`"${A?.packageJson.version}"`:`0.0.1`});
-              return; `}}),t(u,{}),O,n(`hbr`,{})]}}),n(`hbr`,{}),n(`hbr`,{}),n(`hbr`,{}),t(a,{get when(){return!!T},get fallback(){return t(S,{})},children:T}),n(`hbr`,{})]}}))})}export{C as BinEntry,S as RunApplication};
+      `,
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* The binary entry point for the Shell Shock project.
+*/
+function BinEntry(props) {
+	const { prefix, postfix, builtinImports, imports, children, ...rest } = props;
+	const context = usePowerlines();
+	const bins = computed(() => getUnique(Object.values(context.config.bin)));
+	return createComponent(For, {
+		get each() {
+			return bins.value;
+		},
+		children: (bin) => createComponent(EntryFile, mergeProps(rest, {
+			get path() {
+				return findFileName(replaceExtension(bin));
+			},
+			typeDefinition: {
+				file: bin,
+				output: "bin",
+				input: { file: bin }
+			},
+			get imports() {
+				return defu(imports ?? {}, Object.entries(context.commands).filter(([, command]) => command.virtual).reduce((ret, [name, command]) => {
+					ret[`./${command.name}`] = [{
+						name: "handler",
+						alias: `handle${pascalCase(name)}`
+					}];
+					return ret;
+				}, {}));
+			},
+			get builtinImports() {
+				return defu(builtinImports ?? {}, {
+					env: [
+						"env",
+						"isDevelopment",
+						"isDebug"
+					],
+					console: [
+						"verbose",
+						"table",
+						"writeLine",
+						"borderColors",
+						"textColors",
+						"stripAnsi",
+						"error",
+						"warn"
+					],
+					utils: ["isUnicodeSupported", "findSuggestions"],
+					state: [
+						"withGlobal",
+						"useGlobal",
+						"hasFlag"
+					],
+					help: ["showHelp"],
+					banner: ["showBanner"]
+				});
+			},
+			get children() {
+				return [
+					createComponent(ExitFunctionDeclaration, {}),
+					createComponent(Spacing, {}),
+					createComponent(Show, {
+						get when() {
+							return Boolean(prefix);
+						},
+						get children() {
+							return [prefix, createComponent(Spacing, {})];
+						}
+					}),
+					createComponent(TSDoc, {
+						get heading() {
+							return `Binary entry point for the ${getAppTitle(context, true)} command-line interface application.`;
+						},
+						get children() {
+							return [createComponent(TSDocRemarks, { get children() {
+								return `This file serves as the main entry point for the binary executable of the ${getAppTitle(context, true)} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`;
+							} }), createComponent(TSDocReturns, { children: `Returns a promise that resolves to either a successful result or an error object.` })];
+						}
+					}),
+					createComponent(FunctionDeclaration, {
+						async: true,
+						returnType: "any | { error: string | Error }",
+						name: "main",
+						get children() {
+							return [
+								createComponent(IfStatement, {
+									condition: code`hasFlag(["version", "v"])`,
+									get children() {
+										return code`console.log(${context?.packageJson.version ? `"${context?.packageJson.version}"` : "0.0.1"});
+              return; `;
+									}
+								}),
+								createComponent(Spacing, {}),
+								children,
+								createIntrinsic("hbr", {})
+							];
+						}
+					}),
+					createIntrinsic("hbr", {}),
+					createIntrinsic("hbr", {}),
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return Boolean(postfix);
+						},
+						get fallback() {
+							return createComponent(RunApplication, {});
+						},
+						children: postfix
+					}),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}))
+	});
+}
+
+//#endregion
+export { BinEntry, RunApplication };
 //# sourceMappingURL=bin-entry.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.mjs","names":[],"sources":["../../src/components/bin-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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\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 { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { ExitFunctionDeclaration } from \"./exit-function-declaration\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <Spacing />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        const startDate = new Date();\n        try {\n          process.on(\"exit\", () => exit({\n            startDate,\n            skipProcessExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            startDate,\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                startDate,\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            startDate,\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            startDate,\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\n              startDate,\n              exception: err || new Error(\\`An \\${type === \"unhandledRejection\" ? \"unhandled promise rejection\" : \"uncaught exception\"} occurred during processing - the application is shutting down.\\`)\n            }));\n          }\n\n          await withGlobal(async () => {\n            const result = await main();\n            if (result?.error) {\n              error(result.error);\n            }\n          });\n\n          exit({ startDate });\n        } catch (err) {\n          exit({ startDate, exception: err as Error });\n        }\n      })();\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface BinEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"hashbang\"\n> {\n  prefix?: Children;\n  postfix?: Children;\n  children: Children;\n}\n\n/**\n * The binary entry point for the Shell Shock project.\n */\nexport function BinEntry(props: BinEntryProps) {\n  const { prefix, postfix, builtinImports, imports, children, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const bins = computed<string[]>(() =>\n    getUnique(Object.values(context.config.bin))\n  );\n\n  return (\n    <For each={bins.value}>\n      {bin => (\n        <EntryFile\n          {...rest}\n          path={findFileName(replaceExtension(bin))}\n          typeDefinition={{\n            file: bin,\n            output: \"bin\",\n            input: {\n              file: bin\n            }\n          }}\n          imports={defu(\n            imports ?? {},\n            Object.entries(context.commands as Record<string, CommandTree>)\n              .filter(([, command]) => command.isVirtual)\n              .reduce((ret, [name, command]) => {\n                ret[`./${command.name}`] = [\n                  { name: \"handler\", alias: `handle${pascalCase(name)}` }\n                ];\n\n                return ret;\n              }, {} as TypescriptFileImports)\n          )}\n          builtinImports={defu(builtinImports ?? {}, {\n            env: [\"env\", \"isDevelopment\", \"isDebug\"],\n            console: [\n              \"verbose\",\n              \"table\",\n              \"writeLine\",\n              \"borderColors\",\n              \"textColors\",\n              \"stripAnsi\",\n              \"error\",\n              \"warn\"\n            ],\n            utils: [\"isUnicodeSupported\", \"findSuggestions\"],\n            state: [\"withGlobal\", \"useGlobal\", \"hasFlag\"],\n            help: [\"showHelp\"],\n            banner: [\"showBanner\"]\n          })}>\n          <ExitFunctionDeclaration />\n          <Spacing />\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <Spacing />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`}>\n            <TSDocRemarks>\n              {`This file serves as the main entry point for the binary executable of the ${getAppTitle(\n                context,\n                true\n              )} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}\n            </TSDocRemarks>\n            <TSDocReturns>\n              {`Returns a promise that resolves to either a successful result or an error object.`}\n            </TSDocReturns>\n          </TSDoc>\n          <FunctionDeclaration\n            async\n            returnType=\"any | { error: string | Error }\"\n            name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${\n                context?.packageJson.version\n                  ? `\"${context?.packageJson.version}\"`\n                  : \"0.0.1\"\n              });\n              return; `}\n            </IfStatement>\n            <Spacing />\n            {children}\n            <hbr />\n          </FunctionDeclaration>\n          <hbr />\n          <hbr />\n          <hbr />\n          <Show when={Boolean(postfix)} fallback={<RunApplication />}>\n            {postfix}\n          </Show>\n          <hbr />\n        </EntryFile>\n      )}\n    </For>\n  );\n}\n"],"mappings":"y9BAoCA,SAAS,GAAoB,CAC7B,MAAO,CAAA,EAAgB,EAAA,EAAA,CAAA,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkEd,EAAkB,MAAM,EAAA,CAAI,CAAC,eAMpC,GAAM,CACJ,SACA,UACA,iBACA,UACA,WACA,GAAG,GACD,EACH,EAAA,GAAA,CACH,EAAA,MAAA,EAAA,OAAA,OAAA,EAAA,OAAA,IAAA,CAAA,CAAA,aAEA,IAAO,MAAA,CACL,OAAA,EAAc,OAEd,SAAA,GAAA,EAAA,EAAA,EAAA,EAAA,CACA,IAAQ,MAAC,CACT,OAAU,EAAQ,EAAA,EAAA,CAAA,EAEpB,eAAA,QAEE,OAAA,MACK,MAAO,CACZ,KAAA,EACK,CACA,eAEC,OAAO,EAAG,GAAa,EAAC,CAAA,OAAA,QAAA,EAAsB,SAAA,CAAA,QAAA,EAAA,KAAA,EAAA,UAAA,CAAA,QAAA,EAAA,CAAA,EAAA,MAC9C,EAAM,KAAC,EAAS,QAAa,CAAC,CAClC,KAAU,UACX,MAAA,SAAA,EAAA,EAAA,KAEM,GACA,EAAI,CAAC,CAAC,EAET,IAAG,gBAAA,CACD,OAAM,EAAI,GAAA,EAAA,CAAA,CACR,IAAK,CAAC,MAAA,gBAAa,UAAqB,CACxC,QAAA,CAAA,UAAgB,QAAA,YAAA,eAAA,aAAA,YAAA,QAAA,OAAA,CAChB,MAAO,CAAC,qBAAG,kBAAA,CACX,MAAE,CAAM,aAAO,YAAA,UAAA,CACf,KAAE,CAAK,WAAE,CACT,OAAQ,CAAC,aAAC,CACX,CAAC,EAEJ,IAAI,UAAS,CACX,MAAI,CAAA,EAAa,EAAA,EAAA,CAAA,CAAA,EAAA,EAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACf,IAAE,MAAO,CACP,MAAG,EAAW,GAEhB,IAAI,UAAW,CACb,MAAO,CAAC,EAAO,EAAkB,EAAQ,EAAA,CAAA,CAAA,SAG3C,IAAI,SAAS,CACX,MAAO,8BAAyB,EAAA,EAAA,GAAA,CAAA,uCAElC,IAAA,UAAe,CACb,MAAO,CAAA,EAAO,EAA0B,CACxC,IAAA,UAAS,CACN,MAAQ,6EAAA,EAAA,EAAA,GAAA,CAAA,waAEV,CAAC,CAAC,EAAU,EAAA,CACX,SAAC,oFACF,CAAC,CAAC,EAEN,CAAC,CAAE,EAAS,EAAA,CACX,MAAK,GACL,WAAG,kCACH,KAAE,OACF,IAAE,UAAS,CACT,MAAO,CAAC,EAAU,EAAA,CAClB,UAAU,CAAA,4BACT,IAAA,UAAA,CACF,MAAA,EAAA,eAAyB,GAAA,YAAA,QAAA,IAAA,GAAA,YAAA,QAAA,GAAA,QAAA;yBAGvB,CAAA,CAAA,EAAM,EAAA,EAAA,CAAA,CAAA,EAAA,EAAA,MAAA,EAAA,CAAA,CAAA,EAEV,CAAC,CAAE,EAAI,MAAA,EAAA,CAAA,CAAA,EAAA,MAAA,EAAA,CAAA,CAAA,EAAA,MAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACN,IAAC,MAAA,CACC,MAAO,EAAG,GAEZ,IAAI,UAAA,CACF,OAAG,EAAsB,EAAe,EAAA,CAAA,EAE1C,SAAU,EACX,CAAC,CAAE,EAAW,MAAA,EAAA,CAAA,CAAA,EAElB,CAAC,CAAC,CACJ,CAAC"}
+{"version":3,"file":"bin-entry.mjs","names":[],"sources":[],"mappings":""}

package/dist/components/command-entry.cjs

@@ -1,4 +1,206 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.cjs`),t=require(`./virtual-command-entry.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@alloy-js/typescript`),a=require(`@powerlines/plugin-alloy/core/components/spacing`),o=require(`@powerlines/plugin-alloy/core/contexts/context`),s=require(`@powerlines/plugin-alloy/typescript/components/entry-file`),c=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`),l=require(`@shell-shock/core/plugin-utils`),u=require(`@stryke/path/replace`),d=require(`@stryke/string-format/pascal-case`),f=require(`defu`);f=e.__toESM(f);let p=require(`@shell-shock/core/components/helpers`),m=require(`@shell-shock/core/components/command-validation-logic`),h=require(`@shell-shock/core/components/options-parser-logic`),g=require(`@stryke/path/find`),_=require(`@stryke/path/join`),v=require(`@stryke/string-format/camel-case`),y=require(`@stryke/string-format/constant-case`),b=require(`@stryke/string-format/kebab-case`);function x(e){let{command:t}=e;return[(0,n.memo)(()=>r.code` return withCommand("${t.path}", [${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?(0,v.camelCase)((0,l.getDynamicPathSegmentName)(e)):`"${e}"`).join(`, `)}], [${Object.keys(t.options).length>0?`options`:``}${t.args.length>0?`${Object.keys(t.options).length>0?`, `:``}${t.args.map(e=>(0,v.camelCase)(e.name)).join(`, `)}`:``}], handle${(0,d.pascalCase)(t.name)}); `),(0,n.createIntrinsic)(`hbr`,{})]}function S(e){let{command:t,banner:s,children:u}=e,d=(0,o.usePowerlines)();return[(0,n.createComponent)(h.OptionsInterfaceDeclaration,{command:t}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(c.TSDoc,{get heading(){return`The ${t.title} (${(0,l.getAppBin)(d)} ${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?`[${(0,y.constantCase)((0,l.getDynamicPathSegmentName)(e))}]`:e).join(` `)}) command.`},get children(){return[(0,n.createComponent)(c.TSDocRemarks,{get children(){return`${t.description.replace(/\.+$/,``)}.`}}),(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(c.TSDocTitle,{get children(){return t.title}}),(0,n.createComponent)(c.TSDocParam,{name:`args`,children:`The command-line arguments passed to the command.`})]}}),(0,n.createComponent)(i.FunctionDeclaration,{export:!0,async:!0,name:`handler`,parameters:[{name:`args`,type:`string[]`,default:`useArgs()`}],get children(){return[(0,n.createComponent)(h.CommandParserLogic,{command:t,get appSpecificEnvPrefix(){return d.config.appSpecificEnvPrefix},get isCaseSensitive(){return d.config.isCaseSensitive}}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(r.Show,{get when(){return!!s},children:s}),(0,n.createComponent)(a.Spacing,{}),r.code`writeLine("");`,(0,n.createComponent)(i.IfStatement,{get condition(){return(0,n.createComponent)(p.IsDebug,{})},get children(){return r.code`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_components_virtual_command_entry = require('./virtual-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_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
+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_path_replace = require("@stryke/path/replace");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let _shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
+let _shell_shock_core_components_command_validation_logic = require("@shell-shock/core/components/command-validation-logic");
+let _shell_shock_core_components_options_parser_logic = require("@shell-shock/core/components/options-parser-logic");
+let _stryke_path_find = require("@stryke/path/find");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+
+//#region src/components/command-entry.tsx
+function CommandInvocation(props) {
+	const { command } = props;
+	return [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code` return withCommand("${command.path}", [${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? (0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment)) : `"${segment}"`).join(", ")}], [${Object.keys(command.options).length > 0 ? `options` : ""}${command.args.length > 0 ? `${Object.keys(command.options).length > 0 ? ", " : ""}${command.args.map((arg) => (0, _stryke_string_format_camel_case.camelCase)(arg.name)).join(", ")}` : ""}], handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}); `), (0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+}
+/**
+* A component that generates the `handler` function declaration for a command.
+*/
+function CommandHandlerDeclaration(props) {
+	const { command, banner, children } = props;
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(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(" ")}) 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)(_shell_shock_core_components_options_parser_logic.CommandParserLogic, {
+						command,
+						get appSpecificEnvPrefix() {
+							return context.config.appSpecificEnvPrefix;
+						},
+						get isCaseSensitive() {
+							return context.config.isCaseSensitive;
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+						get when() {
+							return Boolean(banner);
+						},
+						children: banner
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`writeLine("");`,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						get condition() {
+							return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_helpers.IsDebug, {});
+						},
+						get children() {
+							return _alloy_js_core.code`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
           writeLine("");
-          debug(\`Command path: ${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?`\${${(0,v.camelCase)((0,l.getDynamicPathSegmentName)(e))}}`:e).join(` / `)} \\n\\nOptions: \\n${Object.values(t.options).map(e=>` - ${(0,b.kebabCase)(e.name)}: \${options.${(0,v.camelCase)(e.name)} === undefined ? "" : JSON.stringify(options.${(0,v.camelCase)(e.name)})}`).join(`\\n`)}${t.args.length>0?` \\n\\nArguments: \\n${t.args.map(e=>` - ${(0,b.kebabCase)(e.name)}: \${${(0,v.camelCase)(e.name)} === undefined ? "" : JSON.stringify(${(0,v.camelCase)(e.name)})}`).join(`\\n`)}`:``}\`); `}}),(0,n.createComponent)(a.Spacing,{}),u,(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(i.IfStatement,{condition:r.code`options.help`,children:r.code`return showHelp(); `}),(0,n.createComponent)(i.ElseClause,{get children(){return[(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(x,{command:t})]}})]}})]}function C(e){let{command:c,imports:p,builtinImports:v,...y}=e,b=(0,o.usePowerlines)(),x=(0,r.computed)(()=>(0,_.joinPaths)(c.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)).join(`/`),`index.ts`)),w=(0,r.computed)(()=>(0,u.replaceExtension)((0,g.relativePath)((0,_.joinPaths)(b.entryPath,(0,g.findFilePath)(x.value)),c.entry.input?.file||c.entry.file))),T=(0,r.computed)(()=>({...c.entry,output:c.id}));return[(0,n.createComponent)(s.EntryFile,(0,n.mergeProps)(y,{get path(){return x.value},get typeDefinition(){return T.value},get imports(){return(0,f.default)(p??{},{[w.value.startsWith(`.`)?w.value:`./${w.value}`]:`handle${(0,d.pascalCase)(c.name)}`})},get builtinImports(){return(0,f.default)(v??{},{env:[`env`,`isDevelopment`,`isDebug`],console:[`debug`,`warn`,`error`,`writeLine`,`textColors`],utils:[`isMinimal`,`isUnicodeSupported`],state:[{name:`GlobalOptions`,type:!0},`useGlobal`,`useGlobalOptions`,`useArgs`,`hasFlag`,`withCommand`],[(0,_.joinPaths)(`help`,...c.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)))]:[`showHelp`],[(0,_.joinPaths)(`banner`,...c.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)))]:[`showBanner`]})},get children(){return[(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(h.OptionsInterfaceDeclaration,{command:c}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(S,{command:c,banner:r.code`await showBanner(); `,get children(){return[(0,n.createComponent)(m.CommandValidationLogic,{command:c}),(0,n.createComponent)(i.IfStatement,{condition:r.code`failures.length > 0`,get children(){return r.code`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${c.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
-                options.help = true; `}})]}})]}})),(0,n.createComponent)(r.For,{get each(){return Object.values(c.children)},children:e=>(0,n.createComponent)(r.Show,{get when(){return e.isVirtual},get fallback(){return(0,n.createComponent)(C,{command:e})},get children(){return(0,n.createComponent)(t.VirtualCommandEntry,{command:e})}})})]}exports.CommandEntry=C,exports.CommandHandlerDeclaration=S,exports.CommandInvocation=x;
+          debug(\`Command path: ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `\${${(0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(option.name)}: \${options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)} === undefined ? "" : JSON.stringify(options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(arg.name)}: \${${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} === undefined ? "" : JSON.stringify(${(0, _stryke_string_format_camel_case.camelCase)(arg.name)})}`).join("\\n")}` : ""}\`); `;
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					children,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`options.help`,
+						children: _alloy_js_core.code`return showHelp(); `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { get children() {
+						return [(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), (0, _alloy_js_core_jsx_runtime.createComponent)(CommandInvocation, { command })];
+					} })
+				];
+			}
+		})
+	];
+}
+/**
+* The command entry point for the Shell Shock project.
+*/
+function CommandEntry(props) {
+	const { command, imports, builtinImports, ...rest } = props;
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const filePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_join.joinPaths)(command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)).join("/"), "index.ts"));
+	const commandSourcePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_replace.replaceExtension)((0, _stryke_path_find.relativePath)((0, _stryke_path_join.joinPaths)(context.entryPath, (0, _stryke_path_find.findFilePath)(filePath.value)), command.entry.input?.file || command.entry.file)));
+	const typeDefinition = (0, _alloy_js_core.computed)(() => ({
+		...command.entry,
+		output: command.id
+	}));
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_entry_file.EntryFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get path() {
+			return filePath.value;
+		},
+		get typeDefinition() {
+			return typeDefinition.value;
+		},
+		get imports() {
+			return (0, defu.default)(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}` });
+		},
+		get builtinImports() {
+			return (0, defu.default)(builtinImports ?? {}, {
+				env: [
+					"env",
+					"isDevelopment",
+					"isDebug"
+				],
+				console: [
+					"debug",
+					"warn",
+					"error",
+					"writeLine",
+					"textColors"
+				],
+				utils: ["isMinimal", "isUnicodeSupported"],
+				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
+					"useGlobal",
+					"useGlobalOptions",
+					"useArgs",
+					"hasFlag",
+					"withCommand"
+				],
+				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"],
+				[(0, _stryke_path_join.joinPaths)("banner", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showBanner"]
+			});
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(CommandHandlerDeclaration, {
+					command,
+					banner: _alloy_js_core.code`await showBanner(); `,
+					get children() {
+						return [(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_command_validation_logic.CommandValidationLogic, { command }), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+							condition: _alloy_js_core.code`failures.length > 0`,
+							get children() {
+								return _alloy_js_core.code`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${command.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
+                options.help = true; `;
+							}
+						})];
+					}
+				})
+			];
+		}
+	})), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+		get each() {
+			return Object.values(command.children);
+		},
+		children: (child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return child.virtual;
+			},
+			get fallback() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandEntry, { command: child });
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
+			}
+		})
+	})];
+}
+
+//#endregion
+exports.CommandEntry = CommandEntry;
+exports.CommandHandlerDeclaration = CommandHandlerDeclaration;
+exports.CommandInvocation = CommandInvocation;

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"mappings":";;;;;iBA0DgB,iBAAA,CAAkB,KAAA;EAAS,OAAA,EAAS,WAAA;AAAA,IAAa,QAAA;AAAA,UAyBhD,8BAAA;EACf,OAAA,EAAS,WAAA;EACT,MAAA,GAAS,QAAA;EACT,QAAA,GAAW,QAAA;AAAA;;;;iBAMG,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,QAAA;AAAA,UAqFtB,iBAAA,SAA0B,IAAA,CACzC,cAAA;EAGA,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,QAAA"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"mappings":""}