@optique/core 1.0.0-dev.1326 → 1.0.0-dev.1344

package/dist/constructs.cjs

@@ -3,6 +3,7 @@ const require_message = require('./message.cjs');
 const require_dependency = require('./dependency.cjs');
 const require_mode_dispatch = require('./mode-dispatch.cjs');
 const require_usage = require('./usage.cjs');
+const require_doc = require('./doc.cjs');
 const require_suggestion = require('./suggestion.cjs');
 const require_usage_internals = require('./usage-internals.cjs');
 
@@ -145,6 +146,19 @@ function extractRequiredUsage(usage) {
 	return required;
 }
 /**
+* Validates that every element of the given array is a {@link Parser} object.
+* @param parsers The array of values to validate.
+* @param callerName The name of the calling function, used in error messages.
+* @throws {TypeError} If any element is not a valid {@link Parser}.
+*/
+function assertParsers(parsers, callerName) {
+	for (let i = 0; i < parsers.length; i++) {
+		const p = parsers[i];
+		const r = p;
+		if (p == null || typeof p !== "object" && typeof p !== "function" || !(r.$mode === "sync" || r.$mode === "async") || !Array.isArray(r.usage) || typeof r.priority !== "number" || Number.isNaN(r.priority) || !("initialState" in p) || typeof r.parse !== "function" || typeof r.complete !== "function" || typeof r.suggest !== "function" || typeof r.getDocFragments !== "function") throw new TypeError(`${callerName} argument at index ${i} is not a valid Parser.`);
+	}
+}
+/**
 * Analyzes parsers to determine what types of inputs are expected.
 * @param parsers The parsers being combined
 * @returns Context about what types of inputs are expected
@@ -305,6 +319,7 @@ function or(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("or() requires at least one parser argument.");
+	assertParsers(parsers, "or()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -471,24 +486,12 @@ function or(...args) {
 				footer = docFragments.footer;
 				fragments = docFragments.fragments;
 			}
-			const entries = fragments.filter((f) => f.type === "entry");
-			const sections = [];
-			for (const fragment of fragments) {
-				if (fragment.type !== "section") continue;
-				if (fragment.title == null) entries.push(...fragment.entries);
-				else sections.push(fragment);
-			}
+			if (state.kind === "unavailable" || state.state == null) fragments = require_doc.deduplicateDocFragments(fragments);
 			return {
 				brief,
 				description,
 				footer,
-				fragments: [...sections.map((s) => ({
-					...s,
-					type: "section"
-				})), {
-					type: "section",
-					entries
-				}]
+				fragments
 			};
 		}
 	};
@@ -507,6 +510,7 @@ function longestMatch(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("longestMatch() requires at least one parser argument.");
+	assertParsers(parsers, "longestMatch()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -606,8 +610,11 @@ function longestMatch(...args) {
 			let description;
 			let footer;
 			let fragments;
-			if (state.kind === "unavailable" || state.state == null) fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
-			else {
+			let shouldDeduplicate;
+			if (state.kind === "unavailable" || state.state == null) {
+				fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
+				shouldDeduplicate = true;
+			} else {
 				const [i, result] = state.state;
 				if (result.success) {
 					const docResult = parsers[i].getDocFragments({
@@ -618,12 +625,16 @@ function longestMatch(...args) {
 					description = docResult.description;
 					footer = docResult.footer;
 					fragments = docResult.fragments;
-				} else fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
+					shouldDeduplicate = false;
+				} else {
+					fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
+					shouldDeduplicate = true;
+				}
 			}
 			return {
 				brief,
 				description,
-				fragments,
+				fragments: shouldDeduplicate ? require_doc.deduplicateDocFragments(fragments) : fragments,
 				footer
 			};
 		}
@@ -1659,6 +1670,7 @@ function merge(...args) {
 	const endIndex = hasOptions ? args.length - 1 : args.length;
 	const rawParsers = args.slice(startIndex, endIndex);
 	if (rawParsers.length < 1) throw new TypeError("merge() requires at least one parser argument.");
+	assertParsers(rawParsers, "merge()");
 	const combinedMode = rawParsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncRawParsers = rawParsers;
@@ -2102,6 +2114,7 @@ function tryParseSuggestList(context, stateArray, parsers, matchedParsers, remai
 }
 function concat(...parsers) {
 	if (parsers.length < 1) throw new TypeError("concat() requires at least one parser argument.");
+	assertParsers(parsers, "concat()");
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;

package/dist/constructs.js

@@ -3,6 +3,7 @@ import { message, optionName, text, values } from "./message.js";
 import { DependencyRegistry, createDependencySourceState, dependencyId, isDeferredParseState, isDependencySourceState, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, wrappedDependencySourceMarker } from "./dependency.js";
 import { dispatchByMode, dispatchIterableByMode } from "./mode-dispatch.js";
 import { extractArgumentMetavars, extractCommandNames, extractOptionNames, isDocHidden, mergeHidden } from "./usage.js";
+import { deduplicateDocFragments } from "./doc.js";
 import { DEFAULT_FIND_SIMILAR_OPTIONS, createErrorWithSuggestions, createSuggestionMessage, deduplicateSuggestions, findSimilar } from "./suggestion.js";
 import { collectLeadingCandidates } from "./usage-internals.js";
 
@@ -145,6 +146,19 @@ function extractRequiredUsage(usage) {
 	return required;
 }
 /**
+* Validates that every element of the given array is a {@link Parser} object.
+* @param parsers The array of values to validate.
+* @param callerName The name of the calling function, used in error messages.
+* @throws {TypeError} If any element is not a valid {@link Parser}.
+*/
+function assertParsers(parsers, callerName) {
+	for (let i = 0; i < parsers.length; i++) {
+		const p = parsers[i];
+		const r = p;
+		if (p == null || typeof p !== "object" && typeof p !== "function" || !(r.$mode === "sync" || r.$mode === "async") || !Array.isArray(r.usage) || typeof r.priority !== "number" || Number.isNaN(r.priority) || !("initialState" in p) || typeof r.parse !== "function" || typeof r.complete !== "function" || typeof r.suggest !== "function" || typeof r.getDocFragments !== "function") throw new TypeError(`${callerName} argument at index ${i} is not a valid Parser.`);
+	}
+}
+/**
 * Analyzes parsers to determine what types of inputs are expected.
 * @param parsers The parsers being combined
 * @returns Context about what types of inputs are expected
@@ -305,6 +319,7 @@ function or(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("or() requires at least one parser argument.");
+	assertParsers(parsers, "or()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -471,24 +486,12 @@ function or(...args) {
 				footer = docFragments.footer;
 				fragments = docFragments.fragments;
 			}
-			const entries = fragments.filter((f) => f.type === "entry");
-			const sections = [];
-			for (const fragment of fragments) {
-				if (fragment.type !== "section") continue;
-				if (fragment.title == null) entries.push(...fragment.entries);
-				else sections.push(fragment);
-			}
+			if (state.kind === "unavailable" || state.state == null) fragments = deduplicateDocFragments(fragments);
 			return {
 				brief,
 				description,
 				footer,
-				fragments: [...sections.map((s) => ({
-					...s,
-					type: "section"
-				})), {
-					type: "section",
-					entries
-				}]
+				fragments
 			};
 		}
 	};
@@ -507,6 +510,7 @@ function longestMatch(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("longestMatch() requires at least one parser argument.");
+	assertParsers(parsers, "longestMatch()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -606,8 +610,11 @@ function longestMatch(...args) {
 			let description;
 			let footer;
 			let fragments;
-			if (state.kind === "unavailable" || state.state == null) fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
-			else {
+			let shouldDeduplicate;
+			if (state.kind === "unavailable" || state.state == null) {
+				fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
+				shouldDeduplicate = true;
+			} else {
 				const [i, result] = state.state;
 				if (result.success) {
 					const docResult = parsers[i].getDocFragments({
@@ -618,12 +625,16 @@ function longestMatch(...args) {
 					description = docResult.description;
 					footer = docResult.footer;
 					fragments = docResult.fragments;
-				} else fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
+					shouldDeduplicate = false;
+				} else {
+					fragments = parsers.flatMap((p) => p.getDocFragments({ kind: "unavailable" }).fragments);
+					shouldDeduplicate = true;
+				}
 			}
 			return {
 				brief,
 				description,
-				fragments,
+				fragments: shouldDeduplicate ? deduplicateDocFragments(fragments) : fragments,
 				footer
 			};
 		}
@@ -1659,6 +1670,7 @@ function merge(...args) {
 	const endIndex = hasOptions ? args.length - 1 : args.length;
 	const rawParsers = args.slice(startIndex, endIndex);
 	if (rawParsers.length < 1) throw new TypeError("merge() requires at least one parser argument.");
+	assertParsers(rawParsers, "merge()");
 	const combinedMode = rawParsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncRawParsers = rawParsers;
@@ -2102,6 +2114,7 @@ function tryParseSuggestList(context, stateArray, parsers, matchedParsers, remai
 }
 function concat(...parsers) {
 	if (parsers.length < 1) throw new TypeError("concat() requires at least one parser argument.");
+	assertParsers(parsers, "concat()");
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;

package/dist/doc.cjs

@@ -2,6 +2,101 @@ const require_message = require('./message.cjs');
 const require_usage = require('./usage.cjs');
 
 //#region src/doc.ts
+function getDocEntryKey(entry) {
+	const term = entry.term;
+	switch (term.type) {
+		case "command": return `command:${term.name}`;
+		case "option": return `option:${[...term.names].sort().join(",")}:${term.metavar ?? ""}`;
+		case "argument": return `argument:${term.metavar}`;
+		default: return JSON.stringify(term);
+	}
+}
+/**
+* Removes duplicate {@link DocEntry} values that share the same surface
+* syntax (same term type and identifying names).  When duplicates exist,
+* the first occurrence is kept and later ones are discarded.
+*
+* Positional argument entries are never deduplicated because they are
+* distinguished by position, not by metavar, and {@link DocEntry} does
+* not carry position information.
+*
+* @param entries The entries to deduplicate.
+* @returns A new array with duplicates removed, preserving insertion order.
+* @since 1.0.0
+*/
+function deduplicateDocEntries(entries) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const entry of entries) {
+		if (entry.term.type === "argument") {
+			result.push(entry);
+			continue;
+		}
+		const key = getDocEntryKey(entry);
+		if (!seen.has(key)) {
+			seen.add(key);
+			result.push(entry);
+		}
+	}
+	return result;
+}
+/**
+* Removes duplicate entries from a list of {@link DocFragment} values.
+* Entry-type fragments are deduplicated by their surface syntax key.
+* Section-type fragments have their entries deduplicated internally.
+*
+* @param fragments The fragments to deduplicate.
+* @returns A new array with duplicate entries removed.
+* @since 1.0.0
+*/
+function deduplicateDocFragments(fragments) {
+	const untitledSeen = /* @__PURE__ */ new Set();
+	const titledSectionMap = /* @__PURE__ */ new Map();
+	const slots = [];
+	for (const fragment of fragments) if (fragment.type === "entry") if (fragment.term.type === "argument") slots.push(fragment);
+	else {
+		const key = getDocEntryKey(fragment);
+		if (!untitledSeen.has(key)) {
+			untitledSeen.add(key);
+			slots.push(fragment);
+		}
+	}
+	else if (fragment.title == null) {
+		const dedupedEntries = [];
+		for (const entry of fragment.entries) {
+			if (entry.term.type === "argument") {
+				dedupedEntries.push(entry);
+				continue;
+			}
+			const key = getDocEntryKey(entry);
+			if (!untitledSeen.has(key)) {
+				untitledSeen.add(key);
+				dedupedEntries.push(entry);
+			}
+		}
+		if (dedupedEntries.length > 0) slots.push({
+			...fragment,
+			type: "section",
+			entries: dedupedEntries
+		});
+	} else {
+		if (!titledSectionMap.has(fragment.title)) {
+			titledSectionMap.set(fragment.title, []);
+			slots.push(fragment.title);
+		}
+		titledSectionMap.get(fragment.title).push(...fragment.entries);
+	}
+	const result = [];
+	for (const slot of slots) if (typeof slot === "string") {
+		const entries = deduplicateDocEntries(titledSectionMap.get(slot));
+		if (entries.length > 0) result.push({
+			type: "section",
+			title: slot,
+			entries
+		});
+	} else result.push(slot);
+	return result;
+}
 /**
 * Creates a deep clone of a {@link DocEntry}.  The `term` is cloned via
 * {@link cloneUsageTerm}, and `description`, `default`, and `choices`
@@ -345,4 +440,6 @@ function lastLineVisibleLength(text$1) {
 
 //#endregion
 exports.cloneDocEntry = cloneDocEntry;
+exports.deduplicateDocEntries = deduplicateDocEntries;
+exports.deduplicateDocFragments = deduplicateDocFragments;
 exports.formatDocPage = formatDocPage;

package/dist/doc.d.cts

@@ -103,6 +103,30 @@ interface DocFragments {
    */
   readonly footer?: Message;
 }
+/**
+ * Removes duplicate {@link DocEntry} values that share the same surface
+ * syntax (same term type and identifying names).  When duplicates exist,
+ * the first occurrence is kept and later ones are discarded.
+ *
+ * Positional argument entries are never deduplicated because they are
+ * distinguished by position, not by metavar, and {@link DocEntry} does
+ * not carry position information.
+ *
+ * @param entries The entries to deduplicate.
+ * @returns A new array with duplicates removed, preserving insertion order.
+ * @since 1.0.0
+ */
+declare function deduplicateDocEntries(entries: readonly DocEntry[]): DocEntry[];
+/**
+ * Removes duplicate entries from a list of {@link DocFragment} values.
+ * Entry-type fragments are deduplicated by their surface syntax key.
+ * Section-type fragments have their entries deduplicated internally.
+ *
+ * @param fragments The fragments to deduplicate.
+ * @returns A new array with duplicate entries removed.
+ * @since 1.0.0
+ */
+declare function deduplicateDocFragments(fragments: readonly DocFragment[]): DocFragment[];
 /**
  * Creates a deep clone of a {@link DocEntry}.  The `term` is cloned via
  * {@link cloneUsageTerm}, and `description`, `default`, and `choices`
@@ -301,4 +325,4 @@ interface DocPageFormatOptions {
  */
 declare function formatDocPage(programName: string, page: DocPage, options?: DocPageFormatOptions): string;
 //#endregion
-export { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, formatDocPage };
+export { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage };

package/dist/doc.d.ts

@@ -103,6 +103,30 @@ interface DocFragments {
    */
   readonly footer?: Message;
 }
+/**
+ * Removes duplicate {@link DocEntry} values that share the same surface
+ * syntax (same term type and identifying names).  When duplicates exist,
+ * the first occurrence is kept and later ones are discarded.
+ *
+ * Positional argument entries are never deduplicated because they are
+ * distinguished by position, not by metavar, and {@link DocEntry} does
+ * not carry position information.
+ *
+ * @param entries The entries to deduplicate.
+ * @returns A new array with duplicates removed, preserving insertion order.
+ * @since 1.0.0
+ */
+declare function deduplicateDocEntries(entries: readonly DocEntry[]): DocEntry[];
+/**
+ * Removes duplicate entries from a list of {@link DocFragment} values.
+ * Entry-type fragments are deduplicated by their surface syntax key.
+ * Section-type fragments have their entries deduplicated internally.
+ *
+ * @param fragments The fragments to deduplicate.
+ * @returns A new array with duplicate entries removed.
+ * @since 1.0.0
+ */
+declare function deduplicateDocFragments(fragments: readonly DocFragment[]): DocFragment[];
 /**
  * Creates a deep clone of a {@link DocEntry}.  The `term` is cloned via
  * {@link cloneUsageTerm}, and `description`, `default`, and `choices`
@@ -301,4 +325,4 @@ interface DocPageFormatOptions {
  */
 declare function formatDocPage(programName: string, page: DocPage, options?: DocPageFormatOptions): string;
 //#endregion
-export { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, formatDocPage };
+export { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage };

package/dist/doc.js

@@ -2,6 +2,101 @@ import { cloneMessage, formatMessage, text } from "./message.js";
 import { cloneUsageTerm, formatUsage, formatUsageTerm } from "./usage.js";
 
 //#region src/doc.ts
+function getDocEntryKey(entry) {
+	const term = entry.term;
+	switch (term.type) {
+		case "command": return `command:${term.name}`;
+		case "option": return `option:${[...term.names].sort().join(",")}:${term.metavar ?? ""}`;
+		case "argument": return `argument:${term.metavar}`;
+		default: return JSON.stringify(term);
+	}
+}
+/**
+* Removes duplicate {@link DocEntry} values that share the same surface
+* syntax (same term type and identifying names).  When duplicates exist,
+* the first occurrence is kept and later ones are discarded.
+*
+* Positional argument entries are never deduplicated because they are
+* distinguished by position, not by metavar, and {@link DocEntry} does
+* not carry position information.
+*
+* @param entries The entries to deduplicate.
+* @returns A new array with duplicates removed, preserving insertion order.
+* @since 1.0.0
+*/
+function deduplicateDocEntries(entries) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const entry of entries) {
+		if (entry.term.type === "argument") {
+			result.push(entry);
+			continue;
+		}
+		const key = getDocEntryKey(entry);
+		if (!seen.has(key)) {
+			seen.add(key);
+			result.push(entry);
+		}
+	}
+	return result;
+}
+/**
+* Removes duplicate entries from a list of {@link DocFragment} values.
+* Entry-type fragments are deduplicated by their surface syntax key.
+* Section-type fragments have their entries deduplicated internally.
+*
+* @param fragments The fragments to deduplicate.
+* @returns A new array with duplicate entries removed.
+* @since 1.0.0
+*/
+function deduplicateDocFragments(fragments) {
+	const untitledSeen = /* @__PURE__ */ new Set();
+	const titledSectionMap = /* @__PURE__ */ new Map();
+	const slots = [];
+	for (const fragment of fragments) if (fragment.type === "entry") if (fragment.term.type === "argument") slots.push(fragment);
+	else {
+		const key = getDocEntryKey(fragment);
+		if (!untitledSeen.has(key)) {
+			untitledSeen.add(key);
+			slots.push(fragment);
+		}
+	}
+	else if (fragment.title == null) {
+		const dedupedEntries = [];
+		for (const entry of fragment.entries) {
+			if (entry.term.type === "argument") {
+				dedupedEntries.push(entry);
+				continue;
+			}
+			const key = getDocEntryKey(entry);
+			if (!untitledSeen.has(key)) {
+				untitledSeen.add(key);
+				dedupedEntries.push(entry);
+			}
+		}
+		if (dedupedEntries.length > 0) slots.push({
+			...fragment,
+			type: "section",
+			entries: dedupedEntries
+		});
+	} else {
+		if (!titledSectionMap.has(fragment.title)) {
+			titledSectionMap.set(fragment.title, []);
+			slots.push(fragment.title);
+		}
+		titledSectionMap.get(fragment.title).push(...fragment.entries);
+	}
+	const result = [];
+	for (const slot of slots) if (typeof slot === "string") {
+		const entries = deduplicateDocEntries(titledSectionMap.get(slot));
+		if (entries.length > 0) result.push({
+			type: "section",
+			title: slot,
+			entries
+		});
+	} else result.push(slot);
+	return result;
+}
 /**
 * Creates a deep clone of a {@link DocEntry}.  The `term` is cloned via
 * {@link cloneUsageTerm}, and `description`, `default`, and `choices`
@@ -344,4 +439,4 @@ function lastLineVisibleLength(text$1) {
 }
 
 //#endregion
-export { cloneDocEntry, formatDocPage };
+export { cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage };

package/dist/facade.cjs

@@ -3,9 +3,9 @@ const require_message = require('./message.cjs');
 const require_completion = require('./completion.cjs');
 const require_mode_dispatch = require('./mode-dispatch.cjs');
 const require_usage = require('./usage.cjs');
+const require_doc = require('./doc.cjs');
 const require_constructs = require('./constructs.cjs');
 const require_context = require('./context.cjs');
-const require_doc = require('./doc.cjs');
 const require_modifiers = require('./modifiers.cjs');
 const require_valueparser = require('./valueparser.cjs');
 const require_primitives = require('./primitives.cjs');

package/dist/facade.js

@@ -3,9 +3,9 @@ import { commandLine, formatMessage, lineBreak, message, optionName, text, value
 import { bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { dispatchByMode } from "./mode-dispatch.js";
 import { formatUsage } from "./usage.js";
+import { formatDocPage } from "./doc.js";
 import { group, longestMatch, object } from "./constructs.js";
 import { isPlaceholderValue } from "./context.js";
-import { formatDocPage } from "./doc.js";
 import { multiple, optional, withDefault } from "./modifiers.js";
 import { string } from "./valueparser.js";
 import { argument, command, constant, flag, option } from "./primitives.js";

package/dist/index.cjs

@@ -3,8 +3,8 @@ const require_message = require('./message.cjs');
 const require_completion = require('./completion.cjs');
 const require_dependency = require('./dependency.cjs');
 const require_usage = require('./usage.cjs');
-const require_constructs = require('./constructs.cjs');
 const require_doc = require('./doc.cjs');
+const require_constructs = require('./constructs.cjs');
 const require_modifiers = require('./modifiers.cjs');
 const require_nonempty = require('./nonempty.cjs');
 const require_valueparser = require('./valueparser.cjs');
@@ -34,6 +34,8 @@ exports.constant = require_primitives.constant;
 exports.createDeferredParseState = require_dependency.createDeferredParseState;
 exports.createDependencySourceState = require_dependency.createDependencySourceState;
 exports.createPendingDependencySourceState = require_dependency.createPendingDependencySourceState;
+exports.deduplicateDocEntries = require_doc.deduplicateDocEntries;
+exports.deduplicateDocFragments = require_doc.deduplicateDocFragments;
 exports.defaultValues = require_dependency.defaultValues;
 exports.deferredParseMarker = require_dependency.deferredParseMarker;
 exports.dependency = require_dependency.dependency;

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { Annotations, ParseOptions, annotationKey, getAnnotations } from "./anno
 import { NonEmptyString, ensureNonEmptyString, isNonEmptyString } from "./nonempty.cjs";
 import { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, lineBreak, link, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.cjs";
 import { HiddenVisibility, OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, cloneUsage, cloneUsageTerm, extractArgumentMetavars, extractCommandNames, extractOptionNames, formatUsage, formatUsageTerm, isDocHidden, isSuggestionHidden, isUsageHidden, mergeHidden, normalizeUsage } from "./usage.cjs";
-import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, formatDocPage } from "./doc.cjs";
+import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage } from "./doc.cjs";
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, DomainOptions, EmailOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, domain, email, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.cjs";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, GroupOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.cjs";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.cjs";
@@ -12,4 +12,4 @@ import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, Mode
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
 import { ParserValuePlaceholder, SourceContext } from "./context.cjs";
 import { CommandSubConfig, ContextOptionsParam, ExtractRequiredOptions, OptionSubConfig, RunOptions, RunParserError, RunWithOptions, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.cjs";
-export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { Annotations, ParseOptions, annotationKey, getAnnotations } from "./anno
 import { NonEmptyString, ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
 import { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, lineBreak, link, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.js";
 import { HiddenVisibility, OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, cloneUsage, cloneUsageTerm, extractArgumentMetavars, extractCommandNames, extractOptionNames, formatUsage, formatUsageTerm, isDocHidden, isSuggestionHidden, isUsageHidden, mergeHidden, normalizeUsage } from "./usage.js";
-import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, formatDocPage } from "./doc.js";
+import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage } from "./doc.js";
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, DomainOptions, EmailOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, domain, email, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.js";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, GroupOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
@@ -12,4 +12,4 @@ import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, Mode
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { ParserValuePlaceholder, SourceContext } from "./context.js";
 import { CommandSubConfig, ContextOptionsParam, ExtractRequiredOptions, OptionSubConfig, RunOptions, RunParserError, RunWithOptions, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.js";
-export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };

package/dist/index.js

@@ -3,8 +3,8 @@ import { commandLine, envVar, formatMessage, lineBreak, link, message, metavar,
 import { bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { DependencyRegistry, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker } from "./dependency.js";
 import { cloneUsage, cloneUsageTerm, extractArgumentMetavars, extractCommandNames, extractOptionNames, formatUsage, formatUsageTerm, isDocHidden, isSuggestionHidden, isUsageHidden, mergeHidden, normalizeUsage } from "./usage.js";
+import { cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage } from "./doc.js";
 import { DuplicateOptionError, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
-import { cloneDocEntry, formatDocPage } from "./doc.js";
 import { WithDefaultError, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
 import { checkBooleanOption, checkEnumOption, choice, cidr, domain, email, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.js";
@@ -12,4 +12,4 @@ import { argument, command, constant, fail, flag, option, passThrough } from "./
 import { getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
 import { RunParserError, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.js";
 
-export { DependencyRegistry, DuplicateOptionError, RunParserError, WithDefaultError, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };
+export { DependencyRegistry, DuplicateOptionError, RunParserError, WithDefaultError, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };

package/dist/parser.cjs

@@ -2,8 +2,8 @@ const require_annotations = require('./annotations.cjs');
 const require_message = require('./message.cjs');
 const require_mode_dispatch = require('./mode-dispatch.cjs');
 const require_usage = require('./usage.cjs');
-const require_constructs = require('./constructs.cjs');
 const require_doc = require('./doc.cjs');
+const require_constructs = require('./constructs.cjs');
 const require_modifiers = require('./modifiers.cjs');
 const require_primitives = require('./primitives.cjs');
 

package/dist/parser.js

@@ -2,8 +2,8 @@ import { injectAnnotations, isInjectedAnnotationWrapper, unwrapInjectedAnnotatio
 import { cloneMessage, message } from "./message.js";
 import { dispatchByMode } from "./mode-dispatch.js";
 import { cloneUsage, normalizeUsage } from "./usage.js";
-import { DuplicateOptionError, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { cloneDocEntry } from "./doc.js";
+import { DuplicateOptionError, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { WithDefaultError, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1326+40fd572e",
+  "version": "1.0.0-dev.1344+e7f36975",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",