@optique/core 1.4.0-dev.2720 → 1.4.0-dev.2723

package/dist/doc.cjs

@@ -555,8 +555,8 @@ function formatDocPage(programName, page, options = {}) {
 			const appendAnnotation = (content, layout, style, ambient, quotes) => {
 				let prefixText = layout.prefix;
 				let prefix = require_text_layout.placeText(prefixText, cursor, descColumnWidth, 1);
-				if (prefix.text !== layout.prefix) {
-					description += "\n";
+				if (prefix.text !== layout.prefix || descColumnWidth != null && cursor.column === 0 && layout.prefixMetrics.firstLineWidth > descColumnWidth) {
+					if (cursor.column > 0) description += "\n";
 					prefixText = require_text_layout.trimLeadingSpace(layout.prefix);
 					prefix = require_text_layout.placeText(prefixText, {
 						line: "",

package/dist/doc.js

@@ -555,8 +555,8 @@ function formatDocPage(programName, page, options = {}) {
 			const appendAnnotation = (content, layout, style, ambient, quotes) => {
 				let prefixText = layout.prefix;
 				let prefix = placeText(prefixText, cursor, descColumnWidth, 1);
-				if (prefix.text !== layout.prefix) {
-					description += "\n";
+				if (prefix.text !== layout.prefix || descColumnWidth != null && cursor.column === 0 && layout.prefixMetrics.firstLineWidth > descColumnWidth) {
+					if (cursor.column > 0) description += "\n";
 					prefixText = trimLeadingSpace(layout.prefix);
 					prefix = placeText(prefixText, {
 						line: "",

package/dist/text-layout.cjs

@@ -67,8 +67,9 @@ function trimLeadingSpace(text) {
 * Measures an annotation's fixed text without invoking theme callbacks.
 * @param prefix The already joined prefix and optional label.
 * @param suffix The closing text.
-* @returns Geometry reserving at least one content column after the suffix's
-* first-line width has been deducted from the formatter budget.
+* @returns Geometry for a heading placed on a fresh line without its leading
+* separator whitespace, reserving at least one content column after the
+* suffix's first-line width has been deducted from the formatter budget.
 * @internal
 */
 function measureAnnotation(prefix, suffix) {
@@ -79,7 +80,7 @@ function measureAnnotation(prefix, suffix) {
 		suffix,
 		prefixMetrics,
 		suffixMetrics,
-		minWidth: Math.max(prefixMetrics.maxLineWidth, suffixMetrics.maxLineWidth, suffixMetrics.firstLineWidth + 1)
+		minWidth: Math.max(measureText(trimLeadingSpace(prefix)).maxLineWidth, suffixMetrics.maxLineWidth, suffixMetrics.firstLineWidth + 1)
 	};
 }
 /**

package/dist/text-layout.js

@@ -67,8 +67,9 @@ function trimLeadingSpace(text) {
 * Measures an annotation's fixed text without invoking theme callbacks.
 * @param prefix The already joined prefix and optional label.
 * @param suffix The closing text.
-* @returns Geometry reserving at least one content column after the suffix's
-* first-line width has been deducted from the formatter budget.
+* @returns Geometry for a heading placed on a fresh line without its leading
+* separator whitespace, reserving at least one content column after the
+* suffix's first-line width has been deducted from the formatter budget.
 * @internal
 */
 function measureAnnotation(prefix, suffix) {
@@ -79,7 +80,7 @@ function measureAnnotation(prefix, suffix) {
 		suffix,
 		prefixMetrics,
 		suffixMetrics,
-		minWidth: Math.max(prefixMetrics.maxLineWidth, suffixMetrics.maxLineWidth, suffixMetrics.firstLineWidth + 1)
+		minWidth: Math.max(measureText(trimLeadingSpace(prefix)).maxLineWidth, suffixMetrics.maxLineWidth, suffixMetrics.firstLineWidth + 1)
 	};
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.4.0-dev.2720",
+  "version": "1.4.0-dev.2723",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -245,7 +245,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.4.0-dev.2720+93db84aa",
+    "@optique/env": "1.4.0-dev.2723+56e838af",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",