@shell-shock/core 0.17.2 → 0.17.3

package/dist/plugin-utils/description-helpers.mjs

@@ -2,9 +2,11 @@
 const __ΩFormatDescriptionOptions = [
 	"replaceNewlines",
 	true,
+	"If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.",
 	"collapseWhitespace",
+	"If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.",
 	"FormatDescriptionOptions",
-	"P)4!8>\")4#8>\"Mw$y"
+	"P)4!8>\"?#)4$8>\"?%Mw&y"
 ];
 /**
 * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
@@ -27,7 +29,8 @@ formatDescriptionWhitespace.__type = [
 	"options",
 	() => ({}),
 	"formatDescriptionWhitespace",
-	"P&2!n\"2#>$&/%"
+	"Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.",
+	"P&2!n\"2#>$&/%?&"
 ];
 /**
 * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
@@ -44,7 +47,8 @@ function formatDescriptionEscapes(description) {
 formatDescriptionEscapes.__type = [
 	"description",
 	"formatDescriptionEscapes",
-	"P&2!&/\""
+	"Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.",
+	"P&2!&/\"?#"
 ];
 /**
 * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
@@ -64,14 +68,16 @@ formatDescription.__type = [
 	"options",
 	() => ({}),
 	"formatDescription",
-	"P&2!n\"2#>$&/%"
+	"Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.",
+	"P&2!n\"2#>$&/%?&"
 ];
 const __ΩFormatShortDescriptionOptions = [
 	() => __ΩFormatDescriptionOptions,
 	"length",
 	62,
+	"The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.",
 	"FormatShortDescriptionOptions",
-	"Pn!'4\"8>#Mw$y"
+	"Pn!'4\"8>#?$Mw%y"
 ];
 /**
 * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
@@ -93,7 +99,8 @@ formatShortDescription.__type = [
 	"options",
 	() => ({}),
 	"formatShortDescription",
-	"P&2!n\"2#>$&/%"
+	"Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.",
+	"P&2!n\"2#>$&/%?&"
 ];
 
 //#endregion

package/dist/plugin-utils/description-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"description-helpers.mjs","names":[],"sources":["../../src/plugin-utils/description-helpers.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\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 62\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 62;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length - 3 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length - 3\n      ? formattedDescription\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACC,IAAE,uBAAa,YAAA,MAAA;AACf,KAAA,QAAA,gBACF,wBAA4B,qBAAA,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAAsB,SAAc;CAAA;OAAiB;CAAgC;QAAqB,EAAE;CAAC;CAAa;CAAA;;;;;;;;;;AAU1H,SAAM,yBAAyB,aAAA;AAC3B,QAAA,YACF,WAAA,KAAA,MAAA,CACI,WAAQ,MAAA,OAAA,CACV,WAAA,KAAqB,MAAE,CACzB,QAAA,SAAA,OAAA;;AAEF,yBAAS,SAAyB;CAAC;CAAC;CAAA;CAAA;;;;;;;;;;AAUpC,SAAgB,kBAAU,aAAkB,UAAA,EAAA,EAAA;AAC1C,QAAA,yBAAA,4BAAA,aAAA,QAAA,CAAA;;AAEF,kBAAS,SAAA;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;AACT,MAAK,mCAAqB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAS1B,SAAI,uBAAA,aAAA,UAAA,EAAA,EAAA;CACD,MAAO,SAAQ,QAAI,UAAc;CACnC,MAAA,uBAAA,4BAAA,aAAA,QAAA;CASG,IAAA,WARwB,qBAAuB,QAAA,KAAA,GAAA,SAAA,KAC/C,qBAAsB,OAAA,eAAkB,GAAA,SAAA,IAC1C,qBACK,MAAS,kBAAiB,GAAA,IACnB,MAAC,EACJ,MAAA,GAAA,GAAA,EACD,MAAA,GACD,WACuB,sBAAoB,MAAA;AACjD,KAAA,OAAA,MAAA,CAAA,SAAA,OACH,UAAA,GAAA,OAAA,UAAA,GAAA,KAAA,IAAA,GAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA;AAEA,QAAO,yBAAU,OAAA;;AAEjB,uBAAuB,SAAQ;CAAA;OAAsB;CAAgC;QAAmB,EAAA;CAAA;CAAS;CAAA"}
+{"version":3,"file":"description-helpers.mjs","names":[],"sources":["../../src/plugin-utils/description-helpers.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\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 62\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 62;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length - 3 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length - 3\n      ? formattedDescription\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACC,IAAE,uBAAa,YAAA,MAAA;AACf,KAAA,QAAA,gBACF,wBAA4B,qBAAA,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAAsB,SAAc;CAAA;OAAiB;CAAgC;QAAqB,EAAE;CAAC;CAAa;CAAA;CAAA;;;;;;;;;;AAU1H,SAAM,yBAAyB,aAAA;AAC3B,QAAA,YACF,WAAA,KAAA,MAAA,CACI,WAAQ,MAAA,OAAA,CACV,WAAA,KAAqB,MAAE,CACzB,QAAA,SAAA,OAAA;;AAEF,yBAAS,SAAyB;CAAC;CAAC;CAAA;CAAA;CAAA;;;;;;;;;;AAUpC,SAAgB,kBAAU,aAAkB,UAAA,EAAA,EAAA;AAC1C,QAAA,yBAAA,4BAAA,aAAA,QAAA,CAAA;;AAEF,kBAAS,SAAA;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;CAAA;AACT,MAAK,mCAAqB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAS1B,SAAI,uBAAA,aAAA,UAAA,EAAA,EAAA;CACD,MAAO,SAAQ,QAAI,UAAc;CACnC,MAAA,uBAAA,4BAAA,aAAA,QAAA;CASG,IAAA,WARwB,qBAAuB,QAAA,KAAA,GAAA,SAAA,KAC/C,qBAAsB,OAAA,eAAkB,GAAA,SAAA,IAC1C,qBACK,MAAS,kBAAiB,GAAA,IACnB,MAAC,EACJ,MAAA,GAAA,GAAA,EACD,MAAA,GACD,WACuB,sBAAoB,MAAA;AACjD,KAAA,OAAA,MAAA,CAAA,SAAA,OACH,UAAA,GAAA,OAAA,UAAA,GAAA,KAAA,IAAA,GAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA;AAEA,QAAO,yBAAU,OAAA;;AAEjB,uBAAuB,SAAQ;CAAA;OAAsB;CAAgC;QAAmB,EAAA;CAAA;CAAS;CAAA;CAAA"}

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

@@ -33,7 +33,8 @@ getCommandTree.__type = [
 	"path",
 	"CommandTree",
 	"getCommandTree",
-	"P\"w!2\"\"2#P\"w$,J/%"
+	"Retrieves a specific command tree based on the provided path.",
+	"P\"w!2\"\"2#P\"w$,J/%?&"
 ];
 /**
 * Retrieves a list of all command trees defined in the context.
@@ -57,10 +58,10 @@ getCommandList.__type = [
 	"context",
 	"CommandTree",
 	"getCommandList",
-	"P\"w!2\"\"w#F`/$"
+	"Retrieves a list of all command trees defined in the context.",
+	"P\"w!2\"\"w#F`/$?%"
 ];
 
 //#endregion
 exports.getCommandList = getCommandList;
-exports.getCommandTree = getCommandTree;
-//# sourceMappingURL=get-command-tree.cjs.map
+exports.getCommandTree = getCommandTree;

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

@@ -33,7 +33,8 @@ getCommandTree.__type = [
 	"path",
 	"CommandTree",
 	"getCommandTree",
-	"P\"w!2\"\"2#P\"w$,J/%"
+	"Retrieves a specific command tree based on the provided path.",
+	"P\"w!2\"\"2#P\"w$,J/%?&"
 ];
 /**
 * Retrieves a list of all command trees defined in the context.
@@ -57,7 +58,8 @@ getCommandList.__type = [
 	"context",
 	"CommandTree",
 	"getCommandList",
-	"P\"w!2\"\"w#F`/$"
+	"Retrieves a list of all command trees defined in the context.",
+	"P\"w!2\"\"w#F`/$?%"
 ];
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\nimport { traverseCommands } from \"./traverse-command-tree\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n\n/**\n * Retrieves a list of all command trees defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command trees in the context.\n */\nexport async function getCommandList(context: Context): Promise<CommandTree[]> {\n  const commandList: CommandTree[] = [];\n  await traverseCommands(context, commandTree => {\n    commandList.push(commandTree);\n  });\n\n  return commandList;\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;AAYV,KAAK,KAAO,WAAW;;AAIxB,KAAO,KAAM,SAAC,GAAW;EAClB,MAAO,WAAU,KACf,MAAA,EAAA,CACA,OAAA,cAAwB,YAAW,CAAC,qBAAa,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAExD,KAAA,aAAA,YACa,OAAQ,UAAS,eAAc,KAAI,YAAa,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAIrB,QAAS;;AAEX,eAAW,SAAa;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOzB,eAAc,eAAA,SAAA;CACV,MAAG,cAAiB,EAAE;AACtB,OAAK,iBAAiB,SAAU,cAAA,gBAAA;AAC5B,cAAC,KAAA,YAAA;IACF;EAAC;EAAa;EAAA;EAAU,CAAA,CAAA;AAC3B,QAAI;;AAER,eAAQ,SAAc;CAAA;CAAY;CAAS;CAAgB;CAAA;CAAA"}
+{"version":3,"file":"get-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\nimport { traverseCommands } from \"./traverse-command-tree\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n\n/**\n * Retrieves a list of all command trees defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command trees in the context.\n */\nexport async function getCommandList(context: Context): Promise<CommandTree[]> {\n  const commandList: CommandTree[] = [];\n  await traverseCommands(context, commandTree => {\n    commandList.push(commandTree);\n  });\n\n  return commandList;\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;AAYV,KAAK,KAAO,WAAW;;AAIxB,KAAO,KAAM,SAAC,GAAW;EAClB,MAAO,WAAU,KACf,MAAA,EAAA,CACA,OAAA,cAAwB,YAAW,CAAC,qBAAa,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAExD,KAAA,aAAA,YACa,OAAQ,UAAS,eAAc,KAAI,YAAa,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAIrB,QAAS;;AAEX,eAAW,SAAa;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOzB,eAAc,eAAA,SAAA;CACV,MAAG,cAAiB,EAAE;AACtB,OAAK,iBAAiB,SAAU,cAAA,gBAAA;AAC5B,cAAC,KAAA,YAAA;IACF;EAAC;EAAa;EAAA;EAAU,CAAA,CAAA;AAC3B,QAAI;;AAER,eAAQ,SAAc;CAAA;CAAY;CAAS;CAAgB;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/reflect.cjs

@@ -44,9 +44,9 @@ sortOptions.__type = [
 	"CommandOption",
 	"options",
 	"sortOptions",
-	"P\"w!F2\"\"w!F/#"
+	"Sort command options alphabetically by name, placing boolean options with negatives appropriately.",
+	"P\"w!F2\"\"w!F/#?$"
 ];
 
 //#endregion
-exports.sortOptions = sortOptions;
-//# sourceMappingURL=reflect.cjs.map
+exports.sortOptions = sortOptions;

package/dist/plugin-utils/reflect.mjs

@@ -44,7 +44,8 @@ sortOptions.__type = [
 	"CommandOption",
 	"options",
 	"sortOptions",
-	"P\"w!F2\"\"w!F/#"
+	"Sort command options alphabetically by name, placing boolean options with negatives appropriately.",
+	"P\"w!F2\"\"w!F/#?$"
 ];
 
 //#endregion

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

@@ -28,7 +28,8 @@ traverseCommandTree.__type = [
 	"",
 	"visitor",
 	"traverseCommandTree",
-	"P\"w!2\"P\"w!2#!/$2%$`/&"
+	"Traverses a command tree and applies a visitor function to each node.",
+	"P\"w!2\"P\"w!2#!/$2%$`/&?'"
 ];
 /**
 * Traverses all commands in the context and applies a visitor function to each command tree.
@@ -54,10 +55,10 @@ traverseCommands.__type = [
 	"",
 	"visitor",
 	"traverseCommands",
-	"P\"2!P\"w\"2#!/$2%$`/&"
+	"Traverses all commands in the context and applies a visitor function to each command tree.",
+	"P\"2!P\"w\"2#!/$2%$`/&?'"
 ];
 
 //#endregion
 exports.traverseCommandTree = traverseCommandTree;
-exports.traverseCommands = traverseCommands;
-//# sourceMappingURL=traverse-command-tree.cjs.map
+exports.traverseCommands = traverseCommands;

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

@@ -27,7 +27,8 @@ traverseCommandTree.__type = [
 	"",
 	"visitor",
 	"traverseCommandTree",
-	"P\"w!2\"P\"w!2#!/$2%$`/&"
+	"Traverses a command tree and applies a visitor function to each node.",
+	"P\"w!2\"P\"w!2#!/$2%$`/&?'"
 ];
 /**
 * Traverses all commands in the context and applies a visitor function to each command tree.
@@ -53,7 +54,8 @@ traverseCommands.__type = [
 	"",
 	"visitor",
 	"traverseCommands",
-	"P\"2!P\"w\"2#!/$2%$`/&"
+	"Traverses all commands in the context and applies a visitor function to each command tree.",
+	"P\"2!P\"w\"2#!/$2%$`/&?'"
 ];
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"traverse-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AAQX,eAAsB,oBAAoB,aAAU,SAAS;AAC5D,KAAA,CAAA,YAAoB,SACb;AAEP,OAAK,QAAQ,IAAA,OAAa,OAAS,YAAA,SAAA,CAAA,IAAA,aAAA,OAAA,cAAA;;AAE5B,QAAM,oBAAoB,WAAW,QAAQ;;;;;;;AAGrD,oBAAc,SAAc;CAAA;CAAe;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnD,eAAoB,iBAAY,SAAY,SAAa;AACvD,KAAA,CAAA,QAAA,SACK;AAEL,OAAQ,QAAQ,IAAA,OAAW,OAAK,QAAA,SAAiB,CAAA,IAAA,aAAA,OAAA,cAAA;AAChD,QAAQ,QAAM,QAAA,QAAA,UAAA,CAAA;AACV,QAAA,oBAAsB,WAAA,QAAA;IACzB;EAAA;EAAM;EAAA;EAAA,CAAA,CAAA,CAAA"}
+{"version":3,"file":"traverse-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AAQX,eAAsB,oBAAoB,aAAU,SAAS;AAC5D,KAAA,CAAA,YAAoB,SACb;AAEP,OAAK,QAAQ,IAAA,OAAa,OAAS,YAAA,SAAA,CAAA,IAAA,aAAA,OAAA,cAAA;;AAE5B,QAAM,oBAAoB,WAAW,QAAQ;;;;;;;AAGrD,oBAAc,SAAc;CAAA;CAAe;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnD,eAAoB,iBAAY,SAAY,SAAa;AACvD,KAAA,CAAA,QAAA,SACK;AAEL,OAAQ,QAAQ,IAAA,OAAW,OAAK,QAAA,SAAiB,CAAA,IAAA,aAAA,OAAA,cAAA;AAChD,QAAQ,QAAM,QAAA,QAAA,UAAA,CAAA;AACV,QAAA,oBAAsB,WAAA,QAAA;IACzB;EAAA;EAAM;EAAA;EAAA,CAAA,CAAA,CAAA"}

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

@@ -21,7 +21,8 @@ function isCommandParameterKind(obj) {
 isCommandParameterKind.__type = [
 	"obj",
 	"isCommandParameterKind",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandParameterKind} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandParameterConfig} type.
@@ -35,7 +36,8 @@ function isCommandParameterConfig(obj) {
 isCommandParameterConfig.__type = [
 	"obj",
 	"isCommandParameterConfig",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandParameterConfig} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandParameter} type.
@@ -49,7 +51,8 @@ function isCommandParameter(obj) {
 isCommandParameter.__type = [
 	"obj",
 	"isCommandParameter",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandParameter} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandOption} type.
@@ -63,7 +66,8 @@ function isCommandOption(obj) {
 isCommandOption.__type = [
 	"obj",
 	"isCommandOption",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandOption} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandArgument} type.
@@ -77,7 +81,8 @@ function isCommandArgument(obj) {
 isCommandArgument.__type = [
 	"obj",
 	"isCommandArgument",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandArgument} type.",
+	"P\"2!!/\"?#"
 ];
 
 //#endregion
@@ -85,5 +90,4 @@ exports.isCommandArgument = isCommandArgument;
 exports.isCommandOption = isCommandOption;
 exports.isCommandParameter = isCommandParameter;
 exports.isCommandParameterConfig = isCommandParameterConfig;
-exports.isCommandParameterKind = isCommandParameterKind;
-//# sourceMappingURL=type-checks.cjs.map
+exports.isCommandParameterKind = isCommandParameterKind;

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

@@ -20,7 +20,8 @@ function isCommandParameterKind(obj) {
 isCommandParameterKind.__type = [
 	"obj",
 	"isCommandParameterKind",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandParameterKind} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandParameterConfig} type.
@@ -34,7 +35,8 @@ function isCommandParameterConfig(obj) {
 isCommandParameterConfig.__type = [
 	"obj",
 	"isCommandParameterConfig",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandParameterConfig} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandParameter} type.
@@ -48,7 +50,8 @@ function isCommandParameter(obj) {
 isCommandParameter.__type = [
 	"obj",
 	"isCommandParameter",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandParameter} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandOption} type.
@@ -62,7 +65,8 @@ function isCommandOption(obj) {
 isCommandOption.__type = [
 	"obj",
 	"isCommandOption",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandOption} type.",
+	"P\"2!!/\"?#"
 ];
 /**
 * Type guard to check if a value is a valid {@link CommandArgument} type.
@@ -76,7 +80,8 @@ function isCommandArgument(obj) {
 isCommandArgument.__type = [
 	"obj",
 	"isCommandArgument",
-	"P\"2!!/\""
+	"Type guard to check if a value is a valid {@link CommandArgument} type.",
+	"P\"2!!/\"?#"
 ];
 
 //#endregion

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;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"}
+{"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;CAAA;;;;;;;AAOF,SAAM,yBAAsB,KAAA;AACxB,QAAE,YAAgB,IAAA,IAAA,UAAA,OAAoB,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;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;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAC,yBAAgC,IAAI,IAAA,mBAAQ,IAAA,IAAA,aAAA;;AAEjD,gBAAc,SAAI;CAAQ;CAAG;CAAA;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAiB,SAAO;CAAA;CAAW;CAAa;CAAoC;CAAA"}

package/dist/plugin.cjs

@@ -146,6 +146,7 @@ const plugin = (options = {}) => {
 							alias: [],
 							tags: [],
 							isVirtual: false,
+							source: "file",
 							entry: {
 								...entry,
 								file: entry.file,
@@ -177,7 +178,6 @@ 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("Finding and adding virtual command inputs for each command previously found.");
 						this.inputs = this.inputs.reduce((ret, command) => {
 							let depth = 0;
@@ -203,7 +203,8 @@ const plugin = (options = {}) => {
 											alias: [],
 											tags: [],
 											isVirtual: true,
-											entry: { file }
+											entry: { file },
+											source: "file"
 										});
 									}
 								}
@@ -211,7 +212,7 @@ const plugin = (options = {}) => {
 							}
 							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_is_parent_path.isParentPath)(command.entry.file, this.commandsPath) ? (0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath) : (0, _stryke_path_replace.replacePath)(command.entry.file, this.config.root)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.debug(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}${command.isVirtual ? " (virtual)" : ""}: ${command.source === "file" ? (0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath) : `added by ${command.source}`}`).join("\n")}`);
 					}
 				}
 			}
@@ -307,5 +308,4 @@ const plugin = (options = {}) => {
 
 //#endregion
 exports.default = plugin;
-exports.plugin = plugin;
-//# sourceMappingURL=plugin.cjs.map
+exports.plugin = plugin;

package/dist/plugin.mjs

@@ -21,7 +21,7 @@ import tsdown from "@powerlines/plugin-tsdown";
 import { toArray } from "@stryke/convert/to-array";
 import { chmodX } from "@stryke/fs/chmod-x";
 import { appendPath } from "@stryke/path/append";
-import { findFilePath, relativePath } from "@stryke/path/file-path-fns";
+import { findFilePath } from "@stryke/path/file-path-fns";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { joinPaths } from "@stryke/path/join-paths";
 import { replacePath } from "@stryke/path/replace";
@@ -141,6 +141,7 @@ const plugin = (options = {}) => {
 							alias: [],
 							tags: [],
 							isVirtual: false,
+							source: "file",
 							entry: {
 								...entry,
 								file: entry.file,
@@ -172,7 +173,6 @@ 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}: ${isParentPath(command.entry.file, this.commandsPath) ? replacePath(command.entry.file, this.commandsPath) : 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;
@@ -198,7 +198,8 @@ const plugin = (options = {}) => {
 											alias: [],
 											tags: [],
 											isVirtual: true,
-											entry: { file }
+											entry: { file },
+											source: "file"
 										});
 									}
 								}
@@ -206,7 +207,7 @@ const plugin = (options = {}) => {
 							}
 							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}: ${isParentPath(command.entry.file, this.commandsPath) ? replacePath(command.entry.file, this.commandsPath) : replacePath(command.entry.file, this.config.root)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.debug(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}${command.isVirtual ? " (virtual)" : ""}: ${command.source === "file" ? replacePath(command.entry.file, this.commandsPath) : `added by ${command.source}`}`).join("\n")}`);
 					}
 				}
 			}

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","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 nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { 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 { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { ExecBuiltin } from \"./components/exec-builtin\";\nimport { StateBuiltin } from \"./components/state-builtin\";\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 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): Plugin<TContext>[] => {\n  return [\n    tsdown<TContext>(),\n    automd<TContext>(),\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            framework: \"shell-shock\",\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              skipNodeModulesBundle: true\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          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 if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\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.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          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      }\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.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\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              tags: [],\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            <StateBuiltin />\n            <UtilsBuiltin />\n            <ExecBuiltin />\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 ${\n                          command.name\n                        } \\n\\nPlease ensure ${\n                          command.entry.file\n                        } 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                          tags: [],\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}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : replacePath(command.entry.file, this.config.root)\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            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  ];\n};\n\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","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 nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath } 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 { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { ExecBuiltin } from \"./components/exec-builtin\";\nimport { StateBuiltin } from \"./components/state-builtin\";\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 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): Plugin<TContext>[] => {\n  return [\n    tsdown<TContext>(),\n    automd<TContext>(),\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            framework: \"shell-shock\",\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              skipNodeModulesBundle: true\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          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 if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\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.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          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      }\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.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\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              tags: [],\n              isVirtual: false,\n              source: \"file\",\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            <StateBuiltin />\n            <UtilsBuiltin />\n            <ExecBuiltin />\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              \"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 ${\n                          command.name\n                        } \\n\\nPlease ensure ${\n                          command.entry.file\n                        } 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                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          },\n                          source: \"file\"\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}${command.isVirtual ? \" (virtual)\" : \"\"}: ${\n                      command.source === \"file\"\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : `added by ${command.source}`\n                    }`\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            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  ];\n};\n\nexport default plugin;\n"],"mappings":"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"}