@shell-shock/core 0.13.0 → 0.13.2

package/dist/helpers/utilities.cjs

@@ -40,15 +40,15 @@ formatCommandTree.__type = [
 	"P\"w!2\"&/#"
 ];
 /**
-* Retrieves the default command options based on the context configuration.
+* Retrieves the global command options based on the context configuration.
 *
 * @param context - The build context.
-* @param command - The command for which to retrieve default options.
-* @returns A record of default command options.
+* @param command - The command for which to retrieve global options.
+* @returns A record of global command options.
 */
-function getDefaultOptions(context, command) {
+function getGlobalOptions(context, command) {
 	let options;
-	if (Array.isArray(context.config.defaultOptions)) options = Object.fromEntries((0, _stryke_helpers_get_unique.getUniqueBy)(context.config.defaultOptions, __assignType((item) => item.name, [
+	if (Array.isArray(context.config.globalOptions)) options = Object.fromEntries((0, _stryke_helpers_get_unique.getUniqueBy)(context.config.globalOptions, __assignType((item) => item.name, [
 		"CommandOption",
 		"item",
 		"",
@@ -58,7 +58,7 @@ function getDefaultOptions(context, command) {
 		"",
 		"P\"2!\"/\""
 	])));
-	else if ((0, _stryke_type_checks_is_function.isFunction)(context.config.defaultOptions)) options = Object.fromEntries((0, _stryke_helpers_get_unique.getUniqueBy)(context.config.defaultOptions(context, command), __assignType((item) => item.name, [
+	else if ((0, _stryke_type_checks_is_function.isFunction)(context.config.globalOptions)) options = Object.fromEntries((0, _stryke_helpers_get_unique.getUniqueBy)(context.config.globalOptions(context, command), __assignType((item) => item.name, [
 		"CommandOption",
 		"item",
 		"",
@@ -78,18 +78,18 @@ function getDefaultOptions(context, command) {
 		"P\"2!\"/\""
 	])));
 }
-getDefaultOptions.__type = [
+getGlobalOptions.__type = [
 	"Context",
 	"context",
 	"CommandBase",
 	"command",
 	() => __ΩRecord,
 	"CommandOption",
-	"getDefaultOptions",
+	"getGlobalOptions",
 	"P\"w!2\"\"w#2$&\"w&o%#/'"
 ];
 
 //#endregion
 exports.formatCommandTree = formatCommandTree;
-exports.getDefaultOptions = getDefaultOptions;
+exports.getGlobalOptions = getGlobalOptions;
 //# sourceMappingURL=utilities.cjs.map

package/dist/helpers/utilities.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.cjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the default command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve default options.\n * @returns A record of default command options.\n */\nexport function getDefaultOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,kBAAA,SAAA,SAAA;CACH,IAAA;kDAEO,WAAS,OAAA,wDAA2B,QAAU,OAAO,gBAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;0DAEpC,QAAK,OAAA,eAAA,CACzB,WAAU,OAAO,wDAA4B,QAAO,OAAA,eAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAQ,OAAQ,QAAQ,QAAY,CAAC,IAAA,cAAQ,CAAA,KAAa,WAAA,CAC1E,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,6DAAO,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,kBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"utilities.cjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the global command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve global options.\n * @returns A record of global command options.\n */\nexport function getGlobalOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,iBAAA,SAAA,SAAA;CACH,IAAA;iDAEO,WAAS,OAAA,wDAA2B,QAAU,OAAO,eAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;0DAEpC,QAAK,OAAA,cAAA,CACzB,WAAU,OAAO,wDAA4B,QAAO,OAAA,cAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAO,OAAQ,QAAa,QAAQ,CAAA,IAAA,cAAQ,CAAA,KAAa,WAAA,CACzE,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,6DAAO,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,iBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/utilities.mjs

@@ -39,15 +39,15 @@ formatCommandTree.__type = [
 	"P\"w!2\"&/#"
 ];
 /**
-* Retrieves the default command options based on the context configuration.
+* Retrieves the global command options based on the context configuration.
 *
 * @param context - The build context.
-* @param command - The command for which to retrieve default options.
-* @returns A record of default command options.
+* @param command - The command for which to retrieve global options.
+* @returns A record of global command options.
 */
-function getDefaultOptions(context, command) {
+function getGlobalOptions(context, command) {
 	let options;
-	if (Array.isArray(context.config.defaultOptions)) options = Object.fromEntries(getUniqueBy(context.config.defaultOptions, __assignType((item) => item.name, [
+	if (Array.isArray(context.config.globalOptions)) options = Object.fromEntries(getUniqueBy(context.config.globalOptions, __assignType((item) => item.name, [
 		"CommandOption",
 		"item",
 		"",
@@ -57,7 +57,7 @@ function getDefaultOptions(context, command) {
 		"",
 		"P\"2!\"/\""
 	])));
-	else if (isFunction(context.config.defaultOptions)) options = Object.fromEntries(getUniqueBy(context.config.defaultOptions(context, command), __assignType((item) => item.name, [
+	else if (isFunction(context.config.globalOptions)) options = Object.fromEntries(getUniqueBy(context.config.globalOptions(context, command), __assignType((item) => item.name, [
 		"CommandOption",
 		"item",
 		"",
@@ -77,17 +77,17 @@ function getDefaultOptions(context, command) {
 		"P\"2!\"/\""
 	])));
 }
-getDefaultOptions.__type = [
+getGlobalOptions.__type = [
 	"Context",
 	"context",
 	"CommandBase",
 	"command",
 	() => __ΩRecord,
 	"CommandOption",
-	"getDefaultOptions",
+	"getGlobalOptions",
 	"P\"w!2\"\"w#2$&\"w&o%#/'"
 ];
 
 //#endregion
-export { formatCommandTree, getDefaultOptions };
+export { formatCommandTree, getGlobalOptions };
 //# sourceMappingURL=utilities.mjs.map

package/dist/helpers/utilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.mjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the default command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve default options.\n * @returns A record of default command options.\n */\nexport function getDefaultOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,kBAAA,SAAA,SAAA;CACH,IAAA;kDAEO,WAAS,OAAA,YAAkB,YAAS,QAAU,OAAO,gBAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;UAElD,WAAc,QAAK,OAAA,eAAA,CACzB,WAAU,OAAO,YAAe,YAAa,QAAO,OAAA,eAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAQ,OAAQ,QAAQ,QAAY,CAAC,IAAA,cAAQ,CAAA,KAAa,WAAA,CAC1E,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,OAAO,aAAA,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,kBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"utilities.mjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the global command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve global options.\n * @returns A record of global command options.\n */\nexport function getGlobalOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,iBAAA,SAAA,SAAA;CACH,IAAA;iDAEO,WAAS,OAAA,YAAkB,YAAS,QAAU,OAAO,eAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;UAElD,WAAc,QAAK,OAAA,cAAA,CACzB,WAAU,OAAO,YAAe,YAAa,QAAO,OAAA,cAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAO,OAAQ,QAAa,QAAQ,CAAA,IAAA,cAAQ,CAAA,KAAa,WAAA,CACzE,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,OAAO,aAAA,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,iBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/index.cjs

@@ -37,6 +37,7 @@ exports.__ΩNumberCommandParameter = require_types_command.__ΩNumberCommandPara
 exports.__ΩNumberCommandParameterConfig = require_types_command.__ΩNumberCommandParameterConfig;
 exports.__ΩOptions = require_types_config.__ΩOptions;
 exports.__ΩOutputConfig = require_types_config.__ΩOutputConfig;
+exports.__ΩReferenceOptions = require_types_config.__ΩReferenceOptions;
 exports.__ΩResolvedConfig = require_types_config.__ΩResolvedConfig;
 exports.__ΩSerializedCommandTree = require_types_command.__ΩSerializedCommandTree;
 exports.__ΩStringCommandParameter = require_types_command.__ΩStringCommandParameter;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { AsCommandParameterConfig, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig } from "./types/command.cjs";
 import { Context, UnresolvedContext } from "./types/context.cjs";
-import { Options, OutputConfig, ResolvedConfig, UserConfig } from "./types/config.cjs";
+import { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig } from "./types/config.cjs";
 import { ShellShockAPI, createShellShock } from "./api.cjs";
 import { BaseCommandOptions } from "./types/options.cjs";
 import { CommandContext } from "./types/runtime.cjs";
-export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig, createShellShock };
+export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ReferenceOptions, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig, createShellShock };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { AsCommandParameterConfig, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig } from "./types/command.mjs";
 import { Context, UnresolvedContext } from "./types/context.mjs";
-import { Options, OutputConfig, ResolvedConfig, UserConfig } from "./types/config.mjs";
+import { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig } from "./types/config.mjs";
 import { ShellShockAPI, createShellShock } from "./api.mjs";
 import { BaseCommandOptions } from "./types/options.mjs";
 import { CommandContext } from "./types/runtime.mjs";
-export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig, createShellShock };
+export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ReferenceOptions, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig, createShellShock };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { CommandParameterKinds, __ΩAsCommandParameterConfig, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig } from "./types/command.mjs";
-import { __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩUserConfig } from "./types/config.mjs";
+import { __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩUserConfig } from "./types/config.mjs";
 import { __ΩContext, __ΩUnresolvedContext } from "./types/context.mjs";
 import { __ΩBaseCommandOptions } from "./types/options.mjs";
 import { __ΩCommandContext } from "./types/runtime.mjs";
@@ -9,5 +9,5 @@ import { ShellShockAPI, createShellShock } from "./api.mjs";
 var src_default = ShellShockAPI;
 
 //#endregion
-export { CommandParameterKinds, ShellShockAPI, __ΩAsCommandParameterConfig, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandContext, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩContext, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩUnresolvedContext, __ΩUserConfig, createShellShock, src_default as default };
+export { CommandParameterKinds, ShellShockAPI, __ΩAsCommandParameterConfig, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandContext, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩContext, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩUnresolvedContext, __ΩUserConfig, createShellShock, src_default as default };
 //# sourceMappingURL=index.mjs.map

package/dist/plugin.cjs

@@ -1,6 +1,7 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_context_helpers = require('./plugin-utils/context-helpers.cjs');
+const require_types_command = require('./types/command.cjs');
 const require_components_docs = require('./components/docs.cjs');
 const require_components_utils_builtin = require('./components/utils-builtin.cjs');
 const require_traverse_command_tree = require('./plugin-utils/traverse-command-tree.cjs');
@@ -53,7 +54,7 @@ const plugin = (options = {}) => {
 			async config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				await require_update_package_json.updatePackageJsonBinary(this);
-				return (0, defu.defu)({ output: { buildPath: (0, _stryke_path_join_paths.joinPaths)(this.config.root, "dist") } }, options, {
+				return (0, defu.defu)({ output: { path: (0, _stryke_path_join_paths.joinPaths)(this.config.root, "dist") } }, options, {
 					name: require_context_helpers.getAppName(this),
 					title: require_context_helpers.getAppTitle(this),
 					description: require_context_helpers.getAppDescription(this),
@@ -82,7 +83,7 @@ const plugin = (options = {}) => {
 					if (!this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)) this.config.env.prefix.push(this.config.appSpecificEnvPrefix);
 					this.config.bin = ((0, _stryke_type_checks_is_set_string.isSetString)(this.packageJson.bin) ? { [(0, _stryke_string_format_kebab_case.kebabCase)(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [(0, _stryke_string_format_kebab_case.kebabCase)(this.config.name)]: require_update_package_json.formatBinaryPath(this.config.output.format) };
 					this.inputs ??= [];
-					this.options = Object.values(require_utilities.getDefaultOptions(this, {
+					this.options = Object.values(require_utilities.getGlobalOptions(this, {
 						id: null,
 						name: this.config.name,
 						path: null,
@@ -103,6 +104,11 @@ const plugin = (options = {}) => {
 			name: "shell-shock:inputs",
 			async configResolved() {
 				this.debug("Finding command entry point files.");
+				if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.reference)) if (this.config.reference.includes("{command}")) this.config.reference = {
+					app: this.config.reference.substring(0, this.config.reference.indexOf("{command}")).replace(/\/?$/, "/"),
+					commands: this.config.reference
+				};
+				else this.config.reference = { app: this.config.reference };
 				this.commandsPath = require_paths.findCommandsRoot(this);
 				const inputs = await (0, powerlines_utils.resolveInputs)(this, this.config.input);
 				this.debug(`Found ${inputs.length} entry points specified in the configuration options.`);
@@ -139,6 +145,24 @@ const plugin = (options = {}) => {
 				}, this.inputs);
 				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}`).join("\n")}`);
 			},
+			typegen(code) {
+				this.debug("Generating type definitions for the Shell Shock application.");
+				return `${code}
+
+/**
+ * The global options available for every command in the ${require_context_helpers.getAppTitle(this, true)} command-line application.
+ */
+export interface GlobalOptions {
+  ${this.options.map((option) => `${option.description ? `
+/**
+ * ${option.description}${option.default ? `
+ *
+ * @defaultValue ${option.kind === require_types_command.CommandParameterKinds.string ? `"${option.default}"` : option.default}` : ""}
+ */
+` : ""}${option.name}${option.optional ? "?" : ""}: ${option.kind === require_types_command.CommandParameterKinds.boolean ? "boolean" : `${option.variadic ? "(" : ""}${option.choices ? option.choices.map((choice) => option.kind === require_types_command.CommandParameterKinds.number ? `${choice}` : `"${choice}"`).join(" | ") : option.kind === require_types_command.CommandParameterKinds.number ? "number" : "string"}${option.variadic ? ")[]" : ""}`};${option.alias && option.alias.length > 0 ? option.alias.map((alias) => `${alias}${option.optional ? "?" : ""}: ${option.kind === require_types_command.CommandParameterKinds.boolean ? "boolean" : `${option.variadic ? "(" : ""}${option.choices ? option.choices.map((choice) => option.kind === require_types_command.CommandParameterKinds.number ? `${choice}` : `"${choice}"`).join(" | ") : option.kind === require_types_command.CommandParameterKinds.number ? "number" : "string"}${option.variadic ? ")[]" : ""}`};`).join("\n\n") : ""}`).join("\n\n")}
+}
+`;
+			},
 			async prepare() {
 				this.debug("Rendering base built-in modules for the Shell Shock application.");
 				return (0, _powerlines_plugin_alloy_render.render)(this, [(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_utils_builtin.UtilsBuiltin, {})]);

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":[],"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 { 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 { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  findCommandsRoot,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/paths\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\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 { resolve } from \"./resolver/resolve\";\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.root, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            platform: \"node\",\n            projectType: \"application\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"]\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\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.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\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 inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\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:resolve-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 command resolution 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 resolve({\n                context: this,\n                command: input\n              });\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.tsdown.hooks ??= {} as TsdownHooks;\n        (this.config.tsdown.hooks as TsdownHooks)[\"build:done\"] = async (\n          _: BuildContext & {\n            chunks: RolldownChunk[];\n          }\n        ) => {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(this.workspaceConfig.workspaceRoot, this.config.root)\n              );\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding hashbang to binary executable output file: ${path}`\n                );\n\n                const content = await this.fs.read(path);\n                if (content && !content.startsWith(\"#!\")) {\n                  await this.fs.write(\n                    path,\n                    `#!/usr/bin/env ${\n                      this.config.mode === \"development\"\n                        ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                        : \"\"\n                    } node\\n\\n${content}`\n                  );\n                }\n\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${\n                    path\n                  }`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Expected binary output file not found at path: ${\n                    path\n                  }. Skipping adding hashbang and executable permissions (chmod+x).`\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,MAAE,YAAA;;;;AAKF,MAAE,UAAiB,UAAA,EAAA,KAAA;AACjB,QAAA;iCAAU;2CAAA;0CAAA;EAAA;GACV,MAAA;GACA,MAAA,SAAA;AACA,SAAA,MAAA,2CAAoB;AACpB,UAAA,oDAAA,KAAA;AA0BI,0BAzBiB,EACf,QAAC,EACA,kDAAmB,KAAQ,OAAO,MAAM,OAAA,EACxC,EACF,EAAA,SAAO;KACP,MAAO,mCAAU,KAAM;KACvB,OAAO,oCAAU,KAAQ;;KAE1B,UAAY;;KAEhB,iBAAA;KACK,QAAK;MACV,QAAA;MACK,KAAM;MACJ;KACJ,OAAA,CAAA,KAAA,OAAA,SAAA,MAAA,QAAA,KAAA,OAAA,MAAA,IAAA,KAAA,OAAA,MAAA,WAAA,iDAAA,KAAA,OAAA,MAAA,IAAA,OAAA,KAAA,KAAA,OAAA,MAAA,CAAA,WAAA,IAAA,wCAAA,KAAA,OAAA,MAAA,oBAAA,yCAAA,KAAA,OAAA,MAAA,qBAAA,CAAA,GAAA;KACG,SAAC,EACC,UAAE,CAAA,sBAAA,EACR;KACA,QAAQ;MACR,KAAA;MACM,cAAc;MAClB,UAAc;MACZ;;;GAIJ,gBAAgB;IACd,OAAI;IACJ,MAAM,UAAQ;AACZ,UAAK,MAAC,+CAA6C;AACnD,UAAI,OAAA,0EAAA,KAAA,OAAA,cAAA,GAAA,KAAA,OAAA,sEAAA,mCAAA,KAAA,CAAA;AACJ,SAAG,CAAA,KAAA,OAAA,IAAA,UAAA,CAAA,MAAA,QAAA,KAAA,OAAA,IAAA,OAAA,CACD,MAAA,OAAO,IAAA,+CAAA,KAAA,OAAA,IAAA,OAAA;AAET,SAAI,CAAA,KAAM,OAAA,IAAW,OAAK,SAAA,KAAA,OAAA,qBAAA,CACxB,MAAE,OAAO,IAAA,OAAY,KAAK,KAAA,OAAA,qBAAA;AAE5B,UAAI,OAAQ,0DAAQ,KAAA,YAAA,IAAA,GAAA,mDAChB,KAAc,OAAA,KAAY,GAAA,KAAA,YAAA,KAC7B,GAAG,KAAA,YAAiB,QAAK,mDACd,KAAA,OAAA,KAAA,GAAA,6CAAA,KAAA,OAAA,OAAA,OAAA,EACX;AACD,UAAK,WAAM,EAAA;AACX,UAAK,UAAA,OAAA,OAAA,oCAAA,MAAA;MACH,IAAE;MACF,MAAK,KAAK,OAAO;MACjB,MAAK;MACL,UAAU,EAAC;MACX,OAAK,KAAA,OAAc;MACnB,aAAa,KAAK,OAAK;MACvB,OAAO,EAAC;MACR,WAAU;MACX,CAAC,CAAC;;IAEN;GACF;EAAE,yDAAgB,WAAA,EAAA,EAAA,EACjB,KAAK;GACH,OAAO;GACP,UAAM;GACP,EACF,CAAC,CAAC;EAAE;GACH,MAAM;GACN,MAAM,iBAAE;AACN,SAAI,MAAA,qCAAA;AACJ,SAAG,eAAA,+BAAA,KAAA;;AAEH,SAAE,MAAO,SAAM,OAAA,OAAA,uDAAA;AACf,SAAC,SAAA,OAAA,QAAA,KAAA,UAAA;AACD,SAAA,MAAA,SAAgB,KAAA,gBAAA,+CAAA,MAAA,MAAA,KAAA,aAAA,CACd,OAAQ,IAAI,MAAA,wBAAA,MAAA,KAAA,6CAAA,KAAA,aAAA,wFAAA;KAEZ,MAAM,KAAC,+BAAmB,MAAA,MAAc,KAAI;;MAE1C,MAAK,OAAO,iCAAoB,MAAG,KAAA;MACnC,IAAE,WAAY,iCAAA,MAAA,MAAA,KAAA,CAAA,MAAA,IAAA,CAAA,OAAA,QAAA;AAGd,iBAAI,SAAa,KAAA,SAAiB,UAAA;OAChC,MAAC,QAAA,SAAA,WAAA,aAAA,aAAA,QAAA;AACD,WAAC,UAAY,MAAI,UAAQ,MACxB,YAAM,IAAQ,SAAW,QAAK,YAAM,6CAAA,QAAA,IAAA,kDAAA,QAAA,CAAA,QAAA,SAAA,GAAA,KAAA,QAAA,CAAA;AAErC,cAAK;QACP;;OAEE;OACA,MAAM,SAAO,KAAI,IAAO;OACxB;OACA;OACF,OAAA,EAAA;;OAEA,OAAK;QACD,GAAG;QACH,MAAK,MAAA;QACN,OAAA;SACC,MAAK,MAAO;SACd,MAAA,MAAA;SACD;;QAED;OACA,CAAA;;AAEF,YAAM;OACL,KAAK,OAAM;AACd,SAAK,MAAG,4BAAU,KAAA,OAAA,OAAA,0BAAA,KAAA,OAAA,KAAA,YAAA,MAAA,QAAA,GAAA,0CAAA,QAAA,MAAA,MAAA,KAAA,aAAA,GAAA,CAAA,KAAA,KAAA,GAAA;;GAEpB,MAAM,UAAU;AACd,SAAK,MAAG,mEAAoC;AAC5C,uDAAc,MAAG,iDAAA,+CAAA,EAAA,CAAA,CAAA,CAAA;;GAEpB;EAAE;GACD,MAAM;GACN,gBAAI;IACF,OAAA;IACD,MAAA,UAAA;AACE,SAAA,KAAO,OAAS,WAAA,EACb,MAAC,KAAS,oFAAM;UACb;AACH,WAAK,MAAI,yEAAyC,KAAA,OAAA,QAAA,QAAA,CAAA,IAAA,UAAA,CAAA,KAAA,YAAA,MAAA,QAAA,GAAA,kDAAA,QAAA,MAAA,MAAA,KAAA,aAAA,yCAAA,QAAA,MAAA,MAAA,KAAA,aAAA,gDAAA,QAAA,MAAA,MAAA,KAAA,aAAA,GAAA,QAAA,YAAA,eAAA,KAAA,CAAA,KAAA,KAAA,GAAA;AAClD,WAAA,MAAU,+EAAA;AACZ,WAAA,SAAA,KAAA,OAAA,QAAA,KAAA,YAAA;OACD,IAAA,QAAA;OACF,IAAA,kHAAA,QAAA,MAAA,KAAA,CAAA;AACD,yDAAA,YAAA,KAAA,aAAA,CACS,QAAM,eAAa,KAAA,cAAA;AACpB,YAAA,UAAiB,UACX,OAAE,IAAQ,MAAA,0CAA4B,QAAA,KAAA,qBAAA,QAAA,MAAA,KAAA,mEAAA;AAE3C,YAAA,CAAA,IAAY,MAAG,0DAAsB,SAAA,MAAA,KAAA,KAAA,WAAA,EAAA;SACpC,MAAS,8CAAM,YAAwB,aAAa;;AAEhD,aAAA,CAAA,IAAA,MAAA,aAAA,SAAA,OAAA,GAAA,EAAA;UACA,MAAA,OAAA,iCAAA,KAAA;UACC,IAAA,WAAA,iCAAA,MAAA,KAAA,CAAA,MAAA,IAAA,CAAA,OAAA,QAAA;;WAIG,MAAM,QAAQ,SAAM,WAAU,aAAA,aAAA,QAAA;AACvC,eAAA,UAAA,MAAA,UAAA,MACW,YAAQ,IAAA,SAAc,QAAA,YAAA,6CAAA,QAAA,IAAA,kDAAA,QAAA,CAAA,QAAA,SAAA,GAAA,KAAA,QAAA,CAAA;AAElC,kBAAA;YACU;AACP,cAAQ,KAAM;WACP;WACF,MAAI,SAAQ,KAAU,IAAC;WACtB;WACH;WACL,OAAA,EAAA;WACH,WAAA;oBAEW,MACE;WACL,CAAI;;;AAGP,6EAAe,WAAA;;AAGlB,cAAA;SACC,KAAC,OAAW,CAAC,MAAE,GAAA,MAAS,EAAA,SAAS,SAAA,EAAA,SAAA,OAAA;AACpC,WAAK,MAAC,+BAAyB,KAAA,OAAA,KAAA,YAAA,MAAA,QAAA,GAAA,0CAAA,QAAA,MAAA,MAAA,KAAA,aAAA,GAAA,QAAA,YAAA,eAAA,KAAA,CAAA,KAAA,KAAA,GAAA;;;IAGpC;GACF;EAAE;GACD,MAAM;GACN,SAAS;IACP,OAAO;IACP,MAAM,UAAU;AACd,UAAK,MAAM,mDAAM;AACjB,UAAK,WAAW,EAAE;AAClB,SAAI,KAAK,OAAG,YAAA,aAAA,KAAA,OAAA,cAAA,QAAA,KAAA,eAAA,aAAA,KAAA,KAAA,YAAA,KAAA,GAAA,WAAA,+CAAA,KAAA,CAAA,EAAA;AACV,WAAK,MAAG,oEAAA;AACR,YAAI,4CAAA,KAAA;;AAEJ,WAAI,MAAO,SAAO,KAAA,OAAA,QAAA,UAAA,MAAA,SAAA,QAAA,YAAA,CAAA,6CAAA,QAAA,IAAA,CAAA,2CAAA,QAAA,CAAA,CAAA,WAAA,EAAA,CAChB,MAAE,SAAA,MAAA,QAAA,MAAA,wBAAA;;OAEF,SAAS;OACR,CAAC;AAEJ,WAAI,MAAA,wDAAQ;AACZ,WAAI,UAAI,KAAA,QAAA,KAAA,YAAA;OACN,GAAE;OACF,sDAAa,OAAK,KAAA;OAClB,OAAO,OAAE,SAAA,EAAA;OACT,UAAO,OAAK,YAAA;OACb,EAAiB;AAClB,YAAM,+CAAO,OAAA,YAAA;AACX,eAAM,UAAY,OAAI,YAAA,OAAA,QAAA,QAAA,QAAA,CAAA,KAAA,CAAA,MAAA,YAAA,iDAAA,KAAA,EAAA;QACpB,GAAG;QACH,sDAAG,KAAA;QACH,OAAE,OAAQ,SAAA,EAAA;QACV,UAAA,OAAA,YAAA;QACD,CAAC,CAAA,CAAA;QACJ;;;AAGF,UAAG,MAAK,gDAAO;;AAEf,WAAK,+CAAK,OAAA,YAAA;MACR,MAAM,WAAW,oCAAU,QAAA;AAC3B,UAAE,SAAW,SAAC,GAAA;AACZ,YAAA,MAAQ,SAAY,SAAS,OAAC,QAAA,SAAA,SAAA,IAAA,MAAA,GAAA,YAAA,QAAA,MAAA,cAAA,SAAA,KAAA,YAAA,MAAA,QAAA,KAAA,IAAA,QAAA,UAAA,CAAA,KAAA,KAAA,CAAA,IAAA;AAC9B,iBAAI;;OAEN;AACF,SAAI,CAAC,QACH,OAAM,IAAE,MAAK,2HAAA;AAEf,UAAI,KAAA,gEAAA,oCAAA,KAAA,CAAA,IAAA;;IAEP;GACF;EAAE;GACD,MAAE;GACF,iBAAc;AACZ,SAAK,OAAA,OAAc,UAAU,EAAA;AAC7B,IAAC,KAAE,OAAA,OAAA,MAAA,gBAAA,OAAA,MAED;AACA,WAAM,QAAA,IAAA,OAAA,OAAA,KAAA,OAAA,IAAA,CAAA,IAAA,OAAA,QAAA;MACJ,MAAC,2CAAA,4CAAA,KAAA,gBAAA,eAAA,KAAA,OAAA,KAAA,CAAA;AACD,UAAG,KAAA,GAAA,WAAc,KAAA,EAAA;AACf,YAAA,MAAA,qDAAA,OAAA;OACH,MAAA,UAAA,MAAA,KAAA,GAAA,KAAA,KAAA;AACH,WAAA,WAAA,CAAA,QAAA,WAAA,KAAA,CACD,OAAA,KAAA,GAAA,MAAA,MAAA,kBAAA,KAAA,OAAA,SAAA,gBAAA,yCAAA,GAAA,WAAA,UAAA;AAEO,YAAC,MAAM,6EAAqB,OAAA;AAClC,4CAAgB,KAAA;YAEd,MAAM,KAAQ,kDAAE,KAAA,kEAAA;OAEd,CAAC;;;GAGR;EAAE;GACD,MAAM;GACN,iBAAiB;AACf,SAAK,OAAM,WAAY,EAAE;AACzB,SAAK,OAAM,OAAG,aAAA;KACZ,GAAI,KAAK,OAAC,OAAS,cAAA,EAAA;KACnB,UAAU,wBAAQ,KAAA;KACnB;;GAEH,MAAM,OAAO;AACX,SAAK,MAAM,oEAA4C;IACvD,MAAM,WAAI,KAAA,OAAA,KAAA,UAAA,wCAAA,MAAA,MAAA,SAAA,CAAA,CAAA,OAAA,QAAA;AACV,uDAAW,sDAAW,+BAAA;KACpB,IAAI,OAAC;;;KAGL,gBAAe;KACf,WAAK,0DAAA,gCAAA;;AAED,cAAK,CAAA,MAAS;;MAEhB,IAAI,WAAW;yGAEX,SAAM,OACP,CAAC;;MAEL,CAAC;KACH,CAAC,CAAC;;GAEN;EAAC"}
+{"version":3,"file":"plugin.cjs","names":[],"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 { 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 { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  findCommandsRoot,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/paths\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getGlobalOptions } 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 { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport { CommandParameterKinds } 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              path: joinPaths(this.config.root, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            platform: \"node\",\n            projectType: \"application\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"]\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\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.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\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            getGlobalOptions(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        if (isSetString(this.config.reference)) {\n          if (this.config.reference.includes(\"{command}\")) {\n            this.config.reference = {\n              app: this.config.reference\n                .substring(0, this.config.reference.indexOf(\"{command}\"))\n                .replace(/\\/?$/, \"/\"),\n              commands: this.config.reference\n            };\n          } else {\n            this.config.reference = {\n              app: this.config.reference\n            };\n          }\n        }\n\n        this.commandsPath = findCommandsRoot(this);\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\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      typegen(code: string) {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `${code}\n\n/**\n * The global options available for every command in the ${getAppTitle(\n   this,\n   true\n )} command-line application.\n */\nexport interface GlobalOptions {\n  ${this.options\n    .map(\n      option =>\n        `${\n          option.description\n            ? `\n/**\n * ${option.description}${\n   option.default\n     ? `\n *\n * @defaultValue ${\n   option.kind === CommandParameterKinds.string\n     ? `\"${option.default}\"`\n     : option.default\n }`\n     : \"\"\n }\n */\n`\n            : \"\"\n        }${option.name}${option.optional ? \"?\" : \"\"}: ${\n          option.kind === CommandParameterKinds.boolean\n            ? \"boolean\"\n            : `${option.variadic ? \"(\" : \"\"}${\n                option.choices\n                  ? option.choices\n                      .map(choice =>\n                        option.kind === CommandParameterKinds.number\n                          ? `${choice}`\n                          : `\"${choice}\"`\n                      )\n                      .join(\" | \")\n                  : option.kind === CommandParameterKinds.number\n                    ? \"number\"\n                    : \"string\"\n              }${option.variadic ? \")[]\" : \"\"}`\n        };${\n          option.alias && option.alias.length > 0\n            ? option.alias\n                .map(\n                  alias =>\n                    `${alias}${option.optional ? \"?\" : \"\"}: ${\n                      option.kind === CommandParameterKinds.boolean\n                        ? \"boolean\"\n                        : `${option.variadic ? \"(\" : \"\"}${\n                            option.choices\n                              ? option.choices\n                                  .map(choice =>\n                                    option.kind === CommandParameterKinds.number\n                                      ? `${choice}`\n                                      : `\"${choice}\"`\n                                  )\n                                  .join(\" | \")\n                              : option.kind === CommandParameterKinds.number\n                                ? \"number\"\n                                : \"string\"\n                          }${option.variadic ? \")[]\" : \"\"}`\n                    };`\n                )\n                .join(\"\\n\\n\")\n            : \"\"\n        }`\n    )\n    .join(\"\\n\\n\")}\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:resolve-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 command resolution 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 resolve({\n                context: this,\n                command: input\n              });\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.tsdown.hooks ??= {} as TsdownHooks;\n        (this.config.tsdown.hooks as TsdownHooks)[\"build:done\"] = async (\n          _: BuildContext & {\n            chunks: RolldownChunk[];\n          }\n        ) => {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(this.workspaceConfig.workspaceRoot, this.config.root)\n              );\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding hashbang to binary executable output file: ${path}`\n                );\n\n                const content = await this.fs.read(path);\n                if (content && !content.startsWith(\"#!\")) {\n                  await this.fs.write(\n                    path,\n                    `#!/usr/bin/env ${\n                      this.config.mode === \"development\"\n                        ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                        : \"\"\n                    } node\\n\\n${content}`\n                  );\n                }\n\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${\n                    path\n                  }`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Expected binary output file not found at path: ${\n                    path\n                  }. Skipping adding hashbang and executable permissions (chmod+x).`\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"],"mappings":";;;;;;;AAiFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KAyfJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAkFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KA0lBJ,MAAA,CAAO,QAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAiFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KAyfJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAkFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KA0lBJ,MAAA,CAAO,QAAA"}

package/dist/plugin.mjs

@@ -1,4 +1,5 @@
 import { getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, isPathSegmentGroup } from "./plugin-utils/context-helpers.mjs";
+import { CommandParameterKinds } from "./types/command.mjs";
 import { CommandDocsFile } from "./components/docs.mjs";
 import { UtilsBuiltin } from "./components/utils-builtin.mjs";
 import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
@@ -7,7 +8,7 @@ import { commands } from "./helpers/automd.mjs";
 import { findCommandsRoot, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/paths.mjs";
 import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
 import { formatBinaryPath, updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
-import { formatCommandTree, getDefaultOptions } from "./helpers/utilities.mjs";
+import { formatCommandTree, getGlobalOptions } from "./helpers/utilities.mjs";
 import { validateCommand } from "./helpers/validations.mjs";
 import { resolve } from "./resolver/resolve.mjs";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
@@ -48,7 +49,7 @@ const plugin = (options = {}) => {
 			async config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				await updatePackageJsonBinary(this);
-				return defu({ output: { buildPath: joinPaths(this.config.root, "dist") } }, options, {
+				return defu({ output: { path: joinPaths(this.config.root, "dist") } }, options, {
 					name: getAppName(this),
 					title: getAppTitle(this),
 					description: getAppDescription(this),
@@ -77,7 +78,7 @@ const plugin = (options = {}) => {
 					if (!this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)) this.config.env.prefix.push(this.config.appSpecificEnvPrefix);
 					this.config.bin = (isSetString(this.packageJson.bin) ? { [kebabCase(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [kebabCase(this.config.name)]: formatBinaryPath(this.config.output.format) };
 					this.inputs ??= [];
-					this.options = Object.values(getDefaultOptions(this, {
+					this.options = Object.values(getGlobalOptions(this, {
 						id: null,
 						name: this.config.name,
 						path: null,
@@ -98,6 +99,11 @@ const plugin = (options = {}) => {
 			name: "shell-shock:inputs",
 			async configResolved() {
 				this.debug("Finding command entry point files.");
+				if (isSetString(this.config.reference)) if (this.config.reference.includes("{command}")) this.config.reference = {
+					app: this.config.reference.substring(0, this.config.reference.indexOf("{command}")).replace(/\/?$/, "/"),
+					commands: this.config.reference
+				};
+				else this.config.reference = { app: this.config.reference };
 				this.commandsPath = findCommandsRoot(this);
 				const inputs = await resolveInputs(this, this.config.input);
 				this.debug(`Found ${inputs.length} entry points specified in the configuration options.`);
@@ -134,6 +140,24 @@ const plugin = (options = {}) => {
 				}, this.inputs);
 				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}`).join("\n")}`);
 			},
+			typegen(code) {
+				this.debug("Generating type definitions for the Shell Shock application.");
+				return `${code}
+
+/**
+ * The global options available for every command in the ${getAppTitle(this, true)} command-line application.
+ */
+export interface GlobalOptions {
+  ${this.options.map((option) => `${option.description ? `
+/**
+ * ${option.description}${option.default ? `
+ *
+ * @defaultValue ${option.kind === CommandParameterKinds.string ? `"${option.default}"` : option.default}` : ""}
+ */
+` : ""}${option.name}${option.optional ? "?" : ""}: ${option.kind === CommandParameterKinds.boolean ? "boolean" : `${option.variadic ? "(" : ""}${option.choices ? option.choices.map((choice) => option.kind === CommandParameterKinds.number ? `${choice}` : `"${choice}"`).join(" | ") : option.kind === CommandParameterKinds.number ? "number" : "string"}${option.variadic ? ")[]" : ""}`};${option.alias && option.alias.length > 0 ? option.alias.map((alias) => `${alias}${option.optional ? "?" : ""}: ${option.kind === CommandParameterKinds.boolean ? "boolean" : `${option.variadic ? "(" : ""}${option.choices ? option.choices.map((choice) => option.kind === CommandParameterKinds.number ? `${choice}` : `"${choice}"`).join(" | ") : option.kind === CommandParameterKinds.number ? "number" : "string"}${option.variadic ? ")[]" : ""}`};`).join("\n\n") : ""}`).join("\n\n")}
+}
+`;
+			},
 			async prepare() {
 				this.debug("Rendering base built-in modules for the Shell Shock application.");
 				return render(this, [createComponent(UtilsBuiltin, {})]);