@shell-shock/core 0.17.2 → 0.17.3

package/dist/resolver/deepkit.cjs

@@ -21,12 +21,10 @@ function extractCommandParameterKind(type) {
 	else return require_types_command.CommandParameterKinds.string;
 }
 extractCommandParameterKind.__type = [
-	"Type",
-	() => _powerlines_deepkit_vendor_type.__ΩReflectionKind,
 	"type",
 	"CommandParameterKind",
 	"extractCommandParameterKind",
-	"PP\"w!n\"J2#\"w$/%"
+	"PP!!J2!\"w\"/#"
 ];
 function resolveCommandOption(ctx, reflection) {
 	const type = reflection.getType();
@@ -60,11 +58,10 @@ function resolveCommandOption(ctx, reflection) {
 resolveCommandOption.__type = [
 	"ResolverContext",
 	"ctx",
-	"ReflectionProperty",
 	"reflection",
 	"CommandOption",
 	"resolveCommandOption",
-	"P\"w!2\"\"w#2$\"w%/&"
+	"P\"w!2\"!2#\"w$/%"
 ];
 function resolveCommandArgument(ctx, index, reflection) {
 	const type = reflection.getType();
@@ -101,11 +98,10 @@ resolveCommandArgument.__type = [
 	"ResolverContext",
 	"ctx",
 	"index",
-	"ReflectionParameter",
 	"reflection",
 	"CommandArgument",
 	"resolveCommandArgument",
-	"P\"w!2\"'2#\"w$2%\"w&/'"
+	"P\"w!2\"'2#!2$\"w%/&"
 ];
 function resolveFromBytecode(ctx) {
 	const { input, module } = ctx;
@@ -136,5 +132,4 @@ resolveFromBytecode.__type = [
 ];
 
 //#endregion
-exports.resolveFromBytecode = resolveFromBytecode;
-//# sourceMappingURL=deepkit.cjs.map
+exports.resolveFromBytecode = resolveFromBytecode;

package/dist/resolver/deepkit.mjs

@@ -1,7 +1,7 @@
 import { CommandParameterKinds } from "../types/command.mjs";
 import { mergeCommandParameter } from "./helpers.mjs";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
-import { ReflectionClass, ReflectionFunction, ReflectionKind, __ΩReflectionKind, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
+import { ReflectionClass, ReflectionFunction, ReflectionKind, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
 import { isBigInt } from "@stryke/type-checks/is-bigint";
 import { isNumber } from "@stryke/type-checks/is-number";
 import { isRegExp } from "@stryke/type-checks/is-regexp";
@@ -20,12 +20,10 @@ function extractCommandParameterKind(type) {
 	else return CommandParameterKinds.string;
 }
 extractCommandParameterKind.__type = [
-	"Type",
-	() => __ΩReflectionKind,
 	"type",
 	"CommandParameterKind",
 	"extractCommandParameterKind",
-	"PP\"w!n\"J2#\"w$/%"
+	"PP!!J2!\"w\"/#"
 ];
 function resolveCommandOption(ctx, reflection) {
 	const type = reflection.getType();
@@ -59,11 +57,10 @@ function resolveCommandOption(ctx, reflection) {
 resolveCommandOption.__type = [
 	"ResolverContext",
 	"ctx",
-	"ReflectionProperty",
 	"reflection",
 	"CommandOption",
 	"resolveCommandOption",
-	"P\"w!2\"\"w#2$\"w%/&"
+	"P\"w!2\"!2#\"w$/%"
 ];
 function resolveCommandArgument(ctx, index, reflection) {
 	const type = reflection.getType();
@@ -100,11 +97,10 @@ resolveCommandArgument.__type = [
 	"ResolverContext",
 	"ctx",
 	"index",
-	"ReflectionParameter",
 	"reflection",
 	"CommandArgument",
 	"resolveCommandArgument",
-	"P\"w!2\"'2#\"w$2%\"w&/'"
+	"P\"w!2\"'2#!2$\"w%/&"
 ];
 function resolveFromBytecode(ctx) {
 	const { input, module } = ctx;

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} 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 (option.variadic) {\n    option.kind = extractCommandParameterKind((type as TypeArray).type.kind);\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[], number[], or literal[] 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  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 {\n      throw new Error(\n        `Unsupported array type for positional argument \"${argument.name}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[], number[], or literal[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    argument.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    (argument 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    (argument 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    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] 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) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\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    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\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 (option.variadic) {\n    option.kind = extractCommandParameterKind((type as TypeArray).type.kind);\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[], number[], or literal[] 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  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 {\n      throw new Error(\n        `Unsupported array type for positional argument \"${argument.name}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[], number[], or literal[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    argument.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    (argument 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    (argument 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    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] 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) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\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    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/helpers.cjs

@@ -36,7 +36,8 @@ resolveCommandOptionDescription.__type = [
 	"title",
 	"defaultValue",
 	"resolveCommandOptionDescription",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+	"Resolves the description for a command option based on its reflection.",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
 ];
 /**
 * Resolves the description for a command argument based on its reflection.
@@ -61,7 +62,8 @@ resolveCommandArgumentDescription.__type = [
 	"title",
 	"defaultValue",
 	"resolveCommandArgumentDescription",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+	"Resolves the description for a command argument based on its reflection.",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
 ];
 function applyOptionsDefaults(ctx) {
 	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
@@ -168,5 +170,4 @@ exports.applyArgsDefaults = applyArgsDefaults;
 exports.applyDefaults = applyDefaults;
 exports.applyOptionsDefaults = applyOptionsDefaults;
 exports.mergeCommandParameter = mergeCommandParameter;
-exports.resolveVirtualCommand = resolveVirtualCommand;
-//# sourceMappingURL=helpers.cjs.map
+exports.resolveVirtualCommand = resolveVirtualCommand;

package/dist/resolver/helpers.mjs

@@ -35,7 +35,8 @@ resolveCommandOptionDescription.__type = [
 	"title",
 	"defaultValue",
 	"resolveCommandOptionDescription",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+	"Resolves the description for a command option based on its reflection.",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
 ];
 /**
 * Resolves the description for a command argument based on its reflection.
@@ -60,7 +61,8 @@ resolveCommandArgumentDescription.__type = [
 	"title",
 	"defaultValue",
 	"resolveCommandArgumentDescription",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+	"Resolves the description for a command argument based on its reflection.",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
 ];
 function applyOptionsDefaults(ctx) {
 	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {

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 {\n  getAppTitle,\n  isDynamicPathSegment\n} 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  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\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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"}
+{"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 {\n  getAppTitle,\n  isDynamicPathSegment\n} 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  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\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

@@ -142,5 +142,4 @@ validateExports.__type = [
 ];
 
 //#endregion
-exports.resolveFromExports = resolveFromExports;
-//# sourceMappingURL=module.cjs.map
+exports.resolveFromExports = resolveFromExports;

package/dist/resolver/resolve.cjs

@@ -26,6 +26,7 @@ async function initialize(input) {
 			alias: [],
 			icon: parent?.icon,
 			tags: parent?.tags ?? [],
+			source: "file",
 			...command,
 			title,
 			options: parent === null ? require_utilities.getGlobalOptions(context, command) : {},
@@ -36,12 +37,14 @@ async function initialize(input) {
 	};
 	if (!command.isVirtual) {
 		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
-		context.debug(`Adding reflection for application command: ${command.id} (file: ${command.entry.input.file})`);
+		context.debug(`Adding reflection for CLI command: ${command.id} (file: ${command.entry.input.file})`);
 		result.module = await (_powerlines_plugin_esbuild_helpers_resolve.resolveModule.Ω = [["CommandModule", "\"w!"]], (0, _powerlines_plugin_esbuild_helpers_resolve.resolveModule)(context, command.entry.input, {
 			name: command.title || (0, _stryke_string_format_title_case.titleCase)(command.name),
+			treeShaking: true,
+			resolve: { skipNodeModulesBundle: true },
 			plugins: [(0, _powerlines_deepkit_esbuild_plugin.esbuildPlugin)(context, {
 				reflection: "default",
-				reflectionLevel: "verbose"
+				level: "all"
 			})]
 		}));
 	}
@@ -211,9 +214,9 @@ resolve.__type = [
 	"input",
 	"CommandTree",
 	"resolve",
-	"P\"w!2\"\"w#`/$"
+	"Resolves a command tree from the given resolver input.",
+	"P\"w!2\"\"w#`/$?%"
 ];
 
 //#endregion
-exports.resolve = resolve;
-//# sourceMappingURL=resolve.cjs.map
+exports.resolve = resolve;

package/dist/resolver/resolve.mjs

@@ -25,6 +25,7 @@ async function initialize(input) {
 			alias: [],
 			icon: parent?.icon,
 			tags: parent?.tags ?? [],
+			source: "file",
 			...command,
 			title,
 			options: parent === null ? getGlobalOptions(context, command) : {},
@@ -35,12 +36,14 @@ async function initialize(input) {
 	};
 	if (!command.isVirtual) {
 		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
-		context.debug(`Adding reflection for application command: ${command.id} (file: ${command.entry.input.file})`);
+		context.debug(`Adding reflection for CLI command: ${command.id} (file: ${command.entry.input.file})`);
 		result.module = await (resolveModule.Ω = [["CommandModule", "\"w!"]], resolveModule(context, command.entry.input, {
 			name: command.title || titleCase(command.name),
+			treeShaking: true,
+			resolve: { skipNodeModulesBundle: true },
 			plugins: [esbuildPlugin(context, {
 				reflection: "default",
-				reflectionLevel: "verbose"
+				level: "all"
 			})]
 		}));
 	}
@@ -210,7 +213,8 @@ resolve.__type = [
 	"input",
 	"CommandTree",
 	"resolve",
-	"P\"w!2\"\"w#`/$"
+	"Resolves a command tree from the given resolver input.",
+	"P\"w!2\"\"w#`/$?%"
 ];
 
 //#endregion

package/dist/resolver/resolve.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    tags: parent?.tags ?? [],\n    ...command,\n    title,\n    options: parent === null ? getGlobalOptions(context, command) : {},\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for application command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        name: command.title || titleCase(command.name),\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    tags: parent?.tags ?? [],\n    source: \"file\",\n    ...command,\n    title,\n    options: parent === null ? getGlobalOptions(context, command) : {},\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for CLI command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        name: command.title || titleCase(command.name),\n        treeShaking: true,\n        resolve: {\n          skipNodeModulesBundle: true\n        },\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            level: \"all\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}

package/dist/types/command.cjs

@@ -46,23 +46,33 @@ const __ΩCommandParameterKind = [
 ];
 const __ΩBaseCommandParameter = [
 	"name",
+	"The option name.",
 	() => __ΩCommandParameterKind,
 	"kind",
+	"The option kind.",
 	"title",
+	"The display title.",
 	"description",
+	"The option description.",
 	"alias",
+	"Alternative option names.",
 	false,
 	"env",
+	"The environment variable name or false to disable.",
 	"optional",
+	"Whether the option is optional.",
 	"variadic",
+	"Whether the option accepts multiple values.",
 	"BaseCommandParameter",
-	"P&4!n\"4#&4$&4%&F4&P&.'J4()4))4*Mw+y"
+	"P&4!?\"n#4$?%&4&?'&4(?)&F4*?+P&.,J4-?.)4/?0)41?2Mw3y"
 ];
 const __ΩStringCommandParameter = [
 	() => __ΩBaseCommandParameter,
 	"string",
 	"kind",
+	"The option kind.",
 	"default",
+	"The default value.",
 	"email",
 	"uri",
 	"uuid",
@@ -73,26 +83,33 @@ const __ΩStringCommandParameter = [
 	"date-time",
 	"duration",
 	"format",
+	"A standard string format to validate the option value against.",
 	"choices",
+	"The allowed choices for the option value.",
 	"StringCommandParameter",
-	"Pn!.\"4#&4$8P.%.&.'.(.).*.+.,.-J4.8&F4/8Mw0y"
+	"Pn!.\"4#?$&4%8?&P.'.(.).*.+.,.-.../J408?1&F428?3Mw4y"
 ];
 const __ΩNumberCommandParameter = [
 	() => __ΩBaseCommandParameter,
 	"number",
 	"kind",
+	"The option kind.",
 	"default",
+	"The default value.",
 	"choices",
+	"The allowed choices for the option value.",
 	"NumberCommandParameter",
-	"Pn!.\"4#'4$8'F4%8Mw&y"
+	"Pn!.\"4#?$'4%8?&'F4'8?(Mw)y"
 ];
 const __ΩBooleanCommandParameter = [
 	() => __ΩBaseCommandParameter,
 	"boolean",
 	"kind",
+	"The option kind.",
 	"default",
+	"The default value.",
 	"BooleanCommandParameter",
-	"Pn!.\"4#)4$8Mw%y"
+	"Pn!.\"4#?$)4%8?&Mw'y"
 ];
 const __ΩCommandParameter = [
 	() => __ΩStringCommandParameter,
@@ -142,9 +159,11 @@ const __ΩCommandParameterConfig = [
 const __ΩBooleanCommandOption = [
 	() => __ΩBooleanCommandParameter,
 	"isNegativeOf",
+	"The option this negates.",
 	"skipAddingNegative",
+	"Whether to skip adding a negative option.",
 	"BooleanCommandOption",
-	"Pn!&4\"8)4#8Mw$y"
+	"Pn!&4\"8?#)4$8?%Mw&y"
 ];
 const __ΩCommandOption = [
 	() => __ΩStringCommandParameter,
@@ -174,44 +193,71 @@ const __ΩCommandArgumentConfig = [
 ];
 const __ΩCommandBase = [
 	"id",
+	"The command id.",
 	"name",
+	"The command name.",
 	"path",
+	"The full command path value.",
 	"segments",
+	"The path segments.",
 	"title",
+	"The display title.",
 	"description",
+	"The command description.",
 	"alias",
+	"Alternative command names.",
 	"icon",
+	"The command icon.",
 	"reference",
+	"A URL to the command documentation or reference.",
 	"isVirtual",
+	"Whether the command is virtual.",
 	"CommandBase",
-	"PP&,J4!&4\"P&,J4#&F4$&4%8&4&8&F4'8&4(8&4)8)4*Mw+y"
+	"PP&,J4!?\"&4#?$P&,J4%?&&F4'?(&4)8?*&4+8?,&F4-8?.&4/8?0&418?2)43?4Mw5y"
 ];
 const __ΩCommandConfig = [
 	() => __ΩCommandBase,
 	"id",
+	"The command id.",
 	"entry",
+	"The resolved entry definition.",
 	"tags",
+	"Optional tags for the command.",
+	"file",
+	"source",
+	"A string representing the source of the command, which can be \"file\", a specific plugin name, or any other string value that describes the source that added the command.",
 	"CommandConfig",
-	"Pn!&4\"!4#&F4$8Mw%y"
+	"Pn!&4\"?#!4$?%&F4&8?'P.(&J4)8?*Mw+y"
 ];
 const __ΩCommandTree = [
 	() => __ΩCommandConfig,
 	"title",
+	"The display title.",
 	"description",
+	"The command description.",
 	"alias",
+	"Alternative command names.",
 	"tags",
+	"A set of tags for the command.",
+	"file",
+	"source",
+	"A string representing the source of the command, which can be \"file\", a specific plugin name, or any other string value that describes the source that added the command.",
 	() => __ΩRecord,
 	() => __ΩCommandOption,
 	"options",
+	"The command options.",
 	() => __ΩCommandArgument,
 	"args",
+	"The positional arguments provided to the command.",
 	0,
 	"parent",
+	"The parent command.",
 	() => __ΩRecord,
 	0,
 	"children",
+	"Child commands.",
 	"CommandTree",
-	"Pn!P&4\"&4#&F4$&F4%&n'o&#4(n)F4*P,n+J4,&n.o-#4/MKw0y"
+	"Pn!P&4\"?#&4$?%&F4&?'&F4(?)P.*&J4+?,&n.o-#4/?0n1F42?3P,n4J45?6&n8o7#49?:MKw;y"
 ];
 const __ΩSerializedCommandTree = [
 	() => __ΩOmit,
@@ -219,21 +265,29 @@ const __ΩSerializedCommandTree = [
 	"parent",
 	"children",
 	"parent",
+	"The parent command id.",
 	() => __ΩRecord,
 	0,
 	"children",
+	"Serialized child commands.",
 	"SerializedCommandTree",
-	"Pn\"P.#.$Jo!#PP,&J4%&n'o&#4(MKw)y"
+	"Pn\"P.#.$Jo!#PP,&J4%?&&n(o'#4)?*MKw+y"
 ];
 const __ΩCommandMetadata = [
 	"title",
+	"The display name of the command.",
 	"description",
+	"A brief description of what the command does.",
 	"alias",
+	"One or more alternative names for the command.",
 	"tags",
+	"Optional tags for the command.",
 	"icon",
+	"An optional icon to visually represent the command in user interfaces.",
 	"reference",
+	"A URL to the command documentation or reference.",
 	"CommandMetadata",
-	"P&4!8&4\"8P&&FJ4#8&F4$8&4%8&4&8Mw'y"
+	"P&4!8?\"&4#8?$P&&FJ4%8?&&F4'8?(&4)8?*&4+8?,Mw-y"
 ];
 const __ΩCommandModule = [
 	() => __ΩCommandMetadata,
@@ -274,5 +328,4 @@ exports.__ΩNumberCommandParameter = __ΩNumberCommandParameter;
 exports.__ΩNumberCommandParameterConfig = __ΩNumberCommandParameterConfig;
 exports.__ΩSerializedCommandTree = __ΩSerializedCommandTree;
 exports.__ΩStringCommandParameter = __ΩStringCommandParameter;
-exports.__ΩStringCommandParameterConfig = __ΩStringCommandParameterConfig;
-//# sourceMappingURL=command.cjs.map
+exports.__ΩStringCommandParameterConfig = __ΩStringCommandParameterConfig;

package/dist/types/command.d.cts

@@ -172,6 +172,10 @@ interface CommandConfig extends CommandBase {
    * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.
    */
   tags?: string[];
+  /**
+   * A string representing the source of the command, which can be "file", a specific plugin name, or any other string value that describes the source that added the command.
+   */
+  source?: "file" | string;
 }
 type CommandTree = CommandConfig & {
   /**
@@ -187,12 +191,16 @@ type CommandTree = CommandConfig & {
    */
   alias: string[];
   /**
-   * Optional tags for the command.
+   * A set of tags for the command.
    *
    * @remarks
    * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.
    */
   tags: string[];
+  /**
+   * A string representing the source of the command, which can be "file", a specific plugin name, or any other string value that describes the source that added the command.
+   */
+  source: "file" | string;
   /**
    * The command options.
    */