@optique/core 0.7.15 → 0.7.16

package/dist/constructs.cjs

@@ -882,6 +882,9 @@ function merge(...args) {
 			});
 		},
 		getDocFragments(state, _defaultValue) {
+			let brief;
+			let description;
+			let footer;
 			const fragments = parsers.flatMap((p, i) => {
 				let parserState;
 				if (p.initialState === void 0) {
@@ -895,7 +898,11 @@ function merge(...args) {
 					kind: "available",
 					state: state.state
 				};
-				return p.getDocFragments(parserState, void 0).fragments;
+				const docFragments = p.getDocFragments(parserState, void 0);
+				brief ??= docFragments.brief;
+				description ??= docFragments.description;
+				footer ??= docFragments.footer;
+				return docFragments.fragments;
 			});
 			const entries = fragments.filter((f) => f.type === "entry");
 			const sections = [];
@@ -910,18 +917,28 @@ function merge(...args) {
 					entries
 				};
 				sections.push(labeledSection);
-				return { fragments: sections.map((s) => ({
+				return {
+					brief,
+					description,
+					footer,
+					fragments: sections.map((s) => ({
+						...s,
+						type: "section"
+					}))
+				};
+			}
+			return {
+				brief,
+				description,
+				footer,
+				fragments: [...sections.map((s) => ({
 					...s,
 					type: "section"
-				})) };
-			}
-			return { fragments: [...sections.map((s) => ({
-				...s,
-				type: "section"
-			})), {
-				type: "section",
-				entries
-			}] };
+				})), {
+					type: "section",
+					entries
+				}]
+			};
 		}
 	};
 }
@@ -1112,10 +1129,17 @@ function group(label, parser) {
 			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 = {
+			const initialFragments = parser.getDocFragments({
+				kind: "available",
+				state: parser.initialState
+			}, void 0);
+			const initialHasCommands = initialFragments.fragments.some((f) => f.type === "entry" && f.term.type === "command" || f.type === "section" && f.entries.some((e) => e.term.type === "command"));
+			const currentHasCommands = allEntries.some((e) => e.term.type === "command");
+			const applyLabel = !initialHasCommands || currentHasCommands;
+			const labeledSection = applyLabel ? {
 				title: label,
 				entries: allEntries
-			};
+			} : { entries: allEntries };
 			return {
 				description,
 				fragments: [...titledSections.map((s) => ({

package/dist/constructs.js

@@ -882,6 +882,9 @@ function merge(...args) {
 			});
 		},
 		getDocFragments(state, _defaultValue) {
+			let brief;
+			let description;
+			let footer;
 			const fragments = parsers.flatMap((p, i) => {
 				let parserState;
 				if (p.initialState === void 0) {
@@ -895,7 +898,11 @@ function merge(...args) {
 					kind: "available",
 					state: state.state
 				};
-				return p.getDocFragments(parserState, void 0).fragments;
+				const docFragments = p.getDocFragments(parserState, void 0);
+				brief ??= docFragments.brief;
+				description ??= docFragments.description;
+				footer ??= docFragments.footer;
+				return docFragments.fragments;
 			});
 			const entries = fragments.filter((f) => f.type === "entry");
 			const sections = [];
@@ -910,18 +917,28 @@ function merge(...args) {
 					entries
 				};
 				sections.push(labeledSection);
-				return { fragments: sections.map((s) => ({
+				return {
+					brief,
+					description,
+					footer,
+					fragments: sections.map((s) => ({
+						...s,
+						type: "section"
+					}))
+				};
+			}
+			return {
+				brief,
+				description,
+				footer,
+				fragments: [...sections.map((s) => ({
 					...s,
 					type: "section"
-				})) };
-			}
-			return { fragments: [...sections.map((s) => ({
-				...s,
-				type: "section"
-			})), {
-				type: "section",
-				entries
-			}] };
+				})), {
+					type: "section",
+					entries
+				}]
+			};
 		}
 	};
 }
@@ -1112,10 +1129,17 @@ function group(label, parser) {
 			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 = {
+			const initialFragments = parser.getDocFragments({
+				kind: "available",
+				state: parser.initialState
+			}, void 0);
+			const initialHasCommands = initialFragments.fragments.some((f) => f.type === "entry" && f.term.type === "command" || f.type === "section" && f.entries.some((e) => e.term.type === "command"));
+			const currentHasCommands = allEntries.some((e) => e.term.type === "command");
+			const applyLabel = !initialHasCommands || currentHasCommands;
+			const labeledSection = applyLabel ? {
 				title: label,
 				entries: allEntries
-			};
+			} : { entries: allEntries };
 			return {
 				description,
 				fragments: [...titledSections.map((s) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.7.15",
+  "version": "0.7.16",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",