politty 0.2.0 → 0.2.2

package/dist/{runner-CyxuNkT1.js → runner-CUN50BqK.js}

@@ -1,8 +1,25 @@
-import { n as getExtractedFields, t as extractFields } from "./schema-extractor-D0q5Fj2R.js";
-import { a as emptyLogs, i as createLogCollector, n as resolveLazyCommand, o as mergeLogs, r as resolveSubcommand, t as listSubCommands } from "./subcommand-router-D9QSLX56.js";
+import { n as getExtractedFields, t as extractFields } from "./schema-extractor-1YXqFSDT.js";
+import { a as emptyLogs, i as createLogCollector, n as resolveLazyCommand, o as mergeLogs, r as resolveSubcommand, t as listSubCommands } from "./subcommand-router-DtCeT_O9.js";
 import { z } from "zod";
 import { styleText } from "node:util";
 
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
 //#region src/executor/command-runner.ts
 /**
 * Execute a command lifecycle: setup → run → cleanup
@@ -140,7 +157,7 @@ const styles = {
 	white: createStyleFn("white"),
 	gray: createStyleFn("gray"),
 	command: createStyleFn("bold"),
-	commandName: createStyleFn("bold", "cyan"),
+	commandName: createStyleFn("bold", "underline", "cyan"),
 	option: createStyleFn("cyan"),
 	optionName: createStyleFn("bold"),
 	placeholder: createStyleFn("dim"),
@@ -188,6 +205,311 @@ const logger = {
 	}
 };
 
+//#endregion
+//#region src/output/markdown-renderer.ts
+/**
+* Lightweight Markdown-to-terminal renderer.
+*
+* Supports a subset of Markdown tailored for CLI help notes:
+* - Inline: bold, italic, inline code, links
+* - Block: paragraphs, unordered/ordered lists, blockquotes, headings,
+*          horizontal rules, fenced code blocks
+*/
+/**
+* Apply inline Markdown formatting to a string.
+*
+* Processing order matters to avoid conflicts:
+*   1. Inline code (backticks) — content inside is literal, no further processing
+*   2. Bold (**text**)
+*   3. Italic (*text* or _text_)
+*   4. Links [text](url)
+*/
+function renderInline(text) {
+	const codeSpans = [];
+	let result = text.replace(/`([^`]+)`/g, (_match, code) => {
+		const index = codeSpans.length;
+		codeSpans.push(styles.cyan(code));
+		return `\x00CODE${index}\x00`;
+	});
+	result = result.replace(/\*\*(.+?)\*\*/g, (_match, content) => styles.bold(content));
+	result = result.replace(/__(.+?)__/g, (_match, content) => styles.bold(content));
+	result = result.replace(/\*(.+?)\*/g, (_match, content) => styles.italic(content));
+	result = result.replace(/(?<!\w)_(.+?)_(?!\w)/g, (_match, content) => styles.italic(content));
+	result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, linkText, url) => `${styles.underline(linkText)} ${styles.dim(`(${url})`)}`);
+	result = result.replace(/\x00CODE(\d+)\x00/g, (_match, index) => codeSpans[Number(index)]);
+	return result;
+}
+/**
+* Render a Markdown string to styled terminal output.
+*
+* Block-level processing:
+*   - Splits input into blocks separated by blank lines
+*   - Detects headings, horizontal rules, blockquotes, lists, code blocks, and paragraphs
+*   - Applies inline formatting within each block
+*/
+function renderMarkdown(markdown) {
+	return splitIntoBlocks(markdown.split("\n")).map(renderBlock).join("\n\n");
+}
+const HEADING_RE = /^(#{1,6})\s+(.+)$/;
+const HR_RE = /^(?:---+|\*\*\*+|___+)\s*$/;
+const BLOCKQUOTE_RE = /^>\s?(.*)$/;
+const UL_RE = /^-\s+(.+)$/;
+const OL_RE = /^(\d+)[.)]\s+(.+)$/;
+const FENCE_OPEN_RE = /^(`{3,}|~{3,})(\S*)\s*$/;
+const ALERT_RE = /^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/;
+const TABLE_ROW_RE = /^\|(.+)\|$/;
+const TABLE_SEP_RE = /^\|(\s*:?-+:?\s*\|)+$/;
+/**
+* Split lines into logical blocks separated by blank lines.
+* Consecutive lines of the same block type are grouped together.
+*/
+function splitIntoBlocks(lines) {
+	const blocks = [];
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i];
+		if (line.trim() === "") {
+			i++;
+			continue;
+		}
+		const fenceMatch = line.match(FENCE_OPEN_RE);
+		if (fenceMatch) {
+			const fence = fenceMatch[1];
+			const lang = fenceMatch[2] ?? "";
+			const codeLines = [];
+			i++;
+			while (i < lines.length) {
+				if (lines[i].startsWith(fence.charAt(0).repeat(fence.length)) && lines[i].trim() === fence.charAt(0).repeat(Math.max(fence.length, lines[i].trim().length))) {
+					i++;
+					break;
+				}
+				codeLines.push(lines[i]);
+				i++;
+			}
+			blocks.push({
+				type: "code",
+				lang,
+				lines: codeLines
+			});
+			continue;
+		}
+		const headingMatch = line.match(HEADING_RE);
+		if (headingMatch) {
+			blocks.push({
+				type: "heading",
+				level: headingMatch[1].length,
+				content: headingMatch[2]
+			});
+			i++;
+			continue;
+		}
+		if (HR_RE.test(line)) {
+			blocks.push({ type: "hr" });
+			i++;
+			continue;
+		}
+		if (BLOCKQUOTE_RE.test(line)) {
+			const bqLines = [];
+			while (i < lines.length) {
+				const bqMatch = lines[i].match(BLOCKQUOTE_RE);
+				if (bqMatch) {
+					bqLines.push(bqMatch[1]);
+					i++;
+				} else break;
+			}
+			if (bqLines.length > 0) {
+				const alertMatch = bqLines[0].match(ALERT_RE);
+				if (alertMatch) {
+					const contentLines = bqLines.slice(1).filter((l) => l !== "");
+					blocks.push({
+						type: "alert",
+						alertType: alertMatch[1],
+						lines: contentLines
+					});
+					continue;
+				}
+			}
+			blocks.push({
+				type: "blockquote",
+				lines: bqLines
+			});
+			continue;
+		}
+		if (UL_RE.test(line)) {
+			const items = [];
+			while (i < lines.length) {
+				const ulMatch = lines[i].match(UL_RE);
+				if (ulMatch) {
+					items.push(ulMatch[1]);
+					i++;
+				} else break;
+			}
+			blocks.push({
+				type: "ul",
+				items
+			});
+			continue;
+		}
+		const olMatch = line.match(OL_RE);
+		if (olMatch) {
+			const start = Number(olMatch[1]);
+			const items = [];
+			while (i < lines.length) {
+				const match = lines[i].match(OL_RE);
+				if (match) {
+					items.push(match[2]);
+					i++;
+				} else break;
+			}
+			blocks.push({
+				type: "ol",
+				items,
+				start
+			});
+			continue;
+		}
+		if (TABLE_ROW_RE.test(line) && i + 1 < lines.length && TABLE_SEP_RE.test(lines[i + 1])) {
+			const headers = parseCells(line);
+			const alignments = parseAlignments(lines[i + 1]);
+			i += 2;
+			const rows = [];
+			while (i < lines.length && TABLE_ROW_RE.test(lines[i])) {
+				rows.push(parseCells(lines[i]));
+				i++;
+			}
+			blocks.push({
+				type: "table",
+				headers,
+				alignments,
+				rows
+			});
+			continue;
+		}
+		const paraLines = [];
+		while (i < lines.length) {
+			const l = lines[i];
+			if (l.trim() === "" || HEADING_RE.test(l) || HR_RE.test(l) || BLOCKQUOTE_RE.test(l) || UL_RE.test(l) || OL_RE.test(l) || FENCE_OPEN_RE.test(l) || TABLE_ROW_RE.test(l) && i + 1 < lines.length && TABLE_SEP_RE.test(lines[i + 1])) break;
+			paraLines.push(l);
+			i++;
+		}
+		if (paraLines.length > 0) blocks.push({
+			type: "paragraph",
+			lines: paraLines
+		});
+	}
+	return blocks;
+}
+/**
+* Parse cells from a table row: `| a | b | c |` → `["a", "b", "c"]`
+*/
+function parseCells(row) {
+	return row.slice(1, -1).split("|").map((cell) => cell.trim());
+}
+/**
+* Parse alignment from separator row: `|:---|:---:|---:|` → `["left", "center", "right"]`
+*/
+function parseAlignments(sepRow) {
+	return sepRow.slice(1, -1).split("|").map((cell) => {
+		const trimmed = cell.trim();
+		if (trimmed.startsWith(":") && trimmed.endsWith(":")) return "center";
+		if (trimmed.endsWith(":")) return "right";
+		return "left";
+	});
+}
+/**
+* Pad a string to a given width with the specified alignment.
+*/
+function alignText(text, width, alignment) {
+	if (alignment === "right") return text.padStart(width);
+	if (alignment === "center") {
+		const total = width - text.length;
+		const left = Math.floor(total / 2);
+		return " ".repeat(left) + text + " ".repeat(total - left);
+	}
+	return text.padEnd(width);
+}
+/**
+* Style configuration for GitHub-style alert blocks.
+*/
+const alertStyles = {
+	NOTE: {
+		icon: "ℹ",
+		label: "Note",
+		styleFn: styles.cyan
+	},
+	TIP: {
+		icon: "💡",
+		label: "Tip",
+		styleFn: styles.green
+	},
+	IMPORTANT: {
+		icon: "❗",
+		label: "Important",
+		styleFn: styles.magenta
+	},
+	WARNING: {
+		icon: "⚠",
+		label: "Warning",
+		styleFn: styles.yellow
+	},
+	CAUTION: {
+		icon: "🔴",
+		label: "Caution",
+		styleFn: styles.red
+	}
+};
+/**
+* Render a single block to styled terminal output.
+*/
+function renderBlock(block) {
+	switch (block.type) {
+		case "heading": return styles.green(styles.bold(renderInline(block.content)));
+		case "hr": return styles.dim("─".repeat(40));
+		case "blockquote": {
+			const prefix = styles.dim("│ ");
+			return block.lines.map((line) => `${prefix}${renderInline(line)}`).join("\n");
+		}
+		case "alert": {
+			const { icon, label, styleFn } = alertStyles[block.alertType];
+			const prefix = styleFn(styles.bold("│")) + " ";
+			const header = `${prefix}${styleFn(icon)} ${styleFn(label)}`;
+			if (block.lines.length === 0) return header;
+			return `${header}\n${block.lines.map((line) => `${prefix}${renderInline(line)}`).join("\n")}`;
+		}
+		case "ul": return block.items.map((item) => `${styles.dim("•")} ${renderInline(item)}`).join("\n");
+		case "ol": {
+			const maxNum = block.start + block.items.length - 1;
+			const width = String(maxNum).length;
+			return block.items.map((item, i) => {
+				const num = String(block.start + i).padStart(width, " ");
+				return `${styles.dim(`${num}.`)} ${renderInline(item)}`;
+			}).join("\n");
+		}
+		case "table": {
+			const colCount = block.headers.length;
+			const colWidths = block.headers.map((h, i) => {
+				const cellLengths = block.rows.map((row) => (row[i] ?? "").length);
+				return Math.max(h.length, ...cellLengths);
+			});
+			const pipe = styles.dim("│");
+			const topBorder = styles.dim(`┌─${colWidths.map((w) => "─".repeat(w)).join("─┬─")}─┐`);
+			const midBorder = styles.dim(`├─${colWidths.map((w) => "─".repeat(w)).join("─┼─")}─┤`);
+			const botBorder = styles.dim(`└─${colWidths.map((w) => "─".repeat(w)).join("─┴─")}─┘`);
+			return [
+				topBorder,
+				`${pipe} ${block.headers.map((h, i) => styles.bold(alignText(h, colWidths[i], block.alignments[i] ?? "left"))).join(` ${pipe} `)} ${pipe}`,
+				midBorder,
+				...block.rows.map((row) => {
+					return `${pipe} ${Array.from({ length: colCount }, (_, i) => renderInline(alignText(row[i] ?? "", colWidths[i], block.alignments[i] ?? "left"))).join(` ${pipe} `)} ${pipe}`;
+				}),
+				botBorder
+			].join("\n");
+		}
+		case "code": return block.lines.map((line) => `  ${styles.yellow(line)}`).join("\n");
+		case "paragraph": return renderInline(block.lines.join(" "));
+	}
+}
+
 //#endregion
 //#region src/output/help-generator.ts
 /**
@@ -453,17 +775,15 @@ function renderSubcommandsWithOptions(subCommands, parentPath, baseIndent) {
 function generateHelp(command, options) {
 	const sections = [];
 	const context = options.context;
-	const headerLines = [];
 	const displayName = buildFullCommandName(command, context);
 	if (displayName) {
 		let header = styles.commandName(displayName);
 		if (context?.rootName && context.commandPath && context.commandPath.length > 0) if (context.rootVersion) header += ` ${styles.version(`(${context.rootName} v${context.rootVersion})`)}`;
 		else header += ` ${styles.version(`(${context.rootName})`)}`;
 		else if (context?.rootVersion) header += ` ${styles.version(`v${context.rootVersion}`)}`;
-		headerLines.push(header);
+		sections.push(header);
 	}
-	if (command.description) headerLines.push(command.description);
-	if (headerLines.length > 0) sections.push(headerLines.join("\n"));
+	if (command.description) sections.push(command.description);
 	sections.push(`${styles.sectionHeader("Usage:")} ${renderUsageLine(command, context)}`);
 	const optionsText = renderOptions(command, options.descriptions, context);
 	if (optionsText) sections.push(`${styles.sectionHeader("Options:")}\n${optionsText}`);
@@ -486,8 +806,11 @@ function generateHelp(command, options) {
 		const exampleLines = renderExamplesForHelp(command.examples, context);
 		sections.push(`${styles.sectionHeader("Examples:")}\n${exampleLines}`);
 	}
-	if (command.notes) sections.push(`${styles.sectionHeader("Notes:")}\n${command.notes}`);
-	return sections.join("\n\n");
+	if (command.notes) {
+		const indented = renderMarkdown(command.notes).split("\n").map((line) => line === "" ? "" : `  ${line}`).join("\n");
+		sections.push(`${styles.sectionHeader("Notes:")}\n${indented}`);
+	}
+	return `\n${sections.join("\n\n")}\n`;
 }
 /**
 * Render examples for CLI help output
@@ -1148,6 +1471,10 @@ function formatValidationErrors(errors) {
 
 //#endregion
 //#region src/core/runner.ts
+var runner_exports = /* @__PURE__ */ __exportAll({
+	runCommand: () => runCommand,
+	runMain: () => runMain
+});
 /**
 * Default logger using console
 */
@@ -1368,5 +1695,5 @@ async function runCommandInternal(command, argv, options = {}) {
 }
 
 //#endregion
-export { logger as _, formatCommandValidationErrors as a, symbols as b, validateDuplicateFields as c, DuplicateAliasError as d, DuplicateFieldError as f, isColorEnabled as g, generateHelp as h, parseArgv as i, validatePositionalConfig as l, ReservedAliasError as m, runMain as n, validateCommand as o, PositionalConfigError as p, formatValidationErrors as r, validateDuplicateAliases as s, runCommand as t, validateReservedAliases as u, setColorEnabled as v, styles as y };
-//# sourceMappingURL=runner-CyxuNkT1.js.map
+export { symbols as C, styles as S, renderInline as _, parseArgv as a, logger as b, validateDuplicateAliases as c, validateReservedAliases as d, DuplicateAliasError as f, generateHelp as g, ReservedAliasError as h, formatValidationErrors as i, validateDuplicateFields as l, PositionalConfigError as m, runMain as n, formatCommandValidationErrors as o, DuplicateFieldError as p, runner_exports as r, validateCommand as s, runCommand as t, validatePositionalConfig as u, renderMarkdown as v, setColorEnabled as x, isColorEnabled as y };
+//# sourceMappingURL=runner-CUN50BqK.js.map