politty 0.4.11 → 0.4.12

package/dist/{arg-registry-CHmAzJOM.d.ts → arg-registry-BlXeCM4p.d.cts}

@@ -204,6 +204,8 @@ interface MainOptions {
   setup?: ((context: GlobalSetupContext) => void | Promise<void>) | undefined;
   /** Global cleanup hook (runs after command execution, always executes even on error) */
   cleanup?: ((context: GlobalCleanupContext) => void | Promise<void>) | undefined;
+  /** Whether to display errors to stderr before process.exit (default: true) */
+  displayErrors?: boolean;
 }
 /**
  * Options for runCommand (programmatic/test usage)
@@ -456,4 +458,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { SubCommandValue as A, NonRunnableCommand as C, RunResultSuccess as D, RunResultFailure as E, LazyCommand as M, isLazyCommand as N, RunnableCommand as O, lazy as P, MainOptions as S, RunResult as T, IsEmpty as _, EffectContext as a, LogStream as b, ArgsSchema as c, Command as d, CommandBase as f, GlobalSetupContext as g, GlobalCleanupContext as h, CustomCompletion as i, SubCommandsRecord as j, SetupContext as k, CleanupContext as l, GlobalArgs as m, CompletionMeta as n, arg as o, Example as p, CompletionType as r, AnyCommand as s, ArgMeta as t, CollectedLogs as u, LogEntry as v, RunCommandOptions as w, Logger as x, LogLevel as y };
-//# sourceMappingURL=arg-registry-CHmAzJOM.d.ts.map
+//# sourceMappingURL=arg-registry-BlXeCM4p.d.cts.map

package/dist/arg-registry-BlXeCM4p.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-BlXeCM4p.d.cts","names":[],"sources":["../src/lazy.ts","../src/types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/{arg-registry-BDybpyo5.d.cts → arg-registry-D0MimRYf.d.ts}

@@ -204,6 +204,8 @@ interface MainOptions {
   setup?: ((context: GlobalSetupContext) => void | Promise<void>) | undefined;
   /** Global cleanup hook (runs after command execution, always executes even on error) */
   cleanup?: ((context: GlobalCleanupContext) => void | Promise<void>) | undefined;
+  /** Whether to display errors to stderr before process.exit (default: true) */
+  displayErrors?: boolean;
 }
 /**
  * Options for runCommand (programmatic/test usage)
@@ -456,4 +458,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { SubCommandValue as A, NonRunnableCommand as C, RunResultSuccess as D, RunResultFailure as E, LazyCommand as M, isLazyCommand as N, RunnableCommand as O, lazy as P, MainOptions as S, RunResult as T, IsEmpty as _, EffectContext as a, LogStream as b, ArgsSchema as c, Command as d, CommandBase as f, GlobalSetupContext as g, GlobalCleanupContext as h, CustomCompletion as i, SubCommandsRecord as j, SetupContext as k, CleanupContext as l, GlobalArgs as m, CompletionMeta as n, arg as o, Example as p, CompletionType as r, AnyCommand as s, ArgMeta as t, CollectedLogs as u, LogEntry as v, RunCommandOptions as w, Logger as x, LogLevel as y };
-//# sourceMappingURL=arg-registry-BDybpyo5.d.cts.map
+//# sourceMappingURL=arg-registry-D0MimRYf.d.ts.map

package/dist/arg-registry-D0MimRYf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-D0MimRYf.d.ts","names":[],"sources":["../src/lazy.ts","../src/types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/augment.d.cts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-BDybpyo5.cjs";
+import { t as ArgMeta } from "./arg-registry-BlXeCM4p.cjs";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/augment.d.ts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-CHmAzJOM.js";
+import { t as ArgMeta } from "./arg-registry-D0MimRYf.js";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/completion/index.d.cts

@@ -1,2 +1,2 @@
-import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-DjU9BErU.cjs";
+import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-f2-VIfCo.cjs";
 export { CandidateResult, CompletableOption, CompletableSubcommand, CompletionCandidate, CompletionContext, CompletionData, CompletionDirective, CompletionGenerator, CompletionOptions, CompletionResult, CompletionType, ShellFormatOptions, ShellType, ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/completion/index.d.ts

@@ -1,2 +1,2 @@
-import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-DcwMaTvt.js";
+import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-CBGSQVm9.js";
 export { CandidateResult, CompletableOption, CompletableSubcommand, CompletionCandidate, CompletionContext, CompletionData, CompletionDirective, CompletionGenerator, CompletionOptions, CompletionResult, CompletionType, ShellFormatOptions, ShellType, ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/docs/index.cjs

@@ -14,6 +14,12 @@ node_path = require_subcommand_router.__toESM(node_path);
 */
 const UPDATE_GOLDEN_ENV = "POLITTY_DOCS_UPDATE";
 /**
+* Environment variable name for doctor mode.
+* When enabled alone, detects and reports missing section markers (read-only).
+* When combined with POLITTY_DOCS_UPDATE=true, auto-inserts missing markers.
+*/
+const DOCTOR_ENV = "POLITTY_DOCS_DOCTOR";
+/**
 * All section types in rendering order
 */
 const SECTION_TYPES = [
@@ -822,7 +828,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await Promise.resolve().then(() => require("../runner-BgW1XWJw.cjs")).then((n) => n.runner_exports);
+		const { runCommand } = await Promise.resolve().then(() => require("../runner-U86FIDHT.cjs")).then((n) => n.runner_exports);
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);
@@ -1115,11 +1121,8 @@ async function applyFormatter(content, formatter) {
 	if (!content.endsWith("\n") && formatted.endsWith("\n")) return formatted.slice(0, -1);
 	return formatted;
 }
-/**
-* Check if update mode is enabled via environment variable
-*/
-function isUpdateMode() {
-	const value = process.env[UPDATE_GOLDEN_ENV];
+function isTruthyEnv(envKey) {
+	const value = process.env[envKey];
 	return value === "true" || value === "1";
 }
 /**
@@ -1355,6 +1358,37 @@ function replaceSectionMarker(content, type, scope, newContent) {
 	return replaceMarkerSection(content, sectionStartMarker(type, scope), sectionEndMarker(type, scope), newContent);
 }
 /**
+* Insert a new section marker into existing content at the correct position
+* relative to other section markers for the same command, based on SECTION_TYPES order.
+* @throws If no adjacent marker is found (unreachable when at least one marker exists for the command)
+*/
+function insertSectionMarkerAtOrder(content, type, scope, newSection) {
+	const typeIndex = SECTION_TYPES.indexOf(type);
+	for (let i = typeIndex - 1; i >= 0; i--) {
+		const prevType = SECTION_TYPES[i];
+		const prevEnd = sectionEndMarker(prevType, scope);
+		const prevEndIdx = content.indexOf(prevEnd);
+		if (prevEndIdx !== -1) {
+			const insertPos = prevEndIdx + prevEnd.length;
+			let afterPos = insertPos;
+			while (afterPos < content.length && content[afterPos] === "\n") afterPos++;
+			return content.slice(0, insertPos) + "\n\n" + newSection + "\n\n" + content.slice(afterPos);
+		}
+	}
+	for (let i = typeIndex + 1; i < SECTION_TYPES.length; i++) {
+		const nextType = SECTION_TYPES[i];
+		const nextStart = sectionStartMarker(nextType, scope);
+		const nextStartIdx = content.indexOf(nextStart);
+		if (nextStartIdx !== -1) {
+			let beforePos = nextStartIdx;
+			while (beforePos > 0 && content[beforePos - 1] === "\n") beforePos--;
+			const prefix = beforePos === 0 ? "" : "\n\n";
+			return content.slice(0, beforePos) + prefix + newSection + "\n\n" + content.slice(nextStartIdx);
+		}
+	}
+	throw new Error(`No insertion point found for section "${type}" (scope="${scope}"). This should be unreachable when at least one marker exists for the command.`);
+}
+/**
 * Collect all section types that have markers for a given command path.
 */
 function collectSectionMarkers(content, commandPath) {
@@ -1900,7 +1934,9 @@ async function generateDoc(config) {
 			};
 		}
 	}
-	const updateMode = isUpdateMode();
+	const updateMode = isTruthyEnv(UPDATE_GOLDEN_ENV);
+	const doctorMode = isTruthyEnv(DOCTOR_ENV);
+	let hasDoctorIssues = false;
 	if (rootDoc && !usingPathConfig) {
 		const normalizedRootDocPath = normalizeDocPathForComparison(rootDoc.path);
 		if (Object.keys(files).some((filePath) => normalizeDocPathForComparison(filePath) === normalizedRootDocPath)) throw new Error(`rootDoc.path "${rootDoc.path}" must not also appear as a key in files.`);
@@ -2006,6 +2042,25 @@ async function generateDoc(config) {
 						diffs.push(formatDiff(existingSection, generatedSectionPart));
 					}
 				}
+				if (doctorMode) {
+					const generatedMarkers = collectSectionMarkers(generatedSection, targetCommand);
+					const existingMarkerSet = new Set(existingMarkers);
+					for (const sectionType of generatedMarkers) {
+						if (existingMarkerSet.has(sectionType)) continue;
+						const generatedSectionPart = extractSectionMarker(generatedSection, sectionType, targetCommand);
+						if (!generatedSectionPart) continue;
+						if (updateMode) {
+							existingContent = insertSectionMarkerAtOrder(existingContent, sectionType, targetCommand, generatedSectionPart);
+							writeFile(filePath, existingContent);
+							if (fileStatus !== "created") fileStatus = "updated";
+						} else {
+							hasError = true;
+							hasDoctorIssues = true;
+							fileStatus = "diff";
+							diffs.push(`[doctor] Missing section marker "${sectionType}" for command "${formatCommandPath(targetCommand)}". Run with ${DOCTOR_ENV}=true ${UPDATE_GOLDEN_ENV}=true to insert.\n${generatedSectionPart}`);
+						}
+					}
+				}
 			}
 			if (existingContent) {
 				const existingMarkerPaths = collectSectionMarkerPaths(existingContent);
@@ -2118,10 +2173,11 @@ async function generateDoc(config) {
 			diff: rootDocDiffs.length > 0 ? rootDocDiffs.join("\n\n") : void 0
 		});
 	}
+	const errorHint = hasDoctorIssues ? `Run with ${DOCTOR_ENV}=true ${UPDATE_GOLDEN_ENV}=true to fix missing markers.` : `Run with ${UPDATE_GOLDEN_ENV}=true to update.`;
 	return {
 		success: !hasError,
 		files: results,
-		error: hasError ? `Documentation is out of date. Run with ${UPDATE_GOLDEN_ENV}=true to update.` : void 0
+		error: hasError ? `Documentation is out of date. ${errorHint}` : void 0
 	};
 }
 /**
@@ -2136,7 +2192,7 @@ async function assertDocMatch(config) {
 			if (f.diff) msg += f.diff;
 			return msg;
 		}).join("\n\n");
-		throw new Error(`Documentation does not match golden files.\n\n${diffMessages}\n\nRun with ${UPDATE_GOLDEN_ENV}=true to update the documentation.`);
+		throw new Error(`Documentation does not match golden files.\n\n${diffMessages}\n\n` + (result.error ?? `Run with ${"POLITTY_DOCS_UPDATE"}=true to update the documentation.`));
 	}
 }
 /**
@@ -2147,12 +2203,13 @@ async function assertDocMatch(config) {
 * @param fileSystem - Optional fs implementation (useful when fs is mocked)
 */
 function initDocFile(config, fileSystem) {
-	if (!isUpdateMode()) return;
+	if (!isTruthyEnv("POLITTY_DOCS_UPDATE")) return;
 	if (typeof config === "string") deleteFile(config, fileSystem);
 	else if (config.files) for (const filePath of Object.keys(config.files)) deleteFile(filePath, fileSystem);
 }
 
 //#endregion
+exports.DOCTOR_ENV = DOCTOR_ENV;
 exports.GLOBAL_OPTIONS_MARKER_PREFIX = GLOBAL_OPTIONS_MARKER_PREFIX;
 exports.INDEX_MARKER_PREFIX = INDEX_MARKER_PREFIX;
 exports.ROOT_FOOTER_MARKER_PREFIX = ROOT_FOOTER_MARKER_PREFIX;