@shell-shock/core 0.17.15 → 0.17.17

package/dist/api.d.cts

@@ -1,4 +1,4 @@
 //#region src/api.d.ts
-declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "types" | "prepare" | "create" | "clean" | "lint" | "test" | "build" | "docs" | "deploy">) => Promise<void>;
+declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "types" | "docs" | "create" | "clean" | "prepare" | "lint" | "test" | "build" | "deploy">) => Promise<void>;
 export = _default;
 //# sourceMappingURL=api.d.cts.map

package/dist/api.d.mts

@@ -1,5 +1,5 @@
 //#region src/api.d.ts
-declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "types" | "prepare" | "create" | "clean" | "lint" | "test" | "build" | "docs" | "deploy">) => Promise<void>;
+declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "types" | "docs" | "create" | "clean" | "prepare" | "lint" | "test" | "build" | "deploy">) => Promise<void>;
 //#endregion
 export { _default as default };
 //# sourceMappingURL=api.d.mts.map

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "0.17.14";
+var version = "0.17.16";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.17.14";
+var version = "0.17.16";
 
 //#endregion
 export { version };

package/dist/resolver/deepkit.cjs

@@ -0,0 +1,110 @@
+const require_helpers = require('./helpers.cjs');
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _stryke_type_checks_is_bigint = require("@stryke/type-checks/is-bigint");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let _stryke_type_checks_is_regexp = require("@stryke/type-checks/is-regexp");
+
+//#region src/resolver/deepkit.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function resolveCommandParameterType(type) {
+	const isKind = !((0, _stryke_type_checks_is_set_object.isSetObject)(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.string) return "string";
+	else if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || kind === _powerlines_deepkit_vendor_type.ReflectionKind.bigint || !isKind && type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(type.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal))) return "number";
+	else if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.boolean) return "boolean";
+	else return "string";
+}
+resolveCommandParameterType.__type = [
+	"type",
+	"string",
+	"number",
+	"boolean",
+	"resolveCommandParameterType",
+	"PP!!J2!P.\".#.$J/%"
+];
+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(),
+		type: resolveCommandParameterType(type),
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (option.variadic) option.type = resolveCommandParameterType(type.type.kind);
+	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		option.type = type.types.every(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(t.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		option.choices = type.types.map(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, _stryke_type_checks_is_number.isNumber)(t.literal) ? t.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal) ? Number(t.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal) option.choices = [(0, _stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.type && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	return require_helpers.mergeCommandParameter(existing, option);
+}
+resolveCommandOption.__type = [
+	"ResolverContext",
+	"ctx",
+	"reflection",
+	"CommandOption",
+	"resolveCommandOption",
+	"P\"w!2\"!2#\"w$/%"
+];
+function resolveCommandArgument(ctx, index, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
+	const argument = {
+		name: reflection.getName() || reflection.parameter.name,
+		alias: reflection.getAlias(),
+		type: resolveCommandParameterType(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue()
+	};
+	if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.array) if (type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number) {
+		argument.variadic = true;
+		argument.type = resolveCommandParameterType(type.type.kind);
+	} else throw new Error(`Unsupported array type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		argument.type = type.types.every(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(t.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		argument.choices = type.types.map(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, _stryke_type_checks_is_number.isNumber)(t.literal) ? t.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal) ? Number(t.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal) argument.choices = [(0, _stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!ctx.output.args?.length && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	return require_helpers.mergeCommandParameter(existing, argument, { name: `arg${index}` });
+}
+resolveCommandArgument.__type = [
+	"ResolverContext",
+	"ctx",
+	"index",
+	"reflection",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P\"w!2\"'2#!2$\"w%/&"
+];
+
+//#endregion
+exports.resolveCommandArgument = resolveCommandArgument;
+exports.resolveCommandOption = resolveCommandOption;
+//# sourceMappingURL=deepkit.cjs.map

package/dist/resolver/deepkit.cjs.map

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

package/dist/resolver/deepkit.mjs

@@ -0,0 +1,109 @@
+import { mergeCommandParameter } from "./helpers.mjs";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { ReflectionKind, 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 resolveCommandParameterType(type) {
+	const isKind = !(isSetObject(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === ReflectionKind.string) return "string";
+	else if (kind === ReflectionKind.number || kind === ReflectionKind.bigint || !isKind && type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return "number";
+	else if (kind === ReflectionKind.boolean) return "boolean";
+	else return "string";
+}
+resolveCommandParameterType.__type = [
+	"type",
+	"string",
+	"number",
+	"boolean",
+	"resolveCommandParameterType",
+	"PP!!J2!P.\".#.$J/%"
+];
+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(),
+		type: resolveCommandParameterType(type),
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (option.variadic) option.type = resolveCommandParameterType(type.type.kind);
+	else if (type.kind === ReflectionKind.union) {
+		option.type = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "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.type && 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[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return mergeCommandParameter(existing, option);
+}
+resolveCommandOption.__type = [
+	"ResolverContext",
+	"ctx",
+	"reflection",
+	"CommandOption",
+	"resolveCommandOption",
+	"P\"w!2\"!2#\"w$/%"
+];
+function resolveCommandArgument(ctx, index, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
+	const argument = {
+		name: reflection.getName() || reflection.parameter.name,
+		alias: reflection.getAlias(),
+		type: resolveCommandParameterType(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		required: !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.type = resolveCommandParameterType(type.type.kind);
+	} else throw new Error(`Unsupported array type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === ReflectionKind.union) {
+		argument.type = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		argument.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) argument.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 (!ctx.output.args?.length && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return mergeCommandParameter(existing, argument, { name: `arg${index}` });
+}
+resolveCommandArgument.__type = [
+	"ResolverContext",
+	"ctx",
+	"index",
+	"reflection",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P\"w!2\"'2#!2$\"w%/&"
+];
+
+//#endregion
+export { resolveCommandArgument, resolveCommandOption };
+//# sourceMappingURL=deepkit.mjs.map

package/dist/resolver/deepkit.mjs.map

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

package/dist/resolver/helpers.cjs

@@ -179,5 +179,6 @@ const mergeCommandParameter = (0, defu.createDefu)(__assignType((obj, key, value
 exports.applyArgsDefaults = applyArgsDefaults;
 exports.applyDefaults = applyDefaults;
 exports.applyOptionsDefaults = applyOptionsDefaults;
+exports.mergeCommandParameter = mergeCommandParameter;
 exports.resolveVirtualCommand = resolveVirtualCommand;
 //# sourceMappingURL=helpers.cjs.map

package/dist/resolver/helpers.mjs

@@ -176,5 +176,5 @@ const mergeCommandParameter = createDefu(__assignType((obj, key, value) => {
 ]));
 
 //#endregion
-export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand };
+export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, mergeCommandParameter, resolveVirtualCommand };
 //# sourceMappingURL=helpers.mjs.map

package/dist/resolver/resolve.cjs

@@ -1,6 +1,7 @@
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
 const require_utilities = require('../helpers/utilities.cjs');
 const require_helpers = require('./helpers.cjs');
+const require_deepkit = require('./deepkit.cjs');
 let _powerlines_schema = require("@powerlines/schema");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_path_replace = require("@stryke/path/replace");
@@ -8,8 +9,10 @@ let _stryke_string_format_constant_case = require("@stryke/string-format/constan
 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 _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let _stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
 let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
 let _powerlines_deepkit_esbuild_plugin = require("@powerlines/deepkit/esbuild-plugin");
 let _stryke_json = require("@stryke/json");
 
@@ -223,44 +226,6 @@ resolveCommandParameter.__type = [
 	"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.virtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${(0, _stryke_string_format_title_case.titleCase)(command.name)}${command.virtual ? " Commands" : ""}`;
@@ -270,7 +235,6 @@ async function preprocess(input) {
 			alias: [],
 			icon: parent?.icon,
 			tags: parent?.tags ?? [],
-			source: "file",
 			...command,
 			title,
 			options: parent === null ? require_utilities.getGlobalOptions(context, command) : {},
@@ -291,6 +255,12 @@ async function preprocess(input) {
 			resolve: { skipNodeModulesBundle: true }
 		}));
 	}
+	if (!command.virtual) {
+		if (!result.module?.default) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not include a handler function as its default export - this is required for command resolution and execution.`);
+		const type = (0, _powerlines_deepkit_vendor_type.reflect)(result.module.default);
+		if (type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.function) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not have a valid function as its default export - this is required for command resolution and execution.`);
+		result.reflection = new _powerlines_deepkit_vendor_type.ReflectionFunction(type);
+	}
 	return result;
 }
 preprocess.__type = [
@@ -441,11 +411,15 @@ async function resolve(input) {
 		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)) {
+		ctx.output.description ??= ctx.input.command.description || (0, _stryke_type_checks_is_function.isFunction)(ctx.reflection?.getDescription) ? ctx.reflection?.getDescription() : ctx.reflection?.description;
+		if (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);
+				ret[property.name] = resolveCommandParameter(property, {
+					fallbackRequired: false,
+					includeBooleanOptionFields: true
+				});
 				return ret;
 			}, [
 				"ret",
@@ -454,13 +428,32 @@ async function resolve(input) {
 				"P\"2!\"2\"\"/#"
 			]), {});
 		}
-		if (ctx.module.args && Array.isArray(ctx.module.args)) {
+		if (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",
+			if ((0, _stryke_type_checks_is_set_object.isSetObject)(args)) {
+				if (!(0, _stryke_json.isJsonSchemaTupleType)(args.schema) && !(0, _powerlines_schema.isJsonSchemaArray)(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple${args?.schema?.type ? `, instead received ${JSON.stringify(args.schema.type)}` : ""}.`);
+				if (Array.isArray(args.schema.items)) ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandParameter(item, {
+					fallbackRequired: true,
+					includeBooleanOptionFields: false
+				}), [
+					"item",
+					"",
+					"P\"2!\"/\""
+				]));
+			}
+		}
+		const parameters = ctx.reflection?.getParameters() ?? [];
+		if (parameters.length > 0) {
+			const hasOptions = parameters[0] && (parameters[0].type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || parameters[0].type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.class);
+			if (hasOptions && !ctx.module.options) {
+				const optionsReflection = _powerlines_deepkit_vendor_type.ReflectionClass.from(parameters[0]?.type);
+				for (const property of optionsReflection.getProperties()) ctx.output.options[property.getNameAsString()] = require_deepkit.resolveCommandOption(ctx, property);
+			}
+			if (!ctx.module.args) ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(__assignType((arg, index) => require_deepkit.resolveCommandArgument(ctx, index, arg), [
+				"arg",
+				"index",
 				"",
-				"P\"2!\"/\""
+				"P\"2!\"2\"\"/#"
 			]));
 		}
 	} else require_helpers.resolveVirtualCommand(ctx);

package/dist/resolver/resolve.mjs

@@ -1,15 +1,18 @@
 import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
 import { getGlobalOptions } from "../helpers/utilities.mjs";
 import { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand } from "./helpers.mjs";
-import { addProperty, extract, getPropertiesList, resolveModule } from "@powerlines/schema";
+import { resolveCommandArgument, resolveCommandOption } from "./deepkit.mjs";
+import { addProperty, extract, getPropertiesList, isJsonSchemaArray, resolveModule } from "@powerlines/schema";
 import { toArray } from "@stryke/convert/to-array";
 import { replacePath } from "@stryke/path/replace";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionClass, ReflectionFunction, ReflectionKind, reflect } from "@powerlines/deepkit/vendor/type";
 import { isBoolean } from "@stryke/type-checks/is-boolean";
 import { getUnique } from "@stryke/helpers/get-unique";
+import { isFunction } from "@stryke/type-checks/is-function";
 import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
 import { isJsonSchemaObjectType, isJsonSchemaTupleType } from "@stryke/json";
 
@@ -223,44 +226,6 @@ resolveCommandParameter.__type = [
 	"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.virtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${titleCase(command.name)}${command.virtual ? " Commands" : ""}`;
@@ -270,7 +235,6 @@ async function preprocess(input) {
 			alias: [],
 			icon: parent?.icon,
 			tags: parent?.tags ?? [],
-			source: "file",
 			...command,
 			title,
 			options: parent === null ? getGlobalOptions(context, command) : {},
@@ -291,6 +255,12 @@ async function preprocess(input) {
 			resolve: { skipNodeModulesBundle: true }
 		}));
 	}
+	if (!command.virtual) {
+		if (!result.module?.default) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not include a handler function as its default export - this is required for command resolution and execution.`);
+		const type = reflect(result.module.default);
+		if (type.kind !== ReflectionKind.function) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not have a valid function as its default export - this is required for command resolution and execution.`);
+		result.reflection = new ReflectionFunction(type);
+	}
 	return result;
 }
 preprocess.__type = [
@@ -441,11 +411,15 @@ async function resolve(input) {
 		if (isSetString(metadata.alias) || Array.isArray(metadata.alias) && metadata.alias.length > 0) ctx.output.alias = toArray(metadata.alias);
 		if (isSetString(metadata.icon)) ctx.output.icon = metadata.icon;
 		if (isSetString(metadata.tags)) ctx.output.tags = getUnique(ctx.output.tags.concat(toArray(metadata.tags)));
-		if (isSetObject(ctx.module.options)) {
+		ctx.output.description ??= ctx.input.command.description || isFunction(ctx.reflection?.getDescription) ? ctx.reflection?.getDescription() : ctx.reflection?.description;
+		if (ctx.module.options) {
 			const options = await extract(ctx.input.context, ctx.module.options);
 			if (!isSetObject(options) || !isJsonSchemaObjectType(options.schema)) throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must resolve to an object.`);
 			ctx.output.options = getPropertiesList(options).reduce(__assignType((ret, property) => {
-				ret[property.name] = resolveCommandOption(property);
+				ret[property.name] = resolveCommandParameter(property, {
+					fallbackRequired: false,
+					includeBooleanOptionFields: true
+				});
 				return ret;
 			}, [
 				"ret",
@@ -454,13 +428,32 @@ async function resolve(input) {
 				"P\"2!\"2\"\"/#"
 			]), {});
 		}
-		if (ctx.module.args && Array.isArray(ctx.module.args)) {
+		if (ctx.module.args) {
 			const args = await extract(ctx.input.context, ctx.module.args);
-			if (!isSetObject(args) || !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",
+			if (isSetObject(args)) {
+				if (!isJsonSchemaTupleType(args.schema) && !isJsonSchemaArray(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple${args?.schema?.type ? `, instead received ${JSON.stringify(args.schema.type)}` : ""}.`);
+				if (Array.isArray(args.schema.items)) ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandParameter(item, {
+					fallbackRequired: true,
+					includeBooleanOptionFields: false
+				}), [
+					"item",
+					"",
+					"P\"2!\"/\""
+				]));
+			}
+		}
+		const parameters = ctx.reflection?.getParameters() ?? [];
+		if (parameters.length > 0) {
+			const hasOptions = parameters[0] && (parameters[0].type.kind === ReflectionKind.objectLiteral || parameters[0].type.kind === ReflectionKind.class);
+			if (hasOptions && !ctx.module.options) {
+				const optionsReflection = ReflectionClass.from(parameters[0]?.type);
+				for (const property of optionsReflection.getProperties()) ctx.output.options[property.getNameAsString()] = resolveCommandOption(ctx, property);
+			}
+			if (!ctx.module.args) ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(__assignType((arg, index) => resolveCommandArgument(ctx, index, arg), [
+				"arg",
+				"index",
 				"",
-				"P\"2!\"/\""
+				"P\"2!\"2\"\"/#"
 			]));
 		}
 	} else resolveVirtualCommand(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.17.15",
+  "version": "0.17.17",
   "private": false,
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "keywords": ["shell-shock", "powerlines", "storm-software"],
@@ -407,5 +407,5 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "302eeb47bc029bb0105ec572faecfe398a30d3c1"
+  "gitHead": "8c9f000d243ed0b6ac67b2be112429ddeccd0617"
 }