@shell-shock/core 0.17.10 → 0.17.11

package/dist/resolver/helpers.mjs

@@ -1,5 +1,4 @@
 import { getAppTitle, isDynamicPathSegment } 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";
@@ -16,53 +15,57 @@ function __assignType(fn, args) {
 * 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 type - The reflection kind of the command option.
+* @param required - Whether the command option is required.
 * @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" : ""}`}.`;
+function resolveCommandOptionDescription(name, type, required = true, variadic = false, title, defaultValue) {
+	return `A${!required && !defaultValue ? "n optional" : ""} command-line ${type === "boolean" ? "flag" : "option"} that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 resolveCommandOptionDescription.__type = [
 	"name",
-	"CommandParameterKind",
-	"kind",
-	"optional",
+	"string",
+	"number",
+	"boolean",
+	"type",
+	"required",
 	"variadic",
 	"title",
 	"defaultValue",
 	"resolveCommandOptionDescription",
 	"Resolves the description for a command option based on its reflection.",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
+	"P&2!P.\".#.$J2%\"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 type - The reflection kind of the command argument.
+* @param required - Whether the command argument is required.
 * @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" : ""}`}.`;
+function resolveCommandArgumentDescription(name, type, required = true, variadic = false, title, defaultValue) {
+	return `An${!required && !defaultValue ? " optional" : ""} argument that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 resolveCommandArgumentDescription.__type = [
 	"name",
-	"CommandParameterKind",
-	"kind",
-	"optional",
+	"string",
+	"number",
+	"boolean",
+	"type",
+	"required",
 	"variadic",
 	"title",
 	"defaultValue",
 	"resolveCommandArgumentDescription",
 	"Resolves the description for a command argument based on its reflection.",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
+	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
 ];
 function applyOptionsDefaults(ctx) {
 	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
@@ -72,7 +75,7 @@ function applyOptionsDefaults(ctx) {
 			...option,
 			name,
 			title,
-			description: option.description || resolveCommandOptionDescription(name, option.kind, option.optional, option.kind !== CommandParameterKinds.boolean && option.variadic, title, option.default),
+			description: option.description || resolveCommandOptionDescription(name, option.type, option.required, option.type !== "boolean" && option.variadic, title, option.default),
 			env: option.env || option.env === false ? option.env : ctx.input.context.config.autoAssignEnv ? constantCase(name) : false
 		}];
 	}, [
@@ -95,7 +98,7 @@ function applyArgsDefaults(ctx) {
 			...arg,
 			name,
 			title,
-			description: arg.description || resolveCommandArgumentDescription(name, arg.kind, arg.optional, arg.kind !== CommandParameterKinds.boolean && arg.variadic, title, arg.default),
+			description: arg.description || resolveCommandArgumentDescription(name, arg.type, arg.required, arg.type !== "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
 		};
 	}, [
@@ -114,7 +117,7 @@ applyArgsDefaults.__type = [
 ];
 function applyDefaults(ctx) {
 	ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
-	if (isSetString(ctx.input.context.config.reference?.commands) && ctx.input.context.config.reference.commands.includes("{command}")) ctx.output.reference ??= ctx.input.context.config.reference.commands ? ctx.input.context.config.reference.commands.replace("{command}", ctx.input.command.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+	if (isSetString(ctx.input.context.config.reference?.commands) && ctx.input.context.config.reference.commands.includes("{command}")) ctx.output.docs ??= ctx.input.context.config.reference.commands ? ctx.input.context.config.reference.commands.replace("{command}", ctx.input.command.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
 		"segment",
 		"",
 		"P\"2!\"/\""
@@ -126,6 +129,12 @@ applyDefaults.__type = [
 	"applyDefaults",
 	"P\"w!2\"\"/#"
 ];
+/**
+* Resolves a virtual command by applying default values to its title and description based on the command name and application title.
+*
+* @template TContext - The type of the context object.
+* @param ctx - The resolver context containing the input and output for the command resolution process.
+*/
 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, true)} command-line application.`;
@@ -134,7 +143,8 @@ resolveVirtualCommand.__type = [
 	"ResolverContext",
 	"ctx",
 	"resolveVirtualCommand",
-	"P\"w!2\"\"/#"
+	"Resolves a virtual command by applying default values to its title and description based on the command name and application title.",
+	"P\"w!2\"\"/#?$"
 ];
 /**
 * Merges two command parameters, giving precedence to string values in the second configuration.
@@ -165,5 +175,5 @@ const mergeCommandParameter = createDefu(__assignType((obj, key, value) => {
 ]));
 
 //#endregion
-export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, mergeCommandParameter, resolveVirtualCommand };
+export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand };
 //# sourceMappingURL=helpers.mjs.map

package/dist/resolver/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/resolver/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context,\n    true\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":"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"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":[],"mappings":""}

package/dist/resolver/resolve.cjs

@@ -1,25 +1,268 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
-const require_deepkit = require('../plugin-utils/deepkit.cjs');
 const require_utilities = require('../helpers/utilities.cjs');
 const require_helpers = require('./helpers.cjs');
-const require_deepkit$1 = require('./deepkit.cjs');
-const require_module = require('./module.cjs');
-let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _powerlines_schema = require("@powerlines/schema");
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
-let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 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_string_format_title_case = require("@stryke/string-format/title-case");
+let _stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
+let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
 let _powerlines_deepkit_esbuild_plugin = require("@powerlines/deepkit/esbuild-plugin");
-let _powerlines_plugin_esbuild_helpers_resolve = require("@powerlines/plugin-esbuild/helpers/resolve");
+let _stryke_json = require("@stryke/json");
 
 //#region src/resolver/resolve.ts
+const __ΩRecord = [
+	"K",
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+];
 function __assignType(fn, args) {
 	fn.__type = args;
 	return fn;
 }
-async function initialize(input) {
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+isFiniteNumber.__type = [
+	"value",
+	"isFiniteNumber",
+	"P#2!!/\""
+];
+function asRecord(value) {
+	return (0, _stryke_type_checks_is_set_object.isSetObject)(value) ? value : {};
+}
+asRecord.__type = [
+	"value",
+	() => __ΩRecord,
+	"asRecord",
+	"P#2!&#o\"#/#"
+];
+function toAliasList(value) {
+	if (Array.isArray(value)) return (0, _stryke_helpers_get_unique.getUnique)(value.filter(_stryke_type_checks_is_set_string.isSetString));
+	return (0, _stryke_type_checks_is_set_string.isSetString)(value) ? [value] : [];
+}
+toAliasList.__type = [
+	"value",
+	"toAliasList",
+	"P#2!&F/\""
+];
+function inferParameterType(input) {
+	const schemaType = input.type;
+	if (Array.isArray(schemaType)) {
+		const first = schemaType.find(__assignType((type) => type !== "null", [
+			"type",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (first === "integer" || first === "number") return "number";
+		if (first === "boolean") return "boolean";
+		if (first === "array") {
+			const nestedType = asRecord(input.items).type;
+			if (nestedType === "integer" || nestedType === "number") return "number";
+			if (nestedType === "boolean") return "boolean";
+			return "string";
+		}
+		return "string";
+	}
+	if (schemaType === "integer" || schemaType === "number") return "number";
+	if (schemaType === "boolean") return "boolean";
+	if (schemaType === "array") {
+		const nestedType = asRecord(input.items).type;
+		if (nestedType === "integer" || nestedType === "number") return "number";
+		if (nestedType === "boolean") return "boolean";
+		return "string";
+	}
+	if (Array.isArray(input.enum) && input.enum.length > 0) {
+		const first = input.enum.find(__assignType((value) => value !== null, [
+			"value",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (isFiniteNumber(first)) return "number";
+		if ((0, _stryke_type_checks_is_boolean.isBoolean)(first)) return "boolean";
+	}
+	if (isFiniteNumber(input.default)) return "number";
+	if ((0, _stryke_type_checks_is_boolean.isBoolean)(input.default)) return "boolean";
+	return "string";
+}
+inferParameterType.__type = [
+	() => __ΩRecord,
+	"input",
+	"CommandOption",
+	"type",
+	"inferParameterType",
+	"P&#o!#2\"\"w#.$f/%"
+];
+function inferVariadic(input) {
+	if ((0, _stryke_type_checks_is_boolean.isBoolean)(input.variadic)) return input.variadic;
+	return input.type === "array";
+}
+inferVariadic.__type = [
+	() => __ΩRecord,
+	"input",
+	"inferVariadic",
+	"P&#o!#2\")/#"
+];
+function normalizeDefault(input, type, variadic) {
+	const defaultValue = input.default;
+	if (defaultValue === void 0) return;
+	if (type === "boolean") {
+		if (variadic) {
+			if (Array.isArray(defaultValue)) return defaultValue.filter(_stryke_type_checks_is_boolean.isBoolean);
+			return (0, _stryke_type_checks_is_boolean.isBoolean)(defaultValue) ? [defaultValue] : void 0;
+		}
+		if (Array.isArray(defaultValue)) return defaultValue.find(_stryke_type_checks_is_boolean.isBoolean);
+		return (0, _stryke_type_checks_is_boolean.isBoolean)(defaultValue) ? defaultValue : void 0;
+	}
+	if (type === "number") {
+		if (variadic) {
+			if (Array.isArray(defaultValue)) return defaultValue.map(__assignType((item) => typeof item === "bigint" ? Number(item) : item, [
+				"item",
+				"",
+				"P\"2!\"/\""
+			])).filter(isFiniteNumber);
+			const normalized = typeof defaultValue === "bigint" ? Number(defaultValue) : defaultValue;
+			return isFiniteNumber(normalized) ? [normalized] : void 0;
+		}
+		if (Array.isArray(defaultValue)) return defaultValue.map(__assignType((item) => typeof item === "bigint" ? Number(item) : item, [
+			"item",
+			"",
+			"P\"2!\"/\""
+		])).find(isFiniteNumber);
+		const normalized = typeof defaultValue === "bigint" ? Number(defaultValue) : defaultValue;
+		return isFiniteNumber(normalized) ? normalized : void 0;
+	}
+	if (variadic) {
+		if (Array.isArray(defaultValue)) return defaultValue.filter(_stryke_type_checks_is_set_string.isSetString);
+		return (0, _stryke_type_checks_is_set_string.isSetString)(defaultValue) ? [defaultValue] : void 0;
+	}
+	if (Array.isArray(defaultValue)) return defaultValue.find(_stryke_type_checks_is_set_string.isSetString);
+	return (0, _stryke_type_checks_is_set_string.isSetString)(defaultValue) ? defaultValue : void 0;
+}
+normalizeDefault.__type = [
+	() => __ΩRecord,
+	"input",
+	"CommandOption",
+	"type",
+	"type",
+	"variadic",
+	"normalizeDefault",
+	"P&#o!#2\"\"w#.$f2%)2&\"/'"
+];
+function normalizeStringChoices(input) {
+	const source = Array.isArray(input.choices) ? input.choices : input.enum;
+	if (!Array.isArray(source)) return;
+	return source.filter(_stryke_type_checks_is_set_string.isSetString);
+}
+normalizeStringChoices.__type = [
+	() => __ΩRecord,
+	"input",
+	"normalizeStringChoices",
+	"P&#o!#2\"\"/#"
+];
+function normalizeNumberChoices(input) {
+	const source = Array.isArray(input.choices) ? input.choices : input.enum;
+	if (!Array.isArray(source)) return;
+	return source.map(__assignType((item) => typeof item === "bigint" ? Number(item) : item, [
+		"item",
+		"",
+		"P\"2!\"/\""
+	])).filter(isFiniteNumber);
+}
+normalizeNumberChoices.__type = [
+	() => __ΩRecord,
+	"input",
+	"normalizeNumberChoices",
+	"P&#o!#2\"\"/#"
+];
+function resolveCommandParameter(schema, defaults) {
+	const input = asRecord(schema);
+	const type = inferParameterType(input);
+	const variadic = inferVariadic(input);
+	const defaultValue = normalizeDefault(input, type, variadic);
+	const required = (0, _stryke_type_checks_is_boolean.isBoolean)(input.required) ? input.required : defaultValue === void 0 ? defaults.fallbackRequired : false;
+	const env = (0, _stryke_type_checks_is_set_string.isSetString)(input.env) ? input.env : false;
+	const result = {
+		name: (0, _stryke_type_checks_is_set_string.isSetString)(input.name) ? input.name : "",
+		type,
+		title: (0, _stryke_type_checks_is_set_string.isSetString)(input.title) ? input.title : "",
+		description: (0, _stryke_type_checks_is_set_string.isSetString)(input.description) ? input.description : "",
+		alias: toAliasList(input.alias),
+		default: defaultValue,
+		env,
+		required,
+		variadic
+	};
+	if (type === "string") {
+		const stringChoices = normalizeStringChoices(input);
+		if (Array.isArray(stringChoices)) result.choices = stringChoices;
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(input.format)) result.format = input.format;
+	}
+	if (type === "number") {
+		const numberChoices = normalizeNumberChoices(input);
+		if (Array.isArray(numberChoices)) result.choices = numberChoices;
+	}
+	if (defaults.includeBooleanOptionFields && type === "boolean" && !variadic) {
+		const optionResult = result;
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(input.isNegativeOf)) optionResult.isNegativeOf = input.isNegativeOf;
+		if ((0, _stryke_type_checks_is_boolean.isBoolean)(input.skipAddingNegative)) optionResult.skipAddingNegative = input.skipAddingNegative;
+	}
+	return result;
+}
+resolveCommandParameter.__type = [
+	"schema",
+	"fallbackRequired",
+	"includeBooleanOptionFields",
+	"defaults",
+	"CommandOption",
+	"CommandArgument",
+	"resolveCommandParameter",
+	"P#2!P)4\")4#M2$P\"w%\"w&J/'"
+];
+/**
+* Resolves a command option from the given schema.
+*
+* @param schema - The command option schema, which can be a command option configuration or a JSON schema input.
+* @returns The resolved command option definition.
+*/
+function resolveCommandOption(schema) {
+	return resolveCommandParameter(schema, {
+		fallbackRequired: false,
+		includeBooleanOptionFields: true
+	});
+}
+resolveCommandOption.__type = [
+	"schema",
+	"CommandOption",
+	"resolveCommandOption",
+	"Resolves a command option from the given schema.",
+	"P#2!\"w\"/#?$"
+];
+/**
+* Resolves a command argument from the given schema.
+*
+* @param schema - The command argument schema, which can be a command argument configuration or a JSON schema input.
+* @returns The resolved command argument definition.
+*/
+function resolveCommandArgument(schema) {
+	return resolveCommandParameter(schema, {
+		fallbackRequired: true,
+		includeBooleanOptionFields: false
+	});
+}
+resolveCommandArgument.__type = [
+	"schema",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"Resolves a command argument from the given schema.",
+	"P#2!\"w\"/#?$"
+];
+async function preprocess(input) {
 	const { context, command, parent } = input;
-	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${(0, _stryke_string_format_title_case.titleCase)(command.name)}${command.isVirtual ? " Commands" : ""}`;
+	const title = command.title || `${parent?.title ? `${parent.virtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${(0, _stryke_string_format_title_case.titleCase)(command.name)}${command.virtual ? " Commands" : ""}`;
 	const result = {
 		input,
 		output: {
@@ -35,26 +278,25 @@ async function initialize(input) {
 			children: {}
 		}
 	};
-	if (!command.isVirtual) {
+	if (!command.virtual) {
 		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
 		context.debug(`Adding reflection for CLI command: ${command.id} (file: ${command.entry.input.file})`);
-		result.module = await (_powerlines_plugin_esbuild_helpers_resolve.resolveModule.Ω = [["CommandModule", "\"w!"]], (0, _powerlines_plugin_esbuild_helpers_resolve.resolveModule)(context, command.entry.input, {
+		result.module = await (_powerlines_schema.resolveModule.Ω = [["CommandModule", "\"w!"]], (0, _powerlines_schema.resolveModule)(context, command.entry.input, {
 			name: command.title || (0, _stryke_string_format_title_case.titleCase)(command.name),
-			treeShaking: true,
-			resolve: { skipNodeModulesBundle: true },
 			plugins: [(0, _powerlines_deepkit_esbuild_plugin.esbuildPlugin)(context, {
 				reflection: "default",
 				level: "all"
-			})]
+			})],
+			resolve: { skipNodeModulesBundle: true }
 		}));
 	}
 	return result;
 }
-initialize.__type = [
+preprocess.__type = [
 	"ResolverInput",
 	"input",
 	"ResolverContext",
-	"initialize",
+	"preprocess",
 	"P\"w!2\"\"w#`/$"
 ];
 async function postprocess(ctx) {
@@ -95,26 +337,18 @@ async function postprocess(ctx) {
 			"",
 			"P\"2!\"/\""
 		])).forEach(__assignType((option) => {
-			ctx.input.context.env.types.env.addProperty({
+			(0, _powerlines_schema.addProperty)(ctx.input.context.env.config.schema, option.env, {
+				...option,
 				name: option.env,
-				optional: option.optional ? true : void 0,
-				description: option.description,
-				visibility: _powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-				type: require_deepkit.extractType(option),
-				default: option.default,
-				tags: {
-					title: option.title,
-					alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
-						"alias",
-						"",
-						"P\"2!\"/\""
-					])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
-						"alias",
-						"",
-						"P\"2!\"/\""
-					])),
-					domain: "cli"
-				}
+				alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+					"alias",
+					"",
+					"P\"2!\"/\""
+				])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
+					"alias",
+					"",
+					"P\"2!\"/\""
+				]))
 			});
 		}, [
 			"option",
@@ -125,25 +359,18 @@ async function postprocess(ctx) {
 			"arg",
 			"",
 			"P\"2!\"/\""
-		])).forEach(__assignType((arg) => ctx.input.context.env.types.env.addProperty({
+		])).forEach(__assignType((arg) => (0, _powerlines_schema.addProperty)(ctx.input.context.env.config.schema, arg.env, {
+			...arg,
 			name: arg.env,
-			optional: arg.optional ? true : void 0,
-			description: arg.description,
-			visibility: _powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-			type: require_deepkit.extractType(arg),
-			default: arg.default,
-			tags: {
-				alias: arg.alias.filter(__assignType((alias) => alias.length > 1, [
-					"alias",
-					"",
-					"P\"2!\"/\""
-				])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
-					"alias",
-					"",
-					"P\"2!\"/\""
-				])),
-				domain: "cli"
-			}
+			alias: arg.alias.filter(__assignType((alias) => alias.length > 1, [
+				"alias",
+				"",
+				"P\"2!\"/\""
+			])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
+				"alias",
+				"",
+				"P\"2!\"/\""
+			]))
 		}), [
 			"arg",
 			"",
@@ -198,14 +425,43 @@ postprocess.__type = [
 * @returns A promise that resolves to the resolved command tree.
 */
 async function resolve(input) {
-	const ctx = await (initialize.Ω = [[
+	const ctx = await (preprocess.Ω = [[
 		() => input,
 		"ResolverInput",
 		"Pi!\"w\"q\"!j"
-	]], initialize(input));
-	if (!ctx.output.isVirtual) {
-		await require_module.resolveFromExports(ctx);
-		require_deepkit$1.resolveFromBytecode(ctx);
+	]], preprocess(input));
+	if (!ctx.output.virtual) {
+		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.`);
+		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_string.isSetString)(metadata.tags)) ctx.output.tags = (0, _stryke_helpers_get_unique.getUnique)(ctx.output.tags.concat((0, _stryke_convert_to_array.toArray)(metadata.tags)));
+		if ((0, _stryke_type_checks_is_set_object.isSetObject)(ctx.module.options)) {
+			const options = await (0, _powerlines_schema.extract)(ctx.input.context, ctx.module.options);
+			if (!(0, _stryke_type_checks_is_set_object.isSetObject)(options) || !(0, _stryke_json.isJsonSchemaObjectType)(options.schema)) throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must resolve to an object.`);
+			ctx.output.options = (0, _powerlines_schema.getPropertiesList)(options).reduce(__assignType((ret, property) => {
+				ret[property.name] = resolveCommandOption(property);
+				return ret;
+			}, [
+				"ret",
+				"property",
+				"",
+				"P\"2!\"2\"\"/#"
+			]), {});
+		}
+		if (ctx.module.args && Array.isArray(ctx.module.args)) {
+			const args = await (0, _powerlines_schema.extract)(ctx.input.context, ctx.module.args);
+			if (!(0, _stryke_type_checks_is_set_object.isSetObject)(args) || !(0, _stryke_json.isJsonSchemaTupleType)(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple.`);
+			ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandArgument(item), [
+				"item",
+				"",
+				"P\"2!\"/\""
+			]));
+		}
 	} else require_helpers.resolveVirtualCommand(ctx);
 	return postprocess(ctx);
 }
@@ -219,4 +475,5 @@ resolve.__type = [
 ];
 
 //#endregion
-exports.resolve = resolve;
+exports.resolve = resolve;
+//# sourceMappingURL=resolve.cjs.map

package/dist/resolver/resolve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.cjs","names":[],"sources":[],"mappings":""}