@shell-shock/core 0.17.22 → 0.17.23

package/dist/plugin-utils/index.cjs

@@ -1,39 +1,372 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_context_helpers = require('./context-helpers.cjs');
-const require_reflect = require('./reflect.cjs');
-const require_compute_bin = require('./compute-bin.cjs');
-const require_type_checks = require('./type-checks.cjs');
-const require_deepkit = require('./deepkit.cjs');
-const require_description_helpers = require('./description-helpers.cjs');
-const require_traverse_command_tree = require('./traverse-command-tree.cjs');
-const require_get_command_tree = require('./get-command-tree.cjs');
+const require_context_helpers = require('../context-helpers-_wUuFRB8.cjs');
+const require_reflect = require('../reflect-CSiffeL9.cjs');
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let _deepkit_type = require("@deepkit/type");
+let _stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
 
-exports.__ΩFormatDescriptionOptions = require_description_helpers.__ΩFormatDescriptionOptions;
-exports.__ΩFormatShortDescriptionOptions = require_description_helpers.__ΩFormatShortDescriptionOptions;
-exports.computeBin = require_compute_bin.computeBin;
-exports.extractReflectionKind = require_deepkit.extractReflectionKind;
-exports.extractType = require_deepkit.extractType;
-exports.formatDescription = require_description_helpers.formatDescription;
-exports.formatShortDescription = require_description_helpers.formatShortDescription;
+//#region src/plugin-utils/compute-bin.ts
+/**
+* Computes the command tree for the root binary command based on the provided context.
+*
+* @param context - The plugin context containing the necessary information to compute the command tree.
+* @returns The computed command tree for the root binary command.
+*/
+function computeBin(context) {
+	return {
+		id: "",
+		name: require_context_helpers.getAppName(context),
+		title: require_context_helpers.getAppTitle(context),
+		description: require_context_helpers.getAppDescription(context),
+		virtual: true,
+		path: null,
+		segments: [],
+		alias: [],
+		tags: [],
+		options: Object.fromEntries(context.globalOptions.map((option) => [option.name, option])),
+		args: [],
+		entry: { file: (0, _stryke_path_join_paths.joinPaths)(context.entryPath, "bin.ts") },
+		parent: null,
+		children: context.commands,
+		docs: context.config.docs?.app
+	};
+}
+
+//#endregion
+//#region src/plugin-utils/type-checks.ts
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => (0, _stryke_type_checks_is_set_string.isSetString)(item));
+}
+function isNumberArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "number" && Number.isFinite(item));
+}
+function isBooleanArray(value) {
+	return Array.isArray(value) && value.every((item) => (0, _stryke_type_checks_is_boolean.isBoolean)(item));
+}
+function isAliasConfig(value) {
+	return (0, _stryke_type_checks_is_set_string.isSetString)(value) || isStringArray(value);
+}
+function isTypedDefaultValue(type, value, variadic) {
+	if (type === "string") {
+		if (variadic === true) return isStringArray(value);
+		if (variadic === false) return (0, _stryke_type_checks_is_set_string.isSetString)(value);
+		return (0, _stryke_type_checks_is_set_string.isSetString)(value) || isStringArray(value);
+	}
+	if (type === "number") {
+		if (variadic === true) return isNumberArray(value);
+		if (variadic === false) return typeof value === "number" && Number.isFinite(value);
+		return typeof value === "number" && Number.isFinite(value) || isNumberArray(value);
+	}
+	if (variadic === true) return isBooleanArray(value);
+	if (variadic === false) return (0, _stryke_type_checks_is_boolean.isBoolean)(value);
+	return (0, _stryke_type_checks_is_boolean.isBoolean)(value) || isBooleanArray(value);
+}
+function hasValidOptionalCommonFields(obj) {
+	if ("alias" in obj && obj.alias !== void 0 && !isAliasConfig(obj.alias)) return false;
+	if ("name" in obj && obj.name !== void 0 && !(0, _stryke_type_checks_is_set_string.isSetString)(obj.name)) return false;
+	if ("title" in obj && obj.title !== void 0 && !(0, _stryke_type_checks_is_set_string.isSetString)(obj.title)) return false;
+	if ("description" in obj && obj.description !== void 0 && !(0, _stryke_type_checks_is_set_string.isSetString)(obj.description)) return false;
+	if ("env" in obj && obj.env !== void 0 && !((0, _stryke_type_checks_is_set_string.isSetString)(obj.env) || obj.env === false)) return false;
+	if ("required" in obj && obj.required !== void 0 && !(0, _stryke_type_checks_is_boolean.isBoolean)(obj.required)) return false;
+	if ("variadic" in obj && obj.variadic !== void 0 && !(0, _stryke_type_checks_is_boolean.isBoolean)(obj.variadic)) return false;
+	return true;
+}
+function hasValidTypeSpecificFields(obj, type) {
+	const variadic = (0, _stryke_type_checks_is_boolean.isBoolean)(obj.variadic) ? obj.variadic : void 0;
+	if ("default" in obj && obj.default !== void 0 && !isTypedDefaultValue(type, obj.default, variadic)) return false;
+	if (type === "string") {
+		if ("format" in obj && obj.format !== void 0 && !(0, _stryke_type_checks_is_set_string.isSetString)(obj.format)) return false;
+		if ("choices" in obj && obj.choices !== void 0 && !isStringArray(obj.choices)) return false;
+		return true;
+	}
+	if (type === "number") {
+		if ("choices" in obj && obj.choices !== void 0 && !isNumberArray(obj.choices)) return false;
+		return true;
+	}
+	if ("choices" in obj && obj.choices !== void 0) return false;
+	if ("format" in obj && obj.format !== void 0) return false;
+	return true;
+}
+/**
+* Type guard to check if a value is a valid {@link CommandParameterType} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandParameterType} type, false otherwise.
+*/
+function isCommandParameterType(obj) {
+	return (0, _stryke_type_checks_is_set_string.isSetString)(obj) && [
+		"string",
+		"number",
+		"boolean"
+	].includes(obj);
+}
+/**
+* Type guard to check if a value is a valid {@link CommandParameterConfig} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.
+*/
+function isCommandParameterConfig(obj) {
+	if (!(0, _stryke_type_checks_is_set_object.isSetObject)(obj) || !("type" in obj) || !isCommandParameterType(obj.type)) return false;
+	return hasValidOptionalCommonFields(obj) && hasValidTypeSpecificFields(obj, obj.type);
+}
+/**
+* Type guard to check if a value is a valid {@link CommandParameter} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandParameter} type, false otherwise.
+*/
+function isCommandParameter(obj) {
+	if (!isCommandParameterConfig(obj)) return false;
+	if (!("name" in obj) || !(0, _stryke_type_checks_is_set_string.isSetString)(obj.name)) return false;
+	if (!("title" in obj) || !(0, _stryke_type_checks_is_set_string.isSetString)(obj.title)) return false;
+	if (!("description" in obj) || !(0, _stryke_type_checks_is_set_string.isSetString)(obj.description)) return false;
+	if (!("alias" in obj) || !isStringArray(obj.alias)) return false;
+	if (!("env" in obj) || !((0, _stryke_type_checks_is_set_string.isSetString)(obj.env) || obj.env === false)) return false;
+	if (!("required" in obj) || !(0, _stryke_type_checks_is_boolean.isBoolean)(obj.required)) return false;
+	if (!("variadic" in obj) || !(0, _stryke_type_checks_is_boolean.isBoolean)(obj.variadic)) return false;
+	return hasValidTypeSpecificFields(obj, obj.type);
+}
+/**
+* Type guard to check if a value is a valid {@link CommandOption} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandOption} type, false otherwise.
+*/
+function isCommandOption(obj) {
+	if (!isCommandParameter(obj)) return false;
+	if (obj.type !== "boolean") return true;
+	if ("isNegativeOf" in obj && obj.isNegativeOf !== void 0 && !(0, _stryke_type_checks_is_set_string.isSetString)(obj.isNegativeOf)) return false;
+	if ("skipAddingNegative" in obj && obj.skipAddingNegative !== void 0 && !(0, _stryke_type_checks_is_boolean.isBoolean)(obj.skipAddingNegative)) return false;
+	return true;
+}
+/**
+* Type guard to check if a value is a valid {@link CommandArgument} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandArgument} type, false otherwise.
+*/
+function isCommandArgument(obj) {
+	return isCommandParameter(obj);
+}
+
+//#endregion
+//#region src/plugin-utils/deepkit.ts
+/**
+* Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
+*
+* @param command - The command parameter or kind to extract the reflection kind from.
+* @param checkVariadic - Whether to check for variadic parameters (arrays).
+* @returns The extracted {@link ReflectionKind}.
+*/
+function extractReflectionKind(command, checkVariadic = true) {
+	if (isCommandParameterType(command) && command === "string" || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.type === "string") return checkVariadic && command.variadic ? _deepkit_type.ReflectionKind.array : _deepkit_type.ReflectionKind.string;
+	else if (isCommandParameterType(command) && command === "number" || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.type === "number") return checkVariadic && command.variadic ? _deepkit_type.ReflectionKind.array : _deepkit_type.ReflectionKind.number;
+	else if (isCommandParameterType(command) && command === "boolean" || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.type === "boolean") return _deepkit_type.ReflectionKind.boolean;
+	else return _deepkit_type.ReflectionKind.string;
+}
+/**
+* Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
+*
+* @param command - The command parameter or kind to extract the type from.
+* @param checkVariadic - Whether to check for variadic parameters (arrays).
+* @returns The extracted {@link Type}.
+*/
+function extractType(command, checkVariadic = true) {
+	const reflectionKind = extractReflectionKind(command, checkVariadic);
+	if (reflectionKind === _deepkit_type.ReflectionKind.string) return { kind: _deepkit_type.ReflectionKind.string };
+	else if (reflectionKind === _deepkit_type.ReflectionKind.number) return { kind: _deepkit_type.ReflectionKind.number };
+	else if (reflectionKind === _deepkit_type.ReflectionKind.boolean) return { kind: _deepkit_type.ReflectionKind.boolean };
+	else if (reflectionKind === _deepkit_type.ReflectionKind.array) {
+		if (isCommandParameterType(command)) return {
+			kind: _deepkit_type.ReflectionKind.array,
+			type: extractType({ type: command }, false)
+		};
+		else if ((0, _stryke_type_checks_is_set_object.isSetObject)(command)) return {
+			kind: _deepkit_type.ReflectionKind.array,
+			type: extractType({
+				...command,
+				type: command.type
+			}, false)
+		};
+		else return {
+			kind: _deepkit_type.ReflectionKind.array,
+			type: { kind: _deepkit_type.ReflectionKind.string }
+		};
+	} else return { kind: _deepkit_type.ReflectionKind.string };
+}
+
+//#endregion
+//#region src/plugin-utils/description-helpers.ts
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescriptionWhitespace(description, options = {}) {
+	let formattedDescription = description.trim();
+	if (options.replaceNewlines) formattedDescription = formattedDescription.replace(/\s*\n\s*/g, " ");
+	if (options.collapseWhitespace) formattedDescription = formattedDescription.replace(/\s{2,}/g, " ");
+	return formattedDescription.trim();
+}
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescriptionEscapes(description) {
+	return description.replaceAll("'", "\\'").replaceAll("\"", "\\\"").replaceAll("`", "\\`").replace(/\$\{/g, "\\${");
+}
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescription(description, options = {}) {
+	return formatDescriptionEscapes(formatDescriptionWhitespace(description, options));
+}
+/**
+* Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
+*
+* @param description - The full description string.
+* @param options - Options for formatting the short description, including the maximum length.
+* @returns The extracted short description.
+*/
+function formatShortDescription(description, options = {}) {
+	const length = options.length ?? 62;
+	const formattedDescription = formatDescriptionWhitespace(description, options);
+	let result = ((formattedDescription.indexOf("\n") < length - 3 || formattedDescription.search(/[.!?\n]\s*\S/) > length - 3 ? formattedDescription.match(/^.*[.!?\n]\s?\S/)?.[0]?.trim()?.slice(0, -1)?.trim() : void 0) || formattedDescription).trim();
+	if (result.trim().length > length) result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;
+	return formatDescriptionEscapes(result);
+}
+
+//#endregion
+//#region src/plugin-utils/traverse-command-tree.ts
+/**
+* Traverses a command tree and applies a visitor function to each node.
+*
+* @param commandTree - The command tree to traverse.
+* @param visitor - The visitor function to apply to each node.
+*/
+async function traverseCommandTree(commandTree, visitor) {
+	if (!commandTree.children) return;
+	await Promise.all(Object.values(commandTree.children).map(async (childTree) => {
+		await Promise.resolve(visitor(childTree));
+		await traverseCommandTree(childTree, visitor);
+	}));
+}
+/**
+* Traverses all commands in the context and applies a visitor function to each command tree.
+*
+* @param context - The build context containing the command definitions.
+* @param visitor - The visitor function to apply to each command tree.
+*/
+async function traverseCommands(context, visitor) {
+	if (!context.commands) return;
+	await Promise.all(Object.values(context.commands).map(async (childTree) => {
+		await Promise.resolve(visitor(childTree));
+		await traverseCommandTree(childTree, visitor);
+	}));
+}
+
+//#endregion
+//#region src/plugin-utils/get-command-tree.ts
+/**
+* Retrieves a specific command tree based on the provided path.
+*
+* @param context - The build context containing the command definitions.
+* @param path - An array of strings representing the command path.
+* @returns The command tree at the specified path, or null if not found.
+*/
+function getCommandTree(context, path = []) {
+	if (path.length === 0) return null;
+	let currentTree = context.commands[path[0]] ?? null;
+	if (path.length > 1) {
+		const segments = path.slice(1).filter((segment) => !require_context_helpers.isDynamicPathSegment(segment));
+		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
+		else return null;
+	}
+	return currentTree;
+}
+/**
+* Retrieves a list of all command trees defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command trees in the context.
+*/
+async function getCommandList(context) {
+	const commandList = [];
+	await traverseCommands(context, (commandTree) => {
+		commandList.push(commandTree);
+	});
+	return commandList;
+}
+/**
+* Retrieves a list of all command paths defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command paths in the context.
+*/
+async function getCommandPaths(context) {
+	const commandPaths = [];
+	await traverseCommands(context, (commandTree) => {
+		if (commandTree.path) commandPaths.push(commandTree.path);
+	});
+	return commandPaths;
+}
+/**
+* Retrieves a list of all command segments defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command segments in the context.
+*/
+async function getCommandSegments(context) {
+	const commandSegments = [];
+	await traverseCommands(context, (commandTree) => {
+		if (commandTree.path) commandSegments.push(commandTree.segments);
+	});
+	return commandSegments;
+}
+
+//#endregion
+exports.computeBin = computeBin;
+exports.extractReflectionKind = extractReflectionKind;
+exports.extractType = extractType;
+exports.formatDescription = formatDescription;
+exports.formatShortDescription = formatShortDescription;
 exports.getAppBin = require_context_helpers.getAppBin;
 exports.getAppDescription = require_context_helpers.getAppDescription;
 exports.getAppName = require_context_helpers.getAppName;
 exports.getAppTitle = require_context_helpers.getAppTitle;
-exports.getCommandList = require_get_command_tree.getCommandList;
-exports.getCommandPaths = require_get_command_tree.getCommandPaths;
-exports.getCommandSegments = require_get_command_tree.getCommandSegments;
-exports.getCommandTree = require_get_command_tree.getCommandTree;
+exports.getCommandList = getCommandList;
+exports.getCommandPaths = getCommandPaths;
+exports.getCommandSegments = getCommandSegments;
+exports.getCommandTree = getCommandTree;
 exports.getDynamicPathSegmentName = require_context_helpers.getDynamicPathSegmentName;
 exports.getPathSegmentGroupName = require_context_helpers.getPathSegmentGroupName;
 exports.getPathSegmentName = require_context_helpers.getPathSegmentName;
-exports.isCommandArgument = require_type_checks.isCommandArgument;
-exports.isCommandOption = require_type_checks.isCommandOption;
-exports.isCommandParameter = require_type_checks.isCommandParameter;
-exports.isCommandParameterConfig = require_type_checks.isCommandParameterConfig;
-exports.isCommandParameterType = require_type_checks.isCommandParameterType;
+exports.isCommandArgument = isCommandArgument;
+exports.isCommandOption = isCommandOption;
+exports.isCommandParameter = isCommandParameter;
+exports.isCommandParameterConfig = isCommandParameterConfig;
+exports.isCommandParameterType = isCommandParameterType;
 exports.isDynamicPathSegment = require_context_helpers.isDynamicPathSegment;
 exports.isPathSegmentGroup = require_context_helpers.isPathSegmentGroup;
 exports.sortArgAliases = require_context_helpers.sortArgAliases;
 exports.sortOptions = require_reflect.sortOptions;
-exports.traverseCommandTree = require_traverse_command_tree.traverseCommandTree;
-exports.traverseCommands = require_traverse_command_tree.traverseCommands;
+exports.traverseCommandTree = traverseCommandTree;
+exports.traverseCommands = traverseCommands;