@gajae-code/tui 0.18.9 → 0.18.11

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased]
 
+## [0.18.11] - 2026-10-12
+
+### Fixed
+
+- Fixed the viewport going blank above the status line and input box when a tall live block (task output, streaming tool output) collapsed with `clearOnShrink` off: the TUI now replays the frame when padding to the committed frontier would leave no transcript row on screen.
+
+## [0.18.10] - 2026-10-12
+
+### Fixed
+
+- TUI no longer goes blank after stop/restart cycles: `#hardwareCursorRow` is now properly reset during `stop()` to prevent stale cursor position state from corrupting viewport calculations on the next `start()`.
+
+- With `clearOnShrink` enabled, a live block that shrinks after the transcript has scrolled into history no longer leaves blank spacer rows above the pinned composer until the next resize. The contraction now clears the screen and history and replays the frame, so the viewport is filled again and no row appears twice in history.
+
 ## [0.18.9] - 2026-10-11
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.18.9",
+	"version": "0.18.11",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://gajae-code.com",
 	"author": "Yeachan-Heo and Gajae Code Contributors",
@@ -36,8 +36,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@gajae-code/natives": "0.18.9",
-		"@gajae-code/utils": "0.18.9",
+		"@gajae-code/natives": "0.18.11",
+		"@gajae-code/utils": "0.18.11",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},

package/src/tui.ts

@@ -1152,6 +1152,7 @@ export class TUI extends Container {
 	#fullRedrawCount = 0;
 	#stopped = false;
 	#terminalUnavailable = false;
+	#restartNeedsClear = false; // Set when stop() resets viewport state
 	#bottomPinnedComponent: Component | null = null;
 	#pendingTerminalCleanup: Array<{ payload: string; onDelivered?: () => void }> = [];
 	#mouseSelectionStart: MouseSelectionPoint | null = null;
@@ -1432,6 +1433,11 @@ export class TUI extends Container {
 		this.#clearOnShrink = enabled;
 	}
 
+	/** Overlays rely on padded rows, so contraction replays only without them. */
+	#clearOnShrinkReplays(): boolean {
+		return this.#clearOnShrink && this.overlayStack.length === 0;
+	}
+
 	setFocus(component: Component | null): void {
 		// Clear focused flag on old component
 		if (isFocusable(this.#focusedComponent)) {
@@ -2981,6 +2987,12 @@ export class TUI extends Container {
 		this.#lineEmitWidthCache.clear();
 		this.#previousWidth = 0;
 		this.#previousHeight = 0;
+		this.#cursorRow = 0;
+		this.#hardwareCursorRow = 0;
+		this.#viewportTopRow = 0;
+		this.#maxLinesRendered = 0;
+		// Mark that the next initial render needs to clear the screen after terminal reset
+		this.#restartNeedsClear = true;
 		this.#forcedRenderPreviousWidth = 0;
 		this.#forcedRenderPreviousHeight = 0;
 		this.#transcriptRebuildPending = false;
@@ -5228,6 +5240,7 @@ export class TUI extends Container {
 		let usedWindowNormalize = false;
 		let stitched = false;
 		let frontierSpacerLineCount = 0;
+		let strandedContractionReplay = false;
 		if (reusedAnchor !== null && layoutPrefixEligible && !layoutPrefixBlocked) {
 			const reused = this.#reuseCachedLayoutPrefix(
 				width,
@@ -5268,12 +5281,32 @@ export class TUI extends Container {
 			if (hasStickySuffix && height > 0 && this.#manualViewportTop === undefined) {
 				// Rebuilds start at their new transcript frontier. Forced redraws use the
 				// captured rendered dimensions rather than their -1 invalidation sentinels.
+				// clearOnShrink replays the whole frame on contraction instead; spacer rows
+				// would otherwise stay on screen as a blank gap above the pinned component.
 				const preserveLiveFrontier =
+					!this.#clearOnShrinkReplays() &&
 					!transcriptIdentityReplaced &&
 					!transcriptRebuildPending &&
 					frontierPreviousWidth === width &&
 					(frontierPreviousHeight === height || this.#viewportRepaintHost());
-				const minimumLineCount = preserveLiveFrontier ? prevViewportTop + height : height;
+				// Padding to the committed frontier keeps scrollback rows from being
+				// repainted, but when the contraction ends the transcript at or above that
+				// frontier the padded viewport holds nothing but spacer rows. Replay the
+				// frame instead of leaving a blank screen above the pinned component. A
+				// pinned suffix that already fills the viewport hides the spacers, so it
+				// keeps the frontier and its scrollback.
+				strandedContractionReplay =
+					preserveLiveFrontier &&
+					!heightChanged &&
+					frontierPreviousHeight === height &&
+					this.overlayStack.length === 0 &&
+					prevViewportTop > 0 &&
+					sourceTranscriptLineCount > 0 &&
+					sourceTranscriptLineCount <= prevViewportTop &&
+					newLines.length < prevViewportTop + height &&
+					newLines.length - sourceTranscriptLineCount < height;
+				const minimumLineCount =
+					preserveLiveFrontier && !strandedContractionReplay ? prevViewportTop + height : height;
 				const padded = this.#padBeforeBottomPinnedComponent(
 					newLines,
 					minimumLineCount,
@@ -5788,9 +5821,12 @@ export class TUI extends Container {
 			return;
 		}
 		// First render - just output everything without clearing (assumes clean screen)
+		// unless we're restarting after a stop() which leaves stale content
 		if (initialRender) {
 			logRedraw("first render");
-			fullRender(false, "first render");
+			const shouldClear = this.#restartNeedsClear;
+			this.#restartNeedsClear = false;
+			fullRender(shouldClear, "first render");
 			return;
 		}
 
@@ -5848,13 +5884,19 @@ export class TUI extends Container {
 		// Content shrunk below the previous render and no overlays - re-render to clear empty rows
 		// (overlays need the padding, so only do this when no overlays are active)
 		// Configurable via setClearOnShrink() or GJC_CLEAR_ON_SHRINK=0 env var
-		if (this.#clearOnShrink && newLines.length < this.#previousLines.length && this.overlayStack.length === 0) {
+		// Erase native scrollback too: scrolled-off rows cannot be pulled back into the
+		// viewport, and repainting them on screen would duplicate them in history.
+		if (this.#clearOnShrinkReplays() && newLines.length < this.#previousLines.length) {
 			logRedraw(`clearOnShrink (prev=${this.#previousLines.length}, new=${newLines.length})`);
-			if (useViewportRepaintPath) {
-				viewportRepaint(`clearOnShrink (prev=${this.#previousLines.length}, new=${newLines.length})`);
-			} else {
-				fullRender(true, "clearOnShrink");
-			}
+			fullRender(true, "clearOnShrink", true);
+			return;
+		}
+		// Default (clearOnShrink off) still replays when frontier padding would leave the
+		// viewport with no transcript row, e.g. a tall live block collapsing back into
+		// history. Same scrollback erase as above, for the same duplication reason.
+		if (strandedContractionReplay) {
+			logRedraw(`stranded contraction (prev=${this.#previousLines.length}, new=${newLines.length})`);
+			fullRender(true, "stranded contraction", true);
 			return;
 		}