padrone 1.9.0 → 2.0.0

package/dist/ink.d.mts

@@ -0,0 +1,2 @@
+import { InkOptions, isReactElement, padroneInk } from "./extension/ink.mjs";
+export { type InkOptions, isReactElement, padroneInk };

package/dist/ink.mjs

@@ -0,0 +1,2 @@
+import { isReactElement, padroneInk } from "./extension/ink.mjs";
+export { isReactElement, padroneInk };

package/dist/man.d.mts

@@ -0,0 +1,2 @@
+import { WithMan, padroneMan } from "./extension/man.mjs";
+export { type WithMan, padroneMan };

package/dist/man.mjs

@@ -0,0 +1,2 @@
+import { padroneMan } from "./extension/man.mjs";
+export { padroneMan };

package/dist/mcp.d.mts

@@ -0,0 +1,3 @@
+import { PadroneMcpPreferences } from "./feature/mcp.mjs";
+import { WithMcp, padroneMcp } from "./extension/mcp.mjs";
+export { type PadroneMcpPreferences, type WithMcp, padroneMcp };

package/dist/mcp.mjs

@@ -0,0 +1,2 @@
+import { padroneMcp } from "./extension/mcp.mjs";
+export { padroneMcp };

package/dist/output/colorizer.d.mts

@@ -0,0 +1,28 @@
+//#region src/output/colorizer.d.ts
+/**
+ * Available ANSI styles that can be combined for each color role.
+ */
+type AnsiStyle = 'reset' | 'bold' | 'dim' | 'italic' | 'underline' | 'strikethrough' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'gray';
+/**
+ * Maps each semantic color role to an array of ANSI styles.
+ * Partial configs are merged with the default theme.
+ */
+type ColorConfig = {
+  command?: AnsiStyle[];
+  arg?: AnsiStyle[];
+  type?: AnsiStyle[];
+  description?: AnsiStyle[];
+  label?: AnsiStyle[];
+  meta?: AnsiStyle[];
+  example?: AnsiStyle[];
+  exampleValue?: AnsiStyle[];
+  deprecated?: AnsiStyle[];
+};
+/**
+ * Available predefined color themes.
+ */
+type ColorTheme = 'default' | 'ocean' | 'warm' | 'monochrome';
+declare const colorThemes: Record<ColorTheme, Required<ColorConfig>>;
+//#endregion
+export { AnsiStyle, ColorConfig, ColorTheme, colorThemes };
+//# sourceMappingURL=colorizer.d.mts.map

package/dist/output/colorizer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorizer.d.mts","names":[],"sources":["../../src/output/colorizer.ts"],"mappings":";;AAqBA;;KAAY,SAAA;;AAAS;AAoBrB;;KAAY,WAAA;EACV,OAAA,GAAU,SAAA;EACV,GAAA,GAAM,SAAA;EACN,IAAA,GAAO,SAAA;EACP,WAAA,GAAc,SAAA;EACd,KAAA,GAAQ,SAAA;EACR,IAAA,GAAO,SAAA;EACP,OAAA,GAAU,SAAA;EACV,YAAA,GAAe,SAAA;EACf,UAAA,GAAa,SAAA;AAAA;;;;KAsEH,UAAA;AAAA,cAEC,WAAA,EAAa,MAAA,CAAO,UAAA,EAAY,QAAA,CAAS,WAAA"}

package/dist/output/colorizer.mjs

@@ -0,0 +1,94 @@
+//#region src/output/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
+export { colorThemes, createColorizer };
+
+//# sourceMappingURL=colorizer.mjs.map

package/dist/output/colorizer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorizer.mjs","names":[],"sources":["../../src/output/colorizer.ts"],"sourcesContent":["// ANSI color/style codes\nconst ansiCodes: Record<AnsiStyle, string> = {\n  reset: '\\x1b[0m',\n  bold: '\\x1b[1m',\n  dim: '\\x1b[2m',\n  italic: '\\x1b[3m',\n  underline: '\\x1b[4m',\n  strikethrough: '\\x1b[9m',\n  red: '\\x1b[31m',\n  green: '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  blue: '\\x1b[34m',\n  magenta: '\\x1b[35m',\n  cyan: '\\x1b[36m',\n  white: '\\x1b[37m',\n  gray: '\\x1b[90m',\n};\n\n/**\n * Available ANSI styles that can be combined for each color role.\n */\nexport type AnsiStyle =\n  | 'reset'\n  | 'bold'\n  | 'dim'\n  | 'italic'\n  | 'underline'\n  | 'strikethrough'\n  | 'red'\n  | 'green'\n  | 'yellow'\n  | 'blue'\n  | 'magenta'\n  | 'cyan'\n  | 'white'\n  | 'gray';\n\n/**\n * Maps each semantic color role to an array of ANSI styles.\n * Partial configs are merged with the default theme.\n */\nexport type ColorConfig = {\n  command?: AnsiStyle[];\n  arg?: AnsiStyle[];\n  type?: AnsiStyle[];\n  description?: AnsiStyle[];\n  label?: AnsiStyle[];\n  meta?: AnsiStyle[];\n  example?: AnsiStyle[];\n  exampleValue?: AnsiStyle[];\n  deprecated?: AnsiStyle[];\n};\n\nexport type Colorizer = {\n  command: (text: string) => string;\n  arg: (text: string) => string;\n  type: (text: string) => string;\n  description: (text: string) => string;\n  label: (text: string) => string;\n  meta: (text: string) => string;\n  example: (text: string) => string;\n  exampleValue: (text: string) => string;\n  deprecated: (text: string) => string;\n};\n\n// ============================================================================\n// Predefined Themes\n// ============================================================================\n\nconst defaultTheme: Required<ColorConfig> = {\n  command: ['cyan', 'bold'],\n  arg: ['green'],\n  type: ['yellow'],\n  description: ['dim'],\n  label: ['bold'],\n  meta: ['gray'],\n  example: ['underline'],\n  exampleValue: ['italic'],\n  deprecated: ['strikethrough', 'gray'],\n};\n\nconst oceanTheme: Required<ColorConfig> = {\n  command: ['blue', 'bold'],\n  arg: ['cyan'],\n  type: ['green'],\n  description: ['dim'],\n  label: ['bold'],\n  meta: ['gray'],\n  example: ['underline', 'cyan'],\n  exampleValue: ['italic'],\n  deprecated: ['strikethrough', 'gray'],\n};\n\nconst warmTheme: Required<ColorConfig> = {\n  command: ['yellow', 'bold'],\n  arg: ['red'],\n  type: ['magenta'],\n  description: ['dim'],\n  label: ['bold'],\n  meta: ['gray'],\n  example: ['underline', 'yellow'],\n  exampleValue: ['italic'],\n  deprecated: ['strikethrough', 'gray'],\n};\n\nconst monochromeTheme: Required<ColorConfig> = {\n  command: ['bold'],\n  arg: ['underline'],\n  type: ['dim'],\n  description: ['dim'],\n  label: ['bold'],\n  meta: ['dim'],\n  example: ['underline'],\n  exampleValue: ['italic'],\n  deprecated: ['strikethrough', 'dim'],\n};\n\n/**\n * Available predefined color themes.\n */\nexport type ColorTheme = 'default' | 'ocean' | 'warm' | 'monochrome';\n\nexport const colorThemes: Record<ColorTheme, Required<ColorConfig>> = {\n  default: defaultTheme,\n  ocean: oceanTheme,\n  warm: warmTheme,\n  monochrome: monochromeTheme,\n};\n\nfunction makeStyleFn(styles: AnsiStyle[]): (text: string) => string {\n  const prefix = styles.map((s) => ansiCodes[s]).join('');\n  return (text: string) => `${prefix}${text}${ansiCodes.reset}`;\n}\n\nfunction resolveConfig(config?: ColorTheme | ColorConfig): Required<ColorConfig> {\n  if (!config) return defaultTheme;\n  if (typeof config === 'string') return colorThemes[config] ?? defaultTheme;\n  return { ...defaultTheme, ...config };\n}\n\nexport function createColorizer(config?: ColorTheme | ColorConfig): Colorizer {\n  const resolved = resolveConfig(config);\n  return {\n    command: makeStyleFn(resolved.command),\n    arg: makeStyleFn(resolved.arg),\n    type: makeStyleFn(resolved.type),\n    description: makeStyleFn(resolved.description),\n    label: makeStyleFn(resolved.label),\n    meta: makeStyleFn(resolved.meta),\n    example: makeStyleFn(resolved.example),\n    exampleValue: makeStyleFn(resolved.exampleValue),\n    deprecated: makeStyleFn(resolved.deprecated),\n  };\n}\n"],"mappings":";AACA,MAAM,YAAuC;CAC3C,OAAO;CACP,MAAM;CACN,KAAK;CACL,QAAQ;CACR,WAAW;CACX,eAAe;CACf,KAAK;CACL,OAAO;CACP,QAAQ;CACR,MAAM;CACN,SAAS;CACT,MAAM;CACN,OAAO;CACP,MAAM;AACR;AAqDA,MAAM,eAAsC;CAC1C,SAAS,CAAC,QAAQ,MAAM;CACxB,KAAK,CAAC,OAAO;CACb,MAAM,CAAC,QAAQ;CACf,aAAa,CAAC,KAAK;CACnB,OAAO,CAAC,MAAM;CACd,MAAM,CAAC,MAAM;CACb,SAAS,CAAC,WAAW;CACrB,cAAc,CAAC,QAAQ;CACvB,YAAY,CAAC,iBAAiB,MAAM;AACtC;AA2CA,MAAa,cAAyD;CACpE,SAAS;CACT,OAAO;EA1CP,SAAS,CAAC,QAAQ,MAAM;EACxB,KAAK,CAAC,MAAM;EACZ,MAAM,CAAC,OAAO;EACd,aAAa,CAAC,KAAK;EACnB,OAAO,CAAC,MAAM;EACd,MAAM,CAAC,MAAM;EACb,SAAS,CAAC,aAAa,MAAM;EAC7B,cAAc,CAAC,QAAQ;EACvB,YAAY,CAAC,iBAAiB,MAAM;CAkC7B;CACP,MAAM;EA/BN,SAAS,CAAC,UAAU,MAAM;EAC1B,KAAK,CAAC,KAAK;EACX,MAAM,CAAC,SAAS;EAChB,aAAa,CAAC,KAAK;EACnB,OAAO,CAAC,MAAM;EACd,MAAM,CAAC,MAAM;EACb,SAAS,CAAC,aAAa,QAAQ;EAC/B,cAAc,CAAC,QAAQ;EACvB,YAAY,CAAC,iBAAiB,MAAM;CAuB9B;CACN,YAAY;EApBZ,SAAS,CAAC,MAAM;EAChB,KAAK,CAAC,WAAW;EACjB,MAAM,CAAC,KAAK;EACZ,aAAa,CAAC,KAAK;EACnB,OAAO,CAAC,MAAM;EACd,MAAM,CAAC,KAAK;EACZ,SAAS,CAAC,WAAW;EACrB,cAAc,CAAC,QAAQ;EACvB,YAAY,CAAC,iBAAiB,KAAK;CAYvB;AACd;AAEA,SAAS,YAAY,QAA+C;CAClE,MAAM,SAAS,OAAO,KAAK,MAAM,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE;CACtD,QAAQ,SAAiB,GAAG,SAAS,OAAO,UAAU;AACxD;AAEA,SAAS,cAAc,QAA0D;CAC/E,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,WAAW,UAAU,OAAO,YAAY,WAAW;CAC9D,OAAO;EAAE,GAAG;EAAc,GAAG;CAAO;AACtC;AAEA,SAAgB,gBAAgB,QAA8C;CAC5E,MAAM,WAAW,cAAc,MAAM;CACrC,OAAO;EACL,SAAS,YAAY,SAAS,OAAO;EACrC,KAAK,YAAY,SAAS,GAAG;EAC7B,MAAM,YAAY,SAAS,IAAI;EAC/B,aAAa,YAAY,SAAS,WAAW;EAC7C,OAAO,YAAY,SAAS,KAAK;EACjC,MAAM,YAAY,SAAS,IAAI;EAC/B,SAAS,YAAY,SAAS,OAAO;EACrC,cAAc,YAAY,SAAS,YAAY;EAC/C,YAAY,YAAY,SAAS,UAAU;CAC7C;AACF"}

package/dist/{formatter-CY3KrOEd.d.mts → output/formatter.d.mts}

@@ -1,29 +1,3 @@
-//#region src/output/colorizer.d.ts
-/**
- * Available ANSI styles that can be combined for each color role.
- */
-type AnsiStyle = 'reset' | 'bold' | 'dim' | 'italic' | 'underline' | 'strikethrough' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'gray';
-/**
- * Maps each semantic color role to an array of ANSI styles.
- * Partial configs are merged with the default theme.
- */
-type ColorConfig = {
-  command?: AnsiStyle[];
-  arg?: AnsiStyle[];
-  type?: AnsiStyle[];
-  description?: AnsiStyle[];
-  label?: AnsiStyle[];
-  meta?: AnsiStyle[];
-  example?: AnsiStyle[];
-  exampleValue?: AnsiStyle[];
-  deprecated?: AnsiStyle[];
-};
-/**
- * Available predefined color themes.
- */
-type ColorTheme = 'default' | 'ocean' | 'warm' | 'monochrome';
-declare const colorThemes: Record<ColorTheme, Required<ColorConfig>>;
-//#endregion
 //#region src/output/formatter.d.ts
 type HelpFormat = 'text' | 'ansi' | 'console' | 'markdown' | 'html' | 'json';
 type HelpDetail = 'minimal' | 'standard' | 'full';
@@ -110,5 +84,5 @@ type HelpInfo = {
   nestedCommands?: HelpInfo[];
 };
 //#endregion
-export { ColorConfig as a, AnsiStyle as i, HelpFormat as n, ColorTheme as o, HelpInfo as r, colorThemes as s, HelpDetail as t };
-//# sourceMappingURL=formatter-CY3KrOEd.d.mts.map
+export { HelpArgumentInfo, HelpBuiltinInfo, HelpDetail, HelpFormat, HelpInfo, HelpPositionalInfo, HelpSubcommandInfo };
+//# sourceMappingURL=formatter.d.mts.map

package/dist/output/formatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.mts","names":[],"sources":["../../src/output/formatter.ts"],"mappings":";KAkBY,UAAA;AAAA,KACA,UAAA;;;AADU;KAUV,kBAAA;EACV,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,IAAA;EACA,IAAA;AAAA;;;;KAMU,gBAAA;EACV,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,IAAA;EACA,IAAA,aAN0B;EAQ1B,KAAA,aAR0B;EAU1B,OAAA;EACA,UAAA;EACA,MAAA;EACA,QAAA,cARA;EAUA,GAAA,sBAPA;EASA,QAAA,YANA;EAQA,SAAA,YANA;EAQA,QAAA,aAJA;EAMA,SAAA,WAFA;EAIA,KAAA;AAAA;;AAAK;AAMP;KAAY,kBAAA;EACV,IAAA;EACA,KAAA;EACA,WAAA;EACA,OAAA;EACA,UAAA;EACA,MAAA;EACA,cAAA,YADA;EAGA,KAAA;AAAA;;AAAK;AAMP;KAAY,eAAA;EACV,IAAA;EACA,WAAA;EACA,GAAA;IAAQ,IAAA;IAAc,WAAA;EAAA;AAAA;;AAAW;AAOnC;;KAAY,QAAA;EAuBI,4DArBd,IAAA,UAyBY;EAvBZ,KAAA,WA6BiB;EA3BjB,WAAA,WA2ByB;EAzBzB,OAAA,aAJA;EAMA,UAAA,qBAFA;EAIA,MAAA;EAEA,KAAA;IACE,OAAA;IACA,cAAA;IACA,cAAA;IACA,YAAA,WAEA;IAAA,UAAA;EAAA,GAKF;EAFA,WAAA,GAAc,kBAAA,IAId;EAFA,WAAA,GAAc,kBAAA,IAId;EAFA,SAAA,GAAY,gBAAA,IAIZ;EAFA,QAAA,GAAW,eAAA,IAIM;EAFjB,QAAA,aAEyB;EAAzB,cAAA,GAAiB,QAAA;AAAA"}

package/dist/output/formatter.mjs

@@ -0,0 +1,360 @@
+import { camelToKebab } from "../util/shell-utils.mjs";
+import { createAnsiStyler, createConsoleStyler, createHtmlLayout, createHtmlStyler, createMarkdownLayout, createMarkdownStyler, createTextLayout, createTextStyler, shouldUseAnsi, wrapText } from "./styling.mjs";
+//#region src/output/formatter.ts
+/**
+* Creates a formatter that uses the given styler and layout configuration.
+*/
+function createGenericFormatter(styler, layout, showAllBuiltins, terminalWidth) {
+	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)));
+		const descCol = 2 + maxNameLength + 2;
+		const posAvailWidth = terminalWidth ? terminalWidth - descCol : void 0;
+		const descColPad = " ".repeat(descCol);
+		for (const arg of args) {
+			const padding = " ".repeat(Math.max(2, maxNameLength - arg.name.length + 2));
+			const prefix = indent(1) + styler.arg(arg.name) + padding;
+			const descPlain = arg.description ?? "";
+			const styledDesc = descPlain ? styler.description(descPlain) : "";
+			const metaParts = [];
+			const styledMetaParts = [];
+			if (info.usage.stdinField === arg.name) {
+				metaParts.push("(stdin)");
+				styledMetaParts.push(styler.meta("(stdin)"));
+			}
+			if (arg.enum) {
+				const text = `(choices: ${arg.enum.join(", ")})`;
+				metaParts.push(text);
+				styledMetaParts.push(styler.meta(text));
+			}
+			if (arg.default !== void 0) {
+				const text = `(default: ${String(arg.default)})`;
+				metaParts.push(text);
+				styledMetaParts.push(styler.meta(text));
+			}
+			const metaStyled = join(styledMetaParts);
+			if (posAvailWidth && posAvailWidth > 0) if ([descPlain, metaParts.join(" ")].filter(Boolean).join(" ").length <= posAvailWidth) lines.push(prefix + [styledDesc, metaStyled].filter(Boolean).join(" "));
+			else if (!descPlain || descPlain.length <= posAvailWidth) {
+				lines.push(prefix + styledDesc);
+				if (metaStyled) lines.push(descColPad + metaStyled);
+			} else {
+				const wrapped = wrapText(descPlain, posAvailWidth);
+				lines.push(prefix + styler.description(wrapped[0]));
+				for (const wline of wrapped.slice(1)) lines.push(descColPad + styler.description(wline));
+				if (metaStyled) lines.push(descColPad + metaStyled);
+			}
+			else lines.push(prefix + join([styledDesc, metaStyled]));
+		}
+		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);
+			const flagsPlain = arg.flags?.length ? arg.flags.map((f) => `-${f}`).join(", ") : "";
+			const negPlain = arg.negative?.length ? arg.negative.map((n) => `--${n}`).join(", ") : "";
+			return {
+				flagsPlain,
+				namesPlain: [
+					`--${primaryName}`,
+					...remainingAliases?.map((a) => `--${a}`) || [],
+					...negPlain ? [negPlain] : []
+				].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 descCol = 2 + (hasAnyFlags ? maxFlagsWidth + 2 : 0) + maxNamesWidth + 2 + (maxTypeWidth > 0 ? maxTypeWidth + 2 : 0);
+		const argAvailWidth = terminalWidth ? terminalWidth - descCol : void 0;
+		const descColPad = " ".repeat(descCol);
+		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 prefix = indent(1) + parts.join("");
+				const contPad = argAvailWidth ? descColPad : indent(3);
+				const inlineMeta = [];
+				const styledInlineMeta = [];
+				if (isDeprecated && typeof arg.deprecated !== "string") {
+					inlineMeta.push("(deprecated)");
+					styledInlineMeta.push(styler.meta("(deprecated)"));
+				}
+				if (hasDefault(arg.default)) {
+					const text = `(default: ${String(arg.default)})`;
+					inlineMeta.push(text);
+					styledInlineMeta.push(styler.meta(text));
+				}
+				if (arg.enum) {
+					const text = `(choices: ${arg.enum.join(", ")})`;
+					inlineMeta.push(text);
+					styledInlineMeta.push(styler.meta(text));
+				}
+				const descPlain = arg.description ?? "";
+				const styledDesc = descPlain ? isDeprecated ? styler.deprecated(descPlain) : styler.description(descPlain) : "";
+				const metaStyled = join(styledInlineMeta);
+				if (argAvailWidth && argAvailWidth > 0) if ([descPlain, inlineMeta.join(" ")].filter(Boolean).join(" ").length <= argAvailWidth) lines.push(prefix + [styledDesc, metaStyled].filter(Boolean).join(" "));
+				else if (!descPlain || descPlain.length <= argAvailWidth) {
+					lines.push(prefix + styledDesc);
+					if (metaStyled) lines.push(descColPad + metaStyled);
+				} else {
+					const wrapped = wrapText(descPlain, argAvailWidth);
+					const styleFn = isDeprecated ? styler.deprecated : styler.description;
+					lines.push(prefix + styleFn(wrapped[0]));
+					for (const wline of wrapped.slice(1)) lines.push(descColPad + styleFn(wline));
+					if (metaStyled) lines.push(descColPad + metaStyled);
+				}
+				else {
+					const descParts = [];
+					if (styledDesc) descParts.push(styledDesc);
+					lines.push(prefix + join(descParts));
+					if (styledInlineMeta.length > 0) lines.push(indent(3) + metaStyled);
+				}
+				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(contPad + 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(contPad + 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);
+	} };
+}
+/**
+* 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, width, terminal, env) {
+	if (detail === "minimal") return createMinimalFormatter();
+	if (format === "json") return createJsonFormatter();
+	const tw = format === "markdown" || format === "html" ? void 0 : width ?? terminal?.columns ?? 80;
+	if (format === "ansi" || format === "auto" && shouldUseAnsi(env, terminal?.isTTY)) return createGenericFormatter(createAnsiStyler(theme), createTextLayout(), all, tw);
+	if (format === "console") return createGenericFormatter(createConsoleStyler(theme), createTextLayout(), all, tw);
+	if (format === "markdown") return createGenericFormatter(createMarkdownStyler(), createMarkdownLayout(), all);
+	if (format === "html") return createGenericFormatter(createHtmlStyler(), createHtmlLayout(), all);
+	return createGenericFormatter(createTextStyler(), createTextLayout(), all, tw);
+}
+//#endregion
+export { createFormatter };
+
+//# sourceMappingURL=formatter.mjs.map