@shell-shock/core 0.9.7 → 0.10.0

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

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

package/dist/helpers/resolve-command.mjs

@@ -3,17 +3,20 @@ 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 { joinPaths } from "@stryke/path/join-paths";
 import { replacePath } from "@stryke/path/replace";
 import { resolveParentPath } from "@stryke/path/resolve-parent-path";
 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 { isTypeDefinition } from "powerlines/utils";
 import { titleCase } from "@stryke/string-format/title-case";
 import { ReflectionClass, ReflectionFunction, ReflectionKind, ReflectionVisibility, __ΩReflectionKind, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
 import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
+import { resolveModule } from "@powerlines/plugin-esbuild/helpers/resolve";
 import { commonPath } from "@stryke/path/common";
 import { stripStars } from "@stryke/path/normalize";
-import { resolveModule } from "powerlines/lib/utilities/resolve";
+import { existsSync } from "node:fs";
 
 //#region src/helpers/resolve-command.ts
 function __assignType(fn, args) {
@@ -137,14 +140,31 @@ resolveCommandDynamicPathSegments.__type = [
 	"P\"w!2\"&2#&F/$"
 ];
 function findCommandsRoot(context) {
-	if (isSetString(context.config.entry)) return appendPath(appendPath(stripStars(context.config.entry), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
-	else if (isSetObject(context.config.entry) && "file" in context.config.entry) return appendPath(appendPath(stripStars(context.config.entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
-	else if (Array.isArray(context.config.entry) && context.config.entry.length > 0) return commonPath(context.config.entry.map(__assignType((entry) => appendPath(appendPath(stripStars(isSetString(entry) ? entry : entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot), [
-		"entry",
+	if (isSetString(context.config.input)) return appendPath(appendPath(stripStars(context.config.input), context.config.root), context.workspaceConfig.workspaceRoot);
+	else if (isTypeDefinition(context.config.input)) return appendPath(appendPath(stripStars(context.config.input.file), context.config.root), context.workspaceConfig.workspaceRoot);
+	else if (Array.isArray(context.config.input) && context.config.input.length > 0) return commonPath(context.config.input.map(__assignType((input) => appendPath(appendPath(stripStars(isSetString(input) ? input : input.file), context.config.root), context.workspaceConfig.workspaceRoot), [
+		"input",
 		"",
 		"P\"2!\"/\""
 	])));
-	return appendPath(context.config.sourceRoot || context.config.projectRoot, context.workspaceConfig.workspaceRoot);
+	else if (isSetObject(context.config.input)) return commonPath(Object.values(context.config.input).map(__assignType((input) => Array.isArray(input) ? commonPath(input.map(__assignType((i) => appendPath(appendPath(stripStars(isSetString(i) ? i : i.file), context.config.root), context.workspaceConfig.workspaceRoot), [
+		"i",
+		"",
+		"P\"2!\"/\""
+	]))) : appendPath(appendPath(stripStars(isSetString(input) ? input : input.file), context.config.root), context.workspaceConfig.workspaceRoot), [
+		"input",
+		"",
+		"P\"2!\"/\""
+	])));
+	let commandsPath = joinPaths(context.config.root, "src/commands");
+	if (!existsSync(commandsPath)) {
+		commandsPath = joinPaths(context.config.root, "commands");
+		if (!existsSync(commandsPath)) {
+			commandsPath = joinPaths(context.config.root, "src");
+			if (!existsSync(commandsPath)) commandsPath = context.config.root;
+		}
+	}
+	return appendPath(commandsPath, context.workspaceConfig.workspaceRoot);
 }
 findCommandsRoot.__type = [
 	"Context",

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

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

package/dist/helpers/update-package-json.cjs

@@ -21,7 +21,7 @@ formatBinaryPath.__type = [
 	"PP&&F-J2!&/\""
 ];
 async function updatePackageJsonBinary(context) {
-	const packageJsonPath = (0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.projectRoot, "package.json");
+	const packageJsonPath = (0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.root, "package.json");
 	if (context.config.bin && Array.isArray(context.config.bin) && context.config.bin.length > 0) {
 		context.packageJson.bin = Object.fromEntries((0, __stryke_helpers_get_unique.getUnique)((0, __stryke_convert_to_array.toArray)(context.config.bin)).map(__assignType((bin) => [bin, formatBinaryPath(context.config.output.format)], [
 			"bin",

package/dist/helpers/update-package-json.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-package-json.cjs","names":[],"sources":["../../src/helpers/update-package-json.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.projectRoot,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.\"\n    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AA0BX,SAAgB,iBAAiB,QAAK;AAClC,QAAM,cAAA,WAAA,SAAA,MAAA,QAAA,OAAA,IAAA,OAAA,SAAA,MAAA,GACA,QACA;;AAEV,iBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;AACZ,eAAI,wBAAA,SAAA;CACJ,MAAA,0DAAA,QAAA,gBAAA,eAAA,QAAA,OAAA,aAAA,eAAA;2BAEQ,MAAM,QAAQ,QAAQ,OAAO,IAAI,IACjC,QAAQ,OAAO,IAAI,SAAA,GAAA;AACnB,UAAQ,YAAC,MAAA,OAAA,8FAAA,QAAA,OAAA,IAAA,CAAA,CAAA,IAAA,cAAA,QAAA,CACL,KACA,iBAAiB,QAAQ,OAAI,OAAA,OAAA,CAChC,EAAE;GAAC;GAAO;GAAI;GAAO,CAAA,CAAA,CAAA;AACtB,QAAM,QAAG,GAAA,MAAA,iBAAA,mCAAA,UAAA,QAAA,YAAA,CAAA;QAEZ;AACG,MAAI,MAAM,QAAM,QAAA,OAAA,OAAA,OAAA,IACZ,QAAQ,OAAO,OAAO,OAAK,SAAA,GAAA;AAC3B,WAAQ,YAAY,MAAA,oDAC5B,gDAAA,QAAA,CAAA,GAAA,wDAAA,QAAA,OAAA,OAAA,OAAA,CAAA,GAAA,EACS;AACD,WAAQ,YAAY,6CAAc,QAAQ,OAAE,OAAA,OAAA,CAAA,OAAA,cAAA,KAAA,WAAA;AAC7C,QAAA,oDAAA,gDAAA,QAAA,CAAA,CAAA,GAAA,YACS,iBAAiB,OAAO;AACrC,WAAA;MACF;IAAA;IAAA;IAAA;IAAA;IAAA,CAAA,EAAA,QAAA,YAAA,IAAA;QAGO,SAAQ,YAAC,MAAA,oDACM,gDAAW,QAAO,CAAA,GAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,EACxC;AAEE,QAAA,QAAA,GAAA,MAAA,iBAAA,mCAAA,UAAA,QAAA,YAAA,CAAA;;AAEH,KAAI,qDAAa,QAAQ,YAAY,IAAG,CACtC,OAAA,IAAA,MAAA,0KAAA;AAEF,SAAQ,OAAO,MAAM,OAAO,KAAK,QAAQ,YAAY,IAAC;;AAE1D,wBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"update-package-json.cjs","names":[],"sources":["../../src/helpers/update-package-json.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.\"\n    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AA0BX,SAAgB,iBAAiB,QAAK;AAClC,QAAM,cAAA,WAAA,SAAA,MAAA,QAAA,OAAA,IAAA,OAAA,SAAA,MAAA,GACA,QACA;;AAEV,iBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;AACZ,eAAI,wBAAA,SAAA;CACJ,MAAA,0DAAA,QAAA,gBAAA,eAAA,QAAA,OAAA,MAAA,eAAA;2BAEQ,MAAM,QAAQ,QAAQ,OAAO,IAAI,IACjC,QAAQ,OAAO,IAAI,SAAA,GAAA;AACnB,UAAQ,YAAC,MAAA,OAAA,8FAAA,QAAA,OAAA,IAAA,CAAA,CAAA,IAAA,cAAA,QAAA,CACL,KACA,iBAAiB,QAAQ,OAAI,OAAA,OAAA,CAChC,EAAE;GAAC;GAAO;GAAI;GAAA,CAAA,CAAA,CAAA;AACf,QAAM,QAAG,GAAA,MAAA,iBAAA,mCAAA,UAAA,QAAA,YAAA,CAAA;QAEZ;AACG,MAAI,MAAM,QAAM,QAAA,OAAA,OAAA,OAAA,IACZ,QAAQ,OAAO,OAAO,OAAK,SAAA,GAAA;AAC3B,WAAQ,YAAY,MAAA,oDAC5B,gDAAA,QAAA,CAAA,GAAA,wDAAA,QAAA,OAAA,OAAA,OAAA,CAAA,GAAA,EACS;AACD,WAAQ,YAAY,6CAAc,QAAQ,OAAE,OAAA,OAAA,CAAA,OAAA,cAAA,KAAA,WAAA;AAC7C,QAAA,oDAAA,gDAAA,QAAA,CAAA,CAAA,GAAA,YACS,iBAAiB,OAAO;AACrC,WAAA;MACF;IAAA;IAAA;IAAA;IAAA;IAAA,CAAA,EAAA,QAAA,YAAA,IAAA;QAGO,SAAQ,YAAC,MAAA,oDACM,gDAAW,QAAO,CAAA,GAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,EACxC;AAEE,QAAA,QAAA,GAAA,MAAA,iBAAA,mCAAA,UAAA,QAAA,YAAA,CAAA;;AAEH,KAAI,qDAAa,QAAQ,YAAY,IAAG,CACtC,OAAA,IAAA,MAAA,0KAAA;AAEF,SAAQ,OAAO,MAAM,OAAO,KAAK,QAAQ,YAAY,IAAC;;AAE1D,wBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/update-package-json.mjs

@@ -20,7 +20,7 @@ formatBinaryPath.__type = [
 	"PP&&F-J2!&/\""
 ];
 async function updatePackageJsonBinary(context) {
-	const packageJsonPath = joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot, "package.json");
+	const packageJsonPath = joinPaths(context.workspaceConfig.workspaceRoot, context.config.root, "package.json");
 	if (context.config.bin && Array.isArray(context.config.bin) && context.config.bin.length > 0) {
 		context.packageJson.bin = Object.fromEntries(getUnique(toArray(context.config.bin)).map(__assignType((bin) => [bin, formatBinaryPath(context.config.output.format)], [
 			"bin",

package/dist/helpers/update-package-json.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-package-json.mjs","names":[],"sources":["../../src/helpers/update-package-json.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.projectRoot,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.\"\n    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AA0BX,SAAgB,iBAAiB,QAAK;AAClC,QAAM,cAAA,WAAA,SAAA,MAAA,QAAA,OAAA,IAAA,OAAA,SAAA,MAAA,GACA,QACA;;AAEV,iBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;AACZ,eAAI,wBAAA,SAAA;CACJ,MAAA,kBAAA,UAAA,QAAA,gBAAA,eAAA,QAAA,OAAA,aAAA,eAAA;2BAEQ,MAAM,QAAQ,QAAQ,OAAO,IAAI,IACjC,QAAQ,OAAO,IAAI,SAAA,GAAA;AACnB,UAAQ,YAAC,MAAA,OAAA,YAAA,UAAA,QAAA,QAAA,OAAA,IAAA,CAAA,CAAA,IAAA,cAAA,QAAA,CACL,KACA,iBAAiB,QAAQ,OAAI,OAAA,OAAA,CAChC,EAAE;GAAC;GAAO;GAAI;GAAO,CAAA,CAAA,CAAA;AACtB,QAAM,QAAG,GAAA,MAAA,iBAAA,UAAA,UAAA,QAAA,YAAA,CAAA;QAEZ;AACG,MAAI,MAAM,QAAM,QAAA,OAAA,OAAA,OAAA,IACZ,QAAQ,OAAO,OAAO,OAAK,SAAA,GAAA;AAC3B,WAAQ,YAAY,MAAA,GAC5B,UAAA,WAAA,QAAA,CAAA,GAAA,iBAAA,QAAA,QAAA,OAAA,OAAA,OAAA,CAAA,GAAA,EACS;AACD,WAAQ,YAAY,MAAM,QAAQ,QAAQ,OAAE,OAAA,OAAA,CAAA,OAAA,cAAA,KAAA,WAAA;AAC7C,QAAA,GAAA,UAAA,WAAA,QAAA,CAAA,CAAA,GAAA,YACS,iBAAiB,OAAO;AACrC,WAAA;MACF;IAAA;IAAA;IAAA;IAAA;IAAA,CAAA,EAAA,QAAA,YAAA,IAAA;QAGO,SAAQ,YAAC,MAAA,GACJ,UAAU,WAAW,QAAO,CAAA,GAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,EACxC;AAEE,QAAA,QAAA,GAAA,MAAA,iBAAA,UAAA,UAAA,QAAA,YAAA,CAAA;;AAEH,KAAI,CAAC,YAAY,QAAQ,YAAY,IAAG,CACtC,OAAA,IAAA,MAAA,0KAAA;AAEF,SAAQ,OAAO,MAAM,OAAO,KAAK,QAAQ,YAAY,IAAC;;AAE1D,wBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"update-package-json.mjs","names":[],"sources":["../../src/helpers/update-package-json.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.\"\n    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AA0BX,SAAgB,iBAAiB,QAAK;AAClC,QAAM,cAAA,WAAA,SAAA,MAAA,QAAA,OAAA,IAAA,OAAA,SAAA,MAAA,GACA,QACA;;AAEV,iBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;AACZ,eAAI,wBAAA,SAAA;CACJ,MAAA,kBAAA,UAAA,QAAA,gBAAA,eAAA,QAAA,OAAA,MAAA,eAAA;2BAEQ,MAAM,QAAQ,QAAQ,OAAO,IAAI,IACjC,QAAQ,OAAO,IAAI,SAAA,GAAA;AACnB,UAAQ,YAAC,MAAA,OAAA,YAAA,UAAA,QAAA,QAAA,OAAA,IAAA,CAAA,CAAA,IAAA,cAAA,QAAA,CACL,KACA,iBAAiB,QAAQ,OAAI,OAAA,OAAA,CAChC,EAAE;GAAC;GAAO;GAAI;GAAA,CAAA,CAAA,CAAA;AACf,QAAM,QAAG,GAAA,MAAA,iBAAA,UAAA,UAAA,QAAA,YAAA,CAAA;QAEZ;AACG,MAAI,MAAM,QAAM,QAAA,OAAA,OAAA,OAAA,IACZ,QAAQ,OAAO,OAAO,OAAK,SAAA,GAAA;AAC3B,WAAQ,YAAY,MAAA,GAC5B,UAAA,WAAA,QAAA,CAAA,GAAA,iBAAA,QAAA,QAAA,OAAA,OAAA,OAAA,CAAA,GAAA,EACS;AACD,WAAQ,YAAY,MAAM,QAAQ,QAAQ,OAAE,OAAA,OAAA,CAAA,OAAA,cAAA,KAAA,WAAA;AAC7C,QAAA,GAAA,UAAA,WAAA,QAAA,CAAA,CAAA,GAAA,YACS,iBAAiB,OAAO;AACrC,WAAA;MACF;IAAA;IAAA;IAAA;IAAA;IAAA,CAAA,EAAA,QAAA,YAAA,IAAA;QAGO,SAAQ,YAAC,MAAA,GACJ,UAAU,WAAW,QAAO,CAAA,GAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,EACxC;AAEE,QAAA,QAAA,GAAA,MAAA,iBAAA,UAAA,UAAA,QAAA,YAAA,CAAA;;AAEH,KAAI,CAAC,YAAY,QAAQ,YAAY,IAAG,CACtC,OAAA,IAAA,MAAA,0KAAA;AAEF,SAAQ,OAAO,MAAM,OAAO,KAAK,QAAQ,YAAY,IAAC;;AAE1D,wBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/index.cjs

@@ -1,7 +1,5 @@
 Object.defineProperty(exports, '__esModule', { value: true });
-const require_plugin = require('./plugin.cjs');
 const require_api = require('./api.cjs');
-const require_config = require('./config.cjs');
 const require_types_command = require('./types/command.cjs');
 const require_types_config = require('./types/config.cjs');
 const require_types_context = require('./types/context.cjs');
@@ -24,6 +22,7 @@ exports.__ΩCommandContext = require_types_runtime.__ΩCommandContext;
 exports.__ΩCommandInput = require_types_command.__ΩCommandInput;
 exports.__ΩCommandModule = require_types_command.__ΩCommandModule;
 exports.__ΩCommandOption = require_types_command.__ΩCommandOption;
+exports.__ΩCommandParameterSchema = require_types_command.__ΩCommandParameterSchema;
 exports.__ΩCommandTree = require_types_command.__ΩCommandTree;
 exports.__ΩContext = require_types_context.__ΩContext;
 exports.__ΩMetadata = require_types_command.__ΩMetadata;
@@ -43,7 +42,4 @@ exports.__ΩUnresolvedContext = require_types_context.__ΩUnresolvedContext;
 exports.__ΩUserConfig = require_types_config.__ΩUserConfig;
 exports.createShellShock = require_api.createShellShock;
 exports.default = src_default;
-exports.defineConfig = require_config.defineConfig;
-exports.plugin = require_plugin.plugin;
-exports.shellShock = require_plugin.plugin;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.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 { ShellShockAPI, createShellShock } from \"./api\";\n\nexport * from \"./config\";\n\nexport { plugin, shellShock } from \"./plugin\";\nexport * from \"./types\";\n\n// eslint-disable-next-line perfectionist/sort-named-exports\nexport { ShellShockAPI, createShellShock };\nexport default ShellShockAPI;\n"],"mappings":";;;;;;;;;;;AAuBA,kBAAe"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.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 { ShellShockAPI, createShellShock } from \"./api\";\n\nexport * from \"./types\";\n\n// eslint-disable-next-line perfectionist/sort-named-exports\nexport { ShellShockAPI, createShellShock };\nexport default ShellShockAPI;\n"],"mappings":""}

package/dist/index.d.cts

@@ -1,10 +1,8 @@
-import { BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandInput, CommandModule, CommandOption, CommandTree, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, StringCommandArgument, StringCommandOption, StringCommandParameter } from "./types/command.cjs";
+import { BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandInput, CommandModule, CommandOption, CommandParameterSchema, CommandTree, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, StringCommandArgument, StringCommandOption, StringCommandParameter } from "./types/command.cjs";
 import { Context, UnresolvedContext } from "./types/context.cjs";
 import { Options, OutputConfig, ResolvedConfig, UserConfig } from "./types/config.cjs";
 import { ShellShockAPI, createShellShock } from "./api.cjs";
-import { defineConfig } from "./config.cjs";
 import { BaseCommandOptions } from "./types/options.cjs";
 import { CommandContext } from "./types/runtime.cjs";
 import "./types/index.cjs";
-import plugin from "./plugin.cjs";
-export { BaseCommandOptions, BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandContext, CommandInput, CommandModule, CommandOption, CommandTree, Context, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, Options, OutputConfig, ResolvedConfig, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandArgument, StringCommandOption, StringCommandParameter, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+export { BaseCommandOptions, BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandContext, CommandInput, CommandModule, CommandOption, CommandParameterSchema, CommandTree, Context, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, Options, OutputConfig, ResolvedConfig, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandArgument, StringCommandOption, StringCommandParameter, UnresolvedContext, UserConfig, createShellShock };

package/dist/index.d.mts

@@ -1,10 +1,8 @@
-import { BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandInput, CommandModule, CommandOption, CommandTree, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, StringCommandArgument, StringCommandOption, StringCommandParameter } from "./types/command.mjs";
+import { BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandInput, CommandModule, CommandOption, CommandParameterSchema, CommandTree, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, StringCommandArgument, StringCommandOption, StringCommandParameter } from "./types/command.mjs";
 import { Context, UnresolvedContext } from "./types/context.mjs";
 import { Options, OutputConfig, ResolvedConfig, UserConfig } from "./types/config.mjs";
 import { ShellShockAPI, createShellShock } from "./api.mjs";
-import { defineConfig } from "./config.mjs";
 import { BaseCommandOptions } from "./types/options.mjs";
 import { CommandContext } from "./types/runtime.mjs";
 import "./types/index.mjs";
-import plugin from "./plugin.mjs";
-export { BaseCommandOptions, BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandContext, CommandInput, CommandModule, CommandOption, CommandTree, Context, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, Options, OutputConfig, ResolvedConfig, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandArgument, StringCommandOption, StringCommandParameter, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+export { BaseCommandOptions, BaseCommandParameter, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandArgument, CommandBase, CommandContext, CommandInput, CommandModule, CommandOption, CommandParameterSchema, CommandTree, Context, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, Options, OutputConfig, ResolvedConfig, SerializedCommandArgument, SerializedCommandOption, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandArgument, StringCommandOption, StringCommandParameter, UnresolvedContext, UserConfig, createShellShock };

package/dist/index.mjs

@@ -1,7 +1,5 @@
-import { plugin } from "./plugin.mjs";
 import { ShellShockAPI, createShellShock } from "./api.mjs";
-import { defineConfig } from "./config.mjs";
-import { __ΩBaseCommandParameter, __ΩBooleanCommandArgument, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩCommandArgument, __ΩCommandBase, __ΩCommandInput, __ΩCommandModule, __ΩCommandOption, __ΩCommandTree, __ΩMetadata, __ΩNumberCommandArgument, __ΩNumberCommandOption, __ΩNumberCommandParameter, __ΩSerializedCommandArgument, __ΩSerializedCommandOption, __ΩSerializedCommandTree, __ΩStringCommandArgument, __ΩStringCommandOption, __ΩStringCommandParameter } from "./types/command.mjs";
+import { __ΩBaseCommandParameter, __ΩBooleanCommandArgument, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩCommandArgument, __ΩCommandBase, __ΩCommandInput, __ΩCommandModule, __ΩCommandOption, __ΩCommandParameterSchema, __ΩCommandTree, __ΩMetadata, __ΩNumberCommandArgument, __ΩNumberCommandOption, __ΩNumberCommandParameter, __ΩSerializedCommandArgument, __ΩSerializedCommandOption, __ΩSerializedCommandTree, __ΩStringCommandArgument, __ΩStringCommandOption, __ΩStringCommandParameter } from "./types/command.mjs";
 import { __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩUserConfig } from "./types/config.mjs";
 import { __ΩContext, __ΩUnresolvedContext } from "./types/context.mjs";
 import { __ΩBaseCommandOptions } from "./types/options.mjs";
@@ -11,5 +9,5 @@ import { __ΩCommandContext } from "./types/runtime.mjs";
 var src_default = ShellShockAPI;
 
 //#endregion
-export { ShellShockAPI, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandArgument, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩCommandArgument, __ΩCommandBase, __ΩCommandContext, __ΩCommandInput, __ΩCommandModule, __ΩCommandOption, __ΩCommandTree, __ΩContext, __ΩMetadata, __ΩNumberCommandArgument, __ΩNumberCommandOption, __ΩNumberCommandParameter, __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩSerializedCommandArgument, __ΩSerializedCommandOption, __ΩSerializedCommandTree, __ΩStringCommandArgument, __ΩStringCommandOption, __ΩStringCommandParameter, __ΩUnresolvedContext, __ΩUserConfig, createShellShock, src_default as default, defineConfig, plugin, plugin as shellShock };
+export { ShellShockAPI, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandArgument, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩCommandArgument, __ΩCommandBase, __ΩCommandContext, __ΩCommandInput, __ΩCommandModule, __ΩCommandOption, __ΩCommandParameterSchema, __ΩCommandTree, __ΩContext, __ΩMetadata, __ΩNumberCommandArgument, __ΩNumberCommandOption, __ΩNumberCommandParameter, __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩSerializedCommandArgument, __ΩSerializedCommandOption, __ΩSerializedCommandTree, __ΩStringCommandArgument, __ΩStringCommandOption, __ΩStringCommandParameter, __ΩUnresolvedContext, __ΩUserConfig, createShellShock, src_default as default };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.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 { ShellShockAPI, createShellShock } from \"./api\";\n\nexport * from \"./config\";\n\nexport { plugin, shellShock } from \"./plugin\";\nexport * from \"./types\";\n\n// eslint-disable-next-line perfectionist/sort-named-exports\nexport { ShellShockAPI, createShellShock };\nexport default ShellShockAPI;\n"],"mappings":";;;;;;;;;;AAuBA,kBAAe"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.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 { ShellShockAPI, createShellShock } from \"./api\";\n\nexport * from \"./types\";\n\n// eslint-disable-next-line perfectionist/sort-named-exports\nexport { ShellShockAPI, createShellShock };\nexport default ShellShockAPI;\n"],"mappings":""}