@shell-shock/core 0.8.9 → 0.8.11

package/dist/components/docs.d.cts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _alloy_js_core8 from "@alloy-js/core";
+import * as _alloy_js_core9 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +12,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core8.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core9.Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +31,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core8.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core9.Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +56,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _alloy_js_core8.Children;
+declare function CommandDocs(props: CommandDocsProps): _alloy_js_core9.Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +75,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core8.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core9.Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.cts.map

package/dist/components/docs.d.mts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.mjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core1 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +12,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core0.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core1.Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +31,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core0.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core1.Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +56,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _alloy_js_core0.Children;
+declare function CommandDocs(props: CommandDocsProps): _alloy_js_core1.Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +75,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core0.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core1.Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.mts.map

package/dist/components/helpers.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core12 from "@alloy-js/core";
+import * as _alloy_js_core8 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,7 +7,7 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core12.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core8.Children;
 //#endregion
 export { BooleanInputParserLogic, BooleanInputParserLogicProps };
 //# sourceMappingURL=helpers.d.cts.map

package/dist/components/helpers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;;iBAAgB,uBAAA,QAA+B,+BAA4B,gBAAA,CAAA"}
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;;iBAAgB,uBAAA,QAA+B,+BAA4B,eAAA,CAAA"}

package/dist/components/options-parser-logic.d.mts

@@ -1,5 +1,5 @@
 import { CommandOption, CommandTree } from "../types/command.mjs";
-import * as _alloy_js_core4 from "@alloy-js/core";
+import * as _alloy_js_core5 from "@alloy-js/core";
 
 //#region src/components/options-parser-logic.d.ts
 interface DynamicSegmentsParserLogicProps {
@@ -12,7 +12,7 @@ interface DynamicSegmentsParserLogicProps {
    */
   isCaseSensitive: boolean;
 }
-declare function DynamicSegmentsParserLogic(props: DynamicSegmentsParserLogicProps): _alloy_js_core4.Children;
+declare function DynamicSegmentsParserLogic(props: DynamicSegmentsParserLogicProps): _alloy_js_core5.Children;
 interface ArgumentsParserLogicProps {
   /**
    * The command to generate the positional parameters parser logic for.
@@ -27,7 +27,7 @@ interface ArgumentsParserLogicProps {
    */
   isCaseSensitive: boolean;
 }
-declare function ArgumentsParserLogic(props: ArgumentsParserLogicProps): _alloy_js_core4.Children;
+declare function ArgumentsParserLogic(props: ArgumentsParserLogicProps): _alloy_js_core5.Children;
 /**
  * The command option interface property.
  */
@@ -35,7 +35,7 @@ declare function OptionsMember({
   option
 }: {
   option: CommandOption;
-}): _alloy_js_core4.Children;
+}): _alloy_js_core5.Children;
 interface OptionsMemberParserLogicProps {
   /**
    * The option name to generate the parser logic for.
@@ -55,7 +55,7 @@ interface OptionsMemberParserLogicProps {
 /**
  * The command option property parser logic.
  */
-declare function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps): _alloy_js_core4.Children;
+declare function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps): _alloy_js_core5.Children;
 interface OptionsMemberParserConditionProps {
   /**
    * The option name to generate the parser logic for.
@@ -72,10 +72,10 @@ interface OptionsMemberParserConditionProps {
    */
   isCaseSensitive: boolean;
 }
-declare function OptionsMemberParserCondition(props: OptionsMemberParserConditionProps): _alloy_js_core4.Children;
+declare function OptionsMemberParserCondition(props: OptionsMemberParserConditionProps): _alloy_js_core5.Children;
 declare function OptionsInterfaceDeclaration(props: {
   command: CommandTree;
-}): _alloy_js_core4.Children;
+}): _alloy_js_core5.Children;
 interface OptionsParserLogicProps {
   /**
    * The command to generate the options parser logic for.
@@ -95,7 +95,7 @@ interface OptionsParserLogicProps {
 /**
  * The command options parser logic.
  */
-declare function OptionsParserLogic(props: OptionsParserLogicProps): _alloy_js_core4.Children;
+declare function OptionsParserLogic(props: OptionsParserLogicProps): _alloy_js_core5.Children;
 interface CommandParserLogicProps {
   /**
    * The command to generate the parser logic for.
@@ -115,7 +115,7 @@ interface CommandParserLogicProps {
 /**
  * The command parser logic, which includes parsing dynamic path segments, positional parameters, and options.
  */
-declare function CommandParserLogic(props: CommandParserLogicProps): _alloy_js_core4.Children;
+declare function CommandParserLogic(props: CommandParserLogicProps): _alloy_js_core5.Children;
 //#endregion
 export { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps };
 //# sourceMappingURL=options-parser-logic.d.mts.map

package/dist/components/usage.d.mts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.mjs";
-import * as _alloy_js_core12 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 
 //#region src/components/usage.d.ts
 interface UsageProps {
@@ -22,7 +22,7 @@ interface UsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function Usage(props: UsageProps): _alloy_js_core12.Children;
+declare function Usage(props: UsageProps): _alloy_js_core0.Children;
 //#endregion
 export { Usage, UsageProps };
 //# sourceMappingURL=usage.d.mts.map

package/dist/components/usage.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.mts","names":[],"sources":["../../src/components/usage.tsx"],"sourcesContent":[],"mappings":";;;;UA2BiB,UAAA;;;AAAjB;EAuBgB,OAAA,EAnBL,WAmBkB;;;;;;;;;;;;;;;;iBAAb,KAAA,QAAa,aAAU,gBAAA,CAAA"}
+{"version":3,"file":"usage.d.mts","names":[],"sources":["../../src/components/usage.tsx"],"sourcesContent":[],"mappings":";;;;UA2BiB,UAAA;;;AAAjB;EAuBgB,OAAA,EAnBL,WAmBkB;;;;;;;;;;;;;;;;iBAAb,KAAA,QAAa,aAAU,eAAA,CAAA"}

package/dist/helpers/resolve-command.cjs

@@ -29,7 +29,7 @@ let powerlines_lib_utilities_resolve = require("powerlines/lib/utilities/resolve
 * @returns The resolved description for the command option.
 */
 function resolveCommandOptionDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
-	return `A${optional && !defaultValue ? "n optional" : ""} command line ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "flag" : "option"} that allows the user to ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, __stryke_string_format_title_case.titleCase)(name)} ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "indicator" : `${kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+	return `A${optional && !defaultValue ? "n optional" : ""} command-line ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "flag" : "option"} that allows the user to ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, __stryke_string_format_title_case.titleCase)(name)} ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "indicator" : `${kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 /**
 * Resolves the description for a command argument based on its reflection.
@@ -164,7 +164,7 @@ async function reflectCommandTree(context, command, parent) {
 		const type = (0, __powerlines_deepkit_vendor_type.reflect)(resolved);
 		if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.function) throw new Error(`The command entry file "${command.entry.input.file}" does not export a valid function.`);
 		tree.reflection = new __powerlines_deepkit_vendor_type.ReflectionFunction(type);
-		tree.description ??= command.description || type.description || `The ${tree.title.replace(/(?:c|C)ommands?$/, "").trim()} 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 === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || parameters[0].type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) {
@@ -180,7 +180,7 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		}
-	} else tree.description ??= `A collection of available ${tree.title.replace(/(?:c|C)ommands?$/, "").trim() || (0, __stryke_string_format_title_case.titleCase)(tree.name)} commands that are included in the ${require_plugin_utils_context_helpers.getAppTitle(context)} command line application.`;
+	} else tree.description ??= `A collection of available ${tree.title.replace(/(?:c|C)ommands?$/, "").trim() || (0, __stryke_string_format_title_case.titleCase)(tree.name)} commands that are included in the ${require_plugin_utils_context_helpers.getAppTitle(context)} command-line application.`;
 	if (context.env) {
 		if ((0, __stryke_type_checks_is_set_object.isSetObject)(tree.options)) Object.values(tree.options).filter((option) => option.env !== false).forEach((option) => {
 			context.env.types.env.addProperty({

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-command.cjs","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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"}
+{"version":3,"file":"resolve-command.cjs","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/helpers/resolve-command.mjs

@@ -28,7 +28,7 @@ import { resolveModule } from "powerlines/lib/utilities/resolve";
 * @returns The resolved description for the command option.
 */
 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" : ""}`}.`;
+	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 argument based on its reflection.
@@ -163,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.replace(/(?:c|C)ommands?$/, "").trim()} 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) {
@@ -179,7 +179,7 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		}
-	} 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.`;
+	} 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({

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","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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"}
+{"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-utils/context-helpers.cjs

@@ -33,10 +33,12 @@ function getAppName(context) {
 * Retrieves the application title from the context and configuration.
 *
 * @param context - The build context containing workspace and package information.
+* @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
 * @returns The application title in title-case format.
 */
-function getAppTitle(context) {
-	return context.config.title || (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
+function getAppTitle(context, replaceCLI = false) {
+	const title = context.config.title || (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
+	return (replaceCLI ? title.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi, "") : title).trim();
 }
 /**
 * Retrieves the application description from the context and configuration.
@@ -45,7 +47,7 @@ function getAppTitle(context) {
 * @returns The application description.
 */
 function getAppDescription(context) {
-	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context, true)} command-line interface application.`;
 }
 /**
 * Retrieves the primary binary name for the application.