@optique/core 0.3.0-dev.39 → 0.3.0-dev.40

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, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, 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, 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, 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, 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, integer, isValueParser, locale, 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, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, 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, 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, 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, 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, integer, isValueParser, locale, 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

@@ -514,7 +514,11 @@ function optional(parser) {
 			return parser.complete(state[0]);
 		},
 		getDocFragments(state, defaultValue) {
-			return parser.getDocFragments(typeof state === "undefined" ? parser.initialState : state[0], defaultValue);
+			const innerState = state.kind === "unavailable" ? { kind: "unavailable" } : state.state === void 0 ? { kind: "unavailable" } : {
+				kind: "available",
+				state: state.state[0]
+			};
+			return parser.getDocFragments(innerState, defaultValue);
 		}
 	};
 }
@@ -566,7 +570,11 @@ function withDefault(parser, defaultValue) {
 			return parser.complete(state[0]);
 		},
 		getDocFragments(state, upperDefaultValue) {
-			return parser.getDocFragments(typeof state === "undefined" ? parser.initialState : state[0], upperDefaultValue != null ? upperDefaultValue : typeof defaultValue === "function" ? defaultValue() : defaultValue);
+			const innerState = state.kind === "unavailable" ? { kind: "unavailable" } : state.state === void 0 ? { kind: "unavailable" } : {
+				kind: "available",
+				state: state.state[0]
+			};
+			return parser.getDocFragments(innerState, upperDefaultValue != null ? upperDefaultValue : typeof defaultValue === "function" ? defaultValue() : defaultValue);
 		}
 	};
 }
@@ -697,7 +705,11 @@ function multiple(parser, options = {}) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			return parser.getDocFragments(state.at(-1) ?? parser.initialState, defaultValue != null && defaultValue.length > 0 ? defaultValue[0] : void 0);
+			const innerState = state.kind === "unavailable" ? { kind: "unavailable" } : state.state.length > 0 ? {
+				kind: "available",
+				state: state.state.at(-1)
+			} : { kind: "unavailable" };
+			return parser.getDocFragments(innerState, defaultValue != null && defaultValue.length > 0 ? defaultValue[0] : void 0);
 		}
 	};
 }
@@ -788,7 +800,13 @@ function object(labelOrParsers, maybeParsers) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			const fragments = parserPairs.flatMap(([field, p]) => p.getDocFragments(state[field], defaultValue?.[field]).fragments);
+			const fragments = parserPairs.flatMap(([field, p]) => {
+				const fieldState = state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state[field]
+				};
+				return p.getDocFragments(fieldState, defaultValue?.[field]).fragments;
+			});
 			const entries = fragments.filter((d) => d.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -892,7 +910,13 @@ function tuple(labelOrParsers, maybeParsers) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			const fragments = parsers.flatMap((p, i) => p.getDocFragments(state[i], defaultValue?.[i]).fragments);
+			const fragments = parsers.flatMap((p, i) => {
+				const indexState = state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state[i]
+				};
+				return p.getDocFragments(indexState, defaultValue?.[i]).fragments;
+			});
 			const entries = fragments.filter((d) => d.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -976,10 +1000,14 @@ function or(...parsers) {
 		getDocFragments(state, _defaultValue) {
 			let description;
 			let fragments;
-			if (state == null) fragments = parsers.flatMap((p) => p.getDocFragments(p.initialState, void 0).fragments);
+			if (state.kind === "unavailable" || state.state == null) fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }, void 0).fragments);
 			else {
-				const [index, parserResult] = state;
-				const docFragments = parsers[index].getDocFragments(parserResult.success ? parserResult.next.state : parsers[index].initialState, void 0);
+				const [index, parserResult] = state.state;
+				const innerState = parserResult.success ? {
+					kind: "available",
+					state: parserResult.next.state
+				} : { kind: "unavailable" };
+				const docFragments = parsers[index].getDocFragments(innerState, void 0);
 				description = docFragments.description;
 				fragments = docFragments.fragments;
 			}
@@ -1082,7 +1110,13 @@ function merge(...parsers) {
 			};
 		},
 		getDocFragments(state, _defaultValue) {
-			const fragments = parsers.flatMap((p) => p.getDocFragments(state, void 0).fragments);
+			const fragments = parsers.flatMap((p) => {
+				const parserState = p.initialState === void 0 ? { kind: "unavailable" } : state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state
+				};
+				return p.getDocFragments(parserState, void 0).fragments;
+			});
 			const entries = fragments.filter((f) => f.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -1183,7 +1217,13 @@ function concat(...parsers) {
 			};
 		},
 		getDocFragments(state, _defaultValue) {
-			const fragments = parsers.flatMap((p, index) => p.getDocFragments(state[index], void 0).fragments);
+			const fragments = parsers.flatMap((p, index) => {
+				const indexState = state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state[index]
+				};
+				return p.getDocFragments(indexState, void 0).fragments;
+			});
 			const entries = fragments.filter((f) => f.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -1290,7 +1330,7 @@ function command(name, parser, options = {}) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			if (typeof state === "undefined") return {
+			if (state.kind === "unavailable" || typeof state.state === "undefined") return {
 				description: options.description,
 				fragments: [{
 					type: "entry",
@@ -1301,7 +1341,11 @@ function command(name, parser, options = {}) {
 					description: options.description
 				}]
 			};
-			const innerFragments = parser.getDocFragments(state[0] === "parsing" ? state[1] : parser.initialState, defaultValue);
+			const innerState = state.state[0] === "parsing" ? {
+				kind: "available",
+				state: state.state[1]
+			} : { kind: "unavailable" };
+			const innerFragments = parser.getDocFragments(innerState, defaultValue);
 			return {
 				...innerFragments,
 				description: innerFragments.description ?? options.description
@@ -1398,7 +1442,10 @@ function getDocPage(parser, args = []) {
 		if (!result.success) break;
 		context = result.next;
 	} while (context.buffer.length > 0);
-	const { description, fragments } = parser.getDocFragments(context.state, void 0);
+	const { description, fragments } = parser.getDocFragments({
+		kind: "available",
+		state: context.state
+	}, void 0);
 	const entries = fragments.filter((f) => f.type === "entry");
 	const sections = [];
 	for (const fragment of fragments) {

package/dist/parser.d.cts

@@ -5,6 +5,19 @@ import { ValueParser, ValueParserResult } from "./valueparser.cjs";
 
 //#region src/parser.d.ts
 
+/**
+ * Represents the state passed to getDocFragments.
+ * Can be either the actual parser state or an explicit indicator
+ * that no state is available.
+ * @template TState The type of the actual state when available.
+ * @since 0.3.0
+ */
+type DocState<TState> = {
+  readonly kind: "available";
+  readonly state: TState;
+} | {
+  readonly kind: "unavailable";
+};
 /**
  * Parser interface for command-line argument parsing.
  * @template TValue The type of the value returned by the parser.
@@ -65,15 +78,14 @@ interface Parser<TValue, TState> {
   /**
    * Generates a documentation fragment for this parser, which can be used
    * to describe the parser's usage, description, and default value.
-   * @param state The current state of the parser, which may contain
-   *              accumulated data or context needed to produce
-   *              the documentation.
+   * @param state The current state of the parser, wrapped in a DocState
+   *              to indicate whether the actual state is available or not.
    * @param defaultValue An optional default value that can be used
    *                     to provide a default value in the documentation.
    * @returns {@link DocFragments} object containing documentation
    *          fragments for this parser.
    */
-  getDocFragments(state: TState, defaultValue?: TValue): DocFragments;
+  getDocFragments(state: DocState<TState>, defaultValue?: TValue): DocFragments;
 }
 /**
  * The context of the parser, which includes the input buffer and the state.
@@ -924,4 +936,4 @@ declare function parse<T>(parser: Parser<T, unknown>, args: readonly string[]):
  */
 declare function getDocPage(parser: Parser<unknown, unknown>, args?: readonly string[]): DocPage | undefined;
 //#endregion
-export { ArgumentOptions, CommandOptions, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault };
+export { ArgumentOptions, CommandOptions, DocState, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault };

package/dist/parser.d.ts

@@ -5,6 +5,19 @@ import { ValueParser, ValueParserResult } from "./valueparser.js";
 
 //#region src/parser.d.ts
 
+/**
+ * Represents the state passed to getDocFragments.
+ * Can be either the actual parser state or an explicit indicator
+ * that no state is available.
+ * @template TState The type of the actual state when available.
+ * @since 0.3.0
+ */
+type DocState<TState> = {
+  readonly kind: "available";
+  readonly state: TState;
+} | {
+  readonly kind: "unavailable";
+};
 /**
  * Parser interface for command-line argument parsing.
  * @template TValue The type of the value returned by the parser.
@@ -65,15 +78,14 @@ interface Parser<TValue, TState> {
   /**
    * Generates a documentation fragment for this parser, which can be used
    * to describe the parser's usage, description, and default value.
-   * @param state The current state of the parser, which may contain
-   *              accumulated data or context needed to produce
-   *              the documentation.
+   * @param state The current state of the parser, wrapped in a DocState
+   *              to indicate whether the actual state is available or not.
    * @param defaultValue An optional default value that can be used
    *                     to provide a default value in the documentation.
    * @returns {@link DocFragments} object containing documentation
    *          fragments for this parser.
    */
-  getDocFragments(state: TState, defaultValue?: TValue): DocFragments;
+  getDocFragments(state: DocState<TState>, defaultValue?: TValue): DocFragments;
 }
 /**
  * The context of the parser, which includes the input buffer and the state.
@@ -924,4 +936,4 @@ declare function parse<T>(parser: Parser<T, unknown>, args: readonly string[]):
  */
 declare function getDocPage(parser: Parser<unknown, unknown>, args?: readonly string[]): DocPage | undefined;
 //#endregion
-export { ArgumentOptions, CommandOptions, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault };
+export { ArgumentOptions, CommandOptions, DocState, FlagOptions, InferValue, MultipleOptions, OptionOptions, Parser, ParserContext, ParserResult, Result, argument, command, concat, constant, flag, getDocPage, map, merge, multiple, object, option, optional, or, parse, tuple, withDefault };

package/dist/parser.js

@@ -514,7 +514,11 @@ function optional(parser) {
 			return parser.complete(state[0]);
 		},
 		getDocFragments(state, defaultValue) {
-			return parser.getDocFragments(typeof state === "undefined" ? parser.initialState : state[0], defaultValue);
+			const innerState = state.kind === "unavailable" ? { kind: "unavailable" } : state.state === void 0 ? { kind: "unavailable" } : {
+				kind: "available",
+				state: state.state[0]
+			};
+			return parser.getDocFragments(innerState, defaultValue);
 		}
 	};
 }
@@ -566,7 +570,11 @@ function withDefault(parser, defaultValue) {
 			return parser.complete(state[0]);
 		},
 		getDocFragments(state, upperDefaultValue) {
-			return parser.getDocFragments(typeof state === "undefined" ? parser.initialState : state[0], upperDefaultValue != null ? upperDefaultValue : typeof defaultValue === "function" ? defaultValue() : defaultValue);
+			const innerState = state.kind === "unavailable" ? { kind: "unavailable" } : state.state === void 0 ? { kind: "unavailable" } : {
+				kind: "available",
+				state: state.state[0]
+			};
+			return parser.getDocFragments(innerState, upperDefaultValue != null ? upperDefaultValue : typeof defaultValue === "function" ? defaultValue() : defaultValue);
 		}
 	};
 }
@@ -697,7 +705,11 @@ function multiple(parser, options = {}) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			return parser.getDocFragments(state.at(-1) ?? parser.initialState, defaultValue != null && defaultValue.length > 0 ? defaultValue[0] : void 0);
+			const innerState = state.kind === "unavailable" ? { kind: "unavailable" } : state.state.length > 0 ? {
+				kind: "available",
+				state: state.state.at(-1)
+			} : { kind: "unavailable" };
+			return parser.getDocFragments(innerState, defaultValue != null && defaultValue.length > 0 ? defaultValue[0] : void 0);
 		}
 	};
 }
@@ -788,7 +800,13 @@ function object(labelOrParsers, maybeParsers) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			const fragments = parserPairs.flatMap(([field, p]) => p.getDocFragments(state[field], defaultValue?.[field]).fragments);
+			const fragments = parserPairs.flatMap(([field, p]) => {
+				const fieldState = state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state[field]
+				};
+				return p.getDocFragments(fieldState, defaultValue?.[field]).fragments;
+			});
 			const entries = fragments.filter((d) => d.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -892,7 +910,13 @@ function tuple(labelOrParsers, maybeParsers) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			const fragments = parsers.flatMap((p, i) => p.getDocFragments(state[i], defaultValue?.[i]).fragments);
+			const fragments = parsers.flatMap((p, i) => {
+				const indexState = state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state[i]
+				};
+				return p.getDocFragments(indexState, defaultValue?.[i]).fragments;
+			});
 			const entries = fragments.filter((d) => d.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -976,10 +1000,14 @@ function or(...parsers) {
 		getDocFragments(state, _defaultValue) {
 			let description;
 			let fragments;
-			if (state == null) fragments = parsers.flatMap((p) => p.getDocFragments(p.initialState, void 0).fragments);
+			if (state.kind === "unavailable" || state.state == null) fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }, void 0).fragments);
 			else {
-				const [index, parserResult] = state;
-				const docFragments = parsers[index].getDocFragments(parserResult.success ? parserResult.next.state : parsers[index].initialState, void 0);
+				const [index, parserResult] = state.state;
+				const innerState = parserResult.success ? {
+					kind: "available",
+					state: parserResult.next.state
+				} : { kind: "unavailable" };
+				const docFragments = parsers[index].getDocFragments(innerState, void 0);
 				description = docFragments.description;
 				fragments = docFragments.fragments;
 			}
@@ -1082,7 +1110,13 @@ function merge(...parsers) {
 			};
 		},
 		getDocFragments(state, _defaultValue) {
-			const fragments = parsers.flatMap((p) => p.getDocFragments(state, void 0).fragments);
+			const fragments = parsers.flatMap((p) => {
+				const parserState = p.initialState === void 0 ? { kind: "unavailable" } : state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state
+				};
+				return p.getDocFragments(parserState, void 0).fragments;
+			});
 			const entries = fragments.filter((f) => f.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -1183,7 +1217,13 @@ function concat(...parsers) {
 			};
 		},
 		getDocFragments(state, _defaultValue) {
-			const fragments = parsers.flatMap((p, index) => p.getDocFragments(state[index], void 0).fragments);
+			const fragments = parsers.flatMap((p, index) => {
+				const indexState = state.kind === "unavailable" ? { kind: "unavailable" } : {
+					kind: "available",
+					state: state.state[index]
+				};
+				return p.getDocFragments(indexState, void 0).fragments;
+			});
 			const entries = fragments.filter((f) => f.type === "entry");
 			const sections = [];
 			for (const fragment of fragments) {
@@ -1290,7 +1330,7 @@ function command(name, parser, options = {}) {
 			};
 		},
 		getDocFragments(state, defaultValue) {
-			if (typeof state === "undefined") return {
+			if (state.kind === "unavailable" || typeof state.state === "undefined") return {
 				description: options.description,
 				fragments: [{
 					type: "entry",
@@ -1301,7 +1341,11 @@ function command(name, parser, options = {}) {
 					description: options.description
 				}]
 			};
-			const innerFragments = parser.getDocFragments(state[0] === "parsing" ? state[1] : parser.initialState, defaultValue);
+			const innerState = state.state[0] === "parsing" ? {
+				kind: "available",
+				state: state.state[1]
+			} : { kind: "unavailable" };
+			const innerFragments = parser.getDocFragments(innerState, defaultValue);
 			return {
 				...innerFragments,
 				description: innerFragments.description ?? options.description
@@ -1398,7 +1442,10 @@ function getDocPage(parser, args = []) {
 		if (!result.success) break;
 		context = result.next;
 	} while (context.buffer.length > 0);
-	const { description, fragments } = parser.getDocFragments(context.state, void 0);
+	const { description, fragments } = parser.getDocFragments({
+		kind: "available",
+		state: context.state
+	}, void 0);
 	const entries = fragments.filter((f) => f.type === "entry");
 	const sections = [];
 	for (const fragment of fragments) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.3.0-dev.39+80d894ad",
+  "version": "0.3.0-dev.40+7b4a92a1",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",