politty 0.4.14 → 0.4.16

package/dist/docs/index.d.cts

@@ -1,4 +1,4 @@
-import { N as SubCommandValue, R as ExtractedFields, h as Example, l as AnyCommand, u as ArgsSchema, z as ResolvedFieldMeta } from "../arg-registry-r5wYN6qd.cjs";
+import { N as SubCommandValue, R as ExtractedFields, h as Example, l as AnyCommand, u as ArgsSchema, z as ResolvedFieldMeta } from "../arg-registry-MVWOAcvw.cjs";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -66,6 +66,8 @@ interface CommandInfo {
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names (aliases) for this command */
+  aliases?: string[] | undefined;
   /** Full command path (e.g., "my-cli config get") */
   fullCommandPath: string;
   /** Command path relative to root (e.g., "" for root, "config" for subcommand) */
@@ -105,6 +107,8 @@ interface SubCommandInfo {
   name: string;
   /** Subcommand description */
   description?: string | undefined;
+  /** Alternative names (aliases) for this subcommand */
+  aliases?: string[] | undefined;
   /** Full command path */
   fullPath: string[];
 }

package/dist/docs/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}

package/dist/docs/index.d.ts

@@ -1,4 +1,4 @@
-import { N as SubCommandValue, R as ExtractedFields, h as Example, l as AnyCommand, u as ArgsSchema, z as ResolvedFieldMeta } from "../arg-registry-CkPDokIu.js";
+import { N as SubCommandValue, R as ExtractedFields, h as Example, l as AnyCommand, u as ArgsSchema, z as ResolvedFieldMeta } from "../arg-registry-Cd6xnjHa.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -66,6 +66,8 @@ interface CommandInfo {
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names (aliases) for this command */
+  aliases?: string[] | undefined;
   /** Full command path (e.g., "my-cli config get") */
   fullCommandPath: string;
   /** Command path relative to root (e.g., "" for root, "config" for subcommand) */
@@ -105,6 +107,8 @@ interface SubCommandInfo {
   name: string;
   /** Subcommand description */
   description?: string | undefined;
+  /** Alternative names (aliases) for this subcommand */
+  aliases?: string[] | undefined;
   /** Full command path */
   fullPath: string[];
 }

package/dist/docs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}

package/dist/docs/index.js

@@ -1,9 +1,10 @@
-import { i as extractFields, o as getExtractedFields } from "../lazy-DiMJSDMB.js";
-import { i as createLogCollector, n as resolveLazyCommand } from "../subcommand-router--EUt6ftA.js";
+import { d as getExtractedFields, l as extractFields, r as resolveLazyCommand } from "../subcommand-router-XZBWe8HN.js";
+import { t as createLogCollector } from "../log-collector-Cu6MCtAx.js";
 import { z } from "zod";
-import { isDeepStrictEqual } from "node:util";
 import * as fs from "node:fs";
-import * as path from "node:path";
+import * as path$1 from "node:path";
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
 
 //#region src/docs/types.ts
 /**
@@ -111,6 +112,13 @@ function escapeTableCell$2(str) {
 	return str.replace(/\|/g, "\\|").replace(/\n/g, " ");
 }
 /**
+* Marker appended to a custom negation row/line so readers can see which
+* positive flag it negates (e.g. `--monochrome` → `(↔ \`--color\`)`).
+*/
+function negationRelationMarker(opt) {
+	return `(↔ \`--${opt.cliName}\`)`;
+}
+/**
 * Format default value for display
 */
 function formatDefaultValue$1(value) {
@@ -171,25 +179,39 @@ function resolvePlaceholder(opt) {
 }
 /**
 * Format option name for table display (e.g., `--dry-run` or `--port <PORT>`)
+*
+* Boolean fields with a custom inline `negation` (no separate description) are
+* shown as `\`--cache\` / \`--disable-cache\``.
 */
 function formatOptionName(opt) {
 	const placeholder = resolvePlaceholder(opt);
-	return opt.type === "boolean" ? `\`--${opt.cliName}\`` : `\`--${opt.cliName} <${placeholder}>\``;
+	if (opt.type === "boolean") {
+		const positive = `\`--${opt.cliName}\``;
+		if (opt.negationDisplay && !opt.negationDescription) return `${positive} / \`--${opt.negationDisplay}\``;
+		return positive;
+	}
+	return `\`--${opt.cliName} <${placeholder}>\``;
 }
 /**
-* Format option flags for list display (uses kebab-case cliName)
+* Format option flags for list display (uses kebab-case cliName).
+* Aliases are joined with `, `; the inline negation (when no separate
+* `negationDescription` is set) is appended with ` / ` so it stays
+* visually distinct from aliases, matching help and table output.
 */
 function formatOptionFlags(opt) {
 	const placeholder = resolvePlaceholder(opt);
 	const longFlag = opt.type === "boolean" ? `--${opt.cliName}` : `--${opt.cliName} <${placeholder}>`;
-	if (!opt.alias || opt.alias.length === 0) return `\`${longFlag}\``;
-	const shortParts = opt.alias.filter((a) => a.length === 1).map((a) => `\`-${a}\``);
-	const longParts = opt.alias.filter((a) => a.length > 1).map((a) => `\`--${a}\``);
-	return [
-		...shortParts,
-		`\`${longFlag}\``,
-		...longParts
-	].join(", ");
+	const parts = [];
+	if (opt.alias) {
+		for (const a of opt.alias) if (a.length === 1) parts.push(`\`-${a}\``);
+	}
+	parts.push(`\`${longFlag}\``);
+	if (opt.alias) {
+		for (const a of opt.alias) if (a.length > 1) parts.push(`\`--${a}\``);
+	}
+	const aliasJoined = parts.join(", ");
+	if (opt.type === "boolean" && opt.negationDisplay && !opt.negationDescription) return `${aliasJoined} / \`--${opt.negationDisplay}\``;
+	return aliasJoined;
 }
 /**
 * Format aliases for a markdown table cell
@@ -241,6 +263,12 @@ function renderOptionsTable(info) {
 			const envNames = formatEnvNames(opt.env);
 			lines.push(`| ${optionName} | ${alias} | ${desc} | ${required} | ${defaultVal} | ${envNames} |`);
 		} else lines.push(`| ${optionName} | ${alias} | ${desc} | ${required} | ${defaultVal} |`);
+		if (opt.type === "boolean" && opt.negationDisplay && opt.negationDescription) {
+			const negName = `\`--${opt.negationDisplay}\``;
+			const negDesc = `${escapeTableCell$2(opt.negationDescription)} ${negationRelationMarker(opt)}`;
+			if (hasEnv) lines.push(`| ${negName} | - | ${negDesc} | ${required} | - | - |`);
+			else lines.push(`| ${negName} | - | ${negDesc} | ${required} | - |`);
+		}
 	}
 	return lines.join("\n");
 }
@@ -265,6 +293,7 @@ function renderOptionsList(info) {
 		const defaultVal = opt.defaultValue !== void 0 ? ` (default: ${JSON.stringify(opt.defaultValue)})` : "";
 		const envInfo = formatEnvInfo(opt.env);
 		lines.push(`- ${flags}${desc}${required}${defaultVal}${envInfo}`);
+		if (opt.type === "boolean" && opt.negationDisplay && opt.negationDescription) lines.push(`- \`--${opt.negationDisplay}\` - ${opt.negationDescription} ${negationRelationMarker(opt)}`);
 	}
 	return lines.join("\n");
 }
@@ -275,40 +304,19 @@ function generateAnchor$1(commandPath) {
 	return commandPath.join("-").toLowerCase();
 }
 /**
-* Generate relative path from one file to another
+* Generate relative path from one file to another.
+* Always emits forward slashes so Markdown links remain portable across OSes.
 */
 function getRelativePath(from, to) {
-	const fromParts = from.split("/").slice(0, -1);
-	const toParts = to.split("/");
-	let commonLength = 0;
-	while (commonLength < fromParts.length && commonLength < toParts.length - 1 && fromParts[commonLength] === toParts[commonLength]) commonLength++;
-	const upCount = fromParts.length - commonLength;
-	return [...Array(upCount).fill(".."), ...toParts.slice(commonLength)].join("/") || (toParts[toParts.length - 1] ?? "");
+	const fromPosix = from.replace(/\\/g, "/");
+	const toPosix = to.replace(/\\/g, "/");
+	return path.posix.relative(path.posix.dirname(fromPosix), toPosix);
 }
 /**
 * Render subcommands as table
 */
 function renderSubcommandsTable(info, generateAnchors = true) {
-	if (info.subCommands.length === 0) return "";
-	const lines = [];
-	lines.push("| Command | Description |");
-	lines.push("|---------|-------------|");
-	const currentFile = info.filePath;
-	const fileMap = info.fileMap;
-	for (const sub of info.subCommands) {
-		const fullName = sub.fullPath.join(" ");
-		const desc = escapeTableCell$2(sub.description ?? "");
-		const subCommandPath = sub.fullPath.join(" ");
-		if (generateAnchors) {
-			const anchor = generateAnchor$1(sub.fullPath);
-			const subFile = fileMap?.[subCommandPath];
-			if (currentFile && subFile && currentFile !== subFile) {
-				const relativePath = getRelativePath(currentFile, subFile);
-				lines.push(`| [\`${fullName}\`](${relativePath}#${anchor}) | ${desc} |`);
-			} else lines.push(`| [\`${fullName}\`](#${anchor}) | ${desc} |`);
-		} else lines.push(`| \`${fullName}\` | ${desc} |`);
-	}
-	return lines.join("\n");
+	return renderSubcommandsTableFromArray(info.subCommands, info, generateAnchors);
 }
 /**
 * Render options from array as table
@@ -334,6 +342,12 @@ function renderOptionsTableFromArray(options) {
 			const envNames = formatEnvNames(opt.env);
 			lines.push(`| ${optionName} | ${alias} | ${desc} | ${required} | ${defaultVal} | ${envNames} |`);
 		} else lines.push(`| ${optionName} | ${alias} | ${desc} | ${required} | ${defaultVal} |`);
+		if (opt.type === "boolean" && opt.negationDisplay && opt.negationDescription) {
+			const negName = `\`--${opt.negationDisplay}\``;
+			const negDesc = `${escapeTableCell$2(opt.negationDescription)} ${negationRelationMarker(opt)}`;
+			if (hasEnv) lines.push(`| ${negName} | - | ${negDesc} | ${required} | - | - |`);
+			else lines.push(`| ${negName} | - | ${negDesc} | ${required} | - |`);
+		}
 	}
 	return lines.join("\n");
 }
@@ -415,6 +429,7 @@ function renderOptionsListFromArray(options) {
 		const defaultVal = opt.defaultValue !== void 0 ? ` (default: ${JSON.stringify(opt.defaultValue)})` : "";
 		const envInfo = formatEnvInfo(opt.env);
 		lines.push(`- ${flags}${desc}${required}${defaultVal}${envInfo}`);
+		if (opt.type === "boolean" && opt.negationDisplay && opt.negationDescription) lines.push(`- \`--${opt.negationDisplay}\` - ${opt.negationDescription} ${negationRelationMarker(opt)}`);
 	}
 	return lines.join("\n");
 }
@@ -451,23 +466,31 @@ function renderArgumentsListFromArray(args) {
 */
 function renderSubcommandsTableFromArray(subcommands, info, generateAnchors = true) {
 	if (subcommands.length === 0) return "";
+	const hasAliases = subcommands.some((s) => s.aliases && s.aliases.length > 0);
 	const lines = [];
-	lines.push("| Command | Description |");
-	lines.push("|---------|-------------|");
+	if (hasAliases) {
+		lines.push("| Command | Aliases | Description |");
+		lines.push("|---------|---------|-------------|");
+	} else {
+		lines.push("| Command | Description |");
+		lines.push("|---------|-------------|");
+	}
 	const currentFile = info.filePath;
 	const fileMap = info.fileMap;
 	for (const sub of subcommands) {
 		const fullName = sub.fullPath.join(" ");
 		const desc = escapeTableCell$2(sub.description ?? "");
 		const subCommandPath = sub.fullPath.join(" ");
+		const aliasCell = hasAliases ? sub.aliases && sub.aliases.length > 0 ? sub.aliases.map((a) => `\`${escapeTableCell$2(a)}\``).join(", ") : "-" : "";
+		let cmdCell;
 		if (generateAnchors) {
 			const anchor = generateAnchor$1(sub.fullPath);
 			const subFile = fileMap?.[subCommandPath];
-			if (currentFile && subFile && currentFile !== subFile) {
-				const relativePath = getRelativePath(currentFile, subFile);
-				lines.push(`| [\`${fullName}\`](${relativePath}#${anchor}) | ${desc} |`);
-			} else lines.push(`| [\`${fullName}\`](#${anchor}) | ${desc} |`);
-		} else lines.push(`| \`${fullName}\` | ${desc} |`);
+			if (currentFile && subFile && currentFile !== subFile) cmdCell = `[\`${fullName}\`](${getRelativePath(currentFile, subFile)}#${anchor})`;
+			else cmdCell = `[\`${fullName}\`](#${anchor})`;
+		} else cmdCell = `\`${fullName}\``;
+		if (hasAliases) lines.push(`| ${cmdCell} | ${aliasCell} | ${desc} |`);
+		else lines.push(`| ${cmdCell} | ${desc} |`);
 	}
 	return lines.join("\n");
 }
@@ -534,14 +557,19 @@ function createCommandRenderer(options = {}) {
 		const h = "#".repeat(effectiveLevel);
 		const title = info.commandPath || info.name;
 		sections.push(wrapWithMarker("heading", scope, `${h} ${title}`));
-		if (info.description) {
-			const context = {
-				content: info.description,
-				heading: "",
-				info
-			};
-			const content = customRenderDescription ? customRenderDescription(context) : context.content;
-			if (content) sections.push(wrapWithMarker("description", scope, content));
+		{
+			const parts = [];
+			if (info.description) parts.push(info.description);
+			if (info.aliases && info.aliases.length > 0) parts.push(`**Aliases:** ${info.aliases.map((a) => `\`${a}\``).join(", ")}`);
+			if (parts.length > 0) {
+				const context = {
+					content: parts.join("\n\n"),
+					heading: "",
+					info
+				};
+				const content = customRenderDescription ? customRenderDescription(context) : context.content;
+				if (content) sections.push(wrapWithMarker("description", scope, content));
+			}
 		}
 		{
 			const context = {
@@ -653,8 +681,11 @@ function createCommandRenderer(options = {}) {
 * Default renderers presets
 */
 const defaultRenderers = {
+	/** Standard command documentation */
 	command: (options) => createCommandRenderer(options),
+	/** Table style options (default) */
 	tableStyle: createCommandRenderer({ optionStyle: "table" }),
+	/** List style options */
 	listStyle: createCommandRenderer({ optionStyle: "list" })
 };
 
@@ -664,7 +695,7 @@ const defaultRenderers = {
 * Compare generated content with existing file
 */
 function compareWithExisting(generatedContent, filePath) {
-	const absolutePath = path.resolve(filePath);
+	const absolutePath = path$1.resolve(filePath);
 	if (!fs.existsSync(absolutePath)) return {
 		match: false,
 		fileExists: false
@@ -729,8 +760,8 @@ function formatDiff(expected, actual) {
 * Write content to file, creating directories if needed
 */
 function writeFile(filePath, content) {
-	const absolutePath = path.resolve(filePath);
-	const dir = path.dirname(absolutePath);
+	const absolutePath = path$1.resolve(filePath);
+	const dir = path$1.dirname(absolutePath);
 	if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 	fs.writeFileSync(absolutePath, content, "utf-8");
 }
@@ -739,7 +770,7 @@ function writeFile(filePath, content) {
 * Returns null if file does not exist
 */
 function readFile(filePath) {
-	const absolutePath = path.resolve(filePath);
+	const absolutePath = path$1.resolve(filePath);
 	if (!fs.existsSync(absolutePath)) return null;
 	return fs.readFileSync(absolutePath, "utf-8");
 }
@@ -749,7 +780,7 @@ function readFile(filePath) {
 * @param fileSystem - Optional fs implementation (useful when fs is mocked)
 */
 function deleteFile(filePath, fileSystem = fs) {
-	const absolutePath = path.resolve(filePath);
+	const absolutePath = path$1.resolve(filePath);
 	if (fileSystem.existsSync(absolutePath)) fileSystem.unlinkSync(absolutePath);
 }
 
@@ -769,12 +800,14 @@ async function buildCommandInfo(command, rootName, commandPath = []) {
 		subCommands.push({
 			name,
 			description: resolved.description,
+			aliases: resolved.aliases,
 			fullPath
 		});
 	}
 	return {
 		name: command.name ?? "",
 		description: command.description,
+		aliases: command.aliases,
 		fullCommandPath: commandPath.length > 0 ? `${rootName} ${commandPath.join(" ")}` : rootName,
 		commandPath: commandPath.join(" "),
 		depth: commandPath.length + 1,
@@ -838,7 +871,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await import("../runner-DSZw1AsW.js").then((n) => n.r);
+		const { runCommand } = await import("../runner-BHeCMEa5.js").then((n) => n.r);
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);
@@ -986,7 +1019,11 @@ function renderFilteredTable(options, columns) {
 		for (const col of columns) switch (col) {
 			case "option": {
 				const placeholder = opt.placeholder ?? opt.cliName.toUpperCase().replace(/-/g, "_");
-				const optionName = opt.type === "boolean" ? `\`--${opt.cliName}\`` : `\`--${opt.cliName} <${placeholder}>\``;
+				let optionName;
+				if (opt.type === "boolean") {
+					optionName = `\`--${opt.cliName}\``;
+					if (opt.negationDisplay && !opt.negationDescription) optionName += ` / \`--${opt.negationDisplay}\``;
+				} else optionName = `\`--${opt.cliName} <${placeholder}>\``;
 				cells.push(optionName);
 				break;
 			}
@@ -1009,6 +1046,26 @@ function renderFilteredTable(options, columns) {
 			}
 		}
 		lines.push(`| ${cells.join(" | ")} |`);
+		if (opt.type === "boolean" && opt.negationDisplay && opt.negationDescription) {
+			const negCells = [];
+			for (const col of columns) switch (col) {
+				case "option":
+					negCells.push(`\`--${opt.negationDisplay}\``);
+					break;
+				case "description":
+					negCells.push(`${escapeTableCell$1(opt.negationDescription)} ${negationRelationMarker(opt)}`);
+					break;
+				case "required":
+					negCells.push(opt.required ? "Yes" : "No");
+					break;
+				case "alias":
+				case "default":
+				case "env":
+					negCells.push("-");
+					break;
+			}
+			lines.push(`| ${negCells.join(" | ")} |`);
+		}
 	}
 	return lines.join("\n");
 }
@@ -1568,12 +1625,12 @@ function deriveIndexFromFiles(files, rootDocPath, allCommands, ignores) {
 	for (const [filePath, fileConfigRaw] of Object.entries(files)) {
 		const { commandPaths, topLevelCommands } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
 		if (commandPaths.length === 0) continue;
-		const docPath = "./" + path.relative(path.dirname(rootDocPath), filePath).replace(/\\/g, "/");
+		const docPath = "./" + path$1.relative(path$1.dirname(rootDocPath), filePath).replace(/\\/g, "/");
 		const firstCmdPath = commandPaths[0];
 		const cmdInfo = firstCmdPath !== void 0 ? allCommands.get(firstCmdPath) : void 0;
 		const fileConfig = Array.isArray(fileConfigRaw) ? void 0 : fileConfigRaw;
 		categories.push({
-			title: fileConfig?.title ?? cmdInfo?.name ?? path.basename(filePath, path.extname(filePath)),
+			title: fileConfig?.title ?? cmdInfo?.name ?? path$1.basename(filePath, path$1.extname(filePath)),
 			description: fileConfig?.description ?? cmdInfo?.description ?? "",
 			commands: topLevelCommands,
 			docPath
@@ -1649,7 +1706,7 @@ async function generateIndexSection(categories, command, scope, options) {
 * Normalize a doc file path for equivalence checks.
 */
 function normalizeDocPathForComparison(filePath) {
-	return path.resolve(filePath);
+	return path$1.resolve(filePath);
 }
 /**
 * Process global options marker in file content
@@ -2176,7 +2233,7 @@ async function generateDoc(config) {
 				if (globalOptionsResult.wasUpdated) markerUpdated = true;
 			}
 			const derivedCategories = deriveIndexFromFiles(files, rootDocFilePath, allCommands, ignores);
-			const indexScope = path.relative(process.cwd(), rootDocFilePath);
+			const indexScope = path$1.relative(process.cwd(), rootDocFilePath).replace(/\\/g, "/");
 			const indexResult = await processIndexMarker(content, derivedCategories, command, indexScope, updateMode, formatter, rootDoc.index);
 			content = indexResult.content;
 			rootDocDiffs.push(...indexResult.diffs);