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

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 const require_man = require('./man-DFKETOWN.cjs');
 require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-Bal_ioLr.cjs');
+const require_generator = require('./generator-BkWfsb4u.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.896+5a811a7f";
+var version = "1.0.0-dev.900+d7ebaa88";
 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-CdDVvD4r.js";
+import { generateManPageAsync } from "./generator-DZnf5j1D.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.896+5a811a7f";
+var version = "1.0.0-dev.900+d7ebaa88";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

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

@@ -3,16 +3,40 @@ const __optique_core_parser = require_man.__toESM(require("@optique/core/parser"
 
 //#region src/generator.ts
 /**
+* Checks if the given value looks like a {@link Parser} at runtime.
+*/
+function isParser(value) {
+	try {
+		if (value == null || typeof value !== "object") return false;
+		const p = value;
+		return "parse" in p && typeof p.parse === "function" && "complete" in p && typeof p.complete === "function" && "$mode" in p && (p.$mode === "sync" || p.$mode === "async") && "usage" in p && Array.isArray(p.usage) && "initialState" in p && "suggest" in p && typeof p.suggest === "function" && "getDocFragments" in p && typeof p.getDocFragments === "function";
+	} catch {
+		return false;
+	}
+}
+/**
 * Checks if the given value is a {@link Program} object.
 */
 function isProgram(value) {
-	return typeof value === "object" && value !== null && "parser" in value && "metadata" in value;
+	try {
+		return typeof value === "object" && value !== null && "parser" in value && "metadata" in value && typeof value.metadata === "object" && value.metadata !== null && "name" in value.metadata && typeof value.metadata.name === "string";
+	} catch {
+		return false;
+	}
+}
+/**
+* Validates that the extracted parser is a genuine Optique parser.
+* @throws {TypeError} If the value is not a valid Parser.
+*/
+function validateParser(value) {
+	if (!isParser(value)) throw new TypeError("The given value is not a valid Parser or Program.");
 }
 /**
 * Extracts parser and merged options from a parser or program.
 */
 function extractParserAndOptions(parserOrProgram, options) {
 	if (isProgram(parserOrProgram)) {
+		validateParser(parserOrProgram.parser);
 		const { metadata } = parserOrProgram;
 		const programOptions = options;
 		return {
@@ -33,6 +57,7 @@ function extractParserAndOptions(parserOrProgram, options) {
 			}
 		};
 	}
+	validateParser(parserOrProgram);
 	return {
 		parser: parserOrProgram,
 		mergedOptions: options

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

@@ -3,16 +3,40 @@ import { getDocPageAsync, getDocPageSync } from "@optique/core/parser";
 
 //#region src/generator.ts
 /**
+* Checks if the given value looks like a {@link Parser} at runtime.
+*/
+function isParser(value) {
+	try {
+		if (value == null || typeof value !== "object") return false;
+		const p = value;
+		return "parse" in p && typeof p.parse === "function" && "complete" in p && typeof p.complete === "function" && "$mode" in p && (p.$mode === "sync" || p.$mode === "async") && "usage" in p && Array.isArray(p.usage) && "initialState" in p && "suggest" in p && typeof p.suggest === "function" && "getDocFragments" in p && typeof p.getDocFragments === "function";
+	} catch {
+		return false;
+	}
+}
+/**
 * Checks if the given value is a {@link Program} object.
 */
 function isProgram(value) {
-	return typeof value === "object" && value !== null && "parser" in value && "metadata" in value;
+	try {
+		return typeof value === "object" && value !== null && "parser" in value && "metadata" in value && typeof value.metadata === "object" && value.metadata !== null && "name" in value.metadata && typeof value.metadata.name === "string";
+	} catch {
+		return false;
+	}
+}
+/**
+* Validates that the extracted parser is a genuine Optique parser.
+* @throws {TypeError} If the value is not a valid Parser.
+*/
+function validateParser(value) {
+	if (!isParser(value)) throw new TypeError("The given value is not a valid Parser or Program.");
 }
 /**
 * Extracts parser and merged options from a parser or program.
 */
 function extractParserAndOptions(parserOrProgram, options) {
 	if (isProgram(parserOrProgram)) {
+		validateParser(parserOrProgram.parser);
 		const { metadata } = parserOrProgram;
 		const programOptions = options;
 		return {
@@ -33,6 +57,7 @@ function extractParserAndOptions(parserOrProgram, options) {
 			}
 		};
 	}
+	validateParser(parserOrProgram);
 	return {
 		parser: parserOrProgram,
 		mergedOptions: options

package/dist/index.cjs

@@ -1,6 +1,6 @@
 const require_man = require('./man-DFKETOWN.cjs');
 const require_roff = require('./roff-Cl0vekdg.cjs');
-const require_generator = require('./generator-Bal_ioLr.cjs');
+const require_generator = require('./generator-BkWfsb4u.cjs');
 
 exports.escapeHyphens = require_roff.escapeHyphens;
 exports.escapeQuotedValue = require_roff.escapeQuotedValue;

package/dist/index.d.cts

@@ -48,9 +48,10 @@ interface GenerateManPageProgramOptions extends Partial<Omit<ManPageOptions, "se
  * console.log(manPage);
  * ```
  *
- * @param parser The parser to generate documentation from.
+ * @param parserOrProgram The parser or program to generate documentation from.
  * @param options The man page generation options.
  * @returns The complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
  * @since 0.10.0
  */
 declare function generateManPageSync<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
@@ -78,9 +79,10 @@ declare function generateManPageSync(parser: Parser<"sync", unknown, unknown>, o
  * });
  * ```
  *
- * @param parser The parser to generate documentation from.
+ * @param parserOrProgram The parser or program to generate documentation from.
  * @param options The man page generation options.
  * @returns A promise that resolves to the complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
  * @since 0.10.0
  */
 declare function generateManPageAsync<M extends Mode, T>(program: Program<M, T>, options: GenerateManPageProgramOptions): Promise<string>;
@@ -148,6 +150,7 @@ declare function generateManPageAsync<M extends Mode>(parser: Parser<M, unknown,
  * @param parserOrProgram The parser or program to generate documentation from.
  * @param options The man page generation options.
  * @returns The complete man page in roff format, or a Promise for async parsers.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
  * @since 0.10.0
  */
 declare function generateManPage<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;

package/dist/index.d.ts

@@ -48,9 +48,10 @@ interface GenerateManPageProgramOptions extends Partial<Omit<ManPageOptions, "se
  * console.log(manPage);
  * ```
  *
- * @param parser The parser to generate documentation from.
+ * @param parserOrProgram The parser or program to generate documentation from.
  * @param options The man page generation options.
  * @returns The complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
  * @since 0.10.0
  */
 declare function generateManPageSync<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
@@ -78,9 +79,10 @@ declare function generateManPageSync(parser: Parser<"sync", unknown, unknown>, o
  * });
  * ```
  *
- * @param parser The parser to generate documentation from.
+ * @param parserOrProgram The parser or program to generate documentation from.
  * @param options The man page generation options.
  * @returns A promise that resolves to the complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
  * @since 0.10.0
  */
 declare function generateManPageAsync<M extends Mode, T>(program: Program<M, T>, options: GenerateManPageProgramOptions): Promise<string>;
@@ -148,6 +150,7 @@ declare function generateManPageAsync<M extends Mode>(parser: Parser<M, unknown,
  * @param parserOrProgram The parser or program to generate documentation from.
  * @param options The man page generation options.
  * @returns The complete man page in roff format, or a Promise for async parsers.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
  * @since 0.10.0
  */
 declare function generateManPage<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;

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-CdDVvD4r.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-DZnf5j1D.js";
 
 export { escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/package.json

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