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

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_man = require('./man-NL-hVPdd.cjs');
+const require_man = require('./man-Bah5ZMyV.cjs');
 require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-BORgW1yS.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.908+f60f037d";
+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-CcjsLpyb.js";
-import { generateManPageAsync } from "./generator-Di1pIRAG.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.908+f60f037d";
+var version = "1.0.0-dev.921+754748bd";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

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

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

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

@@ -1,4 +1,4 @@
-const require_man = require('./man-NL-hVPdd.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-NL-hVPdd.cjs');
+const require_man = require('./man-Bah5ZMyV.cjs');
 const require_roff = require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-BORgW1yS.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-D2t8hkyn.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-DXQgwt1g.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-CcjsLpyb.js";
-import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-Di1pIRAG.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-NL-hVPdd.cjs → man-Bah5ZMyV.cjs}

@@ -231,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) {
@@ -308,6 +308,15 @@ 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 ? "," : "";

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

@@ -208,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) {
@@ -285,6 +285,15 @@ 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 ? "," : "";

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

@@ -64,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.
@@ -130,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-D2t8hkyn.d.cts → man-Dp4oW-al.d.cts}

@@ -64,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.
@@ -130,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-NL-hVPdd.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-D2t8hkyn.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-DXQgwt1g.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-CcjsLpyb.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.908+f60f037d",
+  "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/run": "1.0.0-dev.908+f60f037d",
-    "@optique/core": "1.0.0-dev.908+f60f037d"
+    "@optique/core": "1.0.0-dev.921+754748bd",
+    "@optique/run": "1.0.0-dev.921+754748bd"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",