@shell-shock/core 0.11.0 → 0.12.0

package/dist/resolver/deepkit.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/resolver/deepkit.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 {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray,\n  TypeLiteral\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  if (type === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    type === ReflectionKind.number ||\n    type === ReflectionKind.bigint ||\n    ((type as Type).kind === ReflectionKind.literal &&\n      (isNumber((type as TypeLiteral).literal) ||\n        isBigInt((type as TypeLiteral).literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (type === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\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 StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\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        ctx.input.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 mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.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    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.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 mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = 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        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/resolver/deepkit.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 {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  const isKind = !(isSetObject(type) && \"kind\" in type);\n  const kind = !isKind ? type.kind : type;\n  if (kind === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    kind === ReflectionKind.number ||\n    kind === ReflectionKind.bigint ||\n    (!isKind &&\n      type.kind === ReflectionKind.literal &&\n      (isNumber(type.literal) || isBigInt(type.literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (kind === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\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 StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\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        ctx.input.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 mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.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    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.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 mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = 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        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/deepkit.mjs

@@ -1,5 +1,6 @@
 import { CommandParameterKinds } from "../types/command.mjs";
 import { mergeCommandParameter } from "./helpers.mjs";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { ReflectionClass, ReflectionFunction, ReflectionKind, __ΩReflectionKind, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
 import { isBigInt } from "@stryke/type-checks/is-bigint";
 import { isNumber } from "@stryke/type-checks/is-number";
@@ -11,9 +12,11 @@ function __assignType(fn, args) {
 	return fn;
 }
 function extractCommandParameterKind(type) {
-	if (type === ReflectionKind.string) return CommandParameterKinds.string;
-	else if (type === ReflectionKind.number || type === ReflectionKind.bigint || type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return CommandParameterKinds.number;
-	else if (type === ReflectionKind.boolean) return CommandParameterKinds.boolean;
+	const isKind = !(isSetObject(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === ReflectionKind.string) return CommandParameterKinds.string;
+	else if (kind === ReflectionKind.number || kind === ReflectionKind.bigint || !isKind && type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return CommandParameterKinds.number;
+	else if (kind === ReflectionKind.boolean) return CommandParameterKinds.boolean;
 	else return CommandParameterKinds.string;
 }
 extractCommandParameterKind.__type = [

package/dist/resolver/deepkit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deepkit.mjs","names":[],"sources":["../../src/resolver/deepkit.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 {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray,\n  TypeLiteral\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  if (type === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    type === ReflectionKind.number ||\n    type === ReflectionKind.bigint ||\n    ((type as Type).kind === ReflectionKind.literal &&\n      (isNumber((type as TypeLiteral).literal) ||\n        isBigInt((type as TypeLiteral).literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (type === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\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 StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\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        ctx.input.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 mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.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    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.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 mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = 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        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"deepkit.mjs","names":[],"sources":["../../src/resolver/deepkit.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 {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  const isKind = !(isSetObject(type) && \"kind\" in type);\n  const kind = !isKind ? type.kind : type;\n  if (kind === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    kind === ReflectionKind.number ||\n    kind === ReflectionKind.bigint ||\n    (!isKind &&\n      type.kind === ReflectionKind.literal &&\n      (isNumber(type.literal) || isBigInt(type.literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (kind === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\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 StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\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        ctx.input.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 mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.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    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.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 mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = 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        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/helpers.cjs

@@ -9,12 +9,6 @@ let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
 let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
 
 //#region src/resolver/helpers.ts
-const __ΩRecord = [
-	"K",
-	"T",
-	"Record",
-	"l'e#\"Rb!b\"Pde\"!N#!w#y"
-];
 function __assignType(fn, args) {
 	fn.__type = args;
 	return fn;
@@ -69,8 +63,8 @@ resolveCommandArgumentDescription.__type = [
 	"resolveCommandArgumentDescription",
 	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
 ];
-function applyOptionsDefaults(options) {
-	return Object.fromEntries(Object.entries(options).map(__assignType(([key, option]) => {
+function applyOptionsDefaults(ctx) {
+	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
 		const name = option.name || key;
 		const title = option.title || (0, __stryke_string_format_title_case.titleCase)(name);
 		return [key, {
@@ -78,7 +72,7 @@ function applyOptionsDefaults(options) {
 			name,
 			title,
 			description: option.description || resolveCommandOptionDescription(name, option.kind, option.optional, option.kind !== require_types_command.CommandParameterKinds.boolean && option.variadic, title, option.default),
-			env: option.env || (0, __stryke_string_format_constant_case.constantCase)(key)
+			env: option.env || option.env === false ? option.env : ctx.input.context.config.autoAssignEnv ? (0, __stryke_string_format_constant_case.constantCase)(name) : false
 		}];
 	}, [
 		"param0",
@@ -87,14 +81,13 @@ function applyOptionsDefaults(options) {
 	])));
 }
 applyOptionsDefaults.__type = [
-	() => __ΩRecord,
-	"CommandOption",
-	"options",
+	"ResolverContext",
+	"ctx",
 	"applyOptionsDefaults",
-	"P&\"w\"o!#2#\"/$"
+	"P\"w!2\"\"/#"
 ];
-function applyArgsDefaults(args) {
-	return args.map(__assignType((arg, i) => {
+function applyArgsDefaults(ctx) {
+	return ctx.output.args.map(__assignType((arg, i) => {
 		const name = arg.name || `arg${i + 1}`;
 		const title = arg.title || (0, __stryke_string_format_title_case.titleCase)(name);
 		return {
@@ -102,7 +95,7 @@ function applyArgsDefaults(args) {
 			name,
 			title,
 			description: arg.description || resolveCommandArgumentDescription(name, arg.kind, arg.optional, arg.kind !== require_types_command.CommandParameterKinds.boolean && arg.variadic, title, arg.default),
-			env: arg.name ? arg.env || arg.env === false ? arg.env : (0, __stryke_string_format_constant_case.constantCase)(name) : false
+			env: arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? (0, __stryke_string_format_constant_case.constantCase)(name) : false : false
 		};
 	}, [
 		"arg",
@@ -112,17 +105,18 @@ function applyArgsDefaults(args) {
 	]));
 }
 applyArgsDefaults.__type = [
+	"ResolverContext",
+	"ctx",
 	"CommandArgument",
-	"args",
 	"applyArgsDefaults",
-	"P\"w!F2\"\"w!F/#"
+	"P\"w!2\"\"w#F/$"
 ];
-function applyDefaults(context) {
-	context.output.description ??= `The ${context.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
+function applyDefaults(ctx) {
+	ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
 }
 applyDefaults.__type = [
 	"ResolverContext",
-	"context",
+	"ctx",
 	"applyDefaults",
 	"P\"w!2\"\"/#"
 ];

package/dist/resolver/helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.cjs","names":[],"sources":["../../src/resolver/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 { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport { getAppTitle } from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(options: Record<string, CommandOption>) {\n  return Object.fromEntries(\n    Object.entries(options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env: option.env || constantCase(key)\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(args: CommandArgument[]): CommandArgument[] {\n  return args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : constantCase(name)\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(context: ResolverContext) {\n  context.output.description ??= `The ${context.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":"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"}
+{"version":3,"file":"helpers.cjs","names":[],"sources":["../../src/resolver/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 { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport { getAppTitle } from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":"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"}

package/dist/resolver/helpers.mjs

@@ -8,12 +8,6 @@ import { getUniqueBy } from "@stryke/helpers/get-unique";
 import { isString } from "@stryke/type-checks/is-string";
 
 //#region src/resolver/helpers.ts
-const __ΩRecord = [
-	"K",
-	"T",
-	"Record",
-	"l'e#\"Rb!b\"Pde\"!N#!w#y"
-];
 function __assignType(fn, args) {
 	fn.__type = args;
 	return fn;
@@ -68,8 +62,8 @@ resolveCommandArgumentDescription.__type = [
 	"resolveCommandArgumentDescription",
 	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
 ];
-function applyOptionsDefaults(options) {
-	return Object.fromEntries(Object.entries(options).map(__assignType(([key, option]) => {
+function applyOptionsDefaults(ctx) {
+	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
 		const name = option.name || key;
 		const title = option.title || titleCase(name);
 		return [key, {
@@ -77,7 +71,7 @@ function applyOptionsDefaults(options) {
 			name,
 			title,
 			description: option.description || resolveCommandOptionDescription(name, option.kind, option.optional, option.kind !== CommandParameterKinds.boolean && option.variadic, title, option.default),
-			env: option.env || constantCase(key)
+			env: option.env || option.env === false ? option.env : ctx.input.context.config.autoAssignEnv ? constantCase(name) : false
 		}];
 	}, [
 		"param0",
@@ -86,14 +80,13 @@ function applyOptionsDefaults(options) {
 	])));
 }
 applyOptionsDefaults.__type = [
-	() => __ΩRecord,
-	"CommandOption",
-	"options",
+	"ResolverContext",
+	"ctx",
 	"applyOptionsDefaults",
-	"P&\"w\"o!#2#\"/$"
+	"P\"w!2\"\"/#"
 ];
-function applyArgsDefaults(args) {
-	return args.map(__assignType((arg, i) => {
+function applyArgsDefaults(ctx) {
+	return ctx.output.args.map(__assignType((arg, i) => {
 		const name = arg.name || `arg${i + 1}`;
 		const title = arg.title || titleCase(name);
 		return {
@@ -101,7 +94,7 @@ function applyArgsDefaults(args) {
 			name,
 			title,
 			description: arg.description || resolveCommandArgumentDescription(name, arg.kind, arg.optional, arg.kind !== CommandParameterKinds.boolean && arg.variadic, title, arg.default),
-			env: arg.name ? arg.env || arg.env === false ? arg.env : constantCase(name) : false
+			env: arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? constantCase(name) : false : false
 		};
 	}, [
 		"arg",
@@ -111,17 +104,18 @@ function applyArgsDefaults(args) {
 	]));
 }
 applyArgsDefaults.__type = [
+	"ResolverContext",
+	"ctx",
 	"CommandArgument",
-	"args",
 	"applyArgsDefaults",
-	"P\"w!F2\"\"w!F/#"
+	"P\"w!2\"\"w#F/$"
 ];
-function applyDefaults(context) {
-	context.output.description ??= `The ${context.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
+function applyDefaults(ctx) {
+	ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
 }
 applyDefaults.__type = [
 	"ResolverContext",
-	"context",
+	"ctx",
 	"applyDefaults",
 	"P\"w!2\"\"/#"
 ];

package/dist/resolver/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/resolver/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 { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport { getAppTitle } from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(options: Record<string, CommandOption>) {\n  return Object.fromEntries(\n    Object.entries(options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env: option.env || constantCase(key)\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(args: CommandArgument[]): CommandArgument[] {\n  return args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : constantCase(name)\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(context: ResolverContext) {\n  context.output.description ??= `The ${context.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":";;;;;;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;;;;;;;;;;;;AAuChB,SAAgB,gCAAgC,MAAM,MAAG,WAAA,OAAA,WAAA,OAAA,OAAA,cAAA;AACrD,QAAO,IAAI,YAAY,CAAC,eAAe,eAAe,GAAE,gBAAY,SAAA,sBAAA,UAAA,SAAA,SAAA,2BAAA,SAAA,sBAAA,UAC9D,YACR,WACY,mBACA,mBAAA,GAAA,OAAA,MAAA,IAAA,UAAA,KAAA,CAAA,GAAA,SAAA,sBAAA,UACJ,cACA,GAAG,SAAK,sBAAA,SAAA,YAAA,SAAA,QAAA,WAAA,MAAA,KAAA;;AAElB,gCAAgB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYhB,SAAgB,kCAAyB,MAAA,MAAA,WAAA,OAAA,WAAA,OAAA,OAAA,cAAA;AACrC,QAAO,KAAK,YAAE,CAAA,eAAA,cAAA,GAAA,oCAAA,SAAA,sBAAA,UACR,YACA,WACD,mBACJ,mBAAA,GAAA,OAAA,MAAA,IAAA,UAAA,KAAA,CAAA,GAAA,SAAA,sBAAA,UACL;;AAGA,kCAAkC,SAAS;CAAC;CAAQ;CAAsB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAC1E,SAAC,qBAAA,SAAA;AACG,QAAO,OAAO,YAAY,OAAO,QAAQ,QAAI,CAAA,IAAA,cAAA,CAAA,KAAA,YAAA;EACzC,MAAM,OAAO,OAAO,QAAQ;EAC5B,MAAM,QAAQ,OAAO,SAAS,UAAU,KAAK;AAC7C,SAAO,CACH,KACA;GACI,GAAG;GACjB;GACc;GACF,aAAA,OAAA,eACM,gCAAQ,MAAA,OAAA,MAAA,OAAA,UAAA,OAAA,SAAA,sBAAA,WAAA,OAAA,UAAA,OAAA,OAAA,QAAA;GACZ,KAAE,OAAA,OAAA,aAAA,IAAA;GACL,CACJ;IACF;EAAC;EAAU;EAAC;EAAA,CAAA,CAAA,CAAA;;AAEnB,qBAAa,SAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACb,SAAgB,kBAAkB,MAAM;AACpC,QAAO,KAAK,IAAI,cAAc,KAAI,MAAA;EAC9B,MAAM,OAAO,IAAI,QAAQ,MAAM,IAAE;EACjC,MAAM,QAAE,IAAA,SAAA,UAAA,KAAA;AACR,SAAO;GACH,GAAG;GACH;GACA;GACA,aAAa,IAAI,eACb,kCAAE,MAAA,IAAA,MAAA,IAAA,UAAA,IAAA,SAAA,sBAAA,WAAA,IAAA,UAAA,OAAA,IAAA,QAAA;GACN,KAAK,IAAI,OACH,IAAI,OAAM,IAAA,QAAA,QACnB,IAAA,MACJ,aAAA,KAAA,GACL;;IAEO;EAAC;EAAO;EAAK;EAAI;EAAa,CAAC,CAAC;;AAEvC,kBAAkB,SAAS;CAAC;CAAmB;CAAI;CAAA;CAAA;AACnD,SAAgB,cAAc,SAAO;AACjC,SAAQ,OAAO,gBAAgB,OAAO,QAAQ,OAAC,MAAA,QAAA,oBAAA,GAAA,CAAA,MAAA,CAAA;;AAEnD,cAAa,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACb,SAAW,sBAAA,KAAA;AACP,KAAI,OAAA,UAAA,UAAA,IAAA,MAAA,QAAA,KAAA;AACJ,KAAI,OAAO,gBAAI,6BAAA,IAAA,OAAA,MAAA,QAAA,oBAAA,GAAA,CAAA,MAAA,IACX,UAAM,IAAA,MAAA,QAAA,KAAA,CAAA,qCAAA,YAAA,IAAA,MAAA,QAAA,CAAA;;AAEd,sBAAqB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQrB,MAAa,wBAAc,WAAA,cAAA,KAAA,KAAA,UAAA;AACvB,KAAI,SAAK,IAAA,KAAA,IAAA,SAAA,MAAA,EAAA;AACL,MAAI,YAAY,MAAM,CACtB,KAAA,OAAA;AAEH,SAAA;YAEL,MAAA,QAAA,IAAA,KAAA,IAAA,MAAA,QAAA,MAAA,EAAA;uBAEY,KAAI,OAAO,YAAY,IAAI,KAAK,OAAO,MAAM,EAAE,cAAa,SAAM,SAAA,KAAA,GAAA,OAAA,KAAA,UAAA,KAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;AAEtE,SAAO;;;GAGZ;CAAC;CAAO;CAAA;CAAA;CAAA;CAAA,CAAA,CAAA"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/resolver/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 { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport { getAppTitle } from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":"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"}

package/dist/resolver/resolve.cjs

@@ -51,39 +51,39 @@ initialize.__type = [
 	"P\"w!2\"\"w#`/$"
 ];
 async function postprocess(ctx) {
-	ctx.output.options = require_helpers.applyOptionsDefaults(ctx.output.options);
-	ctx.output.args = require_helpers.applyArgsDefaults(ctx.output.args);
-	ctx.output.args.forEach(__assignType((argument, index) => {
-		const found = ctx.output.args.findIndex(__assignType((arg) => arg.name === argument.name, [
-			"arg",
+	ctx.output.options = require_helpers.applyOptionsDefaults(ctx);
+	ctx.output.args = require_helpers.applyArgsDefaults(ctx);
+	ctx.output.args.forEach(__assignType((arg, index) => {
+		const found = ctx.output.args.findIndex(__assignType((a) => a.name === arg.name, [
+			"a",
 			"",
 			"P\"2!\"/\""
 		]));
-		if (found !== -1 && found !== index || ctx.output.segments.some(__assignType((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment) === argument.name, [
+		if (found !== -1 && found !== index || ctx.output.segments.some(__assignType((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment) === arg.name, [
 			"segment",
 			"",
 			"P\"2!\"/\""
 		]))) {
-			argument.name += `_${ctx.output.segments.filter(__assignType((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === argument.name, [
+			arg.name += `_${ctx.output.segments.filter(__assignType((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === arg.name, [
 				"segment",
 				"",
 				"P\"2!\"/\""
-			])).length + ctx.output.args.filter(__assignType((arg) => arg.name.replace(/_\d+$/, "") === argument.name, [
-				"arg",
+			])).length + ctx.output.args.filter(__assignType((a) => a.name.replace(/_\d+$/, "") === arg.name, [
+				"a",
 				"",
 				"P\"2!\"/\""
 			])).length}`;
-			argument.env = (0, __stryke_string_format_constant_case.constantCase)(argument.name);
+			arg.env = arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? (0, __stryke_string_format_constant_case.constantCase)(arg.name) : false : false;
 		}
 	}, [
-		"argument",
+		"arg",
 		"index",
 		"",
 		"P\"2!\"2\"\"/#"
 	]));
 	require_helpers.applyDefaults(ctx);
 	if (ctx.input.context.env) {
-		if ((0, __stryke_type_checks_is_set_object.isSetObject)(ctx.output.options)) Object.values(ctx.output.options).filter(__assignType((option) => option.env !== false, [
+		if ((0, __stryke_type_checks_is_set_object.isSetObject)(ctx.output.options)) Object.values(ctx.output.options).filter(__assignType((option) => Boolean(option.env), [
 			"option",
 			"",
 			"P\"2!\"/\""
@@ -114,7 +114,7 @@ async function postprocess(ctx) {
 			"",
 			"P\"2!\"/\""
 		]));
-		ctx.output.args.filter(__assignType((arg) => arg.env !== false, [
+		ctx.output.args.filter(__assignType((arg) => Boolean(arg.env), [
 			"arg",
 			"",
 			"P\"2!\"/\""

package/dist/resolver/resolve.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.cjs","names":[],"sources":["../../src/resolver/resolve.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 { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\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 { getDefaultOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getDefaultOptions(context, command),\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\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    result.module = 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\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx.output.options);\n  ctx.output.args = applyArgsDefaults(ctx.output.args);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((argument, index) => {\n    const found = ctx.output.args.findIndex(arg => arg.name === argument.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === argument.name\n      )\n    ) {\n      argument.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") ===\n              argument.name\n        ).length +\n        ctx.output.args.filter(\n          arg => arg.name.replace(/_\\d+$/, \"\") === argument.name\n        ).length\n      }`;\n      argument.env = constantCase(argument.name);\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          ctx.input.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: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => arg.env !== false)\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  for (const input of ctx.input.context.inputs.filter(\n    input =>\n      input.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        ctx.input.command.segments.filter(\n          segment => !isDynamicPathSegment(segment)\n        ).length +\n          1 &&\n      input.segments\n        .slice(0, ctx.input.command.segments.length)\n        .every((value, index) => value === ctx.input.command.segments[index])\n  )) {\n    ctx.output.children[input.name] = await resolve<TContext>({\n      context: ctx.input.context,\n      command: input,\n      parent: ctx.output\n    });\n  }\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve.cjs","names":[],"sources":["../../src/resolver/resolve.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 { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\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 { getDefaultOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getDefaultOptions(context, command),\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\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    result.module = 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\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.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: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  for (const input of ctx.input.context.inputs.filter(\n    input =>\n      input.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        ctx.input.command.segments.filter(\n          segment => !isDynamicPathSegment(segment)\n        ).length +\n          1 &&\n      input.segments\n        .slice(0, ctx.input.command.segments.length)\n        .every((value, index) => value === ctx.input.command.segments[index])\n  )) {\n    ctx.output.children[input.name] = await resolve<TContext>({\n      context: ctx.input.context,\n      command: input,\n      parent: ctx.output\n    });\n  }\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}