@shell-shock/core 0.6.0 → 0.8.0

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

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

package/dist/helpers/validations.cjs

@@ -1,42 +1,19 @@
-const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 
 //#region src/helpers/validations.ts
-function validateDynamicPathSegments(command) {
+function validateArguments(command) {
 	const failures = [];
-	if (!command.isVirtual && command.path.segments.length > 0) {
-		const dynamicPathSegmentNames = /* @__PURE__ */ new Set();
-		for (const segment of command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment) ?? []) {
-			if (dynamicPathSegmentNames.has(segment)) failures.push({
-				code: "DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME",
-				details: `Duplicate dynamic path segment name "${require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)}" found in command.`
-			});
-			dynamicPathSegmentNames.add(require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment));
-		}
-		if (command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).length !== Object.keys(command.path.dynamics ?? {}).length) failures.push({
-			code: "DYNAMIC_PATH_SEGMENT_MISMATCH",
-			details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).length} dynamic path segments in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.dynamics ?? {}).length} potential dynamic path segment(s) could be determined from the command's function signature).`
-		});
-		const missing = command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.dynamics ?? {}, require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)) === false);
-		if (missing.length > 0) failures.push({
-			code: "MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION",
-			details: `${missing.length} dynamic path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path dynamic segments: \n- ${missing.map((segment) => `"${require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)}"`).join("\n- ")}`
-		});
-		else {
-			for (const varName of Object.keys(command.path.dynamics ?? {})) if (!command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).find((segment) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === varName)) failures.push({
-				code: "UNUSED_DYNAMIC_PATH_SEGMENT",
-				details: `The dynamic path segment name "${varName}" defined in the command's path dynamic segments is not used in the command folder path "${command.path.segments.join("/")}".`
-			});
-			command.path.segments.forEach((segment, index) => {
-				if (require_plugin_utils_context_helpers.isDynamicPathSegment(segment) && command.path.dynamics[require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)]?.catchAll === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.dynamics[require_plugin_utils_context_helpers.getDynamicPathSegmentName(command.path.segments[index + 1])]?.catchAll === true) failures.push({
-					code: "MULTIPLE_CATCH_ALL_PATH_SEGMENTS",
-					details: `The catch-all path segment "${require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as catch-all, and it is followed by another catch-all dynamic path segment "${require_plugin_utils_context_helpers.getDynamicPathSegmentName(command.path.segments[index + 1])}". Only one catch-all path segment is allowed per command, and it must be the final path segment.`
-				});
-			});
-		}
-	}
+	let sequential = false;
+	for (const argument of command.arguments ?? []) if ((argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) && argument.variadic) if (!sequential) sequential = true;
+	else failures.push({
+		code: "SEQUENTIAL_VARIADIC_ARGUMENTS",
+		details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`
+	});
+	else sequential = false;
 	return failures;
 }
-function validateCommandOptions(command) {
+function validateOptions(command) {
 	const failures = [];
 	const optionNames = /* @__PURE__ */ new Set();
 	for (const option of Object.values(command.options ?? {})) {
@@ -57,9 +34,9 @@ function validateCommandOptions(command) {
 }
 function validateCommand(command) {
 	const results = [];
-	let failures = validateDynamicPathSegments(command);
+	let failures = validateOptions(command);
 	if (failures.length > 0) results.push(...failures);
-	failures = validateCommandOptions(command);
+	failures = validateArguments(command);
 	if (failures.length > 0) results.push(...failures);
 	return results;
 }

package/dist/helpers/validations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validations.cjs","names":["getDynamicPathSegmentName","isDynamicPathSegment","validateDynamicPathSegments","command","failures","isVirtual","path","segments","length","dynamicPathSegmentNames","Set","segment","filter","has","push","code","details","add","Object","keys","dynamics","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","catchAll","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommand","results"],"sources":["../../src/helpers/validations.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 {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateDynamicPathSegments(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const dynamicPathSegmentNames = new Set<string>();\n    for (const segment of command.path.segments.filter(isDynamicPathSegment) ??\n      []) {\n      if (dynamicPathSegmentNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME\",\n          details: `Duplicate dynamic path segment name \"${getDynamicPathSegmentName(segment)}\" found in command.`\n        });\n      }\n      dynamicPathSegmentNames.add(getDynamicPathSegmentName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isDynamicPathSegment).length !==\n      Object.keys(command.path.dynamics ?? {}).length\n    ) {\n      failures.push({\n        code: \"DYNAMIC_PATH_SEGMENT_MISMATCH\",\n        details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${\n          command.path.segments.filter(isDynamicPathSegment).length\n        } dynamic path segments in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.dynamics ?? {}).length\n        } potential dynamic path segment(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isDynamicPathSegment)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.dynamics ?? {},\n            getDynamicPathSegmentName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION\",\n        details: `${missing.length} dynamic path segment${missing.length > 1 ? \"s\" : \"\"} in the command folder path \"${command.path.segments.join(\n          \"/\"\n        )}\" do${missing.length > 1 ? \"\" : \"es\"} not have corresponding entr${\n          missing.length > 1 ? \"ies\" : \"y\"\n        } in the command's path dynamic segments: \\n- ${missing\n          .map(segment => `\"${getDynamicPathSegmentName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.dynamics ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isDynamicPathSegment)\n            .find(segment => getDynamicPathSegmentName(segment) === varName)\n        ) {\n          failures.push({\n            code: \"UNUSED_DYNAMIC_PATH_SEGMENT\",\n            details: `The dynamic path segment name \"${\n              varName\n            }\" defined in the command's path dynamic segments is not used in the command folder path \"${command.path.segments.join(\n              \"/\"\n            )}\".`\n          });\n        }\n      }\n\n      command.path.segments.forEach((segment, index) => {\n        if (\n          isDynamicPathSegment(segment) &&\n          command.path.dynamics[getDynamicPathSegmentName(segment)]\n            ?.catchAll === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.dynamics[\n            getDynamicPathSegmentName(command.path.segments[index + 1]!)\n          ]?.catchAll === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_CATCH_ALL_PATH_SEGMENTS\",\n            details: `The catch-all path segment \"${getDynamicPathSegmentName(\n              segment\n            )}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is marked as catch-all, and it is followed by another catch-all dynamic path segment \"${getDynamicPathSegmentName(\n              command.path.segments[index + 1]!\n            )}\". Only one catch-all path segment is allowed per command, and it must be the final path segment.`\n          });\n        }\n      });\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommandOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateDynamicPathSegments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"validations.cjs","names":["ReflectionKind","validateArguments","command","failures","sequential","argument","arguments","kind","string","number","variadic","push","code","details","name","validateOptions","optionNames","Set","option","Object","values","options","has","add","alias","validateCommand","results","length"],"sources":["../../src/helpers/validations.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateArguments(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  let sequential = false;\n  for (const argument of command.arguments ?? []) {\n    if (\n      (argument.kind === ReflectionKind.string ||\n        argument.kind === ReflectionKind.number) &&\n      argument.variadic\n    ) {\n      if (!sequential) {\n        sequential = true;\n      } else {\n        failures.push({\n          code: \"SEQUENTIAL_VARIADIC_ARGUMENTS\",\n          details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`\n        });\n      }\n    } else {\n      sequential = false;\n    }\n  }\n\n  return failures;\n}\n\nexport function validateOptions(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateArguments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":";;;;AA0BA,SAAgBC,kBAAkBC,SAA2C;CAC3E,MAAMC,WAAgC,EAAE;CAExC,IAAIC,aAAa;AACjB,MAAK,MAAMC,YAAYH,QAAQI,aAAa,EAAE,CAC5C,MACGD,SAASE,SAASP,gDAAeQ,UAChCH,SAASE,SAASP,gDAAeS,WACnCJ,SAASK,SAET,KAAI,CAACN,WACHA,cAAa;KAEbD,UAASQ,KAAK;EACZC,MAAM;EACNC,SAAS,gFAAgFR,SAASS,KAAI;EACvG,CAAC;KAGJV,cAAa;AAIjB,QAAOD;;AAGT,SAAgBY,gBAAgBb,SAA2C;CACzE,MAAMC,WAAgC,EAAE;CAExC,MAAMa,8BAAc,IAAIC,KAAa;AACrC,MAAK,MAAMC,UAAUC,OAAOC,OAAOlB,QAAQmB,WAAW,EAAE,CAAC,EAAE;AACzD,MAAIL,YAAYM,IAAIJ,OAAOJ,KAAK,CAC9BX,UAASQ,KAAK;GACZC,MAAM;GACNC,SAAS,0BAA0BK,OAAOJ,KAAI;GAC/C,CAAC;AAEJE,cAAYO,IAAIL,OAAOJ,KAAK;AAE5B,OAAK,MAAMU,SAASN,OAAOM,OAAO;AAChC,OAAIR,YAAYM,IAAIE,MAAM,CACxBrB,UAASQ,KAAK;IACZC,MAAM;IACNC,SAAS,0BAA0BW,MAAK,kBACtCN,OAAOJ,KAAI;IAEd,CAAC;AAEJE,eAAYO,IAAIC,MAAM;;;AAI1B,QAAOrB;;AAGT,SAAgBsB,gBAAgBvB,SAA2C;CACzE,MAAMwB,UAA+B,EAAE;CAEvC,IAAIvB,WAAWY,gBAAgBb,QAAQ;AACvC,KAAIC,SAASwB,SAAS,EACpBD,SAAQf,KAAK,GAAGR,SAAS;AAG3BA,YAAWF,kBAAkBC,QAAQ;AACrC,KAAIC,SAASwB,SAAS,EACpBD,SAAQf,KAAK,GAAGR,SAAS;AAG3B,QAAOuB"}

package/dist/helpers/validations.mjs

@@ -1,42 +1,18 @@
-import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 
 //#region src/helpers/validations.ts
-function validateDynamicPathSegments(command) {
+function validateArguments(command) {
 	const failures = [];
-	if (!command.isVirtual && command.path.segments.length > 0) {
-		const dynamicPathSegmentNames = /* @__PURE__ */ new Set();
-		for (const segment of command.path.segments.filter(isDynamicPathSegment) ?? []) {
-			if (dynamicPathSegmentNames.has(segment)) failures.push({
-				code: "DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME",
-				details: `Duplicate dynamic path segment name "${getDynamicPathSegmentName(segment)}" found in command.`
-			});
-			dynamicPathSegmentNames.add(getDynamicPathSegmentName(segment));
-		}
-		if (command.path.segments.filter(isDynamicPathSegment).length !== Object.keys(command.path.dynamics ?? {}).length) failures.push({
-			code: "DYNAMIC_PATH_SEGMENT_MISMATCH",
-			details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${command.path.segments.filter(isDynamicPathSegment).length} dynamic path segments in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.dynamics ?? {}).length} potential dynamic path segment(s) could be determined from the command's function signature).`
-		});
-		const missing = command.path.segments.filter(isDynamicPathSegment).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.dynamics ?? {}, getDynamicPathSegmentName(segment)) === false);
-		if (missing.length > 0) failures.push({
-			code: "MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION",
-			details: `${missing.length} dynamic path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path dynamic segments: \n- ${missing.map((segment) => `"${getDynamicPathSegmentName(segment)}"`).join("\n- ")}`
-		});
-		else {
-			for (const varName of Object.keys(command.path.dynamics ?? {})) if (!command.path.segments.filter(isDynamicPathSegment).find((segment) => getDynamicPathSegmentName(segment) === varName)) failures.push({
-				code: "UNUSED_DYNAMIC_PATH_SEGMENT",
-				details: `The dynamic path segment name "${varName}" defined in the command's path dynamic segments is not used in the command folder path "${command.path.segments.join("/")}".`
-			});
-			command.path.segments.forEach((segment, index) => {
-				if (isDynamicPathSegment(segment) && command.path.dynamics[getDynamicPathSegmentName(segment)]?.catchAll === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.dynamics[getDynamicPathSegmentName(command.path.segments[index + 1])]?.catchAll === true) failures.push({
-					code: "MULTIPLE_CATCH_ALL_PATH_SEGMENTS",
-					details: `The catch-all path segment "${getDynamicPathSegmentName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as catch-all, and it is followed by another catch-all dynamic path segment "${getDynamicPathSegmentName(command.path.segments[index + 1])}". Only one catch-all path segment is allowed per command, and it must be the final path segment.`
-				});
-			});
-		}
-	}
+	let sequential = false;
+	for (const argument of command.arguments ?? []) if ((argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number) && argument.variadic) if (!sequential) sequential = true;
+	else failures.push({
+		code: "SEQUENTIAL_VARIADIC_ARGUMENTS",
+		details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`
+	});
+	else sequential = false;
 	return failures;
 }
-function validateCommandOptions(command) {
+function validateOptions(command) {
 	const failures = [];
 	const optionNames = /* @__PURE__ */ new Set();
 	for (const option of Object.values(command.options ?? {})) {
@@ -57,9 +33,9 @@ function validateCommandOptions(command) {
 }
 function validateCommand(command) {
 	const results = [];
-	let failures = validateDynamicPathSegments(command);
+	let failures = validateOptions(command);
 	if (failures.length > 0) results.push(...failures);
-	failures = validateCommandOptions(command);
+	failures = validateArguments(command);
 	if (failures.length > 0) results.push(...failures);
 	return results;
 }

package/dist/helpers/validations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validations.mjs","names":["getDynamicPathSegmentName","isDynamicPathSegment","validateDynamicPathSegments","command","failures","isVirtual","path","segments","length","dynamicPathSegmentNames","Set","segment","filter","has","push","code","details","add","Object","keys","dynamics","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","catchAll","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommand","results"],"sources":["../../src/helpers/validations.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 {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateDynamicPathSegments(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const dynamicPathSegmentNames = new Set<string>();\n    for (const segment of command.path.segments.filter(isDynamicPathSegment) ??\n      []) {\n      if (dynamicPathSegmentNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME\",\n          details: `Duplicate dynamic path segment name \"${getDynamicPathSegmentName(segment)}\" found in command.`\n        });\n      }\n      dynamicPathSegmentNames.add(getDynamicPathSegmentName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isDynamicPathSegment).length !==\n      Object.keys(command.path.dynamics ?? {}).length\n    ) {\n      failures.push({\n        code: \"DYNAMIC_PATH_SEGMENT_MISMATCH\",\n        details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${\n          command.path.segments.filter(isDynamicPathSegment).length\n        } dynamic path segments in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.dynamics ?? {}).length\n        } potential dynamic path segment(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isDynamicPathSegment)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.dynamics ?? {},\n            getDynamicPathSegmentName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION\",\n        details: `${missing.length} dynamic path segment${missing.length > 1 ? \"s\" : \"\"} in the command folder path \"${command.path.segments.join(\n          \"/\"\n        )}\" do${missing.length > 1 ? \"\" : \"es\"} not have corresponding entr${\n          missing.length > 1 ? \"ies\" : \"y\"\n        } in the command's path dynamic segments: \\n- ${missing\n          .map(segment => `\"${getDynamicPathSegmentName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.dynamics ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isDynamicPathSegment)\n            .find(segment => getDynamicPathSegmentName(segment) === varName)\n        ) {\n          failures.push({\n            code: \"UNUSED_DYNAMIC_PATH_SEGMENT\",\n            details: `The dynamic path segment name \"${\n              varName\n            }\" defined in the command's path dynamic segments is not used in the command folder path \"${command.path.segments.join(\n              \"/\"\n            )}\".`\n          });\n        }\n      }\n\n      command.path.segments.forEach((segment, index) => {\n        if (\n          isDynamicPathSegment(segment) &&\n          command.path.dynamics[getDynamicPathSegmentName(segment)]\n            ?.catchAll === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.dynamics[\n            getDynamicPathSegmentName(command.path.segments[index + 1]!)\n          ]?.catchAll === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_CATCH_ALL_PATH_SEGMENTS\",\n            details: `The catch-all path segment \"${getDynamicPathSegmentName(\n              segment\n            )}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is marked as catch-all, and it is followed by another catch-all dynamic path segment \"${getDynamicPathSegmentName(\n              command.path.segments[index + 1]!\n            )}\". Only one catch-all path segment is allowed per command, and it must be the final path segment.`\n          });\n        }\n      });\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommandOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateDynamicPathSegments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"validations.mjs","names":["ReflectionKind","validateArguments","command","failures","sequential","argument","arguments","kind","string","number","variadic","push","code","details","name","validateOptions","optionNames","Set","option","Object","values","options","has","add","alias","validateCommand","results","length"],"sources":["../../src/helpers/validations.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateArguments(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  let sequential = false;\n  for (const argument of command.arguments ?? []) {\n    if (\n      (argument.kind === ReflectionKind.string ||\n        argument.kind === ReflectionKind.number) &&\n      argument.variadic\n    ) {\n      if (!sequential) {\n        sequential = true;\n      } else {\n        failures.push({\n          code: \"SEQUENTIAL_VARIADIC_ARGUMENTS\",\n          details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`\n        });\n      }\n    } else {\n      sequential = false;\n    }\n  }\n\n  return failures;\n}\n\nexport function validateOptions(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateArguments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":";;;AA0BA,SAAgBC,kBAAkBC,SAA2C;CAC3E,MAAMC,WAAgC,EAAE;CAExC,IAAIC,aAAa;AACjB,MAAK,MAAMC,YAAYH,QAAQI,aAAa,EAAE,CAC5C,MACGD,SAASE,SAASP,eAAeQ,UAChCH,SAASE,SAASP,eAAeS,WACnCJ,SAASK,SAET,KAAI,CAACN,WACHA,cAAa;KAEbD,UAASQ,KAAK;EACZC,MAAM;EACNC,SAAS,gFAAgFR,SAASS,KAAI;EACvG,CAAC;KAGJV,cAAa;AAIjB,QAAOD;;AAGT,SAAgBY,gBAAgBb,SAA2C;CACzE,MAAMC,WAAgC,EAAE;CAExC,MAAMa,8BAAc,IAAIC,KAAa;AACrC,MAAK,MAAMC,UAAUC,OAAOC,OAAOlB,QAAQmB,WAAW,EAAE,CAAC,EAAE;AACzD,MAAIL,YAAYM,IAAIJ,OAAOJ,KAAK,CAC9BX,UAASQ,KAAK;GACZC,MAAM;GACNC,SAAS,0BAA0BK,OAAOJ,KAAI;GAC/C,CAAC;AAEJE,cAAYO,IAAIL,OAAOJ,KAAK;AAE5B,OAAK,MAAMU,SAASN,OAAOM,OAAO;AAChC,OAAIR,YAAYM,IAAIE,MAAM,CACxBrB,UAASQ,KAAK;IACZC,MAAM;IACNC,SAAS,0BAA0BW,MAAK,kBACtCN,OAAOJ,KAAI;IAEd,CAAC;AAEJE,eAAYO,IAAIC,MAAM;;;AAI1B,QAAOrB;;AAGT,SAAgBsB,gBAAgBvB,SAA2C;CACzE,MAAMwB,UAA+B,EAAE;CAEvC,IAAIvB,WAAWY,gBAAgBb,QAAQ;AACvC,KAAIC,SAASwB,SAAS,EACpBD,SAAQf,KAAK,GAAGR,SAAS;AAG3BA,YAAWF,kBAAkBC,QAAQ;AACrC,KAAIC,SAASwB,SAAS,EACpBD,SAAQf,KAAK,GAAGR,SAAS;AAG3B,QAAOuB"}

package/dist/index.d.cts

@@ -1,9 +1,10 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandPath, CommandTree, CommandTreePath, Metadata, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.cjs";
+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 { Context, UnresolvedContext } from "./types/context.cjs";
 import { BaseConfig, 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 { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandPath, CommandTree, CommandTreePath, Context, Metadata, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+export { BaseCommandOptions, BaseCommandParameter, BaseConfig, 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 };

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandPath, CommandTree, CommandTreePath, Metadata, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.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 { Context, UnresolvedContext } from "./types/context.mjs";
 import { BaseConfig, 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 { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandPath, CommandTree, CommandTreePath, Context, Metadata, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+export { BaseCommandOptions, BaseCommandParameter, BaseConfig, 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 };

package/dist/plugin-utils/context-helpers.cjs

@@ -63,8 +63,6 @@ function getAppBin(context) {
 * ```typescript
 * isDynamicPathSegment("[user]"); // true
 * isDynamicPathSegment("user"); // false
-* isDynamicPathSegment("[[...user]]"); // true
-* isDynamicPathSegment("[...user]"); // true
 * ```
 *
 * @param path - The command path segment to check.
@@ -74,52 +72,18 @@ function isDynamicPathSegment(path) {
 	return path.startsWith("[") && path.endsWith("]");
 }
 /**
-* Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
-*
-* @example
-* ```typescript
-* isOptionalCatchAllPathSegment("[[...user]]"); // true
-* isOptionalCatchAllPathSegment("[...user]"); // false
-* isOptionalCatchAllPathSegment("[user]"); // false
-* ```
-*
-* @param path - The command path segment to check.
-* @returns True if the path is an optional catch-all segment, false otherwise.
-*/
-function isOptionalCatchAllPathSegment(path) {
-	return path.startsWith("[[...") && path.endsWith("]]");
-}
-/**
-* Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
-*
-* @example
-* ```typescript
-* isCatchAllPathSegment("[[...user]]"); // true
-* isCatchAllPathSegment("[...user]"); // true
-* isCatchAllPathSegment("[user]"); // false
-* ```
-*
-* @param path - The command path segment to check.
-* @returns True if the path is a catch-all segment, false otherwise.
-*/
-function isCatchAllPathSegment(path) {
-	return path.startsWith("[...") && path.endsWith("]") || isOptionalCatchAllPathSegment(path);
-}
-/**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
 * @example
 * ```typescript
 * getDynamicPathSegmentName("[user]"); // "user"
-* getDynamicPathSegmentName("[[...user]]"); // "user"
-* getDynamicPathSegmentName("[...user]"); // "user"
 * ```
 *
 * @param path - The command path segment.
 * @returns The variable name without square brackets.
 */
 function getDynamicPathSegmentName(path) {
-	return path.replaceAll(/^\[+(?:\.\.\.)*/g, "").replaceAll(/\]+$/g, "");
+	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
 }
 /**
 * Determines if a given command path segment is a path segment group (enclosed in parentheses).
@@ -127,8 +91,6 @@ function getDynamicPathSegmentName(path) {
 * @example
 * ```typescript
 * isPathSegmentGroup("(user)"); // true
-* isPathSegmentGroup("[[...user]]"); // false
-* isPathSegmentGroup("[...user]"); // false
 * isPathSegmentGroup("[user]"); // false
 * isPathSegmentGroup("user"); // false
 * ```
@@ -137,7 +99,7 @@ function getDynamicPathSegmentName(path) {
 * @returns True if the path is a path segment group, false otherwise.
 */
 function isPathSegmentGroup(path) {
-	return path.startsWith("(") && path.endsWith(")");
+	return path.startsWith("(") && path.endsWith(")") || path.startsWith("_");
 }
 /**
 * Extracts the group name from a command path segment by removing enclosing parentheses.
@@ -152,7 +114,7 @@ function isPathSegmentGroup(path) {
 * @returns The group name without parentheses.
 */
 function getPathSegmentGroupName(path) {
-	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "");
+	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "").replaceAll(/^_+/g, "");
 }
 /**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
@@ -160,8 +122,6 @@ function getPathSegmentGroupName(path) {
 * @example
 * ```typescript
 * getDynamicPathSegmentName("[user]"); // "user"
-* getDynamicPathSegmentName("[[...user]]"); // "user"
-* getDynamicPathSegmentName("[...user]"); // "user"
 * ```
 *
 * @param path - The command path segment.
@@ -179,9 +139,7 @@ exports.getAppTitle = getAppTitle;
 exports.getDynamicPathSegmentName = getDynamicPathSegmentName;
 exports.getPathSegmentGroupName = getPathSegmentGroupName;
 exports.getPathSegmentName = getPathSegmentName;
-exports.isCatchAllPathSegment = isCatchAllPathSegment;
 exports.isDynamicPathSegment = isDynamicPathSegment;
-exports.isOptionalCatchAllPathSegment = isOptionalCatchAllPathSegment;
 exports.isPathSegmentGroup = isPathSegmentGroup;
 exports.sortArgAliases = sortArgAliases;
 //# sourceMappingURL=context-helpers.cjs.map

package/dist/plugin-utils/context-helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"context-helpers.cjs","names":["kebabCase","titleCase","isSetObject","isSetString","sortArgAliases","aliases","length","result","filter","alias","push","sort","a","b","localeCompare","getAppName","context","config","name","bin","Array","isArray","packageJson","Error","getAppTitle","title","getAppDescription","description","getAppBin","Object","keys","isDynamicPathSegment","path","startsWith","endsWith","isOptionalCatchAllPathSegment","isCatchAllPathSegment","getDynamicPathSegmentName","replaceAll","isPathSegmentGroup","getPathSegmentGroupName","getPathSegmentName"],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { kebabCase } from \"@stryke/string-format/kebab-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 type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(context: UnresolvedContext | Context): string {\n  return (\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context))\n  );\n}\n\n/**\n * Retrieves the application description from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application description.\n */\nexport function getAppDescription(\n  context: UnresolvedContext | Context\n): string {\n  return (\n    context.config.description ||\n    context.packageJson?.description ||\n    `The ${getAppTitle(context)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * isDynamicPathSegment(\"[[...user]]\"); // true\n * isDynamicPathSegment(\"[...user]\"); // true\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).\n *\n * @example\n * ```typescript\n * isOptionalCatchAllPathSegment(\"[[...user]]\"); // true\n * isOptionalCatchAllPathSegment(\"[...user]\"); // false\n * isOptionalCatchAllPathSegment(\"[user]\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is an optional catch-all segment, false otherwise.\n */\nexport function isOptionalCatchAllPathSegment(path: string): boolean {\n  return path.startsWith(\"[[...\") && path.endsWith(\"]]\");\n}\n\n/**\n * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).\n *\n * @example\n * ```typescript\n * isCatchAllPathSegment(\"[[...user]]\"); // true\n * isCatchAllPathSegment(\"[...user]\"); // true\n * isCatchAllPathSegment(\"[user]\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a catch-all segment, false otherwise.\n */\nexport function isCatchAllPathSegment(path: string): boolean {\n  return (\n    (path.startsWith(\"[...\") && path.endsWith(\"]\")) ||\n    isOptionalCatchAllPathSegment(path)\n  );\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * getDynamicPathSegmentName(\"[[...user]]\"); // \"user\"\n * getDynamicPathSegmentName(\"[...user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+(?:\\.\\.\\.)*/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[[...user]]\"); // false\n * isPathSegmentGroup(\"[...user]\"); // false\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return path.startsWith(\"(\") && path.endsWith(\")\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path.replaceAll(/^\\(+/g, \"\").replaceAll(/\\)+$/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * getDynamicPathSegmentName(\"[[...user]]\"); // \"user\"\n * getDynamicPathSegmentName(\"[...user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgBI,eAAeC,SAA6B;AAC1D,KAAIA,QAAQC,WAAW,EACrB,QAAO,EAAE;CAGX,MAAMC,SAASF,QAAQG,QAAOC,UAASA,MAAMH,WAAW,EAAE;AAC1DC,QAAOG,KAAK,GAAGL,QAAQG,QAAOC,UAASA,MAAMH,SAAS,EAAE,CAAC;AAEzD,QAAOC,OAAOI,MAAMC,GAAGC,MAAMD,EAAEE,cAAcD,EAAE,CAAC;;;;;;;;;AAUlD,SAAgBE,WAAWC,SAA8C;CACvE,MAAMT,SACJS,QAAQC,OAAOC,6DACFF,QAAQC,OAAOE,IAAI,IAC/BC,MAAMC,QAAQL,QAAQC,OAAOE,IAAI,IAChCH,QAAQC,OAAOE,IAAIb,SAAS,yDAChBU,QAAQC,OAAOE,IAAI,GAAI,uDACrBH,QAAQC,OAAOE,IAAI,GAC7BH,QAAQC,OAAOE,MACfH,QAAQC,OAAOE,IAAI,KACrBH,QAAQM,aAAaJ;AAC3B,KAAI,qDAAaX,OAAO,CACtB,OAAM,IAAIgB,MACR,qIACD;AAGH,yDAAiBhB,OAAO;;;;;;;;AAS1B,SAAgBiB,YAAYR,SAA8C;AACxE,QACEA,QAAQC,OAAOQ,0DACLT,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;;;;;;;;AAUzD,SAAgBU,kBACdV,SACQ;AACR,QACEA,QAAQC,OAAOU,eACfX,QAAQM,aAAaK,eACrB,OAAOH,YAAYR,QAAQ,CAAA;;;;;;;;AAU/B,SAAgBY,UAAUZ,SAA0B;AAClD,4DAAmBA,QAAQC,OAAOE,IAAI,GAClCU,OAAOC,KAAKd,QAAQC,OAAOE,IAAI,CAAC,sDACtBJ,WAAWC,QAAQ,CAAC;;;;;;;;;;;;;;;;AAiBpC,SAAgBe,qBAAqBC,MAAuB;AAC1D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;;;AAgBnD,SAAgBC,8BAA8BH,MAAuB;AACnE,QAAOA,KAAKC,WAAW,QAAQ,IAAID,KAAKE,SAAS,KAAK;;;;;;;;;;;;;;;AAgBxD,SAAgBE,sBAAsBJ,MAAuB;AAC3D,QACGA,KAAKC,WAAW,OAAO,IAAID,KAAKE,SAAS,IAAI,IAC9CC,8BAA8BH,KAAK;;;;;;;;;;;;;;;AAiBvC,SAAgBK,0BAA0BL,MAAsB;AAC9D,QAAOA,KAAKM,WAAW,oBAAoB,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;;;AAkBxE,SAAgBC,mBAAmBP,MAAuB;AACxD,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;;AAenD,SAAgBM,wBAAwBR,MAAsB;AAC5D,QAAOA,KAAKM,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;AAgB7D,SAAgBG,mBAAmBT,MAAsB;AACvD,QAAOQ,wBAAwBH,0BAA0BL,KAAK,CAAC"}
+{"version":3,"file":"context-helpers.cjs","names":["kebabCase","titleCase","isSetObject","isSetString","sortArgAliases","aliases","length","result","filter","alias","push","sort","a","b","localeCompare","getAppName","context","config","name","bin","Array","isArray","packageJson","Error","getAppTitle","title","getAppDescription","description","getAppBin","Object","keys","isDynamicPathSegment","path","startsWith","endsWith","getDynamicPathSegmentName","replaceAll","isPathSegmentGroup","getPathSegmentGroupName","getPathSegmentName"],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { kebabCase } from \"@stryke/string-format/kebab-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 type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(context: UnresolvedContext | Context): string {\n  return (\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context))\n  );\n}\n\n/**\n * Retrieves the application description from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application description.\n */\nexport function getAppDescription(\n  context: UnresolvedContext | Context\n): string {\n  return (\n    context.config.description ||\n    context.packageJson?.description ||\n    `The ${getAppTitle(context)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgBI,eAAeC,SAA6B;AAC1D,KAAIA,QAAQC,WAAW,EACrB,QAAO,EAAE;CAGX,MAAMC,SAASF,QAAQG,QAAOC,UAASA,MAAMH,WAAW,EAAE;AAC1DC,QAAOG,KAAK,GAAGL,QAAQG,QAAOC,UAASA,MAAMH,SAAS,EAAE,CAAC;AAEzD,QAAOC,OAAOI,MAAMC,GAAGC,MAAMD,EAAEE,cAAcD,EAAE,CAAC;;;;;;;;;AAUlD,SAAgBE,WAAWC,SAA8C;CACvE,MAAMT,SACJS,QAAQC,OAAOC,6DACFF,QAAQC,OAAOE,IAAI,IAC/BC,MAAMC,QAAQL,QAAQC,OAAOE,IAAI,IAChCH,QAAQC,OAAOE,IAAIb,SAAS,yDAChBU,QAAQC,OAAOE,IAAI,GAAI,uDACrBH,QAAQC,OAAOE,IAAI,GAC7BH,QAAQC,OAAOE,MACfH,QAAQC,OAAOE,IAAI,KACrBH,QAAQM,aAAaJ;AAC3B,KAAI,qDAAaX,OAAO,CACtB,OAAM,IAAIgB,MACR,qIACD;AAGH,yDAAiBhB,OAAO;;;;;;;;AAS1B,SAAgBiB,YAAYR,SAA8C;AACxE,QACEA,QAAQC,OAAOQ,0DACLT,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;;;;;;;;AAUzD,SAAgBU,kBACdV,SACQ;AACR,QACEA,QAAQC,OAAOU,eACfX,QAAQM,aAAaK,eACrB,OAAOH,YAAYR,QAAQ,CAAA;;;;;;;;AAU/B,SAAgBY,UAAUZ,SAA0B;AAClD,4DAAmBA,QAAQC,OAAOE,IAAI,GAClCU,OAAOC,KAAKd,QAAQC,OAAOE,IAAI,CAAC,sDACtBJ,WAAWC,QAAQ,CAAC;;;;;;;;;;;;;;AAepC,SAAgBe,qBAAqBC,MAAuB;AAC1D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;AAcnD,SAAgBC,0BAA0BH,MAAsB;AAC9D,QAAOA,KAAKI,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;AAgB7D,SAAgBC,mBAAmBL,MAAuB;AACxD,QAAQA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI,IAAKF,KAAKC,WAAW,IAAI;;;;;;;;;;;;;;AAe7E,SAAgBK,wBAAwBN,MAAsB;AAC5D,QAAOA,KACJI,WAAW,SAAS,GAAG,CACvBA,WAAW,SAAS,GAAG,CACvBA,WAAW,QAAQ,GAAG;;;;;;;;;;;;;AAc3B,SAAgBG,mBAAmBP,MAAsB;AACvD,QAAOM,wBAAwBH,0BAA0BH,KAAK,CAAC"}