padrone 1.4.0 → 1.5.0

package/dist/help-bbmu9-qd.mjs

@@ -0,0 +1,735 @@
+import { a as extractSchemaMetadata, c as parsePositionalConfig, l as parseStdinConfig, n as camelToKebab, t as JSON_SCHEMA_OPTS } from "./args-D5PNDyNu.mjs";
+import { L as getRootCommand, u as findCommandByName } from "./command-utils-B1D-HqCd.mjs";
+//#region src/colorizer.ts
+const ansiCodes = {
+	reset: "\x1B[0m",
+	bold: "\x1B[1m",
+	dim: "\x1B[2m",
+	italic: "\x1B[3m",
+	underline: "\x1B[4m",
+	strikethrough: "\x1B[9m",
+	red: "\x1B[31m",
+	green: "\x1B[32m",
+	yellow: "\x1B[33m",
+	blue: "\x1B[34m",
+	magenta: "\x1B[35m",
+	cyan: "\x1B[36m",
+	white: "\x1B[37m",
+	gray: "\x1B[90m"
+};
+const defaultTheme = {
+	command: ["cyan", "bold"],
+	arg: ["green"],
+	type: ["yellow"],
+	description: ["dim"],
+	label: ["bold"],
+	meta: ["gray"],
+	example: ["underline"],
+	exampleValue: ["italic"],
+	deprecated: ["strikethrough", "gray"]
+};
+const colorThemes = {
+	default: defaultTheme,
+	ocean: {
+		command: ["blue", "bold"],
+		arg: ["cyan"],
+		type: ["green"],
+		description: ["dim"],
+		label: ["bold"],
+		meta: ["gray"],
+		example: ["underline", "cyan"],
+		exampleValue: ["italic"],
+		deprecated: ["strikethrough", "gray"]
+	},
+	warm: {
+		command: ["yellow", "bold"],
+		arg: ["red"],
+		type: ["magenta"],
+		description: ["dim"],
+		label: ["bold"],
+		meta: ["gray"],
+		example: ["underline", "yellow"],
+		exampleValue: ["italic"],
+		deprecated: ["strikethrough", "gray"]
+	},
+	monochrome: {
+		command: ["bold"],
+		arg: ["underline"],
+		type: ["dim"],
+		description: ["dim"],
+		label: ["bold"],
+		meta: ["dim"],
+		example: ["underline"],
+		exampleValue: ["italic"],
+		deprecated: ["strikethrough", "dim"]
+	}
+};
+function makeStyleFn(styles) {
+	const prefix = styles.map((s) => ansiCodes[s]).join("");
+	return (text) => `${prefix}${text}${ansiCodes.reset}`;
+}
+function resolveConfig(config) {
+	if (!config) return defaultTheme;
+	if (typeof config === "string") return colorThemes[config] ?? defaultTheme;
+	return {
+		...defaultTheme,
+		...config
+	};
+}
+function createColorizer(config) {
+	const resolved = resolveConfig(config);
+	return {
+		command: makeStyleFn(resolved.command),
+		arg: makeStyleFn(resolved.arg),
+		type: makeStyleFn(resolved.type),
+		description: makeStyleFn(resolved.description),
+		label: makeStyleFn(resolved.label),
+		meta: makeStyleFn(resolved.meta),
+		example: makeStyleFn(resolved.example),
+		exampleValue: makeStyleFn(resolved.exampleValue),
+		deprecated: makeStyleFn(resolved.deprecated)
+	};
+}
+//#endregion
+//#region src/formatter.ts
+function createTextStyler() {
+	return {
+		command: (text) => text,
+		arg: (text) => text,
+		type: (text) => text,
+		description: (text) => text,
+		label: (text) => text,
+		section: (text) => text,
+		meta: (text) => text,
+		example: (text) => text,
+		exampleValue: (text) => text,
+		deprecated: (text) => text
+	};
+}
+function createAnsiStyler(theme) {
+	const colorizer = createColorizer(theme);
+	return {
+		command: colorizer.command,
+		arg: colorizer.arg,
+		type: colorizer.type,
+		description: colorizer.description,
+		label: colorizer.label,
+		section: colorizer.label,
+		meta: colorizer.meta,
+		example: colorizer.example,
+		exampleValue: colorizer.exampleValue,
+		deprecated: colorizer.deprecated
+	};
+}
+function createConsoleStyler(theme) {
+	return createAnsiStyler(theme);
+}
+function createMarkdownStyler() {
+	return {
+		command: (text) => `**${text}**`,
+		arg: (text) => `\`${text}\``,
+		type: (text) => `\`${text}\``,
+		description: (text) => text,
+		label: (text) => `**${text}**`,
+		section: (text) => `### ${text}`,
+		meta: (text) => `*${text}*`,
+		example: (text) => `**${text}**`,
+		exampleValue: (text) => `\`${text}\``,
+		deprecated: (text) => `~~${text}~~`
+	};
+}
+function escapeHtml(text) {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function createHtmlStyler() {
+	return {
+		command: (text) => `<strong style="color: #00bcd4;">${escapeHtml(text)}</strong>`,
+		arg: (text) => `<code style="color: #4caf50;">${escapeHtml(text)}</code>`,
+		type: (text) => `<code style="color: #ff9800;">${escapeHtml(text)}</code>`,
+		description: (text) => `<span style="color: #666;">${escapeHtml(text)}</span>`,
+		label: (text) => `<strong>${escapeHtml(text)}</strong>`,
+		section: (text) => `<h3>${escapeHtml(text)}</h3>`,
+		meta: (text) => `<span style="color: #999;">${escapeHtml(text)}</span>`,
+		example: (text) => `<strong style="text-decoration: underline;">${escapeHtml(text)}</strong>`,
+		exampleValue: (text) => `<em>${escapeHtml(text)}</em>`,
+		deprecated: (text) => `<del style="color: #999;">${escapeHtml(text)}</del>`
+	};
+}
+function createTextLayout() {
+	return {
+		newline: "\n",
+		indent: (level) => "  ".repeat(level),
+		join: (parts) => parts.filter(Boolean).join(" ")
+	};
+}
+function createMarkdownLayout() {
+	return {
+		newline: "\n\n",
+		indent: (level) => {
+			if (level === 0) return "";
+			if (level === 1) return "  ";
+			return "    ";
+		},
+		join: (parts) => parts.filter(Boolean).join(" ")
+	};
+}
+function createHtmlLayout() {
+	return {
+		newline: "<br>",
+		indent: (level) => "&nbsp;&nbsp;".repeat(level),
+		join: (parts) => parts.filter(Boolean).join(" "),
+		wrapDocument: (content) => `<div style="font-family: monospace; line-height: 1.6;">${content}</div>`
+	};
+}
+/**
+* Creates a formatter that uses the given styler and layout configuration.
+*/
+function createGenericFormatter(styler, layout, showAllBuiltins) {
+	const { newline, indent, join, wrapDocument } = layout;
+	function formatUsageSection(info) {
+		const usageParts = [styler.command(info.usage.command), info.usage.hasSubcommands ? styler.meta("[command]") : ""];
+		if (info.positionals && info.positionals.length > 0) for (const arg of info.positionals) {
+			const name = arg.name.startsWith("...") ? `${arg.name}` : arg.name;
+			usageParts.push(styler.meta(arg.optional ? `[${name}]` : `<${name}>`));
+		}
+		if (info.usage.hasArguments) usageParts.push(styler.meta("[options]"));
+		return [`${styler.label("Usage:")} ${join(usageParts)}`];
+	}
+	function formatSubcommandsSection(info) {
+		const lines = [];
+		const subcommands = info.subcommands;
+		const subcommandSuffix = (c) => c.hasSubcommands ? " <subcommand>" : "";
+		const formatAliasParts = (c) => {
+			if (!c.aliases?.length) return {
+				plain: "",
+				styled: ""
+			};
+			const realAliases = c.aliases.filter((a) => a !== "[default]");
+			const hasDefault = c.aliases.some((a) => a === "[default]");
+			const parts = [];
+			const styledParts = [];
+			if (realAliases.length) {
+				parts.push(`(${realAliases.join(", ")})`);
+				styledParts.push(`(${realAliases.join(", ")})`);
+			}
+			if (hasDefault) {
+				parts.push("[default]");
+				styledParts.push(styler.meta("[default]"));
+			}
+			return {
+				plain: parts.length ? ` ${parts.join(" ")}` : "",
+				styled: styledParts.length ? ` ${styledParts.join(" ")}` : ""
+			};
+		};
+		const maxNameLength = Math.max(...subcommands.map((c) => {
+			return (c.name + subcommandSuffix(c) + formatAliasParts(c).plain).length;
+		}));
+		const grouped = Object.groupBy(subcommands, (c) => c.group ?? "");
+		const renderSubcommands = (cmds) => {
+			for (const subCmd of cmds) {
+				const aliasParts = formatAliasParts(subCmd);
+				const suffix = subcommandSuffix(subCmd);
+				const commandDisplay = subCmd.name + suffix + aliasParts.plain;
+				const padding = " ".repeat(Math.max(0, maxNameLength - commandDisplay.length + 2));
+				const isDeprecated = !!subCmd.deprecated;
+				const isDefaultEntry = subCmd.name === "[default]";
+				const lineParts = [isDeprecated ? styler.deprecated(commandDisplay) : (isDefaultEntry ? styler.meta(subCmd.name) : styler.command(subCmd.name)) + (suffix ? styler.meta(suffix) : "") + aliasParts.styled, padding];
+				const displayText = subCmd.title ?? subCmd.description;
+				if (displayText) lineParts.push(isDeprecated ? styler.deprecated(displayText) : styler.description(displayText));
+				if (isDeprecated) {
+					const deprecatedMeta = typeof subCmd.deprecated === "string" ? styler.meta(` (deprecated: ${subCmd.deprecated})`) : styler.meta(" (deprecated)");
+					lineParts.push(deprecatedMeta);
+				}
+				lines.push(indent(1) + lineParts.join(""));
+			}
+		};
+		for (const [key, items] of Object.entries(grouped)) {
+			if (lines.length > 0) lines.push("");
+			lines.push(styler.section(key ? `${key}:` : "Commands:"));
+			renderSubcommands(items);
+		}
+		if (!info.builtins?.length) {
+			lines.push("");
+			lines.push(styler.meta(`Run "${info.name} [command] --help" for more information on a command.`));
+		}
+		return lines;
+	}
+	function formatPositionalsSection(info) {
+		const lines = [];
+		const args = info.positionals;
+		lines.push(styler.section("Arguments:"));
+		const maxNameLength = Math.min(32, Math.max(...args.map((a) => a.name.length)));
+		for (const arg of args) {
+			const padding = " ".repeat(Math.max(2, maxNameLength - arg.name.length + 2));
+			const descParts = [];
+			if (arg.description) descParts.push(styler.description(arg.description));
+			if (info.usage.stdinField === arg.name) descParts.push(styler.meta("(stdin)"));
+			if (arg.enum) descParts.push(styler.meta(`(choices: ${arg.enum.join(", ")})`));
+			if (arg.default !== void 0) descParts.push(styler.meta(`(default: ${String(arg.default)})`));
+			lines.push(indent(1) + styler.arg(arg.name) + padding + join(descParts));
+		}
+		return lines;
+	}
+	function formatArgumentsSection(info) {
+		const lines = [];
+		const argList = info.arguments || [];
+		const hasDefault = (value) => {
+			if (value === void 0) return false;
+			if (value === "") return false;
+			if (Array.isArray(value) && value.length === 0) return false;
+			return true;
+		};
+		const argColumns = argList.map((arg) => {
+			const kebab = camelToKebab(arg.name);
+			const primaryName = kebab && arg.aliases?.includes(kebab) ? kebab : arg.name;
+			const remainingAliases = arg.aliases?.filter((a) => a !== primaryName);
+			return {
+				flagsPlain: arg.flags?.length ? arg.flags.map((f) => `-${f}`).join(", ") : "",
+				namesPlain: [`--${primaryName}`, ...remainingAliases?.map((a) => `--${a}`) || []].join(", "),
+				typePlain: arg.type && arg.type !== "boolean" ? arg.optional ? `[${arg.type}]` : `<${arg.type}>` : "",
+				isDeprecated: !!arg.deprecated,
+				arg
+			};
+		});
+		const maxFlagsWidth = Math.min(12, Math.max(0, ...argColumns.map((c) => c.flagsPlain.length)));
+		const maxNamesWidth = Math.min(32, Math.max(0, ...argColumns.map((c) => c.namesPlain.length)));
+		const maxTypeWidth = Math.min(16, Math.max(0, ...argColumns.map((c) => c.typePlain.length)));
+		const hasAnyFlags = maxFlagsWidth > 0;
+		const grouped = Object.groupBy(argColumns, (c) => c.arg.group ?? "");
+		const renderArgColumns = (columns) => {
+			for (const { flagsPlain, namesPlain, typePlain, isDeprecated, arg } of columns) {
+				const parts = [];
+				if (hasAnyFlags) {
+					const styledFlags = isDeprecated ? flagsPlain ? styler.deprecated(flagsPlain) : "" : flagsPlain ? styler.arg(flagsPlain) : "";
+					const flagsPadding = " ".repeat(Math.max(0, maxFlagsWidth - flagsPlain.length));
+					const separator = flagsPlain ? ", " : "  ";
+					parts.push(styledFlags + flagsPadding + separator);
+				}
+				const styledNames = isDeprecated ? styler.deprecated(namesPlain) : styler.arg(namesPlain);
+				const namesPadding = " ".repeat(Math.max(2, maxNamesWidth - namesPlain.length + 2));
+				parts.push(styledNames + namesPadding);
+				if (maxTypeWidth > 0) {
+					const styledType = typePlain ? styler.type(typePlain) : "";
+					const typePadding = " ".repeat(Math.max(2, maxTypeWidth - typePlain.length + 2));
+					parts.push(styledType + typePadding);
+				}
+				const descParts = [];
+				if (arg.description) descParts.push(isDeprecated ? styler.deprecated(arg.description) : styler.description(arg.description));
+				lines.push(indent(1) + parts.join("") + join(descParts));
+				const line2Parts = [];
+				if (isDeprecated && typeof arg.deprecated !== "string") line2Parts.push(styler.meta("(deprecated)"));
+				if (hasDefault(arg.default)) line2Parts.push(styler.meta(`(default: ${String(arg.default)})`));
+				if (arg.enum) line2Parts.push(styler.meta(`(choices: ${arg.enum.join(", ")})`));
+				if (line2Parts.length > 0) lines.push(indent(3) + join(line2Parts));
+				const line3Parts = [];
+				if (isDeprecated && typeof arg.deprecated === "string") line3Parts.push(styler.meta(`(deprecated: ${arg.deprecated})`));
+				if (arg.examples && arg.examples.length > 0) {
+					const exampleValues = arg.examples.map((example) => typeof example === "string" ? example : JSON.stringify(example)).join(", ");
+					line3Parts.push(styler.example("Example:"), styler.exampleValue(exampleValues));
+				}
+				if (line3Parts.length > 0) lines.push(indent(3) + join(line3Parts));
+				const line4Parts = [];
+				if (info.usage.stdinField === arg.name) line4Parts.push(styler.meta("(stdin)"));
+				if (arg.env) {
+					const envVars = typeof arg.env === "string" ? [arg.env] : arg.env;
+					line4Parts.push(styler.example("Env:"), styler.exampleValue(envVars.join(", ")));
+				}
+				if (arg.configKey) line4Parts.push(styler.example("Config:"), styler.exampleValue(arg.configKey));
+				if (line4Parts.length > 0) lines.push(indent(3) + join(line4Parts));
+			}
+		};
+		for (const [key, items] of Object.entries(grouped)) {
+			if (lines.length > 0) lines.push("");
+			lines.push(styler.section(key ? `${key}:` : "Options:"));
+			renderArgColumns(items);
+		}
+		return lines;
+	}
+	function formatBuiltinsSection(info) {
+		const lines = [];
+		const builtins = info.builtins;
+		if (!showAllBuiltins) {
+			lines.push(`${styler.label("Global:")} ${styler.meta([
+				"help [command]",
+				"version",
+				"[command] --repl"
+			].join(", "))}`);
+			const hint = info.usage.hasSubcommands ? `Run "${info.name} [command] --help" for more information. Use "--all" for all global commands.` : `Use "${info.name} help --all" for more information on global commands.`;
+			lines.push(styler.meta(hint));
+			return lines;
+		}
+		lines.push(styler.section("Global:"));
+		const allLengths = [];
+		for (const entry of builtins) {
+			allLengths.push(entry.name.length);
+			if (entry.sub) for (const sub of entry.sub) allLengths.push(sub.name.length + 2);
+		}
+		const maxLen = Math.max(...allLengths);
+		for (const entry of builtins) {
+			const padding = " ".repeat(Math.max(2, maxLen - entry.name.length + 2));
+			const parts = [styler.command(entry.name)];
+			if (entry.description) parts.push(padding + styler.description(entry.description));
+			lines.push(indent(1) + parts.join(""));
+			if (entry.sub) for (const sub of entry.sub) {
+				const subPadding = " ".repeat(Math.max(2, maxLen - sub.name.length));
+				const subParts = [styler.arg(sub.name)];
+				if (sub.description) subParts.push(subPadding + styler.description(sub.description));
+				lines.push(indent(2) + subParts.join(""));
+			}
+		}
+		return lines;
+	}
+	return { format(info) {
+		const lines = [];
+		if (info.deprecated) {
+			const deprecationMessage = typeof info.deprecated === "string" ? `⚠️  This command is deprecated: ${info.deprecated}` : "⚠️  This command is deprecated";
+			lines.push(styler.deprecated(deprecationMessage));
+			lines.push("");
+		}
+		lines.push(...formatUsageSection(info));
+		lines.push("");
+		if (info.title) {
+			lines.push(styler.label(info.title));
+			lines.push("");
+		}
+		if (info.aliases && info.aliases.length > 0) {
+			lines.push(styler.meta(`Aliases: ${info.aliases.join(", ")}`));
+			lines.push("");
+		}
+		if (info.description) {
+			lines.push(styler.description(info.description));
+			lines.push("");
+		}
+		if (info.examples && info.examples.length > 0) {
+			lines.push(styler.section("Examples:"));
+			for (const ex of info.examples) lines.push(indent(1) + styler.meta("$ ") + styler.exampleValue(ex));
+			lines.push("");
+		}
+		if (info.subcommands && info.subcommands.length > 0) {
+			lines.push(...formatSubcommandsSection(info));
+			lines.push("");
+		}
+		if (info.positionals && info.positionals.length > 0) {
+			lines.push(...formatPositionalsSection(info));
+			lines.push("");
+		}
+		if (info.arguments && info.arguments.length > 0) {
+			lines.push(...formatArgumentsSection(info));
+			lines.push("");
+		}
+		if (info.builtins && info.builtins.length > 0) {
+			lines.push(...formatBuiltinsSection(info));
+			lines.push("");
+		}
+		if (info.arguments?.some((arg) => arg.negatable && arg.default === true)) {
+			lines.push(styler.meta("Boolean options can be negated with --no-<option>."));
+			lines.push("");
+		}
+		if (info.nestedCommands?.length) {
+			lines.push(styler.section("Subcommand Details:"));
+			lines.push("");
+			for (const nestedCmd of info.nestedCommands) {
+				lines.push(styler.meta("─".repeat(60)));
+				lines.push(this.format(nestedCmd));
+			}
+		}
+		const result = lines.join(newline);
+		return wrapDocument ? wrapDocument(result) : result;
+	} };
+}
+function createJsonFormatter() {
+	return { format(info) {
+		return JSON.stringify(info, null, 2);
+	} };
+}
+function shouldUseAnsi() {
+	if (typeof process === "undefined") return false;
+	if (process.env.NO_COLOR) return false;
+	if (process.env.CI) return false;
+	if (process.stdout && typeof process.stdout.isTTY === "boolean") return process.stdout.isTTY;
+	return false;
+}
+/**
+* Creates a minimal formatter that outputs just a single-line usage string.
+*/
+function createMinimalFormatter() {
+	return { format(info) {
+		const parts = [info.usage.command];
+		if (info.usage.hasSubcommands) parts.push("[command]");
+		if (info.positionals && info.positionals.length > 0) for (const arg of info.positionals) {
+			const name = arg.name.startsWith("...") ? `${arg.name}` : arg.name;
+			parts.push(arg.optional ? `[${name}]` : `<${name}>`);
+		}
+		if (info.usage.hasArguments) parts.push("[options]");
+		return parts.join(" ");
+	} };
+}
+function createFormatter(format, detail = "standard", theme, all) {
+	if (detail === "minimal") return createMinimalFormatter();
+	if (format === "json") return createJsonFormatter();
+	if (format === "ansi" || format === "auto" && shouldUseAnsi()) return createGenericFormatter(createAnsiStyler(theme), createTextLayout(), all);
+	if (format === "console") return createGenericFormatter(createConsoleStyler(theme), createTextLayout(), all);
+	if (format === "markdown") return createGenericFormatter(createMarkdownStyler(), createMarkdownLayout(), all);
+	if (format === "html") return createGenericFormatter(createHtmlStyler(), createHtmlLayout(), all);
+	return createGenericFormatter(createTextStyler(), createTextLayout(), all);
+}
+//#endregion
+//#region src/help.ts
+/**
+* Extract positional arguments info from schema based on meta.positional config.
+*/
+function extractPositionalArgsInfo(schema, meta) {
+	const args = [];
+	const positionalNames = /* @__PURE__ */ new Set();
+	if (!schema || !meta?.positional || meta.positional.length === 0) return {
+		args,
+		positionalNames
+	};
+	const positionalConfig = parsePositionalConfig(meta.positional);
+	try {
+		const jsonSchema = schema["~standard"].jsonSchema.input(JSON_SCHEMA_OPTS);
+		if (jsonSchema.type === "object" && jsonSchema.properties) {
+			const properties = jsonSchema.properties;
+			const required = jsonSchema.required || [];
+			for (const { name, variadic } of positionalConfig) {
+				const prop = properties[name];
+				if (!prop) continue;
+				positionalNames.add(name);
+				const optMeta = meta.fields?.[name];
+				args.push({
+					name: variadic ? `...${name}` : name,
+					description: optMeta?.description ?? prop.description,
+					optional: !required.includes(name),
+					default: prop.default,
+					type: variadic ? `array<${prop.items?.type || "string"}>` : prop.type,
+					enum: prop.enum ?? prop.items?.enum
+				});
+			}
+		}
+	} catch {}
+	return {
+		args,
+		positionalNames
+	};
+}
+function extractArgsInfo(schema, meta, positionalNames) {
+	const result = [];
+	if (!schema) return result;
+	if (!schema["~standard"].vendor.includes("zod")) return result;
+	const argsMeta = meta?.fields;
+	try {
+		const jsonSchema = schema["~standard"].jsonSchema.input(JSON_SCHEMA_OPTS);
+		if (jsonSchema.type === "object" && jsonSchema.properties) {
+			const properties = jsonSchema.properties;
+			const required = jsonSchema.required || [];
+			const propertyNames = new Set(Object.keys(properties));
+			const hasExplicitNegation = (key) => {
+				const camelNegated = `no${key.charAt(0).toUpperCase()}${key.slice(1)}`;
+				if (propertyNames.has(camelNegated)) return true;
+				const kebabNegated = `no-${key}`;
+				if (propertyNames.has(kebabNegated)) return true;
+				return false;
+			};
+			const isNegationOf = (key) => {
+				if (key.startsWith("no") && key.length > 2 && key[2] === key[2]?.toUpperCase()) {
+					const positiveKey = key.charAt(2).toLowerCase() + key.slice(3);
+					if (propertyNames.has(positiveKey)) return true;
+				}
+				if (key.startsWith("no-")) {
+					const positiveKey = key.slice(3);
+					if (propertyNames.has(positiveKey)) return true;
+				}
+				return false;
+			};
+			for (const [key, prop] of Object.entries(properties)) {
+				if (positionalNames?.has(key)) continue;
+				const isOptional = !required.includes(key);
+				const enumValues = prop.enum ?? prop.items?.enum;
+				const optMeta = argsMeta?.[key];
+				const propType = prop.type;
+				const isNegatable = propType === "boolean" && !hasExplicitNegation(key) && !isNegationOf(key);
+				result.push({
+					name: key,
+					description: optMeta?.description ?? prop.description,
+					optional: isOptional,
+					default: prop.default,
+					type: propType === "array" ? `${prop.items?.type || "string"}[]` : propType,
+					enum: enumValues,
+					deprecated: optMeta?.deprecated ?? prop?.deprecated,
+					hidden: optMeta?.hidden ?? prop?.hidden,
+					examples: optMeta?.examples ?? prop?.examples,
+					variadic: propType === "array",
+					negatable: isNegatable,
+					group: optMeta?.group
+				});
+			}
+		}
+	} catch {}
+	return result;
+}
+/**
+* Builds a comprehensive HelpInfo structure from a command.
+* This is the single source of truth that all formatters use.
+* @param cmd - The command to build help info for
+* @param detail - The level of detail ('minimal', 'standard', or 'full')
+*/
+function getHelpInfo(cmd, detail = "standard", all) {
+	const rootCmd = getRootCommand(cmd);
+	const isDefaultCommand = cmd.parent && (!cmd.name || cmd.aliases?.includes(""));
+	const nonEmptyAliases = cmd.aliases?.filter(Boolean);
+	const commandName = cmd.path || cmd.name || nonEmptyAliases?.[0] || (cmd.parent ? "[default]" : "program");
+	const remainingAliases = !cmd.name && nonEmptyAliases?.length ? nonEmptyAliases.slice(1) : nonEmptyAliases ?? [];
+	const displayAliases = isDefaultCommand ? [...remainingAliases, "[default]"] : nonEmptyAliases;
+	const { args: positionalArgs, positionalNames } = cmd.argsSchema ? extractPositionalArgsInfo(cmd.argsSchema, cmd.meta) : {
+		args: [],
+		positionalNames: /* @__PURE__ */ new Set()
+	};
+	const hasPositionals = positionalArgs.length > 0;
+	const helpInfo = {
+		name: commandName,
+		title: cmd.title,
+		description: cmd.description,
+		examples: cmd.examples,
+		aliases: displayAliases,
+		deprecated: cmd.deprecated,
+		hidden: cmd.hidden,
+		usage: {
+			command: rootCmd === cmd ? commandName : `${rootCmd.name} ${commandName}`,
+			hasSubcommands: !!(cmd.commands && cmd.commands.length > 0),
+			hasPositionals,
+			hasArguments: false,
+			stdinField: cmd.meta?.stdin ? parseStdinConfig(cmd.meta.stdin) : void 0
+		}
+	};
+	if (cmd.commands && cmd.commands.length > 0) {
+		const visibleCommands = detail === "full" ? cmd.commands : cmd.commands.filter((c) => !c.hidden);
+		helpInfo.subcommands = [...cmd.action ? [{
+			name: "[default]",
+			title: cmd.title,
+			description: cmd.description
+		}] : [], ...visibleCommands.flatMap((c) => {
+			const isDefault = !c.name || c.aliases?.includes("");
+			const nonEmptyAliases = c.aliases?.filter(Boolean);
+			const displayName = c.name || nonEmptyAliases?.[0] || "[default]";
+			const remainingAliases = !c.name && nonEmptyAliases?.length ? nonEmptyAliases.slice(1) : nonEmptyAliases ?? [];
+			const displayAliases = isDefault && displayName !== "[default]" ? [...remainingAliases, "[default]"] : isDefault ? remainingAliases : nonEmptyAliases;
+			const hasSubcommands = !!(c.commands && c.commands.length > 0);
+			const hasDefaultHandler = c.action || c.commands?.some((sub) => !sub.name || sub.aliases?.includes(""));
+			if (hasSubcommands && hasDefaultHandler) {
+				const defaultSub = !c.action ? c.commands?.find((sub) => !sub.name || sub.aliases?.includes("")) : void 0;
+				const hasDefaultSubInfo = defaultSub && (defaultSub.title || defaultSub.description);
+				return [{
+					name: displayName,
+					title: hasDefaultSubInfo ? defaultSub.title : c.title,
+					description: hasDefaultSubInfo ? defaultSub.description : c.description,
+					aliases: displayAliases?.length ? displayAliases : void 0,
+					deprecated: c.deprecated,
+					hidden: c.hidden,
+					group: c.group
+				}, {
+					name: displayName,
+					title: c.title,
+					description: c.description,
+					deprecated: c.deprecated,
+					hidden: c.hidden,
+					hasSubcommands: true,
+					group: c.group
+				}];
+			}
+			return [{
+				name: displayName,
+				title: c.title,
+				description: c.description,
+				aliases: displayAliases?.length ? displayAliases : void 0,
+				deprecated: c.deprecated,
+				hidden: c.hidden,
+				hasSubcommands,
+				group: c.group
+			}];
+		})];
+		if (detail === "full") helpInfo.nestedCommands = visibleCommands.map((c) => getHelpInfo(c, "full"));
+	}
+	if (hasPositionals) helpInfo.positionals = positionalArgs;
+	if (cmd.argsSchema) {
+		const argsInfo = extractArgsInfo(cmd.argsSchema, cmd.meta, positionalNames);
+		const argMap = Object.fromEntries(argsInfo.map((arg) => [arg.name, arg]));
+		const { flags, aliases } = extractSchemaMetadata(cmd.argsSchema, cmd.meta?.fields, cmd.meta?.autoAlias);
+		for (const [flag, name] of Object.entries(flags)) {
+			const arg = argMap[name];
+			if (!arg) continue;
+			arg.flags = [...arg.flags || [], flag];
+		}
+		for (const [alias, name] of Object.entries(aliases)) {
+			const arg = argMap[name];
+			if (!arg) continue;
+			arg.aliases = [...arg.aliases || [], alias];
+		}
+		const visibleArgs = argsInfo.filter((arg) => !arg.hidden);
+		if (visibleArgs.length > 0) {
+			helpInfo.arguments = visibleArgs;
+			helpInfo.usage.hasArguments = true;
+		}
+	}
+	if (!cmd.parent || all) {
+		const builtins = [];
+		if (!findCommandByName("help", rootCmd.commands)) builtins.push({
+			name: "help [command], -h, --help",
+			description: "Show help for a command",
+			sub: [
+				{
+					name: "--all",
+					description: "Show all global commands and flags"
+				},
+				{
+					name: "--detail <level>",
+					description: "Detail level (minimal, standard, full)"
+				},
+				{
+					name: "--format <format>",
+					description: "Output format (text, ansi, json, markdown, html)"
+				}
+			]
+		});
+		if (!findCommandByName("version", rootCmd.commands)) builtins.push({
+			name: "version, -v, --version",
+			description: "Show version information"
+		});
+		if (!findCommandByName("completion", rootCmd.commands)) builtins.push({
+			name: "completion [shell]",
+			description: "Generate shell completions (bash, zsh, fish, powershell)"
+		});
+		if (!findCommandByName("man", rootCmd.commands)) builtins.push({
+			name: "man",
+			description: "Show or install man pages (--setup to install, --remove to uninstall) (experimental)"
+		});
+		builtins.push({
+			name: "[command] --repl",
+			description: "Start interactive REPL scoped to a command"
+		});
+		if (!findCommandByName("mcp", rootCmd.commands)) builtins.push({
+			name: "mcp [http|stdio]",
+			description: "Start a Model Context Protocol server to expose commands as AI tools (experimental)",
+			sub: [{
+				name: "--port <port>",
+				description: "HTTP port (default: 3000)"
+			}, {
+				name: "--host <host>",
+				description: "HTTP host (default: 127.0.0.1)"
+			}]
+		});
+		builtins.push({
+			name: "--color [theme], --no-color",
+			description: "Set color theme (default, ocean, warm, monochrome) or disable colors"
+		});
+		if (builtins.length > 0) helpInfo.builtins = builtins;
+	}
+	return helpInfo;
+}
+function generateHelp(rootCommand, commandObj = rootCommand, prefs) {
+	const helpInfo = getHelpInfo(commandObj, prefs?.detail, prefs?.all);
+	return createFormatter(prefs?.format ?? "auto", prefs?.detail, prefs?.theme, prefs?.all).format(helpInfo);
+}
+//#endregion
+export { getHelpInfo as n, colorThemes as r, generateHelp as t };
+
+//# sourceMappingURL=help-bbmu9-qd.mjs.map