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

package/dist/cli.cjs

@@ -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.771+55c12309";
+var version = "1.0.0-dev.783+64de3665";
 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;
@@ -203,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();
@@ -216,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 });
 }
 /**
@@ -234,22 +251,80 @@ 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 isPlainTs = /\.[mc]?ts$/.test(filePath);
+	const isJsxOrTsx = jsxTsxPattern.test(filePath);
 	const isDeno = "Deno" in globalThis;
 	const isBun = "Bun" in globalThis;
-	if (!isDeno && !isBun && isTypeScript && !nodeSupportsNativeTypeScript()) try {
+	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.

package/dist/cli.js

@@ -17,7 +17,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 //#region deno.json
 var name = "@optique/man";
-var version = "1.0.0-dev.771+55c12309";
+var version = "1.0.0-dev.783+64de3665";
 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;
@@ -203,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();
@@ -216,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 });
 }
 /**
@@ -234,22 +251,80 @@ 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 isPlainTs = /\.[mc]?ts$/.test(filePath);
+	const isJsxOrTsx = jsxTsxPattern.test(filePath);
 	const isDeno = "Deno" in globalThis;
 	const isBun = "Bun" in globalThis;
-	if (!isDeno && !isBun && isTypeScript && !nodeSupportsNativeTypeScript()) try {
+	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.

package/package.json

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