@lewishowles/cli-style 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.12.1 - 2026-08-20
+
+### Fixed
+
+- Fixed `row()` (and `rowGroup()`) wrapping long values one character per line when a long label left very little room for the value. Values now print unwrapped when the available width is too small to wrap usefully; an explicit `wrapWidth` still overrides the fallback.
+
 ## 0.12.0 - 2026-08-20
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lewishowles/cli-style",
-	"version": "0.12.0",
+	"version": "0.12.1",
 	"description": "Shared terminal output styles for Lewis Howles tools, diagnostics, and package CLIs.",
 	"license": "MIT",
 	"repository": {

package/src/gallery/render-gallery.js

@@ -831,6 +831,10 @@ function renderPrimitives(options) {
 				wrap: false,
 			},
 		),
+		row("Long label ".repeat(10), "pending (chk_example)", {
+			...options,
+			width: 80,
+		}),
 		"",
 		"Row groups",
 		rowGroup({

package/src/primitives/row.js

@@ -11,6 +11,9 @@ const defaultSeparator = "  ";
 // Keeps a wrapped value within a typical narrow terminal column.
 const defaultWrapWidth = 64;
 
+// Avoid character-per-line wrapping when labels leave no useful value width.
+const minimumWrapWidth = 10;
+
 /**
  * Render a labelled value row.
  *
@@ -33,7 +36,9 @@ const defaultWrapWidth = 64;
  * @param  {string}  options.valueColour
  *     Optional colour token for the value.
  * @param  {number}  options.width
- *     Total row width used to calculate the available value width.
+ *     Total row width used to calculate the available value width. When a
+ *     long label leaves less than the minimum wrap width, the value renders
+ *     unwrapped on one line instead of wrapping.
  * @param  {boolean}  options.wrap
  *     Set to false to keep the value on one line instead of wrapping it.
  * @param  {number}  options.wrapWidth
@@ -54,16 +59,23 @@ export function row(label, value = "", options = {}) {
 
 	const renderedValue = renderValue(value, options);
 	const separator = options.separator ?? defaultSeparator;
+	const unwrappedRow = `${renderedLabel}${separator}${renderedValue}`;
 
 	if (options.wrap === false) {
-		return `${renderedLabel}${separator}${renderedValue}`;
+		return unwrappedRow;
+	}
+
+	const availableWrapWidth = Number.isFinite(options.width)
+		? options.width - labelWidth - separator.length
+		: defaultWrapWidth;
+
+	const hasExplicitWrapWidth = options.wrapWidth !== undefined && options.wrapWidth !== null;
+
+	if (!hasExplicitWrapWidth && availableWrapWidth < minimumWrapWidth) {
+		return unwrappedRow;
 	}
 
-	const wrapWidth =
-		options.wrapWidth ??
-		(Number.isFinite(options.width)
-			? Math.max(1, options.width - labelWidth - separator.length)
-			: defaultWrapWidth);
+	const wrapWidth = options.wrapWidth ?? availableWrapWidth;
 
 	const valueLines = wrapText(value, wrapWidth);
 	const continuationIndent = " ".repeat(labelWidth + separator.length);