politty 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -278,6 +278,35 @@ declare const logger: {
   debug(message: string): void;
 };
 //#endregion
+//#region src/output/markdown-renderer.d.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)
+ */
+declare function renderInline(text: string): string;
+/**
+ * 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
+ */
+declare function renderMarkdown(markdown: string): string;
+//#endregion
 //#region src/parser/argv-parser.d.ts
 /**
  * Parsed arguments result
@@ -474,5 +503,5 @@ type ValidationResult<T> = {
  */
 declare function formatValidationErrors(errors: ValidationError[]): string;
 //#endregion
-export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, DuplicateAliasError, DuplicateFieldError, type Example, type ExtractedFields, type HelpOptions, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, arg, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateHelp, getUnknownKeysMode, isColorEnabled, logger, parseArgv, runCommand, runMain, setColorEnabled, styles, symbols, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases };
+export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, DuplicateAliasError, DuplicateFieldError, type Example, type ExtractedFields, type HelpOptions, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, arg, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateHelp, getUnknownKeysMode, isColorEnabled, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}

package/dist/index.d.ts

@@ -278,6 +278,35 @@ declare const logger: {
   debug(message: string): void;
 };
 //#endregion
+//#region src/output/markdown-renderer.d.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)
+ */
+declare function renderInline(text: string): string;
+/**
+ * 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
+ */
+declare function renderMarkdown(markdown: string): string;
+//#endregion
 //#region src/parser/argv-parser.d.ts
 /**
  * Parsed arguments result
@@ -474,5 +503,5 @@ type ValidationResult<T> = {
  */
 declare function formatValidationErrors(errors: ValidationError[]): string;
 //#endregion
-export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, DuplicateAliasError, DuplicateFieldError, type Example, type ExtractedFields, type HelpOptions, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, arg, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateHelp, getUnknownKeysMode, isColorEnabled, logger, parseArgv, runCommand, runMain, setColorEnabled, styles, symbols, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases };
+export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, DuplicateAliasError, DuplicateFieldError, type Example, type ExtractedFields, type HelpOptions, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, arg, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateHelp, getUnknownKeysMode, isColorEnabled, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a as arg, i as toKebabCase, r as getUnknownKeysMode, t as extractFields } from "./schema-extractor-D0q5Fj2R.js";
-import { t as defineCommand } from "./command-DCpFEZFM.js";
-import { _ as logger, a as formatCommandValidationErrors, b as symbols, c as validateDuplicateFields, d as DuplicateAliasError, f as DuplicateFieldError, g as isColorEnabled, h as generateHelp, i as parseArgv, l as validatePositionalConfig, m as ReservedAliasError, n as runMain, o as validateCommand, p as PositionalConfigError, r as formatValidationErrors, s as validateDuplicateAliases, t as runCommand, u as validateReservedAliases, v as setColorEnabled, y as styles } from "./runner-CyxuNkT1.js";
+import { C as symbols, S as styles, _ as renderInline, a as parseArgv, b as logger, c as validateDuplicateAliases, d as validateReservedAliases, f as DuplicateAliasError, g as generateHelp, h as ReservedAliasError, i as formatValidationErrors, l as validateDuplicateFields, m as PositionalConfigError, n as runMain, o as formatCommandValidationErrors, p as DuplicateFieldError, s as validateCommand, t as runCommand, u as validatePositionalConfig, v as renderMarkdown, x as setColorEnabled, y as isColorEnabled } from "./runner-CUN50BqK.js";
+import { a as arg, i as toKebabCase, r as getUnknownKeysMode, t as extractFields } from "./schema-extractor-1YXqFSDT.js";
+import { t as defineCommand } from "./command-D-P2Pc3J.js";
 
-export { DuplicateAliasError, DuplicateFieldError, PositionalConfigError, ReservedAliasError, arg, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateHelp, getUnknownKeysMode, isColorEnabled, logger, parseArgv, runCommand, runMain, setColorEnabled, styles, symbols, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases };
+export { DuplicateAliasError, DuplicateFieldError, PositionalConfigError, ReservedAliasError, arg, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateHelp, getUnknownKeysMode, isColorEnabled, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases };

package/dist/{runner-ttyvfYGi.cjs → runner-B38UBqhv.cjs}

@@ -141,7 +141,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"),
@@ -189,6 +189,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
 /**
@@ -454,17 +759,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}`);
@@ -487,8 +790,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
@@ -1149,6 +1455,10 @@ function formatValidationErrors(errors) {
 
 //#endregion
 //#region src/core/runner.ts
+var runner_exports = /* @__PURE__ */ require_docs_index.__exportAll({
+	runCommand: () => runCommand,
+	runMain: () => runMain
+});
 /**
 * Default logger using console
 */
@@ -1429,6 +1739,18 @@ Object.defineProperty(exports, 'parseArgv', {
     return parseArgv;
   }
 });
+Object.defineProperty(exports, 'renderInline', {
+  enumerable: true,
+  get: function () {
+    return renderInline;
+  }
+});
+Object.defineProperty(exports, 'renderMarkdown', {
+  enumerable: true,
+  get: function () {
+    return renderMarkdown;
+  }
+});
 Object.defineProperty(exports, 'runCommand', {
   enumerable: true,
   get: function () {
@@ -1441,6 +1763,12 @@ Object.defineProperty(exports, 'runMain', {
     return runMain;
   }
 });
+Object.defineProperty(exports, 'runner_exports', {
+  enumerable: true,
+  get: function () {
+    return runner_exports;
+  }
+});
 Object.defineProperty(exports, 'setColorEnabled', {
   enumerable: true,
   get: function () {
@@ -1489,4 +1817,4 @@ Object.defineProperty(exports, 'validateReservedAliases', {
     return validateReservedAliases;
   }
 });
-//# sourceMappingURL=runner-ttyvfYGi.cjs.map
+//# sourceMappingURL=runner-B38UBqhv.cjs.map