@optique/man 1.3.2 → 1.3.3

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_man = require('./man-C44Q4VSc.cjs');
+const require_man = require('./man-BRIf09IL.cjs');
 require('./roff-C8MvQ2tL.cjs');
-const require_generator = require('./generator-CtkCu_MS.cjs');
+const require_generator = require('./generator-Cx-FBKsf.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.3.2";
+var version = "1.3.3";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import "./roff-Bh9bsH6u.js";
-import "./man-Cq0qfXg0.js";
-import { generateManPageAsync } from "./generator-DywTJCMH.js";
+import "./man-hrFQUZQw.js";
+import { generateManPageAsync } from "./generator-r2ZeAR1V.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.3.2";
+var version = "1.3.3";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

package/dist/{generator-MbR1I1SH.d.ts → generator-B6ZmkvAw.d.ts}

@@ -1,4 +1,4 @@
-import { ManPageOptions } from "./man-CHYiSoI_.js";
+import { ManPageOptions } from "./man-Ciuegxoi.js";
 import { Program } from "@optique/core/program";
 import { Mode, ModeValue, Parser } from "@optique/core/parser";
 

package/dist/{generator-I9cXlw1Z.d.cts → generator-CZaQyGmU.d.cts}

@@ -1,4 +1,4 @@
-import { ManPageOptions } from "./man-C3FUTPuQ.cjs";
+import { ManPageOptions } from "./man-BQpizqcO.cjs";
 import { Mode, ModeValue, Parser } from "@optique/core/parser";
 import { Program } from "@optique/core/program";
 

package/dist/{generator-CtkCu_MS.cjs → generator-Cx-FBKsf.cjs}

@@ -1,4 +1,4 @@
-const require_man = require('./man-C44Q4VSc.cjs');
+const require_man = require('./man-BRIf09IL.cjs');
 const __optique_core_parser = require_man.__toESM(require("@optique/core/parser"));
 
 //#region src/generator.ts

package/dist/{generator-DywTJCMH.js → generator-r2ZeAR1V.js}

@@ -1,4 +1,4 @@
-import { formatDocPageAsMan } from "./man-Cq0qfXg0.js";
+import { formatDocPageAsMan } from "./man-hrFQUZQw.js";
 import { getDocPageAsync, getDocPageSync } from "@optique/core/parser";
 
 //#region src/generator.ts

package/dist/generator.cjs

@@ -1,6 +1,6 @@
-require('./man-C44Q4VSc.cjs');
+require('./man-BRIf09IL.cjs');
 require('./roff-C8MvQ2tL.cjs');
-const require_generator = require('./generator-CtkCu_MS.cjs');
+const require_generator = require('./generator-Cx-FBKsf.cjs');
 
 exports.generateManPage = require_generator.generateManPage;
 exports.generateManPageAsync = require_generator.generateManPageAsync;

package/dist/generator.d.cts

@@ -1,3 +1,3 @@
-import "./man-C3FUTPuQ.cjs";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-I9cXlw1Z.cjs";
+import "./man-BQpizqcO.cjs";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-CZaQyGmU.cjs";
 export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.d.ts

@@ -1,3 +1,3 @@
-import "./man-CHYiSoI_.js";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-MbR1I1SH.js";
+import "./man-Ciuegxoi.js";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-B6ZmkvAw.js";
 export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.js

@@ -1,5 +1,5 @@
 import "./roff-Bh9bsH6u.js";
-import "./man-Cq0qfXg0.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-DywTJCMH.js";
+import "./man-hrFQUZQw.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-r2ZeAR1V.js";
 
 export { generateManPage, generateManPageAsync, generateManPageSync };

package/dist/index.cjs

@@ -1,6 +1,6 @@
-const require_man = require('./man-C44Q4VSc.cjs');
+const require_man = require('./man-BRIf09IL.cjs');
 const require_roff = require('./roff-C8MvQ2tL.cjs');
-const require_generator = require('./generator-CtkCu_MS.cjs');
+const require_generator = require('./generator-Cx-FBKsf.cjs');
 
 exports.escapeHyphens = require_roff.escapeHyphens;
 exports.escapeQuotedValue = require_roff.escapeQuotedValue;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-C3FUTPuQ.cjs";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-I9cXlw1Z.cjs";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-BQpizqcO.cjs";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-CZaQyGmU.cjs";
 import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-Cpm_FJok.cjs";
 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,4 +1,4 @@
-import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CHYiSoI_.js";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-MbR1I1SH.js";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Ciuegxoi.js";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-B6ZmkvAw.js";
 import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-DkJvVQ1o.js";
 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-Bh9bsH6u.js";
-import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Cq0qfXg0.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-DywTJCMH.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-hrFQUZQw.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-r2ZeAR1V.js";
 
 export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/{man-C3FUTPuQ.d.cts → man-BQpizqcO.d.cts}

@@ -114,6 +114,8 @@ interface ManPageOptions {
 declare function formatDateForMan(date: string | Date | undefined): string | undefined;
 /**
  * Formats a single {@link UsageTerm} as roff markup for the SYNOPSIS section.
+ * Optionality follows the supplied usage wrappers.  Usage describes display
+ * structure; empty-input acceptance depends on the parser's runtime behavior.
  *
  * @param term The usage term to format.
  * @returns The roff-formatted string.

package/dist/{man-C44Q4VSc.cjs → man-BRIf09IL.cjs}

@@ -64,6 +64,8 @@ function formatCommandNameAsRoff(name) {
 }
 /**
 * Formats a single {@link UsageTerm} as roff markup for the SYNOPSIS section.
+* Optionality follows the supplied usage wrappers.  Usage describes display
+* structure; empty-input acceptance depends on the parser's runtime behavior.
 *
 * @param term The usage term to format.
 * @returns The roff-formatted string.
@@ -74,12 +76,12 @@ 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.
+* Returns whether a usage list contains exactly one visible term that can
+* share enclosing brackets.  Options need no brackets of their own, while
+* optional and repeated terms can elide redundant brackets.  Multiple
+* visible siblings must retain their individual grouping boundaries.
 */
-function hasSingleBracketedTerm(terms) {
+function hasSingleElidableTerm(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];
@@ -99,23 +101,23 @@ function formatUsageTermAsRoffInternal(term, insideBrackets) {
 		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}]`;
+			if (insideBrackets || term.names.length < 2) return `${names}${metavarPart}`;
+			return `(${names})${metavarPart}`;
 		}
 		case "command": return formatCommandNameAsRoff(term.name);
 		case "optional": {
-			const childrenBracketed = hasSingleBracketedTerm(term.terms);
-			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
-			const inner = formatUsageAsRoffInternal(term.terms, childrenBracketed);
+			const childrenElidable = hasSingleElidableTerm(term.terms);
+			const childIsMultiple = childrenElidable && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const inner = formatUsageAsRoffInternal(term.terms, childrenElidable);
 			if (inner === "") return "";
-			if (insideBrackets && childrenBracketed && !childIsMultiple) return inner;
+			if (insideBrackets && childrenElidable && !childIsMultiple) return inner;
 			return `[${inner}]`;
 		}
 		case "multiple": {
 			const wrapInBrackets = term.min < 1;
-			const childrenBracketed = hasSingleBracketedTerm(term.terms);
-			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
-			const passInsideBrackets = wrapInBrackets && childrenBracketed && !childIsMultiple;
+			const childrenElidable = hasSingleElidableTerm(term.terms);
+			const childIsMultiple = childrenElidable && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const passInsideBrackets = wrapInBrackets && childrenElidable && !childIsMultiple;
 			const inner = formatUsageAsRoffInternal(term.terms, passInsideBrackets);
 			if (inner === "") return "";
 			if (wrapInBrackets) {

package/dist/{man-CHYiSoI_.d.ts → man-Ciuegxoi.d.ts}

@@ -114,6 +114,8 @@ interface ManPageOptions {
 declare function formatDateForMan(date: string | Date | undefined): string | undefined;
 /**
  * Formats a single {@link UsageTerm} as roff markup for the SYNOPSIS section.
+ * Optionality follows the supplied usage wrappers.  Usage describes display
+ * structure; empty-input acceptance depends on the parser's runtime behavior.
  *
  * @param term The usage term to format.
  * @returns The roff-formatted string.

package/dist/{man-Cq0qfXg0.js → man-hrFQUZQw.js}

@@ -41,6 +41,8 @@ function formatCommandNameAsRoff(name) {
 }
 /**
 * Formats a single {@link UsageTerm} as roff markup for the SYNOPSIS section.
+* Optionality follows the supplied usage wrappers.  Usage describes display
+* structure; empty-input acceptance depends on the parser's runtime behavior.
 *
 * @param term The usage term to format.
 * @returns The roff-formatted string.
@@ -51,12 +53,12 @@ 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.
+* Returns whether a usage list contains exactly one visible term that can
+* share enclosing brackets.  Options need no brackets of their own, while
+* optional and repeated terms can elide redundant brackets.  Multiple
+* visible siblings must retain their individual grouping boundaries.
 */
-function hasSingleBracketedTerm(terms) {
+function hasSingleElidableTerm(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];
@@ -76,23 +78,23 @@ function formatUsageTermAsRoffInternal(term, insideBrackets) {
 		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}]`;
+			if (insideBrackets || term.names.length < 2) return `${names}${metavarPart}`;
+			return `(${names})${metavarPart}`;
 		}
 		case "command": return formatCommandNameAsRoff(term.name);
 		case "optional": {
-			const childrenBracketed = hasSingleBracketedTerm(term.terms);
-			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
-			const inner = formatUsageAsRoffInternal(term.terms, childrenBracketed);
+			const childrenElidable = hasSingleElidableTerm(term.terms);
+			const childIsMultiple = childrenElidable && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const inner = formatUsageAsRoffInternal(term.terms, childrenElidable);
 			if (inner === "") return "";
-			if (insideBrackets && childrenBracketed && !childIsMultiple) return inner;
+			if (insideBrackets && childrenElidable && !childIsMultiple) return inner;
 			return `[${inner}]`;
 		}
 		case "multiple": {
 			const wrapInBrackets = term.min < 1;
-			const childrenBracketed = hasSingleBracketedTerm(term.terms);
-			const childIsMultiple = childrenBracketed && hasSingleVisibleTermOfType(term.terms, "multiple");
-			const passInsideBrackets = wrapInBrackets && childrenBracketed && !childIsMultiple;
+			const childrenElidable = hasSingleElidableTerm(term.terms);
+			const childIsMultiple = childrenElidable && hasSingleVisibleTermOfType(term.terms, "multiple");
+			const passInsideBrackets = wrapInBrackets && childrenElidable && !childIsMultiple;
 			const inner = formatUsageAsRoffInternal(term.terms, passInsideBrackets);
 			if (inner === "") return "";
 			if (wrapInBrackets) {

package/dist/man.cjs

@@ -1,4 +1,4 @@
-const require_man = require('./man-C44Q4VSc.cjs');
+const require_man = require('./man-BRIf09IL.cjs');
 require('./roff-C8MvQ2tL.cjs');
 
 exports.formatDateForMan = require_man.formatDateForMan;

package/dist/man.d.cts

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

package/dist/man.d.ts

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

package/dist/man.js

@@ -1,4 +1,4 @@
 import "./roff-Bh9bsH6u.js";
-import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Cq0qfXg0.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-hrFQUZQw.js";
 
 export { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/man",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Man page generator for Optique CLI parsers",
   "keywords": [
     "CLI",
@@ -90,11 +90,11 @@
     "optique-man": "./dist/cli.js"
   },
   "dependencies": {
-    "@optique/core": "1.3.2",
-    "@optique/run": "1.3.2"
+    "@optique/core": "1.3.3",
+    "@optique/run": "1.3.3"
   },
   "devDependencies": {
-    "@optique/testing": "1.3.2",
+    "@optique/testing": "1.3.3",
     "@types/node": "^24.0.0",
     "tsdown": "^0.13.0",
     "tsx": "^4.21.0",