@politty/zod 0.1.1 → 0.2.0

package/dist/docs.js

@@ -1,3055 +1,94 @@
-import { a as getValidatorAdapter } from "./field-meta-DMy5BcRr.js";
-import "./register-DlGnMLIY.js";
-import { n as getExtractedFields, t as extractFields } from "./schema-extractor-DMSozq40.js";
-import { t as createLogCollector } from "./log-collector-CoUkLVJB.js";
-import { r as resolveLazyCommand } from "./subcommand-router-Cskpofdk.js";
-import * as fs from "node:fs";
-import * as path$1 from "node:path";
-import path from "node:path";
-import { isDeepStrictEqual } from "node:util";
+import{a as e}from"./field-meta-COGya7xp.js";import"./register-C1WbbeYH.js";import{n as t,t as n}from"./schema-extractor-DU0Vuhbd.js";import{t as r}from"./log-collector-hiFa3sNm.js";import{r as i}from"./subcommand-router-D8GTMXYL.js";import*as a from"node:fs";import*as o from"node:path";import s from"node:path";import{isDeepStrictEqual as c}from"node:util";const l=[`option`,`alias`,`description`,`required`,`default`];function u(e){return`(↔ \`--${e.cliName}\`)`}function d(e){return e.placeholder??e.cliName.toUpperCase().replace(/-/g,`_`)}function f(e){let t=e.type===`boolean`?`--${e.cliName}`:`--${e.cliName} <${d(e)}>`,n=[];if(e.alias)for(let t of e.alias)n.push(t.length===1?`-${t}`:`--${t}`);let r=e.type===`boolean`&&!!e.negationDisplay,i=r&&!e.negationDescription?`--${e.negationDisplay}`:void 0,a=r&&e.negationDescription?{flag:`--${e.negationDisplay}`,description:e.negationDescription,relationMarker:u(e),required:e.required}:void 0;return{longFlag:t,aliases:n,inlineNegation:i,description:e.description,required:e.required,hasDefault:e.defaultValue!==void 0,defaultValue:e.defaultValue,env:e.env,negationRow:a}}function p(e){return e.map(f)}function m(e){return e.replace(/\r?\n/g,`<br>`)}function h(e){return m(e.replace(/\|/g,`\\|`))}function g(e){return`\`${e}\``}function _(e){return e.hasDefault?`\`${JSON.stringify(e.defaultValue)}\``:`-`}function v(e){return e?Array.isArray(e)?e.map(e=>`\`${e}\``).join(`, `):`\`${e}\``:`-`}function y(e){return e?` [env: ${(Array.isArray(e)?e:[e]).join(`, `)}]`:``}const b={option:{header:`Option`,separator:`--------`},alias:{header:`Alias`,separator:`-------`},description:{header:`Description`,separator:`-------------`},required:{header:`Required`,separator:`----------`},default:{header:`Default`,separator:`---------`},env:{header:`Env`,separator:`-----`}};function x(e,t){switch(t){case`option`:{let t=g(e.longFlag);return e.inlineNegation?`${t} / ${g(e.inlineNegation)}`:t}case`alias`:return e.aliases.length>0?e.aliases.map(g).join(`, `):`-`;case`description`:return h(e.description??``);case`required`:return e.required?`Yes`:`No`;case`default`:return _(e);case`env`:return v(e.env)}}function S(e,t){switch(t){case`option`:return g(e.flag);case`description`:return`${h(e.description)} ${e.relationMarker}`;case`required`:return e.required?`Yes`:`No`;case`alias`:case`default`:case`env`:return`-`}}function C(e,t){if(e.length===0)return``;let n=t??(e.some(e=>e.env)?[...l,`env`]:l),r=[];r.push(`| ${n.map(e=>b[e].header).join(` | `)} |`),r.push(`|${n.map(e=>b[e].separator).join(`|`)}|`);for(let t of e)r.push(`| ${n.map(e=>x(t,e)).join(` | `)} |`),t.negationRow&&r.push(`| ${n.map(e=>S(t.negationRow,e)).join(` | `)} |`);return r.join(`
+`)}function w(e){if(e.length===0)return``;let t=[];for(let n of e){let e=n.aliases.filter(e=>!e.startsWith(`--`)),r=n.aliases.filter(e=>e.startsWith(`--`)),i=[...e,n.longFlag,...r].map(g).join(`, `);n.inlineNegation&&(i+=` / ${g(n.inlineNegation)}`);let a=n.description?` - ${m(n.description)}`:``,o=n.required?` (required)`:``,s=n.hasDefault?` (default: ${JSON.stringify(n.defaultValue)})`:``,c=y(n.env);t.push(`- ${i}${a}${o}${s}${c}`),n.negationRow&&t.push(`- ${g(n.negationRow.flag)} - ${m(n.negationRow.description)} ${n.negationRow.relationMarker}`)}return t.join(`
+`)}const T=`POLITTY_DOCS_UPDATE`,E=`POLITTY_DOCS_DOCTOR`,D=[`heading`,`description`,`usage`,`arguments`,`options`,`global-options-link`,`subcommands`,`examples`,`notes`],O=`politty:command`;function k(e,t){return`<!-- ${O}:${t}:${e}:start -->`}function A(e,t){return`<!-- ${O}:${t}:${e}:end -->`}const j=`politty:global-options`;function M(){return`<!-- ${j}:start -->`}function N(){return`<!-- ${j}:end -->`}const P=`politty:root-header`;function ee(){return`<!-- ${P}:start -->`}function te(){return`<!-- ${P}:end -->`}const F=`politty:root-footer`;function ne(){return`<!-- ${F}:start -->`}function re(){return`<!-- ${F}:end -->`}const I=`politty:index`;function L(e){return`<!-- ${I}:${e}:start -->`}function ie(e){return`<!-- ${I}:${e}:end -->`}function R(e){return m(e.replace(/\|/g,`\\|`))}function z(e){let t=[e.fullCommandPath];e.options.length>0&&t.push(`[options]`),e.subCommands.length>0&&(e.command.run?t.push(`[command]`):t.push(`<command>`));for(let n of e.positionalArgs)n.required?t.push(`<${n.name}>`):t.push(`[${n.name}]`);return t.join(` `)}function B(e){if(e.positionalArgs.length===0)return``;let t=[];t.push(`| Argument | Description | Required |`),t.push(`|----------|-------------|----------|`);for(let n of e.positionalArgs){let e=R(n.description??``),r=n.required?`Yes`:`No`;t.push(`| \`${n.name}\` | ${e} | ${r} |`)}return t.join(`
+`)}function V(e){if(e.positionalArgs.length===0)return``;let t=[];for(let n of e.positionalArgs){let e=n.required?`(required)`:`(optional)`,r=n.description?` - ${m(n.description)}`:``;t.push(`- \`${n.name}\`${r} ${e}`)}return t.join(`
+`)}function ae(e){return C(p(e.options))}function oe(e){return w(p(e.options))}function se(e){return e.join(`-`).toLowerCase()}function ce(e,t){let n=e.replace(/\\/g,`/`),r=t.replace(/\\/g,`/`);return s.posix.relative(s.posix.dirname(n),r)}function le(e,t=!0){return me(e.subCommands,e,t)}function H(e){return C(p(e))}function ue(e,t=`table`){let n=e.unionOptions??[];if(n.length===0)return``;let r=[],i=new Set;for(let e of n)for(let t of e.fields)i.add(t.name);let a=new Set;for(let e of i)n.every(t=>t.fields.some(t=>t.name===e))&&a.add(e);let o=e.fields.filter(e=>a.has(e.name)&&!e.positional);o.length>0&&r.push(t===`table`?H(o):U(o)),r.push(`> One of the following option groups is required:`);for(let e=0;e<n.length;e++){let i=n[e];if(!i)continue;let o=i.fields.filter(e=>!a.has(e.name)&&!e.positional),s=i.description??`Variant ${e+1}`;if(o.length===0){r.push(`**${s}:**\n\n_no options_`);continue}let c=t===`table`?H(o):U(o);r.push(`**${s}:**\n\n${c}`)}return r.join(`
 
-//#region ../core/src/docs/option-rows.ts
-/** Canonical column order used when no explicit column subset is requested. */
-const DEFAULT_COLUMNS = [
-	"option",
-	"alias",
-	"description",
-	"required",
-	"default"
-];
-/**
-* 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}\`)`;
-}
-/**
-* Resolve placeholder for an option (uses kebab-case cliName).
-*/
-function resolvePlaceholder(opt) {
-	return opt.placeholder ?? opt.cliName.toUpperCase().replace(/-/g, "_");
-}
-/**
-* Normalize a single {@link ResolvedFieldMeta} into an {@link OptionRow}.
-*/
-function toOptionRow(opt) {
-	const longFlag = opt.type === "boolean" ? `--${opt.cliName}` : `--${opt.cliName} <${resolvePlaceholder(opt)}>`;
-	const aliases = [];
-	if (opt.alias) for (const a of opt.alias) aliases.push(a.length === 1 ? `-${a}` : `--${a}`);
-	const hasNegationDisplay = opt.type === "boolean" && !!opt.negationDisplay;
-	const inlineNegation = hasNegationDisplay && !opt.negationDescription ? `--${opt.negationDisplay}` : void 0;
-	const negationRow = hasNegationDisplay && opt.negationDescription ? {
-		flag: `--${opt.negationDisplay}`,
-		description: opt.negationDescription,
-		relationMarker: negationRelationMarker(opt),
-		required: opt.required
-	} : void 0;
-	return {
-		longFlag,
-		aliases,
-		inlineNegation,
-		description: opt.description,
-		required: opt.required,
-		hasDefault: opt.defaultValue !== void 0,
-		defaultValue: opt.defaultValue,
-		env: opt.env,
-		negationRow
-	};
-}
-/**
-* Build the normalized intermediate representation for a list of options.
-* This is the single source of truth for per-option display decisions; the
-* emitters below ({@link emitMarkdownTable}, {@link emitMarkdownList}) are pure
-* formatting.
-*/
-function toOptionRows(options) {
-	return options.map(toOptionRow);
-}
-/**
-* Convert hard line breaks in a description into `<br>` so they render as line
-* breaks inside a single markdown table cell or list item, instead of breaking
-* the surrounding table row / list structure.
-*/
-function inlineMarkdownBreaks(str) {
-	return str.replace(/\r?\n/g, "<br>");
-}
-/**
-* Escape markdown special characters in table cells. Embedded line breaks are
-* converted to `<br>` so multi-line descriptions stay within a single cell.
-*/
-function escapeTableCell$2(str) {
-	return inlineMarkdownBreaks(str.replace(/\|/g, "\\|"));
-}
-function backtick(value) {
-	return `\`${value}\``;
-}
-/**
-* Format default value for table display.
-*/
-function formatDefaultValue(row) {
-	if (!row.hasDefault) return "-";
-	return `\`${JSON.stringify(row.defaultValue)}\``;
-}
-/**
-* Format env variable names for a markdown table cell.
-*/
-function formatEnvNames(env) {
-	if (!env) return "-";
-	if (Array.isArray(env)) return env.map((e) => `\`${e}\``).join(", ");
-	return `\`${env}\``;
-}
-/**
-* Format env variable info for a markdown list item (e.g. `[env: PORT, SERVER_PORT]`).
-*/
-function formatEnvInfo(env) {
-	if (!env) return "";
-	return ` [env: ${(Array.isArray(env) ? env : [env]).join(", ")}]`;
-}
-/** Header label + separator dashes for each column, matching legacy widths. */
-const COLUMN_META = {
-	option: {
-		header: "Option",
-		separator: "--------"
-	},
-	alias: {
-		header: "Alias",
-		separator: "-------"
-	},
-	description: {
-		header: "Description",
-		separator: "-------------"
-	},
-	required: {
-		header: "Required",
-		separator: "----------"
-	},
-	default: {
-		header: "Default",
-		separator: "---------"
-	},
-	env: {
-		header: "Env",
-		separator: "-----"
-	}
-};
-/**
-* Render the table cell for a base option row in the given column.
-*/
-function tableCell(row, col) {
-	switch (col) {
-		case "option": {
-			const name = backtick(row.longFlag);
-			return row.inlineNegation ? `${name} / ${backtick(row.inlineNegation)}` : name;
-		}
-		case "alias": return row.aliases.length > 0 ? row.aliases.map(backtick).join(", ") : "-";
-		case "description": return escapeTableCell$2(row.description ?? "");
-		case "required": return row.required ? "Yes" : "No";
-		case "default": return formatDefaultValue(row);
-		case "env": return formatEnvNames(row.env);
-	}
-}
-/**
-* Render the table cell for a negation row in the given column.
-*/
-function negationTableCell(neg, col) {
-	switch (col) {
-		case "option": return backtick(neg.flag);
-		case "description": return `${escapeTableCell$2(neg.description)} ${neg.relationMarker}`;
-		case "required": return neg.required ? "Yes" : "No";
-		case "alias":
-		case "default":
-		case "env": return "-";
-	}
-}
-/**
-* Emit option rows as a markdown table.
-*
-* When `columns` is omitted, the canonical column set is used and the `Env`
-* column is appended automatically iff any row has env configured. When
-* `columns` is provided, exactly those columns are emitted, in that order.
-*
-* The separator row always uses the canonical fixed-width dashes from
-* {@link COLUMN_META}, so every table — default or column-filtered — shares a
-* single, consistent format.
-*/
-function emitMarkdownTable(rows, columns) {
-	if (rows.length === 0) return "";
-	const cols = columns ?? (rows.some((r) => r.env) ? [...DEFAULT_COLUMNS, "env"] : DEFAULT_COLUMNS);
-	const lines = [];
-	lines.push(`| ${cols.map((c) => COLUMN_META[c].header).join(" | ")} |`);
-	lines.push(`|${cols.map((c) => COLUMN_META[c].separator).join("|")}|`);
-	for (const row of rows) {
-		lines.push(`| ${cols.map((c) => tableCell(row, c)).join(" | ")} |`);
-		if (row.negationRow) lines.push(`| ${cols.map((c) => negationTableCell(row.negationRow, c)).join(" | ")} |`);
-	}
-	return lines.join("\n");
-}
-/**
-* Emit option rows as a markdown list.
-*
-* Aliases are joined with `, ` (short flags first, then the long flag, then
-* long aliases); the inline negation is appended with ` / ` so it stays
-* visually distinct from aliases.
-*/
-function emitMarkdownList(rows) {
-	if (rows.length === 0) return "";
-	const lines = [];
-	for (const row of rows) {
-		const shortAliases = row.aliases.filter((a) => !a.startsWith("--"));
-		const longAliases = row.aliases.filter((a) => a.startsWith("--"));
-		let flags = [
-			...shortAliases,
-			row.longFlag,
-			...longAliases
-		].map(backtick).join(", ");
-		if (row.inlineNegation) flags += ` / ${backtick(row.inlineNegation)}`;
-		const desc = row.description ? ` - ${inlineMarkdownBreaks(row.description)}` : "";
-		const required = row.required ? " (required)" : "";
-		const defaultVal = row.hasDefault ? ` (default: ${JSON.stringify(row.defaultValue)})` : "";
-		const envInfo = formatEnvInfo(row.env);
-		lines.push(`- ${flags}${desc}${required}${defaultVal}${envInfo}`);
-		if (row.negationRow) lines.push(`- ${backtick(row.negationRow.flag)} - ${inlineMarkdownBreaks(row.negationRow.description)} ${row.negationRow.relationMarker}`);
-	}
-	return lines.join("\n");
-}
+`)}function de(e,t=`table`){let n=e.discriminator,r=e.variants??[];if(!n||r.length===0)return``;let i=[],a=new Set;for(let e of r)for(let t of e.fields)a.add(t.name);let o=new Set;for(let e of a)e!==n&&r.every(t=>t.fields.some(t=>t.name===e))&&o.add(e);let s=e.fields.find(e=>e.name===n),c=r.map(e=>e.discriminatorValue).join(`\\|`),l=[];s&&l.push({...s,placeholder:c});for(let t of o){let n=e.fields.find(e=>e.name===t);n&&!n.positional&&l.push(n)}l.length>0&&i.push(t===`table`?H(l):U(l));for(let e of r){let r=e.fields.filter(e=>e.name!==n&&!o.has(e.name)&&!e.positional);if(r.length===0)continue;let a=e.description?` ${e.description}`:``,s=`**When \`${n}\` = \`${e.discriminatorValue}\`:**${a}`,c=t===`table`?H(r):U(r);i.push(`${s}\n\n${c}`)}return i.join(`
 
-//#endregion
-//#region ../core/src/docs/types.ts
-/**
-* Environment variable name for update mode
-*/
-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 = [
-	"heading",
-	"description",
-	"usage",
-	"arguments",
-	"options",
-	"global-options-link",
-	"subcommands",
-	"examples",
-	"notes"
-];
-/**
-* Marker prefix for command section markers in generated documentation
-* Format: <!-- politty:command:<scope>:<type>:start --> ... <!-- politty:command:<scope>:<type>:end -->
-*/
-const SECTION_MARKER_PREFIX = "politty:command";
-/**
-* Generate start marker for a command section
-*/
-function sectionStartMarker(type, scope) {
-	return `<!-- ${SECTION_MARKER_PREFIX}:${scope}:${type}:start -->`;
-}
-/**
-* Generate end marker for a command section
-*/
-function sectionEndMarker(type, scope) {
-	return `<!-- ${SECTION_MARKER_PREFIX}:${scope}:${type}:end -->`;
-}
-/**
-* Marker prefix for global options sections in generated documentation
-* Format: <!-- politty:global-options:start --> ... <!-- politty:global-options:end -->
-*/
-const GLOBAL_OPTIONS_MARKER_PREFIX = "politty:global-options";
-/**
-* Generate start marker for a global options section
-*/
-function globalOptionsStartMarker() {
-	return `<!-- ${GLOBAL_OPTIONS_MARKER_PREFIX}:start -->`;
-}
-/**
-* Generate end marker for a global options section
-*/
-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 -->
-*/
-const INDEX_MARKER_PREFIX = "politty:index";
-/**
-* Generate start marker for an index section
-*/
-function indexStartMarker(scope) {
-	return `<!-- ${INDEX_MARKER_PREFIX}:${scope}:start -->`;
-}
-/**
-* Generate end marker for an index section
-*/
-function indexEndMarker(scope) {
-	return `<!-- ${INDEX_MARKER_PREFIX}:${scope}:end -->`;
-}
+`)}function U(e){return w(p(e))}function fe(e){if(e.length===0)return``;let t=[];t.push(`| Argument | Description | Required |`),t.push(`|----------|-------------|----------|`);for(let n of e){let e=R(n.description??``),r=n.required?`Yes`:`No`;t.push(`| \`${n.name}\` | ${e} | ${r} |`)}return t.join(`
+`)}function pe(e){if(e.length===0)return``;let t=[];for(let n of e){let e=n.required?`(required)`:`(optional)`,r=n.description?` - ${m(n.description)}`:``;t.push(`- \`${n.name}\`${r} ${e}`)}return t.join(`
+`)}function me(e,t,n=!0){if(e.length===0)return``;let r=e.some(e=>e.aliases&&e.aliases.length>0),i=[];r?(i.push(`| Command | Aliases | Description |`),i.push(`|---------|---------|-------------|`)):(i.push(`| Command | Description |`),i.push(`|---------|-------------|`));let a=t.filePath,o=t.fileMap;for(let t of e){let e=t.fullPath.join(` `),s=R(t.description??``),c=t.fullPath.join(` `),l=r?t.aliases&&t.aliases.length>0?t.aliases.map(e=>`\`${R(e)}\``).join(`, `):`-`:``,u;if(n){let n=se(t.fullPath),r=o!==void 0&&Object.prototype.hasOwnProperty.call(o,c),i=r?o[c]:void 0;u=a&&i&&a!==i?`[\`${e}\`](${ce(a,i)}#${n})`:o&&!r?`\`${e}\``:`[\`${e}\`](#${n})`}else u=`\`${e}\``;r?i.push(`| ${u} | ${l} | ${s} |`):i.push(`| ${u} | ${s} |`)}return i.join(`
+`)}function he(e,t,n){if(e.length===0)return``;let r=n?.showOutput??!0,i=n?.commandPrefix?`${n.commandPrefix} `:``,a=[];for(let n=0;n<e.length;n++){let o=e[n];if(!o)continue;let s=t?.[n];a.push(`**${o.desc}**`),a.push(``),a.push("```bash"),a.push(`$ ${i}${o.cmd}`),r&&(s?(s.stdout&&a.push(s.stdout),s.stderr&&a.push(`[stderr] ${s.stderr}`)):o.output&&a.push(o.output)),a.push("```"),a.push(``)}for(;a.length>0&&a[a.length-1]===``;)a.pop();return a.join(`
+`)}function ge(e,t,n){return`${k(e,t)}\n${n}\n${A(e,t)}`}function _e(e){return!e.hasGlobalOptions||e.commandPath===``?null:`See [Global Options](${e.rootDocPath&&e.filePath&&e.filePath!==e.rootDocPath?`${ce(e.filePath,e.rootDocPath)}#global-options`:`#global-options`}) for options available to all commands.`}function W(e={}){let{headingLevel:t=1,optionStyle:n=`table`,generateAnchors:r=!0,includeSubcommandDetails:i=!0,markerless:a=!1,renderDescription:o,renderUsage:s,renderArguments:c,renderOptions:l,renderSubcommands:u,renderNotes:d,renderFooter:f,renderExamples:p}=e,m=a?(e,t,n)=>n:ge;return e=>{let a=[],h=e.commandPath,g=Math.min(t+(e.depth-1),6),_=`#`.repeat(g),v=e.commandPath||e.name;a.push(m(`heading`,h,`${_} ${v}`));{let t=[];if(e.description&&t.push(e.description),e.aliases&&e.aliases.length>0&&t.push(`**Aliases:** ${e.aliases.map(e=>`\`${e}\``).join(`, `)}`),t.length>0){let n={content:t.join(`
 
-//#endregion
-//#region ../core/src/docs/default-renderers.ts
-/**
-* Escape markdown special characters in table cells. Embedded line breaks are
-* converted to `<br>` so multi-line descriptions stay within a single cell.
-*/
-function escapeTableCell$1(str) {
-	return inlineMarkdownBreaks(str.replace(/\|/g, "\\|"));
-}
-/**
-* Render usage line
-*/
-function renderUsage(info) {
-	const parts = [info.fullCommandPath];
-	if (info.options.length > 0) parts.push("[options]");
-	if (info.subCommands.length > 0) if (info.command.run) parts.push("[command]");
-	else parts.push("<command>");
-	for (const arg of info.positionalArgs) if (arg.required) parts.push(`<${arg.name}>`);
-	else parts.push(`[${arg.name}]`);
-	return parts.join(" ");
-}
-/**
-* Render arguments as table
-*/
-function renderArgumentsTable(info) {
-	if (info.positionalArgs.length === 0) return "";
-	const lines = [];
-	lines.push("| Argument | Description | Required |");
-	lines.push("|----------|-------------|----------|");
-	for (const arg of info.positionalArgs) {
-		const desc = escapeTableCell$1(arg.description ?? "");
-		const required = arg.required ? "Yes" : "No";
-		lines.push(`| \`${arg.name}\` | ${desc} | ${required} |`);
-	}
-	return lines.join("\n");
-}
-/**
-* Render arguments as list
-*/
-function renderArgumentsList(info) {
-	if (info.positionalArgs.length === 0) return "";
-	const lines = [];
-	for (const arg of info.positionalArgs) {
-		const required = arg.required ? "(required)" : "(optional)";
-		const desc = arg.description ? ` - ${inlineMarkdownBreaks(arg.description)}` : "";
-		lines.push(`- \`${arg.name}\`${desc} ${required}`);
-	}
-	return lines.join("\n");
-}
-/**
-* Render options as markdown table
-*
-* Features:
-* - Uses kebab-case (cliName) for option names (e.g., `--dry-run` instead of `--dryRun`)
-* - Automatically adds Env column when any option has env configured
-* - Displays multiple env vars as comma-separated list
-*
-* @example
-* | Option | Alias | Description | Required | Default | Env |
-* |--------|-------|-------------|----------|---------|-----|
-* | `--dry-run` | `-d` | Dry run mode | No | `false` | - |
-* | `--port <PORT>` | - | Server port | Yes | - | `PORT`, `SERVER_PORT` |
-*/
-function renderOptionsTable(info) {
-	return emitMarkdownTable(toOptionRows(info.options));
-}
-/**
-* Render options as markdown list
-*
-* Features:
-* - Uses kebab-case (cliName) for option names (e.g., `--dry-run` instead of `--dryRun`)
-* - Appends env info at the end of each option (e.g., `[env: PORT, SERVER_PORT]`)
-*
-* @example
-* - `-d`, `--dry-run` - Dry run mode (default: false)
-* - `--port <PORT>` - Server port (required) [env: PORT, SERVER_PORT]
-*/
-function renderOptionsList(info) {
-	return emitMarkdownList(toOptionRows(info.options));
-}
-/**
-* Generate anchor from command path
-*/
-function generateAnchor$1(commandPath) {
-	return commandPath.join("-").toLowerCase();
-}
-/**
-* Generate relative path from one file to another.
-* Always emits forward slashes so Markdown links remain portable across OSes.
-*/
-function getRelativePath(from, to) {
-	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) {
-	return renderSubcommandsTableFromArray(info.subCommands, info, generateAnchors);
-}
-/**
-* Render options from array as table
-*/
-function renderOptionsTableFromArray(options) {
-	return emitMarkdownTable(toOptionRows(options));
-}
-/**
-* 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);
-		const label = option.description ?? `Variant ${i + 1}`;
-		if (uniqueFields.length === 0) {
-			sections.push(`**${label}:**\n\n_no options_`);
-			continue;
-		}
-		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) {
-	return emitMarkdownList(toOptionRows(options));
-}
-/**
-* Render arguments from array as table
-*/
-function renderArgumentsTableFromArray(args) {
-	if (args.length === 0) return "";
-	const lines = [];
-	lines.push("| Argument | Description | Required |");
-	lines.push("|----------|-------------|----------|");
-	for (const arg of args) {
-		const desc = escapeTableCell$1(arg.description ?? "");
-		const required = arg.required ? "Yes" : "No";
-		lines.push(`| \`${arg.name}\` | ${desc} | ${required} |`);
-	}
-	return lines.join("\n");
-}
-/**
-* Render arguments from array as list
-*/
-function renderArgumentsListFromArray(args) {
-	if (args.length === 0) return "";
-	const lines = [];
-	for (const arg of args) {
-		const required = arg.required ? "(required)" : "(optional)";
-		const desc = arg.description ? ` - ${inlineMarkdownBreaks(arg.description)}` : "";
-		lines.push(`- \`${arg.name}\`${desc} ${required}`);
-	}
-	return lines.join("\n");
-}
-/**
-* Render subcommands from array as table
-*/
-function renderSubcommandsTableFromArray(subcommands, info, generateAnchors = true) {
-	if (subcommands.length === 0) return "";
-	const hasAliases = subcommands.some((s) => s.aliases && s.aliases.length > 0);
-	const lines = [];
-	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$1(sub.description ?? "");
-		const subCommandPath = sub.fullPath.join(" ");
-		const aliasCell = hasAliases ? sub.aliases && sub.aliases.length > 0 ? sub.aliases.map((a) => `\`${escapeTableCell$1(a)}\``).join(", ") : "-" : "";
-		let cmdCell;
-		if (generateAnchors) {
-			const anchor = generateAnchor$1(sub.fullPath);
-			const hasSubFile = fileMap !== void 0 && Object.prototype.hasOwnProperty.call(fileMap, subCommandPath);
-			const subFile = hasSubFile ? fileMap[subCommandPath] : void 0;
-			if (currentFile && subFile && currentFile !== subFile) cmdCell = `[\`${fullName}\`](${getRelativePath(currentFile, subFile)}#${anchor})`;
-			else if (fileMap && !hasSubFile) cmdCell = `\`${fullName}\``;
-			else cmdCell = `[\`${fullName}\`](#${anchor})`;
-		} else cmdCell = `\`${fullName}\``;
-		if (hasAliases) lines.push(`| ${cmdCell} | ${aliasCell} | ${desc} |`);
-		else lines.push(`| ${cmdCell} | ${desc} |`);
-	}
-	return lines.join("\n");
-}
-/**
-* Render examples as markdown
-*
-* @example
-* **Basic usage**
-*
-* ```bash
-* $ greet World
-* ```
-*
-* Output:
-* ```
-* Hello, World!
-* ```
-*/
-function renderExamplesDefault(examples, results, opts) {
-	if (examples.length === 0) return "";
-	const showOutput = opts?.showOutput ?? true;
-	const prefix = opts?.commandPrefix ? `${opts.commandPrefix} ` : "";
-	const lines = [];
-	for (let i = 0; i < examples.length; i++) {
-		const example = examples[i];
-		if (!example) continue;
-		const result = results?.[i];
-		lines.push(`**${example.desc}**`);
-		lines.push("");
-		lines.push("```bash");
-		lines.push(`$ ${prefix}${example.cmd}`);
-		if (showOutput) {
-			if (result) {
-				if (result.stdout) lines.push(result.stdout);
-				if (result.stderr) lines.push(`[stderr] ${result.stderr}`);
-			} else if (example.output) lines.push(example.output);
-		}
-		lines.push("```");
-		lines.push("");
-	}
-	while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-	return lines.join("\n");
-}
-/**
-* Wrap content with section markers
-*/
-function wrapWithMarker(type, scope, content) {
-	return `${sectionStartMarker(type, scope)}\n${content}\n${sectionEndMarker(type, scope)}`;
-}
-/**
-* 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, markerless = false, renderDescription: customRenderDescription, renderUsage: customRenderUsage, renderArguments: customRenderArguments, renderOptions: customRenderOptions, renderSubcommands: customRenderSubcommands, renderNotes: customRenderNotes, renderFooter: customRenderFooter, renderExamples: customRenderExamples } = options;
-	const wrap = markerless ? (_type, _scope, content) => content : wrapWithMarker;
-	return (info) => {
-		const sections = [];
-		const scope = info.commandPath;
-		const effectiveLevel = Math.min(headingLevel + (info.depth - 1), 6);
-		const h = "#".repeat(effectiveLevel);
-		const title = info.commandPath || info.name;
-		sections.push(wrap("heading", scope, `${h} ${title}`));
-		{
-			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(wrap("description", scope, content));
-			}
-		}
-		{
-			const context = {
-				content: `**Usage**\n\n\`\`\`\n${renderUsage(info)}\n\`\`\``,
-				heading: "**Usage**",
-				info
-			};
-			const content = customRenderUsage ? customRenderUsage(context) : context.content;
-			if (content) sections.push(wrap("usage", scope, content));
-		}
-		if (info.positionalArgs.length > 0) {
-			const renderArgs = (args, opts) => {
-				const style = opts?.style ?? optionStyle;
-				const withHeading = opts?.withHeading ?? true;
-				const content = style === "table" ? renderArgumentsTableFromArray(args) : renderArgumentsListFromArray(args);
-				return withHeading ? `**Arguments**\n\n${content}` : content;
-			};
-			const context = {
-				args: info.positionalArgs,
-				render: renderArgs,
-				heading: "**Arguments**",
-				info
-			};
-			const content = customRenderArguments ? customRenderArguments(context) : renderArgs(context.args);
-			if (content) sections.push(wrap("arguments", scope, content));
-		}
-		if (info.options.length > 0) {
-			const renderOpts = (opts, renderOpts) => {
-				const style = renderOpts?.style ?? optionStyle;
-				const withHeading = renderOpts?.withHeading ?? true;
-				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 = {
-				options: info.options,
-				render: renderOpts,
-				heading: "**Options**",
-				info
-			};
-			const content = customRenderOptions ? customRenderOptions(context) : renderOpts(context.options);
-			if (content) sections.push(wrap("options", scope, content));
-		}
-		{
-			const globalLink = getGlobalOptionsLink(info);
-			if (globalLink) sections.push(wrap("global-options-link", scope, globalLink));
-		}
-		if (info.subCommands.length > 0) {
-			const effectiveAnchors = generateAnchors && includeSubcommandDetails;
-			const renderSubs = (subs, opts) => {
-				const anchors = opts?.generateAnchors ?? effectiveAnchors;
-				const withHeading = opts?.withHeading ?? true;
-				const content = renderSubcommandsTableFromArray(subs, info, anchors);
-				return withHeading ? `**Commands**\n\n${content}` : content;
-			};
-			const context = {
-				subcommands: info.subCommands,
-				render: renderSubs,
-				heading: "**Commands**",
-				info
-			};
-			const content = customRenderSubcommands ? customRenderSubcommands(context) : renderSubs(context.subcommands);
-			if (content) sections.push(wrap("subcommands", scope, content));
-		}
-		if (info.examples && info.examples.length > 0) {
-			const renderEx = (examples, results, opts) => {
-				const withHeading = opts?.withHeading ?? true;
-				const content = renderExamplesDefault(examples, results, {
-					commandPrefix: info.fullCommandPath,
-					...opts
-				});
-				return withHeading ? `**Examples**\n\n${content}` : content;
-			};
-			const context = {
-				examples: info.examples,
-				results: info.exampleResults,
-				render: renderEx,
-				heading: "**Examples**",
-				info
-			};
-			const content = customRenderExamples ? customRenderExamples(context) : renderEx(context.examples, context.results);
-			if (content) sections.push(wrap("examples", scope, content));
-		}
-		if (info.notes) {
-			const context = {
-				content: `**Notes**\n\n${info.notes}`,
-				heading: "**Notes**",
-				info
-			};
-			const content = customRenderNotes ? customRenderNotes(context) : context.content;
-			if (content) sections.push(wrap("notes", scope, content));
-		}
-		{
-			const context = {
-				content: "",
-				heading: "",
-				info
-			};
-			const content = customRenderFooter ? customRenderFooter(context) : context.content;
-			if (content) sections.push(content);
-		}
-		return sections.join("\n\n") + "\n";
-	};
-}
-/**
-* 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" })
-};
+`),heading:``,info:e},r=o?o(n):n.content;r&&a.push(m(`description`,h,r))}}{let t={content:`**Usage**\n\n\`\`\`\n${z(e)}\n\`\`\``,heading:`**Usage**`,info:e},n=s?s(t):t.content;n&&a.push(m(`usage`,h,n))}if(e.positionalArgs.length>0){let t=(e,t)=>{let r=t?.style??n,i=t?.withHeading??!0,a=r===`table`?fe(e):pe(e);return i?`**Arguments**\n\n${a}`:a},r={args:e.positionalArgs,render:t,heading:`**Arguments**`,info:e},i=c?c(r):t(r.args);i&&a.push(m(`arguments`,h,i))}if(e.options.length>0){let t=(t,r)=>{let i=r?.style??n,a=r?.withHeading??!0,o=e.extracted,s;return s=o&&(o.schemaType===`union`||o.schemaType===`xor`)&&o.unionOptions?ue(o,i):o&&o.schemaType===`discriminatedUnion`&&o.discriminator?de(o,i):i===`table`?H(t):U(t),a?`**Options**\n\n${s}`:s},r={options:e.options,render:t,heading:`**Options**`,info:e},i=l?l(r):t(r.options);i&&a.push(m(`options`,h,i))}{let t=_e(e);t&&a.push(m(`global-options-link`,h,t))}if(e.subCommands.length>0){let t=r&&i,n=(n,r)=>{let i=r?.generateAnchors??t,a=r?.withHeading??!0,o=me(n,e,i);return a?`**Commands**\n\n${o}`:o},o={subcommands:e.subCommands,render:n,heading:`**Commands**`,info:e},s=u?u(o):n(o.subcommands);s&&a.push(m(`subcommands`,h,s))}if(e.examples&&e.examples.length>0){let t=(t,n,r)=>{let i=r?.withHeading??!0,a=he(t,n,{commandPrefix:e.fullCommandPath,...r});return i?`**Examples**\n\n${a}`:a},n={examples:e.examples,results:e.exampleResults,render:t,heading:`**Examples**`,info:e},r=p?p(n):t(n.examples,n.results);r&&a.push(m(`examples`,h,r))}if(e.notes){let t={content:`**Notes**\n\n${e.notes}`,heading:`**Notes**`,info:e},n=d?d(t):t.content;n&&a.push(m(`notes`,h,n))}{let t={content:``,heading:``,info:e},n=f?f(t):t.content;n&&a.push(n)}return a.join(`
 
-//#endregion
-//#region ../core/src/docs/doc-comparator.ts
-/**
-* Compare generated content with existing file
-*/
-function compareWithExisting(generatedContent, filePath) {
-	const absolutePath = path$1.resolve(filePath);
-	if (!fs.existsSync(absolutePath)) return {
-		match: false,
-		fileExists: false
-	};
-	const existingContent = fs.readFileSync(absolutePath, "utf-8");
-	if (generatedContent === existingContent) return {
-		match: true,
-		fileExists: true
-	};
-	return {
-		match: false,
-		diff: formatDiff(existingContent, generatedContent),
-		fileExists: true
-	};
-}
-/**
-* Format diff between two strings in unified diff format
-*/
-function formatDiff(expected, actual) {
-	const expectedLines = expected.split("\n");
-	const actualLines = actual.split("\n");
-	const result = [];
-	result.push("--- existing");
-	result.push("+++ generated");
-	result.push("");
-	const maxLines = Math.max(expectedLines.length, actualLines.length);
-	let inChunk = false;
-	let chunkStart = 0;
-	const chunk = [];
-	const flushChunk = () => {
-		if (chunk.length > 0) {
-			result.push(`@@ -${chunkStart + 1},${chunk.length} @@`);
-			result.push(...chunk);
-			chunk.length = 0;
-		}
-		inChunk = false;
-	};
-	for (let i = 0; i < maxLines; i++) {
-		const expectedLine = expectedLines[i];
-		const actualLine = actualLines[i];
-		if (expectedLine === actualLine) {
-			if (inChunk) {
-				chunk.push(` ${expectedLine ?? ""}`);
-				const lastChangeIndex = chunk.findIndex((line, idx) => (line.startsWith("-") || line.startsWith("+")) && chunk.slice(idx + 1).every((l) => l.startsWith(" ")));
-				if (lastChangeIndex !== -1 && chunk.length - lastChangeIndex > 3) flushChunk();
-			}
-		} else {
-			if (!inChunk) {
-				inChunk = true;
-				chunkStart = i;
-				const contextStart = Math.max(0, i - 3);
-				for (let j = contextStart; j < i; j++) chunk.push(` ${expectedLines[j] ?? ""}`);
-			}
-			if (expectedLine !== void 0 && (actualLine === void 0 || expectedLine !== actualLine)) chunk.push(`-${expectedLine}`);
-			if (actualLine !== void 0 && (expectedLine === void 0 || expectedLine !== actualLine)) chunk.push(`+${actualLine}`);
-		}
-	}
-	flushChunk();
-	return result.join("\n");
-}
-/**
-* Write content to file, creating directories if needed
-*/
-function writeFile(filePath, content) {
-	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");
-}
-/**
-* Read file content if it exists
-* Returns null if file does not exist
-*/
-function readFile(filePath) {
-	const absolutePath = path$1.resolve(filePath);
-	if (!fs.existsSync(absolutePath)) return null;
-	return fs.readFileSync(absolutePath, "utf-8");
-}
-/**
-* Delete file if it exists
-* @param filePath - Path to the file to delete
-* @param fileSystem - Optional fs implementation (useful when fs is mocked)
-*/
-function deleteFile(filePath, fileSystem = fs) {
-	const absolutePath = path$1.resolve(filePath);
-	if (fileSystem.existsSync(absolutePath)) fileSystem.unlinkSync(absolutePath);
-}
+`)+`
+`}}const ve={command:e=>W(e),tableStyle:W({optionStyle:`table`}),listStyle:W({optionStyle:`list`})};function ye(e,t){let n=o.resolve(t);if(!a.existsSync(n))return{match:!1,fileExists:!1};let r=a.readFileSync(n,`utf-8`);return e===r?{match:!0,fileExists:!0}:{match:!1,diff:G(r,e),fileExists:!0}}function G(e,t){let n=e.split(`
+`),r=t.split(`
+`),i=[];i.push(`--- existing`),i.push(`+++ generated`),i.push(``);let a=Math.max(n.length,r.length),o=!1,s=0,c=[],l=()=>{c.length>0&&(i.push(`@@ -${s+1},${c.length} @@`),i.push(...c),c.length=0),o=!1};for(let e=0;e<a;e++){let t=n[e],i=r[e];if(t===i){if(o){c.push(` ${t??``}`);let e=c.findIndex((e,t)=>(e.startsWith(`-`)||e.startsWith(`+`))&&c.slice(t+1).every(e=>e.startsWith(` `)));e!==-1&&c.length-e>3&&l()}}else{if(!o){o=!0,s=e;let t=Math.max(0,e-3);for(let r=t;r<e;r++)c.push(` ${n[r]??``}`)}t!==void 0&&(i===void 0||t!==i)&&c.push(`-${t}`),i!==void 0&&(t===void 0||t!==i)&&c.push(`+${i}`)}}return l(),i.join(`
+`)}function K(e,t){let n=o.resolve(e),r=o.dirname(n);a.existsSync(r)||a.mkdirSync(r,{recursive:!0}),a.writeFileSync(n,t,`utf-8`)}function be(e){let t=o.resolve(e);return a.existsSync(t)?a.readFileSync(t,`utf-8`):null}function xe(e,t=a){let n=o.resolve(e);t.existsSync(n)&&t.unlinkSync(n)}async function Se(e,n,r=[]){let a=t(e),o=a?.fields.filter(e=>e.positional)??[],s=a?.fields.filter(e=>!e.positional)??[],c=[];if(e.subCommands)for(let[t,n]of Object.entries(e.subCommands)){let e=await i(n),a=[...r,t];c.push({name:t,description:e.description,aliases:e.aliases,fullPath:a})}return{name:e.name??``,description:e.description,aliases:e.aliases,fullCommandPath:r.length>0?`${n} ${r.join(` `)}`:n,commandPath:r.join(` `),depth:r.length+1,positionalArgs:o,options:s,subCommands:c,extracted:a,command:e,notes:e.notes,examples:e.examples}}async function Ce(e,t){let n=t??e.name??`command`,r=new Map;async function a(e,t){let o=await Se(e,n,t),s=t.join(` `);if(r.set(s,o),e.subCommands)for(let[n,r]of Object.entries(e.subCommands))await a(await i(r),[...t,n])}return await a(e,[]),r}async function we(e,t,n,r=[]){let i=[];t.mock&&await t.mock();try{for(let t of e){let e=await Te(t,n,r);i.push(e)}}finally{t.cleanup&&await t.cleanup()}return i}async function Te(e,t,n){let i=Ee(e.cmd),a=[...n,...i],o=r({passthrough:!1});o.start();let s=!0;try{let{runCommand:e}=await import(`./runner-C_wCXh6X.js`),n=await e(t,a);s=n.success,!n.success&&n.error&&console.error(n.error.message)}catch(e){s=!1,console.error(e instanceof Error?e.message:String(e))}finally{o.stop()}let c=o.getLogs(),l=c.entries.filter(e=>e.stream===`stdout`).map(e=>e.message).join(`
+`),u=c.entries.filter(e=>e.stream===`stderr`).map(e=>e.message).join(`
+`);return{cmd:e.cmd,desc:e.desc,expectedOutput:e.output,stdout:l,stderr:u,success:s}}function Ee(e){let t=[],n=``,r=!1,i=``;for(let a=0;a<e.length;a++){let o=e[a];(o===`"`||o===`'`)&&!r?(r=!0,i=o):o===i&&r?(r=!1,i=``):o===` `&&!r?n&&=(t.push(n),``):n+=o}return n&&t.push(n),t}function De(t){let n=e();return Object.entries(t).map(([e,t])=>n.resolveFieldMeta(e,t))}function Oe(e,t){let n=De(e).filter(e=>!e.positional);return n.length===0?``:C(p(n),t?.columns)}function ke(e){return e.replace(/\|/g,`\\|`).replace(/\n/g,` `)}function Ae(e){return e.replace(/\s+/g,`-`).toLowerCase()}function je(e){return e.subCommands.length===0}function Me(e,t){return e===t?!0:t===``?e!==``:e.startsWith(t+` `)}function Ne(e,t,n){let r=[];for(let i of e){let e=t.get(i);if(e){if(je(e))r.push(i);else for(let[e,a]of t)(i===``?e.length>0:e.startsWith(i+` `)||e===i)&&(je(a)||!n)&&r.push(e)}}return r}function Pe(e,t,n,r){let i=`#`.repeat(n),a=[];a.push(`${i} [${e.title}](${e.docPath})`),a.push(``),a.push(e.description),a.push(``);let o=e.noExpand?e.commands:Ne(e.commands,t,r),s=o,c=new Set;if(e.allowedCommands){let t=new Set(e.allowedCommands);s=o.filter(e=>t.has(e));for(let n of e.commands)t.has(n)&&!s.some(e=>Me(e,n))&&(s.push(n),c.add(n))}a.push(`| Command | Description |`),a.push(`|---------|-------------|`);for(let n of s){let i=t.get(n);if(!i||!e.noExpand&&r&&!c.has(n)&&!je(i))continue;let o=n||i.name,s=Ae(o),l=ke(i.description??``);a.push(`| [${o}](${e.docPath}#${s}) | ${l} |`)}return a.join(`
+`)}async function Fe(e,t,n){let r=n?.headingLevel??3,i=n?.leafOnly??!0,a=await Ce(e),o=[];for(let e of t){let t=Pe(e,a,r,i);o.push(t)}return o.join(`
 
-//#endregion
-//#region ../core/src/docs/doc-generator.ts
-/**
-* Build CommandInfo from a command
-*/
-async function buildCommandInfo(command, rootName, commandPath = []) {
-	const extracted = getExtractedFields(command);
-	const positionalArgs = extracted?.fields.filter((f) => f.positional) ?? [];
-	const options = extracted?.fields.filter((f) => !f.positional) ?? [];
-	const subCommands = [];
-	if (command.subCommands) for (const [name, subCmd] of Object.entries(command.subCommands)) {
-		const resolved = await resolveLazyCommand(subCmd);
-		const fullPath = [...commandPath, name];
-		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,
-		positionalArgs,
-		options,
-		subCommands,
-		extracted,
-		command,
-		notes: command.notes,
-		examples: command.examples
-	};
-}
-/**
-* Collect all commands with their paths
-* Returns a map of command path -> CommandInfo
-*/
-async function collectAllCommands(command, rootName) {
-	const root = rootName ?? command.name ?? "command";
-	const result = /* @__PURE__ */ new Map();
-	async function traverse(cmd, path) {
-		const info = await buildCommandInfo(cmd, root, path);
-		const pathKey = path.join(" ");
-		result.set(pathKey, info);
-		if (cmd.subCommands) for (const [name, subCmd] of Object.entries(cmd.subCommands)) await traverse(await resolveLazyCommand(subCmd), [...path, name]);
-	}
-	await traverse(command, []);
-	return result;
-}
+`)}async function q(e,t){if(!t)return e;let n=await t(e);return!e.endsWith(`
+`)&&n.endsWith(`
+`)?n.slice(0,-1):n}function Ie(e){let t=process.env[e];return t===`true`||t===`1`}function Le(e){let t=e.split(/\r?\n/);if(t[0]!==`---`)return null;let n=[];for(let e=1;e<t.length;e++){let r=t[e];if(r===`---`||r===`...`)return n.join(`
+`);n.push(r??``)}return null}function Re(e){let t=ht(e),n=e.split(/\r?\n/);if(n[0]!==`---`)return e;let r=-1;for(let e=1;e<n.length;e++){let t=n[e];if(t===`---`||t===`...`){r=e;break}}if(r===-1)return e;let i=n.slice(1,r),a=[];for(let e=0;e<i.length;e++){let t=i[e]??``;if(!/^politty\s*:\s*(.*)$/.test(t)){a.push(t);continue}for(;e+1<i.length;){let t=i[e+1]??``;if(t.trim()!==``&&!t.startsWith(` `)&&!t.startsWith(`	`))break;e++}}let o=n.slice(r+1);return a.some(e=>e.trim()!==``)?[`---`,...a,n[r]??`---`,...o].join(t):o.join(t).replace(RegExp(`^${t}`),``)}function ze(e){let t=e.trim();return t.length>=2&&(t.startsWith(`"`)&&t.endsWith(`"`)||t.startsWith(`'`)&&t.endsWith(`'`))?t.slice(1,-1):t}function Be(e){let t=ze(e);if(t===``)return null;let n=t.match(/^\{\{politty:([^{}]*)\}\}$/);return n?t=n[1]??``:t.startsWith(`politty:`)&&(t=t.slice(8)),t===``?null:t}function Ve(e){return e.slice(2,-2).slice(8)}function He(e){let t=e.trim();return!t.startsWith(`[`)||!t.endsWith(`]`)?[t]:t.slice(1,-1).split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function Ue(e,t){let n=Be(t);n!==null&&e.add(n)}function We(e){let t=new Set,n=Le(e);if(n===null)return t;let r=!1,i=!1,a=0;for(let e of n.split(/\r?\n/)){let n=e.trim();if(n===``||n.startsWith(`#`))continue;let o=e.match(/^politty\s*:\s*(.*)$/);if(o){r=(o[1]?.trim()??``)===``,i=!1;continue}if(!e.startsWith(` `)&&!e.startsWith(`	`)){r=!1,i=!1;continue}if(!r)continue;let s=e.match(/^(\s+)(?:exclude|excludes)\s*:\s*(.*)$/);if(s){let e=s[2]?.trim()??``;if(e===``)i=!0,a=s[1]?.length??0;else{i=!1;for(let n of He(e))Ue(t,n)}continue}if(!i)continue;let c=e.match(/^(\s*)-\s*(.+)$/);if(!c||(c[1]?.length??0)<=a){i=!1;continue}Ue(t,c[2]??``)}return t}function Ge(e){let t=Le(e);if(t===null)return{};let n=!1,r=!1,i=0,a={};for(let e of t.split(/\r?\n/)){let t=e.trim();if(t===``||t.startsWith(`#`))continue;let o=e.match(/^politty\s*:\s*(.*)$/);if(o){n=(o[1]?.trim()??``)===``,r=!1;continue}if(!e.startsWith(` `)&&!e.startsWith(`	`)){n=!1,r=!1;continue}if(!n)continue;let s=e.match(/^(\s+)index\s*:\s*(.*)$/);if(s){r=(s[2]?.trim()??``)===``,i=s[1]?.length??0;continue}if(!r)continue;if((e.match(/^(\s*)/)?.[1]?.length??0)<=i){r=!1;continue}let c=e.match(/^\s+(title|description)\s*:\s*(.+)$/);if(!c)continue;let l=c[1],u=ze(c[2]??``);l===`title`?a.title=u:l===`description`&&(a.description=u)}return a}function Ke(e){return{rawKeys:e,commandScopes:new Set,commandSections:new Map,globalOptions:!1,index:!1}}function qe(e,t,n){Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0})}function Je(e){if(Array.isArray(e))return{commands:e};if(!(`commands`in e)||!Array.isArray(e.commands))throw Error(`Invalid file config: object form must include a "commands" array. Use [] to skip generation intentionally.`);return e}function J(e,t){return t===``||e===t||e.startsWith(t+` `)}function Y(e){return e.includes(`*`)}function Ye(e,t){let n=e===``?[]:e.split(` `),r=t===``?[]:t.split(` `);if(n.length!==r.length)return!1;for(let e=0;e<r.length;e++){let t=r[e],i=n[e];if(t!==`*`&&t!==i)return!1}return!0}function Xe(e,t){let n=[];for(let r of t.keys())Ye(r,e)&&n.push(r);return n}function Ze(e,t){if(Y(t)){if(Ye(e,t))return!0;let n=e===``?[]:e.split(` `),r=t===``?[]:t.split(` `);return n.length>r.length&&Ye(n.slice(0,r.length).join(` `),t)}return J(e,t)}function Qe(e,t){let n=new Set,r=e.flatMap(e=>Y(e)?Xe(e,t):[e]);for(let e of r)for(let r of t.keys())J(r,e)&&n.add(r);return Array.from(n)}function $e(e,t){return e.filter(e=>!t.some(t=>Ze(e,t)))}function et(e,t){let n=[];for(let r of e)Y(r)?n.push(...Xe(r,t)):t.has(r)&&n.push(r);return n}function X(e,t,n){let r=Je(e),i=r.commands;return{fileConfig:r,specifiedCommands:i,commandPaths:$e(r.noExpand?i.filter(e=>t.has(e)):Qe(i,t),n),topLevelCommands:$e(et(i,t),n)}}function tt(e,t,n){let r=[];for(let i of e){let e=Y(i)?Xe(i,n):[i];for(let n of e)for(let e of t)Y(e)?Ye(n,e)&&r.push(`"${n}" is both in files and ignored by "${e}"`):(n===e||J(n,e))&&r.push(`"${n}" is both in files and ignored by "${e}"`)}if(r.length>0)throw Error(`Conflict between files and ignores:\n  - ${r.join(`
+  - `)}`)}function nt(e,t){let n=[];for(let r of e)Y(r)?Xe(r,t).length===0&&n.push(`"${r}"`):t.has(r)||n.push(`"${r}"`);if(n.length>0)throw Error(`Ignored command paths do not exist: ${n.join(`, `)}`)}function rt(e,t){let n=new Set(e),r=t.filter(e=>n.has(e));for(let t of e)(t===``?0:t.split(` `).length)===1&&!r.includes(t)&&r.push(t);let i=[],a=new Set;function o(t){if(a.has(t)||!n.has(t))return;a.add(t),i.push(t);let r=e.filter(e=>e===t||a.has(e)?!1:t===``?e.split(` `).length===1:e.startsWith(t+` `)&&e.split(` `).length===t.split(` `).length+1).sort((e,t)=>e.localeCompare(t));for(let e of r)o(e)}for(let e of r)o(e);for(let t of e)a.has(t)||i.push(t);return i}function it(e){if(!e.title&&!e.description)return null;let t=[];if(e.title){let n=`#`.repeat(e.headingLevel??1);t.push(`${n} ${e.title}`)}return e.description&&(t.push(``),t.push(e.description)),t.push(``),t.join(`
+`)}function at(e){if(!/^#{1,6} /.test(e))return null;let t=e.indexOf(`
+`);if(t===-1)return e;let n=t+1;for(e[n]===`
+`&&(n+=1);n<e.length;){let t=e.indexOf(`
+`,n),r=t===-1?e.slice(n):e.slice(n,t);if(r.length===0||/^#{1,6}\s/.test(r)||r.startsWith(`<!-- politty:`))break;n=t===-1?e.length:t+1}return e.slice(0,n)}function ot(e,t,n){let r=it(t);if(!r||e.startsWith(r))return{content:e,hasError:!1,wasUpdated:!1};let i=at(e)??``;return n?{content:`${r}${(i?e.slice(i.length):e).replace(/^\n+/,``)}`,hasError:!1,wasUpdated:!0}:{content:e,diff:G(i,r),hasError:!0,wasUpdated:!1}}function Z(e){return e===``?`<root>`:e}function Q(e,t,n){return jt(e,k(t,n),A(t,n))}function st(e,t,n,r){return Mt(e,k(t,n),A(t,n),r)}function ct(e,t,n,r){let i=D.indexOf(t),a=k(t,n),o=A(t,n),s=null;for(let t=i-1;t>=0;t--){let r=D[t],i=A(r,n),a=e.indexOf(i);if(a!==-1){s=a+i.length;break}}let c=null;for(let t=i+1;t<D.length;t++){let r=D[t],i=k(r,n),a=e.indexOf(i);if(a!==-1){c=a;break}}if(s!=null&&c!=null){let t=a+e.slice(s,c).replace(/^\n+/,`
+`).replace(/\n+$/,`
+`)+o;return e.slice(0,s)+`
 
-//#endregion
-//#region ../core/src/docs/example-executor.ts
-/**
-* Execute examples for a command and capture output
-*
-* @param examples - Examples to execute
-* @param config - Execution configuration (mock setup/cleanup)
-* @param rootCommand - Root command to execute against
-* @param commandPath - Command path for subcommands (e.g., ["config", "get"])
-* @returns Array of execution results with captured stdout/stderr
-*/
-async function executeExamples(examples, config, rootCommand, commandPath = []) {
-	const results = [];
-	if (config.mock) await config.mock();
-	try {
-		for (const example of examples) {
-			const result = await executeSingleExample(example, rootCommand, commandPath);
-			results.push(result);
-		}
-	} finally {
-		if (config.cleanup) await config.cleanup();
-	}
-	return results;
-}
-/**
-* Execute a single example and capture output
-*/
-async function executeSingleExample(example, rootCommand, commandPath) {
-	const exampleArgs = parseExampleCmd(example.cmd);
-	const argv = [...commandPath, ...exampleArgs];
-	const collector = createLogCollector({ passthrough: false });
-	collector.start();
-	let success = true;
-	try {
-		const { runCommand } = await import("./runner-MMjpKeEa.js");
-		const result = await runCommand(rootCommand, argv);
-		success = result.success;
-		if (!result.success && result.error) console.error(result.error.message);
-	} catch (error) {
-		success = false;
-		console.error(error instanceof Error ? error.message : String(error));
-	} finally {
-		collector.stop();
-	}
-	const logs = collector.getLogs();
-	const stdout = logs.entries.filter((e) => e.stream === "stdout").map((e) => e.message).join("\n");
-	const stderr = logs.entries.filter((e) => e.stream === "stderr").map((e) => e.message).join("\n");
-	return {
-		cmd: example.cmd,
-		desc: example.desc,
-		expectedOutput: example.output,
-		stdout,
-		stderr,
-		success
-	};
-}
-/**
-* Parse example command string into argv array
-* Handles quoted strings (single and double quotes)
-*
-* @example
-* parseExampleCmd('World') // ['World']
-* parseExampleCmd('--name "John Doe"') // ['--name', 'John Doe']
-* parseExampleCmd("--greeting 'Hello World'") // ['--greeting', 'Hello World']
-*/
-function parseExampleCmd(cmd) {
-	const args = [];
-	let current = "";
-	let inQuote = false;
-	let quoteChar = "";
-	for (let i = 0; i < cmd.length; i++) {
-		const char = cmd[i];
-		if ((char === "\"" || char === "'") && !inQuote) {
-			inQuote = true;
-			quoteChar = char;
-		} else if (char === quoteChar && inQuote) {
-			inQuote = false;
-			quoteChar = "";
-		} else if (char === " " && !inQuote) {
-			if (current) {
-				args.push(current);
-				current = "";
-			}
-		} else current += char;
-	}
-	if (current) args.push(current);
-	return args;
-}
+`+t+`
 
-//#endregion
-//#region ../core/src/docs/render-args.ts
-/**
-* Extract ResolvedFieldMeta array from ArgsShape
-*
-* This converts a raw args shape (like `commonArgs`) into the
-* ResolvedFieldMeta format used by politty's rendering functions.
-* Fields are resolved one by one — same result as wrapping the shape in
-* `z.object()` and extracting, without constructing a schema at runtime.
-*/
-function extractArgsFields(args) {
-	const adapter = getValidatorAdapter();
-	return Object.entries(args).map(([name, fieldSchema]) => adapter.resolveFieldMeta(name, fieldSchema));
-}
-/**
-* Render args definition as a markdown options table
-*
-* This function takes raw args definitions (like `commonArgs`) and
-* renders them as a markdown table suitable for documentation.
-*
-* @example
-* import { renderArgsTable } from "politty/docs";
-* import { commonArgs, workspaceArgs } from "./args";
-*
-* const table = renderArgsTable({
-*   ...commonArgs,
-*   ...workspaceArgs,
-* });
-* // | Option | Alias | Description | Default |
-* // |--------|-------|-------------|---------|
-* // | `--env-file <ENV_FILE>` | `-e` | Path to environment file | - |
-* // ...
-*
-* @param args - Args shape (record of field names to the CLI's schema-library schemas, with arg() metadata)
-* @param options - Rendering options
-* @returns Rendered markdown table string
-*/
-function renderArgsTable(args, options) {
-	const optionFields = extractArgsFields(args).filter((f) => !f.positional);
-	if (optionFields.length === 0) return "";
-	return emitMarkdownTable(toOptionRows(optionFields), options?.columns);
-}
+`+e.slice(c)}if(s!=null){let t=s;for(;t<e.length&&e[t]===`
+`;)t++;return e.slice(0,s)+`
 
-//#endregion
-//#region ../core/src/docs/render-index.ts
-/**
-* Escape markdown special characters in table cells
-*/
-function escapeTableCell(str) {
-	return str.replace(/\|/g, "\\|").replace(/\n/g, " ");
-}
-/**
-* Generate anchor from command path
-*/
-function generateAnchor(commandPath) {
-	return commandPath.replace(/\s+/g, "-").toLowerCase();
-}
-/**
-* Check if a command is a leaf (has no subcommands)
-*/
-function isLeafCommand(info) {
-	return info.subCommands.length === 0;
-}
-function isSubcommandOf$1(childPath, parentPath) {
-	if (childPath === parentPath) return true;
-	if (parentPath === "") return childPath !== "";
-	return childPath.startsWith(parentPath + " ");
-}
-/**
-* Expand commands to include their subcommands
-* If a command has subcommands, recursively find all commands under it
-*
-* @param commandPaths - Command paths to expand
-* @param allCommands - Map of all available commands
-* @param leafOnly - If true, only include leaf commands; if false, include all commands
-*/
-function expandCommands(commandPaths, allCommands, leafOnly) {
-	const result = [];
-	for (const cmdPath of commandPaths) {
-		const info = allCommands.get(cmdPath);
-		if (!info) continue;
-		if (isLeafCommand(info)) result.push(cmdPath);
-		else for (const [path, pathInfo] of allCommands) if (cmdPath === "" ? path.length > 0 : path.startsWith(cmdPath + " ") || path === cmdPath) {
-			if (isLeafCommand(pathInfo) || !leafOnly) result.push(path);
-		}
-	}
-	return result;
-}
-/**
-* Render a single category section
-*/
-function renderCategory(category, allCommands, headingLevel, leafOnly) {
-	const h = "#".repeat(headingLevel);
-	const lines = [];
-	lines.push(`${h} [${category.title}](${category.docPath})`);
-	lines.push("");
-	lines.push(category.description);
-	lines.push("");
-	const commandPaths = category.noExpand ? category.commands : expandCommands(category.commands, allCommands, leafOnly);
-	let visibleCommandPaths = commandPaths;
-	const fallbackCommandPaths = /* @__PURE__ */ new Set();
-	if (category.allowedCommands) {
-		const allowed = new Set(category.allowedCommands);
-		visibleCommandPaths = commandPaths.filter((cmdPath) => allowed.has(cmdPath));
-		for (const configuredPath of category.commands) if (allowed.has(configuredPath) && !visibleCommandPaths.some((cmdPath) => isSubcommandOf$1(cmdPath, configuredPath))) {
-			visibleCommandPaths.push(configuredPath);
-			fallbackCommandPaths.add(configuredPath);
-		}
-	}
-	lines.push("| Command | Description |");
-	lines.push("|---------|-------------|");
-	for (const cmdPath of visibleCommandPaths) {
-		const info = allCommands.get(cmdPath);
-		if (!info) continue;
-		if (!category.noExpand && leafOnly && !fallbackCommandPaths.has(cmdPath) && !isLeafCommand(info)) continue;
-		const displayName = cmdPath || info.name;
-		const anchor = generateAnchor(displayName);
-		const desc = escapeTableCell(info.description ?? "");
-		lines.push(`| [${displayName}](${category.docPath}#${anchor}) | ${desc} |`);
-	}
-	return lines.join("\n");
-}
-/**
-* Render command index from categories
-*
-* Generates a category-based index of commands with links to documentation.
-*
-* @example
-* const categories: CommandCategory[] = [
-*   {
-*     title: "Application Commands",
-*     description: "Commands for managing applications.",
-*     commands: ["init", "generate", "apply"],
-*     docPath: "./cli/application.md",
-*   },
-* ];
-*
-* const index = await renderCommandIndex(mainCommand, categories);
-* // ### [Application Commands](./cli/application.md)
-* //
-* // Commands for managing applications.
-* //
-* // | Command | Description |
-* // |---------|-------------|
-* // | [init](./cli/application.md#init) | Initialize a project |
-* // ...
-*
-* @param command - Root command to extract command information from
-* @param categories - Category definitions for grouping commands
-* @param options - Rendering options
-* @returns Rendered markdown string
-*/
-async function renderCommandIndex(command, categories, options) {
-	const headingLevel = options?.headingLevel ?? 3;
-	const leafOnly = options?.leafOnly ?? true;
-	const allCommands = await collectAllCommands(command);
-	const sections = [];
-	for (const category of categories) {
-		const section = renderCategory(category, allCommands, headingLevel, leafOnly);
-		sections.push(section);
-	}
-	return sections.join("\n\n");
-}
+`+r+(t<e.length?`
 
-//#endregion
-//#region ../core/src/docs/golden-test.ts
-/**
-* Apply formatter to content if provided
-* Supports both sync and async formatters
-*/
-async function applyFormatter(content, formatter) {
-	if (!formatter) return content;
-	const formatted = await formatter(content);
-	if (!content.endsWith("\n") && formatted.endsWith("\n")) return formatted.slice(0, -1);
-	return formatted;
-}
-function isTruthyEnv(envKey) {
-	const value = process.env[envKey];
-	return value === "true" || value === "1";
-}
-function extractYamlFrontMatter(content) {
-	const lines = content.split(/\r?\n/);
-	if (lines[0] !== "---") return null;
-	const frontMatterLines = [];
-	for (let i = 1; i < lines.length; i++) {
-		const line = lines[i];
-		if (line === "---" || line === "...") return frontMatterLines.join("\n");
-		frontMatterLines.push(line ?? "");
-	}
-	return null;
-}
-function stripPolittyFrontMatterForOutput(content) {
-	const lineEnding = detectLineEnding(content);
-	const lines = content.split(/\r?\n/);
-	if (lines[0] !== "---") return content;
-	let endIndex = -1;
-	for (let i = 1; i < lines.length; i++) {
-		const line = lines[i];
-		if (line === "---" || line === "...") {
-			endIndex = i;
-			break;
-		}
-	}
-	if (endIndex === -1) return content;
-	const frontMatterLines = lines.slice(1, endIndex);
-	const keptFrontMatterLines = [];
-	for (let i = 0; i < frontMatterLines.length; i++) {
-		const line = frontMatterLines[i] ?? "";
-		if (!/^politty\s*:\s*(.*)$/.test(line)) {
-			keptFrontMatterLines.push(line);
-			continue;
-		}
-		while (i + 1 < frontMatterLines.length) {
-			const nextLine = frontMatterLines[i + 1] ?? "";
-			if (nextLine.trim() !== "" && !nextLine.startsWith(" ") && !nextLine.startsWith("	")) break;
-			i++;
-		}
-	}
-	const bodyLines = lines.slice(endIndex + 1);
-	if (!keptFrontMatterLines.some((line) => line.trim() !== "")) return bodyLines.join(lineEnding).replace(new RegExp(`^${lineEnding}`), "");
-	return [
-		"---",
-		...keptFrontMatterLines,
-		lines[endIndex] ?? "---",
-		...bodyLines
-	].join(lineEnding);
-}
-function stripYamlScalarQuotes(value) {
-	const trimmed = value.trim();
-	if (trimmed.length >= 2 && (trimmed.startsWith("\"") && trimmed.endsWith("\"") || trimmed.startsWith("'") && trimmed.endsWith("'"))) return trimmed.slice(1, -1);
-	return trimmed;
-}
-function normalizeTemplatePlaceholderKey(value) {
-	let normalized = stripYamlScalarQuotes(value);
-	if (normalized === "") return null;
-	const fullPlaceholder = normalized.match(/^\{\{politty:([^{}]*)\}\}$/);
-	if (fullPlaceholder) normalized = fullPlaceholder[1] ?? "";
-	else if (normalized.startsWith("politty:")) normalized = normalized.slice(8);
-	return normalized === "" ? null : normalized;
-}
-function templatePlaceholderKey(placeholder) {
-	return placeholder.slice(2, -2).slice(8);
-}
-function splitFrontMatterListValue(value) {
-	const trimmed = value.trim();
-	if (!trimmed.startsWith("[") || !trimmed.endsWith("]")) return [trimmed];
-	return trimmed.slice(1, -1).split(",").map((item) => item.trim()).filter((item) => item.length > 0);
-}
-function addTemplatePlaceholderExclusion(exclusions, value) {
-	const normalized = normalizeTemplatePlaceholderKey(value);
-	if (normalized !== null) exclusions.add(normalized);
-}
-function collectExcludedTemplatePlaceholders(templateContent) {
-	const exclusions = /* @__PURE__ */ new Set();
-	const frontMatter = extractYamlFrontMatter(templateContent);
-	if (frontMatter === null) return exclusions;
-	let inPolittyBlock = false;
-	let inExcludeList = false;
-	let excludeIndent = 0;
-	for (const line of frontMatter.split(/\r?\n/)) {
-		const trimmed = line.trim();
-		if (trimmed === "" || trimmed.startsWith("#")) continue;
-		const topLevelPolitty = line.match(/^politty\s*:\s*(.*)$/);
-		if (topLevelPolitty) {
-			inPolittyBlock = (topLevelPolitty[1]?.trim() ?? "") === "";
-			inExcludeList = false;
-			continue;
-		}
-		if (!line.startsWith(" ") && !line.startsWith("	")) {
-			inPolittyBlock = false;
-			inExcludeList = false;
-			continue;
-		}
-		if (!inPolittyBlock) continue;
-		const excludeEntry = line.match(/^(\s+)(?:exclude|excludes)\s*:\s*(.*)$/);
-		if (excludeEntry) {
-			const value = excludeEntry[2]?.trim() ?? "";
-			if (value === "") {
-				inExcludeList = true;
-				excludeIndent = excludeEntry[1]?.length ?? 0;
-			} else {
-				inExcludeList = false;
-				for (const item of splitFrontMatterListValue(value)) addTemplatePlaceholderExclusion(exclusions, item);
-			}
-			continue;
-		}
-		if (!inExcludeList) continue;
-		const listItem = line.match(/^(\s*)-\s*(.+)$/);
-		if (!listItem || (listItem[1]?.length ?? 0) <= excludeIndent) {
-			inExcludeList = false;
-			continue;
-		}
-		addTemplatePlaceholderExclusion(exclusions, listItem[2] ?? "");
-	}
-	return exclusions;
-}
-function collectTemplateIndexMetadata(templateContent) {
-	const frontMatter = extractYamlFrontMatter(templateContent);
-	if (frontMatter === null) return {};
-	let inPolittyBlock = false;
-	let inIndexBlock = false;
-	let indexIndent = 0;
-	const metadata = {};
-	for (const line of frontMatter.split(/\r?\n/)) {
-		const trimmed = line.trim();
-		if (trimmed === "" || trimmed.startsWith("#")) continue;
-		const topLevelPolitty = line.match(/^politty\s*:\s*(.*)$/);
-		if (topLevelPolitty) {
-			inPolittyBlock = (topLevelPolitty[1]?.trim() ?? "") === "";
-			inIndexBlock = false;
-			continue;
-		}
-		if (!line.startsWith(" ") && !line.startsWith("	")) {
-			inPolittyBlock = false;
-			inIndexBlock = false;
-			continue;
-		}
-		if (!inPolittyBlock) continue;
-		const indexEntry = line.match(/^(\s+)index\s*:\s*(.*)$/);
-		if (indexEntry) {
-			inIndexBlock = (indexEntry[2]?.trim() ?? "") === "";
-			indexIndent = indexEntry[1]?.length ?? 0;
-			continue;
-		}
-		if (!inIndexBlock) continue;
-		if ((line.match(/^(\s*)/)?.[1]?.length ?? 0) <= indexIndent) {
-			inIndexBlock = false;
-			continue;
-		}
-		const property = line.match(/^\s+(title|description)\s*:\s*(.+)$/);
-		if (!property) continue;
-		const key = property[1];
-		const value = stripYamlScalarQuotes(property[2] ?? "");
-		if (key === "title") metadata.title = value;
-		else if (key === "description") metadata.description = value;
-	}
-	return metadata;
-}
-function createTemplateExclusions(rawKeys) {
-	return {
-		rawKeys,
-		commandScopes: /* @__PURE__ */ new Set(),
-		commandSections: /* @__PURE__ */ new Map(),
-		globalOptions: false,
-		index: false
-	};
-}
-function setFileMapEntry(fileMap, commandPath, filePath) {
-	Object.defineProperty(fileMap, commandPath, {
-		value: filePath,
-		enumerable: true,
-		configurable: true,
-		writable: true
-	});
-}
-/**
-* Normalize file mapping entry to FileConfig
-*/
-function normalizeFileConfig(config) {
-	if (Array.isArray(config)) return { commands: config };
-	if (!("commands" in config) || !Array.isArray(config.commands)) throw new Error("Invalid file config: object form must include a \"commands\" array. Use [] to skip generation intentionally.");
-	return config;
-}
-/**
-* Check if a command path is a subcommand of another
-*/
-function isSubcommandOf(childPath, parentPath) {
-	if (parentPath === "") return true;
-	if (childPath === parentPath) return true;
-	return childPath.startsWith(parentPath + " ");
-}
-/**
-* Check if a pattern contains wildcards
-*/
-function containsWildcard(pattern) {
-	return pattern.includes("*");
-}
-/**
-* Check if a command path matches a wildcard pattern
-* - `*` matches any single command segment
-* - Pattern segments are space-separated
-*
-* @example
-* matchesWildcard("config get", "* *") // true
-* matchesWildcard("config", "* *") // false
-* matchesWildcard("config get", "config *") // true
-* matchesWildcard("greet", "*") // true
-*/
-function matchesWildcard(path, pattern) {
-	const pathSegments = path === "" ? [] : path.split(" ");
-	const patternSegments = pattern === "" ? [] : pattern.split(" ");
-	if (pathSegments.length !== patternSegments.length) return false;
-	for (let i = 0; i < patternSegments.length; i++) {
-		const patternSeg = patternSegments[i];
-		const pathSeg = pathSegments[i];
-		if (patternSeg !== "*" && patternSeg !== pathSeg) return false;
-	}
-	return true;
-}
-/**
-* Expand a wildcard pattern to matching command paths
-*/
-function expandWildcardPattern(pattern, allCommands) {
-	const matches = [];
-	for (const cmdPath of allCommands.keys()) if (matchesWildcard(cmdPath, pattern)) matches.push(cmdPath);
-	return matches;
-}
-/**
-* Check if a path matches any ignore pattern (with wildcard support)
-* For wildcard patterns, also ignores subcommands of matched commands
-*/
-function matchesIgnorePattern(path, ignorePattern) {
-	if (containsWildcard(ignorePattern)) {
-		if (matchesWildcard(path, ignorePattern)) return true;
-		const pathSegments = path === "" ? [] : path.split(" ");
-		const patternSegments = ignorePattern === "" ? [] : ignorePattern.split(" ");
-		if (pathSegments.length > patternSegments.length) return matchesWildcard(pathSegments.slice(0, patternSegments.length).join(" "), ignorePattern);
-		return false;
-	}
-	return isSubcommandOf(path, ignorePattern);
-}
-/**
-* Expand command paths to include all subcommands (with wildcard support)
-*/
-function expandCommandPaths(commandPaths, allCommands) {
-	const expanded = /* @__PURE__ */ new Set();
-	const resolved = commandPaths.flatMap((cmdPath) => containsWildcard(cmdPath) ? expandWildcardPattern(cmdPath, allCommands) : [cmdPath]);
-	for (const cmdPath of resolved) for (const existingPath of allCommands.keys()) if (isSubcommandOf(existingPath, cmdPath)) expanded.add(existingPath);
-	return Array.from(expanded);
-}
-/**
-* Filter out ignored commands (with wildcard support)
-*/
-function filterIgnoredCommands(commandPaths, ignores) {
-	return commandPaths.filter((path) => {
-		return !ignores.some((ignorePattern) => matchesIgnorePattern(path, ignorePattern));
-	});
-}
-/**
-* Resolve wildcards to direct matches without subcommand expansion.
-* Returns the "top-level" commands for use in CommandCategory.commands,
-* where expandCommands in render-index handles subcommand expansion.
-*/
-function resolveTopLevelCommands(specifiedCommands, allCommands) {
-	const result = [];
-	for (const cmdPath of specifiedCommands) if (containsWildcard(cmdPath)) result.push(...expandWildcardPattern(cmdPath, allCommands));
-	else if (allCommands.has(cmdPath)) result.push(cmdPath);
-	return result;
-}
-/**
-* Resolve file command configuration to concrete command paths.
-* This applies wildcard/subcommand expansion and ignore filtering.
-*/
-function resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores) {
-	const fileConfig = normalizeFileConfig(fileConfigRaw);
-	const specifiedCommands = fileConfig.commands;
-	return {
-		fileConfig,
-		specifiedCommands,
-		commandPaths: filterIgnoredCommands(fileConfig.noExpand ? specifiedCommands.filter((p) => allCommands.has(p)) : expandCommandPaths(specifiedCommands, allCommands), ignores),
-		topLevelCommands: filterIgnoredCommands(resolveTopLevelCommands(specifiedCommands, allCommands), ignores)
-	};
-}
-/**
-* Validate that there are no conflicts between files and ignores (with wildcard support)
-*/
-function validateNoConflicts(filesCommands, ignores, allCommands) {
-	const conflicts = [];
-	for (const filePattern of filesCommands) {
-		const filePaths = containsWildcard(filePattern) ? expandWildcardPattern(filePattern, allCommands) : [filePattern];
-		for (const filePath of filePaths) for (const ignorePattern of ignores) if (containsWildcard(ignorePattern)) {
-			if (matchesWildcard(filePath, ignorePattern)) conflicts.push(`"${filePath}" is both in files and ignored by "${ignorePattern}"`);
-		} else if (filePath === ignorePattern || isSubcommandOf(filePath, ignorePattern)) conflicts.push(`"${filePath}" is both in files and ignored by "${ignorePattern}"`);
-	}
-	if (conflicts.length > 0) throw new Error(`Conflict between files and ignores:\n  - ${conflicts.join("\n  - ")}`);
-}
-/**
-* Validate that all ignored paths exist in the command tree (with wildcard support)
-*/
-function validateIgnoresExist(ignores, allCommands) {
-	const nonExistent = [];
-	for (const ignorePattern of ignores) if (containsWildcard(ignorePattern)) {
-		if (expandWildcardPattern(ignorePattern, allCommands).length === 0) nonExistent.push(`"${ignorePattern}"`);
-	} else if (!allCommands.has(ignorePattern)) nonExistent.push(`"${ignorePattern}"`);
-	if (nonExistent.length > 0) throw new Error(`Ignored command paths do not exist: ${nonExistent.join(", ")}`);
-}
-/**
-* Sort command paths in depth-first order while preserving the specified command order
-* Parent commands are immediately followed by their subcommands
-*/
-function sortDepthFirst(commandPaths, specifiedOrder) {
-	const pathSet = new Set(commandPaths);
-	const topLevelPaths = specifiedOrder.filter((cmd) => pathSet.has(cmd));
-	for (const path of commandPaths) if ((path === "" ? 0 : path.split(" ").length) === 1 && !topLevelPaths.includes(path)) topLevelPaths.push(path);
-	const result = [];
-	const visited = /* @__PURE__ */ new Set();
-	function addWithChildren(cmdPath) {
-		if (visited.has(cmdPath) || !pathSet.has(cmdPath)) return;
-		visited.add(cmdPath);
-		result.push(cmdPath);
-		const children = commandPaths.filter((p) => {
-			if (p === cmdPath || visited.has(p)) return false;
-			if (cmdPath === "") return p.split(" ").length === 1;
-			return p.startsWith(cmdPath + " ") && p.split(" ").length === cmdPath.split(" ").length + 1;
-		}).sort((a, b) => a.localeCompare(b));
-		for (const child of children) addWithChildren(child);
-	}
-	for (const topLevel of topLevelPaths) addWithChildren(topLevel);
-	for (const path of commandPaths) if (!visited.has(path)) result.push(path);
-	return result;
-}
-function generateFileHeader(fileConfig) {
-	if (!fileConfig.title && !fileConfig.description) return null;
-	const parts = [];
-	if (fileConfig.title) {
-		const heading = "#".repeat(fileConfig.headingLevel ?? 1);
-		parts.push(`${heading} ${fileConfig.title}`);
-	}
-	if (fileConfig.description) {
-		parts.push("");
-		parts.push(fileConfig.description);
-	}
-	parts.push("");
-	return parts.join("\n");
-}
-/**
-* Extract a leading file header (title and optional description paragraph)
-*/
-function extractFileHeader(content) {
-	if (!/^#{1,6} /.test(content)) return null;
-	const titleEnd = content.indexOf("\n");
-	if (titleEnd === -1) return content;
-	let cursor = titleEnd + 1;
-	if (content[cursor] === "\n") cursor += 1;
-	while (cursor < content.length) {
-		const lineEnd = content.indexOf("\n", cursor);
-		const line = lineEnd === -1 ? content.slice(cursor) : content.slice(cursor, lineEnd);
-		if (line.length === 0 || /^#{1,6}\s/.test(line) || line.startsWith("<!-- politty:")) break;
-		cursor = lineEnd === -1 ? content.length : lineEnd + 1;
-	}
-	return content.slice(0, cursor);
-}
-/**
-* Validate and optionally update configured file header
-*/
-function processFileHeader(existingContent, fileConfig, updateMode) {
-	const generatedHeader = generateFileHeader(fileConfig);
-	if (!generatedHeader) return {
-		content: existingContent,
-		hasError: false,
-		wasUpdated: false
-	};
-	if (existingContent.startsWith(generatedHeader)) return {
-		content: existingContent,
-		hasError: false,
-		wasUpdated: false
-	};
-	const existingHeader = extractFileHeader(existingContent) ?? "";
-	if (!updateMode) return {
-		content: existingContent,
-		diff: formatDiff(existingHeader, generatedHeader),
-		hasError: true,
-		wasUpdated: false
-	};
-	return {
-		content: `${generatedHeader}${(existingHeader ? existingContent.slice(existingHeader.length) : existingContent).replace(/^\n+/, "")}`,
-		hasError: false,
-		wasUpdated: true
-	};
-}
-function formatCommandPath(commandPath) {
-	return commandPath === "" ? "<root>" : commandPath;
-}
-/**
-* Extract a section marker's content from document content.
-* Returns the content between start and end markers (including markers).
-*/
-function extractSectionMarker(content, type, scope) {
-	return extractMarkerSection(content, sectionStartMarker(type, scope), sectionEndMarker(type, scope));
-}
-/**
-* Replace a section marker's content in document content.
-* Returns updated content, or null if marker not found.
-*/
-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.
-* Preserves any existing content between adjacent markers by wrapping it with the new markers
-* instead of replacing it with generated content.
-* @throws If no adjacent marker is found (unreachable when at least one marker exists for the command)
-*/
-function insertSectionMarkerAtOrder(content, type, scope, generatedSection) {
-	const typeIndex = SECTION_TYPES.indexOf(type);
-	const startMarker = sectionStartMarker(type, scope);
-	const endMarker = sectionEndMarker(type, scope);
-	let prevBoundary = null;
-	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) {
-			prevBoundary = prevEndIdx + prevEnd.length;
-			break;
-		}
-	}
-	let nextBoundary = null;
-	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) {
-			nextBoundary = nextStartIdx;
-			break;
-		}
-	}
-	if (prevBoundary != null && nextBoundary != null) {
-		const wrapped = startMarker + content.slice(prevBoundary, nextBoundary).replace(/^\n+/, "\n").replace(/\n+$/, "\n") + endMarker;
-		return content.slice(0, prevBoundary) + "\n\n" + wrapped + "\n\n" + content.slice(nextBoundary);
-	}
-	if (prevBoundary != null) {
-		let afterPos = prevBoundary;
-		while (afterPos < content.length && content[afterPos] === "\n") afterPos++;
-		return content.slice(0, prevBoundary) + "\n\n" + generatedSection + (afterPos < content.length ? "\n\n" : "\n") + content.slice(afterPos);
-	}
-	if (nextBoundary != null) {
-		let beforePos = nextBoundary;
-		while (beforePos > 0 && content[beforePos - 1] === "\n") beforePos--;
-		const prefix = beforePos === 0 ? "" : "\n\n";
-		return content.slice(0, beforePos) + prefix + generatedSection + "\n\n" + content.slice(nextBoundary);
-	}
-	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) {
-	const found = [];
-	for (const type of SECTION_TYPES) if (extractSectionMarker(content, type, commandPath) !== null) found.push(type);
-	return found;
-}
-/**
-* Collect all command paths that have any section markers in the content.
-*/
-function collectSectionMarkerPaths(content) {
-	const sectionTypes = SECTION_TYPES.join("|");
-	const markerPattern = new RegExp(`<!--\\s*politty:command:(.*?):(?:${sectionTypes}):start\\s*-->`, "g");
-	const paths = /* @__PURE__ */ new Set();
-	for (const match of content.matchAll(markerPattern)) paths.add(match[1] ?? "");
-	return Array.from(paths);
-}
-/**
-* Insert command section markers at the correct position based on specified order.
-* Uses the heading marker of adjacent commands as reference points.
-*/
-function insertCommandSections(content, commandPath, newSection, specifiedOrder) {
-	const targetIndex = specifiedOrder.indexOf(commandPath);
-	if (targetIndex === -1) return content.trimEnd() + "\n\n" + newSection + "\n";
-	for (let i = targetIndex + 1; i < specifiedOrder.length; i++) {
-		const nextCmd = specifiedOrder[i];
-		if (nextCmd === void 0) continue;
-		const nextMarker = sectionStartMarker("heading", nextCmd);
-		const nextIndex = content.indexOf(nextMarker);
-		if (nextIndex !== -1) {
-			let insertPos = nextIndex;
-			while (insertPos > 0 && content[insertPos - 1] === "\n") insertPos--;
-			if (insertPos < nextIndex) insertPos++;
-			return content.slice(0, insertPos) + newSection + "\n" + content.slice(nextIndex);
-		}
-	}
-	for (let i = targetIndex - 1; i >= 0; i--) {
-		const prevCmd = specifiedOrder[i];
-		if (prevCmd === void 0) continue;
-		const prevMarkers = collectSectionMarkers(content, prevCmd);
-		if (prevMarkers.length > 0) {
-			const lastType = prevMarkers[prevMarkers.length - 1];
-			const prevEndMarker = sectionEndMarker(lastType, prevCmd);
-			const prevEndIndex = content.indexOf(prevEndMarker);
-			if (prevEndIndex !== -1) {
-				const insertPos = prevEndIndex + prevEndMarker.length;
-				return content.slice(0, insertPos) + "\n" + newSection + content.slice(insertPos);
-			}
-		}
-	}
-	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;
-}
-/**
-* Strip politty marker lines from content, then collapse the blank-line gaps the removed markers
-* leave behind (outside fenced code blocks only, so intentional blank lines inside generated
-* example/code blocks are preserved) and trim leading/trailing blank lines.
-*/
-function stripPolittyMarkers(content) {
-	let result = collapseBlankLinesOutsideCodeFences(content.split("\n").filter((line) => !/^<!-- politty:.*-->$/.test(line.trim())).join("\n"));
-	result = result.replace(/^\n+/, "").replace(/\n+$/, "");
-	return result;
-}
-/**
-* Collapse runs of 3+ newlines to 2, but only outside fenced code blocks so that intentional
-* blank lines inside handwritten code samples are preserved. Fences are lines whose trimmed
-* content starts with ``` or ~~~.
-*/
-function collapseBlankLinesOutsideCodeFences(content) {
-	const lines = content.split("\n");
-	const out = [];
-	let inFence = false;
-	let blankRun = 0;
-	for (const line of lines) {
-		const trimmed = line.trim();
-		if (trimmed.startsWith("```") || trimmed.startsWith("~~~")) {
-			inFence = !inFence;
-			blankRun = 0;
-			out.push(line);
-			continue;
-		}
-		if (!inFence && line.trim() === "") {
-			blankRun++;
-			if (blankRun >= 2) continue;
-		} else if (!inFence) blankRun = 0;
-		out.push(line);
-	}
-	return out.join("\n");
-}
-function detectLineEnding(content) {
-	return content.includes("\r\n") ? "\r\n" : "\n";
-}
-function countLineBreaks(value) {
-	return (value.match(/\n/g) ?? []).length;
-}
-/**
-* Type guard for SectionType values parsed from template placeholders.
-*/
-function isSectionType(value) {
-	return SECTION_TYPES.some((type) => type === value);
-}
-/**
-* Clamp a numeric heading level to the valid HeadingLevel range (1–6).
-* Uses a switch to return a literal union member, avoiding `as` assertions.
-*/
-function clampHeadingLevel(level) {
-	switch (Math.min(6, Math.max(1, Math.trunc(level)))) {
-		case 1: return 1;
-		case 2: return 2;
-		case 3: return 3;
-		case 4: return 4;
-		case 5: return 5;
-		default: return 6;
-	}
-}
-function resolveTemplateCommandScope(tokens, allCommands) {
-	if (tokens.length === 0) return allCommands === void 0 || allCommands.has("") ? "" : null;
-	const exactScope = tokens.join(":");
-	if (allCommands?.has(exactScope)) return exactScope;
-	const colonSeparatedScope = tokens.join(" ");
-	if (allCommands?.has(colonSeparatedScope)) return colonSeparatedScope;
-	return allCommands === void 0 ? colonSeparatedScope : null;
-}
-function templateScopeFallback(tokens) {
-	return tokens.join(" ");
-}
-/**
-* Parse a single {{politty:...}} placeholder string into a discriminated structure.
-* The `placeholder` argument should be the full `{{politty:...}}` text.
-*
-* Uses String.match / String.replace internally (not .exec) to avoid lastIndex
-* state issues from the shared TEMPLATE_PLACEHOLDER_REGEX constant.
-*/
-function parsePlaceholder(placeholder, allCommands) {
-	const tokens = placeholder.slice(2, -2).split(":");
-	const directive = tokens[1];
-	if (directive === "command") {
-		const rest = tokens.slice(2);
-		if (rest.length === 1 && rest[0] === "") return {
-			kind: "invalid",
-			reason: `Trailing colon in "${placeholder}"; use {{politty:command}} for the root command.`
-		};
-		const fullScope = resolveTemplateCommandScope(rest, allCommands);
-		if (fullScope !== null) return {
-			kind: "command",
-			scope: fullScope,
-			type: void 0
-		};
-		if (rest.length >= 2) {
-			const last = rest[rest.length - 1];
-			const scopeTokens = rest.slice(0, -1);
-			const sectionScope = resolveTemplateCommandScope(scopeTokens, allCommands);
-			if (last !== void 0 && isSectionType(last)) return {
-				kind: "command",
-				scope: sectionScope ?? templateScopeFallback(scopeTokens),
-				type: last
-			};
-			if (last !== void 0 && sectionScope !== null) return {
-				kind: "invalid",
-				reason: `Unknown section type "${last}" for command scope "${formatCommandPath(sectionScope)}". Valid section types: ${SECTION_TYPES.join(", ")}`
-			};
-		}
-		return {
-			kind: "command",
-			scope: templateScopeFallback(rest),
-			type: void 0
-		};
-	}
-	if (directive === "global-options") {
-		if (tokens.length !== 2) return {
-			kind: "invalid",
-			reason: `Malformed placeholder "${placeholder}". Expected {{politty:global-options}}.`
-		};
-		return { kind: "global-options" };
-	}
-	if (directive === "index") {
-		if (tokens.length !== 2) return {
-			kind: "invalid",
-			reason: `Malformed placeholder "${placeholder}". Expected {{politty:index}}.`
-		};
-		return { kind: "index" };
-	}
-	return {
-		kind: "invalid",
-		reason: `Unknown politty directive "${directive ?? ""}" in "${placeholder}". Valid directives: command, global-options, index`
-	};
-}
-function buildTemplateExclusions(rawKeys, allCommands) {
-	const exclusions = createTemplateExclusions(rawKeys);
-	for (const key of rawKeys) {
-		const parsed = parsePlaceholder(`{{politty:${key}}}`, allCommands);
-		if (parsed.kind === "command") if (parsed.type === void 0) exclusions.commandScopes.add(parsed.scope);
-		else {
-			let sections = exclusions.commandSections.get(parsed.scope);
-			if (!sections) {
-				sections = /* @__PURE__ */ new Set();
-				exclusions.commandSections.set(parsed.scope, sections);
-			}
-			sections.add(parsed.type);
-		}
-		else if (parsed.kind === "global-options") exclusions.globalOptions = true;
-		else if (parsed.kind === "index") exclusions.index = true;
-	}
-	return exclusions;
-}
-function isCommandScopeExcluded(commandPath, excludedCommandScopes) {
-	for (const excludedScope of excludedCommandScopes) if (isSubcommandOf(commandPath, excludedScope)) return true;
-	return false;
-}
-function isCommandSectionExcluded(commandPath, sectionType, exclusions) {
-	if (isCommandScopeExcluded(commandPath, exclusions.commandScopes)) return true;
-	return exclusions.commandSections.get(commandPath)?.has(sectionType) ?? false;
-}
-function getTemplateCommandTreePaths(commandPath, allCommands, ignores, exclusions) {
-	return sortDepthFirst(filterIgnoredCommands(expandCommandPaths([commandPath], allCommands), ignores).filter((path) => !isCommandScopeExcluded(path, exclusions.commandScopes)), [commandPath]);
-}
-function shouldSkipTemplatePlaceholder(placeholder, parsed, exclusions) {
-	if (exclusions.rawKeys.has(templatePlaceholderKey(placeholder))) return true;
-	if (parsed.kind === "command") {
-		if (isCommandScopeExcluded(parsed.scope, exclusions.commandScopes)) return true;
-		return parsed.type !== void 0 && (exclusions.commandSections.get(parsed.scope)?.has(parsed.type) ?? false);
-	}
-	if (parsed.kind === "global-options") return exclusions.globalOptions;
-	if (parsed.kind === "index") return exclusions.index;
-	return false;
-}
-function isRawCommandPlaceholderUnderExcludedScope(key, exclusions) {
-	if (!key.startsWith("command:")) return false;
-	const tokens = key.slice(8).split(":");
-	for (const excludedScope of exclusions.commandScopes) {
-		if (excludedScope === "") return true;
-		const spaceTokens = excludedScope.split(" ");
-		if (tokens.slice(0, spaceTokens.length).join(" ") === excludedScope) return true;
-		const colonTokens = excludedScope.split(":");
-		if (tokens.slice(0, colonTokens.length).join(":") === excludedScope) return true;
-	}
-	return false;
-}
-/**
-* Regex matching {{politty:...}} placeholders.
-* NOTE: only use with String.match / String.replace, never with .exec in a loop,
-* because the /g flag makes the regex stateful via lastIndex.
-*/
-const TEMPLATE_PLACEHOLDER_REGEX = /\{\{politty:[^{}]*\}\}/g;
-function validateTemplatePlaceholderSyntax(templateContent, templatePath) {
-	const validPlaceholderStarts = /* @__PURE__ */ new Set();
-	for (const match of templateContent.matchAll(TEMPLATE_PLACEHOLDER_REGEX)) {
-		const start = match.index;
-		const end = start + match[0].length;
-		if (templateContent[start - 1] === "{" || templateContent[end] === "}") {
-			const snippet = templateContent.slice(Math.max(0, start - 1), Math.min(templateContent.length, end + 1)).split("\n")[0];
-			throw new Error(`Malformed politty placeholder in template "${templatePath}": "${snippet}". Expected {{politty:...}}.`);
-		}
-		validPlaceholderStarts.add(start);
-	}
-	let searchIndex = 0;
-	while (true) {
-		const placeholderStart = templateContent.indexOf("{{politty:", searchIndex);
-		if (placeholderStart === -1) return;
-		if (!validPlaceholderStarts.has(placeholderStart)) {
-			const snippet = templateContent.slice(placeholderStart, placeholderStart + 80).split("\n")[0];
-			throw new Error(`Malformed politty placeholder in template "${templatePath}": "${snippet}". Expected {{politty:...}}.`);
-		}
-		searchIndex = placeholderStart + 10;
-	}
-}
-function getUnknownSectionTypeError(scope, allCommands) {
-	const separatorIndex = scope.lastIndexOf(":");
-	if (separatorIndex === -1) return null;
-	const commandScope = scope.slice(0, separatorIndex);
-	const sectionType = scope.slice(separatorIndex + 1);
-	if (sectionType === "" || !allCommands.has(commandScope)) return null;
-	return `Unknown section type "${sectionType}" for command scope "${formatCommandPath(commandScope)}". Valid section types: ${SECTION_TYPES.join(", ")}`;
-}
-/**
-* Extract a marker section from content
-* Returns the content between start and end markers (including markers)
-*/
-function extractMarkerSection(content, startMarker, endMarker) {
-	const startIndex = content.indexOf(startMarker);
-	if (startIndex === -1) return null;
-	const endIndex = content.indexOf(endMarker, startIndex);
-	if (endIndex === -1) return null;
-	return content.slice(startIndex, endIndex + endMarker.length);
-}
-/**
-* Replace a marker section in content
-* Returns the updated content with the new section
-*/
-function replaceMarkerSection(content, startMarker, endMarker, newSection) {
-	const startIndex = content.indexOf(startMarker);
-	if (startIndex === -1) return null;
-	const endIndex = content.indexOf(endMarker, startIndex);
-	if (endIndex === -1) return null;
-	return content.slice(0, startIndex) + newSection + content.slice(endIndex + endMarker.length);
-}
-/**
-* Whether a value is a Standard Schema, judged by the shape of its
-* `~standard` marker rather than the key alone.
-*
-* `vendor` and `validate` are what the check relies on; `version` is
-* deliberately not required, so a future spec revision bumping it does not
-* make politty stop recognizing schemas.
-*/
-function isStandardSchema(value) {
-	if (typeof value !== "object" || value === null) return false;
-	const marker = value["~standard"];
-	if (typeof marker !== "object" || marker === null) return false;
-	const { vendor, validate } = marker;
-	return typeof vendor === "string" && typeof validate === "function";
-}
-/**
-* Check if config is the { args, options? } shape (not shorthand ArgsShape)
-*
-* Distinguishes between:
-* - { args: ArgsShape, options?: ArgsTableOptions } → returns true
-* - ArgsShape (e.g., { verbose: <schema>, args: <schema> }) → returns false
-*
-* The key insight is that in the { args, options? } shape, config.args is an
-* ArgsShape (a record of the CLI's schema-library schemas), while in shorthand
-* config itself is the ArgsShape and config.args would be a single schema if
-* the user has an option named "args".
-*/
-function isGlobalOptionsConfigWithOptions(config) {
-	if (typeof config !== "object" || config === null || !("args" in config)) return false;
-	return !isStandardSchema(config.args);
-}
-/**
-* Collect option fields that are actually rendered by global options markers.
-* Positional args are not rendered in args tables, so they must not be excluded.
-*/
-function collectRenderableGlobalOptionFields(argsShape) {
-	const adapter = getValidatorAdapter();
-	return Object.entries(argsShape).map(([name, fieldSchema]) => adapter.resolveFieldMeta(name, fieldSchema)).filter((field) => !field.positional);
-}
-/**
-* Compare option definitions for global-options compatibility.
-*/
-function areGlobalOptionsEquivalent(a, b) {
-	const { schema: _aSchema, ...aRest } = a;
-	const { schema: _bSchema, ...bRest } = b;
-	return isDeepStrictEqual(aRest, bRest);
-}
-/**
-* Normalize rootDoc.globalOptions to { args, options? } form.
-*/
-function normalizeGlobalOptions(config) {
-	if (!config) return void 0;
-	return isGlobalOptionsConfigWithOptions(config) ? config : { args: config };
-}
-/**
-* Derive an ArgsShape from a globalArgs schema, retaining only non-positional option fields.
-* Returns undefined when globalArgs is undefined or contains no option fields.
-* Used to build globalOptionDefinitions from globalArgs when rootDoc is not available.
-*/
-function deriveGlobalArgsShape(globalArgs) {
-	if (!globalArgs) return void 0;
-	const optionFields = extractFields(globalArgs).fields.filter((f) => !f.positional);
-	if (optionFields.length === 0) return void 0;
-	return Object.fromEntries(optionFields.map((f) => [f.name, f.schema]));
-}
-/**
-* Collect global option definitions from rootDoc.
-* Global options are intentionally applied to all generated command sections.
-*/
-function collectGlobalOptionDefinitions(rootDoc) {
-	const globalOptions = /* @__PURE__ */ new Map();
-	if (!rootDoc?.globalOptions) return globalOptions;
-	const normalized = normalizeGlobalOptions(rootDoc.globalOptions);
-	if (!normalized) return globalOptions;
-	for (const field of collectRenderableGlobalOptionFields(normalized.args)) globalOptions.set(field.name, field);
-	return globalOptions;
-}
-/**
-* Derive CommandCategory[] from files mapping.
-* Category title/description come from the first command in each file entry.
-*/
-function deriveIndexFromFiles(files, rootDocPath, allCommands, ignores) {
-	const categories = [];
-	for (const [filePath, fileConfigRaw] of Object.entries(files)) {
-		const { commandPaths, topLevelCommands } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
-		if (commandPaths.length === 0) continue;
-		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$1.basename(filePath, path$1.extname(filePath)),
-			description: fileConfig?.description ?? cmdInfo?.description ?? "",
-			commands: topLevelCommands,
-			allowedCommands: commandPaths,
-			docPath
-		});
-	}
-	return categories;
-}
-/**
-* Build index categories for the {{politty:index}} placeholder from other template outputs.
-* Each category lists exactly the heading-producing scopes of that output (noExpand), so the
-* index never links to commands that template mode did not render.
-*/
-function deriveIndexFromTemplateOutputs(templateMeta, currentOutputPath, indexFilePath, allCommands) {
-	const normalizedCurrent = normalizeDocPathForComparison(currentOutputPath);
-	const categories = [];
-	for (const [outputPath, meta] of templateMeta.entries()) {
-		if (normalizeDocPathForComparison(outputPath) === normalizedCurrent) continue;
-		const scopes = meta.headingScopes;
-		if (scopes.length === 0) continue;
-		const docPath = "./" + path$1.relative(path$1.dirname(indexFilePath), outputPath).replace(/\\/g, "/");
-		const firstScope = scopes[0];
-		const cmdInfo = firstScope !== void 0 ? allCommands.get(firstScope) : void 0;
-		categories.push({
-			title: meta.indexTitle ?? cmdInfo?.name ?? path$1.basename(outputPath, path$1.extname(outputPath)),
-			description: meta.indexDescription ?? cmdInfo?.description ?? "",
-			commands: scopes,
-			docPath,
-			noExpand: true
-		});
-	}
-	return categories;
-}
-/**
-* Collect command paths that are actually documented in configured files.
-*/
-function collectDocumentedCommandPaths(files, allCommands, ignores) {
-	const documentedCommandPaths = /* @__PURE__ */ new Set();
-	for (const fileConfigRaw of Object.values(files)) {
-		const { commandPaths } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
-		for (const commandPath of commandPaths) documentedCommandPaths.add(commandPath);
-	}
-	return documentedCommandPaths;
-}
-/**
-* Collect command paths that are targeted in configured files.
-*/
-function collectTargetDocumentedCommandPaths(targetCommands, files, allCommands, ignores) {
-	const documentedTargetCommandPaths = /* @__PURE__ */ new Set();
-	for (const filePath of Object.keys(files)) {
-		const targetCommandsInFile = findTargetCommandsInFile(targetCommands, filePath, files, allCommands, ignores);
-		for (const commandPath of targetCommandsInFile) documentedTargetCommandPaths.add(commandPath);
-	}
-	return documentedTargetCommandPaths;
-}
-function commandPathMatchesTarget(commandPath, targetCommands) {
-	return targetCommands.some((targetCommand) => isSubcommandOf(commandPath, targetCommand));
-}
-function templateMetaReferencesCommandTarget(meta, targetCommands) {
-	return meta.referencedScopes.some((scope) => commandPathMatchesTarget(scope, targetCommands));
-}
-function templateMetaShouldProcessForTarget(meta, targetCommands) {
-	return meta.emitsIndex || meta.emitsGlobalOptions || templateMetaReferencesCommandTarget(meta, targetCommands);
-}
-/**
-* Validate that excluded command options match globalOptions definitions.
-*/
-function validateGlobalOptionCompatibility(documentedCommandPaths, allCommands, globalOptions) {
-	if (globalOptions.size === 0) return;
-	const conflicts = [];
-	for (const commandPath of documentedCommandPaths) {
-		const info = allCommands.get(commandPath);
-		if (!info) continue;
-		for (const option of info.options) {
-			const globalOption = globalOptions.get(option.name);
-			if (!globalOption) continue;
-			if (!areGlobalOptionsEquivalent(globalOption, option)) conflicts.push(`Command "${formatCommandPath(commandPath)}" option "--${option.cliName}" does not match globalOptions definition for "${option.name}".`);
-		}
-	}
-	if (conflicts.length > 0) throw new Error(`Invalid globalOptions configuration:\n  - ${conflicts.join("\n  - ")}`);
-}
-/**
-* Build global options content (anchor + args table) without markers
-*/
-function buildGlobalOptionsContent(config) {
-	return ["<a id=\"global-options\"></a>", renderArgsTable(config.args, config.options)].join("\n");
-}
-/**
-* Generate global options section content with markers
-*/
-function generateGlobalOptionsSection(config) {
-	return [
-		globalOptionsStartMarker(),
-		buildGlobalOptionsContent(config),
-		globalOptionsEndMarker()
-	].join("\n");
-}
-/**
-* Generate index section content with markers
-*/
-async function generateIndexSection(categories, command, scope, options) {
-	const startMarker = indexStartMarker(scope);
-	const endMarker = indexEndMarker(scope);
-	return [
-		startMarker,
-		await renderCommandIndex(command, categories, options),
-		endMarker
-	].join("\n");
-}
-/**
-* Normalize a doc file path for equivalence checks.
-*/
-function normalizeDocPathForComparison(filePath) {
-	return path$1.resolve(filePath);
-}
-/**
-* Process global options marker in file content
-* Returns result with updated content and any diffs
-*/
-async function processGlobalOptionsMarker(existingContent, globalOptionsConfig, updateMode, formatter, autoInsertIfMissing) {
-	let content = existingContent;
-	const diffs = [];
-	let hasError = false;
-	let wasUpdated = false;
-	const startMarker = globalOptionsStartMarker();
-	const endMarker = globalOptionsEndMarker();
-	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 {
-			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 global options section");
-		}
-	} else {
-		hasError = true;
-		diffs.push(formatDiff(existingSection, generatedSection));
-	}
-	return {
-		content,
-		diffs,
-		hasError,
-		wasUpdated
-	};
-}
-/**
-* 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.
-*/
-async function processIndexMarker(existingContent, categories, command, scope, updateMode, formatter, indexOptions) {
-	let content = existingContent;
-	const diffs = [];
-	let hasError = false;
-	let wasUpdated = false;
-	const startMarker = indexStartMarker(scope);
-	const endMarker = indexEndMarker(scope);
-	const hasStartMarker = content.includes(startMarker);
-	const hasEndMarker = content.includes(endMarker);
-	if (!hasStartMarker && !hasEndMarker) return {
-		content,
-		diffs,
-		hasError,
-		wasUpdated
-	};
-	if (!hasStartMarker || !hasEndMarker) {
-		hasError = true;
-		diffs.push("Index marker section is malformed: both start and end markers are required.");
-		return {
-			content,
-			diffs,
-			hasError,
-			wasUpdated
-		};
-	}
-	const existingSection = extractMarkerSection(content, startMarker, endMarker);
-	if (!existingSection) {
-		hasError = true;
-		diffs.push("Index marker section is malformed: start marker must appear before end marker.");
-		return {
-			content,
-			diffs,
-			hasError,
-			wasUpdated
-		};
-	}
-	const generatedSection = await applyFormatter(await generateIndexSection(categories, command, scope, indexOptions), formatter);
-	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 index section");
-		}
-	} else {
-		hasError = true;
-		diffs.push(formatDiff(existingSection, generatedSection));
-	}
-	return {
-		content,
-		diffs,
-		hasError,
-		wasUpdated
-	};
-}
-/**
-* Find which file contains a specific command
-*/
-function findFileForCommand(commandPath, files, allCommands, ignores) {
-	for (const [filePath, fileConfigRaw] of Object.entries(files)) {
-		const { commandPaths } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
-		if (commandPaths.includes(commandPath)) return filePath;
-	}
-	return null;
-}
-/**
-* Find which target commands are contained in a file
-* Also expands each target command to include subcommands that are NOT explicitly in specifiedCommands
-*/
-function findTargetCommandsInFile(targetCommands, filePath, files, allCommands, ignores) {
-	const fileConfigRaw = files[filePath];
-	if (!fileConfigRaw) return [];
-	const { specifiedCommands, commandPaths } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
-	const expandedTargets = /* @__PURE__ */ new Set();
-	for (const targetCmd of targetCommands) {
-		if (!commandPaths.includes(targetCmd)) continue;
-		expandedTargets.add(targetCmd);
-		for (const cmdPath of commandPaths) if (isSubcommandOf(cmdPath, targetCmd) && !specifiedCommands.includes(cmdPath)) expandedTargets.add(cmdPath);
-	}
-	return Array.from(expandedTargets);
-}
-/**
-* Generate a single command section (already contains section markers from renderer)
-*/
-function generateCommandSection(cmdPath, allCommands, render, filePath, fileMap, rootDocPath, hasGlobalOptions, ignores = [], excludeOptionNames, templateExclusions) {
-	const info = allCommands.get(cmdPath);
-	if (!info) return null;
-	if (templateExclusions && isCommandScopeExcluded(info.commandPath, templateExclusions.commandScopes)) return null;
-	const enriched = {
-		...info,
-		filePath,
-		fileMap,
-		rootDocPath
-	};
-	if (ignores.length > 0 || templateExclusions && templateExclusions.commandScopes.size > 0) enriched.subCommands = info.subCommands.filter((sub) => {
-		const subCommandPath = sub.fullPath.join(" ");
-		if (ignores.some((pattern) => matchesIgnorePattern(subCommandPath, pattern))) return false;
-		return !(templateExclusions && isCommandScopeExcluded(subCommandPath, templateExclusions.commandScopes));
-	});
-	if (hasGlobalOptions !== void 0) enriched.hasGlobalOptions = hasGlobalOptions;
-	if (excludeOptionNames && excludeOptionNames.size > 0) {
-		enriched.options = info.options.filter((opt) => !excludeOptionNames.has(opt.name));
-		if (info.extracted) enriched.extracted = filterExtractedFields(info.extracted, excludeOptionNames);
-	}
-	let rendered = render(enriched);
-	if (templateExclusions) for (const [scope, sectionTypes] of templateExclusions.commandSections) {
-		if (scope !== info.commandPath) continue;
-		for (const sectionType of sectionTypes) {
-			const section = extractSectionMarker(rendered, sectionType, scope);
-			if (section !== null) rendered = rendered.replace(section, "");
-		}
-		rendered = collapseBlankLinesOutsideCodeFences(rendered);
-	}
-	return rendered;
-}
-function generateCommandTreeMarkdown(cmdPath, allCommands, render, ignores, filePath, fileMap, rootDocPath, hasGlobalOptions, excludeOptionNames, templateExclusions) {
-	const commandPaths = getTemplateCommandTreePaths(cmdPath, allCommands, ignores, templateExclusions);
-	const sections = [];
-	for (const commandPath of commandPaths) {
-		const section = generateCommandSection(commandPath, allCommands, render, filePath, fileMap, rootDocPath, hasGlobalOptions, ignores, excludeOptionNames, templateExclusions);
-		if (section !== null) sections.push(section);
-	}
-	return sections.length === 0 ? null : sections.join("\n");
-}
-/**
-* Return a copy of ExtractedFields with the named options removed from every field collection
-* (top-level fields, union options, and discriminated-union variants). Used to exclude global
-* options from grouped option tables rendered directly from `extracted`.
-*/
-function filterExtractedFields(extracted, excludeOptionNames) {
-	const result = {
-		...extracted,
-		fields: extracted.fields.filter((f) => !excludeOptionNames.has(f.name))
-	};
-	if (extracted.unionOptions) result.unionOptions = extracted.unionOptions.map((opt) => filterExtractedFields(opt, excludeOptionNames));
-	if (extracted.variants) result.variants = extracted.variants.map((variant) => ({
-		...variant,
-		fields: variant.fields.filter((f) => !excludeOptionNames.has(f.name))
-	}));
-	return result;
-}
-/**
-* 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, rootDocPath, hasGlobalOptions, ignores = []) {
-	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, rootDocPath, hasGlobalOptions, ignores);
-		if (section) sections.push(section);
-	}
-	return `${sections.join("\n")}\n`;
-}
-/**
-* Build a map of command path to file path
-*/
-function buildFileMap(files, allCommands, ignores) {
-	const fileMap = {};
-	for (const [filePath, fileConfigRaw] of Object.entries(files)) {
-		const { commandPaths } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
-		for (const cmdPath of commandPaths) setFileMapEntry(fileMap, cmdPath, filePath);
-	}
-	return fileMap;
-}
-/**
-* Execute examples for commands based on configuration
-*/
-async function executeConfiguredExamples(allCommands, examplesConfig, rootCommand) {
-	for (const [cmdPath, cmdConfig] of Object.entries(examplesConfig)) {
-		const commandInfo = allCommands.get(cmdPath);
-		if (!commandInfo?.examples?.length) continue;
-		const config = cmdConfig === true ? {} : cmdConfig;
-		const commandPath = cmdPath ? cmdPath.split(" ") : [];
-		commandInfo.exampleResults = await executeExamples(commandInfo.examples, config, rootCommand, commandPath);
-	}
-}
-/**
-* 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, ignores = [], format = {}, formatter, examples: examplesConfig, targetCommands, globalArgs, customizable = false } = 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 if (config.templates !== void 0) files = {};
-	else throw new Error("Either \"path\", \"files\", or \"templates\" must be specified.");
-	let rootDoc = config.rootDoc;
-	if (!rootDoc && usingPathConfig && (globalArgs || config.rootInfo)) rootDoc = { path: resolvedRootDocPath };
-	if (globalArgs && rootDoc && !rootDoc.globalOptions) {
-		const optionFields = 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 = 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.`);
-	}
-	if (examplesConfig) await executeConfiguredExamples(allCommands, examplesConfig, command);
-	const hasTargetCommands = targetCommands !== void 0 && targetCommands.length > 0;
-	const globalOptionDefinitions = collectGlobalOptionDefinitions(rootDoc);
-	const templateGlobalOptionFields = /* @__PURE__ */ new Map();
-	if (config.templates) if (globalOptionDefinitions.size > 0) for (const [name, field] of globalOptionDefinitions) templateGlobalOptionFields.set(name, field);
-	else {
-		const shape = deriveGlobalArgsShape(globalArgs);
-		if (shape) for (const field of collectRenderableGlobalOptionFields(shape)) templateGlobalOptionFields.set(field.name, field);
-	}
-	const documentedCommandPaths = hasTargetCommands ? collectTargetDocumentedCommandPaths(targetCommands, files, allCommands, ignores) : collectDocumentedCommandPaths(files, allCommands, ignores);
-	const allFilesCommands = [];
-	for (const fileConfigRaw of Object.values(files)) {
-		const fileConfig = normalizeFileConfig(fileConfigRaw);
-		allFilesCommands.push(...fileConfig.commands);
-	}
-	validateIgnoresExist(ignores, allCommands);
-	validateNoConflicts(allFilesCommands, ignores, allCommands);
-	const fileMap = buildFileMap(files, allCommands, ignores);
-	const templateContents = /* @__PURE__ */ new Map();
-	const templateExclusions = /* @__PURE__ */ new Map();
-	if (config.templates) for (const [outputPath, templatePath] of Object.entries(config.templates)) {
-		const templateContent = readFile(templatePath);
-		templateContents.set(outputPath, templateContent);
-		if (templateContent !== null) templateExclusions.set(outputPath, buildTemplateExclusions(collectExcludedTemplatePlaceholders(templateContent), allCommands));
-	}
-	const templateEntries = Object.entries(config.templates ?? {});
-	const templateMeta = /* @__PURE__ */ new Map();
-	const templateValidationErrors = /* @__PURE__ */ new Map();
-	if (templateEntries.length > 0) {
-		const normalizedRootDocPath = rootDoc ? normalizeDocPathForComparison(rootDoc.path) : null;
-		const normalizedFileKeys = new Set(Object.keys(files).map(normalizeDocPathForComparison));
-		const normalizedTemplateOutputs = /* @__PURE__ */ new Set();
-		const allNormalizedTemplateOutputs = new Set(templateEntries.map(([outputPath]) => normalizeDocPathForComparison(outputPath)));
-		for (const [outputPath, templatePath] of templateEntries) {
-			const normalizedOutput = normalizeDocPathForComparison(outputPath);
-			const normalizedSource = normalizeDocPathForComparison(templatePath);
-			if (normalizedFileKeys.has(normalizedOutput)) throw new Error(`Template output path "${outputPath}" conflicts with an existing files key.`);
-			if (normalizedRootDocPath && normalizedOutput === normalizedRootDocPath) throw new Error(`Template output path "${outputPath}" conflicts with rootDoc.path "${rootDoc.path}".`);
-			if (normalizedTemplateOutputs.has(normalizedOutput)) throw new Error(`Duplicate template output path: "${outputPath}".`);
-			normalizedTemplateOutputs.add(normalizedOutput);
-			if (normalizedSource === normalizedOutput) throw new Error(`Template output path "${outputPath}" must not be the same as its source template path.`);
-			if (normalizedFileKeys.has(normalizedSource)) throw new Error(`Template source path "${templatePath}" conflicts with a files output key.`);
-			if (normalizedRootDocPath && normalizedSource === normalizedRootDocPath) throw new Error(`Template source path "${templatePath}" conflicts with rootDoc.path "${rootDoc.path}".`);
-			if (allNormalizedTemplateOutputs.has(normalizedSource)) throw new Error(`Template source path "${templatePath}" conflicts with a template output path.`);
-		}
-		const availableCommandPaths = Array.from(allCommands.keys()).join(", ");
-		for (const [outputPath, templatePath] of templateEntries) {
-			const templateContent = templateContents.get(outputPath) ?? null;
-			const validationErrors = [];
-			if (templateContent === null) {
-				templateMeta.set(outputPath, {
-					referencedScopes: [],
-					headingScopes: [],
-					commandTreeRoots: [],
-					emitsGlobalOptions: false,
-					emitsIndex: false
-				});
-				templateValidationErrors.set(outputPath, validationErrors);
-				continue;
-			}
-			try {
-				validateTemplatePlaceholderSyntax(templateContent, templatePath);
-			} catch (error) {
-				validationErrors.push(error instanceof Error ? error.message : String(error));
-			}
-			const placeholders = Array.from(new Set(templateContent.match(TEMPLATE_PLACEHOLDER_REGEX) ?? []));
-			const scopes = /* @__PURE__ */ new Set();
-			const headingScopes = /* @__PURE__ */ new Set();
-			const commandTreeRoots = /* @__PURE__ */ new Set();
-			let emitsGlobalOptions = false;
-			let emitsIndex = false;
-			const exclusions = templateExclusions.get(outputPath) ?? createTemplateExclusions(/* @__PURE__ */ new Set());
-			const indexMetadata = collectTemplateIndexMetadata(templateContent);
-			for (const placeholder of placeholders) {
-				const placeholderKey = templatePlaceholderKey(placeholder);
-				if (exclusions.rawKeys.has(placeholderKey) || isRawCommandPlaceholderUnderExcludedScope(placeholderKey, exclusions)) continue;
-				const parsed = parsePlaceholder(placeholder, allCommands);
-				if (shouldSkipTemplatePlaceholder(placeholder, parsed, exclusions)) continue;
-				if (parsed.kind === "invalid") {
-					validationErrors.push(`${parsed.reason} (in template "${templatePath}")`);
-					continue;
-				}
-				if (parsed.kind === "command") {
-					const { scope, type } = parsed;
-					if (!allCommands.has(scope)) {
-						const sectionTypeError = getUnknownSectionTypeError(scope, allCommands);
-						if (sectionTypeError) {
-							validationErrors.push(`${sectionTypeError} (in template "${templatePath}")`);
-							continue;
-						}
-						validationErrors.push(`Unknown command scope "${scope}" in template "${templatePath}". Available: ${availableCommandPaths}`);
-						continue;
-					}
-					if (ignores.some((pattern) => matchesIgnorePattern(scope, pattern))) {
-						validationErrors.push(`Command scope "${scope}" in template "${templatePath}" conflicts with ignores configuration.`);
-						continue;
-					}
-					if (type === void 0) {
-						const commandTreePaths = getTemplateCommandTreePaths(scope, allCommands, ignores, exclusions);
-						if (!isCommandSectionExcluded(scope, "heading", exclusions)) commandTreeRoots.add(scope);
-						for (const commandTreePath of commandTreePaths) {
-							scopes.add(commandTreePath);
-							if (!isCommandSectionExcluded(commandTreePath, "heading", exclusions)) headingScopes.add(commandTreePath);
-						}
-					} else {
-						scopes.add(scope);
-						if (type === "heading" && !isCommandSectionExcluded(scope, "heading", exclusions)) {
-							headingScopes.add(scope);
-							commandTreeRoots.add(scope);
-						}
-					}
-				} else if (parsed.kind === "global-options") emitsGlobalOptions = true;
-				else if (parsed.kind === "index") emitsIndex = true;
-			}
-			if (emitsGlobalOptions) {
-				if (!(!!rootDoc?.globalOptions || deriveGlobalArgsShape(globalArgs) !== void 0)) validationErrors.push(`Template "${templatePath}" uses {{politty:global-options}} but no global options are configured (neither rootDoc.globalOptions nor globalArgs with non-positional options).`);
-			}
-			templateMeta.set(outputPath, {
-				referencedScopes: Array.from(scopes),
-				headingScopes: Array.from(headingScopes),
-				commandTreeRoots: Array.from(commandTreeRoots),
-				emitsGlobalOptions,
-				emitsIndex,
-				...indexMetadata.title !== void 0 ? { indexTitle: indexMetadata.title } : {},
-				...indexMetadata.description !== void 0 ? { indexDescription: indexMetadata.description } : {}
-			});
-			templateValidationErrors.set(outputPath, validationErrors);
-		}
-		for (const meta of templateMeta.values()) {
-			if (hasTargetCommands && !templateMetaShouldProcessForTarget(meta, targetCommands)) continue;
-			for (const scope of meta.referencedScopes) documentedCommandPaths.add(scope);
-		}
-	}
-	if (hasTargetCommands) for (const targetCommand of targetCommands) {
-		const targetFilePath = findFileForCommand(targetCommand, files, allCommands, ignores);
-		const targetTemplatePath = Array.from(templateMeta.values()).some((meta) => templateMetaReferencesCommandTarget(meta, [targetCommand]));
-		if (!targetFilePath && !targetTemplatePath) throw new Error(`Target command "${targetCommand}" not found in any file or template configuration`);
-	}
-	const activeTemplateMeta = hasTargetCommands && config.templates ? new Map(Array.from(templateMeta.entries()).filter(([, meta]) => templateMetaShouldProcessForTarget(meta, targetCommands))) : templateMeta;
-	for (const [outputPath, validationErrors] of templateValidationErrors.entries()) if (validationErrors.length > 0 && activeTemplateMeta.has(outputPath)) throw new Error(validationErrors.join("\n"));
-	const templateGlobalOptionsProviderPaths = Array.from(templateMeta.entries()).filter(([, meta]) => meta.emitsGlobalOptions).map(([outputPath]) => outputPath);
-	const templateGlobalOptionsProviderPath = templateGlobalOptionsProviderPaths.length === 1 ? templateGlobalOptionsProviderPaths[0] : void 0;
-	validateGlobalOptionCompatibility(documentedCommandPaths, allCommands, globalOptionDefinitions);
-	if (globalOptionDefinitions.size === 0 && templateGlobalOptionFields.size > 0) {
-		const emittingTemplateScopes = /* @__PURE__ */ new Set();
-		for (const meta of activeTemplateMeta.values()) {
-			if (!meta.emitsGlobalOptions && templateGlobalOptionsProviderPath === void 0) continue;
-			for (const scope of meta.referencedScopes) emittingTemplateScopes.add(scope);
-		}
-		validateGlobalOptionCompatibility(emittingTemplateScopes, allCommands, templateGlobalOptionFields);
-	}
-	if (globalOptionDefinitions.size > 0) for (const info of allCommands.values()) {
-		info.options = info.options.filter((opt) => !globalOptionDefinitions.has(opt.name));
-		if (info.extracted) info.extracted = filterExtractedFields(info.extracted, new Set(globalOptionDefinitions.keys()));
-	}
-	const templateFileMap = {};
-	for (const [scope, outputPath] of Object.entries(fileMap)) setFileMapEntry(templateFileMap, scope, outputPath);
-	const scopeRootLength = (root) => root === "" ? 0 : root.split(" ").length;
-	const templateOwners = /* @__PURE__ */ new Map();
-	for (const [templateOutputPath, meta] of templateMeta.entries()) for (const scope of meta.headingScopes) {
-		if (Object.prototype.hasOwnProperty.call(fileMap, scope)) continue;
-		let bestRootLen = -1;
-		for (const root of meta.commandTreeRoots) if (isSubcommandOf(scope, root)) bestRootLen = Math.max(bestRootLen, scopeRootLength(root));
-		if (bestRootLen < 0) continue;
-		const existing = templateOwners.get(scope);
-		if (!existing || bestRootLen > existing.rootLen) templateOwners.set(scope, {
-			outputPath: templateOutputPath,
-			rootLen: bestRootLen
-		});
-	}
-	for (const [scope, { outputPath }] of templateOwners) setFileMapEntry(templateFileMap, scope, outputPath);
-	const results = [];
-	let hasError = false;
-	for (const [filePath, fileConfigRaw] of Object.entries(files)) {
-		const { fileConfig, specifiedCommands, commandPaths } = resolveConfiguredCommandPaths(fileConfigRaw, allCommands, ignores);
-		if (specifiedCommands.length === 0) continue;
-		if (commandPaths.length === 0) continue;
-		const fileTargetCommands = hasTargetCommands ? findTargetCommandsInFile(targetCommands, filePath, files, allCommands, ignores) : [];
-		if (hasTargetCommands && fileTargetCommands.length === 0) continue;
-		let fileStatus = "match";
-		const diffs = [];
-		const minDepth = Math.min(...commandPaths.map((p) => allCommands.get(p)?.depth ?? 1));
-		const adjustedHeadingLevel = Math.max(1, (format?.headingLevel ?? 1) - (minDepth - 1));
-		const isRootDocFile = usingPathConfig && rootDoc && normalizeDocPathForComparison(filePath) === normalizeDocPathForComparison(rootDoc.path);
-		const fileUsesMarkers = usingPathConfig || customizable;
-		const fileRenderer = createCommandRenderer({
-			...format,
-			headingLevel: adjustedHeadingLevel,
-			markerless: !fileUsesMarkers
-		});
-		const render = fileConfig.render ?? fileRenderer;
-		if (Boolean(isRootDocFile) || hasTargetCommands && fileUsesMarkers) {
-			let existingContent = readFile(filePath);
-			const sortedCommandPaths = sortDepthFirst(commandPaths, specifiedCommands);
-			const effectiveTargetCommands = hasTargetCommands ? fileTargetCommands : commandPaths;
-			for (const targetCommand of effectiveTargetCommands) {
-				const rawSection = generateCommandSection(targetCommand, allCommands, render, filePath, templateFileMap, rootDoc?.path, globalOptionDefinitions.size > 0, ignores);
-				if (!rawSection) throw new Error(`Target command "${targetCommand}" not found in commands`);
-				const generatedSection = await applyFormatter(rawSection, formatter);
-				if (!existingContent) {
-					if (updateMode) {
-						const header = targetCommand === "" && fileConfig ? generateFileHeader(fileConfig) : null;
-						const fullContent = header ? `${header}\n${generatedSection}` : generatedSection;
-						writeFile(filePath, fullContent);
-						existingContent = fullContent;
-						fileStatus = "created";
-					} else {
-						hasError = true;
-						fileStatus = "diff";
-						diffs.push(`File does not exist. Target command "${targetCommand}" section cannot be validated.`);
-					}
-					continue;
-				}
-				const existingMarkers = collectSectionMarkers(existingContent, targetCommand);
-				if (existingMarkers.length === 0) {
-					if (updateMode) {
-						existingContent = insertCommandSections(existingContent, targetCommand, generatedSection, sortedCommandPaths);
-						writeFile(filePath, existingContent);
-						if (fileStatus !== "created") fileStatus = "updated";
-					} else {
-						hasError = true;
-						fileStatus = "diff";
-						diffs.push(`Existing file does not contain section markers for command "${targetCommand}"`);
-					}
-					continue;
-				}
-				for (const sectionType of existingMarkers) {
-					const existingSection = extractSectionMarker(existingContent, sectionType, targetCommand);
-					const generatedSectionPart = extractSectionMarker(generatedSection, sectionType, targetCommand);
-					if (!existingSection) continue;
-					if (!generatedSectionPart) {
-						const emptyMarker = sectionStartMarker(sectionType, targetCommand) + "\n" + sectionEndMarker(sectionType, targetCommand);
-						if (existingSection !== emptyMarker) if (updateMode) {
-							const updated = replaceSectionMarker(existingContent, sectionType, targetCommand, emptyMarker);
-							if (!updated) throw new Error(`Failed to replace stale ${sectionType} section for command "${targetCommand}"`);
-							existingContent = updated.replace(/\n{3,}/g, "\n\n");
-							writeFile(filePath, existingContent);
-							if (fileStatus !== "created") fileStatus = "updated";
-						} else {
-							hasError = true;
-							fileStatus = "diff";
-							diffs.push(formatDiff(existingSection, emptyMarker));
-						}
-						continue;
-					}
-					if (existingSection !== generatedSectionPart) if (updateMode) {
-						const updated = replaceSectionMarker(existingContent, sectionType, targetCommand, generatedSectionPart);
-						if (updated) {
-							existingContent = updated;
-							writeFile(filePath, existingContent);
-							if (fileStatus !== "created") fileStatus = "updated";
-						} else throw new Error(`Failed to replace ${sectionType} section for command "${targetCommand}"`);
-					} else {
-						hasError = true;
-						fileStatus = "diff";
-						diffs.push(formatDiff(existingSection, generatedSectionPart));
-					}
-				}
-				if (doctorMode || customizable) {
-					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 (doctorMode && updateMode) {
-							existingContent = insertSectionMarkerAtOrder(existingContent, sectionType, targetCommand, generatedSectionPart);
-							writeFile(filePath, existingContent);
-							if (fileStatus !== "created") fileStatus = "updated";
-						} else if (doctorMode) {
-							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}`);
-						} else console.warn(`[politty] Missing "${sectionType}" section for command "${formatCommandPath(targetCommand)}" in ${filePath}. Run with ${DOCTOR_ENV}=true ${UPDATE_GOLDEN_ENV}=true to insert it, or leave it removed to opt that section out.`);
-					}
-				}
-			}
-			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, templateFileMap, specifiedCommands, fileConfig, rootDoc?.path, globalOptionDefinitions.size > 0, ignores), formatter);
-			const comparison = compareWithExisting(generatedMarkdown, filePath);
-			if (comparison.match) {} else if (updateMode) {
-				writeFile(filePath, generatedMarkdown);
-				fileStatus = comparison.fileExists ? "updated" : "created";
-			} else {
-				hasError = true;
-				fileStatus = "diff";
-				if (comparison.diff) diffs.push(comparison.diff);
-			}
-		}
-		if (diffs.length > 0) fileStatus = "diff";
-		results.push({
-			path: filePath,
-			status: fileStatus,
-			diff: diffs.length > 0 ? diffs.join("\n\n") : void 0
-		});
-	}
-	let normalizedTemplateGlobalOptions;
-	if (rootDoc?.globalOptions) normalizedTemplateGlobalOptions = normalizeGlobalOptions(rootDoc.globalOptions);
-	else {
-		const shape = deriveGlobalArgsShape(globalArgs);
-		if (shape) normalizedTemplateGlobalOptions = { args: shape };
-	}
-	for (const [outputPath, templatePath] of templateEntries) {
-		if (!activeTemplateMeta.has(outputPath)) continue;
-		const templateContent = templateContents.get(outputPath) ?? null;
-		if (templateContent === null) {
-			hasError = true;
-			results.push({
-				path: outputPath,
-				status: "diff",
-				diff: `Template file not found: ${templatePath}`
-			});
-			continue;
-		}
-		const meta = templateMeta.get(outputPath);
-		const templateLineEnding = detectLineEnding(templateContent);
-		const outputTemplateContent = stripPolittyFrontMatterForOutput(templateContent);
-		const headingDepths = (meta?.headingScopes ?? []).map((s) => allCommands.get(s)?.depth ?? 1);
-		const minDepth = headingDepths.length > 0 ? Math.min(...headingDepths) : 1;
-		const adjustedHeadingLevel = clampHeadingLevel((format?.headingLevel ?? 1) - (minDepth - 1));
-		const templateRenderer = createCommandRenderer({
-			...format,
-			headingLevel: adjustedHeadingLevel
-		});
-		const outputEmitsGlobalOptions = meta?.emitsGlobalOptions ?? false;
-		const excludeOptionNames = (rootDoc !== void 0 && globalOptionDefinitions.size > 0 || outputEmitsGlobalOptions || templateGlobalOptionsProviderPath !== void 0) && templateGlobalOptionFields.size > 0 ? new Set(templateGlobalOptionFields.keys()) : void 0;
-		const sectionHasGlobalOptions = excludeOptionNames !== void 0;
-		const effectiveRootDocPath = outputEmitsGlobalOptions ? outputPath : rootDoc?.path ?? templateGlobalOptionsProviderPath;
-		const placeholders = Array.from(new Set(outputTemplateContent.match(TEMPLATE_PLACEHOLDER_REGEX) ?? []));
-		const replacements = /* @__PURE__ */ new Map();
-		const exclusions = templateExclusions.get(outputPath) ?? createTemplateExclusions(/* @__PURE__ */ new Set());
-		for (const placeholder of placeholders) {
-			const placeholderKey = templatePlaceholderKey(placeholder);
-			if (exclusions.rawKeys.has(placeholderKey) || isRawCommandPlaceholderUnderExcludedScope(placeholderKey, exclusions)) {
-				replacements.set(placeholder, "");
-				continue;
-			}
-			const parsed = parsePlaceholder(placeholder, allCommands);
-			if (shouldSkipTemplatePlaceholder(placeholder, parsed, exclusions)) {
-				replacements.set(placeholder, "");
-				continue;
-			}
-			if (parsed.kind === "invalid") throw new Error(`Internal error: unresolved placeholder "${placeholder}" in template "${templatePath}": ${parsed.reason}`);
-			if (parsed.kind === "command") {
-				const { scope, type } = parsed;
-				if (type === void 0) {
-					const rawSection = generateCommandTreeMarkdown(scope, allCommands, templateRenderer, ignores, outputPath, templateFileMap, effectiveRootDocPath, sectionHasGlobalOptions, excludeOptionNames, exclusions);
-					if (rawSection === null) {
-						replacements.set(placeholder, "");
-						continue;
-					}
-					replacements.set(placeholder, stripPolittyMarkers(rawSection));
-				} else {
-					const rawSection = generateCommandSection(scope, allCommands, templateRenderer, outputPath, templateFileMap, effectiveRootDocPath, sectionHasGlobalOptions, ignores, excludeOptionNames, exclusions);
-					if (rawSection === null) {
-						replacements.set(placeholder, "");
-						continue;
-					}
-					const extracted = extractSectionMarker(rawSection, type, scope);
-					replacements.set(placeholder, extracted === null ? "" : stripPolittyMarkers(extracted));
-				}
-			} else if (parsed.kind === "global-options") if (normalizedTemplateGlobalOptions) replacements.set(placeholder, buildGlobalOptionsContent(normalizedTemplateGlobalOptions));
-			else replacements.set(placeholder, "");
-			else if (parsed.kind === "index") {
-				const categories = [...deriveIndexFromFiles(files, outputPath, allCommands, ignores), ...deriveIndexFromTemplateOutputs(templateMeta, outputPath, outputPath, allCommands)];
-				const indexContent = await renderCommandIndex(command, categories, rootDoc?.index);
-				replacements.set(placeholder, indexContent);
-			}
-		}
-		let generated = outputTemplateContent.replace(/((?:\r?\n)*)([ \t]*)(\{\{politty:[^{}]*\}\})([ \t]*)((?:\r?\n)*)/g, (match, leadNl, leadWs, placeholder, trailWs, trailNl, offset, fullString) => {
-			const replacement = replacements.get(placeholder);
-			if (replacement === void 0) throw new Error(`Internal error: unresolved placeholder "${placeholder}" in template "${templatePath}".`);
-			const startsLine = leadNl !== "" || offset === 0 || fullString[offset - 1] === "\n";
-			const endsLine = trailNl !== "" || offset + match.length === fullString.length;
-			if (replacement === "" && startsLine && endsLine) {
-				if (leadNl === "" || trailNl === "") return "";
-				const leadBreaks = countLineBreaks(leadNl);
-				const trailBreaks = countLineBreaks(trailNl);
-				const widest = Math.max(leadBreaks, trailBreaks);
-				const lineEnding = leadBreaks >= trailBreaks ? detectLineEnding(leadNl) : detectLineEnding(trailNl);
-				return widest >= 2 ? lineEnding + lineEnding : widest === 1 ? lineEnding : "";
-			}
-			return `${leadNl}${leadWs}${replacement}${trailWs}${trailNl}`;
-		});
-		generated = `${generated.trimEnd()}${templateLineEnding}`;
-		generated = await applyFormatter(generated, formatter);
-		const comparison = compareWithExisting(generated, outputPath);
-		let templateStatus = "match";
-		let templateDiff;
-		if (comparison.match) {} else if (updateMode) {
-			writeFile(outputPath, generated);
-			templateStatus = comparison.fileExists ? "updated" : "created";
-		} else {
-			hasError = true;
-			templateStatus = "diff";
-			if (comparison.diff) templateDiff = comparison.diff;
-		}
-		results.push({
-			path: outputPath,
-			status: templateStatus,
-			diff: templateDiff
-		});
-	}
-	if (rootDoc) {
-		const rootDocFilePath = rootDoc.path;
-		let rootDocStatus = "match";
-		const rootDocDiffs = [];
-		const existingContent = readFile(rootDocFilePath);
-		if (existingContent === null) {
-			hasError = true;
-			rootDocStatus = "diff";
-			rootDocDiffs.push("File does not exist. Cannot validate rootDoc markers.");
-		} else {
-			let content = existingContent;
-			let markerUpdated = false;
-			const rootInfo = config.rootInfo;
-			const rootDocFileConfig = { title: rootInfo?.title ?? command.name };
-			if (rootDoc.headingLevel !== void 0) rootDocFileConfig.headingLevel = rootDoc.headingLevel;
-			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;
-			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 = 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(", ")}.`);
-				}
-			}
-			const normalizedGlobalOptions = normalizeGlobalOptions(rootDoc.globalOptions);
-			if (normalizedGlobalOptions) {
-				const globalOptionsResult = await processGlobalOptionsMarker(content, normalizedGlobalOptions, updateMode, formatter, usingPathConfig);
-				content = globalOptionsResult.content;
-				rootDocDiffs.push(...globalOptionsResult.diffs);
-				if (globalOptionsResult.hasError) hasError = true;
-				if (globalOptionsResult.wasUpdated) markerUpdated = true;
-			}
-			const derivedCategories = deriveIndexFromFiles(files, rootDocFilePath, allCommands, ignores);
-			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);
-			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";
-			}
-		}
-		if (rootDocDiffs.length > 0) rootDocStatus = "diff";
-		results.push({
-			path: rootDocFilePath,
-			status: rootDocStatus,
-			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. ${errorHint}` : void 0
-	};
-}
-/**
-* Assert that documentation matches golden files
-* Throws an error if there are differences and update mode is not enabled
-*/
-async function assertDocMatch(config) {
-	const result = await generateDoc(config);
-	if (!result.success) {
-		const diffMessages = result.files.filter((f) => f.status === "diff").map((f) => {
-			let msg = `File: ${f.path}\n`;
-			if (f.diff) msg += f.diff;
-			return msg;
-		}).join("\n\n");
-		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.`));
-	}
-}
-/**
-* Initialize documentation files by deleting them
-* Only deletes when update mode is enabled (POLITTY_DOCS_UPDATE=true)
-* Use this in beforeAll to ensure skipped tests don't leave stale sections
-* @param config - Config containing files to initialize, or a single file path
-* @param fileSystem - Optional fs implementation (useful when fs is mocked)
-*/
-function initDocFile(config, fileSystem) {
-	if (!isTruthyEnv("POLITTY_DOCS_UPDATE")) return;
-	if (typeof config === "string") deleteFile(config, fileSystem);
-	else {
-		const protectedPaths = new Set(Object.values(config.templates ?? {}).map(normalizeDocPathForComparison));
-		if (config.rootDoc) protectedPaths.add(normalizeDocPathForComparison(config.rootDoc.path));
-		const isProtectedPath = (p) => protectedPaths.has(normalizeDocPathForComparison(p));
-		if (config.files) for (const filePath of Object.keys(config.files)) {
-			if (isProtectedPath(filePath)) continue;
-			deleteFile(filePath, fileSystem);
-		}
-		if (config.templates) for (const outputPath of Object.keys(config.templates)) {
-			if (isProtectedPath(outputPath)) continue;
-			deleteFile(outputPath, fileSystem);
-		}
-	}
-}
+`:`
+`)+e.slice(t)}if(c!=null){let t=c;for(;t>0&&e[t-1]===`
+`;)t--;let n=t===0?``:`
 
-//#endregion
-export { DOCTOR_ENV, GLOBAL_OPTIONS_MARKER_PREFIX, INDEX_MARKER_PREFIX, ROOT_FOOTER_MARKER_PREFIX, ROOT_HEADER_MARKER_PREFIX, SECTION_MARKER_PREFIX, SECTION_TYPES, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, rootFooterEndMarker, rootFooterStartMarker, rootHeaderEndMarker, rootHeaderStartMarker, sectionEndMarker, sectionStartMarker, writeFile };
+`;return e.slice(0,t)+n+r+`
+
+`+e.slice(c)}throw Error(`No insertion point found for section "${t}" (scope="${n}"). This should be unreachable when at least one marker exists for the command.`)}function lt(e,t){let n=[];for(let r of D)Q(e,r,t)!==null&&n.push(r);return n}function ut(e){let t=D.join(`|`),n=RegExp(`<!--\\s*politty:command:(.*?):(?:${t}):start\\s*-->`,`g`),r=new Set;for(let t of e.matchAll(n))r.add(t[1]??``);return Array.from(r)}function dt(e,t,n,r){let i=r.indexOf(t);if(i===-1)return e.trimEnd()+`
+
+`+n+`
+`;for(let t=i+1;t<r.length;t++){let i=r[t];if(i===void 0)continue;let a=k(`heading`,i),o=e.indexOf(a);if(o!==-1){let t=o;for(;t>0&&e[t-1]===`
+`;)t--;return t<o&&t++,e.slice(0,t)+n+`
+`+e.slice(o)}}for(let t=i-1;t>=0;t--){let i=r[t];if(i===void 0)continue;let a=lt(e,i);if(a.length>0){let t=a[a.length-1],r=A(t,i),o=e.indexOf(r);if(o!==-1){let t=o+r.length;return e.slice(0,t)+`
+`+n+e.slice(t)}}}return e.trimEnd()+`
+`+n+`
+`}function ft(e,t){let n=lt(e,t);for(let r of n){let n=k(r,t),i=A(r,t),a=e.indexOf(n);for(;a!==-1;){let t=e.indexOf(i,a);if(t===-1)break;e=e.slice(0,a)+e.slice(t+i.length),a=e.indexOf(n,a)}}return e=e.replace(/\n{3,}/g,`
+
+`),e}function pt(e){let t=mt(e.split(`
+`).filter(e=>!/^<!-- politty:.*-->$/.test(e.trim())).join(`
+`));return t=t.replace(/^\n+/,``).replace(/\n+$/,``),t}function mt(e){let t=e.split(`
+`),n=[],r=!1,i=0;for(let e of t){let t=e.trim();if(t.startsWith("```")||t.startsWith(`~~~`)){r=!r,i=0,n.push(e);continue}if(!r&&e.trim()===``){if(i++,i>=2)continue}else r||(i=0);n.push(e)}return n.join(`
+`)}function ht(e){return e.includes(`\r
+`)?`\r
+`:`
+`}function gt(e){return(e.match(/\n/g)??[]).length}function _t(e){return D.some(t=>t===e)}function vt(e){switch(Math.min(6,Math.max(1,Math.trunc(e)))){case 1:return 1;case 2:return 2;case 3:return 3;case 4:return 4;case 5:return 5;default:return 6}}function yt(e,t){if(e.length===0)return t===void 0||t.has(``)?``:null;let n=e.join(`:`);if(t?.has(n))return n;let r=e.join(` `);return t?.has(r)||t===void 0?r:null}function bt(e){return e.join(` `)}function xt(e,t){let n=e.slice(2,-2).split(`:`),r=n[1];if(r===`command`){let r=n.slice(2);if(r.length===1&&r[0]===``)return{kind:`invalid`,reason:`Trailing colon in "${e}"; use {{politty:command}} for the root command.`};let i=yt(r,t);if(i!==null)return{kind:`command`,scope:i,type:void 0};if(r.length>=2){let e=r[r.length-1],n=r.slice(0,-1),i=yt(n,t);if(e!==void 0&&_t(e))return{kind:`command`,scope:i??bt(n),type:e};if(e!==void 0&&i!==null)return{kind:`invalid`,reason:`Unknown section type "${e}" for command scope "${Z(i)}". Valid section types: ${D.join(`, `)}`}}return{kind:`command`,scope:bt(r),type:void 0}}return r===`global-options`?n.length===2?{kind:`global-options`}:{kind:`invalid`,reason:`Malformed placeholder "${e}". Expected {{politty:global-options}}.`}:r===`index`?n.length===2?{kind:`index`}:{kind:`invalid`,reason:`Malformed placeholder "${e}". Expected {{politty:index}}.`}:{kind:`invalid`,reason:`Unknown politty directive "${r??``}" in "${e}". Valid directives: command, global-options, index`}}function St(e,t){let n=Ke(e);for(let r of e){let e=xt(`{{politty:${r}}}`,t);if(e.kind===`command`){if(e.type===void 0)n.commandScopes.add(e.scope);else{let t=n.commandSections.get(e.scope);t||(t=new Set,n.commandSections.set(e.scope,t)),t.add(e.type)}}else e.kind===`global-options`?n.globalOptions=!0:e.kind===`index`&&(n.index=!0)}return n}function Ct(e,t){for(let n of t)if(J(e,n))return!0;return!1}function wt(e,t,n){return Ct(e,n.commandScopes)?!0:n.commandSections.get(e)?.has(t)??!1}function Tt(e,t,n,r){return rt($e(Qe([e],t),n).filter(e=>!Ct(e,r.commandScopes)),[e])}function Et(e,t,n){return n.rawKeys.has(Ve(e))?!0:t.kind===`command`?Ct(t.scope,n.commandScopes)?!0:t.type!==void 0&&(n.commandSections.get(t.scope)?.has(t.type)??!1):t.kind===`global-options`?n.globalOptions:t.kind===`index`&&n.index}function Dt(e,t){if(!e.startsWith(`command:`))return!1;let n=e.slice(8).split(`:`);for(let e of t.commandScopes){if(e===``)return!0;let t=e.split(` `);if(n.slice(0,t.length).join(` `)===e)return!0;let r=e.split(`:`);if(n.slice(0,r.length).join(`:`)===e)return!0}return!1}const Ot=/\{\{politty:[^{}]*\}\}/g;function kt(e,t){let n=new Set;for(let r of e.matchAll(Ot)){let i=r.index,a=i+r[0].length;if(e[i-1]===`{`||e[a]===`}`){let n=e.slice(Math.max(0,i-1),Math.min(e.length,a+1)).split(`
+`)[0];throw Error(`Malformed politty placeholder in template "${t}": "${n}". Expected {{politty:...}}.`)}n.add(i)}let r=0;for(;;){let i=e.indexOf(`{{politty:`,r);if(i===-1)return;if(!n.has(i)){let n=e.slice(i,i+80).split(`
+`)[0];throw Error(`Malformed politty placeholder in template "${t}": "${n}". Expected {{politty:...}}.`)}r=i+10}}function At(e,t){let n=e.lastIndexOf(`:`);if(n===-1)return null;let r=e.slice(0,n),i=e.slice(n+1);return i===``||!t.has(r)?null:`Unknown section type "${i}" for command scope "${Z(r)}". Valid section types: ${D.join(`, `)}`}function jt(e,t,n){let r=e.indexOf(t);if(r===-1)return null;let i=e.indexOf(n,r);return i===-1?null:e.slice(r,i+n.length)}function Mt(e,t,n,r){let i=e.indexOf(t);if(i===-1)return null;let a=e.indexOf(n,i);return a===-1?null:e.slice(0,i)+r+e.slice(a+n.length)}function Nt(e){if(typeof e!=`object`||!e)return!1;let t=e[`~standard`];if(typeof t!=`object`||!t)return!1;let{vendor:n,validate:r}=t;return typeof n==`string`&&typeof r==`function`}function Pt(e){return typeof e!=`object`||!e||!(`args`in e)?!1:!Nt(e.args)}function Ft(t){let n=e();return Object.entries(t).map(([e,t])=>n.resolveFieldMeta(e,t)).filter(e=>!e.positional)}function It(e,t){let{schema:n,...r}=e,{schema:i,...a}=t;return c(r,a)}function Lt(e){if(e)return Pt(e)?e:{args:e}}function Rt(e){if(!e)return;let t=n(e).fields.filter(e=>!e.positional);if(t.length!==0)return Object.fromEntries(t.map(e=>[e.name,e.schema]))}function zt(e){let t=new Map;if(!e?.globalOptions)return t;let n=Lt(e.globalOptions);if(!n)return t;for(let e of Ft(n.args))t.set(e.name,e);return t}function Bt(e,t,n,r){let i=[];for(let[a,s]of Object.entries(e)){let{commandPaths:e,topLevelCommands:c}=X(s,n,r);if(e.length===0)continue;let l=`./`+o.relative(o.dirname(t),a).replace(/\\/g,`/`),u=e[0],d=u===void 0?void 0:n.get(u),f=Array.isArray(s)?void 0:s;i.push({title:f?.title??d?.name??o.basename(a,o.extname(a)),description:f?.description??d?.description??``,commands:c,allowedCommands:e,docPath:l})}return i}function Vt(e,t,n,r){let i=$(t),a=[];for(let[t,s]of e.entries()){if($(t)===i)continue;let e=s.headingScopes;if(e.length===0)continue;let c=`./`+o.relative(o.dirname(n),t).replace(/\\/g,`/`),l=e[0],u=l===void 0?void 0:r.get(l);a.push({title:s.indexTitle??u?.name??o.basename(t,o.extname(t)),description:s.indexDescription??u?.description??``,commands:e,docPath:c,noExpand:!0})}return a}function Ht(e,t,n){let r=new Set;for(let i of Object.values(e)){let{commandPaths:e}=X(i,t,n);for(let t of e)r.add(t)}return r}function Ut(e,t,n,r){let i=new Set;for(let a of Object.keys(t)){let o=tn(e,a,t,n,r);for(let e of o)i.add(e)}return i}function Wt(e,t){return t.some(t=>J(e,t))}function Gt(e,t){return e.referencedScopes.some(e=>Wt(e,t))}function Kt(e,t){return e.emitsIndex||e.emitsGlobalOptions||Gt(e,t)}function qt(e,t,n){if(n.size===0)return;let r=[];for(let i of e){let e=t.get(i);if(e)for(let t of e.options){let e=n.get(t.name);e&&(It(e,t)||r.push(`Command "${Z(i)}" option "--${t.cliName}" does not match globalOptions definition for "${t.name}".`))}}if(r.length>0)throw Error(`Invalid globalOptions configuration:\n  - ${r.join(`
+  - `)}`)}function Jt(e){return[`<a id="global-options"></a>`,Oe(e.args,e.options)].join(`
+`)}function Yt(e){return[M(),Jt(e),N()].join(`
+`)}async function Xt(e,t,n,r){let i=L(n),a=ie(n);return[i,await Fe(t,e,r),a].join(`
+`)}function $(e){return o.resolve(e)}async function Zt(e,t,n,r,i){let a=e,o=[],s=!1,c=!1,l=M(),u=N(),d=await q(Yt(t),r),f=jt(a,l,u);if(!f)return n&&i?(a=a.trimEnd()+`
+
+`+d+`
+`,c=!0,{content:a,diffs:o,hasError:s,wasUpdated:c}):(s=!0,o.push(`Global options marker not found in file. Expected markers:\n${l}\n...\n${u}`),{content:a,diffs:o,hasError:s,wasUpdated:c});if(f!==d){if(n){let e=Mt(a,l,u,d);e?(a=e,c=!0):(s=!0,o.push(`Failed to replace global options section`))}else s=!0,o.push(G(f,d))}return{content:a,diffs:o,hasError:s,wasUpdated:c}}async function Qt(e,t,n,r,i,a,o,s){let c=e,l=[],u=!1,d=!1,f=[n,await q(i,o),r].join(`
+`),p=jt(c,n,r);if(!p)return a&&s?(c=c.trimEnd()+`
+
+`+f+`
+`,d=!0,{content:c,diffs:l,hasError:u,wasUpdated:d}):(u=!0,l.push(`${t} marker not found in file. Expected markers:\n${n}\n...\n${r}`),{content:c,diffs:l,hasError:u,wasUpdated:d});if(p!==f){if(a){let e=Mt(c,n,r,f);e?(c=e,d=!0):(u=!0,l.push(`Failed to replace ${t} section`))}else u=!0,l.push(G(p,f))}return{content:c,diffs:l,hasError:u,wasUpdated:d}}async function $t(e,t,n,r,i,a,o){let s=e,c=[],l=!1,u=!1,d=L(r),f=ie(r),p=s.includes(d),m=s.includes(f);if(!p&&!m)return{content:s,diffs:c,hasError:l,wasUpdated:u};if(!p||!m)return l=!0,c.push(`Index marker section is malformed: both start and end markers are required.`),{content:s,diffs:c,hasError:l,wasUpdated:u};let h=jt(s,d,f);if(!h)return l=!0,c.push(`Index marker section is malformed: start marker must appear before end marker.`),{content:s,diffs:c,hasError:l,wasUpdated:u};let g=await q(await Xt(t,n,r,o),a);if(h!==g){if(i){let e=Mt(s,d,f,g);e?(s=e,u=!0):(l=!0,c.push(`Failed to replace index section`))}else l=!0,c.push(G(h,g))}return{content:s,diffs:c,hasError:l,wasUpdated:u}}function en(e,t,n,r){for(let[i,a]of Object.entries(t)){let{commandPaths:t}=X(a,n,r);if(t.includes(e))return i}return null}function tn(e,t,n,r,i){let a=n[t];if(!a)return[];let{specifiedCommands:o,commandPaths:s}=X(a,r,i),c=new Set;for(let t of e)if(s.includes(t)){c.add(t);for(let e of s)J(e,t)&&!o.includes(e)&&c.add(e)}return Array.from(c)}function nn(e,t,n,r,i,a,o,s=[],c,l){let u=t.get(e);if(!u||l&&Ct(u.commandPath,l.commandScopes))return null;let d={...u,filePath:r,fileMap:i,rootDocPath:a};(s.length>0||l&&l.commandScopes.size>0)&&(d.subCommands=u.subCommands.filter(e=>{let t=e.fullPath.join(` `);return!s.some(e=>Ze(t,e))&&!(l&&Ct(t,l.commandScopes))})),o!==void 0&&(d.hasGlobalOptions=o),c&&c.size>0&&(d.options=u.options.filter(e=>!c.has(e.name)),u.extracted&&(d.extracted=an(u.extracted,c)));let f=n(d);if(l){for(let[e,t]of l.commandSections)if(e===u.commandPath){for(let n of t){let t=Q(f,n,e);t!==null&&(f=f.replace(t,``))}f=mt(f)}}return f}function rn(e,t,n,r,i,a,o,s,c,l){let u=Tt(e,t,r,l),d=[];for(let e of u){let u=nn(e,t,n,i,a,o,s,r,c,l);u!==null&&d.push(u)}return d.length===0?null:d.join(`
+`)}function an(e,t){let n={...e,fields:e.fields.filter(e=>!t.has(e.name))};return e.unionOptions&&(n.unionOptions=e.unionOptions.map(e=>an(e,t))),e.variants&&(n.variants=e.variants.map(e=>({...e,fields:e.fields.filter(e=>!t.has(e.name))}))),n}function on(e,t,n,r,i,a,o,s,c,l=[]){let u=[],d=o?it(o):null;d&&u.push(d);let f=rt(e,a??[]);for(let e of f){let a=nn(e,t,n,r,i,s,c,l);a&&u.push(a)}return`${u.join(`
+`)}\n`}function sn(e,t,n){let r={};for(let[i,a]of Object.entries(e)){let{commandPaths:e}=X(a,t,n);for(let t of e)qe(r,t,i)}return r}async function cn(e,t,n){for(let[r,i]of Object.entries(t)){let t=e.get(r);if(!t?.examples?.length)continue;let a=i===!0?{}:i,o=r?r.split(` `):[];t.exampleResults=await we(t.examples,a,n,o)}}function ln(e,t){if(typeof e==`string`)return{files:{[e]:Array.from(t.keys())},rootDocPath:e};let{root:n,commands:r={}}=e,i={},a=new Set,o=Object.entries(r).sort(([e],[t])=>t.split(` `).length-e.split(` `).length);for(let[e,n]of o){i[n]||(i[n]={commands:[],noExpand:!0});let r=i[n];for(let n of t.keys())(n===e||n.startsWith(e+` `))&&!a.has(n)&&(r.commands.push(n),a.add(n))}return i[n]={commands:Array.from(t.keys()).filter(e=>!a.has(e)),noExpand:!0},{files:i,rootDocPath:n}}async function un(e){let{command:t,ignores:r=[],format:i={},formatter:a,examples:s,targetCommands:c,globalArgs:l,customizable:u=!1}=e,d=await Ce(t),f,p=!1,m;if(e.path!==void 0){if(e.files!==void 0)throw Error(`Cannot specify both "path" and "files". Use one or the other.`);let t=ln(e.path,d);f=t.files,m=t.rootDocPath,p=!0}else if(e.files!==void 0)f=e.files;else if(e.templates!==void 0)f={};else throw Error(`Either "path", "files", or "templates" must be specified.`);let h=e.rootDoc;if(!h&&p&&(l||e.rootInfo)&&(h={path:m}),l&&h&&!h.globalOptions){let e=n(l).fields.filter(e=>!e.positional);if(e.length>0){let t=Object.fromEntries(e.map(e=>[e.name,e.schema]));h={...h,globalOptions:t}}}let g=Ie(T),_=Ie(E),v=!1;if(h&&!p){let e=$(h.path);if(Object.keys(f).some(t=>$(t)===e))throw Error(`rootDoc.path "${h.path}" must not also appear as a key in files.`)}s&&await cn(d,s,t);let y=c!==void 0&&c.length>0,b=zt(h),x=new Map;if(e.templates){if(b.size>0)for(let[e,t]of b)x.set(e,t);else{let e=Rt(l);if(e)for(let t of Ft(e))x.set(t.name,t)}}let S=y?Ut(c,f,d,r):Ht(f,d,r),C=[];for(let e of Object.values(f)){let t=Je(e);C.push(...t.commands)}nt(r,d),tt(C,r,d);let w=sn(f,d,r),D=new Map,O=new Map;if(e.templates)for(let[t,n]of Object.entries(e.templates)){let e=be(n);D.set(t,e),e!==null&&O.set(t,St(We(e),d))}let j=Object.entries(e.templates??{}),M=new Map,N=new Map;if(j.length>0){let e=h?$(h.path):null,t=new Set(Object.keys(f).map($)),n=new Set,i=new Set(j.map(([e])=>$(e)));for(let[r,a]of j){let o=$(r),s=$(a);if(t.has(o))throw Error(`Template output path "${r}" conflicts with an existing files key.`);if(e&&o===e)throw Error(`Template output path "${r}" conflicts with rootDoc.path "${h.path}".`);if(n.has(o))throw Error(`Duplicate template output path: "${r}".`);if(n.add(o),s===o)throw Error(`Template output path "${r}" must not be the same as its source template path.`);if(t.has(s))throw Error(`Template source path "${a}" conflicts with a files output key.`);if(e&&s===e)throw Error(`Template source path "${a}" conflicts with rootDoc.path "${h.path}".`);if(i.has(s))throw Error(`Template source path "${a}" conflicts with a template output path.`)}let a=Array.from(d.keys()).join(`, `);for(let[e,t]of j){let n=D.get(e)??null,i=[];if(n===null){M.set(e,{referencedScopes:[],headingScopes:[],commandTreeRoots:[],emitsGlobalOptions:!1,emitsIndex:!1}),N.set(e,i);continue}try{kt(n,t)}catch(e){i.push(e instanceof Error?e.message:String(e))}let o=Array.from(new Set(n.match(Ot)??[])),s=new Set,c=new Set,u=new Set,f=!1,p=!1,m=O.get(e)??Ke(new Set),g=Ge(n);for(let e of o){let n=Ve(e);if(m.rawKeys.has(n)||Dt(n,m))continue;let o=xt(e,d);if(!Et(e,o,m)){if(o.kind===`invalid`){i.push(`${o.reason} (in template "${t}")`);continue}if(o.kind===`command`){let{scope:e,type:n}=o;if(!d.has(e)){let n=At(e,d);if(n){i.push(`${n} (in template "${t}")`);continue}i.push(`Unknown command scope "${e}" in template "${t}". Available: ${a}`);continue}if(r.some(t=>Ze(e,t))){i.push(`Command scope "${e}" in template "${t}" conflicts with ignores configuration.`);continue}if(n===void 0){let t=Tt(e,d,r,m);wt(e,`heading`,m)||u.add(e);for(let e of t)s.add(e),wt(e,`heading`,m)||c.add(e)}else s.add(e),n===`heading`&&!wt(e,`heading`,m)&&(c.add(e),u.add(e))}else o.kind===`global-options`?f=!0:o.kind===`index`&&(p=!0)}}f&&(h?.globalOptions||Rt(l)!==void 0||i.push(`Template "${t}" uses {{politty:global-options}} but no global options are configured (neither rootDoc.globalOptions nor globalArgs with non-positional options).`)),M.set(e,{referencedScopes:Array.from(s),headingScopes:Array.from(c),commandTreeRoots:Array.from(u),emitsGlobalOptions:f,emitsIndex:p,...g.title===void 0?{}:{indexTitle:g.title},...g.description===void 0?{}:{indexDescription:g.description}}),N.set(e,i)}for(let e of M.values())if(!(y&&!Kt(e,c)))for(let t of e.referencedScopes)S.add(t)}if(y)for(let e of c){let t=en(e,f,d,r),n=Array.from(M.values()).some(t=>Gt(t,[e]));if(!t&&!n)throw Error(`Target command "${e}" not found in any file or template configuration`)}let P=y&&e.templates?new Map(Array.from(M.entries()).filter(([,e])=>Kt(e,c))):M;for(let[e,t]of N.entries())if(t.length>0&&P.has(e))throw Error(t.join(`
+`));let F=Array.from(M.entries()).filter(([,e])=>e.emitsGlobalOptions).map(([e])=>e),I=F.length===1?F[0]:void 0;if(qt(S,d,b),b.size===0&&x.size>0){let e=new Set;for(let t of P.values())if(!(!t.emitsGlobalOptions&&I===void 0))for(let n of t.referencedScopes)e.add(n);qt(e,d,x)}if(b.size>0)for(let e of d.values())e.options=e.options.filter(e=>!b.has(e.name)),e.extracted&&=an(e.extracted,new Set(b.keys()));let L={};for(let[e,t]of Object.entries(w))qe(L,e,t);let ie=e=>e===``?0:e.split(` `).length,R=new Map;for(let[e,t]of M.entries())for(let n of t.headingScopes){if(Object.prototype.hasOwnProperty.call(w,n))continue;let r=-1;for(let e of t.commandTreeRoots)J(n,e)&&(r=Math.max(r,ie(e)));if(r<0)continue;let i=R.get(n);(!i||r>i.rootLen)&&R.set(n,{outputPath:e,rootLen:r})}for(let[e,{outputPath:t}]of R)qe(L,e,t);let z=[],B=!1;for(let[e,t]of Object.entries(f)){let{fileConfig:n,specifiedCommands:o,commandPaths:s}=X(t,d,r);if(o.length===0||s.length===0)continue;let l=y?tn(c,e,f,d,r):[];if(y&&l.length===0)continue;let m=`match`,x=[],S=Math.min(...s.map(e=>d.get(e)?.depth??1)),C=Math.max(1,(i?.headingLevel??1)-(S-1)),w=p&&h&&$(e)===$(h.path),D=p||u,O=W({...i,headingLevel:C,markerless:!D}),j=n.render??O;if(w||y&&D){let t=be(e),i=rt(s,o),c=y?l:s;for(let o of c){let s=nn(o,d,j,e,L,h?.path,b.size>0,r);if(!s)throw Error(`Target command "${o}" not found in commands`);let c=await q(s,a);if(!t){if(g){let r=o===``&&n?it(n):null,i=r?`${r}\n${c}`:c;K(e,i),t=i,m=`created`}else B=!0,m=`diff`,x.push(`File does not exist. Target command "${o}" section cannot be validated.`);continue}let l=lt(t,o);if(l.length===0){g?(t=dt(t,o,c,i),K(e,t),m!==`created`&&(m=`updated`)):(B=!0,m=`diff`,x.push(`Existing file does not contain section markers for command "${o}"`));continue}for(let n of l){let r=Q(t,n,o),i=Q(c,n,o);if(r){if(!i){let i=k(n,o)+`
+`+A(n,o);if(r!==i){if(g){let r=st(t,n,o,i);if(!r)throw Error(`Failed to replace stale ${n} section for command "${o}"`);t=r.replace(/\n{3,}/g,`
+
+`),K(e,t),m!==`created`&&(m=`updated`)}else B=!0,m=`diff`,x.push(G(r,i))}continue}if(r!==i){if(g){let r=st(t,n,o,i);if(r)t=r,K(e,t),m!==`created`&&(m=`updated`);else throw Error(`Failed to replace ${n} section for command "${o}"`)}else B=!0,m=`diff`,x.push(G(r,i))}}}if(_||u){let n=lt(c,o),r=new Set(l);for(let i of n){if(r.has(i))continue;let n=Q(c,i,o);n&&(_&&g?(t=ct(t,i,o,n),K(e,t),m!==`created`&&(m=`updated`)):_?(B=!0,v=!0,m=`diff`,x.push(`[doctor] Missing section marker "${i}" for command "${Z(o)}". Run with ${E}=true ${T}=true to insert.\n${n}`)):console.warn(`[politty] Missing "${i}" section for command "${Z(o)}" in ${e}. Run with ${E}=true ${T}=true to insert it, or leave it removed to opt that section out.`))}}}if(t){let n=ut(t),r=new Set(s);if(g){let i=!1;for(let e of n)r.has(e)||(t=ft(t,e),i=!0);i&&(K(e,t),m!==`created`&&(m=`updated`))}else for(let e of n)r.has(e)||(B=!0,m=`diff`,x.push(`Found orphaned section markers for deleted command "${Z(e)}"`))}}else{let t=await q(on(s,d,j,e,L,o,n,h?.path,b.size>0,r),a),i=ye(t,e);i.match||(g?(K(e,t),m=i.fileExists?`updated`:`created`):(B=!0,m=`diff`,i.diff&&x.push(i.diff)))}x.length>0&&(m=`diff`),z.push({path:e,status:m,diff:x.length>0?x.join(`
+
+`):void 0})}let V;if(h?.globalOptions)V=Lt(h.globalOptions);else{let e=Rt(l);e&&(V={args:e})}for(let[e,n]of j){if(!P.has(e))continue;let o=D.get(e)??null;if(o===null){B=!0,z.push({path:e,status:`diff`,diff:`Template file not found: ${n}`});continue}let s=M.get(e),c=ht(o),l=Re(o),u=(s?.headingScopes??[]).map(e=>d.get(e)?.depth??1),p=u.length>0?Math.min(...u):1,m=vt((i?.headingLevel??1)-(p-1)),_=W({...i,headingLevel:m}),v=s?.emitsGlobalOptions??!1,y=(h!==void 0&&b.size>0||v||I!==void 0)&&x.size>0?new Set(x.keys()):void 0,S=y!==void 0,C=v?e:h?.path??I,w=Array.from(new Set(l.match(Ot)??[])),T=new Map,E=O.get(e)??Ke(new Set);for(let i of w){let a=Ve(i);if(E.rawKeys.has(a)||Dt(a,E)){T.set(i,``);continue}let o=xt(i,d);if(Et(i,o,E)){T.set(i,``);continue}if(o.kind===`invalid`)throw Error(`Internal error: unresolved placeholder "${i}" in template "${n}": ${o.reason}`);if(o.kind===`command`){let{scope:t,type:n}=o;if(n===void 0){let n=rn(t,d,_,r,e,L,C,S,y,E);if(n===null){T.set(i,``);continue}T.set(i,pt(n))}else{let a=nn(t,d,_,e,L,C,S,r,y,E);if(a===null){T.set(i,``);continue}let o=Q(a,n,t);T.set(i,o===null?``:pt(o))}}else if(o.kind===`global-options`)V?T.set(i,Jt(V)):T.set(i,``);else if(o.kind===`index`){let n=await Fe(t,[...Bt(f,e,d,r),...Vt(M,e,e,d)],h?.index);T.set(i,n)}}let k=l.replace(/((?:\r?\n)*)([ \t]*)(\{\{politty:[^{}]*\}\})([ \t]*)((?:\r?\n)*)/g,(e,t,r,i,a,o,s,c)=>{let l=T.get(i);if(l===void 0)throw Error(`Internal error: unresolved placeholder "${i}" in template "${n}".`);let u=t!==``||s===0||c[s-1]===`
+`,d=o!==``||s+e.length===c.length;if(l===``&&u&&d){if(t===``||o===``)return``;let e=gt(t),n=gt(o),r=Math.max(e,n),i=ht(e>=n?t:o);return r>=2?i+i:r===1?i:``}return`${t}${r}${l}${a}${o}`});k=`${k.trimEnd()}${c}`,k=await q(k,a);let A=ye(k,e),j=`match`,N;A.match||(g?(K(e,k),j=A.fileExists?`updated`:`created`):(B=!0,j=`diff`,A.diff&&(N=A.diff))),z.push({path:e,status:j,diff:N})}if(h){let n=h.path,i=`match`,s=[],c=be(n);if(c===null)B=!0,i=`diff`,s.push(`File does not exist. Cannot validate rootDoc markers.`);else{let l=c,u=!1,m=e.rootInfo,_={title:m?.title??t.name};h.headingLevel!==void 0&&(_.headingLevel=h.headingLevel);let v=m?.description??t.description;v!==void 0&&(_.description=v);let y=ot(l,_,g);if(l=y.content,y.diff&&s.push(y.diff),y.hasError&&(B=!0),y.wasUpdated&&(u=!0),m?.header){let e=await Qt(l,`Root header`,ee(),te(),m.header,g,a,p);l=e.content,s.push(...e.diffs),e.hasError&&(B=!0),e.wasUpdated&&(u=!0)}if(!p){let e=ut(l);if(e.length>0){if(g){for(let t of e)l=ft(l,t);u=!0}else B=!0,s.push(`Found unexpected section markers in rootDoc: ${e.map(e=>`"${Z(e)}"`).join(`, `)}.`)}}let b=Lt(h.globalOptions);if(b){let e=await Zt(l,b,g,a,p);l=e.content,s.push(...e.diffs),e.hasError&&(B=!0),e.wasUpdated&&(u=!0)}let x=Bt(f,n,d,r),S=o.relative(process.cwd(),n).replace(/\\/g,`/`),C=await $t(l,x,t,S,g,a,h.index);if(l=C.content,s.push(...C.diffs),C.hasError&&(B=!0),C.wasUpdated&&(u=!0),m?.footer){let e=await Qt(l,`Root footer`,ne(),re(),m.footer,g,a,p);l=e.content,s.push(...e.diffs),e.hasError&&(B=!0),e.wasUpdated&&(u=!0)}g&&u&&(K(n,l),i===`match`&&(i=`updated`))}s.length>0&&(i=`diff`),z.push({path:n,status:i,diff:s.length>0?s.join(`
+
+`):void 0})}return{success:!B,files:z,error:B?`Documentation is out of date. ${v?`Run with ${E}=true ${T}=true to fix missing markers.`:`Run with ${T}=true to update.`}`:void 0}}async function dn(e){let t=await un(e);if(!t.success){let e=t.files.filter(e=>e.status===`diff`).map(e=>{let t=`File: ${e.path}\n`;return e.diff&&(t+=e.diff),t}).join(`
+
+`);throw Error(`Documentation does not match golden files.\n\n${e}\n\n`+(t.error??`Run with POLITTY_DOCS_UPDATE=true to update the documentation.`))}}function fn(e,t){if(Ie(`POLITTY_DOCS_UPDATE`)){if(typeof e==`string`)xe(e,t);else{let n=new Set(Object.values(e.templates??{}).map($));e.rootDoc&&n.add($(e.rootDoc.path));let r=e=>n.has($(e));if(e.files)for(let n of Object.keys(e.files))r(n)||xe(n,t);if(e.templates)for(let n of Object.keys(e.templates))r(n)||xe(n,t)}}}export{E as DOCTOR_ENV,j as GLOBAL_OPTIONS_MARKER_PREFIX,I as INDEX_MARKER_PREFIX,F as ROOT_FOOTER_MARKER_PREFIX,P as ROOT_HEADER_MARKER_PREFIX,O as SECTION_MARKER_PREFIX,D as SECTION_TYPES,T as UPDATE_GOLDEN_ENV,dn as assertDocMatch,Se as buildCommandInfo,Ce as collectAllCommands,ye as compareWithExisting,W as createCommandRenderer,ve as defaultRenderers,we as executeExamples,G as formatDiff,un as generateDoc,N as globalOptionsEndMarker,M as globalOptionsStartMarker,ie as indexEndMarker,L as indexStartMarker,fn as initDocFile,Oe as renderArgsTable,V as renderArgumentsList,pe as renderArgumentsListFromArray,B as renderArgumentsTable,fe as renderArgumentsTableFromArray,Fe as renderCommandIndex,he as renderExamplesDefault,oe as renderOptionsList,U as renderOptionsListFromArray,ae as renderOptionsTable,H as renderOptionsTableFromArray,le as renderSubcommandsTable,me as renderSubcommandsTableFromArray,z as renderUsage,i as resolveLazyCommand,re as rootFooterEndMarker,ne as rootFooterStartMarker,te as rootHeaderEndMarker,ee as rootHeaderStartMarker,A as sectionEndMarker,k as sectionStartMarker,K as writeFile};