@optique/man 1.0.0-dev.783 → 1.0.0-dev.788

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_man = require('./man-CT30XV48.cjs');
+const require_man = require('./man-j-bcfLoE.cjs');
 require('./roff-EpcecLXU.cjs');
-const require_generator = require('./generator-BDKtMiuq.cjs');
+const require_generator = require('./generator-CuGGdQoF.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.783+64de3665";
+var version = "1.0.0-dev.788+1f1c275f";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import "./roff-C_MiRXVS.js";
-import "./man-CAYHrsaf.js";
-import { generateManPageAsync } from "./generator-DGiXLyTu.js";
+import "./man-DOn-s45r.js";
+import { generateManPageAsync } from "./generator-kHG20XUT.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.783+64de3665";
+var version = "1.0.0-dev.788+1f1c275f";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

package/dist/{generator-BDKtMiuq.cjs → generator-CuGGdQoF.cjs}

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

package/dist/{generator-DGiXLyTu.js → generator-kHG20XUT.js}

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

package/dist/index.cjs

@@ -1,6 +1,6 @@
-const require_man = require('./man-CT30XV48.cjs');
+const require_man = require('./man-j-bcfLoE.cjs');
 const require_roff = require('./roff-EpcecLXU.cjs');
-const require_generator = require('./generator-BDKtMiuq.cjs');
+const require_generator = require('./generator-CuGGdQoF.cjs');
 
 exports.escapeHyphens = require_roff.escapeHyphens;
 exports.escapeRoff = require_roff.escapeRoff;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { escapeHyphens, escapeRoff, formatMessageAsRoff } from "./roff-C_MiRXVS.js";
-import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CAYHrsaf.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-DGiXLyTu.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-DOn-s45r.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-kHG20XUT.js";
 
 export { escapeHyphens, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/{man-CAYHrsaf.js → man-DOn-s45r.js}

@@ -1,4 +1,4 @@
-import { escapeHyphens, formatMessageAsRoff } from "./roff-C_MiRXVS.js";
+import { escapeHyphens, escapeRoff, formatMessageAsRoff } from "./roff-C_MiRXVS.js";
 import { isDocHidden, isUsageHidden } from "@optique/core/usage";
 
 //#region src/man.ts
@@ -31,6 +31,9 @@ function formatDateForMan(date) {
 function escapeThField(value) {
 	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
+function formatCommandNameAsRoff(name) {
+	return `\\fB${escapeHyphens(escapeRoff(name))}\\fR`;
+}
 /**
 * Formats a single {@link UsageTerm} as roff markup for the SYNOPSIS section.
 *
@@ -48,7 +51,7 @@ function formatUsageTermAsRoff(term) {
 			const metavarPart = term.metavar ? ` \\fI${term.metavar}\\fR` : "";
 			return `[${names}${metavarPart}]`;
 		}
-		case "command": return `\\fB${term.name}\\fR`;
+		case "command": return formatCommandNameAsRoff(term.name);
 		case "optional": {
 			const inner = formatUsageAsRoff(term.terms);
 			if (inner === "") return "";
@@ -98,7 +101,7 @@ function formatDocEntryTerm(term) {
 			const metavarPart = term.metavar ? ` \\fI${term.metavar}\\fR` : "";
 			return `${names}${metavarPart}`;
 		}
-		case "command": return `\\fB${term.name}\\fR`;
+		case "command": return formatCommandNameAsRoff(term.name);
 		case "argument": return `\\fI${term.metavar}\\fR`;
 		case "literal": return term.value;
 		default: return formatDocUsageTermAsRoff(term);
@@ -136,7 +139,7 @@ function formatDocUsageTermAsRoff(term) {
 			const metavarPart = term.metavar ? ` \\fI${term.metavar}\\fR` : "";
 			return `${names}${metavarPart}`;
 		}
-		case "command": return `\\fB${term.name}\\fR`;
+		case "command": return formatCommandNameAsRoff(term.name);
 		case "literal": return term.value;
 		case "passthrough": return "[...]";
 		case "ellipsis": return "...";
@@ -205,22 +208,22 @@ function formatDocSectionEntries(section) {
 */
 function formatDocPageAsMan(page, options) {
 	const lines = [];
-	const thParts = [escapeThField(options.name.toUpperCase()), options.section.toString()];
+	const thParts = [escapeHyphens(escapeThField(options.name).toUpperCase()), options.section.toString()];
 	const hasDate = options.date != null;
 	const hasVersion = options.version != null;
 	const hasManual = options.manual != null;
 	if (hasDate) thParts.push(`"${escapeThField(formatDateForMan(options.date))}"`);
 	else if (hasVersion || hasManual) thParts.push("\"\"");
-	if (hasVersion) thParts.push(`"${escapeThField(`${options.name} ${options.version}`)}"`);
+	if (hasVersion) thParts.push(`"${escapeHyphens(escapeThField(options.name))} ${escapeThField(options.version)}"`);
 	else if (hasManual) thParts.push("\"\"");
 	if (hasManual) thParts.push(`"${escapeThField(options.manual)}"`);
 	lines.push(`.TH ${thParts.join(" ")}`);
 	lines.push(".SH NAME");
-	if (page.brief) lines.push(`${options.name} \\- ${formatMessageAsRoff(page.brief)}`);
-	else lines.push(options.name);
+	if (page.brief) lines.push(`${escapeHyphens(escapeRoff(options.name))} \\- ${formatMessageAsRoff(page.brief)}`);
+	else lines.push(escapeHyphens(escapeRoff(options.name)));
 	if (page.usage) {
 		lines.push(".SH SYNOPSIS");
-		lines.push(`.B ${options.name}`);
+		lines.push(`.B ${escapeHyphens(escapeRoff(options.name))}`);
 		const usageStr = formatUsageAsRoff(page.usage);
 		if (usageStr) lines.push(usageStr);
 	}
@@ -269,7 +272,7 @@ function formatDocPageAsMan(page, options) {
 		lines.push(".SH SEE ALSO");
 		const refs = options.seeAlso.map((ref, i) => {
 			const suffix = i < options.seeAlso.length - 1 ? "," : "";
-			return `.BR ${ref.name} (${ref.section})${suffix}`;
+			return `.BR ${escapeHyphens(escapeRoff(ref.name))} (${ref.section})${suffix}`;
 		});
 		lines.push(refs.join("\n"));
 	}

package/dist/{man-CT30XV48.cjs → man-j-bcfLoE.cjs}

@@ -54,6 +54,9 @@ function formatDateForMan(date) {
 function escapeThField(value) {
 	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
+function formatCommandNameAsRoff(name) {
+	return `\\fB${require_roff.escapeHyphens(require_roff.escapeRoff(name))}\\fR`;
+}
 /**
 * Formats a single {@link UsageTerm} as roff markup for the SYNOPSIS section.
 *
@@ -71,7 +74,7 @@ function formatUsageTermAsRoff(term) {
 			const metavarPart = term.metavar ? ` \\fI${term.metavar}\\fR` : "";
 			return `[${names}${metavarPart}]`;
 		}
-		case "command": return `\\fB${term.name}\\fR`;
+		case "command": return formatCommandNameAsRoff(term.name);
 		case "optional": {
 			const inner = formatUsageAsRoff(term.terms);
 			if (inner === "") return "";
@@ -121,7 +124,7 @@ function formatDocEntryTerm(term) {
 			const metavarPart = term.metavar ? ` \\fI${term.metavar}\\fR` : "";
 			return `${names}${metavarPart}`;
 		}
-		case "command": return `\\fB${term.name}\\fR`;
+		case "command": return formatCommandNameAsRoff(term.name);
 		case "argument": return `\\fI${term.metavar}\\fR`;
 		case "literal": return term.value;
 		default: return formatDocUsageTermAsRoff(term);
@@ -159,7 +162,7 @@ function formatDocUsageTermAsRoff(term) {
 			const metavarPart = term.metavar ? ` \\fI${term.metavar}\\fR` : "";
 			return `${names}${metavarPart}`;
 		}
-		case "command": return `\\fB${term.name}\\fR`;
+		case "command": return formatCommandNameAsRoff(term.name);
 		case "literal": return term.value;
 		case "passthrough": return "[...]";
 		case "ellipsis": return "...";
@@ -228,22 +231,22 @@ function formatDocSectionEntries(section) {
 */
 function formatDocPageAsMan(page, options) {
 	const lines = [];
-	const thParts = [escapeThField(options.name.toUpperCase()), options.section.toString()];
+	const thParts = [require_roff.escapeHyphens(escapeThField(options.name).toUpperCase()), options.section.toString()];
 	const hasDate = options.date != null;
 	const hasVersion = options.version != null;
 	const hasManual = options.manual != null;
 	if (hasDate) thParts.push(`"${escapeThField(formatDateForMan(options.date))}"`);
 	else if (hasVersion || hasManual) thParts.push("\"\"");
-	if (hasVersion) thParts.push(`"${escapeThField(`${options.name} ${options.version}`)}"`);
+	if (hasVersion) thParts.push(`"${require_roff.escapeHyphens(escapeThField(options.name))} ${escapeThField(options.version)}"`);
 	else if (hasManual) thParts.push("\"\"");
 	if (hasManual) thParts.push(`"${escapeThField(options.manual)}"`);
 	lines.push(`.TH ${thParts.join(" ")}`);
 	lines.push(".SH NAME");
-	if (page.brief) lines.push(`${options.name} \\- ${require_roff.formatMessageAsRoff(page.brief)}`);
-	else lines.push(options.name);
+	if (page.brief) lines.push(`${require_roff.escapeHyphens(require_roff.escapeRoff(options.name))} \\- ${require_roff.formatMessageAsRoff(page.brief)}`);
+	else lines.push(require_roff.escapeHyphens(require_roff.escapeRoff(options.name)));
 	if (page.usage) {
 		lines.push(".SH SYNOPSIS");
-		lines.push(`.B ${options.name}`);
+		lines.push(`.B ${require_roff.escapeHyphens(require_roff.escapeRoff(options.name))}`);
 		const usageStr = formatUsageAsRoff(page.usage);
 		if (usageStr) lines.push(usageStr);
 	}
@@ -292,7 +295,7 @@ function formatDocPageAsMan(page, options) {
 		lines.push(".SH SEE ALSO");
 		const refs = options.seeAlso.map((ref, i) => {
 			const suffix = i < options.seeAlso.length - 1 ? "," : "";
-			return `.BR ${ref.name} (${ref.section})${suffix}`;
+			return `.BR ${require_roff.escapeHyphens(require_roff.escapeRoff(ref.name))} (${ref.section})${suffix}`;
 		});
 		lines.push(refs.join("\n"));
 	}

package/dist/man.cjs

@@ -1,4 +1,4 @@
-const require_man = require('./man-CT30XV48.cjs');
+const require_man = require('./man-j-bcfLoE.cjs');
 require('./roff-EpcecLXU.cjs');
 
 exports.formatDateForMan = require_man.formatDateForMan;

package/dist/man.js

@@ -1,4 +1,4 @@
 import "./roff-C_MiRXVS.js";
-import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CAYHrsaf.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-DOn-s45r.js";
 
 export { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/man",
-  "version": "1.0.0-dev.783+64de3665",
+  "version": "1.0.0-dev.788+1f1c275f",
   "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.783+64de3665",
-    "@optique/run": "1.0.0-dev.783+64de3665"
+    "@optique/core": "1.0.0-dev.788+1f1c275f",
+    "@optique/run": "1.0.0-dev.788+1f1c275f"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",