politty 0.4.8 → 0.4.9

package/dist/docs/index.cjs

@@ -22,6 +22,7 @@ const SECTION_TYPES = [
 	"usage",
 	"arguments",
 	"options",
+	"global-options-link",
 	"subcommands",
 	"examples",
 	"notes"
@@ -570,7 +571,7 @@ function createCommandRenderer(options = {}) {
 		}
 		{
 			const globalLink = getGlobalOptionsLink(info);
-			if (globalLink) sections.push(globalLink);
+			if (globalLink) sections.push(wrapWithMarker("global-options-link", scope, globalLink));
 		}
 		if (info.subCommands.length > 0) {
 			const effectiveAnchors = generateAnchors && includeSubcommandDetails;
@@ -1404,6 +1405,26 @@ function insertCommandSections(content, commandPath, newSection, specifiedOrder)
 	return content.trimEnd() + "\n" + newSection + "\n";
 }
 /**
+* Remove all section markers for a command from content.
+* Returns the content with all markers for the command removed and excess blank lines cleaned up.
+*/
+function removeCommandSections(content, commandPath) {
+	const markers = collectSectionMarkers(content, commandPath);
+	for (const type of markers) {
+		const start = sectionStartMarker(type, commandPath);
+		const end = sectionEndMarker(type, commandPath);
+		let startIndex = content.indexOf(start);
+		while (startIndex !== -1) {
+			const endIndex = content.indexOf(end, startIndex);
+			if (endIndex === -1) break;
+			content = content.slice(0, startIndex) + content.slice(endIndex + end.length);
+			startIndex = content.indexOf(start, startIndex);
+		}
+	}
+	content = content.replace(/\n{3,}/g, "\n\n");
+	return content;
+}
+/**
 * Extract a marker section from content
 * Returns the content between start and end markers (including markers)
 */
@@ -1968,6 +1989,25 @@ async function generateDoc(config) {
 					}
 				}
 			}
+			if (existingContent) {
+				const existingMarkerPaths = collectSectionMarkerPaths(existingContent);
+				const commandPathSet = new Set(commandPaths);
+				if (updateMode) {
+					let removedAny = false;
+					for (const markerPath of existingMarkerPaths) if (!commandPathSet.has(markerPath)) {
+						existingContent = removeCommandSections(existingContent, markerPath);
+						removedAny = true;
+					}
+					if (removedAny) {
+						writeFile(filePath, existingContent);
+						if (fileStatus !== "created") fileStatus = "updated";
+					}
+				} else for (const markerPath of existingMarkerPaths) if (!commandPathSet.has(markerPath)) {
+					hasError = true;
+					fileStatus = "diff";
+					diffs.push(`Found orphaned section markers for deleted command "${formatCommandPath(markerPath)}"`);
+				}
+			}
 		} else {
 			const generatedMarkdown = await applyFormatter(generateFileMarkdown(commandPaths, allCommands, render, filePath, fileMap, specifiedCommands, fileConfig, rootDoc?.path, globalOptionDefinitions.size > 0), formatter);
 			const comparison = compareWithExisting(generatedMarkdown, filePath);
@@ -2017,8 +2057,11 @@ async function generateDoc(config) {
 				if (headerMarkerResult.wasUpdated) markerUpdated = true;
 			}
 			if (!usingPathConfig) {
-				const unexpectedSectionPaths = Array.from(new Set(collectSectionMarkerPaths(content)));
-				if (unexpectedSectionPaths.length > 0) {
+				const unexpectedSectionPaths = collectSectionMarkerPaths(content);
+				if (unexpectedSectionPaths.length > 0) if (updateMode) {
+					for (const commandPath of unexpectedSectionPaths) content = removeCommandSections(content, commandPath);
+					markerUpdated = true;
+				} else {
 					hasError = true;
 					rootDocDiffs.push(`Found unexpected section markers in rootDoc: ${unexpectedSectionPaths.map((commandPath) => `"${formatCommandPath(commandPath)}"`).join(", ")}.`);
 				}