@shell-shock/core 0.12.2 → 0.13.1

package/dist/plugin-utils/type-checks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-checks.cjs","names":[],"sources":["../../src/plugin-utils/type-checks.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 { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACrB,4DAAoB,IAAI;EAE1B,4CAAA;EACU,4CAAsB;EACjC,4CAAA;EACQ,CAAC,SAAS,IAAI;;AAEvB,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAgB,yBAAkB,KAAA;AAC9B,4DAAmB,IAAI,IAAI,UAAU,OAAC,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAE,mBAAA,KAAA;AACE,QAAQ,yBAAyB,IAAG,IAChC,UAAC,2DACW,IAAI,KAAK,IACrB,WAAW,2DACnB,IAAA,MAAA,gFAEE,IAAA,YAAA,IACM,WAAW,OAClB,MAAA,QAAA,IAAA,MAAA,IACO,SAAS,4DACI,IAAI,IAAI,IAAI,IAAI,QAAQ,UAC3C,cAAA,sDACgB,IAAI,SAAS,IACvB,cAAC,sDACS,IAAI,SAAS;;AAE/B,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAQ,yBAAyB,IAAI,IAAI,mBAAI,IAAA,IAAA,aAAA;;AAEjD,gBAAgB,SAAS;CAAC;CAAG;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAkB,SAAS;CAAC;CAAO;CAAqB;CAAU"}
+{"version":3,"file":"type-checks.cjs","names":[],"sources":["../../src/plugin-utils/type-checks.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 { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACzB,2DAAS,IAAA;EAEP,4CAAA;EACM,4CAA0B;EACjC,4CAAA;EACQ,CAAC,SAAS,IAAC;;AAEpB,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAM,yBAAsB,KAAA;AACxB,2DAAkB,IAAA,IAAA,UAAA,OAAoB,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAE,mBAAA,KAAA;AACF,QAAO,yBAAS,IAAwB,IACjC,UAAA,0DACG,IAAA,KAAA,IACF,WAAC,0DACT,IAAA,MAAA,+EAEE,IAAA,YAAA,IACM,WAAS,OAChB,MAAA,QAAA,IAAA,MAAA,IACG,SAAY,2DACI,IAAI,IAAK,IAAI,IAAE,QAAQ,UACzC,cAAA,qDACc,IAAA,SAAA,IACR,cAAC,qDACL,IAAA,SAAyB;;AAE7B,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAC,yBAAgC,IAAI,IAAA,mBAAQ,IAAA,IAAA,aAAA;;AAEjD,gBAAc,SAAI;CAAQ;CAAG;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAiB,SAAO;CAAA;CAAW;CAAa;CAAe"}

package/dist/plugin-utils/type-checks.d.cts

@@ -1,7 +1,6 @@
 import { CommandArgument, CommandOption, CommandParameter, CommandParameterConfig, CommandParameterKind } from "../types/command.cjs";
 
 //#region src/plugin-utils/type-checks.d.ts
-
 /**
  * Type guard to check if a value is a valid {@link CommandParameterKind} type.
  *

package/dist/plugin-utils/type-checks.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"type-checks.d.cts","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"sourcesContent":[],"mappings":";;;;;;AAoCA;AAiBA;AAYA;AA0BA;AAYgB,iBAnEA,sBAAA,CAmEoC,GAAA,EAAA,GAAe,CAAA,EAAA,GAAA,IAnEV,oBAmEU;;;;;;;iBAlDnD,wBAAA,mBAEN;;;;;;;iBAUM,kBAAA,mBAAqC;;;;;;;iBA0BrC,eAAA,mBAAkC;;;;;;;iBAYlC,iBAAA,mBAAoC"}
+{"version":3,"file":"type-checks.d.cts","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"mappings":";;;;;AAoCA;;;;iBAAgB,sBAAA,CAAuB,GAAA,QAAW,GAAA,IAAO,oBAAA;;;;;AAiBzD;;iBAAgB,wBAAA,CACd,GAAA,QACC,GAAA,IAAO,sBAAA;;;;;;;iBAUM,kBAAA,CAAmB,GAAA,QAAW,GAAA,IAAO,gBAAA;;;;;;;iBA0BrC,eAAA,CAAgB,GAAA,QAAW,GAAA,IAAO,aAAA;;AAAlD;;;;;iBAYgB,iBAAA,CAAkB,GAAA,QAAW,GAAA,IAAO,eAAA"}

package/dist/plugin-utils/type-checks.d.mts

@@ -1,7 +1,6 @@
 import { CommandArgument, CommandOption, CommandParameter, CommandParameterConfig, CommandParameterKind } from "../types/command.mjs";
 
 //#region src/plugin-utils/type-checks.d.ts
-
 /**
  * Type guard to check if a value is a valid {@link CommandParameterKind} type.
  *

package/dist/plugin-utils/type-checks.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"type-checks.d.mts","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"sourcesContent":[],"mappings":";;;;;;AAoCA;AAiBA;AAYA;AA0BA;AAYgB,iBAnEA,sBAAA,CAmEoC,GAAA,EAAA,GAAe,CAAA,EAAA,GAAA,IAnEV,oBAmEU;;;;;;;iBAlDnD,wBAAA,mBAEN;;;;;;;iBAUM,kBAAA,mBAAqC;;;;;;;iBA0BrC,eAAA,mBAAkC;;;;;;;iBAYlC,iBAAA,mBAAoC"}
+{"version":3,"file":"type-checks.d.mts","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"mappings":";;;;;AAoCA;;;;iBAAgB,sBAAA,CAAuB,GAAA,QAAW,GAAA,IAAO,oBAAA;;;;;AAiBzD;;iBAAgB,wBAAA,CACd,GAAA,QACC,GAAA,IAAO,sBAAA;;;;;;;iBAUM,kBAAA,CAAmB,GAAA,QAAW,GAAA,IAAO,gBAAA;;;;;;;iBA0BrC,eAAA,CAAgB,GAAA,QAAW,GAAA,IAAO,aAAA;;AAAlD;;;;;iBAYgB,iBAAA,CAAkB,GAAA,QAAW,GAAA,IAAO,eAAA"}

package/dist/plugin-utils/type-checks.mjs

@@ -1,6 +1,6 @@
 import { CommandParameterKinds } from "../types/command.mjs";
-import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isBoolean } from "@stryke/type-checks/is-boolean";
 
 //#region src/plugin-utils/type-checks.ts

package/dist/plugin-utils/type-checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-checks.mjs","names":[],"sources":["../../src/plugin-utils/type-checks.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 { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACrB,QAAQ,YAAY,IAAI;EAE1B,sBAAA;EACU,sBAAsB;EACjC,sBAAA;EACQ,CAAC,SAAS,IAAI;;AAEvB,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAgB,yBAAkB,KAAA;AAC9B,QAAO,YAAY,IAAI,IAAI,UAAU,OAAC,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAE,mBAAA,KAAA;AACE,QAAQ,yBAAyB,IAAG,IAChC,UAAC,OACD,YAAY,IAAI,KAAK,IACrB,WAAW,OACnB,YAAA,IAAA,MAAA,4BAEE,YAAA,IAAA,YAAA,IACM,WAAW,OAClB,MAAA,QAAA,IAAA,MAAA,IACO,SAAS,QACR,YAAY,IAAI,IAAI,IAAI,IAAI,QAAQ,UAC3C,cAAA,OACM,UAAU,IAAI,SAAS,IACvB,cAAC,OACD,UAAU,IAAI,SAAS;;AAE/B,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAQ,yBAAyB,IAAI,IAAI,mBAAI,IAAA,IAAA,aAAA;;AAEjD,gBAAgB,SAAS;CAAC;CAAG;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAkB,SAAS;CAAC;CAAO;CAAqB;CAAU"}
+{"version":3,"file":"type-checks.mjs","names":[],"sources":["../../src/plugin-utils/type-checks.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 { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACzB,QAAS,YAAA,IAAA;EAEP,sBAAA;EACM,sBAA0B;EACjC,sBAAA;EACQ,CAAC,SAAS,IAAC;;AAEpB,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAM,yBAAsB,KAAA;AACxB,QAAE,YAAgB,IAAA,IAAA,UAAA,OAAoB,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAE,mBAAA,KAAA;AACF,QAAO,yBAAS,IAAwB,IACjC,UAAA,OACA,YAAG,IAAA,KAAA,IACF,WAAC,OACT,YAAA,IAAA,MAAA,4BAEE,YAAA,IAAA,YAAA,IACM,WAAS,OAChB,MAAA,QAAA,IAAA,MAAA,IACG,SAAY,QACZ,YAAgB,IAAI,IAAK,IAAI,IAAE,QAAQ,UACzC,cAAA,OACK,UAAS,IAAA,SAAA,IACR,cAAC,OACL,UAAA,IAAA,SAAyB;;AAE7B,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAC,yBAAgC,IAAI,IAAA,mBAAQ,IAAA,IAAA,aAAA;;AAEjD,gBAAc,SAAI;CAAQ;CAAG;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAiB,SAAO;CAAA;CAAW;CAAa;CAAe"}

package/dist/plugin.cjs

@@ -1,5 +1,5 @@
-Object.defineProperty(exports, '__esModule', { value: true });
-const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+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_components_docs = require('./components/docs.cjs');
 const require_components_utils_builtin = require('./components/utils-builtin.cjs');
@@ -12,29 +12,28 @@ const require_update_package_json = require('./helpers/update-package-json.cjs')
 const require_utilities = require('./helpers/utilities.cjs');
 const require_validations = require('./helpers/validations.cjs');
 const require_resolve = require('./resolver/resolve.cjs');
-let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let __alloy_js_core_components = require("@alloy-js/core/components");
-let __powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
-let __powerlines_plugin_automd = require("@powerlines/plugin-automd");
-__powerlines_plugin_automd = require_rolldown_runtime.__toESM(__powerlines_plugin_automd);
-let __powerlines_plugin_deepkit = require("@powerlines/plugin-deepkit");
-__powerlines_plugin_deepkit = require_rolldown_runtime.__toESM(__powerlines_plugin_deepkit);
-let __powerlines_plugin_nodejs = require("@powerlines/plugin-nodejs");
-__powerlines_plugin_nodejs = require_rolldown_runtime.__toESM(__powerlines_plugin_nodejs);
-let __stryke_convert_to_array = require("@stryke/convert/to-array");
-let __stryke_fs_chmod_x = require("@stryke/fs/chmod-x");
-let __stryke_path_append = require("@stryke/path/append");
-let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
-let __stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
-let __stryke_path_join_paths = require("@stryke/path/join-paths");
-let __stryke_path_replace = require("@stryke/path/replace");
-let __stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
-let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
-let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
-let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
-let __stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
-let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
-let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core_components = require("@alloy-js/core/components");
+let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let _powerlines_plugin_automd = require("@powerlines/plugin-automd");
+_powerlines_plugin_automd = require_runtime.__toESM(_powerlines_plugin_automd);
+let _powerlines_plugin_deepkit = require("@powerlines/plugin-deepkit");
+_powerlines_plugin_deepkit = require_runtime.__toESM(_powerlines_plugin_deepkit);
+let _powerlines_plugin_nodejs = require("@powerlines/plugin-nodejs");
+_powerlines_plugin_nodejs = require_runtime.__toESM(_powerlines_plugin_nodejs);
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
+let _stryke_fs_chmod_x = require("@stryke/fs/chmod-x");
+let _stryke_path_append = require("@stryke/path/append");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let _stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let defu = require("defu");
 let powerlines_tsdown = require("powerlines/tsdown");
 let powerlines_utils = require("powerlines/utils");
@@ -47,14 +46,14 @@ const MAX_DEPTH = 50;
 const plugin = (options = {}) => {
 	return [
 		(0, powerlines_tsdown.tsdown)(),
-		(0, __powerlines_plugin_deepkit.default)(),
-		(0, __powerlines_plugin_automd.default)(),
+		(0, _powerlines_plugin_deepkit.default)(),
+		(0, _powerlines_plugin_automd.default)(),
 		{
 			name: "shell-shock:config",
 			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: { buildPath: (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),
@@ -63,12 +62,12 @@ const plugin = (options = {}) => {
 					isCaseSensitive: false,
 					output: {
 						format: "esm",
-						dts: true
+						dts: false
 					},
-					input: !this.config.input || Array.isArray(this.config.input) && this.config.input.length === 0 || (0, __stryke_type_checks_is_object.isObject)(this.config.input) && Object.keys(this.config.input).length === 0 ? [(0, __stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.ts"), (0, __stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.tsx")] : void 0,
+					input: !this.config.input || Array.isArray(this.config.input) && this.config.input.length === 0 || (0, _stryke_type_checks_is_object.isObject)(this.config.input) && Object.keys(this.config.input).length === 0 ? [(0, _stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.ts"), (0, _stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.tsx")] : void 0,
 					resolve: { external: ["@powerlines/deepkit"] },
 					tsdown: {
-						dts: true,
+						dts: false,
 						nodeProtocol: true,
 						unbundle: false
 					}
@@ -78,10 +77,10 @@ const plugin = (options = {}) => {
 				order: "pre",
 				async handler() {
 					this.debug("Shell Shock configuration has been resolved.");
-					this.config.appSpecificEnvPrefix = (0, __stryke_type_checks_is_set_string.isSetString)(this.config.autoAssignEnv) ? this.config.autoAssignEnv : (0, __stryke_string_format_constant_case.constantCase)(require_context_helpers.getAppName(this));
-					if (!this.config.env.prefix || !Array.isArray(this.config.env.prefix)) this.config.env.prefix = (0, __stryke_convert_to_array.toArray)(this.config.env.prefix);
+					this.config.appSpecificEnvPrefix = (0, _stryke_type_checks_is_set_string.isSetString)(this.config.autoAssignEnv) ? this.config.autoAssignEnv : (0, _stryke_string_format_constant_case.constantCase)(require_context_helpers.getAppName(this));
+					if (!this.config.env.prefix || !Array.isArray(this.config.env.prefix)) this.config.env.prefix = (0, _stryke_convert_to_array.toArray)(this.config.env.prefix);
 					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.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, {
 						id: null,
@@ -96,7 +95,7 @@ const plugin = (options = {}) => {
 				}
 			}
 		},
-		...(0, __powerlines_plugin_nodejs.default)((0, defu.defu)(options ?? {}, { env: {
+		...(0, _powerlines_plugin_nodejs.default)((0, defu.defu)(options ?? {}, { env: {
 			types: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} })),
@@ -108,14 +107,14 @@ const plugin = (options = {}) => {
 				const inputs = await (0, powerlines_utils.resolveInputs)(this, this.config.input);
 				this.debug(`Found ${inputs.length} entry points specified in the configuration options.`);
 				this.inputs = inputs.reduce((ret, entry) => {
-					if (entry.file !== this.commandsPath && !(0, __stryke_path_is_parent_path.isParentPath)(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					if (entry.file !== this.commandsPath && !(0, _stryke_path_is_parent_path.isParentPath)(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
 					const id = require_paths.resolveCommandId(this, entry.file);
 					if (!ret.some((existing) => existing.id === id)) {
 						const name = require_paths.resolveCommandName(entry.file);
 						let segments = require_paths.resolveCommandPath(this, entry.file).split("/").filter(Boolean);
 						segments = segments.map((segment, index) => {
 							const found = segments.findIndex((existing) => existing === segment);
-							if (found !== -1 && found !== index) segment += `_${segments.filter((segment$1) => require_context_helpers.isDynamicPathSegment(segment$1) && require_context_helpers.getDynamicPathSegmentName(segment$1).replace(/_\d+$/, "") === segment$1).length}`;
+							if (found !== -1 && found !== index) segment += `_${segments.filter((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === segment).length}`;
 							return segment;
 						});
 						ret.push({
@@ -138,11 +137,11 @@ const plugin = (options = {}) => {
 					}
 					return ret;
 				}, 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")}`);
+				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")}`);
 			},
 			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, {})]);
+				return (0, _powerlines_plugin_alloy_render.render)(this, [(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_utils_builtin.UtilsBuiltin, {})]);
 			}
 		},
 		{
@@ -152,22 +151,22 @@ const plugin = (options = {}) => {
 				async handler() {
 					if (this.inputs.length === 0) this.warn("No commands were found in the project. Please ensure at least one command exists.");
 					else {
-						this.debug(`Shell Shock will create an application with the following commands: \n${this.inputs.filter((cmd) => !cmd.isVirtual).map((command) => ` - ${command.id}: ${(0, __stryke_path_is_parent_path.isParentPath)(command.entry.file, this.commandsPath) ? (0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath) : (0, __stryke_path_file_path_fns.relativePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.debug(`Shell Shock will create an application with the following commands: \n${this.inputs.filter((cmd) => !cmd.isVirtual).map((command) => ` - ${command.id}: ${(0, _stryke_path_is_parent_path.isParentPath)(command.entry.file, this.commandsPath) ? (0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath) : (0, _stryke_path_file_path_fns.relativePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
 						this.debug("Finding and adding virtual command inputs for each command previously found.");
 						this.inputs = this.inputs.reduce((ret, command) => {
 							let depth = 0;
-							let parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)((0, __stryke_path_file_path_fns.findFilePath)(command.entry.file));
-							if ((0, __stryke_path_is_parent_path.isParentPath)(parentPath, this.commandsPath)) while (parentPath !== this.commandsPath) {
+							let parentPath = (0, _stryke_path_resolve_parent_path.resolveParentPath)((0, _stryke_path_file_path_fns.findFilePath)(command.entry.file));
+							if ((0, _stryke_path_is_parent_path.isParentPath)(parentPath, this.commandsPath)) while (parentPath !== this.commandsPath) {
 								if (depth++ > MAX_DEPTH) throw new Error(`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.`);
-								if (!ret.some((existing) => (0, __stryke_path_file_path_fns.findFilePath)(existing.entry.file) === parentPath)) {
-									const file = (0, __stryke_path_join_paths.joinPaths)(parentPath, "command.ts");
+								if (!ret.some((existing) => (0, _stryke_path_file_path_fns.findFilePath)(existing.entry.file) === parentPath)) {
+									const file = (0, _stryke_path_join_paths.joinPaths)(parentPath, "command.ts");
 									const id = require_paths.resolveCommandId(this, file);
 									if (!ret.some((existing) => existing.id === id)) {
 										const name = require_paths.resolveCommandName(file);
 										let segments = require_paths.resolveCommandPath(this, file).split("/").filter(Boolean);
 										segments = segments.map((segment, index) => {
 											const found = segments.findIndex((existing) => existing === segment);
-											if (found !== -1 && found !== index) segment += `_${segments.filter((segment$1) => require_context_helpers.isDynamicPathSegment(segment$1) && require_context_helpers.getDynamicPathSegmentName(segment$1).replace(/_\d+$/, "") === segment$1).length}`;
+											if (found !== -1 && found !== index) segment += `_${segments.filter((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === segment).length}`;
 											return segment;
 										});
 										ret.push({
@@ -181,11 +180,11 @@ const plugin = (options = {}) => {
 										});
 									}
 								}
-								parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)(parentPath);
+								parentPath = (0, _stryke_path_resolve_parent_path.resolveParentPath)(parentPath);
 							}
 							return ret;
 						}, this.inputs).sort((a, b) => a.segments.length - b.segments.length);
-						this.debug(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.debug(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
 					}
 				}
 			}
@@ -201,21 +200,21 @@ const plugin = (options = {}) => {
 						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
 						await require_persistence.readCommandsPersistence(this);
 					} else {
-						for (const input of this.inputs.filter((input$1) => input$1.segments.filter((segment) => !require_context_helpers.isDynamicPathSegment(segment) && !require_context_helpers.isPathSegmentGroup(segment)).length === 1)) this.commands[input.name] = await require_resolve.resolve({
+						for (const input of this.inputs.filter((input) => input.segments.filter((segment) => !require_context_helpers.isDynamicPathSegment(segment) && !require_context_helpers.isPathSegmentGroup(segment)).length === 1)) this.commands[input.name] = await require_resolve.resolve({
 							context: this,
 							command: input
 						});
 						this.debug("Post-processing commands to ensure proper reflection.");
 						this.options = this.options.map((option) => ({
 							...option,
-							name: (0, __stryke_string_format_camel_case.camelCase)(option.name),
+							name: (0, _stryke_string_format_camel_case.camelCase)(option.name),
 							alias: option.alias ?? [],
 							optional: option.optional ?? false
 						}));
 						await require_traverse_command_tree.traverseCommands(this, (command) => {
-							command.options = Object.fromEntries(Object.entries(command.options).map(([name, option]) => [(0, __stryke_string_format_camel_case.camelCase)(name), {
+							command.options = Object.fromEntries(Object.entries(command.options).map(([name, option]) => [(0, _stryke_string_format_camel_case.camelCase)(name), {
 								...option,
-								name: (0, __stryke_string_format_camel_case.camelCase)(name),
+								name: (0, _stryke_string_format_camel_case.camelCase)(name),
 								alias: option.alias ?? [],
 								optional: option.optional ?? false
 							}]));
@@ -239,24 +238,19 @@ const plugin = (options = {}) => {
 		{
 			name: "shell-shock:chmod+x",
 			configResolved() {
-				this.config.tsdown.outputOptions ??= {};
-				if ((0, __stryke_type_checks_is_object.isObject)(this.config.tsdown.outputOptions)) this.config.tsdown.outputOptions.banner = (chunk) => {
-					if (chunk.isEntry && (0, __stryke_path_join_paths.joinPaths)(this.entryPath, "bin.ts") === chunk.facadeModuleId) {
-						this.debug(`Adding hashbang to binary executable output file: ${chunk.fileName}`);
-						return `#!/usr/bin/env ${this.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node\n`;
-					}
-					return "";
+				this.config.tsdown.hooks ??= {};
+				this.config.tsdown.hooks["build:done"] = async (_) => {
+					await Promise.all(Object.values(this.config.bin).map(async (bin) => {
+						const path = (0, _stryke_path_append.appendPath)(bin, (0, _stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.root));
+						if (this.fs.existsSync(path)) {
+							this.debug(`Adding hashbang to binary executable output file: ${path}`);
+							const content = await this.fs.read(path);
+							if (content && !content.startsWith("#!")) await this.fs.write(path, `#!/usr/bin/env ${this.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node\n\n${content}`);
+							this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${path}`);
+							await (0, _stryke_fs_chmod_x.chmodX)(path);
+						} else this.warn(`Expected binary output file not found at path: ${path}. Skipping adding hashbang and executable permissions (chmod+x).`);
+					}));
 				};
-			},
-			async buildEnd() {
-				if (!(0, __stryke_type_checks_is_set_object.isSetObject)(this.config.bin)) this.warn(`No binaries were found for the ${this.config.name} application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`);
-				else await Promise.all(Object.values(this.config.bin).map(async (bin) => {
-					const path = (0, __stryke_path_append.appendPath)(bin, (0, __stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.root));
-					if (this.fs.existsSync(path)) {
-						this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${path}`);
-						await (0, __stryke_fs_chmod_x.chmodX)(path);
-					} else this.warn(`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.`);
-				}));
 			}
 		},
 		{
@@ -270,18 +264,18 @@ const plugin = (options = {}) => {
 			},
 			async docs() {
 				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
-				const commands$1 = this.inputs.map((input) => require_get_command_tree.getCommandTree(this, input.segments)).filter(Boolean);
-				return (0, __powerlines_plugin_alloy_render.render)(this, (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core_components.For, {
+				const commands = this.inputs.map((input) => require_get_command_tree.getCommandTree(this, input.segments)).filter(Boolean);
+				return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.For, {
 					get each() {
-						return Object.values(commands$1);
+						return Object.values(commands);
 					},
 					doubleHardline: true,
-					children: (child) => (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core_components.Show, {
+					children: (child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.Show, {
 						get when() {
 							return !child.isVirtual;
 						},
 						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsFile, { command: child });
+							return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsFile, { command: child });
 						}
 					})
 				}));
@@ -289,10 +283,9 @@ const plugin = (options = {}) => {
 		}
 	];
 };
-var plugin_default = plugin;
 
 //#endregion
-exports.default = plugin_default;
+exports.default = plugin;
 exports.plugin = plugin;
 exports.shellShock = plugin;
 //# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["For","Show","render","automd","deepkit","nodejs","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isObject","isSetObject","isSetString","defu","tsdown","resolveInputs","CommandDocsFile","UtilsBuiltin","commands","findCommandsRoot","resolveCommandId","resolveCommandName","resolveCommandPath","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","resolve","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","root","title","description","platform","projectType","isCaseSensitive","format","dts","input","Array","isArray","length","Object","keys","undefined","external","nodeProtocol","unbundle","configResolved","order","handler","appSpecificEnvPrefix","autoAssignEnv","env","prefix","includes","push","bin","packageJson","inputs","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","reduce","ret","entry","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","context","option","optional","fromEntries","entries","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 { 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 { 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 { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\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: true\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: true,\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.outputOptions ??= {} as any;\n        if (isObject(this.config.tsdown.outputOptions)) {\n          (\n            this.config.tsdown.outputOptions as NonNullable<OutputOptions>\n          ).banner = (chunk: RenderedChunk) => {\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: ${\n                  chunk.fileName\n                }`\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      },\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(this.workspaceConfig.workspaceRoot, this.config.root)\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":[],"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":"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"}

package/dist/plugin.d.cts

@@ -3,7 +3,6 @@ import { Options } from "./types/config.cjs";
 import { Plugin } from "powerlines";
 
 //#region src/plugin.d.ts
-
 /**
  * The core Powerlines plugin to build Shell Shock projects.
  */

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAkFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAkgBjC,MAlgBiC,CAkgB1B,QAlgB0B,CAAA,EAAA"}
+{"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"}

package/dist/plugin.d.mts

@@ -3,7 +3,6 @@ import { Options } from "./types/config.mjs";
 import { Plugin } from "powerlines";
 
 //#region src/plugin.d.ts
-
 /**
  * The core Powerlines plugin to build Shell Shock projects.
  */

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAkFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAkgBjC,MAlgBiC,CAkgB1B,QAlgB0B,CAAA,EAAA"}
+{"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"}