@shell-shock/core 0.17.8 → 0.17.10

package/dist/resolver/deepkit.cjs

@@ -1 +1,135 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../types/command.cjs`),t=require(`./helpers.cjs`);let n=require(`@powerlines/deepkit/vendor/type`),r=require(`@stryke/type-checks/is-set-object`),i=require(`@stryke/type-checks/is-bigint`),a=require(`@stryke/type-checks/is-number`),o=require(`@stryke/type-checks/is-regexp`);function s(e,t){return e.__type=t,e}function c(t){let o=!((0,r.isSetObject)(t)&&`kind`in t),s=o?t:t.kind;return s===n.ReflectionKind.string?e.CommandParameterKinds.string:s===n.ReflectionKind.number||s===n.ReflectionKind.bigint||!o&&t.kind===n.ReflectionKind.literal&&((0,a.isNumber)(t.literal)||(0,i.isBigInt)(t.literal))?e.CommandParameterKinds.number:s===n.ReflectionKind.boolean?e.CommandParameterKinds.boolean:e.CommandParameterKinds.string}c.__type=[`type`,`CommandParameterKind`,`extractCommandParameterKind`,`PP!!J2!"w"/#`];function l(r,l){let u=l.getType(),d=r.output.options[l.getNameAsString()]??{},f={name:l.getNameAsString(),alias:l.getTags().alias??[],title:l.getTags().title?.trim(),description:l.getDescription(),kind:c(u),optional:l.isOptional(),default:l.getDefaultValue(),variadic:l.isArray()};if(f.variadic)f.kind=c(u.type.kind);else if(u.kind===n.ReflectionKind.union)f.kind=u.types.every(s(e=>e.kind===n.ReflectionKind.number||e.kind===n.ReflectionKind.literal&&((0,a.isNumber)(e.literal)||(0,i.isBigInt)(e.literal)),[`t`,``,`P"2!"/"`]))?e.CommandParameterKinds.number:e.CommandParameterKinds.string,f.choices=u.types.map(s(e=>e.kind===n.ReflectionKind.literal?(0,a.isNumber)(e.literal)?e.literal:(0,i.isBigInt)(e.literal)?Number(e.literal):(0,o.isRegExp)(e.literal)?e.literal.source:String(e.literal):null,[`t`,``,`P"2!"/"`])).filter(Boolean);else if(u.kind===n.ReflectionKind.literal)f.choices=[(0,a.isNumber)(u.literal)?u.literal:(0,i.isBigInt)(u.literal)?Number(u.literal):(0,o.isRegExp)(u.literal)?u.literal.source:String(u.literal)].filter(Boolean);else if(!d.kind&&u.kind!==n.ReflectionKind.boolean&&u.kind!==n.ReflectionKind.string&&u.kind!==n.ReflectionKind.number)throw Error(`Unsupported type for option "${l.getNameAsString()}" in command "${r.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0,n.stringifyType)(u).trim().replaceAll(` | `,`, or `)}.`);return t.mergeCommandParameter(d,f)}l.__type=[`ResolverContext`,`ctx`,`reflection`,`CommandOption`,`resolveCommandOption`,`P"w!2"!2#"w$/%`];function u(r,l,u){let d=u.getType(),f=r.output.args.length>l?r.output.args[l]:{},p={name:u.getName()||u.parameter.name,alias:u.getAlias(),kind:c(d.kind),title:u.getTitle()||u.parameter.tags?.title,description:u.parameter.description,optional:u.isOptional(),default:u.getDefaultValue()||u.parameter.default};if(d.kind===n.ReflectionKind.array)if(d.type.kind===n.ReflectionKind.string||d.type.kind===n.ReflectionKind.number)p.variadic=!0,p.kind=c(d.type.kind);else throw Error(`Unsupported array type for positional argument "${p.name}" in command "${r.input.command.name}". Only string[], number[], or literal[] are supported, received ${(0,n.stringifyType)(d).trim().replaceAll(` | `,`, or `)}.`);else if(d.kind===n.ReflectionKind.union)p.kind=d.types.every(s(e=>e.kind===n.ReflectionKind.number||e.kind===n.ReflectionKind.literal&&((0,a.isNumber)(e.literal)||(0,i.isBigInt)(e.literal)),[`t`,``,`P"2!"/"`]))?e.CommandParameterKinds.number:e.CommandParameterKinds.string,p.choices=d.types.map(s(e=>e.kind===n.ReflectionKind.literal?(0,a.isNumber)(e.literal)?e.literal:(0,i.isBigInt)(e.literal)?Number(e.literal):(0,o.isRegExp)(e.literal)?e.literal.source:String(e.literal):null,[`t`,``,`P"2!"/"`])).filter(Boolean);else if(d.kind===n.ReflectionKind.literal)p.choices=[(0,a.isNumber)(d.literal)?d.literal:(0,i.isBigInt)(d.literal)?Number(d.literal):(0,o.isRegExp)(d.literal)?d.literal.source:String(d.literal)].filter(Boolean);else if(!r.output.args?.length&&d.kind!==n.ReflectionKind.boolean&&d.kind!==n.ReflectionKind.string&&d.kind!==n.ReflectionKind.number)throw Error(`Unsupported type for positional argument "${p.name}" in command "${r.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0,n.stringifyType)(d).trim().replaceAll(` | `,`, or `)}.`);return t.mergeCommandParameter(f,p,{name:`arg${l}`})}u.__type=[`ResolverContext`,`ctx`,`index`,`reflection`,`CommandArgument`,`resolveCommandArgument`,`P"w!2"'2#!2$"w%/&`];function d(e){let{input:t,module:r}=e,i=(0,n.reflect)(r);if(i.kind!==n.ReflectionKind.function)throw Error(`The command entry file "${t.command.entry.input?.file||t.command.path}" does not export a valid function.`);let a=new n.ReflectionFunction(i);e.output.description??=e.input.command.description||a.getDescription()||i.description;let o=a.getParameters();if(o.length>0){let t=o[0]&&(o[0].type.kind===n.ReflectionKind.objectLiteral||o[0].type.kind===n.ReflectionKind.class);if(t){let t=n.ReflectionClass.from(o[0]?.type);for(let n of t.getProperties())e.output.options[n.getNameAsString()]=l(e,n)}e.output.args=(t?o.slice(1):o).map(s((t,n)=>u(e,n,t),[`arg`,`index`,``,`P"2!"2""/#`]))}}d.__type=[`ResolverContext`,`ctx`,`resolveFromBytecode`,`P"w!2""/#`],exports.resolveFromBytecode=d;
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_types_command = require('../types/command.cjs');
+const require_helpers = require('./helpers.cjs');
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+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 extractCommandParameterKind(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 require_types_command.CommandParameterKinds.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 require_types_command.CommandParameterKinds.number;
+	else if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.boolean) return require_types_command.CommandParameterKinds.boolean;
+	else return require_types_command.CommandParameterKinds.string;
+}
+extractCommandParameterKind.__type = [
+	"type",
+	"CommandParameterKind",
+	"extractCommandParameterKind",
+	"PP!!J2!\"w\"/#"
+];
+function resolveCommandOption(ctx, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.options[reflection.getNameAsString()] ?? {};
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim(),
+		description: reflection.getDescription(),
+		kind: extractCommandParameterKind(type),
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (option.variadic) option.kind = extractCommandParameterKind(type.type.kind);
+	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		option.kind = 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!\"/\""
+		])) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.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.kind && 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(),
+		kind: extractCommandParameterKind(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue() || reflection.parameter.default
+	};
+	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.kind = extractCommandParameterKind(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.kind = 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!\"/\""
+		])) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.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%/&"
+];
+function resolveFromBytecode(ctx) {
+	const { input, module } = ctx;
+	const type = (0, _powerlines_deepkit_vendor_type.reflect)(module);
+	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 export a valid function.`);
+	const reflection = new _powerlines_deepkit_vendor_type.ReflectionFunction(type);
+	ctx.output.description ??= ctx.input.command.description || reflection.getDescription() || type.description;
+	const parameters = 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) {
+			const optionsReflection = _powerlines_deepkit_vendor_type.ReflectionClass.from(parameters[0]?.type);
+			for (const propertyReflection of optionsReflection.getProperties()) ctx.output.options[propertyReflection.getNameAsString()] = resolveCommandOption(ctx, propertyReflection);
+		}
+		ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(__assignType((arg, index) => resolveCommandArgument(ctx, index, arg), [
+			"arg",
+			"index",
+			"",
+			"P\"2!\"2\"\"/#"
+		]));
+	}
+}
+resolveFromBytecode.__type = [
+	"ResolverContext",
+	"ctx",
+	"resolveFromBytecode",
+	"P\"w!2\"\"/#"
+];
+
+//#endregion
+exports.resolveFromBytecode = resolveFromBytecode;

package/dist/resolver/deepkit.mjs

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

package/dist/resolver/deepkit.mjs.map

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

package/dist/resolver/helpers.cjs

@@ -1 +1,173 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../plugin-utils/context-helpers.cjs`),t=require(`../types/command.cjs`);let n=require(`@stryke/string-format/constant-case`),r=require(`@stryke/type-checks/is-set-string`),i=require(`defu`),a=require(`@stryke/string-format/title-case`),o=require(`@stryke/helpers/get-unique`),s=require(`@stryke/type-checks/is-string`);function c(e,t){return e.__type=t,e}function l(e,n,r=!1,i=!1,o,s){return`A${r&&!s?`n optional`:``} command-line ${n===t.CommandParameterKinds.boolean?`flag`:`option`} that allows the user to ${n===t.CommandParameterKinds.boolean?`set the`:i?`specify custom`:`specify a custom`} ${o?.trim()||(0,a.titleCase)(e)} ${n===t.CommandParameterKinds.boolean?`indicator`:`${n===t.CommandParameterKinds.number?`numeric`:`string`} value${i?`s`:``}`}.`}l.__type=[`name`,`CommandParameterKind`,`kind`,`optional`,`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&/(?)`];function u(e,n,r=!1,i=!1,o,s){return`An${r&&!s?` optional`:``} argument that allows the user to ${n===t.CommandParameterKinds.boolean?`set the`:i?`specify custom`:`specify a custom`} ${o?.trim()||(0,a.titleCase)(e)} ${n===t.CommandParameterKinds.boolean?`indicator`:`${n===t.CommandParameterKinds.number?`numeric`:`string`} value${i?`s`:``}`}.`}u.__type=[`name`,`CommandParameterKind`,`kind`,`optional`,`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&/(?)`];function d(e){return Object.fromEntries(Object.entries(e.output.options).map(c(([r,i])=>{let o=i.name||r,s=i.title||(0,a.titleCase)(o);return[r,{...i,name:o,title:s,description:i.description||l(o,i.kind,i.optional,i.kind!==t.CommandParameterKinds.boolean&&i.variadic,s,i.default),env:i.env||i.env===!1?i.env:e.input.context.config.autoAssignEnv?(0,n.constantCase)(o):!1}]},[`param0`,``,`P"2!"/"`])))}d.__type=[`ResolverContext`,`ctx`,`applyOptionsDefaults`,`P"w!2""/#`];function f(e){return e.output.args.map(c((r,i)=>{let o=r.name||`arg${i+1}`,s=r.title||(0,a.titleCase)(o);return{...r,name:o,title:s,description:r.description||u(o,r.kind,r.optional,r.kind!==t.CommandParameterKinds.boolean&&r.variadic,s,r.default),env:r.name?r.env||r.env===!1?r.env:e.input.context.config.autoAssignEnv?(0,n.constantCase)(o):!1:!1}},[`arg`,`i`,``,`P"2!"2""/#`]))}f.__type=[`ResolverContext`,`ctx`,`CommandArgument`,`applyArgsDefaults`,`P"w!2""w#F/$`];function p(t){t.output.description??=`The ${t.output.title.replace(/(?:c|C)ommands?$/,``).trim()} executable command-line interface.`,(0,r.isSetString)(t.input.context.config.reference?.commands)&&t.input.context.config.reference.commands.includes(`{command}`)&&(t.output.reference??=t.input.context.config.reference.commands?t.input.context.config.reference.commands.replace(`{command}`,t.input.command.segments.filter(c(t=>!e.isDynamicPathSegment(t),[`segment`,``,`P"2!"/"`])).join(`/`)):void 0)}p.__type=[`ResolverContext`,`ctx`,`applyDefaults`,`P"w!2""/#`];function m(t){t.output.title??=(0,a.titleCase)(t.input.command.name),t.output.description??=`A collection of available ${t.output.title.replace(/(?:c|C)ommands?$/,``).trim()||(0,a.titleCase)(t.input.command.name)} commands that are included in the ${e.getAppTitle(t.input.context,!0)} command-line application.`}m.__type=[`ResolverContext`,`ctx`,`resolveVirtualCommand`,`P"w!2""/#`];const h=(0,i.createDefu)(c((e,t,n)=>(0,s.isString)(e[t])&&(0,s.isString)(n)?((0,r.isSetString)(n)&&(e[t]=n),!0):Array.isArray(e[t])&&Array.isArray(n)?(n.length>0&&(e[t]=(0,o.getUniqueBy)(e[t].concat(n),c(e=>(0,s.isString)(e)?e:JSON.stringify(e),[`item`,``,`P"2!"/"`]))),!0):!1,[`obj`,`key`,`value`,``,`P"2!"2""2#"/$`]));exports.applyArgsDefaults=f,exports.applyDefaults=p,exports.applyOptionsDefaults=d,exports.mergeCommandParameter=h,exports.resolveVirtualCommand=m;
+const require_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",
+	"Resolves the description for a command option based on its reflection.",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
+];
+/**
+* Resolves the description for a command argument based on its reflection.
+*
+* @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",
+	"Resolves the description for a command argument based on its reflection.",
+	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
+];
+function applyOptionsDefaults(ctx) {
+	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
+		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.`;
+	if ((0, _stryke_type_checks_is_set_string.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) => !require_context_helpers.isDynamicPathSegment(segment), [
+		"segment",
+		"",
+		"P\"2!\"/\""
+	])).join("/")) : void 0;
+}
+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, true)} 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;