@shell-shock/core 0.8.12 → 0.9.0

package/dist/plugin-utils/reflect.mjs

@@ -1,6 +1,10 @@
 import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 
 //#region src/plugin-utils/reflect.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
 *
@@ -9,15 +13,39 @@ import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 */
 function sortOptions(options) {
 	if (!options || options.length === 0) return [];
-	return options.filter((arg) => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf).sort((a, b) => a.name.localeCompare(b.name)).reduce((ret, arg) => {
+	return options.filter(__assignType((arg) => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf, [
+		"arg",
+		"",
+		"P\"2!\"/\""
+	])).sort(__assignType((a, b) => a.name.localeCompare(b.name), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])).reduce(__assignType((ret, arg) => {
 		ret.push(arg);
 		if (arg.kind === ReflectionKind.boolean) {
-			const negativeArg = options.find((a) => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name);
+			const negativeArg = options.find(__assignType((a) => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name, [
+				"a",
+				"",
+				"P\"2!\"/\""
+			]));
 			if (negativeArg) ret.push(negativeArg);
 		}
 		return ret;
-	}, []);
+	}, [
+		"ret",
+		"arg",
+		"",
+		"P\"2!\"2\"\"/#"
+	]), []);
 }
+sortOptions.__type = [
+	"CommandOption",
+	"options",
+	"sortOptions",
+	"P\"w!F2\"\"w!F/#"
+];
 
 //#endregion
 export { sortOptions };

package/dist/plugin-utils/reflect.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.mjs","names":["ReflectionKind","sortOptions","options","length","filter","arg","kind","boolean","isNegativeOf","sort","a","b","name","localeCompare","reduce","ret","push","negativeArg","find"],"sources":["../../src/plugin-utils/reflect.ts"],"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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgBC,YAAYC,SAA2C;AACrE,KAAI,CAACA,WAAWA,QAAQC,WAAW,EACjC,QAAO,EAAE;AAGX,QAAOD,QACJE,QAAOC,QAAOA,IAAIC,SAASN,eAAeO,WAAW,CAACF,IAAIG,aAAa,CACvEC,MAAMC,GAAGC,MAAMD,EAAEE,KAAKC,cAAcF,EAAEC,KAAK,CAAC,CAC5CE,QAAQC,KAAKV,QAAQ;AACpBU,MAAIC,KAAKX,IAAI;AAEb,MAAIA,IAAIC,SAASN,eAAeO,SAAS;GAEvC,MAAMU,cAAcf,QAAQgB,MAC1BR,MAAKA,EAAEJ,SAASN,eAAeO,WAAWG,EAAEF,iBAAiBH,IAAIO,KAClE;AACD,OAAIK,YACFF,KAAIC,KAAKC,YAAY;;AAIzB,SAAOF;IACN,EAAqB,CAAC"}
+{"version":3,"file":"reflect.mjs","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA0BX,SAAgB,YAAY,SAAS;AACjC,KAAI,CAAC,WAAI,QAAA,WAAA,EACX,QAAA,EAAA;AAEE,QAAO,QACF,OAAO,cAAa,QAAO,IAAI,SAAS,eAAe,WAAW,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAClE,KAAK,cAAc,GAAG,MAAM,EAAE,KAAK,cAAI,EAAA,KAAA,EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CACvC,OAAO,cAAU,KAAA,QAAA;AAClB,MAAI,KAAK,IAAE;;GAGP,MAAM,cAAc,QAAQ,KAAK,cAAG,MAAA,EAAA,SAAA,eAAA,WAAA,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACpC,OAAI,YACA,KAAI,KAAK,YAAY;;AAG7B,SAAO;IACR;EAAC;EAAA;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}

package/dist/plugin-utils/traverse-command-tree.cjs

@@ -1,5 +1,9 @@
 
 //#region src/plugin-utils/traverse-command-tree.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Traverses a command tree and applies a visitor function to each node.
 *
@@ -8,11 +12,24 @@
 */
 async function traverseCommandTree(commandTree, visitor) {
 	if (!commandTree.children) return;
-	await Promise.all(Object.values(commandTree.children).map(async (childTree) => {
+	await Promise.all(Object.values(commandTree.children).map(__assignType(async (childTree) => {
 		await Promise.resolve(visitor(childTree));
 		await traverseCommandTree(childTree, visitor);
-	}));
+	}, [
+		"childTree",
+		"",
+		"P\"2!\"/\""
+	])));
 }
+traverseCommandTree.__type = [
+	"CommandTree",
+	"commandTree",
+	"node",
+	"",
+	"visitor",
+	"traverseCommandTree",
+	"P\"w!2\"P\"w!2#!/$2%$`/&"
+];
 /**
 * Traverses all commands in the context and applies a visitor function to each command tree.
 *
@@ -21,11 +38,24 @@ async function traverseCommandTree(commandTree, visitor) {
 */
 async function traverseCommands(context, visitor) {
 	if (!context.commands) return;
-	await Promise.all(Object.values(context.commands).map(async (childTree) => {
+	await Promise.all(Object.values(context.commands).map(__assignType(async (childTree) => {
 		await Promise.resolve(visitor(childTree));
 		await traverseCommandTree(childTree, visitor);
-	}));
+	}, [
+		"childTree",
+		"",
+		"P\"2!\"/\""
+	])));
 }
+traverseCommands.__type = [
+	"context",
+	"CommandTree",
+	"node",
+	"",
+	"visitor",
+	"traverseCommands",
+	"P\"2!P\"w\"2#!/$2%$`/&"
+];
 
 //#endregion
 exports.traverseCommandTree = traverseCommandTree;

package/dist/plugin-utils/traverse-command-tree.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-command-tree.cjs","names":["traverseCommandTree","commandTree","visitor","children","Promise","all","Object","values","map","childTree","resolve","traverseCommands","context","commands"],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"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 { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";;;;;;;;AA4BA,eAAsBA,oBACpBC,aACAC,SACe;AACf,KAAI,CAACD,YAAYE,SACf;AAGF,OAAMC,QAAQC,IACZC,OAAOC,OAAON,YAAYE,SAAS,CAACK,IAAI,OAAMC,cAAa;AACzD,QAAML,QAAQM,QAAQR,QAAQO,UAAU,CAAC;AACzC,QAAMT,oBAAoBS,WAAWP,QAAQ;GAEjD,CAAC;;;;;;;;AASH,eAAsBS,iBACpBC,SACAV,SACe;AACf,KAAI,CAACU,QAAQC,SACX;AAGF,OAAMT,QAAQC,IACZC,OAAOC,OAAOK,QAAQC,SAAS,CAACL,IAAI,OAAMC,cAAa;AACrD,QAAML,QAAQM,QAAQR,QAAQO,UAAU,CAAC;AACzC,QAAMT,oBAAoBS,WAAWP,QAAQ;GAEjD,CAAC"}
+{"version":3,"file":"traverse-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"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 { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AAQX,eAAsB,oBAAoB,aAAa,SAAS;AAC5D,KAAI,CAAC,YAAY,SACb;AAEJ,OAAM,QAAQ,IAAI,OAAO,OAAO,YAAA,SAAA,CAAA,IAAA,aAAA,OAAA,cAAA;;AAE5B,QAAM,oBAAoB,WAAW,QAAQ;;;;;;;AAGrD,oBAAoB,SAAS;CAAC;CAAe;CAAM;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnD,eAAsB,iBAAiB,SAAS,SAAS;AACvD,KAAA,CAAA,QAAA,SACM;AAEJ,OAAM,QAAQ,IAAI,OAAO,OAAO,QAAQ,SAAO,CAAA,IAAA,aAAA,OAAA,cAAA;AAC3C,QAAM,QAAG,QAAA,QAAA,UAAA,CAAA;AACT,QAAM,oBAAe,WAAA,QAAA;IACtB;EAAC;EAAE;EAAA;EAAA,CAAA,CAAA,CAAA"}

package/dist/plugin-utils/traverse-command-tree.mjs

@@ -1,4 +1,8 @@
 //#region src/plugin-utils/traverse-command-tree.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Traverses a command tree and applies a visitor function to each node.
 *
@@ -7,11 +11,24 @@
 */
 async function traverseCommandTree(commandTree, visitor) {
 	if (!commandTree.children) return;
-	await Promise.all(Object.values(commandTree.children).map(async (childTree) => {
+	await Promise.all(Object.values(commandTree.children).map(__assignType(async (childTree) => {
 		await Promise.resolve(visitor(childTree));
 		await traverseCommandTree(childTree, visitor);
-	}));
+	}, [
+		"childTree",
+		"",
+		"P\"2!\"/\""
+	])));
 }
+traverseCommandTree.__type = [
+	"CommandTree",
+	"commandTree",
+	"node",
+	"",
+	"visitor",
+	"traverseCommandTree",
+	"P\"w!2\"P\"w!2#!/$2%$`/&"
+];
 /**
 * Traverses all commands in the context and applies a visitor function to each command tree.
 *
@@ -20,11 +37,24 @@ async function traverseCommandTree(commandTree, visitor) {
 */
 async function traverseCommands(context, visitor) {
 	if (!context.commands) return;
-	await Promise.all(Object.values(context.commands).map(async (childTree) => {
+	await Promise.all(Object.values(context.commands).map(__assignType(async (childTree) => {
 		await Promise.resolve(visitor(childTree));
 		await traverseCommandTree(childTree, visitor);
-	}));
+	}, [
+		"childTree",
+		"",
+		"P\"2!\"/\""
+	])));
 }
+traverseCommands.__type = [
+	"context",
+	"CommandTree",
+	"node",
+	"",
+	"visitor",
+	"traverseCommands",
+	"P\"2!P\"w\"2#!/$2%$`/&"
+];
 
 //#endregion
 export { traverseCommandTree, traverseCommands };

package/dist/plugin-utils/traverse-command-tree.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-command-tree.mjs","names":["traverseCommandTree","commandTree","visitor","children","Promise","all","Object","values","map","childTree","resolve","traverseCommands","context","commands"],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"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 { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";;;;;;;AA4BA,eAAsBA,oBACpBC,aACAC,SACe;AACf,KAAI,CAACD,YAAYE,SACf;AAGF,OAAMC,QAAQC,IACZC,OAAOC,OAAON,YAAYE,SAAS,CAACK,IAAI,OAAMC,cAAa;AACzD,QAAML,QAAQM,QAAQR,QAAQO,UAAU,CAAC;AACzC,QAAMT,oBAAoBS,WAAWP,QAAQ;GAEjD,CAAC;;;;;;;;AASH,eAAsBS,iBACpBC,SACAV,SACe;AACf,KAAI,CAACU,QAAQC,SACX;AAGF,OAAMT,QAAQC,IACZC,OAAOC,OAAOK,QAAQC,SAAS,CAACL,IAAI,OAAMC,cAAa;AACrD,QAAML,QAAQM,QAAQR,QAAQO,UAAU,CAAC;AACzC,QAAMT,oBAAoBS,WAAWP,QAAQ;GAEjD,CAAC"}
+{"version":3,"file":"traverse-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"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 { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AAQX,eAAsB,oBAAoB,aAAa,SAAS;AAC5D,KAAI,CAAC,YAAY,SACb;AAEJ,OAAM,QAAQ,IAAI,OAAO,OAAO,YAAA,SAAA,CAAA,IAAA,aAAA,OAAA,cAAA;;AAE5B,QAAM,oBAAoB,WAAW,QAAQ;;;;;;;AAGrD,oBAAoB,SAAS;CAAC;CAAe;CAAM;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnD,eAAsB,iBAAiB,SAAS,SAAS;AACvD,KAAA,CAAA,QAAA,SACM;AAEJ,OAAM,QAAQ,IAAI,OAAO,OAAO,QAAQ,SAAO,CAAA,IAAA,aAAA,OAAA,cAAA;AAC3C,QAAM,QAAG,QAAA,QAAA,UAAA,CAAA;AACT,QAAM,oBAAe,WAAA,QAAA;IACtB;EAAC;EAAE;EAAA;EAAA,CAAA,CAAA,CAAA"}

package/dist/plugin.cjs

@@ -75,6 +75,7 @@ const plugin = (options = {}) => {
 					type: "application",
 					framework: "shell-shock"
 				});
+				if (!result.env.prefix || !Array.isArray(result.env.prefix)) result.env.prefix = (0, __stryke_convert_to_array.toArray)(result.env.prefix);
 				if (!result.env.prefix.includes(result.envPrefix)) result.env.prefix.push(result.envPrefix);
 				return result;
 			},
@@ -97,7 +98,10 @@ const plugin = (options = {}) => {
 				}
 			}
 		},
-		...(0, __powerlines_plugin_nodejs.default)(),
+		...(0, __powerlines_plugin_nodejs.default)((0, defu.defu)(options ?? {}, { env: {
+			types: "@shell-shock/core/types/env#ShellShockEnv",
+			validate: false
+		} })),
 		{
 			name: "shell-shock:inputs",
 			async configResolved() {

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["For","Show","render","automd","deepkit","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","UtilsBuiltin","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","noExternal","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","segments","alias","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","input","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","option","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"sources":["../src/plugin.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 { For, Show } from \"@alloy-js/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveEntries } from \"powerlines/lib/entry\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              buildPath: joinPaths(this.config.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false,\n              noExternal: [\"@powerlines/deepkit\"]\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\n        );\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\n        }\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:reflect-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping reflection initialization as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await reflectCommandTree(this, input);\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\n          if (\n            chunk.isEntry &&\n            joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n          ) {\n            this.debug(\n              `Adding hashbang to binary executable output file: ${chunk.fileName}`\n            );\n\n            return `#!/usr/bin/env ${\n              this.config.mode === \"development\"\n                ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                : \"\"\n            } node\\n`;\n          }\n          return \"\";\n        };\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\n              );\n\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\n                );\n              }\n            })\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"plugin.cjs","names":["For","Show","render","automd","deepkit","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","UtilsBuiltin","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","noExternal","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","input","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","option","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"sources":["../src/plugin.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 { For, Show } from \"@alloy-js/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveEntries } from \"powerlines/lib/entry\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              buildPath: joinPaths(this.config.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false,\n              noExternal: [\"@powerlines/deepkit\"]\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\n        );\n\n        if (!result.env.prefix || !Array.isArray(result.env.prefix)) {\n          result.env.prefix = toArray(result.env.prefix);\n        }\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\n        }\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:reflect-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping reflection initialization as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await reflectCommandTree(this, input);\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\n          if (\n            chunk.isEntry &&\n            joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n          ) {\n            this.debug(\n              `Adding hashbang to binary executable output file: ${chunk.fileName}`\n            );\n\n            return `#!/usr/bin/env ${\n              this.config.mode === \"development\"\n                ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                : \"\"\n            } node\\n`;\n          }\n          return \"\";\n        };\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\n              );\n\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\n                );\n              }\n            })\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAiFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAyejC,MAzeiC,CAye1B,QAze0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAiFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAofjC,MApfiC,CAof1B,QApf0B,CAAA,EAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAiFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAyejC,MAzeiC,CAye1B,QAze0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAiFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAofjC,MApfiC,CAof1B,QApf0B,CAAA,EAAA"}

package/dist/plugin.mjs

@@ -69,6 +69,7 @@ const plugin = (options = {}) => {
 					type: "application",
 					framework: "shell-shock"
 				});
+				if (!result.env.prefix || !Array.isArray(result.env.prefix)) result.env.prefix = toArray(result.env.prefix);
 				if (!result.env.prefix.includes(result.envPrefix)) result.env.prefix.push(result.envPrefix);
 				return result;
 			},
@@ -91,7 +92,10 @@ const plugin = (options = {}) => {
 				}
 			}
 		},
-		...nodejs(),
+		...nodejs(defu(options ?? {}, { env: {
+			types: "@shell-shock/core/types/env#ShellShockEnv",
+			validate: false
+		} })),
 		{
 			name: "shell-shock:inputs",
 			async configResolved() {

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["For","Show","render","automd","deepkit","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","UtilsBuiltin","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","noExternal","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","segments","alias","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","input","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","option","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"sources":["../src/plugin.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 { For, Show } from \"@alloy-js/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveEntries } from \"powerlines/lib/entry\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              buildPath: joinPaths(this.config.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false,\n              noExternal: [\"@powerlines/deepkit\"]\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\n        );\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\n        }\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:reflect-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping reflection initialization as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await reflectCommandTree(this, input);\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\n          if (\n            chunk.isEntry &&\n            joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n          ) {\n            this.debug(\n              `Adding hashbang to binary executable output file: ${chunk.fileName}`\n            );\n\n            return `#!/usr/bin/env ${\n              this.config.mode === \"development\"\n                ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                : \"\"\n            } node\\n`;\n          }\n          return \"\";\n        };\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\n              );\n\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\n                );\n              }\n            })\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","names":["For","Show","render","automd","deepkit","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","UtilsBuiltin","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","noExternal","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","input","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","option","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"sources":["../src/plugin.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 { For, Show } from \"@alloy-js/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveEntries } from \"powerlines/lib/entry\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              buildPath: joinPaths(this.config.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false,\n              noExternal: [\"@powerlines/deepkit\"]\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\n        );\n\n        if (!result.env.prefix || !Array.isArray(result.env.prefix)) {\n          result.env.prefix = toArray(result.env.prefix);\n        }\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\n        }\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:reflect-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping reflection initialization as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await reflectCommandTree(this, input);\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\n          if (\n            chunk.isEntry &&\n            joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n          ) {\n            this.debug(\n              `Adding hashbang to binary executable output file: ${chunk.fileName}`\n            );\n\n            return `#!/usr/bin/env ${\n              this.config.mode === \"development\"\n                ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                : \"\"\n            } node\\n`;\n          }\n          return \"\";\n        };\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\n              );\n\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\n                );\n              }\n            })\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}