@oh-my-pi/pi-tui 16.4.5 → 16.4.6

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [16.4.6] - 2026-07-12
+
+### Added
+
+- Added support for width-changing editor text decorators on standalone presentation lines, with decorated output safely truncated to the available content width.
+
 ## [16.4.5] - 2026-07-11
 
 ### Added

package/dist/types/components/editor.d.ts

@@ -31,9 +31,9 @@ export declare class Editor implements Component, Focusable {
     cursorOverride: string | undefined;
     /** Display width of the cursorOverride glyph (needed because override may contain ANSI escapes). */
     cursorOverrideWidth: number | undefined;
-    /** Optional hook that styles displayed input text with zero-width ANSI escapes.
-     *  MUST preserve visible width (may only add SGR codes, never glyphs). Applied per
-     *  layout line to the user-text segments — never to the cursor glyph or inline hint. */
+    /** Optional hook that decorates displayed user text after source-text layout.
+     *  Width-changing output is allowed on lines without the cursor; it is truncated
+     *  to the content width rather than reflowed. Cursor glyphs and inline hints are excluded. */
     decorateText: ((text: string) => string) | undefined;
     borderColor: (str: string) => string;
     onAutocompleteUpdate?: () => void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "16.4.5",
+	"version": "16.4.6",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "16.4.5",
-		"@oh-my-pi/pi-utils": "16.4.5",
+		"@oh-my-pi/pi-natives": "16.4.6",
+		"@oh-my-pi/pi-utils": "16.4.6",
 		"lru-cache": "11.5.1",
 		"marked": "^18.0.5"
 	},

package/src/components/editor.ts

@@ -387,9 +387,9 @@ export class Editor implements Component, Focusable {
 	cursorOverride: string | undefined;
 	/** Display width of the cursorOverride glyph (needed because override may contain ANSI escapes). */
 	cursorOverrideWidth: number | undefined;
-	/** Optional hook that styles displayed input text with zero-width ANSI escapes.
-	 *  MUST preserve visible width (may only add SGR codes, never glyphs). Applied per
-	 *  layout line to the user-text segments — never to the cursor glyph or inline hint. */
+	/** Optional hook that decorates displayed user text after source-text layout.
+	 *  Width-changing output is allowed on lines without the cursor; it is truncated
+	 *  to the content width rather than reflowed. Cursor glyphs and inline hints are excluded. */
 	decorateText: ((text: string) => string) | undefined;
 	#promptGutter: string | undefined;
 
@@ -1001,6 +1001,13 @@ export class Editor implements Component, Focusable {
 			if (!decorated) {
 				displayText = this.#decorate(displayText);
 			}
+			if (!hasCursor) {
+				displayWidth = visibleWidth(displayText);
+				if (displayWidth > lineContentWidth) {
+					displayText = truncateToWidth(displayText, lineContentWidth);
+					displayWidth = visibleWidth(displayText);
+				}
+			}
 
 			const linePad = padding(Math.max(0, lineContentWidth - displayWidth));