@shell-shock/core 0.7.0 → 0.8.0

package/dist/helpers/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":["deserializeType","ReflectionFunction","ReflectionKind","resolveClassType","serializeType","omit","joinPaths","getCommandsPersistencePath","context","dataPath","serializedCommandTree","commands","serialize","node","parent","serializedNode","options","Object","entries","reduce","ret","key","option","path","dynamics","dynamic","params","map","param","children","reflection","type","undefined","child","id","result","deserializeCommandTree","serializedCommands","deserialize","kind","function","Error","optionsReflection","getParameters","length","optionsType","objectLiteral","deserializedNode","getProperty","name","getParameter","readCommandsPersistence","reflections","fs","read","JSON","parse","writeCommandsPersistence","filePath","write","stringify","config","mode"],"sources":["../../src/helpers/persistence.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 type { ReflectionClass } from \"@powerlines/deepkit/vendor/type\";\nimport {\n  deserializeType,\n  ReflectionFunction,\n  ReflectionKind,\n  resolveClassType,\n  serializeType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type {\n  CommandDynamicSegment,\n  CommandOption,\n  CommandParameter,\n  CommandTree,\n  SerializedCommandDynamicSegment,\n  SerializedCommandOption,\n  SerializedCommandTree\n} from \"../types\";\nimport type { Context } from \"../types/context\";\n\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\nexport function serializedCommandTree(\n  commands: Record<string, CommandTree>\n): Record<string, SerializedCommandTree> {\n  const serialize = (\n    node: CommandTree,\n    parent: string | null = null\n  ): SerializedCommandTree => {\n    const serializedNode: SerializedCommandTree = {\n      ...node,\n      options: Object.entries(node.options).reduce(\n        (ret, [key, option]) => {\n          ret[key] = {\n            ...omit(option, [\"reflection\"])\n          };\n          return ret;\n        },\n        {} as Record<string, SerializedCommandOption>\n      ),\n      path: {\n        ...node.path,\n        dynamics: Object.entries(node.path.dynamics).reduce(\n          (ret, [key, dynamic]) => {\n            ret[key] = {\n              ...omit(dynamic, [\"reflection\"])\n            };\n            return ret;\n          },\n          {} as Record<string, SerializedCommandDynamicSegment>\n        )\n      },\n      params: node.params.map(param => ({\n        ...omit(param, [\"reflection\"])\n      })),\n      parent,\n      children: {},\n      reflection: node.reflection\n        ? serializeType(node.reflection.type)\n        : undefined\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      serializedNode.children[key] = serialize(child, node.id);\n    }\n\n    return serializedNode;\n  };\n\n  const result: Record<string, SerializedCommandTree> = {};\n  for (const [key, child] of Object.entries(commands)) {\n    result[key] = serialize(child, null);\n  }\n\n  return result;\n}\n\nexport function deserializeCommandTree(\n  serializedCommands: Record<string, SerializedCommandTree>\n): Record<string, CommandTree> {\n  const deserialize = (\n    node: SerializedCommandTree,\n    parent: CommandTree | null = null\n  ): CommandTree => {\n    const type = deserializeType(node.reflection);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `Failed to deserialize persisted data - invalid command handler reflection type for command ${node.id}`\n      );\n    }\n\n    const reflection = new ReflectionFunction(type);\n\n    let optionsReflection: ReflectionClass<any> | undefined;\n    if (\n      reflection.getParameters().length > 0 &&\n      reflection.getParameters()[0]\n    ) {\n      const optionsType = reflection.getParameters()[0]!.type;\n      if (optionsType.kind === ReflectionKind.objectLiteral) {\n        optionsReflection = resolveClassType(optionsType);\n      }\n    }\n\n    const deserializedNode: CommandTree = {\n      ...node,\n      options: optionsReflection\n        ? Object.entries(node.options).reduce(\n            (ret, [key, option]) => {\n              ret[key] = {\n                ...option,\n                reflection: optionsReflection.getProperty(option.name)\n              } as CommandOption;\n              return ret;\n            },\n            {} as Record<string, CommandOption>\n          )\n        : {},\n      path: {\n        ...node.path,\n        dynamics: Object.entries(node.path.dynamics).reduce(\n          (ret, [key, dynamic]) => {\n            ret[key] = {\n              ...dynamic,\n              reflection: reflection.getParameter(dynamic.name)\n            } as CommandDynamicSegment;\n            return ret;\n          },\n          {} as Record<string, CommandDynamicSegment>\n        )\n      },\n      params: node.params.map(param => ({\n        ...param,\n        reflection: reflection.getParameter(param.name)\n      })) as CommandParameter[],\n      parent,\n      children: {},\n      reflection\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      deserializedNode.children[key] = deserialize(child, deserializedNode);\n    }\n\n    return deserializedNode;\n  };\n\n  const result: Record<string, CommandTree> = {};\n  for (const [key, child] of Object.entries(serializedCommands)) {\n    result[key] = deserialize(child, null);\n  }\n\n  return result;\n}\n\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = deserializeCommandTree(JSON.parse(reflections));\n}\n\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      serializedCommandTree(context.commands),\n      null,\n      context.config.mode === \"development\" ? 2 : 0\n    )\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"persistence.mjs","names":["deserializeType","ReflectionFunction","ReflectionKind","resolveClassType","serializeType","omit","joinPaths","getCommandsPersistencePath","context","dataPath","serializedCommandTree","commands","serialize","node","parent","serializedNode","options","Object","entries","reduce","ret","key","option","arguments","map","arg","children","reflection","type","undefined","child","id","result","deserializeCommandTree","serializedCommands","deserialize","kind","function","Error","optionsReflection","getParameters","length","optionsType","objectLiteral","deserializedNode","getProperty","name","i","getParameterOrUndefined","readCommandsPersistence","reflections","fs","read","JSON","parse","writeCommandsPersistence","filePath","write","stringify","config","mode"],"sources":["../../src/helpers/persistence.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 type { ReflectionClass } from \"@powerlines/deepkit/vendor/type\";\nimport {\n  deserializeType,\n  ReflectionFunction,\n  ReflectionKind,\n  resolveClassType,\n  serializeType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandTree,\n  SerializedCommandOption,\n  SerializedCommandTree\n} from \"../types\";\nimport type { Context } from \"../types/context\";\n\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\nexport function serializedCommandTree(\n  commands: Record<string, CommandTree>\n): Record<string, SerializedCommandTree> {\n  const serialize = (\n    node: CommandTree,\n    parent: string | null = null\n  ): SerializedCommandTree => {\n    const serializedNode: SerializedCommandTree = {\n      ...node,\n      options: Object.entries(node.options).reduce(\n        (ret, [key, option]) => {\n          ret[key] = {\n            ...omit(option, [\"reflection\"])\n          };\n          return ret;\n        },\n        {} as Record<string, SerializedCommandOption>\n      ),\n      arguments: node.arguments.map(arg => ({\n        ...omit(arg, [\"reflection\"])\n      })),\n      parent,\n      children: {},\n      reflection: node.reflection\n        ? serializeType(node.reflection.type)\n        : undefined\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      serializedNode.children[key] = serialize(child, node.id);\n    }\n\n    return serializedNode;\n  };\n\n  const result: Record<string, SerializedCommandTree> = {};\n  for (const [key, child] of Object.entries(commands)) {\n    result[key] = serialize(child, null);\n  }\n\n  return result;\n}\n\nexport function deserializeCommandTree(\n  serializedCommands: Record<string, SerializedCommandTree>\n): Record<string, CommandTree> {\n  const deserialize = (\n    node: SerializedCommandTree,\n    parent: CommandTree | null = null\n  ): CommandTree => {\n    const type = deserializeType(node.reflection);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `Failed to deserialize persisted data - invalid command handler reflection type for command ${node.id}`\n      );\n    }\n\n    const reflection = new ReflectionFunction(type);\n\n    let optionsReflection: ReflectionClass<any> | undefined;\n    if (\n      reflection.getParameters().length > 0 &&\n      reflection.getParameters()[0]\n    ) {\n      const optionsType = reflection.getParameters()[0]!.type;\n      if (optionsType.kind === ReflectionKind.objectLiteral) {\n        optionsReflection = resolveClassType(optionsType);\n      }\n    }\n\n    const deserializedNode: CommandTree = {\n      ...node,\n      options: optionsReflection\n        ? Object.entries(node.options).reduce(\n            (ret, [key, option]) => {\n              ret[key] = {\n                ...option,\n                reflection: optionsReflection.getProperty(option.name)\n              } as CommandOption;\n              return ret;\n            },\n            {} as Record<string, CommandOption>\n          )\n        : {},\n      arguments: node.arguments.map((arg, i) => ({\n        ...arg,\n        reflection:\n          reflection.getParameters().length > i + 1\n            ? reflection.getParameters()[i + 1]\n            : reflection.getParameterOrUndefined(arg.name)\n      })) as CommandArgument[],\n      parent,\n      children: {},\n      reflection\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      deserializedNode.children[key] = deserialize(child, deserializedNode);\n    }\n\n    return deserializedNode;\n  };\n\n  const result: Record<string, CommandTree> = {};\n  for (const [key, child] of Object.entries(serializedCommands)) {\n    result[key] = deserialize(child, null);\n  }\n\n  return result;\n}\n\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = deserializeCommandTree(JSON.parse(reflections));\n}\n\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      serializedCommandTree(context.commands),\n      null,\n      context.config.mode === \"development\" ? 2 : 0\n    )\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/resolve-command.cjs

@@ -99,48 +99,18 @@ function extractCommandOption(command, reflection) {
 	return option;
 }
 /**
-* Extracts command dynamic path segment information from a type parameter reflection.
+* Extracts command positional argument information from a type parameter reflection.
 *
 * @param command - The command tree to which the parameter belongs.
-* @param segment - The command path segment corresponding to the parameter.
 * @param reflection - The type parameter reflection to extract information from.
-* @returns The extracted command dynamic segment information.
+* @returns The extracted command positional argument information.
 */
-function extractCommandDynamicSegment(command, segment, reflection) {
-	const type = reflection.getType();
-	if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && !(type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string)) throw new Error(`Unsupported type for dynamic path segment "${segment}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
-	const option = {
-		name: reflection.getName(),
-		segment,
-		title: reflection.getTags().title || (0, __stryke_string_format_title_case.titleCase)(segment),
-		description: reflection.parameter.description || resolveCommandOptionDescription(type.kind, !!reflection.isOptional(), segment, (0, __stryke_string_format_title_case.titleCase)(segment), reflection.getDefaultValue()),
-		optional: reflection.isOptional(),
-		default: reflection.getDefaultValue(),
-		catchAll: command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isCatchAllPathSegment(seg)),
-		reflection
-	};
-	if (type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) {
-		if (!option.catchAll) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" 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.`);
-		option.variadic = true;
-	}
-	if (option.catchAll) {
-		if (!option.optional && command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is defined as a catch-all segment but is not optional. To define an optional catch-all segment, use the "[[...segment]]" syntax.`);
-		else if (option.optional && !command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" 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.`);
-	}
-	return option;
-}
-/**
-* Extracts command positional parameter information from a type parameter reflection.
-*
-* @param command - The command tree to which the parameter belongs.
-* @param reflection - The type parameter reflection to extract information from.
-* @returns The extracted command positional parameter information.
-*/
-function extractCommandParameter(command, reflection) {
+function extractCommandArgument(command, reflection) {
 	const type = reflection.getType();
 	if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && !(type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && (type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number))) throw new Error(`Unsupported type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	const option = {
 		name: reflection.getName(),
+		kind: type.kind,
 		title: (0, __stryke_string_format_title_case.titleCase)(reflection.getName()),
 		description: reflection.parameter.description || resolveCommandParameterDescription(type.kind, !!reflection.isOptional(), reflection.getName(), (0, __stryke_string_format_title_case.titleCase)(reflection.getName()), reflection.getDefaultValue()),
 		env: (0, __stryke_string_format_constant_case.constantCase)(reflection.getName()),
@@ -167,14 +137,11 @@ async function reflectCommandTree(context, command, parent) {
 	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, "") : parent.title} - ` : ""}${(0, __stryke_string_format_title_case.titleCase)(command.name)}${command.isVirtual ? " Commands" : ""}`;
 	const tree = {
 		alias: [],
+		icon: parent?.icon,
 		...command,
 		title,
-		path: {
-			...command.path,
-			dynamics: {}
-		},
 		options: require_utilities.getDefaultOptions(context, command),
-		params: [],
+		arguments: [],
 		parent: parent ?? null,
 		children: {},
 		reflection: null
@@ -201,14 +168,7 @@ async function reflectCommandTree(context, command, parent) {
 				const optionsReflection = __powerlines_deepkit_vendor_type.ReflectionClass.from(parameters[0].type);
 				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
 			} else throw new Error(`The first parameter of the command handler function in "${command.entry.input.file}" must be an object literal or class type representing the command options.`);
-			tree.path.dynamics = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).reduce((obj, segment, index) => {
-				if (parameters.length < index + 2 || !parameters[index + 1]) return obj;
-				const paramName = require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment);
-				obj[paramName] = extractCommandDynamicSegment(command, paramName, parameters[index + 1]);
-				obj[paramName].description = obj[paramName].description || `The ${paramName} ${obj[paramName].catchAll ? `${obj[paramName].optional ? "optional " : ""}catch-all` : "dynamic "} segment for the ${command.name} command.`;
-				return obj;
-			}, {});
-			if (parameters.length > Object.keys(tree.path.dynamics).length + 1) tree.params = parameters.slice(Object.keys(tree.path.dynamics).length + 1).map((param) => extractCommandParameter(command, param));
+			tree.arguments = parameters.slice(1).map((arg) => extractCommandArgument(command, arg));
 		}
 	} else tree.description ??= `A collection of available ${tree.title || (0, __stryke_string_format_title_case.titleCase)(tree.name)} commands that are included in the ${require_plugin_utils_context_helpers.getAppTitle(context)} command line application.`;
 	if (context.env) {
@@ -231,20 +191,20 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		});
-		Object.values(tree.params).filter((param) => param.env !== false).forEach((param) => context.env.types.env.addProperty({
-			name: (0, __stryke_string_format_constant_case.constantCase)(param.name),
-			optional: param.optional ? true : void 0,
-			description: param.description,
+		Object.values(tree.arguments).filter((arg) => arg.env !== false).forEach((arg) => context.env.types.env.addProperty({
+			name: (0, __stryke_string_format_constant_case.constantCase)(arg.name),
+			optional: arg.optional ? true : void 0,
+			description: arg.description,
 			visibility: __powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-			type: param.reflection.getType(),
-			default: param.default,
+			type: arg.reflection.getType(),
+			default: arg.default,
 			tags: {
-				...param.reflection.getTags(),
+				...arg.reflection.getTags(),
 				domain: "cli"
 			}
 		}));
 	}
-	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length === command.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
+	for (const input of context.inputs.filter((input$1) => input$1.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length === command.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length + 1 && input$1.segments.slice(0, command.segments.length).every((value, index) => value === command.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
 	return tree;
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-command.cjs","names":["esbuildPlugin","reflect","ReflectionClass","ReflectionFunction","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getDynamicPathSegmentName","isCatchAllPathSegment","isDynamicPathSegment","isOptionalCatchAllPathSegment","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","extractCommandDynamicSegment","segment","getName","parameter","catchAll","segments","some","seg","extractCommandParameter","reflectCommandTree","parent","isVirtual","replace","tree","dynamics","options","params","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","icon","function","parameters","getParameters","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","reduce","obj","index","paramName","Object","keys","slice","param","values","forEach","types","addProperty","undefined","visibility","public","tags","domain","inputs","every","value"],"sources":["../../src/helpers/resolve-command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport type {\n  ReflectionParameter,\n  ReflectionProperty,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { resolveModule } from \"powerlines/lib/utilities/resolve\";\nimport {\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isCatchAllPathSegment,\n  isDynamicPathSegment,\n  isOptionalCatchAllPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandDynamicSegment,\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandParameter,\n  CommandTree,\n  NumberCommandOption,\n  NumberCommandParameter,\n  StringCommandOption,\n  StringCommandParameter\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 dynamic path segment 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 dynamic segment information.\n */\nexport function extractCommandDynamicSegment(\n  command: CommandInput,\n  segment: string,\n  reflection: ReflectionParameter\n): CommandDynamicSegment {\n  const type = reflection.getType();\n\n  if (\n    type.kind !== ReflectionKind.string &&\n    !(\n      type.kind === ReflectionKind.array &&\n      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        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const option = {\n    name: reflection.getName(),\n    segment,\n    title: reflection.getTags().title || titleCase(segment),\n    description:\n      reflection.parameter.description ||\n      resolveCommandOptionDescription(\n        type.kind,\n        !!reflection.isOptional(),\n        segment,\n        titleCase(segment),\n        reflection.getDefaultValue()\n      ),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    catchAll: command.path.segments.some(\n      seg =>\n        getDynamicPathSegmentName(segment) === seg && isCatchAllPathSegment(seg)\n    ),\n    reflection\n  } as CommandDynamicSegment;\n\n  if (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 * Extracts command positional 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 positional parameter information.\n */\nexport function extractCommandParameter(\n  command: CommandInput,\n  reflection: ReflectionParameter\n): CommandParameter {\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    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 CommandParameter;\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 StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).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    ...command,\n    title,\n    path: {\n      ...command.path,\n      dynamics: {}\n    },\n    options: getDefaultOptions(context, command),\n    params: [],\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.path.dynamics = tree.path.segments\n        .filter(segment => isDynamicPathSegment(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (parameters.length < index + 2 || !parameters[index + 1]) {\n              return obj;\n            }\n\n            const paramName = getDynamicPathSegmentName(segment);\n            obj[paramName] = extractCommandDynamicSegment(\n              command,\n              paramName,\n              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      if (parameters.length > Object.keys(tree.path.dynamics).length + 1) {\n        tree.params = parameters\n          .slice(Object.keys(tree.path.dynamics).length + 1)\n          .map(param => extractCommandParameter(command, param));\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.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.params)\n      .filter(param => param.env !== false)\n      .forEach(param =>\n        context.env.types.env.addProperty({\n          name: constantCase(param.name),\n          optional: param.optional ? true : undefined,\n          description: param.description,\n          visibility: ReflectionVisibility.public,\n          type: param.reflection.getType(),\n          default: param.default,\n          tags: {\n            ...param.reflection.getTags(),\n            domain: \"cli\"\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.cjs","names":["esbuildPlugin","reflect","ReflectionClass","ReflectionFunction","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getDefaultOptions","resolveCommandOptionDescription","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/resolve-command.mjs

@@ -1,4 +1,4 @@
-import { getAppTitle, getDynamicPathSegmentName, isCatchAllPathSegment, isDynamicPathSegment, isOptionalCatchAllPathSegment, isPathSegmentGroup } from "../plugin-utils/context-helpers.mjs";
+import { getAppTitle, isDynamicPathSegment, isPathSegmentGroup } from "../plugin-utils/context-helpers.mjs";
 import { getDefaultOptions } from "./utilities.mjs";
 import { toArray } from "@stryke/convert/to-array";
 import { appendPath } from "@stryke/path/append";
@@ -98,48 +98,18 @@ function extractCommandOption(command, reflection) {
 	return option;
 }
 /**
-* Extracts command dynamic path segment information from a type parameter reflection.
+* Extracts command positional argument information from a type parameter reflection.
 *
 * @param command - The command tree to which the parameter belongs.
-* @param segment - The command path segment corresponding to the parameter.
 * @param reflection - The type parameter reflection to extract information from.
-* @returns The extracted command dynamic segment information.
+* @returns The extracted command positional argument information.
 */
-function extractCommandDynamicSegment(command, segment, reflection) {
-	const type = reflection.getType();
-	if (type.kind !== ReflectionKind.string && !(type.kind === ReflectionKind.array && type.type.kind === ReflectionKind.string)) throw new Error(`Unsupported type for dynamic path segment "${segment}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
-	const option = {
-		name: reflection.getName(),
-		segment,
-		title: reflection.getTags().title || titleCase(segment),
-		description: reflection.parameter.description || resolveCommandOptionDescription(type.kind, !!reflection.isOptional(), segment, titleCase(segment), reflection.getDefaultValue()),
-		optional: reflection.isOptional(),
-		default: reflection.getDefaultValue(),
-		catchAll: command.path.segments.some((seg) => getDynamicPathSegmentName(segment) === seg && isCatchAllPathSegment(seg)),
-		reflection
-	};
-	if (type.kind === ReflectionKind.array) {
-		if (!option.catchAll) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" 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.`);
-		option.variadic = true;
-	}
-	if (option.catchAll) {
-		if (!option.optional && command.path.segments.some((seg) => getDynamicPathSegmentName(segment) === seg && isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is defined as a catch-all segment but is not optional. To define an optional catch-all segment, use the "[[...segment]]" syntax.`);
-		else if (option.optional && !command.path.segments.some((seg) => getDynamicPathSegmentName(segment) === seg && isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" 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.`);
-	}
-	return option;
-}
-/**
-* Extracts command positional parameter information from a type parameter reflection.
-*
-* @param command - The command tree to which the parameter belongs.
-* @param reflection - The type parameter reflection to extract information from.
-* @returns The extracted command positional parameter information.
-*/
-function extractCommandParameter(command, reflection) {
+function extractCommandArgument(command, reflection) {
 	const type = reflection.getType();
 	if (type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number && type.kind !== ReflectionKind.boolean && !(type.kind === ReflectionKind.array && (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number))) throw new Error(`Unsupported type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
 	const option = {
 		name: reflection.getName(),
+		kind: type.kind,
 		title: titleCase(reflection.getName()),
 		description: reflection.parameter.description || resolveCommandParameterDescription(type.kind, !!reflection.isOptional(), reflection.getName(), titleCase(reflection.getName()), reflection.getDefaultValue()),
 		env: constantCase(reflection.getName()),
@@ -166,14 +136,11 @@ async function reflectCommandTree(context, command, parent) {
 	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, "") : parent.title} - ` : ""}${titleCase(command.name)}${command.isVirtual ? " Commands" : ""}`;
 	const tree = {
 		alias: [],
+		icon: parent?.icon,
 		...command,
 		title,
-		path: {
-			...command.path,
-			dynamics: {}
-		},
 		options: getDefaultOptions(context, command),
-		params: [],
+		arguments: [],
 		parent: parent ?? null,
 		children: {},
 		reflection: null
@@ -200,14 +167,7 @@ async function reflectCommandTree(context, command, parent) {
 				const optionsReflection = ReflectionClass.from(parameters[0].type);
 				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
 			} else throw new Error(`The first parameter of the command handler function in "${command.entry.input.file}" must be an object literal or class type representing the command options.`);
-			tree.path.dynamics = tree.path.segments.filter((segment) => isDynamicPathSegment(segment)).reduce((obj, segment, index) => {
-				if (parameters.length < index + 2 || !parameters[index + 1]) return obj;
-				const paramName = getDynamicPathSegmentName(segment);
-				obj[paramName] = extractCommandDynamicSegment(command, paramName, parameters[index + 1]);
-				obj[paramName].description = obj[paramName].description || `The ${paramName} ${obj[paramName].catchAll ? `${obj[paramName].optional ? "optional " : ""}catch-all` : "dynamic "} segment for the ${command.name} command.`;
-				return obj;
-			}, {});
-			if (parameters.length > Object.keys(tree.path.dynamics).length + 1) tree.params = parameters.slice(Object.keys(tree.path.dynamics).length + 1).map((param) => extractCommandParameter(command, param));
+			tree.arguments = parameters.slice(1).map((arg) => extractCommandArgument(command, arg));
 		}
 	} else tree.description ??= `A collection of available ${tree.title || titleCase(tree.name)} commands that are included in the ${getAppTitle(context)} command line application.`;
 	if (context.env) {
@@ -230,20 +190,20 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		});
-		Object.values(tree.params).filter((param) => param.env !== false).forEach((param) => context.env.types.env.addProperty({
-			name: constantCase(param.name),
-			optional: param.optional ? true : void 0,
-			description: param.description,
+		Object.values(tree.arguments).filter((arg) => arg.env !== false).forEach((arg) => context.env.types.env.addProperty({
+			name: constantCase(arg.name),
+			optional: arg.optional ? true : void 0,
+			description: arg.description,
 			visibility: ReflectionVisibility.public,
-			type: param.reflection.getType(),
-			default: param.default,
+			type: arg.reflection.getType(),
+			default: arg.default,
 			tags: {
-				...param.reflection.getTags(),
+				...arg.reflection.getTags(),
 				domain: "cli"
 			}
 		}));
 	}
-	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !isDynamicPathSegment(segment)).length === command.path.segments.filter((segment) => !isDynamicPathSegment(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
+	for (const input of context.inputs.filter((input$1) => input$1.segments.filter((segment) => !isDynamicPathSegment(segment)).length === command.segments.filter((segment) => !isDynamicPathSegment(segment)).length + 1 && input$1.segments.slice(0, command.segments.length).every((value, index) => value === command.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
 	return tree;
 }