@shell-shock/core 0.10.0 → 0.12.0

package/dist/resolver/helpers.cjs

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

package/dist/resolver/helpers.mjs

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

package/dist/resolver/module.cjs

@@ -0,0 +1,144 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_types_command = require('../types/command.cjs');
+const require_type_checks = require('../plugin-utils/type-checks.cjs');
+require('../plugin-utils/index.cjs');
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_json = require("@stryke/json");
+let __stryke_zod = require("@stryke/zod");
+
+//#region src/resolver/module.ts
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function resolveCommandOption(name, parent, schema) {
+	const result = {
+		name,
+		kind: (0, __stryke_json.isJsonSchema7ArrayType)(schema) && schema.items ? (0, __stryke_json.isJsonSchema7NumberType)(schema.items) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.string : (0, __stryke_json.isJsonSchema7BooleanType)(schema) ? require_types_command.CommandParameterKinds.boolean : (0, __stryke_json.isJsonSchema7NumberType)(schema) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.string,
+		title: schema.title,
+		description: schema.description,
+		alias: (0, __stryke_convert_to_array.toArray)(schema.alias || []),
+		env: schema.env,
+		optional: !parent.required?.includes(name),
+		default: schema.default
+	};
+	if (result.kind === require_types_command.CommandParameterKinds.string || result.kind === require_types_command.CommandParameterKinds.number) {
+		result.variadic = (0, __stryke_json.isJsonSchema7ArrayType)(schema);
+		if (result.kind === require_types_command.CommandParameterKinds.string) result.format = schema.format;
+		if (((0, __stryke_json.isJsonSchema7StringType)(schema) || (0, __stryke_json.isJsonSchema7NumberType)(schema)) && schema.enum) result.choices = schema.enum;
+	} else if (result.kind === require_types_command.CommandParameterKinds.boolean) {
+		result.skipAddingNegative = schema.skipAddingNegative;
+		result.isNegativeOf = schema.isNegativeOf;
+	}
+	return result;
+}
+resolveCommandOption.__type = [
+	"name",
+	"parent",
+	"schema",
+	() => __ΩPartial,
+	"CommandOption",
+	"resolveCommandOption",
+	"P&2!!2\"!2#\"w%o$\"/&"
+];
+function resolveCommandArgument(schema) {
+	const result = {
+		name: schema.name,
+		kind: (0, __stryke_json.isJsonSchema7ArrayType)(schema) && schema.items ? (0, __stryke_json.isJsonSchema7NumberType)(schema.items) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.string : (0, __stryke_json.isJsonSchema7BooleanType)(schema) ? require_types_command.CommandParameterKinds.boolean : (0, __stryke_json.isJsonSchema7NumberType)(schema) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.string,
+		title: schema.title,
+		description: schema.description,
+		alias: (0, __stryke_convert_to_array.toArray)(schema.alias || []),
+		env: schema.env,
+		default: schema.default
+	};
+	if (result.kind === require_types_command.CommandParameterKinds.string || result.kind === require_types_command.CommandParameterKinds.number) {
+		result.variadic = (0, __stryke_json.isJsonSchema7ArrayType)(schema);
+		if (result.kind === require_types_command.CommandParameterKinds.string) result.format = schema.format;
+		if (((0, __stryke_json.isJsonSchema7StringType)(schema) || (0, __stryke_json.isJsonSchema7NumberType)(schema)) && schema.enum) result.choices = schema.enum;
+	}
+	return result;
+}
+resolveCommandArgument.__type = [
+	"schema",
+	() => __ΩPartial,
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P!2!\"w#o\"\"/$"
+];
+async function resolveFromExports(ctx) {
+	validateExports(ctx);
+	const metadata = ctx.module?.metadata ?? {};
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.title)) ctx.output.title = metadata.title;
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.description)) ctx.output.description = metadata.description;
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.alias) || Array.isArray(metadata.alias) && metadata.alias.length > 0) ctx.output.alias = (0, __stryke_convert_to_array.toArray)(metadata.alias);
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.icon)) ctx.output.icon = metadata.icon;
+	if ((0, __stryke_type_checks_is_set_object.isSetObject)(ctx.module?.options)) if ((0, __stryke_zod.isZod3Type)(ctx.module.options) || (0, __stryke_json.isStandardJsonSchema)(ctx.module.options) || (0, __stryke_json.isJsonSchema7ObjectType)(ctx.module.options)) {
+		let jsonSchema;
+		if ((0, __stryke_zod.isZod3Type)(ctx.module.options)) jsonSchema = (0, __stryke_zod.extractJsonSchema7)(ctx.module.options);
+		else if ((0, __stryke_json.isStandardJsonSchema)(ctx.module.options)) jsonSchema = ctx.module.options["~standard"].jsonSchema.input({ target: "draft-07" });
+		else jsonSchema = ctx.module.options;
+		if (!(0, __stryke_json.isJsonSchema7ObjectType)(jsonSchema)) throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`);
+		ctx.output.options = Object.fromEntries(Object.entries(jsonSchema.properties).map(__assignType(([name, property]) => [name, resolveCommandOption(name, jsonSchema, property)], [
+			"param0",
+			"",
+			"P\"2!\"/\""
+		])));
+	} else if (Object.values(ctx.module.options).every(require_type_checks.isCommandParameterConfig)) ctx.output.options = Object.fromEntries(Object.entries(ctx.module.options).map(__assignType(([name, option]) => [name, {
+		name,
+		...option,
+		alias: (0, __stryke_convert_to_array.toArray)(option.alias)
+	}], [
+		"param0",
+		"",
+		"P\"2!\"/\""
+	])));
+	else throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`);
+	if ((0, __stryke_type_checks_is_set_object.isSetObject)(ctx.module?.args)) if ((0, __stryke_zod.isZod3Type)(ctx.module.args) || (0, __stryke_json.isStandardJsonSchema)(ctx.module.args) || (0, __stryke_json.isJsonSchema7TupleType)(ctx.module.args)) {
+		let jsonSchema;
+		if ((0, __stryke_zod.isZod3Type)(ctx.module.args)) jsonSchema = (0, __stryke_zod.extractJsonSchema7)(ctx.module.args);
+		else if ((0, __stryke_json.isStandardJsonSchema)(ctx.module.args)) jsonSchema = ctx.module.args["~standard"].jsonSchema.input({ target: "draft-07" });
+		else jsonSchema = ctx.module.args;
+		if (!(0, __stryke_json.isJsonSchema7TupleType)(jsonSchema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`);
+		ctx.output.args = jsonSchema.items.map(__assignType((item) => resolveCommandArgument(item), [
+			"item",
+			"",
+			"P\"2!\"/\""
+		]));
+	} else if (Object.values(ctx.module.args).every(require_type_checks.isCommandParameterConfig)) ctx.output.args = ctx.module.args.map(__assignType((arg) => ({
+		...arg,
+		alias: (0, __stryke_convert_to_array.toArray)(arg.alias)
+	}), [
+		"arg",
+		"",
+		"P\"2!\"/\""
+	]));
+	else throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`);
+}
+resolveFromExports.__type = [
+	"ResolverContext",
+	"ctx",
+	"resolveFromExports",
+	"P\"w!2\"\"/#"
+];
+function validateExports(ctx) {
+	if (!ctx.module) throw new Error(`Command module at path "${ctx.input.command.path}" is undefined or null. Please ensure the module exports a valid command.`);
+	else if (!(0, __stryke_type_checks_is_set_object.isSetObject)(ctx.module)) throw new TypeError(`Command module at path "${ctx.input.command.path}" is not an object. Please ensure the module exports a valid command.`);
+	else if (!("default" in ctx.module)) throw new Error(`Command module at path "${ctx.input.command.path}" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`);
+}
+validateExports.__type = [
+	"ResolverContext",
+	"ctx",
+	"validateExports",
+	"P\"w!2\"\"/#"
+];
+
+//#endregion
+exports.resolveFromExports = resolveFromExports;
+//# sourceMappingURL=module.cjs.map

package/dist/resolver/module.cjs.map

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