@optique/core 0.4.0-dev.51 → 0.4.0-dev.53

package/README.md

@@ -1,9 +1,8 @@
 @optique/core
 =============
 
-> [!CAUTION]
-> Optique is currently in early development and may change significantly.
-> Expect breaking changes as we refine the API and features.
+> [!WARNING]
+> The API is stabilizing, but may change before the 1.0 release.
 
 The core package of Optique which provides the shared types and parser
 combinators. It is designed to be used in universal JavaScript runtimes,

package/dist/facade.cjs

@@ -73,7 +73,7 @@ function run(parser, programName, args, options = {}) {
 	}), 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({
+	}), require_parser.object({ versionFlag: versionOption }))) : help === "none" && version === "both" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(true),
 		result: versionCommand
@@ -84,7 +84,7 @@ function run(parser, programName, args, options = {}) {
 	}), 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({
+	}), require_parser.object({ versionFlag: versionOption }))) : help === "command" && version === "none" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: helpCommand
@@ -115,7 +115,7 @@ function run(parser, programName, args, options = {}) {
 	}), 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({
+	}), require_parser.object({ versionFlag: versionOption }))) : help === "command" && version === "both" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: helpCommand
@@ -130,7 +130,7 @@ function run(parser, programName, args, options = {}) {
 	}), 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({
+	}), require_parser.object({ versionFlag: versionOption }))) : help === "option" && version === "none" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(false),
 		result: parser
@@ -138,7 +138,7 @@ function run(parser, programName, args, options = {}) {
 		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({
+	}), require_parser.object({ helpFlag: helpOption }))) : help === "option" && version === "command" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(true),
 		result: versionCommand
@@ -150,10 +150,10 @@ function run(parser, programName, args, options = {}) {
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: require_parser.constant([])
-	}), helpOption)) : help === "option" && version === "option" ? require_parser.longestMatch(require_parser.merge(require_parser.object({
+	}), require_parser.object({ helpFlag: 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({
+	}), require_parser.object({ versionFlag: versionOption })), require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(false),
 		result: parser
@@ -161,10 +161,10 @@ function run(parser, programName, args, options = {}) {
 		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({
+	}), require_parser.object({ helpFlag: 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({
+	}), require_parser.object({ versionFlag: versionOption })), require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(true),
 		result: versionCommand
@@ -176,7 +176,7 @@ function run(parser, programName, args, options = {}) {
 		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({
+	}), require_parser.object({ helpFlag: helpOption }))) : help === "both" && version === "none" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(false),
 		result: parser
@@ -188,7 +188,7 @@ function run(parser, programName, args, options = {}) {
 		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({
+	}), require_parser.object({ helpFlag: helpOption }))) : help === "both" && version === "command" ? require_parser.longestMatch(require_parser.object({
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: helpCommand
@@ -204,10 +204,10 @@ function run(parser, programName, args, options = {}) {
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: require_parser.constant([])
-	}), helpOption)) : help === "both" && version === "option" ? require_parser.longestMatch(require_parser.merge(require_parser.object({
+	}), require_parser.object({ helpFlag: 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({
+	}), require_parser.object({ versionFlag: versionOption })), require_parser.object({
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: helpCommand
@@ -219,10 +219,10 @@ function run(parser, programName, args, options = {}) {
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: require_parser.constant([])
-	}), helpOption)) : require_parser.longestMatch(require_parser.merge(require_parser.object({
+	}), require_parser.object({ helpFlag: helpOption }))) : require_parser.longestMatch(require_parser.merge(require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(true)
-	}), versionOption), require_parser.object({
+	}), require_parser.object({ versionFlag: versionOption })), require_parser.object({
 		help: require_parser.constant(false),
 		version: require_parser.constant(true),
 		result: versionCommand
@@ -238,7 +238,7 @@ function run(parser, programName, args, options = {}) {
 		help: require_parser.constant(true),
 		version: require_parser.constant(false),
 		commands: require_parser.constant([])
-	}), helpOption)));
+	}), require_parser.object({ helpFlag: 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;

package/dist/facade.js

@@ -73,7 +73,7 @@ function run(parser, programName, args, options = {}) {
 	}), merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption)) : help === "none" && version === "both" ? longestMatch(object({
+	}), object({ versionFlag: versionOption }))) : help === "none" && version === "both" ? longestMatch(object({
 		help: constant(false),
 		version: constant(true),
 		result: versionCommand
@@ -84,7 +84,7 @@ function run(parser, programName, args, options = {}) {
 	}), merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption)) : help === "command" && version === "none" ? longestMatch(object({
+	}), object({ versionFlag: versionOption }))) : help === "command" && version === "none" ? longestMatch(object({
 		help: constant(true),
 		version: constant(false),
 		commands: helpCommand
@@ -115,7 +115,7 @@ function run(parser, programName, args, options = {}) {
 	}), merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption)) : help === "command" && version === "both" ? longestMatch(object({
+	}), object({ versionFlag: versionOption }))) : help === "command" && version === "both" ? longestMatch(object({
 		help: constant(true),
 		version: constant(false),
 		commands: helpCommand
@@ -130,7 +130,7 @@ function run(parser, programName, args, options = {}) {
 	}), merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption)) : help === "option" && version === "none" ? longestMatch(object({
+	}), object({ versionFlag: versionOption }))) : help === "option" && version === "none" ? longestMatch(object({
 		help: constant(false),
 		version: constant(false),
 		result: parser
@@ -138,7 +138,7 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : help === "option" && version === "command" ? longestMatch(object({
+	}), object({ helpFlag: helpOption }))) : help === "option" && version === "command" ? longestMatch(object({
 		help: constant(false),
 		version: constant(true),
 		result: versionCommand
@@ -150,10 +150,10 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : help === "option" && version === "option" ? longestMatch(merge(object({
+	}), object({ helpFlag: helpOption }))) : help === "option" && version === "option" ? longestMatch(merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption), object({
+	}), object({ versionFlag: versionOption })), object({
 		help: constant(false),
 		version: constant(false),
 		result: parser
@@ -161,10 +161,10 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : help === "option" && version === "both" ? longestMatch(merge(object({
+	}), object({ helpFlag: helpOption }))) : help === "option" && version === "both" ? longestMatch(merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption), object({
+	}), object({ versionFlag: versionOption })), object({
 		help: constant(false),
 		version: constant(true),
 		result: versionCommand
@@ -176,7 +176,7 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : help === "both" && version === "none" ? longestMatch(object({
+	}), object({ helpFlag: helpOption }))) : help === "both" && version === "none" ? longestMatch(object({
 		help: constant(false),
 		version: constant(false),
 		result: parser
@@ -188,7 +188,7 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : help === "both" && version === "command" ? longestMatch(object({
+	}), object({ helpFlag: helpOption }))) : help === "both" && version === "command" ? longestMatch(object({
 		help: constant(true),
 		version: constant(false),
 		commands: helpCommand
@@ -204,10 +204,10 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : help === "both" && version === "option" ? longestMatch(merge(object({
+	}), object({ helpFlag: helpOption }))) : help === "both" && version === "option" ? longestMatch(merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption), object({
+	}), object({ versionFlag: versionOption })), object({
 		help: constant(true),
 		version: constant(false),
 		commands: helpCommand
@@ -219,10 +219,10 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)) : longestMatch(merge(object({
+	}), object({ helpFlag: helpOption }))) : longestMatch(merge(object({
 		help: constant(false),
 		version: constant(true)
-	}), versionOption), object({
+	}), object({ versionFlag: versionOption })), object({
 		help: constant(false),
 		version: constant(true),
 		result: versionCommand
@@ -238,7 +238,7 @@ function run(parser, programName, args, options = {}) {
 		help: constant(true),
 		version: constant(false),
 		commands: constant([])
-	}), helpOption)));
+	}), object({ helpFlag: 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;

package/dist/index.cjs

@@ -18,6 +18,7 @@ exports.formatMessage = require_message.formatMessage;
 exports.formatUsage = require_usage.formatUsage;
 exports.formatUsageTerm = require_usage.formatUsageTerm;
 exports.getDocPage = require_parser.getDocPage;
+exports.group = require_parser.group;
 exports.integer = require_valueparser.integer;
 exports.isValueParser = require_valueparser.isValueParser;
 exports.locale = require_valueparser.locale;

package/dist/index.d.cts

@@ -2,6 +2,6 @@ import { Message, MessageFormatOptions, MessageTerm, formatMessage, message, met
 import { OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, formatUsage, formatUsageTerm, normalizeUsage } from "./usage.cjs";
 import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, formatDocPage } from "./doc.cjs";
 import { ChoiceOptions, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.cjs";
-import { ArgumentOptions, CommandOptions, DocState, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, longestMatch, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault } from "./parser.cjs";
+import { ArgumentOptions, CommandOptions, DocState, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, group, longestMatch, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault } from "./parser.cjs";
 import { RunError, RunOptions, run } from "./facade.cjs";
-export { ArgumentOptions, ChoiceOptions, CommandOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, Message, MessageFormatOptions, MessageTerm, MultipleOptions, OptionName, OptionOptions, Parser, ParserContext, ParserResult, Result, RunError, RunOptions, StringOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, argument, choice, command, concat, constant, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, run, string, text, tuple, url, uuid, value, values, withDefault };
+export { ArgumentOptions, ChoiceOptions, CommandOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, Message, MessageFormatOptions, MessageTerm, MultipleOptions, OptionName, OptionOptions, Parser, ParserContext, ParserResult, Result, RunError, RunOptions, StringOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, argument, choice, command, concat, constant, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, run, string, text, tuple, url, uuid, value, values, withDefault };

package/dist/index.d.ts

@@ -2,6 +2,6 @@ import { Message, MessageFormatOptions, MessageTerm, formatMessage, message, met
 import { OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, formatUsage, formatUsageTerm, normalizeUsage } from "./usage.js";
 import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, formatDocPage } from "./doc.js";
 import { ChoiceOptions, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.js";
-import { ArgumentOptions, CommandOptions, DocState, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, longestMatch, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault } from "./parser.js";
+import { ArgumentOptions, CommandOptions, DocState, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, group, longestMatch, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault } from "./parser.js";
 import { RunError, RunOptions, run } from "./facade.js";
-export { ArgumentOptions, ChoiceOptions, CommandOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, Message, MessageFormatOptions, MessageTerm, MultipleOptions, OptionName, OptionOptions, Parser, ParserContext, ParserResult, Result, RunError, RunOptions, StringOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, argument, choice, command, concat, constant, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, run, string, text, tuple, url, uuid, value, values, withDefault };
+export { ArgumentOptions, ChoiceOptions, CommandOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, Message, MessageFormatOptions, MessageTerm, MultipleOptions, OptionName, OptionOptions, Parser, ParserContext, ParserResult, Result, RunError, RunOptions, StringOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, argument, choice, command, concat, constant, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, run, string, text, tuple, url, uuid, value, values, withDefault };

package/dist/index.js

@@ -2,7 +2,7 @@ import { formatMessage, message, metavar, optionName, optionNames, text, value,
 import { formatUsage, formatUsageTerm, normalizeUsage } from "./usage.js";
 import { formatDocPage } from "./doc.js";
 import { choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.js";
-import { argument, command, concat, constant, flag, getDocPage, longestMatch, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault } from "./parser.js";
+import { argument, command, concat, constant, flag, getDocPage, group, longestMatch, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault } from "./parser.js";
 import { RunError, run } from "./facade.js";
 
-export { RunError, argument, choice, command, concat, constant, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, run, string, text, tuple, url, uuid, value, values, withDefault };
+export { RunError, argument, choice, command, concat, constant, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, run, string, text, tuple, url, uuid, value, values, withDefault };

package/dist/parser.cjs

@@ -1111,7 +1111,9 @@ function longestMatch(...parsers) {
 		}
 	};
 }
-function merge(...parsers) {
+function merge(...args) {
+	const label = typeof args[0] === "string" ? args[0] : void 0;
+	let parsers = typeof args[0] === "string" ? args.slice(1) : args;
 	parsers = parsers.toSorted((a, b) => b.priority - a.priority);
 	const initialState = {};
 	for (const parser of parsers) if (parser.initialState && typeof parser.initialState === "object") for (const field in parser.initialState) initialState[field] = parser.initialState[field];
@@ -1204,6 +1206,17 @@ function merge(...parsers) {
 				if (fragment.title == null) entries.push(...fragment.entries);
 				else sections.push(fragment);
 			}
+			if (label) {
+				const labeledSection = {
+					title: label,
+					entries
+				};
+				sections.push(labeledSection);
+				return { fragments: sections.map((s) => ({
+					...s,
+					type: "section"
+				})) };
+			}
 			return { fragments: [...sections.map((s) => ({
 				...s,
 				type: "section"
@@ -1479,6 +1492,81 @@ function parse(parser, args) {
 	};
 }
 /**
+* Wraps a parser with a group label for documentation purposes.
+*
+* The `group()` function is a documentation-only wrapper that applies a label
+* to any parser for help text organization. This allows you to use clean code
+* structure with combinators like {@link merge} while maintaining well-organized
+* help text through group labeling.
+*
+* The wrapped parser has identical parsing behavior but generates documentation
+* fragments wrapped in a labeled section. This is particularly useful when
+* combining parsers using {@link merge}—you can wrap the merged result with
+* `group()` to add a section header in help output.
+*
+* @example
+* ```typescript
+* const apiOptions = merge(
+*   object({ endpoint: option("--endpoint", string()) }),
+*   object({ timeout: option("--timeout", integer()) })
+* );
+*
+* const groupedApiOptions = group("API Options", apiOptions);
+* // Now produces a labeled "API Options" section in help text
+* ```
+*
+* @example
+* ```typescript
+* // Can be used with any parser, not just merge()
+* const verboseGroup = group("Verbosity", object({
+*   verbose: option("-v", "--verbose"),
+*   quiet: option("-q", "--quiet")
+* }));
+* ```
+*
+* @template TValue The value type of the wrapped parser.
+* @template TState The state type of the wrapped parser.
+* @param label A descriptive label for this parser group, used for
+*              documentation and help text organization.
+* @param parser The parser to wrap with a group label.
+* @returns A new parser that behaves identically to the input parser
+*          but generates documentation within a labeled section.
+* @since 0.4.0
+*/
+function group(label, parser) {
+	return {
+		$valueType: parser.$valueType,
+		$stateType: parser.$stateType,
+		priority: parser.priority,
+		usage: parser.usage,
+		initialState: parser.initialState,
+		parse: (context) => parser.parse(context),
+		complete: (state) => parser.complete(state),
+		getDocFragments: (state, defaultValue) => {
+			const { description, fragments } = parser.getDocFragments(state, defaultValue);
+			const allEntries = [];
+			const titledSections = [];
+			for (const fragment of fragments) if (fragment.type === "entry") allEntries.push(fragment);
+			else if (fragment.type === "section") if (fragment.title) titledSections.push(fragment);
+			else allEntries.push(...fragment.entries);
+			const labeledSection = {
+				title: label,
+				entries: allEntries
+			};
+			return {
+				description,
+				fragments: [...titledSections.map((s) => ({
+					...s,
+					type: "section"
+				})), {
+					type: "section",
+					...labeledSection
+				}]
+			};
+		}
+	};
+}
+/**
 * Generates a documentation page for a parser based on its current state after
 * attempting to parse the provided arguments. This function is useful for
 * creating help documentation that reflects the current parsing context.
@@ -1563,6 +1651,7 @@ exports.concat = concat;
 exports.constant = constant;
 exports.flag = flag;
 exports.getDocPage = getDocPage;
+exports.group = group;
 exports.longestMatch = longestMatch;
 exports.map = map;
 exports.merge = merge;