@optique/core 1.0.0-dev.487 → 1.0.0-dev.488

package/dist/doc.cjs

@@ -27,9 +27,10 @@ function scoreSection(section) {
 /**
 * The default section comparator: command-only sections come first, then
 * mixed sections, then option/argument-only sections.  Untitled sections
-* receive a slight priority boost so the main (untitled) section appears
-* before titled sections of a similar classification.  Sections with the
-* same score preserve their original relative order (stable sort).
+* receive a score bonus of -1 via {@link scoreSection} so that untitled
+* command-only sections naturally sort before titled command-only sections.
+* Sections with the same score preserve their original relative order
+* (stable sort).
 */
 function defaultSectionOrder(a, b) {
 	return scoreSection(a) - scoreSection(b);
@@ -103,8 +104,7 @@ function formatDocPage(programName, page, options = {}) {
 	})).toSorted((a, b) => {
 		const cmp = comparator(a.section, b.section);
 		if (cmp !== 0) return cmp;
-		const titleCmp = (a.section.title == null ? 0 : 1) - (b.section.title == null ? 0 : 1);
-		return titleCmp !== 0 ? titleCmp : a.index - b.index;
+		return a.index - b.index;
 	}).map(({ section }) => section);
 	for (const section of sections) {
 		if (section.entries.length < 1) continue;

package/dist/doc.js

@@ -27,9 +27,10 @@ function scoreSection(section) {
 /**
 * The default section comparator: command-only sections come first, then
 * mixed sections, then option/argument-only sections.  Untitled sections
-* receive a slight priority boost so the main (untitled) section appears
-* before titled sections of a similar classification.  Sections with the
-* same score preserve their original relative order (stable sort).
+* receive a score bonus of -1 via {@link scoreSection} so that untitled
+* command-only sections naturally sort before titled command-only sections.
+* Sections with the same score preserve their original relative order
+* (stable sort).
 */
 function defaultSectionOrder(a, b) {
 	return scoreSection(a) - scoreSection(b);
@@ -103,8 +104,7 @@ function formatDocPage(programName, page, options = {}) {
 	})).toSorted((a, b) => {
 		const cmp = comparator(a.section, b.section);
 		if (cmp !== 0) return cmp;
-		const titleCmp = (a.section.title == null ? 0 : 1) - (b.section.title == null ? 0 : 1);
-		return titleCmp !== 0 ? titleCmp : a.index - b.index;
+		return a.index - b.index;
 	}).map(({ section }) => section);
 	for (const section of sections) {
 		if (section.entries.length < 1) continue;

package/dist/parser.cjs

@@ -387,14 +387,34 @@ function buildDocPage(parser, context, args) {
 		kind: "available",
 		state: context.state
 	}, void 0);
-	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);
+	const buildingSections = [];
+	let untitledSection = null;
+	const titledSectionMap = /* @__PURE__ */ new Map();
+	for (const fragment of fragments) if (fragment.type === "entry") {
+		if (untitledSection == null) {
+			untitledSection = { entries: [] };
+			buildingSections.push(untitledSection);
+		}
+		untitledSection.entries.push(fragment);
+	} else if (fragment.type === "section") if (fragment.title == null) {
+		if (untitledSection == null) {
+			untitledSection = { entries: [] };
+			buildingSections.push(untitledSection);
+		}
+		untitledSection.entries.push(...fragment.entries);
+	} else {
+		let section = titledSectionMap.get(fragment.title);
+		if (section == null) {
+			section = {
+				title: fragment.title,
+				entries: []
+			};
+			titledSectionMap.set(fragment.title, section);
+			buildingSections.push(section);
+		}
+		section.entries.push(...fragment.entries);
 	}
-	if (entries.length > 0) sections.push({ entries });
+	const sections = buildingSections;
 	const usage = [...require_usage.normalizeUsage(parser.usage)];
 	let i = 0;
 	for (const arg of args) {

package/dist/parser.js

@@ -387,14 +387,34 @@ function buildDocPage(parser, context, args) {
 		kind: "available",
 		state: context.state
 	}, void 0);
-	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);
+	const buildingSections = [];
+	let untitledSection = null;
+	const titledSectionMap = /* @__PURE__ */ new Map();
+	for (const fragment of fragments) if (fragment.type === "entry") {
+		if (untitledSection == null) {
+			untitledSection = { entries: [] };
+			buildingSections.push(untitledSection);
+		}
+		untitledSection.entries.push(fragment);
+	} else if (fragment.type === "section") if (fragment.title == null) {
+		if (untitledSection == null) {
+			untitledSection = { entries: [] };
+			buildingSections.push(untitledSection);
+		}
+		untitledSection.entries.push(...fragment.entries);
+	} else {
+		let section = titledSectionMap.get(fragment.title);
+		if (section == null) {
+			section = {
+				title: fragment.title,
+				entries: []
+			};
+			titledSectionMap.set(fragment.title, section);
+			buildingSections.push(section);
+		}
+		section.entries.push(...fragment.entries);
 	}
-	if (entries.length > 0) sections.push({ entries });
+	const sections = buildingSections;
 	const usage = [...normalizeUsage(parser.usage)];
 	let i = 0;
 	for (const arg of args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.487+3c38bb65",
+  "version": "1.0.0-dev.488+690cf201",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",