@shell-shock/core 0.17.21 → 0.17.23

package/dist/resolver/deepkit.mjs

@@ -1,109 +0,0 @@
-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

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

package/dist/resolver/helpers.cjs

@@ -1,184 +0,0 @@
-const require_context_helpers = require('../plugin-utils/context-helpers.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 type - The reflection kind of the command option.
-* @param required - Whether the command option is required.
-* @param variadic - Whether the command option is variadic (i.e., an array).
-* @param title - The title of the command option, if any.
-* @param defaultValue - The default value of the command option, if any.
-* @returns The resolved description for the command option.
-*/
-function resolveCommandOptionDescription(name, type, required = true, variadic = false, title, defaultValue) {
-	return `A${!required && !defaultValue ? "n optional" : ""} command-line ${type === "boolean" ? "flag" : "option"} that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, _stryke_string_format_title_case.titleCase)(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
-}
-resolveCommandOptionDescription.__type = [
-	"name",
-	"string",
-	"number",
-	"boolean",
-	"type",
-	"required",
-	"variadic",
-	"title",
-	"defaultValue",
-	"resolveCommandOptionDescription",
-	"Resolves the description for a command option based on its reflection.",
-	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
-];
-/**
-* Resolves the description for a command argument based on its reflection.
-*
-* @param name - The name of the command argument.
-* @param type - The reflection kind of the command argument.
-* @param required - Whether the command argument is required.
-* @param variadic - Whether the command argument is variadic (i.e., an array).
-* @param title - The title of the command argument, if any.
-* @param defaultValue - The default value of the command argument, if any.
-* @returns The resolved description for the command argument.
-*/
-function resolveCommandArgumentDescription(name, type, required = true, variadic = false, title, defaultValue) {
-	return `An${!required && !defaultValue ? " optional" : ""} argument that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, _stryke_string_format_title_case.titleCase)(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
-}
-resolveCommandArgumentDescription.__type = [
-	"name",
-	"string",
-	"number",
-	"boolean",
-	"type",
-	"required",
-	"variadic",
-	"title",
-	"defaultValue",
-	"resolveCommandArgumentDescription",
-	"Resolves the description for a command argument based on its reflection.",
-	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
-];
-function applyOptionsDefaults(ctx) {
-	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
-		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.type, option.required, option.type !== "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.type, arg.required, arg.type !== "boolean" && arg.variadic, title, arg.default),
-			env: arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? (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 (ctx.input.command.segments.length && (0, _stryke_type_checks_is_set_string.isSetString)(ctx.input.context.config.docs?.commands) && /\{(?:(?:C|c)ommands?|(?:C|c)mds?)\}/.test(ctx.input.context.config.docs.commands)) ctx.output.docs ??= ctx.input.context.config.docs.commands ? ctx.input.context.config.docs.commands.replace(/\{(?:(?:C|c)ommands?|(?:C|c)mds?)\}/, ctx.input.command.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment), [
-		"segment",
-		"",
-		"P\"2!\"/\""
-	])).join("/")) : void 0;
-	else if (!ctx.input.command.segments.length && (0, _stryke_type_checks_is_set_string.isSetString)(ctx.input.context.config.docs?.app)) ctx.output.docs ??= ctx.input.context.config.docs.app;
-}
-applyDefaults.__type = [
-	"ResolverContext",
-	"ctx",
-	"applyDefaults",
-	"P\"w!2\"\"/#"
-];
-/**
-* Resolves a virtual command by applying default values to its title and description based on the command name and application title.
-*
-* @template TContext - The type of the context object.
-* @param ctx - The resolver context containing the input and output for the command resolution process.
-*/
-function resolveVirtualCommand(ctx) {
-	ctx.output.title ??= (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",
-	"Resolves a virtual command by applying default values to its title and description based on the command name and application title.",
-	"P\"w!2\"\"/#?$"
-];
-/**
-* Merges two command parameters, giving precedence to string values in the second configuration.
-*
-* @param objA - The first command parameter object.
-* @param objB - The second command parameter object.
-* @returns The merged command parameter object.
-*/
-const mergeCommandParameter = (0, defu.createDefu)(__assignType((obj, key, value) => {
-	if ((0, _stryke_type_checks_is_string.isString)(obj[key]) && (0, _stryke_type_checks_is_string.isString)(value)) {
-		if ((0, _stryke_type_checks_is_set_string.isSetString)(value)) obj[key] = value;
-		return true;
-	} else if (Array.isArray(obj[key]) && Array.isArray(value)) {
-		if (value.length > 0) obj[key] = (0, _stryke_helpers_get_unique.getUniqueBy)(obj[key].concat(value), __assignType((item) => (0, _stryke_type_checks_is_string.isString)(item) ? item : JSON.stringify(item), [
-			"item",
-			"",
-			"P\"2!\"/\""
-		]));
-		return true;
-	}
-	return false;
-}, [
-	"obj",
-	"key",
-	"value",
-	"",
-	"P\"2!\"2\"\"2#\"/$"
-]));
-
-//#endregion
-exports.applyArgsDefaults = applyArgsDefaults;
-exports.applyDefaults = applyDefaults;
-exports.applyOptionsDefaults = applyOptionsDefaults;
-exports.mergeCommandParameter = mergeCommandParameter;
-exports.resolveVirtualCommand = resolveVirtualCommand;
-//# sourceMappingURL=helpers.cjs.map

package/dist/resolver/helpers.cjs.map

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

package/dist/resolver/helpers.mjs

@@ -1,180 +0,0 @@
-import { getAppTitle, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
-import { constantCase } from "@stryke/string-format/constant-case";
-import { isSetString } from "@stryke/type-checks/is-set-string";
-import { createDefu } from "defu";
-import { titleCase } from "@stryke/string-format/title-case";
-import { getUniqueBy } from "@stryke/helpers/get-unique";
-import { isString } from "@stryke/type-checks/is-string";
-
-//#region src/resolver/helpers.ts
-function __assignType(fn, args) {
-	fn.__type = args;
-	return fn;
-}
-/**
-* Resolves the description for a command option based on its reflection.
-*
-* @param name - The name of the command option.
-* @param type - The reflection kind of the command option.
-* @param required - Whether the command option is required.
-* @param variadic - Whether the command option is variadic (i.e., an array).
-* @param title - The title of the command option, if any.
-* @param defaultValue - The default value of the command option, if any.
-* @returns The resolved description for the command option.
-*/
-function resolveCommandOptionDescription(name, type, required = true, variadic = false, title, defaultValue) {
-	return `A${!required && !defaultValue ? "n optional" : ""} command-line ${type === "boolean" ? "flag" : "option"} that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
-}
-resolveCommandOptionDescription.__type = [
-	"name",
-	"string",
-	"number",
-	"boolean",
-	"type",
-	"required",
-	"variadic",
-	"title",
-	"defaultValue",
-	"resolveCommandOptionDescription",
-	"Resolves the description for a command option based on its reflection.",
-	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
-];
-/**
-* Resolves the description for a command argument based on its reflection.
-*
-* @param name - The name of the command argument.
-* @param type - The reflection kind of the command argument.
-* @param required - Whether the command argument is required.
-* @param variadic - Whether the command argument is variadic (i.e., an array).
-* @param title - The title of the command argument, if any.
-* @param defaultValue - The default value of the command argument, if any.
-* @returns The resolved description for the command argument.
-*/
-function resolveCommandArgumentDescription(name, type, required = true, variadic = false, title, defaultValue) {
-	return `An${!required && !defaultValue ? " optional" : ""} argument that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || titleCase(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
-}
-resolveCommandArgumentDescription.__type = [
-	"name",
-	"string",
-	"number",
-	"boolean",
-	"type",
-	"required",
-	"variadic",
-	"title",
-	"defaultValue",
-	"resolveCommandArgumentDescription",
-	"Resolves the description for a command argument based on its reflection.",
-	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
-];
-function applyOptionsDefaults(ctx) {
-	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
-		const name = option.name || key;
-		const title = option.title || titleCase(name);
-		return [key, {
-			...option,
-			name,
-			title,
-			description: option.description || resolveCommandOptionDescription(name, option.type, option.required, option.type !== "boolean" && option.variadic, title, option.default),
-			env: option.env || option.env === false ? option.env : ctx.input.context.config.autoAssignEnv ? constantCase(name) : false
-		}];
-	}, [
-		"param0",
-		"",
-		"P\"2!\"/\""
-	])));
-}
-applyOptionsDefaults.__type = [
-	"ResolverContext",
-	"ctx",
-	"applyOptionsDefaults",
-	"P\"w!2\"\"/#"
-];
-function applyArgsDefaults(ctx) {
-	return ctx.output.args.map(__assignType((arg, i) => {
-		const name = arg.name || `arg${i + 1}`;
-		const title = arg.title || titleCase(name);
-		return {
-			...arg,
-			name,
-			title,
-			description: arg.description || resolveCommandArgumentDescription(name, arg.type, arg.required, arg.type !== "boolean" && arg.variadic, title, arg.default),
-			env: arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? constantCase(name) : false : false
-		};
-	}, [
-		"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 (ctx.input.command.segments.length && isSetString(ctx.input.context.config.docs?.commands) && /\{(?:(?:C|c)ommands?|(?:C|c)mds?)\}/.test(ctx.input.context.config.docs.commands)) ctx.output.docs ??= ctx.input.context.config.docs.commands ? ctx.input.context.config.docs.commands.replace(/\{(?:(?:C|c)ommands?|(?:C|c)mds?)\}/, ctx.input.command.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
-		"segment",
-		"",
-		"P\"2!\"/\""
-	])).join("/")) : void 0;
-	else if (!ctx.input.command.segments.length && isSetString(ctx.input.context.config.docs?.app)) ctx.output.docs ??= ctx.input.context.config.docs.app;
-}
-applyDefaults.__type = [
-	"ResolverContext",
-	"ctx",
-	"applyDefaults",
-	"P\"w!2\"\"/#"
-];
-/**
-* Resolves a virtual command by applying default values to its title and description based on the command name and application title.
-*
-* @template TContext - The type of the context object.
-* @param ctx - The resolver context containing the input and output for the command resolution process.
-*/
-function resolveVirtualCommand(ctx) {
-	ctx.output.title ??= titleCase(ctx.input.command.name);
-	ctx.output.description ??= `A collection of available ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim() || titleCase(ctx.input.command.name)} commands that are included in the ${getAppTitle(ctx.input.context, true)} command-line application.`;
-}
-resolveVirtualCommand.__type = [
-	"ResolverContext",
-	"ctx",
-	"resolveVirtualCommand",
-	"Resolves a virtual command by applying default values to its title and description based on the command name and application title.",
-	"P\"w!2\"\"/#?$"
-];
-/**
-* Merges two command parameters, giving precedence to string values in the second configuration.
-*
-* @param objA - The first command parameter object.
-* @param objB - The second command parameter object.
-* @returns The merged command parameter object.
-*/
-const mergeCommandParameter = createDefu(__assignType((obj, key, value) => {
-	if (isString(obj[key]) && isString(value)) {
-		if (isSetString(value)) obj[key] = value;
-		return true;
-	} else if (Array.isArray(obj[key]) && Array.isArray(value)) {
-		if (value.length > 0) obj[key] = getUniqueBy(obj[key].concat(value), __assignType((item) => isString(item) ? item : JSON.stringify(item), [
-			"item",
-			"",
-			"P\"2!\"/\""
-		]));
-		return true;
-	}
-	return false;
-}, [
-	"obj",
-	"key",
-	"value",
-	"",
-	"P\"2!\"2\"\"2#\"/$"
-]));
-
-//#endregion
-export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, mergeCommandParameter, resolveVirtualCommand };
-//# sourceMappingURL=helpers.mjs.map

package/dist/resolver/helpers.mjs.map

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