@shell-shock/core 0.9.7 → 0.11.0

package/dist/resolver/deepkit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/resolver/deepkit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray,\n  TypeLiteral\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  if (type === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    type === ReflectionKind.number ||\n    type === ReflectionKind.bigint ||\n    ((type as Type).kind === ReflectionKind.literal &&\n      (isNumber((type as TypeLiteral).literal) ||\n        isBigInt((type as TypeLiteral).literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (type === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\n\n  if (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0 && parameters[0]) {\n    if (\n      parameters[0].type.kind === ReflectionKind.objectLiteral ||\n      parameters[0].type.kind === ReflectionKind.class\n    ) {\n      const optionsReflection = ReflectionClass.from(parameters[0].type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/deepkit.mjs

@@ -0,0 +1,128 @@
+import { CommandParameterKinds } from "../types/command.mjs";
+import { mergeCommandParameter } from "./helpers.mjs";
+import { ReflectionClass, ReflectionFunction, ReflectionKind, __ΩReflectionKind, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
+import { isBigInt } from "@stryke/type-checks/is-bigint";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isRegExp } from "@stryke/type-checks/is-regexp";
+
+//#region src/resolver/deepkit.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function extractCommandParameterKind(type) {
+	if (type === ReflectionKind.string) return CommandParameterKinds.string;
+	else if (type === ReflectionKind.number || type === ReflectionKind.bigint || type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return CommandParameterKinds.number;
+	else if (type === ReflectionKind.boolean) return CommandParameterKinds.boolean;
+	else return CommandParameterKinds.string;
+}
+extractCommandParameterKind.__type = [
+	"Type",
+	() => __ΩReflectionKind,
+	"type",
+	"CommandParameterKind",
+	"extractCommandParameterKind",
+	"PP\"w!n\"J2#\"w$/%"
+];
+function resolveCommandOption(ctx, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.options[reflection.getNameAsString()] ?? {};
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim(),
+		description: reflection.getDescription(),
+		kind: extractCommandParameterKind(type),
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (reflection.isArray()) if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
+		option.variadic = true;
+		option.kind = extractCommandParameterKind(type.type.kind);
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === ReflectionKind.union) {
+		option.kind = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? CommandParameterKinds.number : CommandParameterKinds.string;
+		option.choices = type.types.map(__assignType((t) => t.kind === ReflectionKind.literal ? isNumber(t.literal) ? t.literal : isBigInt(t.literal) ? Number(t.literal) : isRegExp(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === ReflectionKind.literal) option.choices = [isNumber(type.literal) ? type.literal : isBigInt(type.literal) ? Number(type.literal) : isRegExp(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.kind && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return mergeCommandParameter(existing, option);
+}
+resolveCommandOption.__type = [
+	"ResolverContext",
+	"ctx",
+	"ReflectionProperty",
+	"reflection",
+	"CommandOption",
+	"resolveCommandOption",
+	"P\"w!2\"\"w#2$\"w%/&"
+];
+function resolveCommandArgument(ctx, index, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
+	if (!existing.kind && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number && type.kind !== ReflectionKind.boolean && !(type.kind === ReflectionKind.array && (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number))) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string types (or an array of strings) are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	const argument = {
+		name: reflection.getName() || reflection.parameter.name,
+		alias: reflection.getAlias(),
+		kind: extractCommandParameterKind(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue()
+	};
+	if (type.kind === ReflectionKind.array) {
+		if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
+			argument.variadic = true;
+			argument.kind = extractCommandParameterKind(type.type.kind);
+		} else if (!existing.kind) throw new Error(`Unsupported array type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	} else if (!existing.kind && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return mergeCommandParameter(existing, argument, { name: `arg${index}` });
+}
+resolveCommandArgument.__type = [
+	"ResolverContext",
+	"ctx",
+	"index",
+	"ReflectionParameter",
+	"reflection",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P\"w!2\"'2#\"w$2%\"w&/'"
+];
+function resolveFromBytecode(ctx) {
+	const { input, module } = ctx;
+	const type = reflect(module);
+	if (type.kind !== ReflectionKind.function) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not export a valid function.`);
+	const reflection = new ReflectionFunction(type);
+	ctx.output.description ??= ctx.input.command.description || reflection.getDescription() || type.description;
+	const parameters = reflection.getParameters();
+	if (parameters.length > 0 && parameters[0]) {
+		if (parameters[0].type.kind === ReflectionKind.objectLiteral || parameters[0].type.kind === ReflectionKind.class) {
+			const optionsReflection = ReflectionClass.from(parameters[0].type);
+			for (const propertyReflection of optionsReflection.getProperties()) ctx.output.options[propertyReflection.getNameAsString()] = resolveCommandOption(ctx, propertyReflection);
+		} else if (!ctx.module?.options) throw new Error(`The first parameter of the command handler function in "${ctx.input.command.entry.input?.file || ctx.input.command.path}" must be an object literal or class type representing the command options.`);
+		ctx.output.args = parameters.slice(1).map(__assignType((arg, index) => resolveCommandArgument(ctx, index, arg), [
+			"arg",
+			"index",
+			"",
+			"P\"2!\"2\"\"/#"
+		]));
+	}
+}
+resolveFromBytecode.__type = [
+	"ResolverContext",
+	"ctx",
+	"resolveFromBytecode",
+	"P\"w!2\"\"/#"
+];
+
+//#endregion
+export { resolveFromBytecode };
+//# sourceMappingURL=deepkit.mjs.map

package/dist/resolver/deepkit.mjs.map

@@ -0,0 +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":";;;;;;;;AAEA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AAQX,SAAS,4BAA4B,MAAM;oCAEnC,QAAO,sBAAqB;UAEvB,SAAS,eAAe,4CAE5B,KAAG,SAAA,eAAA,YACC,SAAQ,KAAA,QAAA,IACL,SAAI,KAAA,QAAA,EACd,QAAA,sBAAA;UAEM,SAAA,eAAA,QACJ,QAAO,sBAAsB;KAG7B,QAAO,sBAAE;;AAGjB,4BAAc,SAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACd,SAAS,qBAAqB,KAAK,YAAK;CACpC,MAAM,OAAO,WAAW,SAAS;CACjC,MAAM,WAAY,IAAI,OAAO,QAAQ,WAAW,iBAAI,KAChD,EAAG;CACP,MAAM,SAAE;EACJ,MAAM,WAAG,iBAAA;EACT,OAAO,WAAA,SAAA,CAAA,SAAA,EAAA;EACP,OAAO,WAAO,SAAA,CAAA,OAAA,MAAA;EACd,aAAC,WAAA,gBAAA;EACD,MAAM,4BAAU,KAAA;EAChB,UAAU,WAAK,YAAA;EACf,SAAS,WAAA,iBAAA;EACT,UAAU,WAAW,SAAQ;EAChC;AACD,KAAI,WAAW,SAAS,kDAEhB,KAAK,KAAK,SAAS,eAAK,QAAA;AACxB,SAAO,WACH;AACJ,SAAO,OACH,4BAAuB,KAAA,KAAA,KAAA;OAG3B,OAAM,IAAI,MAAM,sCAAQ,WAAA,iBAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,wDAAA,cAAA,KAAA,CACnB,MAAM,CACN,WAAW,OAAO,QAAQ,CAAA,GAAI;UAGlC,KAAK,SAAS,eAAY,OAAA;AAC/B,SAAO,OAAO,KAAK,MAAM,MAAM,cAAO,MAAA,EAAA,SAAA,eAAA,UACjC,EAAE,SAAS,eAAe,YAC9B,SAAA,EAAA,QAAA,IAAA,SAAA,EAAA,QAAA,GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,GACK,sBAAsB,SAClC,sBAAA;AACF,SAAA,qBAEiB,IAAI,cAAQ,MAAA,EAAA,SAAA,eAAA,UACX,SAAI,EAAA,QAAA,GACA,EAAE,UACP,SAAA,EAAA,QAAA,GACS,OAAO,EAAE,QAAA,GACT,SAAS,EAAE,QAAQ,GACf,EAAE,QAAC,6BAEhB,MAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CACA,OAAO,QAAQ;YAEnB,KAAK,SAAS,eAAe,QAClC,QAAO,UAAU,CACb,SAAS,KAAK,QAAQ,GAChB,KAAK,UACL,SAAS,KAAK,QAAQ,GAClB,OAAO,KAAI,QAAA,GAC9B,SAAA,KAAA,QAAA,yBAEuB,OAAE,KAAA,QAAA,CACrB,CAAA,OAAA,QAAA;UAEM,CAAC,SAAS,QACjB,KAAA,SAAA,eAAA,WACE,KAAK,SAAS,eAAe,UAC7B,KAAI,SAAA,eAAA,OACJ,OAAM,IAAI,MAAM,gCAAgC,WAAW,iBAAI,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,iFAAA,cAAA,KAAA,CAC1D,MAAM,CACN,WAAM,OAAA,QAAA,CAAA,GAAA;AAEf,QAAO,sBAAA,UAAA,OAAA;;AAEX,qBAAqB,SAAS;CAAC;CAAmB;CAAO;CAAsB;CAAW;CAAA;CAAA;CAAA;AAC1F,SAAS,uBAAsB,KAAA,OAAA,YAAA;CAC3B,MAAM,OAAO,WAAW,SAAS;CACjC,MAAM,WAAG,IAAA,OAAA,KAAA,SAAA,QAAA,IAAA,OAAA,KAAA,SAAA,EAAA;AACT,KAAI,CAAA,SAAA,QACA,KAAK,SAAG,eAAA,UACR,KAAK,SAAS,eAAe,UAC9B,KAAA,SAAA,eAAA,WACH,EAAA,KAAA,SAAA,eAAA,UACS,KAAK,KAAK,SAAS,eAAe,UAC/B,KAAK,KAAK,SAAQ,eAAA,SAC1B,OAAC,IAAA,MAAA,kCAAA,WAAA,SAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,wEAAA,cAAA,KAAA,CACI,MAAM,CACN,WAAW,OAAO,QAAQ,CAAA,GAAI;CAEvC,MAAA,WAAA;EACI,MAAM,WAAW,SAAS,IAAC,WAAA,UAAA;EAC3B,OAAO,WAAW,UAAU;;EAE5B,OAAO,WAAW,UAAU,IAAI,WAAW,UAAU,MAAM;EAC3D,aAAO,WAAA,UAAA;EACP,UAAQ,WAAA,YAAA;EACR,SAAS,WAAW,iBAAc;EACrC;AACD,KAAI,KAAK,SAAS,eAAE,OAChB;MAAI,KAAK,KAAK,SAAS,eAAG,UACtB,KAAK,KAAK,SAAS,eAAG,QAAA;AACtB,YAAS,WACL;AACJ,YAAS,OACL,4BAAC,KAAA,KAAA,KAAA;aAEA,CAAC,SAAS,KACf,OAAM,IAAI,MAAM,wCAAuB,WAAA,SAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,wDAAA,cAAA,KAAA,CAClC,MAAM,CACN,WAAU,OAAA,QAAA,CAAA,GAAA;YAGd,CAAC,SAAS,QACf,KAAK,SAAS,eAAW,WACzB,KAAK,SAAS,eAAU,UACxB,KAAK,SAAS,eAAW,OACzB,OAAM,IAAI,MAAM,kCAAoB,WAAA,SAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,iFAAA,cAAA,KAAA,CAChC,MAAA,CACC,WAAO,OAAA,QAAA,CAAA,GAAA;AAEhB,QAAO,sBAAsB,UAAQ,UAAA,EACjC,MAAM,MAAM,SAChB,CAAA;;AAEJ,uBAAuB,SAAS;CAAC;CAAmB;CAAO;CAAS;CAAc;CAAA;CAAA;CAAA;CAAA;AAClF,SAAgB,oBAAa,KAAA;CACzB,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,OAAC,QAAA,OAAA;AACP,KAAE,KAAA,SAAA,eAAA,SACE,OAAM,IAAA,MAAA,2BAAA,MAAA,QAAA,MAAA,OAAA,QAAA,MAAA,QAAA,KAAA,qCAAA;CAEV,MAAC,aAAA,IAAA,mBAAA,KAAA;AACH,KAAA,OAAA,gBAAA,IAAA,MAAA,QAAA,8CAEM,KAAK;CACb,MAAA,aAAA,WAAA,eAAA;;AAEQ,MAAI,WAAW,GAAG,KAAK,SAAA,eAAA,iBACnB,WAAU,GAAA,KAAA,SAAA,eAAA,OAAA;GACV,MAAG,oBAAA,gBAAA,KAAA,WAAA,GAAA,KAAA;AACH,QAAK,MAAM,sBAAS,kBAAA,eAAA,CAChB,KAAG,OAAA,QAAA,mBAAA,iBAAA,IACC,qBAAe,KAAA,mBAAA;aAGlB,CAAC,IAAI,QAAQ;AAGtB,MAAI,OAAO,OAAC,WACP,MAAM,EAAE,CACR,IAAI,cAAc,KAAK,UAAK,uBAAA,KAAA,OAAA,IAAA,EAAA;GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;;;AAGzC,oBAAoB,SAAS;CAAC;CAAY;CAAA;CAAA;CAAA"}

package/dist/resolver/helpers.cjs

@@ -0,0 +1,173 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_types_command = require('../types/command.cjs');
+let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+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;
+}
+/**
+* Resolves the description for a command option based on its reflection.
+*
+* @param name - The name of the command option.
+* @param kind - The reflection kind of the command option.
+* @param optional - Whether the command option is optional.
+* @param variadic - Whether the command option is variadic (i.e., an array).
+* @param title - The title of the command option, if any.
+* @param defaultValue - The default value of the command option, if any.
+* @returns The resolved description for the command option.
+*/
+function resolveCommandOptionDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
+	return `A${optional && !defaultValue ? "n optional" : ""} command-line ${kind === require_types_command.CommandParameterKinds.boolean ? "flag" : "option"} that allows the user to ${kind === require_types_command.CommandParameterKinds.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, __stryke_string_format_title_case.titleCase)(name)} ${kind === require_types_command.CommandParameterKinds.boolean ? "indicator" : `${kind === require_types_command.CommandParameterKinds.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+}
+resolveCommandOptionDescription.__type = [
+	"name",
+	"CommandParameterKind",
+	"kind",
+	"optional",
+	"variadic",
+	"title",
+	"defaultValue",
+	"resolveCommandOptionDescription",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+];
+/**
+* Resolves the description for a command argument based on its reflection.
+*
+* @param name - The name of the command argument.
+* @param kind - The reflection kind of the command argument.
+* @param optional - Whether the command argument is optional.
+* @param variadic - Whether the command argument is variadic (i.e., an array).
+* @param title - The title of the command argument, if any.
+* @param defaultValue - The default value of the command argument, if any.
+* @returns The resolved description for the command argument.
+*/
+function resolveCommandArgumentDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
+	return `An${optional && !defaultValue ? " optional" : ""} argument that allows the user to ${kind === require_types_command.CommandParameterKinds.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, __stryke_string_format_title_case.titleCase)(name)} ${kind === require_types_command.CommandParameterKinds.boolean ? "indicator" : `${kind === require_types_command.CommandParameterKinds.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+}
+resolveCommandArgumentDescription.__type = [
+	"name",
+	"CommandParameterKind",
+	"kind",
+	"optional",
+	"variadic",
+	"title",
+	"defaultValue",
+	"resolveCommandArgumentDescription",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+];
+function applyOptionsDefaults(options) {
+	return Object.fromEntries(Object.entries(options).map(__assignType(([key, option]) => {
+		const name = option.name || key;
+		const title = option.title || (0, __stryke_string_format_title_case.titleCase)(name);
+		return [key, {
+			...option,
+			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)
+		}];
+	}, [
+		"param0",
+		"",
+		"P\"2!\"/\""
+	])));
+}
+applyOptionsDefaults.__type = [
+	() => __ΩRecord,
+	"CommandOption",
+	"options",
+	"applyOptionsDefaults",
+	"P&\"w\"o!#2#\"/$"
+];
+function applyArgsDefaults(args) {
+	return 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 {
+			...arg,
+			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
+		};
+	}, [
+		"arg",
+		"i",
+		"",
+		"P\"2!\"2\"\"/#"
+	]));
+}
+applyArgsDefaults.__type = [
+	"CommandArgument",
+	"args",
+	"applyArgsDefaults",
+	"P\"w!F2\"\"w!F/#"
+];
+function applyDefaults(context) {
+	context.output.description ??= `The ${context.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
+}
+applyDefaults.__type = [
+	"ResolverContext",
+	"context",
+	"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.`;
+}
+resolveVirtualCommand.__type = [
+	"ResolverContext",
+	"ctx",
+	"resolveVirtualCommand",
+	"P\"w!2\"\"/#"
+];
+/**
+* Merges two command parameters, giving precedence to string values in the second configuration.
+*
+* @param objA - The first command parameter object.
+* @param objB - The second command parameter object.
+* @returns The merged command parameter object.
+*/
+const mergeCommandParameter = (0, defu.createDefu)(__assignType((obj, key, value) => {
+	if ((0, __stryke_type_checks_is_string.isString)(obj[key]) && (0, __stryke_type_checks_is_string.isString)(value)) {
+		if ((0, __stryke_type_checks_is_set_string.isSetString)(value)) obj[key] = value;
+		return true;
+	} else if (Array.isArray(obj[key]) && Array.isArray(value)) {
+		if (value.length > 0) obj[key] = (0, __stryke_helpers_get_unique.getUniqueBy)(obj[key].concat(value), __assignType((item) => (0, __stryke_type_checks_is_string.isString)(item) ? item : JSON.stringify(item), [
+			"item",
+			"",
+			"P\"2!\"/\""
+		]));
+		return true;
+	}
+	return false;
+}, [
+	"obj",
+	"key",
+	"value",
+	"",
+	"P\"2!\"2\"\"2#\"/$"
+]));
+
+//#endregion
+exports.applyArgsDefaults = applyArgsDefaults;
+exports.applyDefaults = applyDefaults;
+exports.applyOptionsDefaults = applyOptionsDefaults;
+exports.mergeCommandParameter = mergeCommandParameter;
+exports.resolveVirtualCommand = resolveVirtualCommand;
+//# sourceMappingURL=helpers.cjs.map

package/dist/resolver/helpers.cjs.map

@@ -0,0 +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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"}

package/dist/resolver/helpers.mjs

@@ -0,0 +1,168 @@
+import { getAppTitle } from "../plugin-utils/context-helpers.mjs";
+import { CommandParameterKinds } from "../types/command.mjs";
+import { constantCase } from "@stryke/string-format/constant-case";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { createDefu } from "defu";
+import { titleCase } from "@stryke/string-format/title-case";
+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;
+}
+/**
+* Resolves the description for a command option based on its reflection.
+*
+* @param name - The name of the command option.
+* @param kind - The reflection kind of the command option.
+* @param optional - Whether the command option is optional.
+* @param variadic - Whether the command option is variadic (i.e., an array).
+* @param title - The title of the command option, if any.
+* @param defaultValue - The default value of the command option, if any.
+* @returns The resolved description for the command option.
+*/
+function resolveCommandOptionDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
+	return `A${optional && !defaultValue ? "n optional" : ""} command-line ${kind === CommandParameterKinds.boolean ? "flag" : "option"} that allows the user to ${kind === CommandParameterKinds.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === CommandParameterKinds.boolean ? "indicator" : `${kind === CommandParameterKinds.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+}
+resolveCommandOptionDescription.__type = [
+	"name",
+	"CommandParameterKind",
+	"kind",
+	"optional",
+	"variadic",
+	"title",
+	"defaultValue",
+	"resolveCommandOptionDescription",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+];
+/**
+* Resolves the description for a command argument based on its reflection.
+*
+* @param name - The name of the command argument.
+* @param kind - The reflection kind of the command argument.
+* @param optional - Whether the command argument is optional.
+* @param variadic - Whether the command argument is variadic (i.e., an array).
+* @param title - The title of the command argument, if any.
+* @param defaultValue - The default value of the command argument, if any.
+* @returns The resolved description for the command argument.
+*/
+function resolveCommandArgumentDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
+	return `An${optional && !defaultValue ? " optional" : ""} argument that allows the user to ${kind === CommandParameterKinds.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${kind === CommandParameterKinds.boolean ? "indicator" : `${kind === CommandParameterKinds.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+}
+resolveCommandArgumentDescription.__type = [
+	"name",
+	"CommandParameterKind",
+	"kind",
+	"optional",
+	"variadic",
+	"title",
+	"defaultValue",
+	"resolveCommandArgumentDescription",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/("
+];
+function applyOptionsDefaults(options) {
+	return Object.fromEntries(Object.entries(options).map(__assignType(([key, option]) => {
+		const name = option.name || key;
+		const title = option.title || titleCase(name);
+		return [key, {
+			...option,
+			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)
+		}];
+	}, [
+		"param0",
+		"",
+		"P\"2!\"/\""
+	])));
+}
+applyOptionsDefaults.__type = [
+	() => __ΩRecord,
+	"CommandOption",
+	"options",
+	"applyOptionsDefaults",
+	"P&\"w\"o!#2#\"/$"
+];
+function applyArgsDefaults(args) {
+	return args.map(__assignType((arg, i) => {
+		const name = arg.name || `arg${i + 1}`;
+		const title = arg.title || titleCase(name);
+		return {
+			...arg,
+			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
+		};
+	}, [
+		"arg",
+		"i",
+		"",
+		"P\"2!\"2\"\"/#"
+	]));
+}
+applyArgsDefaults.__type = [
+	"CommandArgument",
+	"args",
+	"applyArgsDefaults",
+	"P\"w!F2\"\"w!F/#"
+];
+function applyDefaults(context) {
+	context.output.description ??= `The ${context.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
+}
+applyDefaults.__type = [
+	"ResolverContext",
+	"context",
+	"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.`;
+}
+resolveVirtualCommand.__type = [
+	"ResolverContext",
+	"ctx",
+	"resolveVirtualCommand",
+	"P\"w!2\"\"/#"
+];
+/**
+* Merges two command parameters, giving precedence to string values in the second configuration.
+*
+* @param objA - The first command parameter object.
+* @param objB - The second command parameter object.
+* @returns The merged command parameter object.
+*/
+const mergeCommandParameter = createDefu(__assignType((obj, key, value) => {
+	if (isString(obj[key]) && isString(value)) {
+		if (isSetString(value)) obj[key] = value;
+		return true;
+	} else if (Array.isArray(obj[key]) && Array.isArray(value)) {
+		if (value.length > 0) obj[key] = getUniqueBy(obj[key].concat(value), __assignType((item) => isString(item) ? item : JSON.stringify(item), [
+			"item",
+			"",
+			"P\"2!\"/\""
+		]));
+		return true;
+	}
+	return false;
+}, [
+	"obj",
+	"key",
+	"value",
+	"",
+	"P\"2!\"2\"\"2#\"/$"
+]));
+
+//#endregion
+export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, mergeCommandParameter, resolveVirtualCommand };
+//# sourceMappingURL=helpers.mjs.map

package/dist/resolver/helpers.mjs.map

@@ -0,0 +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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"}