politty 0.4.4 → 0.4.7

package/dist/docs/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_subcommand_router = require('../subcommand-router-ZjNjFaUL.cjs');
-const require_lazy = require('../lazy-BEDnSR0m.cjs');
+const require_subcommand_router = require('../subcommand-router-sZHhUP7b.cjs');
+const require_lazy = require('../lazy-DHlvJiQQ.cjs');
 let zod = require("zod");
 let node_util = require("node:util");
 let node_fs = require("node:fs");
@@ -61,6 +61,26 @@ function globalOptionsEndMarker() {
 	return `<!-- ${GLOBAL_OPTIONS_MARKER_PREFIX}:end -->`;
 }
 /**
+* Marker prefix for root header sections in generated documentation
+*/
+const ROOT_HEADER_MARKER_PREFIX = "politty:root-header";
+function rootHeaderStartMarker() {
+	return `<!-- ${ROOT_HEADER_MARKER_PREFIX}:start -->`;
+}
+function rootHeaderEndMarker() {
+	return `<!-- ${ROOT_HEADER_MARKER_PREFIX}:end -->`;
+}
+/**
+* Marker prefix for root footer sections in generated documentation
+*/
+const ROOT_FOOTER_MARKER_PREFIX = "politty:root-footer";
+function rootFooterStartMarker() {
+	return `<!-- ${ROOT_FOOTER_MARKER_PREFIX}:start -->`;
+}
+function rootFooterEndMarker() {
+	return `<!-- ${ROOT_FOOTER_MARKER_PREFIX}:end -->`;
+}
+/**
 * Marker prefix for index sections in generated documentation
 * Format: <!-- politty:index:<scope>:start --> ... <!-- politty:index:<scope>:end -->
 */
@@ -301,6 +321,68 @@ function renderOptionsTableFromArray(options) {
 	return lines.join("\n");
 }
 /**
+* Render union/xor options as markdown with variant grouping
+*/
+function renderUnionOptionsMarkdown(extracted, style = "table") {
+	const unionOptions = extracted.unionOptions ?? [];
+	if (unionOptions.length === 0) return "";
+	const sections = [];
+	const allFieldNames = /* @__PURE__ */ new Set();
+	for (const option of unionOptions) for (const field of option.fields) allFieldNames.add(field.name);
+	const commonFieldNames = /* @__PURE__ */ new Set();
+	for (const fieldName of allFieldNames) if (unionOptions.every((o) => o.fields.some((f) => f.name === fieldName))) commonFieldNames.add(fieldName);
+	const commonFields = extracted.fields.filter((f) => commonFieldNames.has(f.name) && !f.positional);
+	if (commonFields.length > 0) sections.push(style === "table" ? renderOptionsTableFromArray(commonFields) : renderOptionsListFromArray(commonFields));
+	sections.push("> One of the following option groups is required:");
+	for (let i = 0; i < unionOptions.length; i++) {
+		const option = unionOptions[i];
+		if (!option) continue;
+		const uniqueFields = option.fields.filter((f) => !commonFieldNames.has(f.name) && !f.positional);
+		if (uniqueFields.length === 0) continue;
+		const label = option.description ?? `Variant ${i + 1}`;
+		const rendered = style === "table" ? renderOptionsTableFromArray(uniqueFields) : renderOptionsListFromArray(uniqueFields);
+		sections.push(`**${label}:**\n\n${rendered}`);
+	}
+	return sections.join("\n\n");
+}
+/**
+* Render discriminatedUnion options as markdown with variant grouping
+*/
+function renderDiscriminatedUnionOptionsMarkdown(extracted, style = "table") {
+	const discriminator = extracted.discriminator;
+	const variants = extracted.variants ?? [];
+	if (!discriminator || variants.length === 0) return "";
+	const sections = [];
+	const allFieldNames = /* @__PURE__ */ new Set();
+	for (const variant of variants) for (const field of variant.fields) allFieldNames.add(field.name);
+	const commonFieldNames = /* @__PURE__ */ new Set();
+	for (const fieldName of allFieldNames) {
+		if (fieldName === discriminator) continue;
+		if (variants.every((v) => v.fields.some((f) => f.name === fieldName))) commonFieldNames.add(fieldName);
+	}
+	const discriminatorField = extracted.fields.find((f) => f.name === discriminator);
+	const variantValues = variants.map((v) => v.discriminatorValue).join("\\|");
+	const topFields = [];
+	if (discriminatorField) topFields.push({
+		...discriminatorField,
+		placeholder: variantValues
+	});
+	for (const fieldName of commonFieldNames) {
+		const field = extracted.fields.find((f) => f.name === fieldName);
+		if (field && !field.positional) topFields.push(field);
+	}
+	if (topFields.length > 0) sections.push(style === "table" ? renderOptionsTableFromArray(topFields) : renderOptionsListFromArray(topFields));
+	for (const variant of variants) {
+		const uniqueFields = variant.fields.filter((f) => f.name !== discriminator && !commonFieldNames.has(f.name) && !f.positional);
+		if (uniqueFields.length === 0) continue;
+		const descSuffix = variant.description ? ` ${variant.description}` : "";
+		const label = `**When \`${discriminator}\` = \`${variant.discriminatorValue}\`:**${descSuffix}`;
+		const rendered = style === "table" ? renderOptionsTableFromArray(uniqueFields) : renderOptionsListFromArray(uniqueFields);
+		sections.push(`${label}\n\n${rendered}`);
+	}
+	return sections.join("\n\n");
+}
+/**
 * Render options from array as list
 */
 function renderOptionsListFromArray(options) {
@@ -416,8 +498,13 @@ function wrapWithMarker(type, scope, content) {
 	return `${sectionStartMarker(type, scope)}\n${content}\n${sectionEndMarker(type, scope)}`;
 }
 /**
-* Create command renderer with options
+* Generate a "See Global Options" link for subcommand documentation.
+* Returns null for root command or when no global options exist.
 */
+function getGlobalOptionsLink(info) {
+	if (!info.hasGlobalOptions || info.commandPath === "") return null;
+	return `See [Global Options](${info.rootDocPath && info.filePath && info.filePath !== info.rootDocPath ? `${getRelativePath(info.filePath, info.rootDocPath)}#global-options` : "#global-options"}) for options available to all commands.`;
+}
 function createCommandRenderer(options = {}) {
 	const { headingLevel = 1, optionStyle = "table", generateAnchors = true, includeSubcommandDetails = true, renderDescription: customRenderDescription, renderUsage: customRenderUsage, renderArguments: customRenderArguments, renderOptions: customRenderOptions, renderSubcommands: customRenderSubcommands, renderNotes: customRenderNotes, renderFooter: customRenderFooter, renderExamples: customRenderExamples } = options;
 	return (info) => {
@@ -465,7 +552,11 @@ function createCommandRenderer(options = {}) {
 			const renderOpts = (opts, renderOpts) => {
 				const style = renderOpts?.style ?? optionStyle;
 				const withHeading = renderOpts?.withHeading ?? true;
-				const content = style === "table" ? renderOptionsTableFromArray(opts) : renderOptionsListFromArray(opts);
+				const extracted = info.extracted;
+				let content;
+				if (extracted && (extracted.schemaType === "union" || extracted.schemaType === "xor") && extracted.unionOptions) content = renderUnionOptionsMarkdown(extracted, style);
+				else if (extracted && extracted.schemaType === "discriminatedUnion" && extracted.discriminator) content = renderDiscriminatedUnionOptionsMarkdown(extracted, style);
+				else content = style === "table" ? renderOptionsTableFromArray(opts) : renderOptionsListFromArray(opts);
 				return withHeading ? `**Options**\n\n${content}` : content;
 			};
 			const context = {
@@ -477,6 +568,10 @@ function createCommandRenderer(options = {}) {
 			const content = customRenderOptions ? customRenderOptions(context) : renderOpts(context.options);
 			if (content) sections.push(wrapWithMarker("options", scope, content));
 		}
+		{
+			const globalLink = getGlobalOptionsLink(info);
+			if (globalLink) sections.push(globalLink);
+		}
 		if (info.subCommands.length > 0) {
 			const effectiveAnchors = generateAnchors && includeSubcommandDetails;
 			const renderSubs = (subs, opts) => {
@@ -723,7 +818,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await Promise.resolve().then(() => require("../runner-C4fSHJMe.cjs")).then((n) => n.runner_exports);
+		const { runCommand } = await Promise.resolve().then(() => require("../runner-Cn6Oq4ZZ.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);
@@ -1127,7 +1222,7 @@ function resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores) {
 	return {
 		fileConfig,
 		specifiedCommands,
-		commandPaths: filterIgnoredCommands(expandCommandPaths(specifiedCommands, allCommands), ignores),
+		commandPaths: filterIgnoredCommands(fileConfig.noExpand ? specifiedCommands.filter((p) => allCommands.has(p)) : expandCommandPaths(specifiedCommands, allCommands), ignores),
 		topLevelCommands: filterIgnoredCommands(resolveTopLevelCommands(specifiedCommands, allCommands), ignores)
 	};
 }
@@ -1447,6 +1542,7 @@ function generateGlobalOptionsSection(config) {
 	const endMarker = globalOptionsEndMarker();
 	return [
 		startMarker,
+		"<a id=\"global-options\"></a>",
 		renderArgsTable(config.args, config.options),
 		endMarker
 	].join("\n");
@@ -1473,7 +1569,7 @@ function normalizeDocPathForComparison(filePath) {
 * Process global options marker in file content
 * Returns result with updated content and any diffs
 */
-async function processGlobalOptionsMarker(existingContent, globalOptionsConfig, updateMode, formatter) {
+async function processGlobalOptionsMarker(existingContent, globalOptionsConfig, updateMode, formatter, autoInsertIfMissing) {
 	let content = existingContent;
 	const diffs = [];
 	let hasError = false;
@@ -1483,6 +1579,16 @@ async function processGlobalOptionsMarker(existingContent, globalOptionsConfig,
 	const generatedSection = await applyFormatter(generateGlobalOptionsSection(globalOptionsConfig), formatter);
 	const existingSection = extractMarkerSection(content, startMarker, endMarker);
 	if (!existingSection) {
+		if (updateMode && autoInsertIfMissing) {
+			content = content.trimEnd() + "\n\n" + generatedSection + "\n";
+			wasUpdated = true;
+			return {
+				content,
+				diffs,
+				hasError,
+				wasUpdated
+			};
+		}
 		hasError = true;
 		diffs.push(`Global options marker not found in file. Expected markers:\n${startMarker}\n...\n${endMarker}`);
 		return {
@@ -1513,6 +1619,61 @@ async function processGlobalOptionsMarker(existingContent, globalOptionsConfig,
 	};
 }
 /**
+* Process a static content marker (root-header or root-footer).
+* Inserts/updates the marker section with the given content.
+*/
+async function processStaticMarker(existingContent, markerLabel, startMarker, endMarker, rawContent, updateMode, formatter, autoInsertIfMissing) {
+	let content = existingContent;
+	const diffs = [];
+	let hasError = false;
+	let wasUpdated = false;
+	const generatedSection = [
+		startMarker,
+		await applyFormatter(rawContent, formatter),
+		endMarker
+	].join("\n");
+	const existingSection = extractMarkerSection(content, startMarker, endMarker);
+	if (!existingSection) {
+		if (updateMode && autoInsertIfMissing) {
+			content = content.trimEnd() + "\n\n" + generatedSection + "\n";
+			wasUpdated = true;
+			return {
+				content,
+				diffs,
+				hasError,
+				wasUpdated
+			};
+		}
+		hasError = true;
+		diffs.push(`${markerLabel} marker not found in file. Expected markers:\n${startMarker}\n...\n${endMarker}`);
+		return {
+			content,
+			diffs,
+			hasError,
+			wasUpdated
+		};
+	}
+	if (existingSection !== generatedSection) if (updateMode) {
+		const updated = replaceMarkerSection(content, startMarker, endMarker, generatedSection);
+		if (updated) {
+			content = updated;
+			wasUpdated = true;
+		} else {
+			hasError = true;
+			diffs.push(`Failed to replace ${markerLabel} section`);
+		}
+	} else {
+		hasError = true;
+		diffs.push(formatDiff(existingSection, generatedSection));
+	}
+	return {
+		content,
+		diffs,
+		hasError,
+		wasUpdated
+	};
+}
+/**
 * Process index marker in file content
 * Returns result with updated content and any diffs.
 * If the marker is not present in the file, the section is silently skipped.
@@ -1603,26 +1764,29 @@ function findTargetCommandsInFile(targetCommands, filePath, files, allCommands,
 /**
 * Generate a single command section (already contains section markers from renderer)
 */
-function generateCommandSection(cmdPath, allCommands, render, filePath, fileMap) {
+function generateCommandSection(cmdPath, allCommands, render, filePath, fileMap, rootDocPath, hasGlobalOptions) {
 	const info = allCommands.get(cmdPath);
 	if (!info) return null;
-	return render({
+	const enriched = {
 		...info,
 		filePath,
-		fileMap
-	});
+		fileMap,
+		rootDocPath
+	};
+	if (hasGlobalOptions !== void 0) enriched.hasGlobalOptions = hasGlobalOptions;
+	return render(enriched);
 }
 /**
 * Generate markdown for a file containing multiple commands
 * Each command section is wrapped with markers for partial validation
 */
-function generateFileMarkdown(commandPaths, allCommands, render, filePath, fileMap, specifiedOrder, fileConfig) {
+function generateFileMarkdown(commandPaths, allCommands, render, filePath, fileMap, specifiedOrder, fileConfig, rootDocPath, hasGlobalOptions) {
 	const sections = [];
 	const header = fileConfig ? generateFileHeader(fileConfig) : null;
 	if (header) sections.push(header);
 	const sortedPaths = sortDepthFirst(commandPaths, specifiedOrder ?? []);
 	for (const cmdPath of sortedPaths) {
-		const section = generateCommandSection(cmdPath, allCommands, render, filePath, fileMap);
+		const section = generateCommandSection(cmdPath, allCommands, render, filePath, fileMap, rootDocPath, hasGlobalOptions);
 		if (section) sections.push(section);
 	}
 	return `${sections.join("\n")}\n`;
@@ -1651,16 +1815,72 @@ async function executeConfiguredExamples(allCommands, examplesConfig, rootComman
 	}
 }
 /**
+* Convert PathConfig to FileMapping with explicit command paths.
+* Uses noExpand to prevent subcommand expansion since paths are pre-resolved.
+*/
+function pathToFiles(pathConfig, allCommands) {
+	if (typeof pathConfig === "string") return {
+		files: { [pathConfig]: Array.from(allCommands.keys()) },
+		rootDocPath: pathConfig
+	};
+	const { root, commands = {} } = pathConfig;
+	const files = {};
+	const assignedToOtherFiles = /* @__PURE__ */ new Set();
+	const sortedEntries = Object.entries(commands).sort(([a], [b]) => b.split(" ").length - a.split(" ").length);
+	for (const [cmdPath, filePath] of sortedEntries) {
+		if (!files[filePath]) files[filePath] = {
+			commands: [],
+			noExpand: true
+		};
+		const fc = files[filePath];
+		for (const existingPath of allCommands.keys()) if ((existingPath === cmdPath || existingPath.startsWith(cmdPath + " ")) && !assignedToOtherFiles.has(existingPath)) {
+			fc.commands.push(existingPath);
+			assignedToOtherFiles.add(existingPath);
+		}
+	}
+	files[root] = {
+		commands: Array.from(allCommands.keys()).filter((p) => !assignedToOtherFiles.has(p)),
+		noExpand: true
+	};
+	return {
+		files,
+		rootDocPath: root
+	};
+}
+/**
 * Generate documentation from command definition
 */
 async function generateDoc(config) {
-	const { command, rootDoc, files, ignores = [], format = {}, formatter, examples: examplesConfig, targetCommands } = config;
+	const { command, ignores = [], format = {}, formatter, examples: examplesConfig, targetCommands, globalArgs } = config;
+	const allCommands = await collectAllCommands(command);
+	let files;
+	let usingPathConfig = false;
+	let resolvedRootDocPath;
+	if (config.path !== void 0) {
+		if (config.files !== void 0) throw new Error("Cannot specify both \"path\" and \"files\". Use one or the other.");
+		const converted = pathToFiles(config.path, allCommands);
+		files = converted.files;
+		resolvedRootDocPath = converted.rootDocPath;
+		usingPathConfig = true;
+	} else if (config.files !== void 0) files = config.files;
+	else throw new Error("Either \"path\" or \"files\" must be specified.");
+	let rootDoc = config.rootDoc;
+	if (!rootDoc && usingPathConfig && (globalArgs || config.rootInfo)) rootDoc = { path: resolvedRootDocPath };
+	if (globalArgs && rootDoc && !rootDoc.globalOptions) {
+		const optionFields = require_lazy.extractFields(globalArgs).fields.filter((f) => !f.positional);
+		if (optionFields.length > 0) {
+			const globalShape = Object.fromEntries(optionFields.map((f) => [f.name, f.schema]));
+			rootDoc = {
+				...rootDoc,
+				globalOptions: globalShape
+			};
+		}
+	}
 	const updateMode = isUpdateMode();
-	if (rootDoc) {
+	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.`);
 	}
-	const allCommands = await collectAllCommands(command);
 	if (examplesConfig) await executeConfiguredExamples(allCommands, examplesConfig, command);
 	const hasTargetCommands = targetCommands !== void 0 && targetCommands.length > 0;
 	if (hasTargetCommands) {
@@ -1694,11 +1914,13 @@ async function generateDoc(config) {
 			headingLevel: adjustedHeadingLevel
 		});
 		const render = fileConfig.render ?? fileRenderer;
-		if (hasTargetCommands) {
+		const isRootDocFile = usingPathConfig && rootDoc && normalizeDocPathForComparison(filePath) === normalizeDocPathForComparison(rootDoc.path);
+		if (hasTargetCommands || isRootDocFile) {
 			let existingContent = readFile(filePath);
 			const sortedCommandPaths = sortDepthFirst(commandPaths, specifiedCommands);
-			for (const targetCommand of fileTargetCommands) {
-				const rawSection = generateCommandSection(targetCommand, allCommands, render, filePath, fileMap);
+			const effectiveTargetCommands = hasTargetCommands ? fileTargetCommands : commandPaths;
+			for (const targetCommand of effectiveTargetCommands) {
+				const rawSection = generateCommandSection(targetCommand, allCommands, render, filePath, fileMap, rootDoc?.path, globalOptionDefinitions.size > 0);
 				if (!rawSection) throw new Error(`Target command "${targetCommand}" not found in commands`);
 				const generatedSection = await applyFormatter(rawSection, formatter);
 				if (!existingContent) {
@@ -1747,7 +1969,7 @@ async function generateDoc(config) {
 				}
 			}
 		} else {
-			const generatedMarkdown = await applyFormatter(generateFileMarkdown(commandPaths, allCommands, render, filePath, fileMap, specifiedCommands, fileConfig), formatter);
+			const generatedMarkdown = await applyFormatter(generateFileMarkdown(commandPaths, allCommands, render, filePath, fileMap, specifiedCommands, fileConfig, rootDoc?.path, globalOptionDefinitions.size > 0), formatter);
 			const comparison = compareWithExisting(generatedMarkdown, filePath);
 			if (comparison.match) {} else if (updateMode) {
 				writeFile(filePath, generatedMarkdown);
@@ -1777,22 +1999,33 @@ async function generateDoc(config) {
 		} else {
 			let content = existingContent;
 			let markerUpdated = false;
-			const rootDocFileConfig = { title: command.name };
+			const rootInfo = config.rootInfo;
+			const rootDocFileConfig = { title: rootInfo?.title ?? command.name };
 			if (rootDoc.headingLevel !== void 0) rootDocFileConfig.headingLevel = rootDoc.headingLevel;
-			if (command.description !== void 0) rootDocFileConfig.description = command.description;
+			const rootDescription = rootInfo?.description ?? command.description;
+			if (rootDescription !== void 0) rootDocFileConfig.description = rootDescription;
 			const headerResult = processFileHeader(content, rootDocFileConfig, updateMode);
 			content = headerResult.content;
 			if (headerResult.diff) rootDocDiffs.push(headerResult.diff);
 			if (headerResult.hasError) hasError = true;
 			if (headerResult.wasUpdated) markerUpdated = true;
-			const unexpectedSectionPaths = Array.from(new Set(collectSectionMarkerPaths(content)));
-			if (unexpectedSectionPaths.length > 0) {
-				hasError = true;
-				rootDocDiffs.push(`Found unexpected section markers in rootDoc: ${unexpectedSectionPaths.map((commandPath) => `"${formatCommandPath(commandPath)}"`).join(", ")}.`);
+			if (rootInfo?.header) {
+				const headerMarkerResult = await processStaticMarker(content, "Root header", rootHeaderStartMarker(), rootHeaderEndMarker(), rootInfo.header, updateMode, formatter, usingPathConfig);
+				content = headerMarkerResult.content;
+				rootDocDiffs.push(...headerMarkerResult.diffs);
+				if (headerMarkerResult.hasError) hasError = true;
+				if (headerMarkerResult.wasUpdated) markerUpdated = true;
+			}
+			if (!usingPathConfig) {
+				const unexpectedSectionPaths = Array.from(new Set(collectSectionMarkerPaths(content)));
+				if (unexpectedSectionPaths.length > 0) {
+					hasError = true;
+					rootDocDiffs.push(`Found unexpected section markers in rootDoc: ${unexpectedSectionPaths.map((commandPath) => `"${formatCommandPath(commandPath)}"`).join(", ")}.`);
+				}
 			}
 			const normalizedGlobalOptions = normalizeGlobalOptions(rootDoc.globalOptions);
 			if (normalizedGlobalOptions) {
-				const globalOptionsResult = await processGlobalOptionsMarker(content, normalizedGlobalOptions, updateMode, formatter);
+				const globalOptionsResult = await processGlobalOptionsMarker(content, normalizedGlobalOptions, updateMode, formatter, usingPathConfig);
 				content = globalOptionsResult.content;
 				rootDocDiffs.push(...globalOptionsResult.diffs);
 				if (globalOptionsResult.hasError) hasError = true;
@@ -1805,6 +2038,13 @@ async function generateDoc(config) {
 			rootDocDiffs.push(...indexResult.diffs);
 			if (indexResult.hasError) hasError = true;
 			if (indexResult.wasUpdated) markerUpdated = true;
+			if (rootInfo?.footer) {
+				const footerMarkerResult = await processStaticMarker(content, "Root footer", rootFooterStartMarker(), rootFooterEndMarker(), rootInfo.footer, updateMode, formatter, usingPathConfig);
+				content = footerMarkerResult.content;
+				rootDocDiffs.push(...footerMarkerResult.diffs);
+				if (footerMarkerResult.hasError) hasError = true;
+				if (footerMarkerResult.wasUpdated) markerUpdated = true;
+			}
 			if (updateMode && markerUpdated) {
 				writeFile(rootDocFilePath, content);
 				if (rootDocStatus === "match") rootDocStatus = "updated";
@@ -1848,12 +2088,14 @@ async function assertDocMatch(config) {
 function initDocFile(config, fileSystem) {
 	if (!isUpdateMode()) return;
 	if (typeof config === "string") deleteFile(config, fileSystem);
-	else for (const filePath of Object.keys(config.files)) deleteFile(filePath, fileSystem);
+	else if (config.files) for (const filePath of Object.keys(config.files)) deleteFile(filePath, fileSystem);
 }
 
 //#endregion
 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;
+exports.ROOT_HEADER_MARKER_PREFIX = ROOT_HEADER_MARKER_PREFIX;
 exports.SECTION_MARKER_PREFIX = SECTION_MARKER_PREFIX;
 exports.SECTION_TYPES = SECTION_TYPES;
 exports.UPDATE_GOLDEN_ENV = UPDATE_GOLDEN_ENV;
@@ -1886,6 +2128,10 @@ exports.renderSubcommandsTable = renderSubcommandsTable;
 exports.renderSubcommandsTableFromArray = renderSubcommandsTableFromArray;
 exports.renderUsage = renderUsage;
 exports.resolveLazyCommand = require_subcommand_router.resolveLazyCommand;
+exports.rootFooterEndMarker = rootFooterEndMarker;
+exports.rootFooterStartMarker = rootFooterStartMarker;
+exports.rootHeaderEndMarker = rootHeaderEndMarker;
+exports.rootHeaderStartMarker = rootHeaderStartMarker;
 exports.sectionEndMarker = sectionEndMarker;
 exports.sectionStartMarker = sectionStartMarker;
 exports.writeFile = writeFile;