@optique/man 0.10.7 → 1.0.0-dev.1116

package/README.md

@@ -26,12 +26,18 @@ Quick start
 
 ~~~~ typescript
 import { generateManPage } from "@optique/man";
-import { object, option, argument } from "@optique/core/primitives";
+import { object } from "@optique/core/constructs";
+import { option } from "@optique/core/primitives";
 import { string, integer } from "@optique/core/valueparser";
+import { message } from "@optique/core/message";
 
 const parser = object({
-  port: option("-p", "--port", integer(), { description: "Port to listen on" }),
-  host: option("-h", "--host", string(), { description: "Host to bind to" }),
+  port: option("-p", "--port", integer(), {
+    description: message`Port to listen on`,
+  }),
+  host: option("-h", "--host", string(), {
+    description: message`Host to bind to`,
+  }),
 });
 
 const manPage = generateManPage(parser, {
@@ -66,8 +72,11 @@ formatMessageAsRoff(msg);  // "Use \\fB\\-\\-help\\fR for more info."
 
 ~~~~ typescript
 import { formatDocPageAsMan } from "@optique/man/man";
+import { message } from "@optique/core/message";
 import type { DocPage } from "@optique/core/doc";
 
+declare const docPage: DocPage;
+
 const manPage = formatDocPageAsMan(docPage, {
   name: "myapp",
   section: 1,

package/dist/cli.cjs

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
-const require_generator = require('./generator-zoVk04OH.cjs');
-require('./roff-EpcecLXU.cjs');
-require('./man-DGnow1Jr.cjs');
-const __optique_core_constructs = require_generator.__toESM(require("@optique/core/constructs"));
-const __optique_core_primitives = require_generator.__toESM(require("@optique/core/primitives"));
-const __optique_core_valueparser = require_generator.__toESM(require("@optique/core/valueparser"));
-const __optique_core_modifiers = require_generator.__toESM(require("@optique/core/modifiers"));
-const __optique_core_message = require_generator.__toESM(require("@optique/core/message"));
-const __optique_core_program = require_generator.__toESM(require("@optique/core/program"));
-const __optique_run = require_generator.__toESM(require("@optique/run"));
-const node_fs = require_generator.__toESM(require("node:fs"));
-const node_fs_promises = require_generator.__toESM(require("node:fs/promises"));
-const node_path = require_generator.__toESM(require("node:path"));
-const node_process = require_generator.__toESM(require("node:process"));
-const node_url = require_generator.__toESM(require("node:url"));
+const require_man = require('./man-CkvscTlM.cjs');
+require('./roff-DJ-LkRXl.cjs');
+const require_generator = require('./generator-RyVL5b_V.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"));
+const __optique_core_modifiers = require_man.__toESM(require("@optique/core/modifiers"));
+const __optique_core_message = require_man.__toESM(require("@optique/core/message"));
+const __optique_core_program = require_man.__toESM(require("@optique/core/program"));
+const __optique_run = require_man.__toESM(require("@optique/run"));
+const node_fs = require_man.__toESM(require("node:fs"));
+const node_fs_promises = require_man.__toESM(require("node:fs/promises"));
+const node_path = require_man.__toESM(require("node:path"));
+const node_process = require_man.__toESM(require("node:process"));
+const node_url = require_man.__toESM(require("node:url"));
 
 //#region deno.json
 var name = "@optique/man";
-var version = "0.10.7";
+var version = "1.0.0-dev.1116+6084dd3a";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",
@@ -56,6 +56,7 @@ var deno_default = {
 
 //#endregion
 //#region src/cli.ts
+const jsxTsxPattern = /\.[mc]?[jt]sx$/;
 const EXIT_FILE_NOT_FOUND = 1;
 const EXIT_EXPORT_NOT_FOUND = 2;
 const EXIT_NOT_PROGRAM_OR_PARSER = 3;
@@ -89,15 +90,31 @@ a ${(0, __optique_core_message.metavar)("PROGRAM")} (from ${(0, __optique_core_m
 a ${(0, __optique_core_message.metavar)("PARSER")}. If not specified, the default export is used.` }), "default"),
 		output: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("-o", "--output", (0, __optique_core_valueparser.string)({ metavar: "PATH" }), { description: __optique_core_message.message`Output file path. If not specified, the man page
 is written to stdout.` })),
-		name: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--name", (0, __optique_core_valueparser.string)({ metavar: "NAME" }), { description: __optique_core_message.message`Program name to use in the man page header.
+		name: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--name", (0, __optique_core_valueparser.string)({
+			metavar: "NAME",
+			pattern: /.+/,
+			errors: { patternMismatch: __optique_core_message.message`Program name must not be empty.` }
+		}), { description: __optique_core_message.message`Program name to use in the man page header.
 If not specified, inferred from the ${(0, __optique_core_message.metavar)("PROGRAM")} metadata
 or the input file name.` })),
-		date: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--date", (0, __optique_core_valueparser.string)({ metavar: "DATE" }), { description: __optique_core_message.message`Date to display in the man page footer.
+		date: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--date", (0, __optique_core_valueparser.string)({
+			metavar: "DATE",
+			pattern: /.+/,
+			errors: { patternMismatch: __optique_core_message.message`Date must not be empty.` }
+		}), { description: __optique_core_message.message`Date to display in the man page footer.
 Defaults to the current date.` })),
-		versionString: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--version-string", (0, __optique_core_valueparser.string)({ metavar: "VERSION" }), { description: __optique_core_message.message`Version string for the man page footer
+		versionString: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--version-string", (0, __optique_core_valueparser.string)({
+			metavar: "VERSION",
+			pattern: /.+/,
+			errors: { patternMismatch: __optique_core_message.message`Version string must not be empty.` }
+		}), { description: __optique_core_message.message`Version string for the man page footer
 (e.g., ${"MyApp 1.0.0"}). Overrides the version from
 ${(0, __optique_core_message.metavar)("PROGRAM")} metadata if provided.` })),
-		manual: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--manual", (0, __optique_core_valueparser.string)({ metavar: "TITLE" }), { description: __optique_core_message.message`Manual name for the man page header
+		manual: (0, __optique_core_modifiers.optional)((0, __optique_core_primitives.option)("--manual", (0, __optique_core_valueparser.string)({
+			metavar: "TITLE",
+			pattern: /.+/,
+			errors: { patternMismatch: __optique_core_message.message`Manual name must not be empty.` }
+		}), { description: __optique_core_message.message`Manual name for the man page header
 (e.g., ${"User Commands"}).` }))
 	}),
 	metadata: {
@@ -187,7 +204,7 @@ an Optique parser (e.g., from ${(0, __optique_core_message.commandLine)("object(
 ${(0, __optique_core_message.commandLine)("command()")}, etc.).`, { exitCode: EXIT_NOT_PROGRAM_OR_PARSER });
 }
 /**
-* Error handler for missing tsx.
+* Error handler for missing tsx for TypeScript files.
 */
 function tsxRequiredError(filePath) {
 	const version$1 = getNodeMajorMinor();
@@ -200,6 +217,22 @@ Install tsx as a dev dependency:
 
 Or upgrade to Node.js 25.2.0 or later, which supports TypeScript natively.
 
+Alternatively, use a pre-compiled JavaScript file instead.`, { exitCode: EXIT_TSX_REQUIRED });
+}
+/**
+* Error handler for missing tsx for JSX/TSX files.
+*/
+function jsxLoaderRequiredError(filePath) {
+	const version$1 = getNodeMajorMinor();
+	const versionStr = version$1 ? `${version$1[0]}.${version$1[1]}` : "unknown";
+	const isTsx = /\.[mc]?tsx$/.test(filePath);
+	const fileKind = isTsx ? "TSX" : "JSX";
+	(0, __optique_run.printError)(__optique_core_message.message`${fileKind} file ${filePath} cannot be loaded on Node.js ${versionStr}.
+
+Install tsx as a dev dependency:
+
+  ${(0, __optique_core_message.commandLine)("npm install -D tsx")}
+
 Alternatively, use a pre-compiled JavaScript file instead.`, { exitCode: EXIT_TSX_REQUIRED });
 }
 /**
@@ -218,34 +251,100 @@ Make sure you have write permission and the parent directory exists.`, { exitCod
 }
 /**
 * Imports a module from the given file path.
-* Handles TypeScript files on Node.js by using tsx if needed.
+* Handles TypeScript and JSX files on Node.js by using tsx if needed.
+* @param filePath The path to the module file.
+* @returns The imported module's exports.
+* @throws If the module fails to import for reasons other than a missing
+*         tsx loader (which causes the process to exit instead).
 */
 async function importModule(filePath) {
 	const absolutePath = (0, node_path.resolve)(filePath);
 	if (!(0, node_fs.existsSync)(absolutePath)) fileNotFoundError(filePath);
-	const isTypeScript = /\.[mc]?ts$/.test(filePath);
-	const isDeno = typeof globalThis.Deno !== "undefined";
-	const isBun = typeof globalThis.Bun !== "undefined";
-	if (!isDeno && !isBun && isTypeScript && !nodeSupportsNativeTypeScript()) try {
+	const isPlainTs = /\.[mc]?ts$/.test(filePath);
+	const isJsxOrTsx = jsxTsxPattern.test(filePath);
+	const isDeno = "Deno" in globalThis;
+	const isBun = "Bun" in globalThis;
+	if (!isDeno && !isBun && (isJsxOrTsx || isPlainTs && !nodeSupportsNativeTypeScript())) await registerTsx(filePath, isJsxOrTsx);
+	else if (!isDeno && !isBun) await tryRegisterTsx();
+	const fileUrl = (0, node_url.pathToFileURL)(absolutePath).href;
+	try {
+		return await import(fileUrl);
+	} catch (error) {
+		if (!isDeno && !isBun && isNodeError(error) && error.code === "ERR_UNKNOWN_FILE_EXTENSION") {
+			const failedPath = extractPathFromExtensionError(error.message);
+			if (failedPath != null && jsxTsxPattern.test(failedPath)) jsxLoaderRequiredError(failedPath);
+		}
+		throw error;
+	}
+}
+/**
+* Checks whether an error is a Node.js system error with a string `code`.
+* @param error The value to check.
+* @returns `true` if the error has a string `code` property.
+*/
+function isNodeError(error) {
+	return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+/**
+* Extracts the file path from a Node.js `ERR_UNKNOWN_FILE_EXTENSION` error
+* message, which has the format `Unknown file extension ".ext" for /path`.
+* @param message The error message string.
+* @returns The file path, or null if the message format is unexpected.
+*/
+function extractPathFromExtensionError(message$1) {
+	const match = /^Unknown file extension "\.[^"]*" for (.+)$/.exec(message$1);
+	return match?.[1] ?? null;
+}
+/**
+* Registers the tsx loader for TypeScript/JSX/TSX support on Node.js.
+* @param filePath The file path being loaded (used for error messages).
+* @param isJsxOrTsx Whether the file uses a JSX or TSX extension.
+*/
+async function registerTsx(filePath, isJsxOrTsx) {
+	try {
 		const tsx = await import("tsx/esm/api");
 		tsx.register();
-	} catch {
-		tsxRequiredError(filePath);
+	} catch (error) {
+		if (!isNodeError(error) || error.code !== "ERR_MODULE_NOT_FOUND") throw error;
+		if (isJsxOrTsx) jsxLoaderRequiredError(filePath);
+		else tsxRequiredError(filePath);
 	}
-	const fileUrl = (0, node_url.pathToFileURL)(absolutePath).href;
-	return await import(fileUrl);
+}
+/**
+* Tries to register the tsx loader, silently ignoring all failures.
+* Used on Node.js for entries that may have transitive JSX/TSX dependencies.
+*
+* All errors are suppressed because this is a best-effort preload: the
+* entry file itself does not require tsx, and failing here would be a
+* regression for environments where tsx is absent, incompatible, or
+* broken.  If a transitive JSX/TSX dependency is later encountered
+* without a loader, the caller's catch block produces a helpful error.
+*/
+async function tryRegisterTsx() {
+	try {
+		const tsx = await import("tsx/esm/api");
+		tsx.register();
+	} catch {}
 }
 /**
 * Checks if a value is a Program object.
 */
 function isProgram(value) {
-	return value != null && typeof value === "object" && "parser" in value && "metadata" in value && typeof value.metadata === "object" && value.metadata != null;
+	try {
+		return value != null && typeof value === "object" && "parser" in value && "metadata" in value && typeof value.metadata === "object" && value.metadata != null && typeof value.metadata.name === "string" && isParser(value.parser);
+	} catch {
+		return false;
+	}
 }
 /**
 * Checks if a value is a Parser object.
 */
 function isParser(value) {
-	return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "$mode" in value && "usage" in value;
+	try {
+		return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "$mode" in value && "usage" in value && "getDocFragments" in value && typeof value.getDocFragments === "function";
+	} catch {
+		return false;
+	}
 }
 /**
 * Infers the program name from a file path.
@@ -253,7 +352,7 @@ function isParser(value) {
 function inferNameFromPath(filePath) {
 	const base = (0, node_path.basename)(filePath);
 	const ext = (0, node_path.extname)(base);
-	return base.slice(0, -ext.length);
+	return ext.length > 0 ? base.slice(0, -ext.length) : base;
 }
 /**
 * Gets available exports from a module.
@@ -278,7 +377,7 @@ async function main() {
 		help: "option",
 		version: {
 			value: deno_default.version,
-			mode: "option"
+			option: true
 		}
 	});
 	const mod = await importModule(args.file);
@@ -286,19 +385,20 @@ async function main() {
 	if (target === void 0) exportNotFoundError(args.file, args.exportName, getAvailableExports(mod));
 	if (!isProgram(target) && !isParser(target)) notProgramOrParserError(args.file, args.exportName, describeType(target));
 	const name$1 = args.name ?? (isProgram(target) ? target.metadata.name : null) ?? inferNameFromPath(args.file);
+	const date = args.date ?? /* @__PURE__ */ new Date();
 	let manPage;
 	try {
 		if (isProgram(target)) manPage = await require_generator.generateManPageAsync(target, {
 			section: args.section,
 			name: args.name,
-			date: args.date,
+			date,
 			version: args.versionString,
 			manual: args.manual
 		});
 		else manPage = await require_generator.generateManPageAsync(target, {
 			name: name$1,
 			section: args.section,
-			date: args.date,
+			date,
 			version: args.versionString,
 			manual: args.manual
 		});

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "./roff-C_MiRXVS.js";
-import "./man-Leuf7kOn.js";
-import { generateManPageAsync } from "./generator-CCa36YC2.js";
+import "./roff-CCdIQO7B.js";
+import "./man-BE1OY_lJ.js";
+import { generateManPageAsync } from "./generator-YM0drazb.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 = "0.10.7";
+var version = "1.0.0-dev.1116+6084dd3a";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",
@@ -56,6 +56,7 @@ var deno_default = {
 
 //#endregion
 //#region src/cli.ts
+const jsxTsxPattern = /\.[mc]?[jt]sx$/;
 const EXIT_FILE_NOT_FOUND = 1;
 const EXIT_EXPORT_NOT_FOUND = 2;
 const EXIT_NOT_PROGRAM_OR_PARSER = 3;
@@ -89,15 +90,31 @@ a ${metavar("PROGRAM")} (from ${commandLine("defineProgram()")}) or
 a ${metavar("PARSER")}. If not specified, the default export is used.` }), "default"),
 		output: optional(option("-o", "--output", string({ metavar: "PATH" }), { description: message`Output file path. If not specified, the man page
 is written to stdout.` })),
-		name: optional(option("--name", string({ metavar: "NAME" }), { description: message`Program name to use in the man page header.
+		name: optional(option("--name", string({
+			metavar: "NAME",
+			pattern: /.+/,
+			errors: { patternMismatch: message`Program name must not be empty.` }
+		}), { description: message`Program name to use in the man page header.
 If not specified, inferred from the ${metavar("PROGRAM")} metadata
 or the input file name.` })),
-		date: optional(option("--date", string({ metavar: "DATE" }), { description: message`Date to display in the man page footer.
+		date: optional(option("--date", string({
+			metavar: "DATE",
+			pattern: /.+/,
+			errors: { patternMismatch: message`Date must not be empty.` }
+		}), { description: message`Date to display in the man page footer.
 Defaults to the current date.` })),
-		versionString: optional(option("--version-string", string({ metavar: "VERSION" }), { description: message`Version string for the man page footer
+		versionString: optional(option("--version-string", string({
+			metavar: "VERSION",
+			pattern: /.+/,
+			errors: { patternMismatch: message`Version string must not be empty.` }
+		}), { description: message`Version string for the man page footer
 (e.g., ${"MyApp 1.0.0"}). Overrides the version from
 ${metavar("PROGRAM")} metadata if provided.` })),
-		manual: optional(option("--manual", string({ metavar: "TITLE" }), { description: message`Manual name for the man page header
+		manual: optional(option("--manual", string({
+			metavar: "TITLE",
+			pattern: /.+/,
+			errors: { patternMismatch: message`Manual name must not be empty.` }
+		}), { description: message`Manual name for the man page header
 (e.g., ${"User Commands"}).` }))
 	}),
 	metadata: {
@@ -187,7 +204,7 @@ an Optique parser (e.g., from ${commandLine("object()")},
 ${commandLine("command()")}, etc.).`, { exitCode: EXIT_NOT_PROGRAM_OR_PARSER });
 }
 /**
-* Error handler for missing tsx.
+* Error handler for missing tsx for TypeScript files.
 */
 function tsxRequiredError(filePath) {
 	const version$1 = getNodeMajorMinor();
@@ -200,6 +217,22 @@ Install tsx as a dev dependency:
 
 Or upgrade to Node.js 25.2.0 or later, which supports TypeScript natively.
 
+Alternatively, use a pre-compiled JavaScript file instead.`, { exitCode: EXIT_TSX_REQUIRED });
+}
+/**
+* Error handler for missing tsx for JSX/TSX files.
+*/
+function jsxLoaderRequiredError(filePath) {
+	const version$1 = getNodeMajorMinor();
+	const versionStr = version$1 ? `${version$1[0]}.${version$1[1]}` : "unknown";
+	const isTsx = /\.[mc]?tsx$/.test(filePath);
+	const fileKind = isTsx ? "TSX" : "JSX";
+	printError(message`${fileKind} file ${filePath} cannot be loaded on Node.js ${versionStr}.
+
+Install tsx as a dev dependency:
+
+  ${commandLine("npm install -D tsx")}
+
 Alternatively, use a pre-compiled JavaScript file instead.`, { exitCode: EXIT_TSX_REQUIRED });
 }
 /**
@@ -218,34 +251,100 @@ Make sure you have write permission and the parent directory exists.`, { exitCod
 }
 /**
 * Imports a module from the given file path.
-* Handles TypeScript files on Node.js by using tsx if needed.
+* Handles TypeScript and JSX files on Node.js by using tsx if needed.
+* @param filePath The path to the module file.
+* @returns The imported module's exports.
+* @throws If the module fails to import for reasons other than a missing
+*         tsx loader (which causes the process to exit instead).
 */
 async function importModule(filePath) {
 	const absolutePath = resolve(filePath);
 	if (!existsSync(absolutePath)) fileNotFoundError(filePath);
-	const isTypeScript = /\.[mc]?ts$/.test(filePath);
-	const isDeno = typeof globalThis.Deno !== "undefined";
-	const isBun = typeof globalThis.Bun !== "undefined";
-	if (!isDeno && !isBun && isTypeScript && !nodeSupportsNativeTypeScript()) try {
+	const isPlainTs = /\.[mc]?ts$/.test(filePath);
+	const isJsxOrTsx = jsxTsxPattern.test(filePath);
+	const isDeno = "Deno" in globalThis;
+	const isBun = "Bun" in globalThis;
+	if (!isDeno && !isBun && (isJsxOrTsx || isPlainTs && !nodeSupportsNativeTypeScript())) await registerTsx(filePath, isJsxOrTsx);
+	else if (!isDeno && !isBun) await tryRegisterTsx();
+	const fileUrl = pathToFileURL(absolutePath).href;
+	try {
+		return await import(fileUrl);
+	} catch (error) {
+		if (!isDeno && !isBun && isNodeError(error) && error.code === "ERR_UNKNOWN_FILE_EXTENSION") {
+			const failedPath = extractPathFromExtensionError(error.message);
+			if (failedPath != null && jsxTsxPattern.test(failedPath)) jsxLoaderRequiredError(failedPath);
+		}
+		throw error;
+	}
+}
+/**
+* Checks whether an error is a Node.js system error with a string `code`.
+* @param error The value to check.
+* @returns `true` if the error has a string `code` property.
+*/
+function isNodeError(error) {
+	return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+/**
+* Extracts the file path from a Node.js `ERR_UNKNOWN_FILE_EXTENSION` error
+* message, which has the format `Unknown file extension ".ext" for /path`.
+* @param message The error message string.
+* @returns The file path, or null if the message format is unexpected.
+*/
+function extractPathFromExtensionError(message$1) {
+	const match = /^Unknown file extension "\.[^"]*" for (.+)$/.exec(message$1);
+	return match?.[1] ?? null;
+}
+/**
+* Registers the tsx loader for TypeScript/JSX/TSX support on Node.js.
+* @param filePath The file path being loaded (used for error messages).
+* @param isJsxOrTsx Whether the file uses a JSX or TSX extension.
+*/
+async function registerTsx(filePath, isJsxOrTsx) {
+	try {
 		const tsx = await import("tsx/esm/api");
 		tsx.register();
-	} catch {
-		tsxRequiredError(filePath);
+	} catch (error) {
+		if (!isNodeError(error) || error.code !== "ERR_MODULE_NOT_FOUND") throw error;
+		if (isJsxOrTsx) jsxLoaderRequiredError(filePath);
+		else tsxRequiredError(filePath);
 	}
-	const fileUrl = pathToFileURL(absolutePath).href;
-	return await import(fileUrl);
+}
+/**
+* Tries to register the tsx loader, silently ignoring all failures.
+* Used on Node.js for entries that may have transitive JSX/TSX dependencies.
+*
+* All errors are suppressed because this is a best-effort preload: the
+* entry file itself does not require tsx, and failing here would be a
+* regression for environments where tsx is absent, incompatible, or
+* broken.  If a transitive JSX/TSX dependency is later encountered
+* without a loader, the caller's catch block produces a helpful error.
+*/
+async function tryRegisterTsx() {
+	try {
+		const tsx = await import("tsx/esm/api");
+		tsx.register();
+	} catch {}
 }
 /**
 * Checks if a value is a Program object.
 */
 function isProgram(value) {
-	return value != null && typeof value === "object" && "parser" in value && "metadata" in value && typeof value.metadata === "object" && value.metadata != null;
+	try {
+		return value != null && typeof value === "object" && "parser" in value && "metadata" in value && typeof value.metadata === "object" && value.metadata != null && typeof value.metadata.name === "string" && isParser(value.parser);
+	} catch {
+		return false;
+	}
 }
 /**
 * Checks if a value is a Parser object.
 */
 function isParser(value) {
-	return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "$mode" in value && "usage" in value;
+	try {
+		return value != null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "$mode" in value && "usage" in value && "getDocFragments" in value && typeof value.getDocFragments === "function";
+	} catch {
+		return false;
+	}
 }
 /**
 * Infers the program name from a file path.
@@ -253,7 +352,7 @@ function isParser(value) {
 function inferNameFromPath(filePath) {
 	const base = basename(filePath);
 	const ext = extname(base);
-	return base.slice(0, -ext.length);
+	return ext.length > 0 ? base.slice(0, -ext.length) : base;
 }
 /**
 * Gets available exports from a module.
@@ -278,7 +377,7 @@ async function main() {
 		help: "option",
 		version: {
 			value: deno_default.version,
-			mode: "option"
+			option: true
 		}
 	});
 	const mod = await importModule(args.file);
@@ -286,19 +385,20 @@ async function main() {
 	if (target === void 0) exportNotFoundError(args.file, args.exportName, getAvailableExports(mod));
 	if (!isProgram(target) && !isParser(target)) notProgramOrParserError(args.file, args.exportName, describeType(target));
 	const name$1 = args.name ?? (isProgram(target) ? target.metadata.name : null) ?? inferNameFromPath(args.file);
+	const date = args.date ?? /* @__PURE__ */ new Date();
 	let manPage;
 	try {
 		if (isProgram(target)) manPage = await generateManPageAsync(target, {
 			section: args.section,
 			name: args.name,
-			date: args.date,
+			date,
 			version: args.versionString,
 			manual: args.manual
 		});
 		else manPage = await generateManPageAsync(target, {
 			name: name$1,
 			section: args.section,
-			date: args.date,
+			date,
 			version: args.versionString,
 			manual: args.manual
 		});

package/dist/{generator-zoVk04OH.cjs → generator-RyVL5b_V.cjs}

@@ -1,41 +1,42 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const require_man = require('./man-DGnow1Jr.cjs');
-const __optique_core_parser = __toESM(require("@optique/core/parser"));
+const require_man = require('./man-CkvscTlM.cjs');
+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 {
@@ -49,6 +50,9 @@ function extractParserAndOptions(parserOrProgram, options) {
 				author: programOptions.author ?? metadata.author,
 				bugs: programOptions.bugs ?? metadata.bugs,
 				examples: programOptions.examples ?? metadata.examples,
+				brief: programOptions.brief ?? metadata.brief,
+				description: programOptions.description ?? metadata.description,
+				footer: programOptions.footer ?? metadata.footer,
 				seeAlso: programOptions.seeAlso,
 				environment: programOptions.environment,
 				files: programOptions.files,
@@ -56,6 +60,7 @@ function extractParserAndOptions(parserOrProgram, options) {
 			}
 		};
 	}
+	validateParser(parserOrProgram);
 	return {
 		parser: parserOrProgram,
 		mergedOptions: options
@@ -63,6 +68,7 @@ function extractParserAndOptions(parserOrProgram, options) {
 }
 function generateManPageSync(parserOrProgram, options) {
 	const { parser, mergedOptions } = extractParserAndOptions(parserOrProgram, options);
+	if (parser.$mode === "async") throw new TypeError("Cannot use an async parser with generateManPageSync(). Use generateManPageAsync() or generateManPage() instead.");
 	const docPage = (0, __optique_core_parser.getDocPageSync)(parser) ?? { sections: [] };
 	return require_man.formatDocPageAsMan(docPage, mergedOptions);
 }
@@ -78,12 +84,6 @@ function generateManPage(parserOrProgram, options) {
 }
 
 //#endregion
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
 Object.defineProperty(exports, 'generateManPage', {
   enumerable: true,
   get: function () {