@shell-shock/core 0.11.0 → 0.12.1

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":";;;;;;;;;AAEA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;CAUP,MAAM,SAAS,EAAE,YAAY,KAAG,IAAA,UAAA;;AAEhC,KAAI,SAAS,eAAe;UAGnB,SAAQ,eAAA,UACb,SAAS,eAAG,UACd,CAAA,UACI,KAAA,SAAA,eAAA,YACG,SAAS,KAAK,QAAQ,IAAI,SAAC,KAAA,QAAA,EACjC,QAAA,sBAAA;UAEM,SAAI,eAAA,QACT,QAAO,sBAAK;KAGZ,QAAO,sBAAsB;;AAGrC,4BAA4B,SAAS;CAAC;OAAc;CAAI;CAAA;CAAA;CAAA;CAAA;AACxD,SAAS,qBAAqB,KAAK,YAAY;CAC3C,MAAM,OAAE,WAAA,SAAA;CACR,MAAM,WAAO,IAAA,OAAA,QAAA,WAAA,iBAAA,KACT,EAAG;CACP,MAAM,SAAS;EACX,MAAC,WAAA,iBAAA;EACD,OAAO,WAAS,SAAA,CAAA,SAAA,EAAA;EAChB,OAAO,WAAQ,SAAA,CAAA,OAAA,MAAA;EACf,aAAS,WAAA,gBAAA;EACT,MAAM,4BAA4B,KAAK;EACvC,UAAU,WAAW,YAAY;EACjC,SAAS,WAAW,iBAAiB;;EAExC;AACD,KAAI,WAAW,SAAS,CACpB,KAAI,KAAK,KAAK,SAAE,eAAA,UACZ,KAAK,KAAK,SAAS,eAAe,QAAQ;AAC1C,SAAO,WACH;AACJ,SAAO,OACP,4BAAA,KAAA,KAAA,KAAA;OAGA,OAAE,IAAA,MAAA,sCAAA,WAAA,iBAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,wDAAA,cAAA,KAAA,CACG,MAAM,CACN,WAAW,OAAO,QAAQ,CAAA,GAAI;UAGlC,KAAK,SAAS,eAAe,OAAI;AACtC,SAAO,OAAO,KAAK,MAAM,MAAM,cAAC,MAAA,EAAA,SAAA,eAAA,UAC/B,EAAA,SAAA,eAAA,YACQ,SAAS,EAAE,QAAQ,IAAG,SAAA,EAAA,QAAA,GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,GACrC,sBAAA,SACF,sBAAA;mBAEY,KAAK,MACA,IAAI,cAAC,MAAA,EAAA,SAAA,eAAA,UACJ,SAAS,EAAE,QAAE,GACd,EAAA,UACK,SAAS,EAAE,QAAE,GACT,OAAO,EAAE,QAAQ,GACjB,SAAO,EAAA,QAAA,sBAEhB,OAAA,EAAA,QAAA,GACC,MAAM;GAAC;GAAK;GAAI;GAAI,CAAA,CAAA,CACrB,OAAO,QAAQ;YAEnB,KAAK,SAAS,eAAe,QAClC,QAAO,UAAU,CACb,SAAS,KAAK,QAAQ,GAChB,KAAK,UACL,SAAS,KAAK,QAAC,GAC9B,OAAA,KAAA,QAAA,4BAEuB,KAAE,QAAA,SACrB,OAAA,KAAA,QAAA,CACE,CAAC,OAAO,QAAQ;UAEnB,CAAA,SAAA,QACE,KAAK,SAAS,eAAe,WAC7B,KAAI,SAAA,eAAA,UACJ,KAAK,SAAS,eAAe,OAC7B,OAAM,IAAI,MAAM,gCAAgC,WAAW,iBAAC,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,iFAAA,cAAA,KAAA,CACvD,MAAM,CACN,WAAO,OAAA,QAAA,CAAA,GAAA;AAEhB,QAAO,sBAAU,UAAA,OAAA;;AAErB,qBAAqB,SAAS;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAC/B,SAAS,uBAAuB,KAAK,OAAO,YAAY;CACpD,MAAM,OAAG,WAAA,SAAA;CACT,MAAI,WAAA,IAAA,OAAA,KAAA,SAAA,QAAA,IAAA,OAAA,KAAA,SAAA,EAAA;AACJ,KAAI,CAAC,SAAO,QACR,KAAK,SAAS,eAAe,UAC9B,KAAA,SAAA,eAAA,UACH,KAAA,SAAA,eAAA,WACI,EAAE,KAAK,SAAS,eAAe,UAC1B,KAAK,KAAK,SAAS,eAAE,UACzB,KAAA,KAAA,SAAA,eAAA,SACD,OAAM,IAAI,MAAM,kCAAkB,WAAA,SAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,wEAAA,cAAA,KAAA,CAC7B,MAAM,CACN,WAAW,OAAO,QAAQ,CAAA,GAAI;CAEvC,MAAM,WAAW;EACb,MAAM,WAAW,SAAS,IAAE,WAAA,UAAA;;EAE5B,MAAM,4BAA4B,KAAK,KAAK;EAC5C,OAAO,WAAA,UAAA,IAAA,WAAA,UAAA,MAAA;EACP,aAAQ,WAAA,UAAA;EACR,UAAU,WAAW,YAAY;EACjC,SAAS,WAAW,iBAAI;EAC3B;AACD,KAAI,KAAK,SAAS,eAAY,OAC1B;MAAI,KAAK,KAAK,SAAS,eAAG,UACtB,KAAK,KAAK,SAAS,eAAK,QAAA;AACxB,YAAS,WACL;AACJ,YAAK,OACT,4BAAA,KAAA,KAAA,KAAA;aAES,CAAC,SAAS,KACf,OAAM,IAAI,MAAM,wCAAwC,WAAM,SAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,wDAAA,cAAA,KAAA,CACzD,MAAM,CACN,WAAI,OAAA,QAAA,CAAA,GAAA;YAGR,CAAC,SAAS,QACf,KAAK,SAAS,eAAU,WACxB,KAAK,SAAS,eAAW,UACzB,KAAK,SAAS,eAAe,OAC7B,OAAI,IAAA,MAAA,kCAAA,WAAA,SAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,iFAAA,cAAA,KAAA,CACC,MAAM,CACN,WAAW,OAAO,QAAQ,CAAA,GAAG;AAEtC,QAAO,sBAAsB,UAAK,UAAA,EAClC,MAAA,MAAA,SACC,CAAC;;AAEN,uBAAuB,SAAM;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAC7B,SAAgB,oBAAoB,KAAK;CACrC,MAAM,EAAC,OAAA,WAAA;CACP,MAAE,OAAA,QAAA,OAAA;AACF,KAAI,KAAK,SAAC,eAAA,SACN,OAAM,IAAI,MAAM,2BAAa,MAAA,QAAA,MAAA,OAAA,QAAA,MAAA,QAAA,KAAA,qCAAA;CAEnC,MAAA,aAAA,IAAA,mBAAA,KAAA;6DAEM,WAAW,gBAAgB,IACnC,KAAA;;AAEI,KAAI,WAAW,SAAS,KAAG,WAAA,IAAA;AACvB,MAAI,WAAU,GAAA,KAAA,SAAA,eAAA,iBACV,WAAG,GAAA,KAAA,SAAA,eAAA,OAAA;GACH,MAAM,oBAAc,gBAAA,KAAA,WAAA,GAAA,KAAA;AACpB,QAAK,MAAE,sBAAA,kBAAA,eAAA,CACH,KAAI,OAAO,QAAQ,mBAAA,iBAAA,IAChB,qBAAA,KAAA,mBAAA;kCAId,OAAA,IAAA,MAAA,2DAAA,IAAA,MAAA,QAAA,MAAA,OAAA,QAAA,IAAA,MAAA,QAAA,KAAA,6EAAA;AAEG,MAAI,OAAO,OAAO,WACb,MAAM,EAAE,CACR,IAAI,cAAc,KAAK,UAAM,uBAAA,KAAA,OAAA,IAAA,EAAA;GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;;;AAG1C,oBAAoB,SAAS;CAAC;CAAmB;CAAA;CAAA;CAAA"}

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,23 +105,24 @@ 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\"\"/#"
 ];
 function resolveVirtualCommand(ctx) {
 	ctx.output.title ??= (0, __stryke_string_format_title_case.titleCase)(ctx.input.command.name);
-	ctx.output.description ??= `A collection of available ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim() || (0, __stryke_string_format_title_case.titleCase)(ctx.input.command.name)} commands that are included in the ${require_context_helpers.getAppTitle(ctx.input.context)} command-line application.`;
+	ctx.output.description ??= `A collection of available ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim() || (0, __stryke_string_format_title_case.titleCase)(ctx.input.command.name)} commands that are included in the ${require_context_helpers.getAppTitle(ctx.input.context, true)} command-line application.`;
 }
 resolveVirtualCommand.__type = [
 	"ResolverContext",

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    true\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,23 +104,24 @@ 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\"\"/#"
 ];
 function resolveVirtualCommand(ctx) {
 	ctx.output.title ??= titleCase(ctx.input.command.name);
-	ctx.output.description ??= `A collection of available ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim() || titleCase(ctx.input.command.name)} commands that are included in the ${getAppTitle(ctx.input.context)} command-line application.`;
+	ctx.output.description ??= `A collection of available ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim() || titleCase(ctx.input.command.name)} commands that are included in the ${getAppTitle(ctx.input.context, true)} command-line application.`;
 }
 resolveVirtualCommand.__type = [
 	"ResolverContext",

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":"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"}
+{"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    true\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/module.cjs

@@ -89,7 +89,7 @@ async function resolveFromExports(ctx) {
 			"param0",
 			"",
 			"P\"2!\"/\""
-		])));
+		])).concat(Object.entries(ctx.output.options)));
 	} else if (Object.values(ctx.module.options).every(require_type_checks.isCommandParameterConfig)) ctx.output.options = Object.fromEntries(Object.entries(ctx.module.options).map(__assignType(([name, option]) => [name, {
 		name,
 		...option,
@@ -98,7 +98,7 @@ async function resolveFromExports(ctx) {
 		"param0",
 		"",
 		"P\"2!\"/\""
-	])));
+	])).concat(Object.entries(ctx.output.options)));
 	else throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`);
 	if ((0, __stryke_type_checks_is_set_object.isSetObject)(ctx.module?.args)) if ((0, __stryke_zod.isZod3Type)(ctx.module.args) || (0, __stryke_json.isStandardJsonSchema)(ctx.module.args) || (0, __stryke_json.isJsonSchema7TupleType)(ctx.module.args)) {
 		let jsonSchema;

package/dist/resolver/module.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.cjs","names":[],"sources":["../../src/resolver/module.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (result.kind === CommandParameterKinds.boolean) {\n    result.skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    result.isNegativeOf = (schema as { isNegativeOf?: string }).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options as JsonSchema7ObjectType;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries((jsonSchema as JsonSchema7ObjectType).properties).map(\n          ([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ]\n        )\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        ).map(([name, option]) => [\n          name,\n          { name, ...option, alias: toArray(option.alias) }\n        ])\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;AAE3D,IAAG,SAAS;;;AA2BhB,SAAS,qBAAgB,MAAA,QAAA,QAAA;CACrB,MAAM,SAAS;EACX;EACA,gDAAa,OAAA,IAAA,OAAA,mDACiB,OAAO,MAAM,GACjC,4CAAsB,SACtB,4CAAsB,qDACD,OAAO,GAClC,4CAAA,qDACK,OAAA,GACF,4CAAA,SACO,4CAAE;EAChB,OAAC,OAAA;EACD,aAAa,OAAE;EACf,8CAAS,OAAA,SAAA,EAAA,CAAA;EACT,KAAK,OAAO;EACZ,UAAU,CAAC,OAAO,UAAU,SAAS,KAAC;;EAEzC;AACD,KAAI,OAAM,SAAA,4CAAA,UACN,OAAO,SAAS,4CAAO,QAAA;AACvB,SAAO,qDAAS,OAAA;AAChB,MAAI,OAAO,SAAO,4CAAA,OACd,QAAK,SAAA,OAAA;AAET,kDAAA,OAAA,+CAAA,OAAA,KACI,OAAO,KACP,QAAO,UAAU,OAAO;YAGvB,OAAO,SAAS,4CAAY,SAAA;AACjC,SAAO,qBAAqB,OAAI;AAChC,SAAO,eAAe,OAAO;;AAEjC,QAAO;;AAEX,qBAAqB,SAAS;CAAC;CAAI;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AACnC,SAAS,uBAAuB,QAAQ;CACpC,MAAM,SAAS;EACX,MAAM,OAAO;EACb,gDAAkB,OAAA,IAAA,OAAA,mDACG,OAAA,MAAA,GACxB,4CAAA,SACa,4CAAsB,qDACD,OAAO,GAC1C,4CAAA,qDACsC,OAAO,GAC3B,4CAAsB,SACtB,4CAAA;EACd,OAAO,OAAO;EACd,aAAM,OAAA;EACV,8CAAA,OAAA,SAAA,EAAA,CAAA;;EAEG,SAAA,OAAA;EACF;AACD,KAAI,OAAO,SAAS,4CAAiB,UACnC,OAAA,SAAA,4CAAA,QAAA;AACE,SAAO,qDAAkC,OAAO;AACpD,MAAA,OAAA,SAAA,4CAAA,OACQ,QAAO,SAAS,OAAO;AAE3B,kDAA6B,OAAO,+CAAG,OAAA,KACnC,OAAO,KACP,QAAO,UAAU,OAAO;;AAGhC,QAAO;;;;;;;;;AAGX,eAAsB,mBAAS,KAAA;AAC3B,iBAAgB,IAAI;CACpB,MAAM,WAAW,IAAI,QAAG,YAAA,EAAA;AACxB,yDAAa,SAAA,MAAA,CACT,KAAI,OAAO,QAAQ,SAAS;AAEhC,yDAAgB,SAAS,YAAY,CACjC,KAAI,OAAO,cAAc,SAAS;AAEtC,yDAAgB,SAAS,MAAM,IAC1B,MAAM,QAAQ,SAAS,MAAM,IAAG,SAAA,MAAA,SAAA,EACjC,KAAI,OAAO,+CAAgB,SAAK,MAAA;AAEpC,yDAAgB,SAAS,KAAK,CAC1B,KAAI,OAAO,OAAO,SAAS;AAE/B,yDAAgB,IAAI,QAAQ,QAAG,CAC3B,kCAAe,IAAI,OAAO,QAAQ,4CACT,IAAI,OAAI,QAAA,+CACf,IAAA,OAAA,QAAA,EAAA;EACd,IAAI;AACX,mCAAA,IAAA,OAAA,QAAA,CACW,mDAAgC,IAAE,OAAA,QAAA;mDAE9C,IAAA,OAAA,QAAA,CACY,cAAa,IAAI,OAAO,QAAQ,aAAI,WAAA,MAAA,EAChC,QAAQ,YACX,CAAC;MAGd,cAAA,IAAA,OAAA;AAEG,MAAA,4CAAA,WAAA,CACS,OAAM,IAAI,UAAU,wCAAwC,IAAA,MAAA,QAAA,KAAA,mGAAA;AAEtE,MAAA,OAAA,UAAA,OAAA,YAAA,OAAA,QAAA,WAAA,WAAA,CAAA,IAAA,cAAA,CAAA,MAAA,cAAA,CACU,MACZ,qBAAA,MAAA,YAAA,SAAA,CACF,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CAAA;YAEa,OAAA,OAAA,IAAA,OAAA,QAAA,CAAA,MAAA,6CAAA,CACf,KAAA,OAAA,UAAA,OAAA,YAAA,OAAA,QAAA,IAAA,OAAA,QAAA,CAAA,IAAA,cAAA,CAAA,MAAA,YAAA,OAEgB;EAAE;EAAM,GAAG;EAAQ,8CAAe,OAAO,MAAK;EAAG,CACpD,EAAE;EAAC;EAAU;EAAI;EAAC,CAAA,CAAA,CAAA;;AAM3B,yDAAgB,IAAI,QAAQ,KAAK,CACnC,kCAAA,IAAA,OAAA,KAAA,4CAC+B,IAAI,OAAI,KAAA,8CACN,IAAI,OAAO,KAAG,EAAA;EAC/C,IAAA;AACG,mCAAA,IAAA,OAAA,KAAA,CACW,mDAAiB,IAAA,OAAA,KAAA;mDAE7B,IAAA,OAAA,KAAA,CACY,cAAa,IAAI,OAAO,KAAK,aAAC,WAAA,MAAA,EAC5C,QAAA,YACe,CAAC;;AAKX,MAAA,2CAAA,WAAA,CACS,OAAM,IAAI,UAAU,0CAAE,IAAA,MAAA,QAAA,KAAA,8GAAA;AAE1B,MAAI,OAAO,OAAO,WAAW,MAAM,IAAC,cAAA,SAAA,uBAAA,KAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;YAE/B,OAAO,OAAO,IAAI,OAAE,KAAA,CAAA,MAAA,6CAAA,CACzB,KAAI,OAAO,OAAO,IAAI,OAAO,KAAC,IAAA,cAAA,SAAA;EAC1B,GAAG;EACH,8CAAe,IAAI,MAAK;EAC3B,GAAG;EAAC;EAAO;EAAI;EAAU,CAAC,CAAC;KAG5B,OAAC,IAAA,UAAA,0CAAA,IAAA,MAAA,QAAA,KAAA,6HAAA;;AAIb,mBAAmB,SAAS;CAAC;CAAmB;CAAA;CAAA;CAAA;AAChD,SAAS,gBAAgB,KAAE;AACvB,KAAI,CAAC,IAAI,OACL,OAAM,IAAI,MAAM,2BAAS,IAAA,MAAA,QAAA,KAAA,2EAAA;UAExB,qDAAA,IAAA,OAAA,CACH,OAAA,IAAA,UAAA,2BAAA,IAAA,MAAA,QAAA,KAAA,uEAAA;UAEO,EAAE,aAAa,IAAI,QACxB,OAAM,IAAI,MAAM,2BAA2B,IAAI,MAAM,QAAQ,KAAI,+GAAG;;AAG5E,gBAAgB,SAAS;CAAC;CAAmB;CAAO;CAAO;CAAA"}
+{"version":3,"file":"module.cjs","names":[],"sources":["../../src/resolver/module.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (result.kind === CommandParameterKinds.boolean) {\n    result.skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    result.isNegativeOf = (schema as { isNegativeOf?: string }).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options as JsonSchema7ObjectType;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries((jsonSchema as JsonSchema7ObjectType).properties)\n          .map(([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        )\n          .map(([name, option]) => [\n            name,\n            { name, ...option, alias: toArray(option.alias) }\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/module.mjs

@@ -88,7 +88,7 @@ async function resolveFromExports(ctx) {
 			"param0",
 			"",
 			"P\"2!\"/\""
-		])));
+		])).concat(Object.entries(ctx.output.options)));
 	} else if (Object.values(ctx.module.options).every(isCommandParameterConfig)) ctx.output.options = Object.fromEntries(Object.entries(ctx.module.options).map(__assignType(([name, option]) => [name, {
 		name,
 		...option,
@@ -97,7 +97,7 @@ async function resolveFromExports(ctx) {
 		"param0",
 		"",
 		"P\"2!\"/\""
-	])));
+	])).concat(Object.entries(ctx.output.options)));
 	else throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`);
 	if (isSetObject(ctx.module?.args)) if (isZod3Type(ctx.module.args) || isStandardJsonSchema(ctx.module.args) || isJsonSchema7TupleType(ctx.module.args)) {
 		let jsonSchema;

package/dist/resolver/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","names":[],"sources":["../../src/resolver/module.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (result.kind === CommandParameterKinds.boolean) {\n    result.skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    result.isNegativeOf = (schema as { isNegativeOf?: string }).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options as JsonSchema7ObjectType;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries((jsonSchema as JsonSchema7ObjectType).properties).map(\n          ([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ]\n        )\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        ).map(([name, option]) => [\n          name,\n          { name, ...option, alias: toArray(option.alias) }\n        ])\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"module.mjs","names":[],"sources":["../../src/resolver/module.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (result.kind === CommandParameterKinds.boolean) {\n    result.skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    result.isNegativeOf = (schema as { isNegativeOf?: string }).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options as JsonSchema7ObjectType;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries((jsonSchema as JsonSchema7ObjectType).properties)\n          .map(([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        )\n          .map(([name, option]) => [\n            name,\n            { name, ...option, alias: toArray(option.alias) }\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\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!\"/\""