@gajae-code/tui 0.11.6 → 0.11.7

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## [Unreleased]
 
+## [0.11.7] - 2026-07-22
+### Fixed
+
+- Internal transcript PageUp/PageDown now continues through tool-output and other non-semantic rows instead of intermittently becoming a no-op after a semantic viewport anchor was established.
+
+### Fixed
+
+- Spurious resize events with unchanged terminal dimensions (iTerm2 tab switches and window focus changes deliver SIGWINCH without a size change) no longer trigger a forced full redraw. On hosts still using the full clear+replay path (legacy multiplexer opt-in, non-process terminals) that redraw cleared scrollback (`2J`/`H`/`3J`) and replayed the entire transcript, which could park the native viewport at the top of the thread when returning to the tab. `requestResizeRender()` now forces only when the grid size actually changed since the last committed frame; same-size events fall through to a no-op diff render.
+
 ## [0.11.4] - 2026-07-20
 ### Fixed
 

package/dist/types/tui.d.ts

@@ -281,6 +281,15 @@ export declare class TUI extends Container {
      * the transcript top during streaming redraws, so viewport-repaint sessions
      * keep force off and let `#doRender` repaint only the live viewport. Set
      * `PI_TUI_LEGACY_MULTIPLEXER_FULL_RENDER=1` to restore the legacy tmux redraw.
+     *
+     * Spurious resize events (SIGWINCH with unchanged dimensions — iTerm2 tab
+     * switches and window focus changes, the self-sent SIGWINCH after resume)
+     * must not force either: on hosts still using the `fullRender` path (legacy
+     * multiplexer opt-in, non-process terminals) the forced redraw clears
+     * scrollback (`2J`/`H`/`3J`) and replays the whole transcript, which can
+     * park the native viewport at the transcript top. Only force when the grid
+     * size actually changed since the last committed frame; a plain diff render
+     * is a no-op otherwise.
      */
     requestResizeRender(): void;
     requestRender(force?: boolean, source?: string): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.11.6",
+	"version": "0.11.7",
 	"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.11.6",
-		"@gajae-code/utils": "0.11.6",
+		"@gajae-code/natives": "0.11.7",
+		"@gajae-code/utils": "0.11.7",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},

package/src/tui.ts

@@ -895,7 +895,14 @@ export class TUI extends Container {
 					selected = { row, anchor };
 			}
 			if (selected === undefined) {
-				if (this.#manualViewportAnchor !== null) return false;
+				// A page can consist entirely of non-semantic rows such as tool output,
+				// transient panels, or pinned chrome. Fall back to numeric viewport
+				// ownership so PageUp/PageDown can continue through those rows instead
+				// of becoming an intermittent no-op. A later page with an eligible row
+				// will establish a fresh semantic anchor.
+				this.#manualViewportAnchor = null;
+				this.#manualViewportFallbackAnchors = [];
+				this.#reconcileMissingViewportAnchor = false;
 			} else {
 				this.#manualViewportAnchor = {
 					id: selected.anchor.id,
@@ -1339,9 +1346,20 @@ export class TUI extends Container {
 	 * the transcript top during streaming redraws, so viewport-repaint sessions
 	 * keep force off and let `#doRender` repaint only the live viewport. Set
 	 * `PI_TUI_LEGACY_MULTIPLEXER_FULL_RENDER=1` to restore the legacy tmux redraw.
+	 *
+	 * Spurious resize events (SIGWINCH with unchanged dimensions — iTerm2 tab
+	 * switches and window focus changes, the self-sent SIGWINCH after resume)
+	 * must not force either: on hosts still using the `fullRender` path (legacy
+	 * multiplexer opt-in, non-process terminals) the forced redraw clears
+	 * scrollback (`2J`/`H`/`3J`) and replays the whole transcript, which can
+	 * park the native viewport at the transcript top. Only force when the grid
+	 * size actually changed since the last committed frame; a plain diff render
+	 * is a no-op otherwise.
 	 */
 	requestResizeRender(): void {
-		this.requestRender(!useViewportRepaintPath(this.terminal), "resize");
+		const dimensionsChanged =
+			this.#previousWidth !== this.terminal.columns || this.#previousHeight !== this.terminal.rows;
+		this.requestRender(dimensionsChanged && !useViewportRepaintPath(this.terminal), "resize");
 	}
 
 	requestRender(force = false, source = "unknown"): void {