@optique/man 1.0.0-dev.900 → 1.0.0-dev.921

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_man = require('./man-DFKETOWN.cjs');
+const require_man = require('./man-Bah5ZMyV.cjs');
 require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-BkWfsb4u.cjs');
+const require_generator = require('./generator-bugVqGJn.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.900+d7ebaa88";
+var version = "1.0.0-dev.921+754748bd";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import "./roff-CwBRpWCo.js";
-import "./man-BBDifH_Y.js";
-import { generateManPageAsync } from "./generator-DZnf5j1D.js";
+import "./man-BiY491LQ.js";
+import { generateManPageAsync } from "./generator-CnMxnsMc.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.900+d7ebaa88";
+var version = "1.0.0-dev.921+754748bd";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

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

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

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

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

package/dist/index.cjs

@@ -1,6 +1,6 @@
-const require_man = require('./man-DFKETOWN.cjs');
+const require_man = require('./man-Bah5ZMyV.cjs');
 const require_roff = require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-BkWfsb4u.cjs');
+const require_generator = require('./generator-bugVqGJn.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-xPX8GhXq.cjs";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-Dp4oW-al.cjs";
 import { Mode, ModeValue, Parser } from "@optique/core/parser";
 import { Program } from "@optique/core/program";
 

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-CGKLHWkS.js";
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CGBnZvZF.js";
 import { Program } from "@optique/core/program";
 import { Mode, ModeValue, Parser } from "@optique/core/parser";
 

package/dist/index.js

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

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

@@ -28,6 +28,12 @@ const __optique_core_usage = __toESM(require("@optique/core/usage"));
 /**
 * Formats a date for use in man pages.
 *
+* When a `Date` object is given, the month and year are extracted using
+* the host's local timezone (`getMonth()` / `getFullYear()`).  This means
+* the same `Date` instant may produce different output on machines in
+* different timezones.  Pass a pre-formatted string (e.g., `"January 2026"`)
+* if you need timezone-independent output.
+*
 * @param date The date to format, or undefined.
 * @returns The formatted date string, or undefined.
 * @since 0.10.0
@@ -51,9 +57,6 @@ function formatDateForMan(date) {
 	];
 	return `${months[date.getMonth()]} ${date.getFullYear()}`;
 }
-function escapeThField(value) {
-	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
-}
 function formatCommandNameAsRoff(name) {
 	return `\\fB${require_roff.escapeHyphens(require_roff.escapeRoff(name))}\\fR`;
 }
@@ -228,8 +231,8 @@ function formatDocSectionEntries(section) {
 * @param options The man page options.
 * @returns The complete man page in roff format.
 * @throws {TypeError} If the program name is empty.
-* @throws {RangeError} If the section number is not a valid man page section
-* (1–8).
+* @throws {RangeError} If the section number or any `seeAlso` entry's section
+* number is not a valid man page section (1–8).
 * @since 0.10.0
 */
 function formatDocPageAsMan(page, options) {
@@ -244,22 +247,22 @@ function formatDocPageAsMan(page, options) {
 		throw new RangeError(`Invalid man page section number (must be 1–8): ${repr}`);
 	}
 	const lines = [];
-	const thParts = [require_roff.escapeHyphens(escapeThField(options.name).toUpperCase()), options.section.toString()];
+	const thParts = [`"${require_roff.escapeHyphens(require_roff.escapeRequestArg(options.name.toUpperCase()))}"`, options.section.toString()];
 	const hasDate = options.date != null && options.date !== "";
 	const hasVersion = options.version != null && options.version !== "";
 	const hasManual = options.manual != null && options.manual !== "";
-	if (hasDate) thParts.push(`"${escapeThField(formatDateForMan(options.date))}"`);
+	if (hasDate) thParts.push(`"${require_roff.escapeRequestArg(formatDateForMan(options.date))}"`);
 	else if (hasVersion || hasManual) thParts.push("\"\"");
-	if (hasVersion) thParts.push(`"${require_roff.escapeHyphens(escapeThField(options.name))} ${escapeThField(options.version)}"`);
+	if (hasVersion) thParts.push(`"${require_roff.escapeHyphens(require_roff.escapeRequestArg(options.name))} ${require_roff.escapeRequestArg(options.version)}"`);
 	else if (hasManual) thParts.push("\"\"");
-	if (hasManual) thParts.push(`"${escapeThField(options.manual)}"`);
+	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)}`);
 	else lines.push(require_roff.escapeHyphens(require_roff.escapeRoff(options.name)));
 	if (page.usage) {
 		lines.push(".SH SYNOPSIS");
-		lines.push(`.B ${require_roff.escapeHyphens(require_roff.escapeRoff(options.name))}`);
+		lines.push(`.B "${require_roff.escapeHyphens(require_roff.escapeRequestArg(options.name))}"`);
 		const usageStr = formatUsageAsRoff(page.usage);
 		if (usageStr) lines.push(usageStr);
 	}
@@ -305,10 +308,19 @@ function formatDocPageAsMan(page, options) {
 		lines.push(require_roff.formatMessageAsRoff(options.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) {
+			let repr;
+			try {
+				repr = JSON.stringify(ref.section);
+			} catch {
+				repr = String(typeof ref.section);
+			}
+			throw new RangeError(`Invalid man page section number for seeAlso entry ${JSON.stringify(ref.name)} (must be 1–8): ${repr}`);
+		}
 		lines.push(".SH SEE ALSO");
 		const refs = options.seeAlso.map((ref, i) => {
 			const suffix = i < options.seeAlso.length - 1 ? "," : "";
-			return `.BR ${require_roff.escapeHyphens(require_roff.escapeRoff(ref.name))} (${ref.section})${suffix}`;
+			return `.BR "${require_roff.escapeHyphens(require_roff.escapeRequestArg(ref.name))}" (${ref.section})${suffix}`;
 		});
 		lines.push(refs.join("\n"));
 	}

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

@@ -5,6 +5,12 @@ import { isDocHidden, isUsageHidden } from "@optique/core/usage";
 /**
 * Formats a date for use in man pages.
 *
+* When a `Date` object is given, the month and year are extracted using
+* the host's local timezone (`getMonth()` / `getFullYear()`).  This means
+* the same `Date` instant may produce different output on machines in
+* different timezones.  Pass a pre-formatted string (e.g., `"January 2026"`)
+* if you need timezone-independent output.
+*
 * @param date The date to format, or undefined.
 * @returns The formatted date string, or undefined.
 * @since 0.10.0
@@ -28,9 +34,6 @@ function formatDateForMan(date) {
 	];
 	return `${months[date.getMonth()]} ${date.getFullYear()}`;
 }
-function escapeThField(value) {
-	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
-}
 function formatCommandNameAsRoff(name) {
 	return `\\fB${escapeHyphens(escapeRoff(name))}\\fR`;
 }
@@ -205,8 +208,8 @@ function formatDocSectionEntries(section) {
 * @param options The man page options.
 * @returns The complete man page in roff format.
 * @throws {TypeError} If the program name is empty.
-* @throws {RangeError} If the section number is not a valid man page section
-* (1–8).
+* @throws {RangeError} If the section number or any `seeAlso` entry's section
+* number is not a valid man page section (1–8).
 * @since 0.10.0
 */
 function formatDocPageAsMan(page, options) {
@@ -221,22 +224,22 @@ function formatDocPageAsMan(page, options) {
 		throw new RangeError(`Invalid man page section number (must be 1–8): ${repr}`);
 	}
 	const lines = [];
-	const thParts = [escapeHyphens(escapeThField(options.name).toUpperCase()), options.section.toString()];
+	const thParts = [`"${escapeHyphens(escapeRequestArg(options.name.toUpperCase()))}"`, options.section.toString()];
 	const hasDate = options.date != null && options.date !== "";
 	const hasVersion = options.version != null && options.version !== "";
 	const hasManual = options.manual != null && options.manual !== "";
-	if (hasDate) thParts.push(`"${escapeThField(formatDateForMan(options.date))}"`);
+	if (hasDate) thParts.push(`"${escapeRequestArg(formatDateForMan(options.date))}"`);
 	else if (hasVersion || hasManual) thParts.push("\"\"");
-	if (hasVersion) thParts.push(`"${escapeHyphens(escapeThField(options.name))} ${escapeThField(options.version)}"`);
+	if (hasVersion) thParts.push(`"${escapeHyphens(escapeRequestArg(options.name))} ${escapeRequestArg(options.version)}"`);
 	else if (hasManual) thParts.push("\"\"");
-	if (hasManual) thParts.push(`"${escapeThField(options.manual)}"`);
+	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)}`);
 	else lines.push(escapeHyphens(escapeRoff(options.name)));
 	if (page.usage) {
 		lines.push(".SH SYNOPSIS");
-		lines.push(`.B ${escapeHyphens(escapeRoff(options.name))}`);
+		lines.push(`.B "${escapeHyphens(escapeRequestArg(options.name))}"`);
 		const usageStr = formatUsageAsRoff(page.usage);
 		if (usageStr) lines.push(usageStr);
 	}
@@ -282,10 +285,19 @@ function formatDocPageAsMan(page, options) {
 		lines.push(formatMessageAsRoff(options.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) {
+			let repr;
+			try {
+				repr = JSON.stringify(ref.section);
+			} catch {
+				repr = String(typeof ref.section);
+			}
+			throw new RangeError(`Invalid man page section number for seeAlso entry ${JSON.stringify(ref.name)} (must be 1–8): ${repr}`);
+		}
 		lines.push(".SH SEE ALSO");
 		const refs = options.seeAlso.map((ref, i) => {
 			const suffix = i < options.seeAlso.length - 1 ? "," : "";
-			return `.BR ${escapeHyphens(escapeRoff(ref.name))} (${ref.section})${suffix}`;
+			return `.BR "${escapeHyphens(escapeRequestArg(ref.name))}" (${ref.section})${suffix}`;
 		});
 		lines.push(refs.join("\n"));
 	}

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

@@ -1,6 +1,6 @@
 import { Message } from "@optique/core/message";
-import { DocPage, DocSection } from "@optique/core/doc";
 import { UsageTerm } from "@optique/core/usage";
+import { DocPage, DocSection } from "@optique/core/doc";
 
 //#region src/man.d.ts
 
@@ -32,7 +32,9 @@ interface ManPageOptions {
   readonly section: ManPageSection;
   /**
    * The date to display in the man page footer.
-   * If a Date object is provided, it will be formatted as "Month Year".
+   * If a `Date` object is provided, it will be formatted as `"Month Year"`
+   * using the host's local timezone.  For timezone-independent output (e.g.,
+   * in CI), pass a pre-formatted string instead.
    * If a string is provided, it will be used as-is.
    */
   readonly date?: string | Date;
@@ -62,7 +64,7 @@ interface ManPageOptions {
    */
   readonly seeAlso?: ReadonlyArray<{
     readonly name: string;
-    readonly section: number;
+    readonly section: ManPageSection;
   }>;
   /**
    * Environment variables to document in the ENVIRONMENT section.
@@ -80,6 +82,12 @@ interface ManPageOptions {
 /**
  * Formats a date for use in man pages.
  *
+ * When a `Date` object is given, the month and year are extracted using
+ * the host's local timezone (`getMonth()` / `getFullYear()`).  This means
+ * the same `Date` instant may produce different output on machines in
+ * different timezones.  Pass a pre-formatted string (e.g., `"January 2026"`)
+ * if you need timezone-independent output.
+ *
  * @param date The date to format, or undefined.
  * @returns The formatted date string, or undefined.
  * @since 0.10.0
@@ -122,8 +130,8 @@ declare function formatUsageTermAsRoff(term: UsageTerm): string;
  * @param options The man page options.
  * @returns The complete man page in roff format.
  * @throws {TypeError} If the program name is empty.
- * @throws {RangeError} If the section number is not a valid man page section
- * (1–8).
+ * @throws {RangeError} If the section number or any `seeAlso` entry's section
+ * number is not a valid man page section (1–8).
  * @since 0.10.0
  */
 declare function formatDocPageAsMan(page: DocPage, options: ManPageOptions): string;

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

@@ -1,6 +1,6 @@
 import { Message } from "@optique/core/message";
-import { UsageTerm } from "@optique/core/usage";
 import { DocPage, DocSection } from "@optique/core/doc";
+import { UsageTerm } from "@optique/core/usage";
 
 //#region src/man.d.ts
 
@@ -32,7 +32,9 @@ interface ManPageOptions {
   readonly section: ManPageSection;
   /**
    * The date to display in the man page footer.
-   * If a Date object is provided, it will be formatted as "Month Year".
+   * If a `Date` object is provided, it will be formatted as `"Month Year"`
+   * using the host's local timezone.  For timezone-independent output (e.g.,
+   * in CI), pass a pre-formatted string instead.
    * If a string is provided, it will be used as-is.
    */
   readonly date?: string | Date;
@@ -62,7 +64,7 @@ interface ManPageOptions {
    */
   readonly seeAlso?: ReadonlyArray<{
     readonly name: string;
-    readonly section: number;
+    readonly section: ManPageSection;
   }>;
   /**
    * Environment variables to document in the ENVIRONMENT section.
@@ -80,6 +82,12 @@ interface ManPageOptions {
 /**
  * Formats a date for use in man pages.
  *
+ * When a `Date` object is given, the month and year are extracted using
+ * the host's local timezone (`getMonth()` / `getFullYear()`).  This means
+ * the same `Date` instant may produce different output on machines in
+ * different timezones.  Pass a pre-formatted string (e.g., `"January 2026"`)
+ * if you need timezone-independent output.
+ *
  * @param date The date to format, or undefined.
  * @returns The formatted date string, or undefined.
  * @since 0.10.0
@@ -122,8 +130,8 @@ declare function formatUsageTermAsRoff(term: UsageTerm): string;
  * @param options The man page options.
  * @returns The complete man page in roff format.
  * @throws {TypeError} If the program name is empty.
- * @throws {RangeError} If the section number is not a valid man page section
- * (1–8).
+ * @throws {RangeError} If the section number or any `seeAlso` entry's section
+ * number is not a valid man page section (1–8).
  * @since 0.10.0
  */
 declare function formatDocPageAsMan(page: DocPage, options: ManPageOptions): string;

package/dist/man.cjs

@@ -1,4 +1,4 @@
-const require_man = require('./man-DFKETOWN.cjs');
+const require_man = require('./man-Bah5ZMyV.cjs');
 require('./roff-Cl0vekdg.cjs');
 
 exports.formatDateForMan = require_man.formatDateForMan;

package/dist/man.d.cts

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

package/dist/man.d.ts

@@ -1,2 +1,2 @@
-import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CGKLHWkS.js";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CGBnZvZF.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-BBDifH_Y.js";
+import { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-BiY491LQ.js";
 
 export { formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/man",
-  "version": "1.0.0-dev.900+d7ebaa88",
+  "version": "1.0.0-dev.921+754748bd",
   "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.900+d7ebaa88",
-    "@optique/run": "1.0.0-dev.900+d7ebaa88"
+    "@optique/core": "1.0.0-dev.921+754748bd",
+    "@optique/run": "1.0.0-dev.921+754748bd"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",