@optique/core 0.3.0-dev.41 → 0.3.0-dev.43

package/dist/facade.cjs

@@ -35,56 +35,259 @@ const require_parser = require('./parser.cjs');
 * @throws {RunError} When parsing fails and no `onError` callback is provided.
 */
 function run(parser, programName, args, options = {}) {
-	let { colors, maxWidth, help = "none", onHelp = () => {}, aboveError = "usage", onError = () => {
+	const helpMode = options.help?.mode ?? "option";
+	const onHelp = options.help?.onShow ?? (() => ({}));
+	const versionMode = options.version?.mode ?? "option";
+	const versionValue = options.version?.value ?? "";
+	const onVersion = options.version?.onShow ?? (() => ({}));
+	let { colors, maxWidth, aboveError = "usage", onError = () => {
 		throw new RunError("Failed to parse command line arguments.");
 	}, stderr = console.error, stdout = console.log } = options;
+	const help = options.help ? helpMode : "none";
 	const contextualHelpParser = require_parser.object({
 		help: require_parser.constant(true),
-		commands: require_parser.multiple(require_parser.argument(require_valueparser.string({ metavar: "COMMAND" }))),
+		version: require_parser.constant(false),
+		commands: require_parser.multiple(require_parser.argument(require_valueparser.string({
+			metavar: "COMMAND",
+			pattern: /^[^-].*$/
+		}))),
 		__help: require_parser.flag("--help")
 	});
 	const helpCommand = require_parser.command("help", require_parser.multiple(require_parser.argument(require_valueparser.string({ metavar: "COMMAND" }))), { description: require_message.message`Show help information.` });
 	const helpOption = require_parser.option("--help", { description: require_message.message`Show help information.` });
-	const augmentedParser = help === "none" ? parser : help === "command" ? require_parser.longestMatch(require_parser.object({
+	const version = options.version ? versionMode : "none";
+	const versionCommand = require_parser.command("version", require_parser.object({}), { description: require_message.message`Show version information.` });
+	const versionOption = require_parser.option("--version", { description: require_message.message`Show version information.` });
+	const augmentedParser = help === "none" && version === "none" ? parser : help === "none" && version === "command" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	})) : help === "none" && version === "option" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption)) : help === "none" && version === "both" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption)) : help === "command" && version === "none" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: helpCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	})) : help === "command" && version === "command" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: helpCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	})) : help === "command" && version === "option" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(true),
+		version: require_parser.constant(false),
 		commands: helpCommand
 	}), require_parser.object({
 		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption)) : help === "command" && version === "both" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: helpCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption)) : help === "option" && version === "none" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
 		result: parser
-	})) : help === "option" ? require_parser.longestMatch(require_parser.object({
+	}), contextualHelpParser, require_parser.merge(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: require_parser.constant([])
+	}), helpOption)) : help === "option" && version === "command" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
 		result: parser
 	}), contextualHelpParser, require_parser.merge(require_parser.object({
 		help: require_parser.constant(true),
+		version: require_parser.constant(false),
 		commands: require_parser.constant([])
-	}), helpOption)) : require_parser.longestMatch(require_parser.object({
+	}), helpOption)) : help === "option" && version === "option" ? require_parser.longestMatch(require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption), require_parser.object({
 		help: require_parser.constant(false),
+		version: require_parser.constant(false),
 		result: parser
+	}), contextualHelpParser, require_parser.merge(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: require_parser.constant([])
+	}), helpOption)) : help === "option" && version === "both" ? require_parser.longestMatch(require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
 	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), contextualHelpParser, require_parser.merge(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: require_parser.constant([])
+	}), helpOption)) : help === "both" && version === "none" ? require_parser.longestMatch(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: helpCommand
+	}), contextualHelpParser, require_parser.merge(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: require_parser.constant([])
+	}), helpOption)) : help === "both" && version === "command" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(true),
+		version: require_parser.constant(false),
 		commands: helpCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
 	}), contextualHelpParser, require_parser.merge(require_parser.object({
 		help: require_parser.constant(true),
+		version: require_parser.constant(false),
 		commands: require_parser.constant([])
-	}), helpOption));
-	const result = require_parser.parse(augmentedParser, args);
+	}), helpOption)) : help === "both" && version === "option" ? require_parser.longestMatch(require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption), require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: helpCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), contextualHelpParser, require_parser.merge(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: require_parser.constant([])
+	}), helpOption)) : require_parser.longestMatch(require_parser.merge(require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true)
+	}), versionOption), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(true),
+		result: versionCommand
+	}), require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: helpCommand
+	}), require_parser.object({
+		help: require_parser.constant(false),
+		version: require_parser.constant(false),
+		result: parser
+	}), require_parser.longestMatch(contextualHelpParser, require_parser.merge(require_parser.object({
+		help: require_parser.constant(true),
+		version: require_parser.constant(false),
+		commands: require_parser.constant([])
+	}), helpOption)));
+	let result = require_parser.parse(augmentedParser, args);
+	if (result.success && typeof result.value === "object" && result.value != null && "help" in result.value && "version" in result.value) {
+		const parsedValue = result.value;
+		const hasVersionInput = args.includes("--version") || args.length > 0 && args[0] === "version";
+		const hasHelpInput = args.includes("--help") || args.length > 0 && args[0] === "help";
+		if (parsedValue.version && !hasVersionInput || parsedValue.help && !hasHelpInput && !parsedValue.result) result = require_parser.parse(parser, args);
+	}
 	if (result.success) {
 		const value = result.value;
-		if (help === "none") return value;
-		if (typeof value === "object" && value != null && "help" in value) {
-			const helpValue$1 = value;
-			if (!helpValue$1.help) return helpValue$1.result;
+		if (help === "none" && version === "none") return value;
+		if (typeof value === "object" && value != null && "help" in value && "version" in value) {
+			const parsedValue = value;
+			if (parsedValue.version) {
+				const hasVersionOption = args.includes("--version");
+				const hasVersionCommand = args.length > 0 && args[0] === "version";
+				if (hasVersionOption || hasVersionCommand) {
+					stdout(versionValue);
+					try {
+						return onVersion(0);
+					} catch {
+						return onVersion();
+					}
+				}
+			}
+			if (parsedValue.help) {
+				if (version !== "none" && args.includes("--version")) {
+					stdout(versionValue);
+					try {
+						return onVersion(0);
+					} catch {
+						return onVersion();
+					}
+				}
+				let commandContext = [];
+				if (Array.isArray(parsedValue.commands)) commandContext = parsedValue.commands;
+				else if (typeof parsedValue.commands === "object" && parsedValue.commands != null && "length" in parsedValue.commands) commandContext = parsedValue.commands;
+				const doc = require_parser.getDocPage(commandContext.length < 1 ? augmentedParser : parser, commandContext);
+				if (doc != null) stdout(require_doc.formatDocPage(programName, doc, {
+					colors,
+					maxWidth
+				}));
+				try {
+					return onHelp(0);
+				} catch {
+					return onHelp();
+				}
+			}
+			return parsedValue.result ?? value;
 		} else return value;
-		let commandContext = [];
-		const helpValue = value;
-		if (Array.isArray(helpValue.commands)) commandContext = helpValue.commands;
-		else if (typeof helpValue.commands === "object" && helpValue.commands != null && "length" in helpValue.commands) commandContext = helpValue.commands;
-		const doc = require_parser.getDocPage(commandContext.length < 1 ? augmentedParser : parser, commandContext);
-		if (doc != null) stdout(require_doc.formatDocPage(programName, doc, {
-			colors,
-			maxWidth
-		}));
-		return onHelp(0);
 	}
 	if (aboveError === "help") {
 		const doc = require_parser.getDocPage(args.length < 1 ? augmentedParser : parser, args);

package/dist/facade.d.cts

@@ -21,26 +21,59 @@ interface RunOptions<THelp, TError> {
    */
   readonly maxWidth?: number;
   /**
-   * Determines how help is made available:
-   *
-   * - `"command"`: Only the `help` subcommand is available
-   * - `"option"`: Only the `--help` option is available
-   * - `"both"`: Both `help` subcommand and `--help` option are available
-   * - `"none"`: No help functionality is provided
-   *
-   * @default `"none"`
+   * Help configuration. When provided, enables help functionality.
    */
-  readonly help?: "command" | "option" | "both" | "none";
+  readonly help?: {
+    /**
+     * Determines how help is made available:
+     *
+     * - `"command"`: Only the `help` subcommand is available
+     * - `"option"`: Only the `--help` option is available
+     * - `"both"`: Both `help` subcommand and `--help` option are available
+     *
+     * @default `"option"`
+     */
+    readonly mode?: "command" | "option" | "both";
+    /**
+     * Callback function invoked when help is requested. The function can
+     * optionally receive an exit code parameter.
+     *
+     * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
+     * on Deno to this option.
+     *
+     * @default Returns `void` when help is shown.
+     */
+    readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
+  };
   /**
-   * Callback function invoked when help is requested. The function can
-   * optionally receive an exit code parameter.
-   *
-   * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
-   * on Deno to this option.
-   *
-   * @default Returns `void` when help is shown.
+   * Version configuration. When provided, enables version functionality.
    */
-  readonly onHelp?: (() => THelp) | ((exitCode: number) => THelp);
+  readonly version?: {
+    /**
+     * Determines how version is made available:
+     *
+     * - `"command"`: Only the `version` subcommand is available
+     * - `"option"`: Only the `--version` option is available
+     * - `"both"`: Both `version` subcommand and `--version` option are available
+     *
+     * @default `"option"`
+     */
+    readonly mode?: "command" | "option" | "both";
+    /**
+     * The version string to display when version is requested.
+     */
+    readonly value: string;
+    /**
+     * Callback function invoked when version is requested. The function can
+     * optionally receive an exit code parameter.
+     *
+     * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
+     * on Deno to this option.
+     *
+     * @default Returns `void` when version is shown.
+     */
+    readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
+  };
   /**
    * What to display above error messages:
    * - `"usage"`: Show usage information

package/dist/facade.d.ts

@@ -21,26 +21,59 @@ interface RunOptions<THelp, TError> {
    */
   readonly maxWidth?: number;
   /**
-   * Determines how help is made available:
-   *
-   * - `"command"`: Only the `help` subcommand is available
-   * - `"option"`: Only the `--help` option is available
-   * - `"both"`: Both `help` subcommand and `--help` option are available
-   * - `"none"`: No help functionality is provided
-   *
-   * @default `"none"`
+   * Help configuration. When provided, enables help functionality.
    */
-  readonly help?: "command" | "option" | "both" | "none";
+  readonly help?: {
+    /**
+     * Determines how help is made available:
+     *
+     * - `"command"`: Only the `help` subcommand is available
+     * - `"option"`: Only the `--help` option is available
+     * - `"both"`: Both `help` subcommand and `--help` option are available
+     *
+     * @default `"option"`
+     */
+    readonly mode?: "command" | "option" | "both";
+    /**
+     * Callback function invoked when help is requested. The function can
+     * optionally receive an exit code parameter.
+     *
+     * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
+     * on Deno to this option.
+     *
+     * @default Returns `void` when help is shown.
+     */
+    readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
+  };
   /**
-   * Callback function invoked when help is requested. The function can
-   * optionally receive an exit code parameter.
-   *
-   * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
-   * on Deno to this option.
-   *
-   * @default Returns `void` when help is shown.
+   * Version configuration. When provided, enables version functionality.
    */
-  readonly onHelp?: (() => THelp) | ((exitCode: number) => THelp);
+  readonly version?: {
+    /**
+     * Determines how version is made available:
+     *
+     * - `"command"`: Only the `version` subcommand is available
+     * - `"option"`: Only the `--version` option is available
+     * - `"both"`: Both `version` subcommand and `--version` option are available
+     *
+     * @default `"option"`
+     */
+    readonly mode?: "command" | "option" | "both";
+    /**
+     * The version string to display when version is requested.
+     */
+    readonly value: string;
+    /**
+     * Callback function invoked when version is requested. The function can
+     * optionally receive an exit code parameter.
+     *
+     * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
+     * on Deno to this option.
+     *
+     * @default Returns `void` when version is shown.
+     */
+    readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
+  };
   /**
    * What to display above error messages:
    * - `"usage"`: Show usage information

package/dist/facade.js

@@ -35,56 +35,259 @@ import { argument, command, constant, flag, getDocPage, longestMatch, merge, mul
 * @throws {RunError} When parsing fails and no `onError` callback is provided.
 */
 function run(parser, programName, args, options = {}) {
-	let { colors, maxWidth, help = "none", onHelp = () => {}, aboveError = "usage", onError = () => {
+	const helpMode = options.help?.mode ?? "option";
+	const onHelp = options.help?.onShow ?? (() => ({}));
+	const versionMode = options.version?.mode ?? "option";
+	const versionValue = options.version?.value ?? "";
+	const onVersion = options.version?.onShow ?? (() => ({}));
+	let { colors, maxWidth, aboveError = "usage", onError = () => {
 		throw new RunError("Failed to parse command line arguments.");
 	}, stderr = console.error, stdout = console.log } = options;
+	const help = options.help ? helpMode : "none";
 	const contextualHelpParser = object({
 		help: constant(true),
-		commands: multiple(argument(string({ metavar: "COMMAND" }))),
+		version: constant(false),
+		commands: multiple(argument(string({
+			metavar: "COMMAND",
+			pattern: /^[^-].*$/
+		}))),
 		__help: flag("--help")
 	});
 	const helpCommand = command("help", multiple(argument(string({ metavar: "COMMAND" }))), { description: message`Show help information.` });
 	const helpOption = option("--help", { description: message`Show help information.` });
-	const augmentedParser = help === "none" ? parser : help === "command" ? longestMatch(object({
+	const version = options.version ? versionMode : "none";
+	const versionCommand = command("version", object({}), { description: message`Show version information.` });
+	const versionOption = option("--version", { description: message`Show version information.` });
+	const augmentedParser = help === "none" && version === "none" ? parser : help === "none" && version === "command" ? longestMatch(object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	})) : help === "none" && version === "option" ? longestMatch(object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption)) : help === "none" && version === "both" ? longestMatch(object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption)) : help === "command" && version === "none" ? longestMatch(object({
+		help: constant(true),
+		version: constant(false),
+		commands: helpCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	})) : help === "command" && version === "command" ? longestMatch(object({
+		help: constant(true),
+		version: constant(false),
+		commands: helpCommand
+	}), object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	})) : help === "command" && version === "option" ? longestMatch(object({
 		help: constant(true),
+		version: constant(false),
 		commands: helpCommand
 	}), object({
 		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption)) : help === "command" && version === "both" ? longestMatch(object({
+		help: constant(true),
+		version: constant(false),
+		commands: helpCommand
+	}), object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption)) : help === "option" && version === "none" ? longestMatch(object({
+		help: constant(false),
+		version: constant(false),
 		result: parser
-	})) : help === "option" ? longestMatch(object({
+	}), contextualHelpParser, merge(object({
+		help: constant(true),
+		version: constant(false),
+		commands: constant([])
+	}), helpOption)) : help === "option" && version === "command" ? longestMatch(object({
 		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
 		result: parser
 	}), contextualHelpParser, merge(object({
 		help: constant(true),
+		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : longestMatch(object({
+	}), helpOption)) : help === "option" && version === "option" ? longestMatch(merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption), object({
 		help: constant(false),
+		version: constant(false),
 		result: parser
+	}), contextualHelpParser, merge(object({
+		help: constant(true),
+		version: constant(false),
+		commands: constant([])
+	}), helpOption)) : help === "option" && version === "both" ? longestMatch(merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption), object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
 	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), contextualHelpParser, merge(object({
+		help: constant(true),
+		version: constant(false),
+		commands: constant([])
+	}), helpOption)) : help === "both" && version === "none" ? longestMatch(object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), object({
+		help: constant(true),
+		version: constant(false),
+		commands: helpCommand
+	}), contextualHelpParser, merge(object({
+		help: constant(true),
+		version: constant(false),
+		commands: constant([])
+	}), helpOption)) : help === "both" && version === "command" ? longestMatch(object({
 		help: constant(true),
+		version: constant(false),
 		commands: helpCommand
+	}), object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
 	}), contextualHelpParser, merge(object({
 		help: constant(true),
+		version: constant(false),
 		commands: constant([])
-	}), helpOption));
-	const result = parse(augmentedParser, args);
+	}), helpOption)) : help === "both" && version === "option" ? longestMatch(merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption), object({
+		help: constant(true),
+		version: constant(false),
+		commands: helpCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), contextualHelpParser, merge(object({
+		help: constant(true),
+		version: constant(false),
+		commands: constant([])
+	}), helpOption)) : longestMatch(merge(object({
+		help: constant(false),
+		version: constant(true)
+	}), versionOption), object({
+		help: constant(false),
+		version: constant(true),
+		result: versionCommand
+	}), object({
+		help: constant(true),
+		version: constant(false),
+		commands: helpCommand
+	}), object({
+		help: constant(false),
+		version: constant(false),
+		result: parser
+	}), longestMatch(contextualHelpParser, merge(object({
+		help: constant(true),
+		version: constant(false),
+		commands: constant([])
+	}), helpOption)));
+	let result = parse(augmentedParser, args);
+	if (result.success && typeof result.value === "object" && result.value != null && "help" in result.value && "version" in result.value) {
+		const parsedValue = result.value;
+		const hasVersionInput = args.includes("--version") || args.length > 0 && args[0] === "version";
+		const hasHelpInput = args.includes("--help") || args.length > 0 && args[0] === "help";
+		if (parsedValue.version && !hasVersionInput || parsedValue.help && !hasHelpInput && !parsedValue.result) result = parse(parser, args);
+	}
 	if (result.success) {
 		const value = result.value;
-		if (help === "none") return value;
-		if (typeof value === "object" && value != null && "help" in value) {
-			const helpValue$1 = value;
-			if (!helpValue$1.help) return helpValue$1.result;
+		if (help === "none" && version === "none") return value;
+		if (typeof value === "object" && value != null && "help" in value && "version" in value) {
+			const parsedValue = value;
+			if (parsedValue.version) {
+				const hasVersionOption = args.includes("--version");
+				const hasVersionCommand = args.length > 0 && args[0] === "version";
+				if (hasVersionOption || hasVersionCommand) {
+					stdout(versionValue);
+					try {
+						return onVersion(0);
+					} catch {
+						return onVersion();
+					}
+				}
+			}
+			if (parsedValue.help) {
+				if (version !== "none" && args.includes("--version")) {
+					stdout(versionValue);
+					try {
+						return onVersion(0);
+					} catch {
+						return onVersion();
+					}
+				}
+				let commandContext = [];
+				if (Array.isArray(parsedValue.commands)) commandContext = parsedValue.commands;
+				else if (typeof parsedValue.commands === "object" && parsedValue.commands != null && "length" in parsedValue.commands) commandContext = parsedValue.commands;
+				const doc = getDocPage(commandContext.length < 1 ? augmentedParser : parser, commandContext);
+				if (doc != null) stdout(formatDocPage(programName, doc, {
+					colors,
+					maxWidth
+				}));
+				try {
+					return onHelp(0);
+				} catch {
+					return onHelp();
+				}
+			}
+			return parsedValue.result ?? value;
 		} else return value;
-		let commandContext = [];
-		const helpValue = value;
-		if (Array.isArray(helpValue.commands)) commandContext = helpValue.commands;
-		else if (typeof helpValue.commands === "object" && helpValue.commands != null && "length" in helpValue.commands) commandContext = helpValue.commands;
-		const doc = getDocPage(commandContext.length < 1 ? augmentedParser : parser, commandContext);
-		if (doc != null) stdout(formatDocPage(programName, doc, {
-			colors,
-			maxWidth
-		}));
-		return onHelp(0);
 	}
 	if (aboveError === "help") {
 		const doc = getDocPage(args.length < 1 ? augmentedParser : parser, args);

package/dist/parser.d.cts

@@ -661,6 +661,7 @@ declare function or<TA, TB, TC, TD, TE, TF, TG, TH, TI, TJ, TStateA, TStateB, TS
  * @param b The second {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using both parsers
  *          and returns the result of the parser that consumed more tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TStateA, TStateB>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>): Parser<TA | TB, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>]>;
 /**
@@ -679,6 +680,7 @@ declare function longestMatch<TA, TB, TStateA, TStateB>(a: Parser<TA, TStateA>,
  * @param c The third {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using all parsers
  *          and returns the result of the parser that consumed the most tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TC, TStateA, TStateB, TStateC>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>, c: Parser<TC, TStateC>): Parser<TA | TB | TC, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>] | [2, ParserResult<TStateC>]>;
 /**
@@ -700,6 +702,7 @@ declare function longestMatch<TA, TB, TC, TStateA, TStateB, TStateC>(a: Parser<T
  * @param d The fourth {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using all parsers
  *          and returns the result of the parser that consumed the most tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TC, TD, TStateA, TStateB, TStateC, TStateD>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>, c: Parser<TC, TStateC>, d: Parser<TD, TStateD>): Parser<TA | TB | TC | TD, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>] | [2, ParserResult<TStateC>] | [3, ParserResult<TStateD>]>;
 /**
@@ -724,6 +727,7 @@ declare function longestMatch<TA, TB, TC, TD, TStateA, TStateB, TStateC, TStateD
  * @param e The fifth {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using all parsers
  *          and returns the result of the parser that consumed the most tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TC, TD, TE, TStateA, TStateB, TStateC, TStateD, TStateE>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>, c: Parser<TC, TStateC>, d: Parser<TD, TStateD>, e: Parser<TE, TStateE>): Parser<TA | TB | TC | TD | TE, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>] | [2, ParserResult<TStateC>] | [3, ParserResult<TStateD>] | [4, ParserResult<TStateE>]>;
 /**

package/dist/parser.d.ts

@@ -661,6 +661,7 @@ declare function or<TA, TB, TC, TD, TE, TF, TG, TH, TI, TJ, TStateA, TStateB, TS
  * @param b The second {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using both parsers
  *          and returns the result of the parser that consumed more tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TStateA, TStateB>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>): Parser<TA | TB, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>]>;
 /**
@@ -679,6 +680,7 @@ declare function longestMatch<TA, TB, TStateA, TStateB>(a: Parser<TA, TStateA>,
  * @param c The third {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using all parsers
  *          and returns the result of the parser that consumed the most tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TC, TStateA, TStateB, TStateC>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>, c: Parser<TC, TStateC>): Parser<TA | TB | TC, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>] | [2, ParserResult<TStateC>]>;
 /**
@@ -700,6 +702,7 @@ declare function longestMatch<TA, TB, TC, TStateA, TStateB, TStateC>(a: Parser<T
  * @param d The fourth {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using all parsers
  *          and returns the result of the parser that consumed the most tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TC, TD, TStateA, TStateB, TStateC, TStateD>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>, c: Parser<TC, TStateC>, d: Parser<TD, TStateD>): Parser<TA | TB | TC | TD, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>] | [2, ParserResult<TStateC>] | [3, ParserResult<TStateD>]>;
 /**
@@ -724,6 +727,7 @@ declare function longestMatch<TA, TB, TC, TD, TStateA, TStateB, TStateC, TStateD
  * @param e The fifth {@link Parser} to try.
  * @returns A {@link Parser} that tries to parse using all parsers
  *          and returns the result of the parser that consumed the most tokens.
+ * @since 0.3.0
  */
 declare function longestMatch<TA, TB, TC, TD, TE, TStateA, TStateB, TStateC, TStateD, TStateE>(a: Parser<TA, TStateA>, b: Parser<TB, TStateB>, c: Parser<TC, TStateC>, d: Parser<TD, TStateD>, e: Parser<TE, TStateE>): Parser<TA | TB | TC | TD | TE, undefined | [0, ParserResult<TStateA>] | [1, ParserResult<TStateB>] | [2, ParserResult<TStateC>] | [3, ParserResult<TStateD>] | [4, ParserResult<TStateE>]>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.3.0-dev.41+76c1e568",
+  "version": "0.3.0-dev.43+2da69082",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",