@shell-shock/core 0.8.3 → 0.8.4

package/dist/helpers/resolve-command.mjs

@@ -1,4 +1,4 @@
-import { getAppTitle, isDynamicPathSegment, isPathSegmentGroup } from "../plugin-utils/context-helpers.mjs";
+import { getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, isPathSegmentGroup } from "../plugin-utils/context-helpers.mjs";
 import { getDefaultOptions } from "./utilities.mjs";
 import { toArray } from "@stryke/convert/to-array";
 import { appendPath } from "@stryke/path/append";
@@ -19,28 +19,30 @@ import { resolveModule } from "powerlines/lib/utilities/resolve";
 /**
 * Resolves the description for a command option based on its reflection.
 *
+* @param name - The name of the command option.
 * @param kind - The reflection kind of the command option.
 * @param optional - Whether the command option is optional.
-* @param name - The name of the command option.
+* @param variadic - Whether the command option is variadic (i.e., an array).
 * @param title - The title of the command option, if any.
 * @param defaultValue - The default value of the command option, if any.
 * @returns The resolved description for the command option.
 */
-function resolveCommandOptionDescription(kind, optional, name, title, defaultValue) {
-	return `A${optional && !defaultValue ? "n optional" : ""} ${kind === ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${kind === ReflectionKind.boolean ? "set the" : kind === ReflectionKind.array ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === ReflectionKind.boolean ? "indicator" : `${kind === ReflectionKind.number ? "numeric" : "string"} value${kind === ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
+function resolveCommandOptionDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
+	return `A${optional && !defaultValue ? "n optional" : ""} command line ${kind === ReflectionKind.boolean ? "flag" : "option"} that allows the user to ${kind === ReflectionKind.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === ReflectionKind.boolean ? "indicator" : `${kind === ReflectionKind.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 /**
-* Resolves the description for a command parameter based on its reflection.
+* Resolves the description for a command argument based on its reflection.
 *
-* @param kind - The reflection kind of the command parameter.
-* @param optional - Whether the command parameter is optional.
-* @param name - The name of the command parameter.
-* @param title - The title of the command parameter, if any.
-* @param defaultValue - The default value of the command parameter, if any.
-* @returns The resolved description for the command parameter.
+* @param name - The name of the command argument.
+* @param kind - The reflection kind of the command argument.
+* @param optional - Whether the command argument is optional.
+* @param variadic - Whether the command argument is variadic (i.e., an array).
+* @param title - The title of the command argument, if any.
+* @param defaultValue - The default value of the command argument, if any.
+* @returns The resolved description for the command argument.
 */
-function resolveCommandParameterDescription(kind, optional, name, title, defaultValue) {
-	return `A${optional && !defaultValue ? "n optional" : ""} command-line positional parameter that allows the user to ${kind === ReflectionKind.boolean ? "set the" : kind === ReflectionKind.array ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === ReflectionKind.boolean ? "indicator" : `${kind === ReflectionKind.number ? "numeric" : "string"} value${kind === ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
+function resolveCommandArgumentDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
+	return `An${optional && !defaultValue ? " optional" : ""} argument that allows the user to ${kind === ReflectionKind.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === ReflectionKind.boolean ? "indicator" : `${kind === ReflectionKind.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 function resolveCommandId(context, file) {
 	return replacePath(findFilePath(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !isDynamicPathSegment(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
@@ -82,7 +84,7 @@ function extractCommandOption(command, reflection) {
 		name: reflection.getNameAsString(),
 		alias: reflection.getTags().alias ?? [],
 		title: reflection.getTags().title?.trim() || titleCase(reflection.getNameAsString()),
-		description: reflection.getDescription() || resolveCommandOptionDescription(reflection.getKind(), reflection.isOptional(), reflection.getNameAsString(), reflection.getTags().title, reflection.getDefaultValue()),
+		description: reflection.getDescription() || resolveCommandOptionDescription(reflection.getNameAsString(), reflection.getKind(), reflection.isOptional(), reflection.isArray(), reflection.getTags().title, reflection.getDefaultValue()),
 		env: constantCase(reflection.getNameAsString()),
 		kind: type.kind,
 		optional: reflection.isOptional(),
@@ -106,23 +108,24 @@ function extractCommandOption(command, reflection) {
 */
 function extractCommandArgument(command, reflection) {
 	const type = reflection.getType();
-	if (type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number && type.kind !== ReflectionKind.boolean && !(type.kind === ReflectionKind.array && (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number))) throw new Error(`Unsupported type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
-	const option = {
+	if (type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number && type.kind !== ReflectionKind.boolean && !(type.kind === ReflectionKind.array && (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number))) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	const argument = {
 		name: reflection.getName(),
+		alias: reflection.getAlias(),
 		kind: type.kind,
 		title: titleCase(reflection.getName()),
-		description: reflection.parameter.description || resolveCommandParameterDescription(type.kind, !!reflection.isOptional(), reflection.getName(), titleCase(reflection.getName()), reflection.getDefaultValue()),
+		description: reflection.parameter.description || resolveCommandArgumentDescription(reflection.getName(), type.kind === ReflectionKind.array ? type.type.kind : type.kind, reflection.isOptional(), type.kind === ReflectionKind.array, titleCase(reflection.getName()), reflection.getDefaultValue()),
 		env: constantCase(reflection.getName()),
 		optional: reflection.isOptional(),
 		default: reflection.getDefaultValue(),
 		reflection
 	};
 	if (type.kind === ReflectionKind.array) if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
-		option.variadic = true;
-		option.kind = type.type.kind;
-	} else throw new Error(`Unsupported array type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
-	else if (type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
-	return option;
+		argument.variadic = true;
+		argument.kind = type.type.kind;
+	} else throw new Error(`Unsupported array type for argument "${reflection.getName()}" in command "${command.name}". Only string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return argument;
 }
 /**
 * Reflects the command tree for a given command input.
@@ -133,7 +136,7 @@ function extractCommandArgument(command, reflection) {
 * @returns The reflected command tree.
 */
 async function reflectCommandTree(context, command, parent) {
-	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, "") : parent.title} - ` : ""}${titleCase(command.name)}${command.isVirtual ? " Commands" : ""}`;
+	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${titleCase(command.name)}${command.isVirtual ? " Commands" : ""}`;
 	const tree = {
 		alias: [],
 		icon: parent?.icon,
@@ -160,7 +163,7 @@ async function reflectCommandTree(context, command, parent) {
 		const type = reflect(resolved);
 		if (type.kind !== ReflectionKind.function) throw new Error(`The command entry file "${command.entry.input.file}" does not export a valid function.`);
 		tree.reflection = new ReflectionFunction(type);
-		tree.description ??= command.description || type.description || `The ${tree.title} executable command line interface.`;
+		tree.description ??= command.description || type.description || `The ${tree.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command line interface.`;
 		const parameters = tree.reflection.getParameters();
 		if (parameters.length > 0 && parameters[0]) {
 			if (parameters[0].type.kind === ReflectionKind.objectLiteral || parameters[0].type.kind === ReflectionKind.class) {
@@ -168,8 +171,15 @@ async function reflectCommandTree(context, command, parent) {
 				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
 			} else throw new Error(`The first parameter of the command handler function in "${command.entry.input.file}" must be an object literal or class type representing the command options.`);
 			tree.arguments = parameters.slice(1).map((arg) => extractCommandArgument(command, arg));
+			tree.arguments.forEach((argument, index) => {
+				const found = tree.arguments.findIndex((arg) => arg.name === argument.name);
+				if (found !== -1 && found !== index || tree.segments.some((segment) => isDynamicPathSegment(segment) && getDynamicPathSegmentName(segment) === argument.name)) {
+					argument.name += `_${tree.segments.filter((segment) => isDynamicPathSegment(segment) && getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === argument.name).length + tree.arguments.filter((arg) => arg.name.replace(/_\d+$/, "") === argument.name).length}`;
+					argument.env = constantCase(argument.name);
+				}
+			});
 		}
-	} else tree.description ??= `A collection of available ${tree.title || titleCase(tree.name)} commands that are included in the ${getAppTitle(context)} command line application.`;
+	} else tree.description ??= `A collection of available ${tree.title.replace(/(?:c|C)ommands?$/, "").trim() || titleCase(tree.name)} commands that are included in the ${getAppTitle(context)} command line application.`;
 	if (context.env) {
 		if (isSetObject(tree.options)) Object.values(tree.options).filter((option) => option.env !== false).forEach((option) => {
 			context.env.types.env.addProperty({
@@ -185,13 +195,13 @@ async function reflectCommandTree(context, command, parent) {
 				tags: {
 					...option.reflection?.getTags(),
 					title: option.title,
-					alias: option.alias.filter((alias) => alias.length > 0).map((alias) => constantCase(alias)),
+					alias: option.alias.filter((alias) => alias.length > 1).map((alias) => constantCase(alias)),
 					domain: "cli"
 				}
 			});
 		});
-		Object.values(tree.arguments).filter((arg) => arg.env !== false).forEach((arg) => context.env.types.env.addProperty({
-			name: constantCase(arg.name),
+		tree.arguments.filter((arg) => arg.env !== false).forEach((arg) => context.env.types.env.addProperty({
+			name: arg.env,
 			optional: arg.optional ? true : void 0,
 			description: arg.description,
 			visibility: ReflectionVisibility.public,
@@ -199,6 +209,7 @@ async function reflectCommandTree(context, command, parent) {
 			default: arg.default,
 			tags: {
 				...arg.reflection.getTags(),
+				alias: arg.alias.filter((alias) => alias.length > 1).map((alias) => constantCase(alias)),
 				domain: "cli"
 			}
 		}));

package/dist/helpers/resolve-command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-command.mjs","names":["esbuildPlugin","reflect","ReflectionClass","ReflectionFunction","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getDefaultOptions","resolveCommandOptionDescription","kind","optional","name","title","defaultValue","boolean","array","trim","number","resolveCommandParameterDescription","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","requireExtension","resolveCommandPath","resolveCommandDynamicPathSegments","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandOption","command","reflection","type","getType","option","getNameAsString","alias","getTags","description","getDescription","getKind","isOptional","getDefaultValue","env","default","variadic","string","Error","extractCommandArgument","getName","parameter","reflectCommandTree","parent","isVirtual","replace","tree","icon","options","arguments","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","function","parameters","getParameters","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","slice","arg","Object","values","forEach","types","addProperty","undefined","visibility","public","tags","domain","inputs","segments","segment","every","value","index"],"sources":["../../src/helpers/resolve-command.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 { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport type {\n  ReflectionParameter,\n  ReflectionProperty,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { resolveModule } from \"powerlines/lib/utilities/resolve\";\nimport {\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandArgument,\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption,\n  StringCommandArgument,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param name - The name of the command option.\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  kind: ReflectionKind,\n  optional: boolean,\n  name: string,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} ${\n    kind === ReflectionKind.boolean\n      ? \"flag provided via the command-line\"\n      : \"command-line option\"\n  } that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : kind === ReflectionKind.array\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          kind === ReflectionKind.array ? \"s\" : \"\"\n        }`\n  } that will be used in the application.`;\n}\n\n/**\n * Resolves the description for a command parameter based on its reflection.\n *\n * @param kind - The reflection kind of the command parameter.\n * @param optional - Whether the command parameter is optional.\n * @param name - The name of the command parameter.\n * @param title - The title of the command parameter, if any.\n * @param defaultValue - The default value of the command parameter, if any.\n * @returns The resolved description for the command parameter.\n */\nexport function resolveCommandParameterDescription(\n  kind: ReflectionKind,\n  optional: boolean,\n  name: string,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line positional parameter that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : kind === ReflectionKind.array\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          kind === ReflectionKind.array ? \"s\" : \"\"\n        }`\n  } that will be used in the application.`;\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isDynamicPathSegment(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isDynamicPathSegment(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .split(\"/\")\n    .filter(path => path && !isPathSegmentGroup(path))\n    .join(\"/\");\n}\n\nexport function resolveCommandDynamicPathSegments(\n  context: Context,\n  file: string\n): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(path => Boolean(path) && isDynamicPathSegment(path))\n    .map(path => getDynamicPathSegmentName(path));\n}\n\nexport function findCommandsRoot(context: Context): string {\n  if (isSetString(context.config.entry)) {\n    return appendPath(\n      appendPath(stripStars(context.config.entry), context.config.projectRoot),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    isSetObject(context.config.entry) &&\n    \"file\" in context.config.entry\n  ) {\n    return appendPath(\n      appendPath(\n        stripStars(context.config.entry.file),\n        context.config.projectRoot\n      ),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    Array.isArray(context.config.entry) &&\n    context.config.entry.length > 0\n  ) {\n    return commonPath(\n      context.config.entry.map(entry =>\n        appendPath(\n          appendPath(\n            stripStars(isSetString(entry) ? entry : entry.file),\n            context.config.projectRoot\n          ),\n          context.workspaceConfig.workspaceRoot\n        )\n      )\n    );\n  }\n\n  return appendPath(\n    context.config.sourceRoot || context.config.projectRoot,\n    context.workspaceConfig.workspaceRoot\n  );\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandOption(\n  command: CommandInput,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title:\n      reflection.getTags().title?.trim() ||\n      titleCase(reflection.getNameAsString()),\n    description:\n      reflection.getDescription() ||\n      resolveCommandOptionDescription(\n        reflection.getKind(),\n        reflection.isOptional(),\n        reflection.getNameAsString(),\n        reflection.getTags().title,\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getNameAsString()),\n    kind: type.kind as\n      | ReflectionKind.string\n      | ReflectionKind.number\n      | ReflectionKind.boolean,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray(),\n    reflection\n  } as CommandOption;\n\n  if (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind = (\n        type as TypeArray\n      ).type.kind as ReflectionKind.string | ReflectionKind.number;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\n}\n\n/**\n * Extracts command positional argument information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command positional argument information.\n */\nexport function extractCommandArgument(\n  command: CommandInput,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n\n  if (\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for positional parameter \"${reflection.getName()}\" in command \"${\n        command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const option = {\n    name: reflection.getName(),\n    kind: type.kind,\n    title: titleCase(reflection.getName()),\n    description:\n      reflection.parameter.description ||\n      resolveCommandParameterDescription(\n        type.kind,\n        !!reflection.isOptional(),\n        reflection.getName(),\n        titleCase(reflection.getName()),\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getName()),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    reflection\n  } as CommandArgument;\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandArgument | NumberCommandArgument).variadic = true;\n      (option as StringCommandArgument | NumberCommandArgument).kind =\n        type.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for positional parameter \"${reflection.getName()}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional parameter \"${reflection.getName()}\" in command \"${\n        command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/ Commands$/, \"\")\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const tree = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getDefaultOptions(context, command),\n    arguments: [],\n    parent: parent ?? null,\n    children: {},\n    reflection: null\n  } as CommandTree;\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    const resolved = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n\n    const metadata = resolved.metadata ?? {};\n    if (isSetString(metadata.title)) {\n      tree.title = metadata.title;\n    }\n    if (isSetString(metadata.description)) {\n      tree.description = metadata.description;\n    }\n    if (\n      isSetString(metadata.alias) ||\n      (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n    ) {\n      tree.alias = toArray(metadata.alias);\n    }\n    if (isSetString(metadata.icon)) {\n      tree.icon = metadata.icon;\n    }\n\n    const type = reflect(resolved);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `The command entry file \"${command.entry.input.file}\" does not export a valid function.`\n      );\n    }\n\n    tree.reflection = new ReflectionFunction(type);\n    tree.description ??=\n      command.description ||\n      type.description ||\n      `The ${tree.title} executable command line interface.`;\n\n    const parameters = tree.reflection.getParameters();\n    if (parameters.length > 0 && parameters[0]) {\n      if (\n        parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(parameters[0].type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          tree.options[propertyReflection.getNameAsString()] =\n            extractCommandOption(command, propertyReflection);\n        }\n      } else {\n        throw new Error(\n          `The first parameter of the command handler function in \"${\n            command.entry.input.file\n          }\" must be an object literal or class type representing the command options.`\n        );\n      }\n\n      tree.arguments = parameters\n        .slice(1)\n        .map(arg => extractCommandArgument(command, arg));\n    }\n  } else {\n    tree.description ??= `A collection of available ${\n      tree.title || titleCase(tree.name)\n    } commands that are included in the ${getAppTitle(\n      context\n    )} command line application.`;\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type:\n              option.reflection?.getType() ??\n              ((option as StringCommandOption | NumberCommandOption).variadic\n                ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                : { kind: option.kind }),\n            default: option.default,\n            tags: {\n              ...option.reflection?.getTags(),\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    Object.values(tree.arguments)\n      .filter(arg => arg.env !== false)\n      .forEach(arg =>\n        context.env.types.env.addProperty({\n          name: constantCase(arg.name),\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: arg.reflection.getType(),\n          default: arg.default,\n          tags: {\n            ...arg.reflection.getTags(),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        command.segments.filter(segment => !isDynamicPathSegment(segment))\n          .length +\n          1 &&\n      input.segments\n        .slice(0, command.segments.length)\n        .every((value, index) => value === command.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve-command.mjs","names":["esbuildPlugin","reflect","ReflectionClass","ReflectionFunction","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getDefaultOptions","resolveCommandOptionDescription","name","kind","optional","variadic","title","defaultValue","boolean","trim","number","resolveCommandArgumentDescription","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","requireExtension","resolveCommandPath","resolveCommandDynamicPathSegments","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandOption","command","reflection","type","getType","option","getNameAsString","alias","getTags","description","getDescription","getKind","isOptional","getDefaultValue","env","default","string","Error","extractCommandArgument","array","getName","argument","getAlias","parameter","reflectCommandTree","parent","isVirtual","replace","tree","icon","options","arguments","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","function","parameters","getParameters","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","slice","arg","forEach","index","found","findIndex","segments","some","segment","Object","values","types","addProperty","undefined","visibility","public","tags","domain","inputs","every","value"],"sources":["../../src/helpers/resolve-command.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 { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport type {\n  ReflectionParameter,\n  ReflectionProperty,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { resolveModule } from \"powerlines/lib/utilities/resolve\";\nimport {\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandArgument,\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption,\n  StringCommandArgument,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: ReflectionKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command line ${\n    kind === ReflectionKind.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: ReflectionKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isDynamicPathSegment(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isDynamicPathSegment(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .split(\"/\")\n    .filter(path => path && !isPathSegmentGroup(path))\n    .join(\"/\");\n}\n\nexport function resolveCommandDynamicPathSegments(\n  context: Context,\n  file: string\n): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(path => Boolean(path) && isDynamicPathSegment(path))\n    .map(path => getDynamicPathSegmentName(path));\n}\n\nexport function findCommandsRoot(context: Context): string {\n  if (isSetString(context.config.entry)) {\n    return appendPath(\n      appendPath(stripStars(context.config.entry), context.config.projectRoot),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    isSetObject(context.config.entry) &&\n    \"file\" in context.config.entry\n  ) {\n    return appendPath(\n      appendPath(\n        stripStars(context.config.entry.file),\n        context.config.projectRoot\n      ),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    Array.isArray(context.config.entry) &&\n    context.config.entry.length > 0\n  ) {\n    return commonPath(\n      context.config.entry.map(entry =>\n        appendPath(\n          appendPath(\n            stripStars(isSetString(entry) ? entry : entry.file),\n            context.config.projectRoot\n          ),\n          context.workspaceConfig.workspaceRoot\n        )\n      )\n    );\n  }\n\n  return appendPath(\n    context.config.sourceRoot || context.config.projectRoot,\n    context.workspaceConfig.workspaceRoot\n  );\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandOption(\n  command: CommandInput,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title:\n      reflection.getTags().title?.trim() ||\n      titleCase(reflection.getNameAsString()),\n    description:\n      reflection.getDescription() ||\n      resolveCommandOptionDescription(\n        reflection.getNameAsString(),\n        reflection.getKind(),\n        reflection.isOptional(),\n        reflection.isArray(),\n        reflection.getTags().title,\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getNameAsString()),\n    kind: type.kind as\n      | ReflectionKind.string\n      | ReflectionKind.number\n      | ReflectionKind.boolean,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray(),\n    reflection\n  } as CommandOption;\n\n  if (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind = (\n        type as TypeArray\n      ).type.kind as ReflectionKind.string | ReflectionKind.number;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\n}\n\n/**\n * Extracts command positional argument information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command positional argument information.\n */\nexport function extractCommandArgument(\n  command: CommandInput,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n\n  if (\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const argument = {\n    name: reflection.getName(),\n    alias: reflection.getAlias(),\n    kind: type.kind,\n    title: titleCase(reflection.getName()),\n    description:\n      reflection.parameter.description ||\n      resolveCommandArgumentDescription(\n        reflection.getName(),\n        type.kind === ReflectionKind.array ? type.type.kind : type.kind,\n        reflection.isOptional(),\n        type.kind === ReflectionKind.array,\n        titleCase(reflection.getName()),\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getName()),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    reflection\n  } as CommandArgument;\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandArgument | NumberCommandArgument).variadic =\n        true;\n      (argument as StringCommandArgument | NumberCommandArgument).kind =\n        type.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return argument;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const tree = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getDefaultOptions(context, command),\n    arguments: [],\n    parent: parent ?? null,\n    children: {},\n    reflection: null\n  } as CommandTree;\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    const resolved = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n\n    const metadata = resolved.metadata ?? {};\n    if (isSetString(metadata.title)) {\n      tree.title = metadata.title;\n    }\n    if (isSetString(metadata.description)) {\n      tree.description = metadata.description;\n    }\n    if (\n      isSetString(metadata.alias) ||\n      (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n    ) {\n      tree.alias = toArray(metadata.alias);\n    }\n    if (isSetString(metadata.icon)) {\n      tree.icon = metadata.icon;\n    }\n\n    const type = reflect(resolved);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `The command entry file \"${command.entry.input.file}\" does not export a valid function.`\n      );\n    }\n\n    tree.reflection = new ReflectionFunction(type);\n    tree.description ??=\n      command.description ||\n      type.description ||\n      `The ${tree.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command line interface.`;\n\n    const parameters = tree.reflection.getParameters();\n    if (parameters.length > 0 && parameters[0]) {\n      if (\n        parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(parameters[0].type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          tree.options[propertyReflection.getNameAsString()] =\n            extractCommandOption(command, propertyReflection);\n        }\n      } else {\n        throw new Error(\n          `The first parameter of the command handler function in \"${\n            command.entry.input.file\n          }\" must be an object literal or class type representing the command options.`\n        );\n      }\n\n      tree.arguments = parameters\n        .slice(1)\n        .map(arg => extractCommandArgument(command, arg));\n\n      // Ensure unique argument names by appending an index suffix to duplicates\n      tree.arguments.forEach((argument, index) => {\n        const found = tree.arguments.findIndex(\n          arg => arg.name === argument.name\n        );\n        if (\n          (found !== -1 && found !== index) ||\n          tree.segments.some(\n            segment =>\n              isDynamicPathSegment(segment) &&\n              getDynamicPathSegmentName(segment) === argument.name\n          )\n        ) {\n          argument.name += `_${\n            tree.segments.filter(\n              segment =>\n                isDynamicPathSegment(segment) &&\n                getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") ===\n                  argument.name\n            ).length +\n            tree.arguments.filter(\n              arg => arg.name.replace(/_\\d+$/, \"\") === argument.name\n            ).length\n          }`;\n          argument.env = constantCase(argument.name);\n        }\n      });\n    }\n  } else {\n    tree.description ??= `A collection of available ${\n      tree.title.replace(/(?:c|C)ommands?$/, \"\").trim() || titleCase(tree.name)\n    } commands that are included in the ${getAppTitle(\n      context\n    )} command line application.`;\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type:\n              option.reflection?.getType() ??\n              ((option as StringCommandOption | NumberCommandOption).variadic\n                ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                : { kind: option.kind }),\n            default: option.default,\n            tags: {\n              ...option.reflection?.getTags(),\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    tree.arguments\n      .filter(arg => arg.env !== false)\n      .forEach(arg =>\n        context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: arg.reflection.getType(),\n          default: arg.default,\n          tags: {\n            ...arg.reflection.getTags(),\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        command.segments.filter(segment => !isDynamicPathSegment(segment))\n          .length +\n          1 &&\n      input.segments\n        .slice(0, command.segments.length)\n        .every((value, index) => value === command.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":"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"}

package/dist/plugin.cjs

@@ -108,12 +108,17 @@ const plugin = (options = {}) => {
 					if (!(0, __stryke_path_is_parent_path.isParentPath)(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
 					const id = require_resolve_command.resolveCommandId(this, entry.file);
 					if (!ret.some((existing) => existing.id === id)) {
-						const path = require_resolve_command.resolveCommandPath(this, entry.file);
 						const name = require_resolve_command.resolveCommandName(entry.file);
+						let segments = require_resolve_command.resolveCommandPath(this, entry.file).split("/").filter(Boolean);
+						segments = segments.map((segment, index) => {
+							const found = segments.findIndex((existing) => existing === segment);
+							if (found !== -1 && found !== index) segment += `_${segments.filter((segment$1) => require_plugin_utils_context_helpers.isDynamicPathSegment(segment$1) && require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment$1).replace(/_\d+$/, "") === segment$1).length}`;
+							return segment;
+						});
 						ret.push({
 							id,
-							path,
-							segments: path.split("/").filter(Boolean),
+							path: segments.join("/"),
+							segments,
 							name,
 							alias: [],
 							isVirtual: false,
@@ -152,11 +157,16 @@ const plugin = (options = {}) => {
 									const id = require_resolve_command.resolveCommandId(this, file);
 									if (!ret.some((existing) => existing.id === id)) {
 										const name = require_resolve_command.resolveCommandName(file);
-										const path = require_resolve_command.resolveCommandPath(this, file);
+										let segments = require_resolve_command.resolveCommandPath(this, file).split("/").filter(Boolean);
+										segments = segments.map((segment, index) => {
+											const found = segments.findIndex((existing) => existing === segment);
+											if (found !== -1 && found !== index) segment += `_${segments.filter((segment$1) => require_plugin_utils_context_helpers.isDynamicPathSegment(segment$1) && require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment$1).replace(/_\d+$/, "") === segment$1).length}`;
+											return segment;
+										});
 										ret.push({
 											id,
-											path,
-											segments: path.split("/").filter(Boolean),
+											path: segments.join("/"),
+											segments,
 											name,
 											alias: [],
 											isVirtual: true,

package/dist/plugin.cjs.map

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

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA+EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GA6ajC,MA7aiC,CA6a1B,QA7a0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAgFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GA4djC,MA5diC,CA4d1B,QA5d0B,CAAA,EAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA+EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GA6ajC,MA7aiC,CA6a1B,QA7a0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAgFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GA4djC,MA5diC,CA4d1B,QA5d0B,CAAA,EAAA"}

package/dist/plugin.mjs

@@ -1,4 +1,4 @@
-import { getAppDescription, getAppName, getAppTitle, isDynamicPathSegment, isPathSegmentGroup } from "./plugin-utils/context-helpers.mjs";
+import { getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, isPathSegmentGroup } from "./plugin-utils/context-helpers.mjs";
 import { CommandDocsFile } from "./components/docs.mjs";
 import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
 import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
@@ -102,12 +102,17 @@ const plugin = (options = {}) => {
 					if (!isParentPath(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
 					const id = resolveCommandId(this, entry.file);
 					if (!ret.some((existing) => existing.id === id)) {
-						const path = resolveCommandPath(this, entry.file);
 						const name = resolveCommandName(entry.file);
+						let segments = resolveCommandPath(this, entry.file).split("/").filter(Boolean);
+						segments = segments.map((segment, index) => {
+							const found = segments.findIndex((existing) => existing === segment);
+							if (found !== -1 && found !== index) segment += `_${segments.filter((segment$1) => isDynamicPathSegment(segment$1) && getDynamicPathSegmentName(segment$1).replace(/_\d+$/, "") === segment$1).length}`;
+							return segment;
+						});
 						ret.push({
 							id,
-							path,
-							segments: path.split("/").filter(Boolean),
+							path: segments.join("/"),
+							segments,
 							name,
 							alias: [],
 							isVirtual: false,
@@ -146,11 +151,16 @@ const plugin = (options = {}) => {
 									const id = resolveCommandId(this, file);
 									if (!ret.some((existing) => existing.id === id)) {
 										const name = resolveCommandName(file);
-										const path = resolveCommandPath(this, file);
+										let segments = resolveCommandPath(this, file).split("/").filter(Boolean);
+										segments = segments.map((segment, index) => {
+											const found = segments.findIndex((existing) => existing === segment);
+											if (found !== -1 && found !== index) segment += `_${segments.filter((segment$1) => isDynamicPathSegment(segment$1) && getDynamicPathSegmentName(segment$1).replace(/_\d+$/, "") === segment$1).length}`;
+											return segment;
+										});
 										ret.push({
 											id,
-											path,
-											segments: path.split("/").filter(Boolean),
+											path: segments.join("/"),
+											segments,
 											name,
 											alias: [],
 											isVirtual: true,