@optique/man 1.4.0-dev.2708 → 1.4.0-dev.2711

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_man = require('./man-CbkazOBJ.cjs');
+const require_man = require('./man-DGAR8ct4.cjs');
 require('./roff-C8MvQ2tL.cjs');
-const require_generator = require('./generator-oBpyBLKQ.cjs');
+const require_generator = require('./generator-BAYozOjf.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.4.0-dev.2708+0119545d";
+var version = "1.4.0-dev.2711+fda80c51";
 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-CQXpql4K.js";
-import { generateManPageAsync } from "./generator-B5yyN1Vt.js";
+import "./man-fxL2soSJ.js";
+import { generateManPageAsync } from "./generator-D36bK8bw.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.4.0-dev.2708+0119545d";
+var version = "1.4.0-dev.2711+fda80c51";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

package/dist/{generator-oBpyBLKQ.cjs → generator-BAYozOjf.cjs}

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

package/dist/{generator-pUbUcxVA.d.cts → generator-BOtzZZU6.d.cts}

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

package/dist/{generator-1fDy_sht.d.ts → generator-BZBZucRz.d.ts}

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

package/dist/{generator-B5yyN1Vt.js → generator-D36bK8bw.js}

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

package/dist/generator.cjs

@@ -1,6 +1,6 @@
-require('./man-CbkazOBJ.cjs');
+require('./man-DGAR8ct4.cjs');
 require('./roff-C8MvQ2tL.cjs');
-const require_generator = require('./generator-oBpyBLKQ.cjs');
+const require_generator = require('./generator-BAYozOjf.cjs');
 
 exports.generateManPage = require_generator.generateManPage;
 exports.generateManPageAsync = require_generator.generateManPageAsync;

package/dist/generator.d.cts

@@ -1,3 +1,3 @@
-import "./man-BB48LlND.cjs";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-pUbUcxVA.cjs";
+import "./man-Czp4fceb.cjs";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-BOtzZZU6.cjs";
 export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.d.ts

@@ -1,3 +1,3 @@
-import "./man-WqxcdyoU.js";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-1fDy_sht.js";
+import "./man-DgWDaZfO.js";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-BZBZucRz.js";
 export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.js

@@ -1,5 +1,5 @@
 import "./roff-Bh9bsH6u.js";
-import "./man-CQXpql4K.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-B5yyN1Vt.js";
+import "./man-fxL2soSJ.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-D36bK8bw.js";
 
 export { generateManPage, generateManPageAsync, generateManPageSync };

package/dist/index.cjs

@@ -1,6 +1,6 @@
-const require_man = require('./man-CbkazOBJ.cjs');
+const require_man = require('./man-DGAR8ct4.cjs');
 const require_roff = require('./roff-C8MvQ2tL.cjs');
-const require_generator = require('./generator-oBpyBLKQ.cjs');
+const require_generator = require('./generator-BAYozOjf.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-BB48LlND.cjs";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-pUbUcxVA.cjs";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Czp4fceb.cjs";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-BOtzZZU6.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-WqxcdyoU.js";
-import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-1fDy_sht.js";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-DgWDaZfO.js";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-BZBZucRz.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-CQXpql4K.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-B5yyN1Vt.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-fxL2soSJ.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-D36bK8bw.js";
 
 export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/{man-BB48LlND.d.cts → man-Czp4fceb.d.cts}

@@ -132,8 +132,9 @@ 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.
+ * Optionality follows the supplied usage wrappers, except that a group
+ * recording `acceptsEmpty` is drawn as omissible exactly when its parser
+ * accepts an empty argument list, as in `formatUsage()`.
  *
  * @param term The usage term to format.
  * @returns The roff-formatted string.

package/dist/{man-CbkazOBJ.cjs → man-DGAR8ct4.cjs}

@@ -24,6 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 const require_roff = require('./roff-C8MvQ2tL.cjs');
 const __optique_core_doc = __toESM(require("@optique/core/doc"));
 const __optique_core_usage = __toESM(require("@optique/core/usage"));
+const __optique_core_internal_usage = __toESM(require("@optique/core/internal/usage"));
 
 //#region src/man.ts
 /**
@@ -65,8 +66,9 @@ 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.
+* Optionality follows the supplied usage wrappers, except that a group
+* recording `acceptsEmpty` is drawn as omissible exactly when its parser
+* accepts an empty argument list, as in `formatUsage()`.
 *
 * @param term The usage term to format.
 * @returns The roff-formatted string.
@@ -74,7 +76,7 @@ function formatCommandNameAsRoff(name) {
 * @since 0.10.0
 */
 function formatUsageTermAsRoff(term) {
-	return formatUsageTermAsRoffInternal(term, false);
+	return formatUsageAsRoff([term]);
 }
 /**
 * Returns whether a usage list contains exactly one visible term that can
@@ -150,7 +152,7 @@ function formatUsageTermAsRoffInternal(term, insideBrackets) {
 * @returns The roff-formatted string.
 */
 function formatUsageAsRoff(usage) {
-	return formatUsageAsRoffInternal(usage, false);
+	return formatUsageAsRoffInternal((0, __optique_core_internal_usage.resolveUsageForDisplay)(usage, __optique_core_usage.isUsageHidden), false);
 }
 function formatUsageAsRoffInternal(usage, insideBrackets) {
 	return usage.map((term) => formatUsageTermAsRoffInternal(term, insideBrackets)).filter((s) => s !== "").join(" ");

package/dist/{man-WqxcdyoU.d.ts → man-DgWDaZfO.d.ts}

@@ -132,8 +132,9 @@ 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.
+ * Optionality follows the supplied usage wrappers, except that a group
+ * recording `acceptsEmpty` is drawn as omissible exactly when its parser
+ * accepts an empty argument list, as in `formatUsage()`.
  *
  * @param term The usage term to format.
  * @returns The roff-formatted string.

package/dist/{man-CQXpql4K.js → man-fxL2soSJ.js}

@@ -1,6 +1,7 @@
 import { escapeHyphens, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-Bh9bsH6u.js";
 import { deriveEnvironmentSection } from "@optique/core/doc";
 import { isDocHidden, isUsageHidden } from "@optique/core/usage";
+import { resolveUsageForDisplay } from "@optique/core/internal/usage";
 
 //#region src/man.ts
 /**
@@ -42,8 +43,9 @@ 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.
+* Optionality follows the supplied usage wrappers, except that a group
+* recording `acceptsEmpty` is drawn as omissible exactly when its parser
+* accepts an empty argument list, as in `formatUsage()`.
 *
 * @param term The usage term to format.
 * @returns The roff-formatted string.
@@ -51,7 +53,7 @@ function formatCommandNameAsRoff(name) {
 * @since 0.10.0
 */
 function formatUsageTermAsRoff(term) {
-	return formatUsageTermAsRoffInternal(term, false);
+	return formatUsageAsRoff([term]);
 }
 /**
 * Returns whether a usage list contains exactly one visible term that can
@@ -127,7 +129,7 @@ function formatUsageTermAsRoffInternal(term, insideBrackets) {
 * @returns The roff-formatted string.
 */
 function formatUsageAsRoff(usage) {
-	return formatUsageAsRoffInternal(usage, false);
+	return formatUsageAsRoffInternal(resolveUsageForDisplay(usage, isUsageHidden), false);
 }
 function formatUsageAsRoffInternal(usage, insideBrackets) {
 	return usage.map((term) => formatUsageTermAsRoffInternal(term, insideBrackets)).filter((s) => s !== "").join(" ");

package/dist/man.cjs

@@ -1,4 +1,4 @@
-const require_man = require('./man-CbkazOBJ.cjs');
+const require_man = require('./man-DGAR8ct4.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-BB48LlND.cjs";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Czp4fceb.cjs";
 export { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/dist/man.d.ts

@@ -1,2 +1,2 @@
-import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-WqxcdyoU.js";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-DgWDaZfO.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-CQXpql4K.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-fxL2soSJ.js";
 
 export { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/package.json

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