@shell-shock/core 0.4.3 → 0.5.0

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-command.cjs","names":["reflectType","ReflectionClass","ReflectionKind","ReflectionVisibility","stringifyType","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","getAppTitle","getVariableCommandPathName","isVariableCommandPath","getDefaultOptions","resolveCommandDescription","propertyReflection","getDescription","trim","isOptional","getDefaultValue","getType","kind","boolean","array","getTags","title","getNameAsString","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","name","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandParameters","param","description","optional","variadic","type","default","reflectCommandTree","command","parent","isVirtual","replace","tree","variables","options","params","children","input","fs","existsSync","Error","debug","id","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","getProperties","propertyType","alias","env","string","segments","segment","reduce","obj","index","paramName","slice","forEach","push","Object","values","option","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 { reflectType } from \"@powerlines/deepkit/reflect-type\";\nimport type {\n  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\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 {\n  getAppTitle,\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandParam,\n  CommandTree,\n  NumberCommandOption,\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 propertyReflection - The reflection property of the command option.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandDescription(\n  propertyReflection: ReflectionProperty\n): string {\n  return (\n    propertyReflection.getDescription()?.trim() ||\n    `A${\n      propertyReflection.isOptional() && !propertyReflection.getDefaultValue()\n        ? \"n optional\"\n        : \"\"\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"flag provided via the command-line\"\n        : \"command-line option\"\n    } that allows the user to ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"set the\"\n        : propertyReflection.getType().kind === ReflectionKind.array\n          ? \"specify custom\"\n          : \"specify a custom\"\n    } ${\n      propertyReflection.getTags().title?.trim() ||\n      titleCase(propertyReflection.getNameAsString())\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"indicator\"\n        : `${propertyReflection.getType().kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n            propertyReflection.getType().kind === ReflectionKind.array\n              ? \"s\"\n              : \"\"\n          }`\n    } that will be used in the application.`\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) && !isVariableCommandPath(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 (isVariableCommandPath(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}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isVariableCommandPath(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\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 param - The type parameter reflection to extract information from.\n * @returns The extracted command parameter information.\n */\nexport function extractCommandParameters(param: TypeParameter): CommandParam {\n  return {\n    name: param.name,\n    description: param.description,\n    optional: !!param.optional,\n    variadic: param.type.kind === ReflectionKind.array,\n    default: param.default\n  } as CommandParam;\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    `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, \"\") : parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    ...command,\n    title,\n    description:\n      command.description ||\n      (command.isVirtual\n        ? `A collection of available ${command.title || titleCase(command.name)} commands that are included in the ${getAppTitle(\n            context\n          )} command-line application.`\n        : `The ${title} executable command-line interface.`),\n    path: {\n      ...command.path,\n      variables: {}\n    },\n    options: getDefaultOptions(context, command),\n    params: [],\n    parent: parent ?? null,\n    children: {}\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 type = await reflectType<TContext>(context, command.entry.input);\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    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          const propertyType = propertyReflection.getType();\n\n          tree.options[propertyReflection.getNameAsString()] = {\n            name: propertyReflection.getNameAsString(),\n            alias: propertyReflection.getTags().alias ?? [],\n            title:\n              propertyReflection.getTags().title?.trim() ||\n              titleCase(propertyReflection.getNameAsString()),\n            description: resolveCommandDescription(propertyReflection),\n            env: constantCase(propertyReflection.getNameAsString()),\n            kind: propertyType.kind as\n              | ReflectionKind.string\n              | ReflectionKind.number\n              | ReflectionKind.boolean,\n            optional: propertyReflection.isOptional(),\n            default: propertyReflection.getDefaultValue(),\n            variadic: false\n          };\n          if (propertyType.kind === ReflectionKind.array) {\n            if (\n              propertyType.type.kind === ReflectionKind.string ||\n              propertyType.type.kind === ReflectionKind.number\n            ) {\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).variadic = true;\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).kind = propertyType.type.kind;\n            } else {\n              throw new Error(\n                `Unsupported array type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                  command.name\n                }\". Only string[] and number[] are supported.`\n              );\n            }\n          } else if (\n            propertyType.kind !== ReflectionKind.boolean &&\n            propertyType.kind !== ReflectionKind.string &&\n            propertyType.kind !== ReflectionKind.number\n          ) {\n            throw new Error(\n              `Unsupported type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                command.name\n              }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n                propertyType\n              )\n                .trim()\n                .replaceAll(\" | \", \", or \")}.`\n            );\n          }\n        }\n      }\n\n      tree.path.variables = tree.path.segments\n        .filter(segment => isVariableCommandPath(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getVariableCommandPathName(segment);\n            obj[paramName] = extractCommandParameters(\n              type.parameters[index + 1]!\n            );\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} variable for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandParam>\n        );\n\n      if (type.parameters.length > 1) {\n        type.parameters\n          .slice(\n            tree.path.segments.filter(segment => isVariableCommandPath(segment))\n              .length + 1\n          )\n          .forEach(param => {\n            tree.params.push(extractCommandParameters(param));\n          });\n      }\n    }\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.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (tree.params) {\n      tree.params.forEach(param => {\n        context.env.types.env.addProperty({\n          name: constantCase(param.name),\n          optional: param.optional ? true : undefined,\n          description: param.description,\n          visibility: ReflectionVisibility.public,\n          type: param.variadic\n            ? {\n                kind: ReflectionKind.array,\n                type: { kind: ReflectionKind.string }\n              }\n            : { kind: ReflectionKind.string },\n          default: param.default,\n          tags: {\n            domain: \"cli\"\n          }\n        });\n      });\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isVariableCommandPath(segment))\n        .length ===\n        command.path.segments.filter(segment => !isVariableCommandPath(segment))\n          .length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.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","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","getDefaultOptions","resolveCommandOptionDescription","kind","optional","name","title","defaultValue","boolean","array","trim","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandOption","command","reflection","propertyType","getType","option","getNameAsString","alias","getTags","description","getDescription","getKind","isOptional","getDefaultValue","env","default","variadic","type","string","Error","extractCommandPositionalOption","segment","reflectCommandTree","parent","isVirtual","replace","tree","positional","options","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","segments","reduce","obj","index","paramName","Object","values","forEach","types","addProperty","undefined","visibility","public","tags","domain","inputs","slice","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  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\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  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandPositionalOption,\n  CommandTree,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param name - The name of the command option.\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  kind: ReflectionKind,\n  optional: boolean,\n  name: string,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} ${\n    kind === ReflectionKind.boolean\n      ? \"flag provided via the command-line\"\n      : \"command-line option\"\n  } that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : kind === ReflectionKind.array\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          kind === ReflectionKind.array ? \"s\" : \"\"\n        }`\n  } that will be used in the application.`;\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isPositionalCommandOption(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 (isPositionalCommandOption(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}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isPositionalCommandOption(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\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 propertyType = reflection.getType();\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title:\n      reflection.getTags().title?.trim() ||\n      titleCase(reflection.getNameAsString()),\n    description:\n      reflection.getDescription() ||\n      resolveCommandOptionDescription(\n        reflection.getKind(),\n        reflection.isOptional(),\n        reflection.getNameAsString(),\n        reflection.getTags().title,\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getNameAsString()),\n    kind: propertyType.kind as\n      | ReflectionKind.string\n      | ReflectionKind.number\n      | ReflectionKind.boolean,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: false\n  } as CommandOption;\n  if (propertyType.kind === ReflectionKind.array) {\n    if (\n      propertyType.type.kind === ReflectionKind.string ||\n      propertyType.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        propertyType.type.kind;\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.`\n      );\n    }\n  } else if (\n    propertyType.kind !== ReflectionKind.boolean &&\n    propertyType.kind !== ReflectionKind.string &&\n    propertyType.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        propertyType\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\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 segment - The command path segment corresponding to the parameter.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandPositionalOption(\n  command: CommandInput,\n  segment: string,\n  reflection: TypeParameter\n): CommandPositionalOption {\n  if (\n    reflection.type.kind !== ReflectionKind.string &&\n    reflection.type.kind !== ReflectionKind.number &&\n    !(\n      reflection.type.kind === ReflectionKind.array &&\n      (reflection.type.type.kind === ReflectionKind.string ||\n        reflection.type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for positional option \"${segment}\" in command \"${\n        command.name\n      }\". Only string and number types (or string[] and number[]) are supported, received ${stringifyType(\n        reflection.type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const option = {\n    name: segment,\n    alias: [],\n    title: titleCase(segment),\n    description:\n      reflection.description ||\n      resolveCommandOptionDescription(\n        reflection.type.kind,\n        !!reflection.optional,\n        segment,\n        titleCase(segment),\n        reflection.default\n      ),\n    env: constantCase(segment),\n    kind: reflection.type.kind,\n    optional: reflection.optional,\n    default: reflection.default,\n    variadic: false\n  } as CommandPositionalOption;\n\n  if (reflection.type.kind === ReflectionKind.array) {\n    if (\n      reflection.type.type.kind === ReflectionKind.string ||\n      reflection.type.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        reflection.type.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${segment}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported.`\n      );\n    }\n  }\n\n  return option;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, \"\") : parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    alias: [],\n    ...command,\n    title,\n    path: {\n      ...command.path,\n      positional: {}\n    },\n    options: getDefaultOptions(context, command),\n    parent: parent ?? null,\n    children: {}\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\n    const type = reflect(resolved);\n\n    // const type = await reflectType<TContext>(context, command.entry.input);\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.description ??=\n      command.description ||\n      type.description ||\n      `The ${tree.title} executable command-line interface.`;\n\n    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          tree.options[propertyReflection.getNameAsString()] =\n            extractCommandOption(command, propertyReflection);\n        }\n      }\n\n      tree.path.positional = tree.path.segments\n        .filter(segment => isPositionalCommandOption(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getPositionalCommandOptionName(segment);\n            obj[paramName] = extractCommandPositionalOption(\n              command,\n              paramName,\n              type.parameters[index + 1]!\n            );\n\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} positional option for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandPositionalOption>\n        );\n    }\n  } else {\n    tree.description ??= `A collection of available ${\n      tree.title || titleCase(tree.name)\n    } commands that are included in the ${getAppTitle(\n      context\n    )} command-line application.`;\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type:\n              option.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (\n      Object.values(tree.path.positional).filter(option => option.env !== false)\n        .length > 0\n    ) {\n      Object.values(tree.path.positional)\n        .filter(option => option.env !== false)\n        .forEach(option =>\n          context.env.types.env.addProperty({\n            name: constantCase(option.name),\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: option.variadic\n              ? {\n                  kind: ReflectionKind.array,\n                  type: { kind: ReflectionKind.string }\n                }\n              : { kind: ReflectionKind.string },\n            default: option.default,\n            tags: {\n              domain: \"cli\"\n            }\n          })\n        );\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isPositionalCommandOption(segment))\n        .length ===\n        command.path.segments.filter(\n          segment => !isPositionalCommandOption(segment)\n        ).length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,SAAgBuB,gCACdC,MACAC,UACAC,MACAC,OACAC,cACQ;AACR,QAAO,IAAIH,YAAY,CAACG,eAAe,eAAe,GAAE,GACtDJ,SAASrB,gDAAe0B,UACpB,uCACA,sBAAqB,2BAEzBL,SAASrB,gDAAe0B,UACpB,YACAL,SAASrB,gDAAe2B,QACtB,mBACA,mBAAkB,GACtBH,OAAOI,MAAM,qDAAcL,KAAK,CAAA,GAClCF,SAASrB,gDAAe0B,UACpB,cACA,GAAGL,SAASrB,gDAAe6B,SAAS,YAAY,SAAQ,QACtDR,SAASrB,gDAAe2B,QAAQ,MAAM,KACtC;;AAIV,SAAgBG,iBAAiBC,SAAkBC,MAAsB;AACvE,6FAAgCA,KAAK,EAAED,QAAQE,aAAa,CACzDC,MAAM,IAAI,CACVC,QAAOC,MAAKC,QAAQD,EAAE,IAAI,CAAClB,+DAA0BkB,EAAE,CAAC,CACxDE,KAAK,IAAI,CACTC,WAAW,SAAS,GAAG,CACvBA,WAAW,SAAS,GAAG,CACvBA,WAAW,KAAK,IAAI;;;;;;;;AASzB,SAAgBC,mBAAmBR,MAAc;CAC/C,IAAIS,qDAAoBT,KAAK;CAC7B,IAAIT,uDAAsBS,MAAM,EAC9BU,kBAAkB,MACnB,CAAC;AAEF,QAAOxB,+DAA0BK,KAAK,EAAE;AACtCkB,kEAAyBA,KAAK;AAC9BlB,yDAAsBkB,MAAM,EAC1BC,kBAAkB,MACnB,CAAC;;AAGJ,QAAOnB;;AAGT,SAAgBoB,mBAAmBZ,SAAkBC,MAAsB;AACzE,6FAAgCA,KAAK,EAAED,QAAQE,aAAa,CACzDM,WAAW,SAAS,GAAG,CACvBA,WAAW,SAAS,GAAG;;AAU5B,SAAgBO,iBAAiBf,SAA0B;AACzD,yDAAgBA,QAAQgB,OAAOC,MAAM,CACnC,0HACwBjB,QAAQgB,OAAOC,MAAM,EAAEjB,QAAQgB,OAAOE,YAAY,EACxElB,QAAQmB,gBAAgBC,cACzB;8DAEWpB,QAAQgB,OAAOC,MAAM,IACjC,UAAUjB,QAAQgB,OAAOC,MAEzB,0HAEejB,QAAQgB,OAAOC,MAAMhB,KAAK,EACrCD,QAAQgB,OAAOE,YAChB,EACDlB,QAAQmB,gBAAgBC,cACzB;UAEDC,MAAMC,QAAQtB,QAAQgB,OAAOC,MAAM,IACnCjB,QAAQgB,OAAOC,MAAMM,SAAS,EAE9B,6CACEvB,QAAQgB,OAAOC,MAAMH,KAAIG,gLAGIA,MAAM,GAAGA,QAAQA,MAAMhB,KAAK,EACnDD,QAAQgB,OAAOE,YAChB,EACDlB,QAAQmB,gBAAgBC,cAE5B,CACF,CAAC;AAGH,6CACEpB,QAAQgB,OAAOQ,cAAcxB,QAAQgB,OAAOE,aAC5ClB,QAAQmB,gBAAgBC,cACzB;;;;;;;;;AAUH,SAAgBK,qBACdC,SACAC,YACe;CACf,MAAMC,eAAeD,WAAWE,SAAS;CAEzC,MAAMC,SAAS;EACbtC,MAAMmC,WAAWI,iBAAiB;EAClCC,OAAOL,WAAWM,SAAS,CAACD,SAAS,EAAE;EACvCvC,OACEkC,WAAWM,SAAS,CAACxC,OAAOI,MAAM,qDACxB8B,WAAWI,iBAAiB,CAAC;EACzCG,aACEP,WAAWQ,gBAAgB,IAC3B9C,gCACEsC,WAAWS,SAAS,EACpBT,WAAWU,YAAY,EACvBV,WAAWI,iBAAiB,EAC5BJ,WAAWM,SAAS,CAACxC,OACrBkC,WAAWW,iBACb,CAAC;EACHC,4DAAkBZ,WAAWI,iBAAiB,CAAC;EAC/CzC,MAAMsC,aAAatC;EAInBC,UAAUoC,WAAWU,YAAY;EACjCG,SAASb,WAAWW,iBAAiB;EACrCG,UAAU;EACM;AAClB,KAAIb,aAAatC,SAASrB,gDAAe2B,MACvC,KACEgC,aAAac,KAAKpD,SAASrB,gDAAe0E,UAC1Cf,aAAac,KAAKpD,SAASrB,gDAAe6B,QAC1C;AACCgC,SAAqDW,WAAW;AAChEX,SAAqDxC,OACpDsC,aAAac,KAAKpD;OAEpB,OAAM,IAAIsD,MACR,sCAAsCjB,WAAWI,iBAAiB,CAAA,gBAChEL,QAAQlC,KAAI,8CAEf;UAGHoC,aAAatC,SAASrB,gDAAe0B,WACrCiC,aAAatC,SAASrB,gDAAe0E,UACrCf,aAAatC,SAASrB,gDAAe6B,OAErC,OAAM,IAAI8C,MACR,gCAAgCjB,WAAWI,iBAAiB,CAAA,gBAC1DL,QAAQlC,KAAI,qIAEZoC,aACD,CACE/B,MAAM,CACNW,WAAW,OAAO,QAAQ,CAAA,GAC9B;AAGH,QAAOsB;;;;;;;;;;AAWT,SAAgBe,+BACdnB,SACAoB,SACAnB,YACyB;AACzB,KACEA,WAAWe,KAAKpD,SAASrB,gDAAe0E,UACxChB,WAAWe,KAAKpD,SAASrB,gDAAe6B,UACxC,EACE6B,WAAWe,KAAKpD,SAASrB,gDAAe2B,UACvC+B,WAAWe,KAAKA,KAAKpD,SAASrB,gDAAe0E,UAC5ChB,WAAWe,KAAKA,KAAKpD,SAASrB,gDAAe6B,SAGjD,OAAM,IAAI8C,MACR,2CAA2CE,QAAO,gBAChDpB,QAAQlC,KAAI,yIAEZmC,WAAWe,KACZ,CACE7C,MAAM,CACNW,WAAW,OAAO,QAAQ,CAAA,GAC9B;CAGH,MAAMsB,SAAS;EACbtC,MAAMsD;EACNd,OAAO,EAAE;EACTvC,wDAAiBqD,QAAQ;EACzBZ,aACEP,WAAWO,eACX7C,gCACEsC,WAAWe,KAAKpD,MAChB,CAAC,CAACqC,WAAWpC,UACbuD,0DACUA,QAAQ,EAClBnB,WAAWa,QACZ;EACHD,4DAAkBO,QAAQ;EAC1BxD,MAAMqC,WAAWe,KAAKpD;EACtBC,UAAUoC,WAAWpC;EACrBiD,SAASb,WAAWa;EACpBC,UAAU;EACgB;AAE5B,KAAId,WAAWe,KAAKpD,SAASrB,gDAAe2B,MAC1C,KACE+B,WAAWe,KAAKA,KAAKpD,SAASrB,gDAAe0E,UAC7ChB,WAAWe,KAAKA,KAAKpD,SAASrB,gDAAe6B,QAC7C;AACCgC,SAAqDW,WAAW;AAChEX,SAAqDxC,OACpDqC,WAAWe,KAAKA,KAAKpD;OAEvB,OAAM,IAAIsD,MACR,sCAAsCE,QAAO,gBAC3CpB,QAAQlC,KAAI,8CAEf;AAIL,QAAOsC;;;;;;;;;;AAWT,eAAsBiB,mBACpB/C,SACA0B,SACAsB,QACsB;CACtB,MAAMvD,QACJiC,QAAQjC,SACR,GAAGuD,QAAQvD,QAAQ,GAAGuD,OAAOC,YAAYD,OAAOvD,MAAMyD,QAAQ,cAAc,GAAG,GAAGF,OAAOvD,MAAK,OAAQ,sDAAeiC,QAAQlC,KAAK,GAChIkC,QAAQuB,YAAY,cAAc;CAGtC,MAAME,OAAO;EACXnB,OAAO,EAAE;EACT,GAAGN;EACHjC;EACAiB,MAAM;GACJ,GAAGgB,QAAQhB;GACX0C,YAAY,EAAC;GACd;EACDC,SAASjE,oCAAkBY,SAAS0B,QAAQ;EAC5CsB,QAAQA,UAAU;EAClBM,UAAU,EAAC;EACG;AAEhB,KAAI,CAAC5B,QAAQuB,WAAW;AACtB,MACE,CAACvB,QAAQT,MAAMsC,OAAOtD,QACtB,CAACD,QAAQwD,GAAGC,WAAW/B,QAAQT,MAAMsC,MAAMtD,KAAK,CAEhD,OAAM,IAAI2C,MACR,GACE,CAAClB,QAAQT,MAAMsC,OAAOtD,OAAO,YAAY,eAAc,2BAC7ByB,QAAQlC,KAAI,GACzC;AAGHQ,UAAQ0D,MACN,+CAA+ChC,QAAQiC,GAAE,UACvDjC,QAAQT,MAAMsC,MAAMtD,KAAI,GAE3B;EAED,MAAM2D,WAAW,0DACf5D,SACA0B,QAAQT,MAAMsC,OACd,EACEM,SAAS,wDACO7D,SAAS;GACrB2B,YAAY;GACZmC,iBAAiB;GAClB,CAAC,CAAA,EAGR,CAAC;EAED,MAAMC,WAAWH,SAASG,YAAY,EAAE;AACxC,0DAAgBA,SAAStE,MAAM,CAC7B0D,MAAK1D,QAAQsE,SAAStE;AAExB,0DAAgBsE,SAAS7B,YAAY,CACnCiB,MAAKjB,cAAc6B,SAAS7B;AAE9B,0DACc6B,SAAS/B,MAAM,IAC1BX,MAAMC,QAAQyC,SAAS/B,MAAM,IAAI+B,SAAS/B,MAAMT,SAAS,EAE1D4B,MAAKnB,+CAAgB+B,SAAS/B,MAAM;EAGtC,MAAMU,qDAAekB,SAAS;AAG9B,MAAIlB,KAAKpD,SAASrB,gDAAe+F,SAC/B,OAAM,IAAIpB,MACR,2BAA2BlB,QAAQT,MAAMsC,MAAMtD,KAAI,qCACpD;AAGHkD,OAAKjB,gBACHR,QAAQQ,eACRQ,KAAKR,eACL,OAAOiB,KAAK1D,MAAK;AAEnB,MAAIiD,KAAKuB,WAAW1C,SAAS,KAAKmB,KAAKuB,WAAW,IAAI;GACpD,MAAMC,aAAaxB,KAAKuB,WAAW;AACnC,OACEC,WAAWxB,KAAKpD,SAASrB,gDAAekG,iBACxCD,WAAWxB,KAAKpD,SAASrB,gDAAemG,OACxC;IACA,MAAMC,oBAAoBrG,iDAAgBsG,KAAKJ,WAAWxB,KAAK;AAC/D,SAAK,MAAM6B,sBAAsBF,kBAAkBG,eAAe,CAChErB,MAAKE,QAAQkB,mBAAmBxC,iBAAiB,IAC/CN,qBAAqBC,SAAS6C,mBAAmB;;AAIvDpB,QAAKzC,KAAK0C,aAAaD,KAAKzC,KAAK+D,SAC9BrE,QAAO0C,YAAW3D,+DAA0B2D,QAAQ,CAAC,CACrD4B,QACEC,KAAK7B,SAAS8B,UAAU;AACvB,QACElC,KAAKuB,WAAW1C,SAASqD,QAAQ,KACjC,CAAClC,KAAKuB,WAAWW,QAAQ,GAEzB,QAAOD;IAGT,MAAME,YAAY3F,oEAA+B4D,QAAQ;AACzD6B,QAAIE,aAAahC,+BACfnB,SACAmD,WACAnC,KAAKuB,WAAWW,QAAQ,GACzB;AAEDD,QAAIE,WAAW3C,cACbyC,IAAIE,WAAW3C,eACf,OAAO2C,UAAS,6BAA8BnD,QAAQlC,KAAI;AAE5D,WAAOmF;MAET,EACF,CAAC;;OAGLxB,MAAKjB,gBAAgB,6BACnBiB,KAAK1D,0DAAmB0D,KAAK3D,KAAK,CAAA,qCACEP,iDACpCe,QACD,CAAA;AAGH,KAAIA,QAAQuC,KAAK;AACf,0DAAgBY,KAAKE,QAAQ,CAC3ByB,QAAOC,OAAO5B,KAAKE,QAAQ,CACxBjD,QAAO0B,WAAUA,OAAOS,QAAQ,MAAM,CACtCyC,SAAQlD,WAAU;AACjB9B,WAAQuC,IAAI0C,MAAM1C,IAAI2C,YAAY;IAChC1F,MAAMsC,OAAOS;IACbhD,UAAUuC,OAAOvC,WAAW,OAAO4F;IACnCjD,aAAaJ,OAAOI;IACpBkD,YAAYlH,sDAAqBmH;IACjC3C,MACEZ,OAAOxC,SAASrB,gDAAe0E,UAC/Bb,OAAOxC,SAASrB,gDAAe6B,SAC3BgC,OAAOW,WACL;KAAEnD,MAAMrB,gDAAe2B;KAAO8C,MAAM,EAAEpD,MAAMwC,OAAOxC,MAAK;KAAG,GAC3D,EAAEA,MAAMwC,OAAOxC,MAAM,GACvB,EAAEA,MAAMrB,gDAAe0B,SAAS;IACtC6C,SAASV,OAAOU;IAChB8C,MAAM;KACJ7F,OAAOqC,OAAOrC;KACduC,OAAOF,OAAOE,MACX5B,QAAO4B,UAASA,MAAMT,SAAS,EAAE,CACjCT,KAAIkB,iEAAsBA,MAAM,CAAC;KACpCuD,QAAQ;KACV;IACD,CAAC;IACF;AAGN,MACET,OAAOC,OAAO5B,KAAKzC,KAAK0C,WAAW,CAAChD,QAAO0B,WAAUA,OAAOS,QAAQ,MAAM,CACvEhB,SAAS,EAEZuD,QAAOC,OAAO5B,KAAKzC,KAAK0C,WAAW,CAChChD,QAAO0B,WAAUA,OAAOS,QAAQ,MAAM,CACtCyC,SAAQlD,WACP9B,QAAQuC,IAAI0C,MAAM1C,IAAI2C,YAAY;GAChC1F,6DAAmBsC,OAAOtC,KAAK;GAC/BD,UAAUuC,OAAOvC,WAAW,OAAO4F;GACnCjD,aAAaJ,OAAOI;GACpBkD,YAAYlH,sDAAqBmH;GACjC3C,MAAMZ,OAAOW,WACT;IACEnD,MAAMrB,gDAAe2B;IACrB8C,MAAM,EAAEpD,MAAMrB,gDAAe0E,QAAO;IACrC,GACD,EAAErD,MAAMrB,gDAAe0E,QAAQ;GACnCH,SAASV,OAAOU;GAChB8C,MAAM,EACJC,QAAQ,OACV;GACD,CACH,CAAC;;AAIP,MAAK,MAAMhC,SAASvD,QAAQwF,OAAOpF,QACjCmD,YACEA,QAAM7C,KAAK+D,SAASrE,QAAO0C,YAAW,CAAC3D,+DAA0B2D,QAAQ,CAAC,CACvEvB,WACDG,QAAQhB,KAAK+D,SAASrE,QACpB0C,YAAW,CAAC3D,+DAA0B2D,QACxC,CAAC,CAACvB,SACA,KACJgC,QAAM7C,KAAK+D,SACRgB,MAAM,GAAG/D,QAAQhB,KAAK+D,SAASlD,OAAO,CACtCmE,OAAOC,OAAOf,UAAUe,UAAUjE,QAAQhB,KAAK+D,SAASG,OAC/D,CAAC,CACCzB,MAAKG,SAASC,MAAM/D,QAAQ,MAAMuD,mBAAmB/C,SAASuD,OAAOJ,KAAK;AAG5E,QAAOA"}

package/dist/helpers/resolve-command.mjs

@@ -1,5 +1,6 @@
-import { getAppTitle, getVariableCommandPathName, isVariableCommandPath } from "../plugin-utils/context-helpers.mjs";
+import { getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption } from "../plugin-utils/context-helpers.mjs";
 import { getDefaultOptions } from "./utilities.mjs";
+import { toArray } from "@stryke/convert/to-array";
 import { appendPath } from "@stryke/path/append";
 import { findFilePath, findFolderName } from "@stryke/path/file-path-fns";
 import { replacePath } from "@stryke/path/replace";
@@ -8,23 +9,28 @@ import { constantCase } from "@stryke/string-format/constant-case";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { titleCase } from "@stryke/string-format/title-case";
-import { ReflectionClass, ReflectionKind, ReflectionVisibility, stringifyType } from "@powerlines/deepkit/vendor/type";
-import { reflectType } from "@powerlines/deepkit/reflect-type";
+import { ReflectionClass, ReflectionKind, ReflectionVisibility, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
+import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
 import { commonPath } from "@stryke/path/common";
 import { stripStars } from "@stryke/path/normalize";
+import { resolveModule } from "powerlines/lib/utilities/resolve";
 
 //#region src/helpers/resolve-command.ts
 /**
 * Resolves the description for a command option based on its reflection.
 *
-* @param propertyReflection - The reflection property of the command option.
+* @param kind - The reflection kind of the command option.
+* @param optional - Whether the command option is optional.
+* @param name - The name of the command option.
+* @param title - The title of the command option, if any.
+* @param defaultValue - The default value of the command option, if any.
 * @returns The resolved description for the command option.
 */
-function resolveCommandDescription(propertyReflection) {
-	return propertyReflection.getDescription()?.trim() || `A${propertyReflection.isOptional() && !propertyReflection.getDefaultValue() ? "n optional" : ""} ${propertyReflection.getType().kind === ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${propertyReflection.getType().kind === ReflectionKind.boolean ? "set the" : propertyReflection.getType().kind === ReflectionKind.array ? "specify custom" : "specify a custom"} ${propertyReflection.getTags().title?.trim() || titleCase(propertyReflection.getNameAsString())} ${propertyReflection.getType().kind === ReflectionKind.boolean ? "indicator" : `${propertyReflection.getType().kind === ReflectionKind.number ? "numeric" : "string"} value${propertyReflection.getType().kind === ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
+function resolveCommandOptionDescription(kind, optional, name, title, defaultValue) {
+	return `A${optional && !defaultValue ? "n optional" : ""} ${kind === ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${kind === ReflectionKind.boolean ? "set the" : kind === ReflectionKind.array ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === ReflectionKind.boolean ? "indicator" : `${kind === ReflectionKind.number ? "numeric" : "string"} value${kind === ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
 }
 function resolveCommandId(context, file) {
-	return replacePath(findFilePath(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !isVariableCommandPath(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
+	return replacePath(findFilePath(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !isPositionalCommandOption(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
 }
 /**
 * Finds the command name from the given file path.
@@ -35,7 +41,7 @@ function resolveCommandId(context, file) {
 function resolveCommandName(file) {
 	let path = findFilePath(file);
 	let name = findFolderName(file, { requireExtension: true });
-	while (isVariableCommandPath(name)) {
+	while (isPositionalCommandOption(name)) {
 		path = resolveParentPath(path);
 		name = findFolderName(path, { requireExtension: true });
 	}
@@ -53,17 +59,56 @@ function findCommandsRoot(context) {
 /**
 * Extracts command parameter information from a type parameter reflection.
 *
-* @param param - The type parameter reflection to extract information from.
-* @returns The extracted command parameter information.
+* @param command - The command tree to which the parameter belongs.
+* @param reflection - The type parameter reflection to extract information from.
+* @returns The extracted command option information.
 */
-function extractCommandParameters(param) {
-	return {
-		name: param.name,
-		description: param.description,
-		optional: !!param.optional,
-		variadic: param.type.kind === ReflectionKind.array,
-		default: param.default
+function extractCommandOption(command, reflection) {
+	const propertyType = reflection.getType();
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim() || titleCase(reflection.getNameAsString()),
+		description: reflection.getDescription() || resolveCommandOptionDescription(reflection.getKind(), reflection.isOptional(), reflection.getNameAsString(), reflection.getTags().title, reflection.getDefaultValue()),
+		env: constantCase(reflection.getNameAsString()),
+		kind: propertyType.kind,
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: false
 	};
+	if (propertyType.kind === ReflectionKind.array) if (propertyType.type.kind === ReflectionKind.string || propertyType.type.kind === ReflectionKind.number) {
+		option.variadic = true;
+		option.kind = propertyType.type.kind;
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${command.name}". Only string[] and number[] are supported.`);
+	else if (propertyType.kind !== ReflectionKind.boolean && propertyType.kind !== ReflectionKind.string && propertyType.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(propertyType).trim().replaceAll(" | ", ", or ")}.`);
+	return option;
+}
+/**
+* Extracts command parameter information from a type parameter reflection.
+*
+* @param command - The command tree to which the parameter belongs.
+* @param segment - The command path segment corresponding to the parameter.
+* @param reflection - The type parameter reflection to extract information from.
+* @returns The extracted command option information.
+*/
+function extractCommandPositionalOption(command, segment, reflection) {
+	if (reflection.type.kind !== ReflectionKind.string && reflection.type.kind !== ReflectionKind.number && !(reflection.type.kind === ReflectionKind.array && (reflection.type.type.kind === ReflectionKind.string || reflection.type.type.kind === ReflectionKind.number))) throw new Error(`Unsupported type for positional option "${segment}" in command "${command.name}". Only string and number types (or string[] and number[]) are supported, received ${stringifyType(reflection.type).trim().replaceAll(" | ", ", or ")}.`);
+	const option = {
+		name: segment,
+		alias: [],
+		title: titleCase(segment),
+		description: reflection.description || resolveCommandOptionDescription(reflection.type.kind, !!reflection.optional, segment, titleCase(segment), reflection.default),
+		env: constantCase(segment),
+		kind: reflection.type.kind,
+		optional: reflection.optional,
+		default: reflection.default,
+		variadic: false
+	};
+	if (reflection.type.kind === ReflectionKind.array) if (reflection.type.type.kind === ReflectionKind.string || reflection.type.type.kind === ReflectionKind.number) {
+		option.variadic = true;
+		option.kind = reflection.type.type.kind;
+	} else throw new Error(`Unsupported array type for option "${segment}" in command "${command.name}". Only string[] and number[] are supported.`);
+	return option;
 }
 /**
 * Reflects the command tree for a given command input.
@@ -76,59 +121,46 @@ function extractCommandParameters(param) {
 async function reflectCommandTree(context, command, parent) {
 	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, "") : parent.title} - ` : ""}${titleCase(command.name)}${command.isVirtual ? " Commands" : ""}`;
 	const tree = {
+		alias: [],
 		...command,
 		title,
-		description: command.description || (command.isVirtual ? `A collection of available ${command.title || titleCase(command.name)} commands that are included in the ${getAppTitle(context)} command-line application.` : `The ${title} executable command-line interface.`),
 		path: {
 			...command.path,
-			variables: {}
+			positional: {}
 		},
 		options: getDefaultOptions(context, command),
-		params: [],
 		parent: parent ?? null,
 		children: {}
 	};
 	if (!command.isVirtual) {
 		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
 		context.debug(`Adding reflection for user-defined command: ${command.id} (file: ${command.entry.input.file})`);
-		const type = await reflectType(context, command.entry.input);
+		const resolved = await resolveModule(context, command.entry.input, { plugins: [esbuildPlugin(context, {
+			reflection: "default",
+			reflectionLevel: "verbose"
+		})] });
+		const metadata = resolved.metadata ?? {};
+		if (isSetString(metadata.title)) tree.title = metadata.title;
+		if (isSetString(metadata.description)) tree.description = metadata.description;
+		if (isSetString(metadata.alias) || Array.isArray(metadata.alias) && metadata.alias.length > 0) tree.alias = toArray(metadata.alias);
+		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.description ??= command.description || type.description || `The ${tree.title} executable command-line interface.`;
 		if (type.parameters.length > 0 && type.parameters[0]) {
 			const firstParam = type.parameters[0];
 			if (firstParam.type.kind === ReflectionKind.objectLiteral || firstParam.type.kind === ReflectionKind.class) {
 				const optionsReflection = ReflectionClass.from(firstParam.type);
-				for (const propertyReflection of optionsReflection.getProperties()) {
-					const propertyType = propertyReflection.getType();
-					tree.options[propertyReflection.getNameAsString()] = {
-						name: propertyReflection.getNameAsString(),
-						alias: propertyReflection.getTags().alias ?? [],
-						title: propertyReflection.getTags().title?.trim() || titleCase(propertyReflection.getNameAsString()),
-						description: resolveCommandDescription(propertyReflection),
-						env: constantCase(propertyReflection.getNameAsString()),
-						kind: propertyType.kind,
-						optional: propertyReflection.isOptional(),
-						default: propertyReflection.getDefaultValue(),
-						variadic: false
-					};
-					if (propertyType.kind === ReflectionKind.array) if (propertyType.type.kind === ReflectionKind.string || propertyType.type.kind === ReflectionKind.number) {
-						tree.options[propertyReflection.getNameAsString()].variadic = true;
-						tree.options[propertyReflection.getNameAsString()].kind = propertyType.type.kind;
-					} else throw new Error(`Unsupported array type for option "${propertyReflection.getNameAsString()}" in command "${command.name}". Only string[] and number[] are supported.`);
-					else if (propertyType.kind !== ReflectionKind.boolean && propertyType.kind !== ReflectionKind.string && propertyType.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${propertyReflection.getNameAsString()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(propertyType).trim().replaceAll(" | ", ", or ")}.`);
-				}
+				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
 			}
-			tree.path.variables = tree.path.segments.filter((segment) => isVariableCommandPath(segment)).reduce((obj, segment, index) => {
+			tree.path.positional = tree.path.segments.filter((segment) => isPositionalCommandOption(segment)).reduce((obj, segment, index) => {
 				if (type.parameters.length < index + 2 || !type.parameters[index + 1]) return obj;
-				const paramName = getVariableCommandPathName(segment);
-				obj[paramName] = extractCommandParameters(type.parameters[index + 1]);
-				obj[paramName].description = obj[paramName].description || `The ${paramName} variable for the ${command.name} command.`;
+				const paramName = getPositionalCommandOptionName(segment);
+				obj[paramName] = extractCommandPositionalOption(command, paramName, type.parameters[index + 1]);
+				obj[paramName].description = obj[paramName].description || `The ${paramName} positional option for the ${command.name} command.`;
 				return obj;
 			}, {});
-			if (type.parameters.length > 1) type.parameters.slice(tree.path.segments.filter((segment) => isVariableCommandPath(segment)).length + 1).forEach((param) => {
-				tree.params.push(extractCommandParameters(param));
-			});
 		}
-	}
+	} else tree.description ??= `A collection of available ${tree.title || 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({
@@ -148,22 +180,20 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		});
-		if (tree.params) tree.params.forEach((param) => {
-			context.env.types.env.addProperty({
-				name: constantCase(param.name),
-				optional: param.optional ? true : void 0,
-				description: param.description,
-				visibility: ReflectionVisibility.public,
-				type: param.variadic ? {
-					kind: ReflectionKind.array,
-					type: { kind: ReflectionKind.string }
-				} : { kind: ReflectionKind.string },
-				default: param.default,
-				tags: { domain: "cli" }
-			});
-		});
+		if (Object.values(tree.path.positional).filter((option) => option.env !== false).length > 0) Object.values(tree.path.positional).filter((option) => option.env !== false).forEach((option) => context.env.types.env.addProperty({
+			name: constantCase(option.name),
+			optional: option.optional ? true : void 0,
+			description: option.description,
+			visibility: ReflectionVisibility.public,
+			type: option.variadic ? {
+				kind: ReflectionKind.array,
+				type: { kind: ReflectionKind.string }
+			} : { kind: ReflectionKind.string },
+			default: option.default,
+			tags: { domain: "cli" }
+		}));
 	}
-	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !isVariableCommandPath(segment)).length === command.path.segments.filter((segment) => !isVariableCommandPath(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
+	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !isPositionalCommandOption(segment)).length === command.path.segments.filter((segment) => !isPositionalCommandOption(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
 	return tree;
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-command.mjs","names":["reflectType","ReflectionClass","ReflectionKind","ReflectionVisibility","stringifyType","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","getAppTitle","getVariableCommandPathName","isVariableCommandPath","getDefaultOptions","resolveCommandDescription","propertyReflection","getDescription","trim","isOptional","getDefaultValue","getType","kind","boolean","array","getTags","title","getNameAsString","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","name","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandParameters","param","description","optional","variadic","type","default","reflectCommandTree","command","parent","isVirtual","replace","tree","variables","options","params","children","input","fs","existsSync","Error","debug","id","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","getProperties","propertyType","alias","env","string","segments","segment","reduce","obj","index","paramName","slice","forEach","push","Object","values","option","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 { reflectType } from \"@powerlines/deepkit/reflect-type\";\nimport type {\n  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\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 {\n  getAppTitle,\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandParam,\n  CommandTree,\n  NumberCommandOption,\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 propertyReflection - The reflection property of the command option.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandDescription(\n  propertyReflection: ReflectionProperty\n): string {\n  return (\n    propertyReflection.getDescription()?.trim() ||\n    `A${\n      propertyReflection.isOptional() && !propertyReflection.getDefaultValue()\n        ? \"n optional\"\n        : \"\"\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"flag provided via the command-line\"\n        : \"command-line option\"\n    } that allows the user to ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"set the\"\n        : propertyReflection.getType().kind === ReflectionKind.array\n          ? \"specify custom\"\n          : \"specify a custom\"\n    } ${\n      propertyReflection.getTags().title?.trim() ||\n      titleCase(propertyReflection.getNameAsString())\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"indicator\"\n        : `${propertyReflection.getType().kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n            propertyReflection.getType().kind === ReflectionKind.array\n              ? \"s\"\n              : \"\"\n          }`\n    } that will be used in the application.`\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) && !isVariableCommandPath(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 (isVariableCommandPath(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}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isVariableCommandPath(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\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 param - The type parameter reflection to extract information from.\n * @returns The extracted command parameter information.\n */\nexport function extractCommandParameters(param: TypeParameter): CommandParam {\n  return {\n    name: param.name,\n    description: param.description,\n    optional: !!param.optional,\n    variadic: param.type.kind === ReflectionKind.array,\n    default: param.default\n  } as CommandParam;\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    `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, \"\") : parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    ...command,\n    title,\n    description:\n      command.description ||\n      (command.isVirtual\n        ? `A collection of available ${command.title || titleCase(command.name)} commands that are included in the ${getAppTitle(\n            context\n          )} command-line application.`\n        : `The ${title} executable command-line interface.`),\n    path: {\n      ...command.path,\n      variables: {}\n    },\n    options: getDefaultOptions(context, command),\n    params: [],\n    parent: parent ?? null,\n    children: {}\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 type = await reflectType<TContext>(context, command.entry.input);\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    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          const propertyType = propertyReflection.getType();\n\n          tree.options[propertyReflection.getNameAsString()] = {\n            name: propertyReflection.getNameAsString(),\n            alias: propertyReflection.getTags().alias ?? [],\n            title:\n              propertyReflection.getTags().title?.trim() ||\n              titleCase(propertyReflection.getNameAsString()),\n            description: resolveCommandDescription(propertyReflection),\n            env: constantCase(propertyReflection.getNameAsString()),\n            kind: propertyType.kind as\n              | ReflectionKind.string\n              | ReflectionKind.number\n              | ReflectionKind.boolean,\n            optional: propertyReflection.isOptional(),\n            default: propertyReflection.getDefaultValue(),\n            variadic: false\n          };\n          if (propertyType.kind === ReflectionKind.array) {\n            if (\n              propertyType.type.kind === ReflectionKind.string ||\n              propertyType.type.kind === ReflectionKind.number\n            ) {\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).variadic = true;\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).kind = propertyType.type.kind;\n            } else {\n              throw new Error(\n                `Unsupported array type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                  command.name\n                }\". Only string[] and number[] are supported.`\n              );\n            }\n          } else if (\n            propertyType.kind !== ReflectionKind.boolean &&\n            propertyType.kind !== ReflectionKind.string &&\n            propertyType.kind !== ReflectionKind.number\n          ) {\n            throw new Error(\n              `Unsupported type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                command.name\n              }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n                propertyType\n              )\n                .trim()\n                .replaceAll(\" | \", \", or \")}.`\n            );\n          }\n        }\n      }\n\n      tree.path.variables = tree.path.segments\n        .filter(segment => isVariableCommandPath(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getVariableCommandPathName(segment);\n            obj[paramName] = extractCommandParameters(\n              type.parameters[index + 1]!\n            );\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} variable for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandParam>\n        );\n\n      if (type.parameters.length > 1) {\n        type.parameters\n          .slice(\n            tree.path.segments.filter(segment => isVariableCommandPath(segment))\n              .length + 1\n          )\n          .forEach(param => {\n            tree.params.push(extractCommandParameters(param));\n          });\n      }\n    }\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.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (tree.params) {\n      tree.params.forEach(param => {\n        context.env.types.env.addProperty({\n          name: constantCase(param.name),\n          optional: param.optional ? true : undefined,\n          description: param.description,\n          visibility: ReflectionVisibility.public,\n          type: param.variadic\n            ? {\n                kind: ReflectionKind.array,\n                type: { kind: ReflectionKind.string }\n              }\n            : { kind: ReflectionKind.string },\n          default: param.default,\n          tags: {\n            domain: \"cli\"\n          }\n        });\n      });\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isVariableCommandPath(segment))\n        .length ===\n        command.path.segments.filter(segment => !isVariableCommandPath(segment))\n          .length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.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","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","getDefaultOptions","resolveCommandOptionDescription","kind","optional","name","title","defaultValue","boolean","array","trim","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandOption","command","reflection","propertyType","getType","option","getNameAsString","alias","getTags","description","getDescription","getKind","isOptional","getDefaultValue","env","default","variadic","type","string","Error","extractCommandPositionalOption","segment","reflectCommandTree","parent","isVirtual","replace","tree","positional","options","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","segments","reduce","obj","index","paramName","Object","values","forEach","types","addProperty","undefined","visibility","public","tags","domain","inputs","slice","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  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\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  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandPositionalOption,\n  CommandTree,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param name - The name of the command option.\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  kind: ReflectionKind,\n  optional: boolean,\n  name: string,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} ${\n    kind === ReflectionKind.boolean\n      ? \"flag provided via the command-line\"\n      : \"command-line option\"\n  } that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : kind === ReflectionKind.array\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          kind === ReflectionKind.array ? \"s\" : \"\"\n        }`\n  } that will be used in the application.`;\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isPositionalCommandOption(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 (isPositionalCommandOption(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}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isPositionalCommandOption(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\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 propertyType = reflection.getType();\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title:\n      reflection.getTags().title?.trim() ||\n      titleCase(reflection.getNameAsString()),\n    description:\n      reflection.getDescription() ||\n      resolveCommandOptionDescription(\n        reflection.getKind(),\n        reflection.isOptional(),\n        reflection.getNameAsString(),\n        reflection.getTags().title,\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getNameAsString()),\n    kind: propertyType.kind as\n      | ReflectionKind.string\n      | ReflectionKind.number\n      | ReflectionKind.boolean,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: false\n  } as CommandOption;\n  if (propertyType.kind === ReflectionKind.array) {\n    if (\n      propertyType.type.kind === ReflectionKind.string ||\n      propertyType.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        propertyType.type.kind;\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.`\n      );\n    }\n  } else if (\n    propertyType.kind !== ReflectionKind.boolean &&\n    propertyType.kind !== ReflectionKind.string &&\n    propertyType.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        propertyType\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\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 segment - The command path segment corresponding to the parameter.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandPositionalOption(\n  command: CommandInput,\n  segment: string,\n  reflection: TypeParameter\n): CommandPositionalOption {\n  if (\n    reflection.type.kind !== ReflectionKind.string &&\n    reflection.type.kind !== ReflectionKind.number &&\n    !(\n      reflection.type.kind === ReflectionKind.array &&\n      (reflection.type.type.kind === ReflectionKind.string ||\n        reflection.type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for positional option \"${segment}\" in command \"${\n        command.name\n      }\". Only string and number types (or string[] and number[]) are supported, received ${stringifyType(\n        reflection.type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const option = {\n    name: segment,\n    alias: [],\n    title: titleCase(segment),\n    description:\n      reflection.description ||\n      resolveCommandOptionDescription(\n        reflection.type.kind,\n        !!reflection.optional,\n        segment,\n        titleCase(segment),\n        reflection.default\n      ),\n    env: constantCase(segment),\n    kind: reflection.type.kind,\n    optional: reflection.optional,\n    default: reflection.default,\n    variadic: false\n  } as CommandPositionalOption;\n\n  if (reflection.type.kind === ReflectionKind.array) {\n    if (\n      reflection.type.type.kind === ReflectionKind.string ||\n      reflection.type.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        reflection.type.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${segment}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported.`\n      );\n    }\n  }\n\n  return option;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, \"\") : parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    alias: [],\n    ...command,\n    title,\n    path: {\n      ...command.path,\n      positional: {}\n    },\n    options: getDefaultOptions(context, command),\n    parent: parent ?? null,\n    children: {}\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\n    const type = reflect(resolved);\n\n    // const type = await reflectType<TContext>(context, command.entry.input);\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.description ??=\n      command.description ||\n      type.description ||\n      `The ${tree.title} executable command-line interface.`;\n\n    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          tree.options[propertyReflection.getNameAsString()] =\n            extractCommandOption(command, propertyReflection);\n        }\n      }\n\n      tree.path.positional = tree.path.segments\n        .filter(segment => isPositionalCommandOption(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getPositionalCommandOptionName(segment);\n            obj[paramName] = extractCommandPositionalOption(\n              command,\n              paramName,\n              type.parameters[index + 1]!\n            );\n\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} positional option for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandPositionalOption>\n        );\n    }\n  } else {\n    tree.description ??= `A collection of available ${\n      tree.title || titleCase(tree.name)\n    } commands that are included in the ${getAppTitle(\n      context\n    )} command-line application.`;\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type:\n              option.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (\n      Object.values(tree.path.positional).filter(option => option.env !== false)\n        .length > 0\n    ) {\n      Object.values(tree.path.positional)\n        .filter(option => option.env !== false)\n        .forEach(option =>\n          context.env.types.env.addProperty({\n            name: constantCase(option.name),\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: option.variadic\n              ? {\n                  kind: ReflectionKind.array,\n                  type: { kind: ReflectionKind.string }\n                }\n              : { kind: ReflectionKind.string },\n            default: option.default,\n            tags: {\n              domain: \"cli\"\n            }\n          })\n        );\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isPositionalCommandOption(segment))\n        .length ===\n        command.path.segments.filter(\n          segment => !isPositionalCommandOption(segment)\n        ).length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.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/validations.cjs

@@ -1,35 +1,35 @@
 const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
 
 //#region src/helpers/validations.ts
-function validateCommandVariablePaths(command) {
+function validateCommandPositionalOptions(command) {
 	const failures = [];
 	if (!command.isVirtual && command.path.segments.length > 0) {
-		const variablePathNames = /* @__PURE__ */ new Set();
-		for (const segment of command.path.segments.filter(require_plugin_utils_context_helpers.isVariableCommandPath) ?? []) {
-			if (variablePathNames.has(segment)) failures.push({
-				code: "DUPLICATE_VARIABLE_PATH_NAME",
-				details: `Duplicate variable path name "${require_plugin_utils_context_helpers.getVariableCommandPathName(segment)}" found in command.`
+		const positionalOptionPathNames = /* @__PURE__ */ new Set();
+		for (const segment of command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption) ?? []) {
+			if (positionalOptionPathNames.has(segment)) failures.push({
+				code: "DUPLICATE_POSITIONAL_OPTION_PATH_NAME",
+				details: `Duplicate positional option path name "${require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)}" found in command.`
 			});
-			variablePathNames.add(require_plugin_utils_context_helpers.getVariableCommandPathName(segment));
+			positionalOptionPathNames.add(require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment));
 		}
-		if (command.path.segments.filter(require_plugin_utils_context_helpers.isVariableCommandPath).length !== Object.keys(command.path.variables ?? {}).length) failures.push({
-			code: "VARIABLE_PATH_MISMATCH",
-			details: `Mismatch between variable path segments and defined path variables in command (found ${command.path.segments.filter(require_plugin_utils_context_helpers.isVariableCommandPath).length} variables in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.variables ?? {}).length} potential variable path(s) could be determined from the command's function signature).`
+		if (command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).length !== Object.keys(command.path.positional ?? {}).length) failures.push({
+			code: "POSITIONAL_OPTION_PATH_MISMATCH",
+			details: `Mismatch between positional options path segments and defined path positional options in command (found ${command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).length} positional options in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.positional ?? {}).length} potential positional option path(s) could be determined from the command's function signature).`
 		});
-		const missing = command.path.segments.filter(require_plugin_utils_context_helpers.isVariableCommandPath).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.variables ?? {}, require_plugin_utils_context_helpers.getVariableCommandPathName(segment)) === false);
+		const missing = command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.positional ?? {}, require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)) === false);
 		if (missing.length > 0) failures.push({
-			code: "MISSING_VARIABLE_PATH",
-			details: `${missing.length} variable path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path variables: \n- ${missing.map((segment) => `"${require_plugin_utils_context_helpers.getVariableCommandPathName(segment)}"`).join("\n- ")}`
+			code: "MISSING_POSITIONAL_OPTION_PATH",
+			details: `${missing.length} positional option path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path positional options: \n- ${missing.map((segment) => `"${require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)}"`).join("\n- ")}`
 		});
 		else {
-			for (const varName of Object.keys(command.path.variables ?? {})) if (!command.path.segments.filter(require_plugin_utils_context_helpers.isVariableCommandPath).find((segment) => require_plugin_utils_context_helpers.getVariableCommandPathName(segment) === varName)) failures.push({
-				code: "UNUSED_VARIABLE_PATH",
-				details: `The variable path name "${varName}" defined in the command's path variables is not used in the command folder path "${command.path.segments.join("/")}".`
+			for (const varName of Object.keys(command.path.positional ?? {})) if (!command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).find((segment) => require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment) === varName)) failures.push({
+				code: "UNUSED_POSITIONAL_OPTION_PATH",
+				details: `The positional option path name "${varName}" defined in the command's path positional options is not used in the command folder path "${command.path.segments.join("/")}".`
 			});
 			command.path.segments.forEach((segment, index) => {
-				if (require_plugin_utils_context_helpers.isVariableCommandPath(segment) && command.path.variables[require_plugin_utils_context_helpers.getVariableCommandPathName(segment)]?.variadic === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.variables[require_plugin_utils_context_helpers.getVariableCommandPathName(command.path.segments[index + 1])]?.variadic === true) failures.push({
-					code: "MULTIPLE_VARIADIC_VARIABLE_PATHS",
-					details: `The variable path segment "${require_plugin_utils_context_helpers.getVariableCommandPathName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as variadic, and it is followed by another variadic variable path segment "${require_plugin_utils_context_helpers.getVariableCommandPathName(command.path.segments[index + 1])}". Only one variadic variable path segment is allowed per command, and it must be the final path segment.`
+				if (require_plugin_utils_context_helpers.isPositionalCommandOption(segment) && command.path.positional[require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)]?.variadic === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.positional[require_plugin_utils_context_helpers.getPositionalCommandOptionName(command.path.segments[index + 1])]?.variadic === true) failures.push({
+					code: "MULTIPLE_VARIADIC_POSITIONAL_OPTION_PATHS",
+					details: `The positional option path segment "${require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as variadic, and it is followed by another variadic positional option path segment "${require_plugin_utils_context_helpers.getPositionalCommandOptionName(command.path.segments[index + 1])}". Only one variadic positional option path segment is allowed per command, and it must be the final path segment.`
 				});
 			});
 		}
@@ -55,37 +55,9 @@ function validateCommandOptions(command) {
 	}
 	return failures;
 }
-function validateCommandParams(command) {
-	const failures = [];
-	if (!command.isVirtual && command.params.length > 0) {
-		const paramNames = /* @__PURE__ */ new Set();
-		command.params.forEach((param, index) => {
-			if (paramNames.has(param.name)) failures.push({
-				code: "DUPLICATE_PARAM_NAME",
-				details: `Duplicate parameter name "${param.name}" found in command.`
-			});
-			paramNames.add(param.name);
-			if (param.optional) command.params.slice(index + 1).forEach((nextParam) => {
-				if (nextParam.optional && !nextParam.default) failures.push({
-					code: "OPTIONAL_PARAM_NOT_LAST",
-					details: `The parameter "${nextParam.name}" in the command at path "${command.path.segments.join("/")}" is required, but it follows an optional parameter "${param.name}". All required parameters must come before any optional parameters.`
-				});
-			});
-			if (param.variadic && index + 1 < command.params.length) {
-				if (command.params[index + 1]?.variadic) failures.push({
-					code: "MULTIPLE_VARIADIC_PARAMS",
-					details: `The parameter "${param.name}" in the command at path "${command.path.segments.join("/")}" is variadic, and it is followed by another variadic parameter "${command.params[index + 1]?.name}". Only one variadic parameter is allowed per command, and it must be the final parameter.`
-				});
-			}
-		});
-	}
-	return failures;
-}
 function validateCommand(command) {
 	const results = [];
-	let failures = validateCommandVariablePaths(command);
-	if (failures.length > 0) results.push(...failures);
-	failures = validateCommandParams(command);
+	let failures = validateCommandPositionalOptions(command);
 	if (failures.length > 0) results.push(...failures);
 	failures = validateCommandOptions(command);
 	if (failures.length > 0) results.push(...failures);