@shell-shock/core 0.17.8 → 0.17.11

package/dist/resolver/resolve.mjs

@@ -1,2 +1,479 @@
-import{getDynamicPathSegmentName as e,isDynamicPathSegment as t}from"../plugin-utils/context-helpers.mjs";import{extractType as n}from"../plugin-utils/deepkit.mjs";import{getGlobalOptions as r}from"../helpers/utilities.mjs";import{applyArgsDefaults as i,applyDefaults as a,applyOptionsDefaults as o,resolveVirtualCommand as s}from"./helpers.mjs";import{resolveFromBytecode as c}from"./deepkit.mjs";import{resolveFromExports as l}from"./module.mjs";import{ReflectionVisibility as u}from"@powerlines/deepkit/vendor/type";import{constantCase as d}from"@stryke/string-format/constant-case";import{titleCase as f}from"@stryke/string-format/title-case";import{isSetObject as p}from"@stryke/type-checks/is-set-object";import{esbuildPlugin as m}from"@powerlines/deepkit/esbuild-plugin";import{resolveModule as h}from"@powerlines/plugin-esbuild/helpers/resolve";function g(e,t){return e.__type=t,e}async function _(e){let{context:t,command:n,parent:i}=e,a=n.title||`${i?.title?`${i.isVirtual?i.title.replace(/(?:c|C)ommands?$/,``).trim():i.title} - `:``}${f(n.name)}${n.isVirtual?` Commands`:``}`,o={input:e,output:{alias:[],icon:i?.icon,tags:i?.tags??[],source:`file`,...n,title:a,options:i===null?r(t,n):{},args:[],parent:i??null,children:{}}};if(!n.isVirtual){if(!n.entry.input?.file||!t.fs.existsSync(n.entry.input.file))throw Error(`${n.entry.input?.file?`Non-existent`:`Missing`} command entry file for "${n.name}"`);t.debug(`Adding reflection for CLI command: ${n.id} (file: ${n.entry.input.file})`),o.module=await(h.Ω=[[`CommandModule`,`"w!`]],h(t,n.entry.input,{name:n.title||f(n.name),treeShaking:!0,resolve:{skipNodeModulesBundle:!0},plugins:[m(t,{reflection:`default`,level:`all`})]}))}return o}_.__type=[`ResolverInput`,`input`,`ResolverContext`,`initialize`,'P"w!2""w#`/$'];async function v(r){return r.output.options=o(r),r.output.args=i(r),r.output.args.forEach(g((n,i)=>{let a=r.output.args.findIndex(g(e=>e.name===n.name,[`a`,``,`P"2!"/"`]));(a!==-1&&a!==i||r.output.segments.some(g(r=>t(r)&&e(r)===n.name,[`segment`,``,`P"2!"/"`])))&&(n.name+=`_${r.output.segments.filter(g(r=>t(r)&&e(r).replace(/_\d+$/,``)===n.name,[`segment`,``,`P"2!"/"`])).length+r.output.args.filter(g(e=>e.name.replace(/_\d+$/,``)===n.name,[`a`,``,`P"2!"/"`])).length}`,n.env=n.name?n.env||n.env===!1?n.env:r.input.context.config.autoAssignEnv?d(n.name):!1:!1)},[`arg`,`index`,``,`P"2!"2""/#`])),a(r),r.input.context.env&&(p(r.output.options)&&Object.values(r.output.options).filter(g(e=>!!e.env,[`option`,``,`P"2!"/"`])).forEach(g(e=>{r.input.context.env.types.env.addProperty({name:e.env,optional:e.optional?!0:void 0,description:e.description,visibility:u.public,type:n(e),default:e.default,tags:{title:e.title,alias:e.alias.filter(g(e=>e.length>1,[`alias`,``,`P"2!"/"`])).map(g(e=>d(e),[`alias`,``,`P"2!"/"`])),domain:`cli`}})},[`option`,``,`P"2!"/"`])),r.output.args.filter(g(e=>!!e.env,[`arg`,``,`P"2!"/"`])).forEach(g(e=>r.input.context.env.types.env.addProperty({name:e.env,optional:e.optional?!0:void 0,description:e.description,visibility:u.public,type:n(e),default:e.default,tags:{alias:e.alias.filter(g(e=>e.length>1,[`alias`,``,`P"2!"/"`])).map(g(e=>d(e),[`alias`,``,`P"2!"/"`])),domain:`cli`}}),[`arg`,``,`P"2!"/"`]))),await Promise.all(r.input.context.inputs.filter(g(e=>e.segments.filter(g(e=>!t(e),[`segment`,``,`P"2!"/"`])).length===r.input.command.segments.filter(g(e=>!t(e),[`segment`,``,`P"2!"/"`])).length+1&&e.segments.slice(0,r.input.command.segments.length).every(g((e,t)=>e===r.input.command.segments[t],[`value`,`index`,``,`P"2!"2""/#`])),[`input`,``,`P"2!"/"`])).map(g(async e=>{r.output.children[e.name]=await(y.Ω=[[()=>r,`ResolverContext`,`Pi!"w"q"!j`]],y({context:r.input.context,command:e,parent:r.output}))},[`input`,``,`P"2!"/"`]))),r.output}v.__type=[`ResolverContext`,`ctx`,`CommandTree`,`postprocess`,'P"w!2""w#`/$'];async function y(e){let t=await(_.Ω=[[()=>e,`ResolverInput`,`Pi!"w"q"!j`]],_(e));return t.output.isVirtual?s(t):(await l(t),c(t)),v(t)}y.__type=[`ResolverInput`,`input`,`CommandTree`,`resolve`,`Resolves a command tree from the given resolver input.`,'P"w!2""w#`/$?%'];export{y as resolve};
+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 { toArray } from "@stryke/convert/to-array";
+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 { isBoolean } from "@stryke/type-checks/is-boolean";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
+import { isJsonSchemaObjectType, isJsonSchemaTupleType } from "@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;
+}
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+isFiniteNumber.__type = [
+	"value",
+	"isFiniteNumber",
+	"P#2!!/\""
+];
+function asRecord(value) {
+	return isSetObject(value) ? value : {};
+}
+asRecord.__type = [
+	"value",
+	() => __ΩRecord,
+	"asRecord",
+	"P#2!&#o\"#/#"
+];
+function toAliasList(value) {
+	if (Array.isArray(value)) return getUnique(value.filter(isSetString));
+	return 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 (isBoolean(first)) return "boolean";
+	}
+	if (isFiniteNumber(input.default)) return "number";
+	if (isBoolean(input.default)) return "boolean";
+	return "string";
+}
+inferParameterType.__type = [
+	() => __ΩRecord,
+	"input",
+	"CommandOption",
+	"type",
+	"inferParameterType",
+	"P&#o!#2\"\"w#.$f/%"
+];
+function inferVariadic(input) {
+	if (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(isBoolean);
+			return isBoolean(defaultValue) ? [defaultValue] : void 0;
+		}
+		if (Array.isArray(defaultValue)) return defaultValue.find(isBoolean);
+		return 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(isSetString);
+		return isSetString(defaultValue) ? [defaultValue] : void 0;
+	}
+	if (Array.isArray(defaultValue)) return defaultValue.find(isSetString);
+	return 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(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 = isBoolean(input.required) ? input.required : defaultValue === void 0 ? defaults.fallbackRequired : false;
+	const env = isSetString(input.env) ? input.env : false;
+	const result = {
+		name: isSetString(input.name) ? input.name : "",
+		type,
+		title: isSetString(input.title) ? input.title : "",
+		description: 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 (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 (isSetString(input.isNegativeOf)) optionResult.isNegativeOf = input.isNegativeOf;
+		if (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.virtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${titleCase(command.name)}${command.virtual ? " Commands" : ""}`;
+	const result = {
+		input,
+		output: {
+			alias: [],
+			icon: parent?.icon,
+			tags: parent?.tags ?? [],
+			source: "file",
+			...command,
+			title,
+			options: parent === null ? getGlobalOptions(context, command) : {},
+			args: [],
+			parent: parent ?? null,
+			children: {}
+		}
+	};
+	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 (resolveModule.Ω = [["CommandModule", "\"w!"]], resolveModule(context, command.entry.input, {
+			name: command.title || titleCase(command.name),
+			plugins: [esbuildPlugin(context, {
+				reflection: "default",
+				level: "all"
+			})],
+			resolve: { skipNodeModulesBundle: true }
+		}));
+	}
+	return result;
+}
+preprocess.__type = [
+	"ResolverInput",
+	"input",
+	"ResolverContext",
+	"preprocess",
+	"P\"w!2\"\"w#`/$"
+];
+async function postprocess(ctx) {
+	ctx.output.options = applyOptionsDefaults(ctx);
+	ctx.output.args = applyArgsDefaults(ctx);
+	ctx.output.args.forEach(__assignType((arg, index) => {
+		const found = ctx.output.args.findIndex(__assignType((a) => a.name === arg.name, [
+			"a",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (found !== -1 && found !== index || ctx.output.segments.some(__assignType((segment) => isDynamicPathSegment(segment) && getDynamicPathSegmentName(segment) === arg.name, [
+			"segment",
+			"",
+			"P\"2!\"/\""
+		]))) {
+			arg.name += `_${ctx.output.segments.filter(__assignType((segment) => isDynamicPathSegment(segment) && getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === arg.name, [
+				"segment",
+				"",
+				"P\"2!\"/\""
+			])).length + ctx.output.args.filter(__assignType((a) => a.name.replace(/_\d+$/, "") === arg.name, [
+				"a",
+				"",
+				"P\"2!\"/\""
+			])).length}`;
+			arg.env = arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? constantCase(arg.name) : false : false;
+		}
+	}, [
+		"arg",
+		"index",
+		"",
+		"P\"2!\"2\"\"/#"
+	]));
+	applyDefaults(ctx);
+	if (ctx.input.context.env) {
+		if (isSetObject(ctx.output.options)) Object.values(ctx.output.options).filter(__assignType((option) => Boolean(option.env), [
+			"option",
+			"",
+			"P\"2!\"/\""
+		])).forEach(__assignType((option) => {
+			addProperty(ctx.input.context.env.config.schema, option.env, {
+				...option,
+				name: option.env,
+				alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+					"alias",
+					"",
+					"P\"2!\"/\""
+				])).map(__assignType((alias) => constantCase(alias), [
+					"alias",
+					"",
+					"P\"2!\"/\""
+				]))
+			});
+		}, [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]));
+		ctx.output.args.filter(__assignType((arg) => Boolean(arg.env), [
+			"arg",
+			"",
+			"P\"2!\"/\""
+		])).forEach(__assignType((arg) => addProperty(ctx.input.context.env.config.schema, arg.env, {
+			...arg,
+			name: arg.env,
+			alias: arg.alias.filter(__assignType((alias) => alias.length > 1, [
+				"alias",
+				"",
+				"P\"2!\"/\""
+			])).map(__assignType((alias) => constantCase(alias), [
+				"alias",
+				"",
+				"P\"2!\"/\""
+			]))
+		}), [
+			"arg",
+			"",
+			"P\"2!\"/\""
+		]));
+	}
+	await Promise.all(ctx.input.context.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+		"segment",
+		"",
+		"P\"2!\"/\""
+	])).length === ctx.input.command.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+		"segment",
+		"",
+		"P\"2!\"/\""
+	])).length + 1 && input.segments.slice(0, ctx.input.command.segments.length).every(__assignType((value, index) => value === ctx.input.command.segments[index], [
+		"value",
+		"index",
+		"",
+		"P\"2!\"2\"\"/#"
+	])), [
+		"input",
+		"",
+		"P\"2!\"/\""
+	])).map(__assignType(async (input) => {
+		ctx.output.children[input.name] = await (resolve.Ω = [[
+			() => ctx,
+			"ResolverContext",
+			"Pi!\"w\"q\"!j"
+		]], resolve({
+			context: ctx.input.context,
+			command: input,
+			parent: ctx.output
+		}));
+	}, [
+		"input",
+		"",
+		"P\"2!\"/\""
+	])));
+	return ctx.output;
+}
+postprocess.__type = [
+	"ResolverContext",
+	"ctx",
+	"CommandTree",
+	"postprocess",
+	"P\"w!2\"\"w#`/$"
+];
+/**
+* Resolves a command tree from the given resolver input.
+*
+* @param input - The resolver input containing the context, command, and optional parent command tree.
+* @returns A promise that resolves to the resolved command tree.
+*/
+async function resolve(input) {
+	const ctx = await (preprocess.Ω = [[
+		() => input,
+		"ResolverInput",
+		"Pi!\"w\"q\"!j"
+	]], 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 (!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 (isSetString(metadata.title)) ctx.output.title = metadata.title;
+		if (isSetString(metadata.description)) ctx.output.description = metadata.description;
+		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)) {
+			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);
+				return ret;
+			}, [
+				"ret",
+				"property",
+				"",
+				"P\"2!\"2\"\"/#"
+			]), {});
+		}
+		if (ctx.module.args && Array.isArray(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",
+				"",
+				"P\"2!\"/\""
+			]));
+		}
+	} else resolveVirtualCommand(ctx);
+	return postprocess(ctx);
+}
+resolve.__type = [
+	"ResolverInput",
+	"input",
+	"CommandTree",
+	"resolve",
+	"Resolves a command tree from the given resolver input.",
+	"P\"w!2\"\"w#`/$?%"
+];
+
+//#endregion
+export { resolve };
 //# sourceMappingURL=resolve.mjs.map

package/dist/resolver/resolve.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.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 { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    tags: parent?.tags ?? [],\n    source: \"file\",\n    ...command,\n    title,\n    options: parent === null ? getGlobalOptions(context, command) : {},\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for CLI command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        name: command.title || titleCase(command.name),\n        treeShaking: true,\n        resolve: {\n          skipNodeModulesBundle: true\n        },\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            level: \"all\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"q1BAAA,SAAS,EAAa,EAAI,EAAM,CAE9B,kBAAO,EA+BT,eAAE,EAAiB,EAAA,CACjB,GAAA,CACA,UACA,UACA,UACI,EACC,EAAO,EAAA,OAAiB,GAAA,GAAa,MAAQ,GAAG,EAAM,UAAA,EAAA,MAAA,QAAA,mBAAA,GAAA,CAAA,MAAA,CAAA,EAAA,MAAA,KAAA,KAAA,EAAA,EAAA,KAAA,GAAA,EAAA,UAAA,YAAA,KAarD,EAAQ,CACZ,QACA,OAAA,CAbJ,MAAM,EAAA,CACJ,KAAO,GAAA,KACN,KAAO,GAAC,MAAe,EAAE,CAC1B,OAAQ,YAER,QACE,QAAQ,IAAO,KAAA,EAAA,EAAA,EAAA,CAAA,EAAA,CACf,KAAE,EAAA,CACF,OAAQ,GAAE,KACV,SAAQ,EAAA,CAIF,CACP,CACD,GAAI,CAAC,EAAA,UAAkB,+DAEvB,MAAc,MAAC,GAAA,EAAA,MAAA,OAAA,KAAA,eAAA,UAAA,2BAAA,EAAA,KAAA,GAAA,CAEb,EAAM,MAAQ,sCAAI,EAAA,GAAA,UAAA,EAAA,MAAA,MAAA,KAAA,GAAA,CAClB,EAAM,OAAQ,MAAS,EAAC,EAAA,CAAA,CAAA,gBAAA,MAAA,CAAA,CAAA,EAAA,EAAA,EAAA,MAAA,MAAA,CACxB,KAAQ,EAAM,OAAA,EAAA,EAAA,KAAA,CACZ,YAAQ,GACV,QAAK,CACL,sBAA2B,GAC3B,CACA,QAAQ,CAAA,EAAc,EAAA,CACtB,WAAW,UACR,MAAA,SAEL,CAAA,EAEA,OAAE,mFAGJ,eAAe,EAAW,EAAA,CAkDxB,MAjDA,GAAI,OAAC,QAAA,EAAA,EAAA,CACL,EAAI,OAAC,KAAa,EAAc,EAAA,CAEhC,EAAI,OAAA,KAAA,QAAA,GAAA,EAAA,IAAA,CACF,IAAE,EAAU,EAAK,OAAA,KAAA,UAAA,EAAA,GAAA,EAAA,OAAA,EAAA,KAAA,CAAA,IAAA,GAAA,UAAA,CAAA,CAAA,EACb,IAAE,IAAA,IAAA,GAAA,EAAA,OAAA,SAAA,KAAA,EAAA,GAAA,EAAA,EAAA,EAAA,EAAA,EAAA,GAAA,EAAA,KAAA,CAAA,UAAA,GAAA,UAAA,CAAA,CAAA,IACJ,EAAI,MAAQ,IAAC,EAAM,OAAO,SAAQ,OAAS,EAAO,GAAQ,EAAA,EAAA,EAAA,EAAA,EAAA,CAAA,QAAA,QAAA,GAAA,GAAA,EAAA,KAAA,CAAA,UAAA,GAAA,UAAA,CAAA,CAAA,CAAA,OAAA,EAAA,OAAA,KAAA,OAAA,EAAA,GAAA,EAAA,KAAA,QAAA,QAAA,GAAA,GAAA,EAAA,KAAA,CAAA,IAAA,GAAA,UAAA,CAAA,CAAA,CAAA,SAC1D,EAAI,IAAA,EAAQ,KAAM,EAAK,KAAO,EAAA,MAAc,GAAA,EAAA,IAAA,EAAA,MAAA,QAAA,OAAA,cAAA,EAAA,EAAA,KAAA,CAAA,GAAA,KAE9C,CAAA,MAAA,QAAA,GAAA,aAAA,CAAA,CAAA,MAEA,EAAA,MAAQ,QAAK,MACV,EAAO,EAAU,OAAK,QAAI,EAC3B,OAAE,OAAQ,EAAM,OAAM,QAAA,CAAA,OAAA,EAAA,GAAA,EAAA,EAAA,IAAA,CAAA,SAAA,GAAA,UAAA,CAAA,CAAA,CAAA,QAAA,EAAA,GAAA,CACpB,EAAA,MAAA,QAAA,IAAA,MAAA,IAAA,YAAA,CACH,KAAA,EAAA,kCAEK,YAAU,EAAM,YACpB,WAAO,EAAA,OACP,KAAQ,EAAW,EAAA,CACnB,QAAA,EAAA,QACE,KAAM,CACN,MAAW,EAAM,MACjB,MAAS,EAAA,MAAA,OAAA,EAAA,GAAA,EAAA,OAAA,EAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,CAAA,IAAA,EAAA,GAAA,EAAA,EAAA,CAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,CACP,OAAA,MACD,CACD,CAAA,EACC,CAAC,SAAA,GAAc,UAAS,CAAA,CAAA,CAE7B,EAAI,OAAI,KAAQ,OAAG,EAAA,GAAA,EAAA,EAAA,IAAA,CAAA,MAAA,GAAA,UAAA,CAAA,CAAA,CAAA,QAAA,EAAA,GAAA,EAAA,MAAA,QAAA,IAAA,MAAA,IAAA,YAAA,CACjB,KAAK,EAAA,IACL,SAAE,EAAA,SAAA,GAAA,IAAA,GACF,YAAA,EAAA,YACD,WAAA,EAAA,OACH,KAAA,EAAA,EAAA,mBAEA,KAAO,CACT,MAAA,EAAA,MAAA,OAAA,EAAA,GAAA,EAAA,OAAA,EAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,CAAA,IAAA,EAAA,GAAA,EAAA,EAAA,CAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,cAEM,CACD,CAAC,CAAC,CAAA,MAAA,GAAA,UAAgB,CAAQ,CAAA,EAE7B,MAAI,QAAO,IAAO,EAAG,MAAA,QAAA,OAAqB,OAAI,EAAA,GAAA,EAAA,SAAA,OAAA,EAAA,GAAA,CAAA,EAAA,EAAA,CAAA,CAAA,UAAA,GAAA,UAAA,CAAA,CAAA,CAAA,SAAA,EAAA,MAAA,QAAA,SAAA,OAAA,EAAA,GAAA,CAAA,EAAA,EAAA,CAAA,CAAA,UAAA,GAAA,UAAA,CAAA,CAAA,CAAA,OAAA,GAAA,EAAA,SAAA,MAAA,EAAA,EAAA,MAAA,QAAA,SAAA,OAAA,CAAA,MAAA,GAAA,EAAA,IAAA,IAAA,EAAA,MAAA,QAAA,SAAA,GAAA,CAAA,QAAA,QAAA,GAAA,aAAA,CAAA,CAAA,CAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,CAAA,IAAA,EAAA,KAAA,IAAA,CAC9C,EAAI,OAAO,SAAO,EAAA,MAAkB,MAAI,EAAA,EAAA,CAAA,KAAA,EAAA,kBAAA,aAAA,CAAA,CAAA,EAAA,yBAErC,QAAO,EACN,OAAO,EAAK,OACd,CAAA,GACA,CAAE,QAAC,GAAA,UAAA,CAAA,CAAA,CAAA,CACA,EAAM,OAEb,EAAQ,OAAS,CAAA,kBAAA,MAAA,cAAA,cAAA,eAAA,CAOjB,eAAmB,EAAA,EAAA,CACjB,IAAM,EAAI,MAAA,EAAoB,EAAC,CAAA,KAAU,EAAA,gBAAA,aAAA,CAAA,CAAA,EAAA,EAAA,EAOzC,OANK,EAAI,OAAC,UAIR,EAAI,EAAA,EAHJ,MAAM,EAAO,EAAA,CACb,EAAoB,EAAA,EAIf,EAAY,EAAI,CAEzB,EAAQ,OAAQ,CAAA,gBAAc,QAAO,cAAA,UAAA,yDAAA,iBAAA"}
+{"version":3,"file":"resolve.mjs","names":[],"sources":[],"mappings":""}