@optique/man 1.0.0-dev.921 → 1.0.1

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_man = require('./man-Bah5ZMyV.cjs');
-require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-bugVqGJn.cjs');
+const require_man = require('./man-CkvscTlM.cjs');
+require('./roff-DJ-LkRXl.cjs');
+const require_generator = require('./generator-DXD_dkL9.cjs');
 const __optique_core_constructs = require_man.__toESM(require("@optique/core/constructs"));
 const __optique_core_primitives = require_man.__toESM(require("@optique/core/primitives"));
 const __optique_core_valueparser = require_man.__toESM(require("@optique/core/valueparser"));
@@ -17,7 +17,7 @@ const node_url = require_man.__toESM(require("node:url"));
 
 //#region deno.json
 var name = "@optique/man";
-var version = "1.0.0-dev.921+754748bd";
+var version = "1.0.1";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",
@@ -341,7 +341,7 @@ function isProgram(value) {
 */
 function isParser(value) {
 	try {
-		return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "$mode" in value && "usage" in value && "getDocFragments" in value && typeof value.getDocFragments === "function";
+		return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "mode" in value && "usage" in value && "getDocFragments" in value && typeof value.getDocFragments === "function";
 	} catch {
 		return false;
 	}

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "./roff-CwBRpWCo.js";
-import "./man-BiY491LQ.js";
-import { generateManPageAsync } from "./generator-CnMxnsMc.js";
+import "./roff-CCdIQO7B.js";
+import "./man-BE1OY_lJ.js";
+import { generateManPageAsync } from "./generator-D5cbsYWL.js";
 import { object } from "@optique/core/constructs";
 import { argument, option } from "@optique/core/primitives";
 import { choice, string } from "@optique/core/valueparser";
@@ -17,7 +17,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 //#region deno.json
 var name = "@optique/man";
-var version = "1.0.0-dev.921+754748bd";
+var version = "1.0.1";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",
@@ -341,7 +341,7 @@ function isProgram(value) {
 */
 function isParser(value) {
 	try {
-		return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "$mode" in value && "usage" in value && "getDocFragments" in value && typeof value.getDocFragments === "function";
+		return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "mode" in value && "usage" in value && "getDocFragments" in value && typeof value.getDocFragments === "function";
 	} catch {
 		return false;
 	}

package/dist/{generator-CnMxnsMc.js → generator-D5cbsYWL.js}

@@ -1,4 +1,4 @@
-import { formatDocPageAsMan } from "./man-BiY491LQ.js";
+import { formatDocPageAsMan } from "./man-BE1OY_lJ.js";
 import { getDocPageAsync, getDocPageSync } from "@optique/core/parser";
 
 //#region src/generator.ts
@@ -9,7 +9,7 @@ function isParser(value) {
 	try {
 		if (value == null || typeof value !== "object") return false;
 		const p = value;
-		return "parse" in p && typeof p.parse === "function" && "complete" in p && typeof p.complete === "function" && "$mode" in p && (p.$mode === "sync" || p.$mode === "async") && "usage" in p && Array.isArray(p.usage) && "initialState" in p && "suggest" in p && typeof p.suggest === "function" && "getDocFragments" in p && typeof p.getDocFragments === "function";
+		return "parse" in p && typeof p.parse === "function" && "complete" in p && typeof p.complete === "function" && "mode" in p && (p.mode === "sync" || p.mode === "async") && "usage" in p && Array.isArray(p.usage) && "initialState" in p && "suggest" in p && typeof p.suggest === "function" && "getDocFragments" in p && typeof p.getDocFragments === "function";
 	} catch {
 		return false;
 	}
@@ -50,6 +50,9 @@ function extractParserAndOptions(parserOrProgram, options) {
 				author: programOptions.author ?? metadata.author,
 				bugs: programOptions.bugs ?? metadata.bugs,
 				examples: programOptions.examples ?? metadata.examples,
+				brief: programOptions.brief ?? metadata.brief,
+				description: programOptions.description ?? metadata.description,
+				footer: programOptions.footer ?? metadata.footer,
 				seeAlso: programOptions.seeAlso,
 				environment: programOptions.environment,
 				files: programOptions.files,
@@ -65,6 +68,7 @@ function extractParserAndOptions(parserOrProgram, options) {
 }
 function generateManPageSync(parserOrProgram, options) {
 	const { parser, mergedOptions } = extractParserAndOptions(parserOrProgram, options);
+	if (parser.mode === "async") throw new TypeError("Cannot use an async parser with generateManPageSync(). Use generateManPageAsync() or generateManPage() instead.");
 	const docPage = getDocPageSync(parser) ?? { sections: [] };
 	return formatDocPageAsMan(docPage, mergedOptions);
 }
@@ -75,7 +79,7 @@ async function generateManPageAsync(parserOrProgram, options) {
 }
 function generateManPage(parserOrProgram, options) {
 	const { parser, mergedOptions } = extractParserAndOptions(parserOrProgram, options);
-	if (parser.$mode === "async") return generateManPageAsync(parser, mergedOptions);
+	if (parser.mode === "async") return generateManPageAsync(parser, mergedOptions);
 	return generateManPageSync(parser, mergedOptions);
 }
 

package/dist/{generator-bugVqGJn.cjs → generator-DXD_dkL9.cjs}

@@ -1,4 +1,4 @@
-const require_man = require('./man-Bah5ZMyV.cjs');
+const require_man = require('./man-CkvscTlM.cjs');
 const __optique_core_parser = require_man.__toESM(require("@optique/core/parser"));
 
 //#region src/generator.ts
@@ -9,7 +9,7 @@ function isParser(value) {
 	try {
 		if (value == null || typeof value !== "object") return false;
 		const p = value;
-		return "parse" in p && typeof p.parse === "function" && "complete" in p && typeof p.complete === "function" && "$mode" in p && (p.$mode === "sync" || p.$mode === "async") && "usage" in p && Array.isArray(p.usage) && "initialState" in p && "suggest" in p && typeof p.suggest === "function" && "getDocFragments" in p && typeof p.getDocFragments === "function";
+		return "parse" in p && typeof p.parse === "function" && "complete" in p && typeof p.complete === "function" && "mode" in p && (p.mode === "sync" || p.mode === "async") && "usage" in p && Array.isArray(p.usage) && "initialState" in p && "suggest" in p && typeof p.suggest === "function" && "getDocFragments" in p && typeof p.getDocFragments === "function";
 	} catch {
 		return false;
 	}
@@ -50,6 +50,9 @@ function extractParserAndOptions(parserOrProgram, options) {
 				author: programOptions.author ?? metadata.author,
 				bugs: programOptions.bugs ?? metadata.bugs,
 				examples: programOptions.examples ?? metadata.examples,
+				brief: programOptions.brief ?? metadata.brief,
+				description: programOptions.description ?? metadata.description,
+				footer: programOptions.footer ?? metadata.footer,
 				seeAlso: programOptions.seeAlso,
 				environment: programOptions.environment,
 				files: programOptions.files,
@@ -65,6 +68,7 @@ function extractParserAndOptions(parserOrProgram, options) {
 }
 function generateManPageSync(parserOrProgram, options) {
 	const { parser, mergedOptions } = extractParserAndOptions(parserOrProgram, options);
+	if (parser.mode === "async") throw new TypeError("Cannot use an async parser with generateManPageSync(). Use generateManPageAsync() or generateManPage() instead.");
 	const docPage = (0, __optique_core_parser.getDocPageSync)(parser) ?? { sections: [] };
 	return require_man.formatDocPageAsMan(docPage, mergedOptions);
 }
@@ -75,7 +79,7 @@ async function generateManPageAsync(parserOrProgram, options) {
 }
 function generateManPage(parserOrProgram, options) {
 	const { parser, mergedOptions } = extractParserAndOptions(parserOrProgram, options);
-	if (parser.$mode === "async") return generateManPageAsync(parser, mergedOptions);
+	if (parser.mode === "async") return generateManPageAsync(parser, mergedOptions);
 	return generateManPageSync(parser, mergedOptions);
 }
 

package/dist/index.cjs

@@ -1,6 +1,6 @@
-const require_man = require('./man-Bah5ZMyV.cjs');
-const require_roff = require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-bugVqGJn.cjs');
+const require_man = require('./man-CkvscTlM.cjs');
+const require_roff = require('./roff-DJ-LkRXl.cjs');
+const require_generator = require('./generator-DXD_dkL9.cjs');
 
 exports.escapeHyphens = require_roff.escapeHyphens;
 exports.escapeQuotedValue = require_roff.escapeQuotedValue;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-C_87xXP6.cjs";
-import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Dp4oW-al.cjs";
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-COeDIWWF.cjs";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-DKwa47XV.cjs";
 import { Mode, ModeValue, Parser } from "@optique/core/parser";
 import { Program } from "@optique/core/program";
 
@@ -14,10 +14,10 @@ interface GenerateManPageOptions extends ManPageOptions {}
 /**
  * Options for generating a man page from a {@link Program}.
  *
- * This interface omits `name`, `version`, `author`, `bugs`, and `examples`
- * from {@link ManPageOptions} since they are extracted from the program's
- * metadata. You can still override them by providing values in this options
- * object.
+ * For Program inputs, `name`, `version`, `author`, `bugs`, `examples`,
+ * `brief`, `description`, and `footer` default to values from
+ * `program.metadata`.
+ * These fields are optional here and may be provided to override metadata.
  *
  * @since 0.10.0
  */
@@ -159,4 +159,4 @@ declare function generateManPage(parser: Parser<"sync", unknown, unknown>, optio
 declare function generateManPage(parser: Parser<"async", unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
 declare function generateManPage<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): ModeValue<M, string>;
 //#endregion
-export { type GenerateManPageOptions, type GenerateManPageProgramOptions, type ManPageOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };
+export { type GenerateManPageOptions, type GenerateManPageProgramOptions, type ManPageOptions, type RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-DlmeL3KB.js";
-import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CGBnZvZF.js";
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CgYQDHBN.js";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-B1Q2mhit.js";
 import { Program } from "@optique/core/program";
 import { Mode, ModeValue, Parser } from "@optique/core/parser";
 
@@ -14,10 +14,10 @@ interface GenerateManPageOptions extends ManPageOptions {}
 /**
  * Options for generating a man page from a {@link Program}.
  *
- * This interface omits `name`, `version`, `author`, `bugs`, and `examples`
- * from {@link ManPageOptions} since they are extracted from the program's
- * metadata. You can still override them by providing values in this options
- * object.
+ * For Program inputs, `name`, `version`, `author`, `bugs`, `examples`,
+ * `brief`, `description`, and `footer` default to values from
+ * `program.metadata`.
+ * These fields are optional here and may be provided to override metadata.
  *
  * @since 0.10.0
  */
@@ -159,4 +159,4 @@ declare function generateManPage(parser: Parser<"sync", unknown, unknown>, optio
 declare function generateManPage(parser: Parser<"async", unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
 declare function generateManPage<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): ModeValue<M, string>;
 //#endregion
-export { type GenerateManPageOptions, type GenerateManPageProgramOptions, type ManPageOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };
+export { type GenerateManPageOptions, type GenerateManPageProgramOptions, type ManPageOptions, type RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CwBRpWCo.js";
-import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-BiY491LQ.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-CnMxnsMc.js";
+import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CCdIQO7B.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-BE1OY_lJ.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-D5cbsYWL.js";
 
 export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/{man-CGBnZvZF.d.ts → man-B1Q2mhit.d.ts}

@@ -78,6 +78,24 @@ interface ManPageOptions {
    * Exit status codes to document in the EXIT STATUS section.
    */
   readonly exitStatus?: DocSection;
+  /**
+   * A brief description of the program for the NAME section.
+   * Overrides the brief from the {@link DocPage} if both are present.
+   * @since 1.0.0
+   */
+  readonly brief?: Message;
+  /**
+   * A detailed description of the program for the DESCRIPTION section.
+   * Overrides the description from the {@link DocPage} if both are present.
+   * @since 1.0.0
+   */
+  readonly description?: Message;
+  /**
+   * Footer text appended at the end of the man page.
+   * Overrides the footer from the {@link DocPage} if both are present.
+   * @since 1.0.0
+   */
+  readonly footer?: Message;
 }
 /**
  * Formats a date for use in man pages.
@@ -90,6 +108,7 @@ interface ManPageOptions {
  *
  * @param date The date to format, or undefined.
  * @returns The formatted date string, or undefined.
+ * @throws {RangeError} If the given `Date` object is invalid.
  * @since 0.10.0
  */
 declare function formatDateForMan(date: string | Date | undefined): string | undefined;

package/dist/{man-BiY491LQ.js → man-BE1OY_lJ.js}

@@ -1,4 +1,4 @@
-import { escapeHyphens, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CwBRpWCo.js";
+import { escapeHyphens, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CCdIQO7B.js";
 import { isDocHidden, isUsageHidden } from "@optique/core/usage";
 
 //#region src/man.ts
@@ -13,11 +13,13 @@ import { isDocHidden, isUsageHidden } from "@optique/core/usage";
 *
 * @param date The date to format, or undefined.
 * @returns The formatted date string, or undefined.
+* @throws {RangeError} If the given `Date` object is invalid.
 * @since 0.10.0
 */
 function formatDateForMan(date) {
 	if (date === void 0) return void 0;
 	if (typeof date === "string") return date;
+	if (Number.isNaN(date.getTime())) throw new RangeError("Invalid Date object.");
 	const months = [
 		"January",
 		"February",
@@ -46,28 +48,61 @@ function formatCommandNameAsRoff(name) {
 * @since 0.10.0
 */
 function formatUsageTermAsRoff(term) {
+	return formatUsageTermAsRoffInternal(term, false);
+}
+/**
+* Returns whether a usage list contains exactly one visible term that
+* produces its own brackets.  When true, a parent wrapper can safely elide
+* its own brackets to avoid redundant nesting.  Multiple bracket-producing
+* siblings must keep their individual brackets for disambiguation.
+*/
+function hasSingleBracketedTerm(terms) {
+	const visible = terms.filter((t$1) => !("hidden" in t$1 && isUsageHidden(t$1.hidden)));
+	if (visible.length !== 1) return false;
+	const t = visible[0];
+	return t.type === "option" || t.type === "optional" || t.type === "multiple" && t.min < 1 || t.type === "passthrough";
+}
+/**
+* Returns whether a usage list's single visible term has the given type.
+*/
+function hasSingleVisibleTermOfType(terms, type) {
+	const visible = terms.filter((t) => !("hidden" in t && isUsageHidden(t.hidden)));
+	return visible.length === 1 && visible[0].type === type;
+}
+function formatUsageTermAsRoffInternal(term, insideBrackets) {
 	if ("hidden" in term && isUsageHidden(term.hidden)) return "";
 	switch (term.type) {
 		case "argument": return `\\fI${escapeRoff(term.metavar)}\\fR`;
 		case "option": {
 			const names = term.names.map((name) => `\\fB${escapeHyphens(name)}\\fR`).join(" | ");
 			const metavarPart = term.metavar ? ` \\fI${escapeRoff(term.metavar)}\\fR` : "";
+			if (insideBrackets) return `${names}${metavarPart}`;
 			return `[${names}${metavarPart}]`;
 		}
 		case "command": return formatCommandNameAsRoff(term.name);
 		case "optional": {
-			const inner = formatUsageAsRoff(term.terms);
+			const childrenBracketed = hasSingleBracketedTerm(term.terms);
+			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const inner = formatUsageAsRoffInternal(term.terms, childrenBracketed);
 			if (inner === "") return "";
+			if (insideBrackets && childrenBracketed && !childIsMultiple) return inner;
 			return `[${inner}]`;
 		}
 		case "multiple": {
-			const inner = formatUsageAsRoff(term.terms);
+			const wrapInBrackets = term.min < 1;
+			const childrenBracketed = hasSingleBracketedTerm(term.terms);
+			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const passInsideBrackets = wrapInBrackets && childrenBracketed && !childIsMultiple;
+			const inner = formatUsageAsRoffInternal(term.terms, passInsideBrackets);
 			if (inner === "") return "";
-			if (term.min < 1) return `[${inner} ...]`;
+			if (wrapInBrackets) {
+				if (insideBrackets && passInsideBrackets) return `${inner} ...`;
+				return `[${inner} ...]`;
+			}
 			return `${inner} ...`;
 		}
 		case "exclusive": {
-			const alternatives = term.terms.map((t) => formatUsageAsRoff(t)).filter((s) => s !== "");
+			const alternatives = term.terms.map((t) => formatUsageAsRoffInternal(t, false)).filter((s) => s !== "");
 			if (alternatives.length === 0) return "";
 			if (alternatives.length === 1) return alternatives[0];
 			return `(${alternatives.join(" | ")})`;
@@ -88,7 +123,10 @@ function formatUsageTermAsRoff(term) {
 * @returns The roff-formatted string.
 */
 function formatUsageAsRoff(usage) {
-	return usage.map(formatUsageTermAsRoff).filter((s) => s !== "").join(" ");
+	return formatUsageAsRoffInternal(usage, false);
+}
+function formatUsageAsRoffInternal(usage, insideBrackets) {
+	return usage.map((term) => formatUsageTermAsRoffInternal(term, insideBrackets)).filter((s) => s !== "").join(" ");
 }
 /**
 * Formats a {@link DocEntry}'s term for man page output.
@@ -160,6 +198,26 @@ function formatDocUsageAsRoff(usage) {
 	return usage.map(formatDocUsageTermAsRoff).filter((s) => s !== "").join(" ");
 }
 /**
+* Infers the section title from entry kinds when no explicit title is given.
+* Returns `"COMMANDS"` for command-only sections, `"ARGUMENTS"` for
+* argument-only sections, and `"OPTIONS"` otherwise.
+*
+* @param entries The entries in the section.
+* @returns The inferred section title in uppercase.
+*/
+function inferSectionTitle(entries) {
+	const kinds = /* @__PURE__ */ new Set();
+	for (const entry of entries) {
+		if ("hidden" in entry.term && isDocHidden(entry.term.hidden)) continue;
+		kinds.add(entry.term.type);
+	}
+	if (kinds.size === 1) {
+		if (kinds.has("command")) return "COMMANDS";
+		if (kinds.has("argument")) return "ARGUMENTS";
+	}
+	return "OPTIONS";
+}
+/**
 * Formats a {@link DocSection} as roff markup with .TP macros.
 *
 * @param section The section to format.
@@ -175,8 +233,14 @@ function formatDocSectionEntries(section) {
 		if (entry.description) {
 			let desc = formatMessageAsRoff(entry.description);
 			if (entry.default) desc += ` [${formatMessageAsRoff(entry.default)}]`;
+			if (entry.choices) desc += ` (choices: ${formatMessageAsRoff(entry.choices, { quotes: false })})`;
 			lines.push(desc);
-		} else if (entry.default) lines.push(`[${formatMessageAsRoff(entry.default)}]`);
+		} else if (entry.default || entry.choices) {
+			const parts = [];
+			if (entry.default) parts.push(`[${formatMessageAsRoff(entry.default)}]`);
+			if (entry.choices) parts.push(`(choices: ${formatMessageAsRoff(entry.choices, { quotes: false })})`);
+			lines.push(parts.join(" "));
+		}
 	}
 	return lines.join("\n");
 }
@@ -235,7 +299,8 @@ function formatDocPageAsMan(page, options) {
 	if (hasManual) thParts.push(`"${escapeRequestArg(options.manual)}"`);
 	lines.push(`.TH ${thParts.join(" ")}`);
 	lines.push(".SH NAME");
-	if (page.brief) lines.push(`${escapeHyphens(escapeRoff(options.name))} \\- ${formatMessageAsRoff(page.brief)}`);
+	const brief = options.brief ?? page.brief;
+	if (brief) lines.push(`${escapeHyphens(escapeRoff(options.name))} \\- ${formatMessageAsRoff(brief)}`);
 	else lines.push(escapeHyphens(escapeRoff(options.name)));
 	if (page.usage) {
 		lines.push(".SH SYNOPSIS");
@@ -243,15 +308,16 @@ function formatDocPageAsMan(page, options) {
 		const usageStr = formatUsageAsRoff(page.usage);
 		if (usageStr) lines.push(usageStr);
 	}
-	if (page.description) {
+	const description = options.description ?? page.description;
+	if (description) {
 		lines.push(".SH DESCRIPTION");
-		lines.push(formatMessageAsRoff(page.description));
+		lines.push(formatMessageAsRoff(description));
 	}
 	for (const section of page.sections) {
 		if (section.entries.length === 0) continue;
 		const content = formatDocSectionEntries(section);
 		if (content === "") continue;
-		const title = section.title?.toUpperCase() ?? "OPTIONS";
+		const title = section.title?.toUpperCase() ?? inferSectionTitle(section.entries);
 		lines.push(`.SH "${escapeRequestArg(title)}"`);
 		lines.push(content);
 	}
@@ -276,13 +342,15 @@ function formatDocPageAsMan(page, options) {
 			lines.push(content);
 		}
 	}
-	if (options.examples) {
+	const examples = options.examples ?? page.examples;
+	if (examples) {
 		lines.push(".SH EXAMPLES");
-		lines.push(formatMessageAsRoff(options.examples));
+		lines.push(formatMessageAsRoff(examples));
 	}
-	if (options.bugs) {
+	const bugs = options.bugs ?? page.bugs;
+	if (bugs) {
 		lines.push(".SH BUGS");
-		lines.push(formatMessageAsRoff(options.bugs));
+		lines.push(formatMessageAsRoff(bugs));
 	}
 	if (options.seeAlso && options.seeAlso.length > 0) {
 		for (const ref of options.seeAlso) if (!Number.isInteger(ref.section) || ref.section < 1 || ref.section > 8) {
@@ -301,13 +369,15 @@ function formatDocPageAsMan(page, options) {
 		});
 		lines.push(refs.join("\n"));
 	}
-	if (options.author) {
+	const author = options.author ?? page.author;
+	if (author) {
 		lines.push(".SH AUTHOR");
-		lines.push(formatMessageAsRoff(options.author));
+		lines.push(formatMessageAsRoff(author));
 	}
-	if (page.footer) {
+	const footer = options.footer ?? page.footer;
+	if (footer) {
 		lines.push(".PP");
-		lines.push(formatMessageAsRoff(page.footer));
+		lines.push(formatMessageAsRoff(footer));
 	}
 	return lines.join("\n");
 }

package/dist/{man-Bah5ZMyV.cjs → man-CkvscTlM.cjs}

@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_roff = require('./roff-Cl0vekdg.cjs');
+const require_roff = require('./roff-DJ-LkRXl.cjs');
 const __optique_core_usage = __toESM(require("@optique/core/usage"));
 
 //#region src/man.ts
@@ -36,11 +36,13 @@ const __optique_core_usage = __toESM(require("@optique/core/usage"));
 *
 * @param date The date to format, or undefined.
 * @returns The formatted date string, or undefined.
+* @throws {RangeError} If the given `Date` object is invalid.
 * @since 0.10.0
 */
 function formatDateForMan(date) {
 	if (date === void 0) return void 0;
 	if (typeof date === "string") return date;
+	if (Number.isNaN(date.getTime())) throw new RangeError("Invalid Date object.");
 	const months = [
 		"January",
 		"February",
@@ -69,28 +71,61 @@ function formatCommandNameAsRoff(name) {
 * @since 0.10.0
 */
 function formatUsageTermAsRoff(term) {
+	return formatUsageTermAsRoffInternal(term, false);
+}
+/**
+* Returns whether a usage list contains exactly one visible term that
+* produces its own brackets.  When true, a parent wrapper can safely elide
+* its own brackets to avoid redundant nesting.  Multiple bracket-producing
+* siblings must keep their individual brackets for disambiguation.
+*/
+function hasSingleBracketedTerm(terms) {
+	const visible = terms.filter((t$1) => !("hidden" in t$1 && (0, __optique_core_usage.isUsageHidden)(t$1.hidden)));
+	if (visible.length !== 1) return false;
+	const t = visible[0];
+	return t.type === "option" || t.type === "optional" || t.type === "multiple" && t.min < 1 || t.type === "passthrough";
+}
+/**
+* Returns whether a usage list's single visible term has the given type.
+*/
+function hasSingleVisibleTermOfType(terms, type) {
+	const visible = terms.filter((t) => !("hidden" in t && (0, __optique_core_usage.isUsageHidden)(t.hidden)));
+	return visible.length === 1 && visible[0].type === type;
+}
+function formatUsageTermAsRoffInternal(term, insideBrackets) {
 	if ("hidden" in term && (0, __optique_core_usage.isUsageHidden)(term.hidden)) return "";
 	switch (term.type) {
 		case "argument": return `\\fI${require_roff.escapeRoff(term.metavar)}\\fR`;
 		case "option": {
 			const names = term.names.map((name) => `\\fB${require_roff.escapeHyphens(name)}\\fR`).join(" | ");
 			const metavarPart = term.metavar ? ` \\fI${require_roff.escapeRoff(term.metavar)}\\fR` : "";
+			if (insideBrackets) return `${names}${metavarPart}`;
 			return `[${names}${metavarPart}]`;
 		}
 		case "command": return formatCommandNameAsRoff(term.name);
 		case "optional": {
-			const inner = formatUsageAsRoff(term.terms);
+			const childrenBracketed = hasSingleBracketedTerm(term.terms);
+			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const inner = formatUsageAsRoffInternal(term.terms, childrenBracketed);
 			if (inner === "") return "";
+			if (insideBrackets && childrenBracketed && !childIsMultiple) return inner;
 			return `[${inner}]`;
 		}
 		case "multiple": {
-			const inner = formatUsageAsRoff(term.terms);
+			const wrapInBrackets = term.min < 1;
+			const childrenBracketed = hasSingleBracketedTerm(term.terms);
+			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const passInsideBrackets = wrapInBrackets && childrenBracketed && !childIsMultiple;
+			const inner = formatUsageAsRoffInternal(term.terms, passInsideBrackets);
 			if (inner === "") return "";
-			if (term.min < 1) return `[${inner} ...]`;
+			if (wrapInBrackets) {
+				if (insideBrackets && passInsideBrackets) return `${inner} ...`;
+				return `[${inner} ...]`;
+			}
 			return `${inner} ...`;
 		}
 		case "exclusive": {
-			const alternatives = term.terms.map((t) => formatUsageAsRoff(t)).filter((s) => s !== "");
+			const alternatives = term.terms.map((t) => formatUsageAsRoffInternal(t, false)).filter((s) => s !== "");
 			if (alternatives.length === 0) return "";
 			if (alternatives.length === 1) return alternatives[0];
 			return `(${alternatives.join(" | ")})`;
@@ -111,7 +146,10 @@ function formatUsageTermAsRoff(term) {
 * @returns The roff-formatted string.
 */
 function formatUsageAsRoff(usage) {
-	return usage.map(formatUsageTermAsRoff).filter((s) => s !== "").join(" ");
+	return formatUsageAsRoffInternal(usage, false);
+}
+function formatUsageAsRoffInternal(usage, insideBrackets) {
+	return usage.map((term) => formatUsageTermAsRoffInternal(term, insideBrackets)).filter((s) => s !== "").join(" ");
 }
 /**
 * Formats a {@link DocEntry}'s term for man page output.
@@ -183,6 +221,26 @@ function formatDocUsageAsRoff(usage) {
 	return usage.map(formatDocUsageTermAsRoff).filter((s) => s !== "").join(" ");
 }
 /**
+* Infers the section title from entry kinds when no explicit title is given.
+* Returns `"COMMANDS"` for command-only sections, `"ARGUMENTS"` for
+* argument-only sections, and `"OPTIONS"` otherwise.
+*
+* @param entries The entries in the section.
+* @returns The inferred section title in uppercase.
+*/
+function inferSectionTitle(entries) {
+	const kinds = /* @__PURE__ */ new Set();
+	for (const entry of entries) {
+		if ("hidden" in entry.term && (0, __optique_core_usage.isDocHidden)(entry.term.hidden)) continue;
+		kinds.add(entry.term.type);
+	}
+	if (kinds.size === 1) {
+		if (kinds.has("command")) return "COMMANDS";
+		if (kinds.has("argument")) return "ARGUMENTS";
+	}
+	return "OPTIONS";
+}
+/**
 * Formats a {@link DocSection} as roff markup with .TP macros.
 *
 * @param section The section to format.
@@ -198,8 +256,14 @@ function formatDocSectionEntries(section) {
 		if (entry.description) {
 			let desc = require_roff.formatMessageAsRoff(entry.description);
 			if (entry.default) desc += ` [${require_roff.formatMessageAsRoff(entry.default)}]`;
+			if (entry.choices) desc += ` (choices: ${require_roff.formatMessageAsRoff(entry.choices, { quotes: false })})`;
 			lines.push(desc);
-		} else if (entry.default) lines.push(`[${require_roff.formatMessageAsRoff(entry.default)}]`);
+		} else if (entry.default || entry.choices) {
+			const parts = [];
+			if (entry.default) parts.push(`[${require_roff.formatMessageAsRoff(entry.default)}]`);
+			if (entry.choices) parts.push(`(choices: ${require_roff.formatMessageAsRoff(entry.choices, { quotes: false })})`);
+			lines.push(parts.join(" "));
+		}
 	}
 	return lines.join("\n");
 }
@@ -258,7 +322,8 @@ function formatDocPageAsMan(page, options) {
 	if (hasManual) thParts.push(`"${require_roff.escapeRequestArg(options.manual)}"`);
 	lines.push(`.TH ${thParts.join(" ")}`);
 	lines.push(".SH NAME");
-	if (page.brief) lines.push(`${require_roff.escapeHyphens(require_roff.escapeRoff(options.name))} \\- ${require_roff.formatMessageAsRoff(page.brief)}`);
+	const brief = options.brief ?? page.brief;
+	if (brief) lines.push(`${require_roff.escapeHyphens(require_roff.escapeRoff(options.name))} \\- ${require_roff.formatMessageAsRoff(brief)}`);
 	else lines.push(require_roff.escapeHyphens(require_roff.escapeRoff(options.name)));
 	if (page.usage) {
 		lines.push(".SH SYNOPSIS");
@@ -266,15 +331,16 @@ function formatDocPageAsMan(page, options) {
 		const usageStr = formatUsageAsRoff(page.usage);
 		if (usageStr) lines.push(usageStr);
 	}
-	if (page.description) {
+	const description = options.description ?? page.description;
+	if (description) {
 		lines.push(".SH DESCRIPTION");
-		lines.push(require_roff.formatMessageAsRoff(page.description));
+		lines.push(require_roff.formatMessageAsRoff(description));
 	}
 	for (const section of page.sections) {
 		if (section.entries.length === 0) continue;
 		const content = formatDocSectionEntries(section);
 		if (content === "") continue;
-		const title = section.title?.toUpperCase() ?? "OPTIONS";
+		const title = section.title?.toUpperCase() ?? inferSectionTitle(section.entries);
 		lines.push(`.SH "${require_roff.escapeRequestArg(title)}"`);
 		lines.push(content);
 	}
@@ -299,13 +365,15 @@ function formatDocPageAsMan(page, options) {
 			lines.push(content);
 		}
 	}
-	if (options.examples) {
+	const examples = options.examples ?? page.examples;
+	if (examples) {
 		lines.push(".SH EXAMPLES");
-		lines.push(require_roff.formatMessageAsRoff(options.examples));
+		lines.push(require_roff.formatMessageAsRoff(examples));
 	}
-	if (options.bugs) {
+	const bugs = options.bugs ?? page.bugs;
+	if (bugs) {
 		lines.push(".SH BUGS");
-		lines.push(require_roff.formatMessageAsRoff(options.bugs));
+		lines.push(require_roff.formatMessageAsRoff(bugs));
 	}
 	if (options.seeAlso && options.seeAlso.length > 0) {
 		for (const ref of options.seeAlso) if (!Number.isInteger(ref.section) || ref.section < 1 || ref.section > 8) {
@@ -324,13 +392,15 @@ function formatDocPageAsMan(page, options) {
 		});
 		lines.push(refs.join("\n"));
 	}
-	if (options.author) {
+	const author = options.author ?? page.author;
+	if (author) {
 		lines.push(".SH AUTHOR");
-		lines.push(require_roff.formatMessageAsRoff(options.author));
+		lines.push(require_roff.formatMessageAsRoff(author));
 	}
-	if (page.footer) {
+	const footer = options.footer ?? page.footer;
+	if (footer) {
 		lines.push(".PP");
-		lines.push(require_roff.formatMessageAsRoff(page.footer));
+		lines.push(require_roff.formatMessageAsRoff(footer));
 	}
 	return lines.join("\n");
 }

package/dist/{man-Dp4oW-al.d.cts → man-DKwa47XV.d.cts}

@@ -78,6 +78,24 @@ interface ManPageOptions {
    * Exit status codes to document in the EXIT STATUS section.
    */
   readonly exitStatus?: DocSection;
+  /**
+   * A brief description of the program for the NAME section.
+   * Overrides the brief from the {@link DocPage} if both are present.
+   * @since 1.0.0
+   */
+  readonly brief?: Message;
+  /**
+   * A detailed description of the program for the DESCRIPTION section.
+   * Overrides the description from the {@link DocPage} if both are present.
+   * @since 1.0.0
+   */
+  readonly description?: Message;
+  /**
+   * Footer text appended at the end of the man page.
+   * Overrides the footer from the {@link DocPage} if both are present.
+   * @since 1.0.0
+   */
+  readonly footer?: Message;
 }
 /**
  * Formats a date for use in man pages.
@@ -90,6 +108,7 @@ interface ManPageOptions {
  *
  * @param date The date to format, or undefined.
  * @returns The formatted date string, or undefined.
+ * @throws {RangeError} If the given `Date` object is invalid.
  * @since 0.10.0
  */
 declare function formatDateForMan(date: string | Date | undefined): string | undefined;

package/dist/man.cjs

@@ -1,5 +1,5 @@
-const require_man = require('./man-Bah5ZMyV.cjs');
-require('./roff-Cl0vekdg.cjs');
+const require_man = require('./man-CkvscTlM.cjs');
+require('./roff-DJ-LkRXl.cjs');
 
 exports.formatDateForMan = require_man.formatDateForMan;
 exports.formatDocPageAsMan = require_man.formatDocPageAsMan;

package/dist/man.d.cts

@@ -1,2 +1,2 @@
-import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Dp4oW-al.cjs";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-DKwa47XV.cjs";
 export { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/dist/man.d.ts

@@ -1,2 +1,2 @@
-import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CGBnZvZF.js";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-B1Q2mhit.js";
 export { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/dist/man.js

@@ -1,4 +1,4 @@
-import "./roff-CwBRpWCo.js";
-import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-BiY491LQ.js";
+import "./roff-CCdIQO7B.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-BE1OY_lJ.js";
 
 export { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/dist/{roff-CwBRpWCo.js → roff-CCdIQO7B.js}

@@ -96,17 +96,21 @@ function escapeHyphens(text) {
 * is done in formatMessageAsRoff after all terms are joined.
 *
 * @param term The message term to format.
+* @param options Optional formatting options.
 * @returns The roff-formatted string.
 */
-function formatTermAsRoff(term) {
+function formatTermAsRoff(term, options) {
 	switch (term.type) {
 		case "text": return escapeBackslashes(term.text);
 		case "optionName": return `\\fB${escapeHyphens(term.optionName)}\\fR`;
 		case "optionNames": return term.optionNames.map((name) => `\\fB${escapeHyphens(name)}\\fR`).join(", ");
 		case "metavar": return `\\fI${escapeBackslashes(term.metavar)}\\fR`;
-		case "value": return `"${escapeQuotedValue(term.value)}"`;
+		case "value":
+			if (options?.quotes === false) return escapeBackslashes(term.value);
+			return `"${escapeQuotedValue(term.value)}"`;
 		case "values":
 			if (term.values.length === 0) return "";
+			if (options?.quotes === false) return term.values.map((v) => escapeBackslashes(v)).join(" ");
 			return term.values.map((v) => `"${escapeQuotedValue(v)}"`).join(" ");
 		case "envVar": return `\\fB${escapeBackslashes(term.envVar)}\\fR`;
 		case "commandLine": return `\\fB${escapeHyphens(escapeBackslashes(term.commandLine))}\\fR`;
@@ -148,11 +152,12 @@ function formatTermAsRoff(term) {
 * ```
 *
 * @param msg The message to format.
+* @param options Optional formatting options.
 * @returns The roff-formatted string.
 * @since 0.10.0
 */
-function formatMessageAsRoff(msg) {
-	const joined = msg.map(formatTermAsRoff).join("");
+function formatMessageAsRoff(msg, options) {
+	const joined = msg.map((t) => formatTermAsRoff(t, options)).join("");
 	const escaped = escapeLineStarts(joined);
 	return escaped.replace(/\n\n+/g, "\n.PP\n");
 }

package/dist/{roff-C_87xXP6.d.cts → roff-COeDIWWF.d.cts}

@@ -2,6 +2,20 @@ import { Message } from "@optique/core/message";
 
 //#region src/roff.d.ts
 
+/**
+ * Options for roff formatting of messages.
+ *
+ * @since 1.0.0
+ */
+interface RoffFormatOptions {
+  /**
+   * Whether to wrap `value` and `values` terms in double quotes.
+   * Defaults to `true`.
+   *
+   * @since 1.0.0
+   */
+  readonly quotes?: boolean;
+}
 /**
  * Escapes special roff characters in plain text.
  *
@@ -89,9 +103,10 @@ declare function escapeHyphens(text: string): string;
  * ```
  *
  * @param msg The message to format.
+ * @param options Optional formatting options.
  * @returns The roff-formatted string.
  * @since 0.10.0
  */
-declare function formatMessageAsRoff(msg: Message): string;
+declare function formatMessageAsRoff(msg: Message, options?: RoffFormatOptions): string;
 //#endregion
-export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };
+export { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/dist/{roff-DlmeL3KB.d.ts → roff-CgYQDHBN.d.ts}

@@ -2,6 +2,20 @@ import { Message } from "@optique/core/message";
 
 //#region src/roff.d.ts
 
+/**
+ * Options for roff formatting of messages.
+ *
+ * @since 1.0.0
+ */
+interface RoffFormatOptions {
+  /**
+   * Whether to wrap `value` and `values` terms in double quotes.
+   * Defaults to `true`.
+   *
+   * @since 1.0.0
+   */
+  readonly quotes?: boolean;
+}
 /**
  * Escapes special roff characters in plain text.
  *
@@ -89,9 +103,10 @@ declare function escapeHyphens(text: string): string;
  * ```
  *
  * @param msg The message to format.
+ * @param options Optional formatting options.
  * @returns The roff-formatted string.
  * @since 0.10.0
  */
-declare function formatMessageAsRoff(msg: Message): string;
+declare function formatMessageAsRoff(msg: Message, options?: RoffFormatOptions): string;
 //#endregion
-export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };
+export { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/dist/{roff-Cl0vekdg.cjs → roff-DJ-LkRXl.cjs}

@@ -97,17 +97,21 @@ function escapeHyphens(text) {
 * is done in formatMessageAsRoff after all terms are joined.
 *
 * @param term The message term to format.
+* @param options Optional formatting options.
 * @returns The roff-formatted string.
 */
-function formatTermAsRoff(term) {
+function formatTermAsRoff(term, options) {
 	switch (term.type) {
 		case "text": return escapeBackslashes(term.text);
 		case "optionName": return `\\fB${escapeHyphens(term.optionName)}\\fR`;
 		case "optionNames": return term.optionNames.map((name) => `\\fB${escapeHyphens(name)}\\fR`).join(", ");
 		case "metavar": return `\\fI${escapeBackslashes(term.metavar)}\\fR`;
-		case "value": return `"${escapeQuotedValue(term.value)}"`;
+		case "value":
+			if (options?.quotes === false) return escapeBackslashes(term.value);
+			return `"${escapeQuotedValue(term.value)}"`;
 		case "values":
 			if (term.values.length === 0) return "";
+			if (options?.quotes === false) return term.values.map((v) => escapeBackslashes(v)).join(" ");
 			return term.values.map((v) => `"${escapeQuotedValue(v)}"`).join(" ");
 		case "envVar": return `\\fB${escapeBackslashes(term.envVar)}\\fR`;
 		case "commandLine": return `\\fB${escapeHyphens(escapeBackslashes(term.commandLine))}\\fR`;
@@ -149,11 +153,12 @@ function formatTermAsRoff(term) {
 * ```
 *
 * @param msg The message to format.
+* @param options Optional formatting options.
 * @returns The roff-formatted string.
 * @since 0.10.0
 */
-function formatMessageAsRoff(msg) {
-	const joined = msg.map(formatTermAsRoff).join("");
+function formatMessageAsRoff(msg, options) {
+	const joined = msg.map((t) => formatTermAsRoff(t, options)).join("");
 	const escaped = escapeLineStarts(joined);
 	return escaped.replace(/\n\n+/g, "\n.PP\n");
 }

package/dist/roff.cjs

@@ -1,4 +1,4 @@
-const require_roff = require('./roff-Cl0vekdg.cjs');
+const require_roff = require('./roff-DJ-LkRXl.cjs');
 
 exports.escapeHyphens = require_roff.escapeHyphens;
 exports.escapeQuotedValue = require_roff.escapeQuotedValue;

package/dist/roff.d.cts

@@ -1,2 +1,2 @@
-import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-C_87xXP6.cjs";
-export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-COeDIWWF.cjs";
+export { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/dist/roff.d.ts

@@ -1,2 +1,2 @@
-import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-DlmeL3KB.js";
-export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CgYQDHBN.js";
+export { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/dist/roff.js

@@ -1,3 +1,3 @@
-import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CwBRpWCo.js";
+import { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-CCdIQO7B.js";
 
 export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/man",
-  "version": "1.0.0-dev.921+754748bd",
+  "version": "1.0.1",
   "description": "Man page generator for Optique CLI parsers",
   "keywords": [
     "CLI",
@@ -84,8 +84,8 @@
     "optique-man": "./dist/cli.js"
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.921+754748bd",
-    "@optique/run": "1.0.0-dev.921+754748bd"
+    "@optique/run": "1.0.1",
+    "@optique/core": "1.0.1"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",