politty 0.4.7 → 0.4.9

package/dist/docs/index.d.cts

@@ -1,4 +1,5 @@
-import { A as SubCommandValue, c as AnyCommand, l as ArgsSchema, m as Example, n as ResolvedFieldMeta, t as ExtractedFields } from "../schema-extractor-BoWkcP9a.cjs";
+import { A as SubCommandValue, c as ArgsSchema, p as Example, s as AnyCommand } from "../arg-registry-BDybpyo5.cjs";
+import { n as ResolvedFieldMeta, t as ExtractedFields } from "../schema-extractor-RainqdRn.cjs";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -433,7 +434,7 @@ declare const UPDATE_GOLDEN_ENV = "POLITTY_DOCS_UPDATE";
 /**
  * All section types in rendering order
  */
-declare const SECTION_TYPES: readonly ["heading", "description", "usage", "arguments", "options", "subcommands", "examples", "notes"];
+declare const SECTION_TYPES: readonly ["heading", "description", "usage", "arguments", "options", "global-options-link", "subcommands", "examples", "notes"];
 /**
  * Section types for command documentation markers
  */

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,5 @@
-import { A as SubCommandValue, c as AnyCommand, l as ArgsSchema, m as Example, n as ResolvedFieldMeta, t as ExtractedFields } from "../schema-extractor-DoDO4M_i.js";
+import { A as SubCommandValue, c as ArgsSchema, p as Example, s as AnyCommand } from "../arg-registry-CHmAzJOM.js";
+import { n as ResolvedFieldMeta, t as ExtractedFields } from "../schema-extractor-D1sJW-sc.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -433,7 +434,7 @@ declare const UPDATE_GOLDEN_ENV = "POLITTY_DOCS_UPDATE";
 /**
  * All section types in rendering order
  */
-declare const SECTION_TYPES: readonly ["heading", "description", "usage", "arguments", "options", "subcommands", "examples", "notes"];
+declare const SECTION_TYPES: readonly ["heading", "description", "usage", "arguments", "options", "global-options-link", "subcommands", "examples", "notes"];
 /**
  * Section types for command documentation markers
  */

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,5 +1,5 @@
-import { a as getExtractedFields, i as extractFields } from "../lazy-DSyfzR-F.js";
-import { i as createLogCollector, n as resolveLazyCommand } from "../subcommand-router-CKuy6D2b.js";
+import { a as getExtractedFields, i as extractFields } from "../lazy-D6nL_iKJ.js";
+import { i as createLogCollector, n as resolveLazyCommand } from "../subcommand-router-Bu3YTw_f.js";
 import { z } from "zod";
 import { isDeepStrictEqual } from "node:util";
 import * as fs from "node:fs";
@@ -19,6 +19,7 @@ const SECTION_TYPES = [
 	"usage",
 	"arguments",
 	"options",
+	"global-options-link",
 	"subcommands",
 	"examples",
 	"notes"
@@ -567,7 +568,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;
@@ -815,7 +816,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await import("../runner-D4ByDT5I.js").then((n) => n.r);
+		const { runCommand } = await import("../runner-BQcd2UEj.js").then((n) => n.r);
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);
@@ -1401,6 +1402,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)
 */
@@ -1965,6 +1986,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);
@@ -2014,8 +2054,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(", ")}.`);
 				}