@oh-my-pi/pi-tui 17.2.14 → 17.3.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [17.3.0] - 2026-08-13
+
+### Fixed
+
+- Fixed an issue where repeated pane-width adjustments or terminal resizing could corrupt native scrollback and soft-wrap behavior.
+- Fixed an issue where scaled OSC 66 Markdown headings (such as "Large Headings" on Kitty) would render as invisible placeholders or get partially cleared after a redraw or terminal resize.
+
 ## [17.2.13] - 2026-08-11
 
 ### Fixed

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

@@ -15,6 +15,8 @@ export interface EditorTopBorder {
     content: string;
     /** Visible width of the content */
     width: number;
+    /** Optional logical revision that changes independently of available width. */
+    revision?: number;
 }
 interface HistoryEntry {
     prompt: string;
@@ -74,8 +76,9 @@ export declare class Editor implements Component, Focusable {
      *
      * Use this when the top border derives from state that mutates far faster
      * than the render cadence (session events, streaming, subagent updates).
-     * The TUI already throttles renders, so a provider is invoked at most once
-     * per frame and never does wasted work between paints.
+     * The TUI already throttles renders, so a provider is invoked exactly once
+     * per frame and does no work between paints. Return a logical `revision` to
+     * distinguish concurrent status mutations from pure width reflow.
      */
     setTopBorderProvider(provider: ((availableWidth: number) => EditorTopBorder | undefined) | undefined): void;
     /**
@@ -111,6 +114,7 @@ export declare class Editor implements Component, Focusable {
     render(width: number): readonly string[];
     handleInput(data: string): void;
     getText(): string;
+    getNativeScrollbackWidthEpochRevision(): number;
     /** Whether the buffer text equals `value`, without `getText()`'s full join —
      *  O(1) for the hot per-keystroke probes against short single-line values. */
     textEquals(value: string): boolean;

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

@@ -92,6 +92,12 @@ export declare class ImageBudget {
      * re-emission.
      */
     observeCommitWatermark(committedTo: number): void;
+    /**
+     * End the physical-row coordinate epoch after observing its final commit
+     * watermark. Placement ids and latched archive state survive, but attachment
+     * rows do not: the next placement emit records them in the new-width frame.
+     */
+    beginPlacementCoordinateEpoch(): void;
     /**
      * Resolve the placement id and geometry for a direct-placement emit whose
      * topmost attached cell sits at `attachTopFrameRow` — the first frame row

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

@@ -1,5 +1,5 @@
 import type { SymbolTheme } from "../symbols.js";
-import type { Component, NativeScrollbackCommittedRows, NativeScrollbackReplay } from "../tui.js";
+import type { Component, NativeScrollbackCommittedRows, NativeScrollbackReplay, NativeScrollbackWidthEpoch } from "../tui.js";
 /** @internal exported for tests — must stay index-identical to the old regex scan. */
 export declare function mathStartIndex(src: string): number | undefined;
 /** @internal exported for tests — must stay index-identical to the old regex scan. */
@@ -53,7 +53,7 @@ export interface MarkdownTheme {
     resolveMermaidAscii?: (source: string, maxWidth?: number) => string | null;
     symbols: SymbolTheme;
 }
-export declare class Markdown implements Component, NativeScrollbackCommittedRows, NativeScrollbackReplay {
+export declare class Markdown implements Component, NativeScrollbackCommittedRows, NativeScrollbackReplay, NativeScrollbackWidthEpoch {
     #private;
     setIgnoreTight(ignore: boolean): this;
     constructor(text: string, paddingX: number, paddingY: number, theme: MarkdownTheme, defaultTextStyle?: DefaultTextStyle, codeBlockIndent?: number);
@@ -71,6 +71,10 @@ export declare class Markdown implements Component, NativeScrollbackCommittedRow
      * lineage), and on cache-served non-streaming renders.
      */
     getLastRenderSettledRows(): number;
+    captureNativeScrollbackWidthEpoch(): unknown;
+    resolveNativeScrollbackWidthEpoch(boundary: unknown): number | undefined;
+    getNativeScrollbackWidthEpochRows(): number | undefined;
+    isNativeScrollbackWidthEpochAppendOnly(boundary: unknown): boolean;
     /**
      * Freeze every table whose first physical row is already part of the native
      * scrollback prefix. The recorded widths came from the exact frame that was

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

@@ -14,6 +14,7 @@ export declare class Text implements Component {
     constructor(text?: string, paddingX?: number, paddingY?: number, customBgFn?: (text: string) => string);
     getText(): string;
     setText(text: string): boolean;
+    getNativeScrollbackWidthEpochRevision(): number;
     setCustomBgFn(customBgFn?: (text: string) => string): void;
     /**
      * Supply a foreground styler applied to the text at render time (e.g. a

package/dist/types/tui.d.ts

@@ -102,6 +102,21 @@ export interface NativeScrollbackLiveRegion {
 export interface NativeScrollbackCommittedRows {
     setNativeScrollbackCommittedRows(rows: number): void;
 }
+/**
+ * Width-independent source boundary for multiplexer resize epochs. Capture
+ * reads the last rendered source state; resolve maps that same logical boundary
+ * into the most recent render's physical rows at its new width. The current
+ * boundary identifies the source tail after updates queued during the resize.
+ */
+export interface NativeScrollbackWidthEpoch {
+    captureNativeScrollbackWidthEpoch(): unknown;
+    resolveNativeScrollbackWidthEpoch(boundary: unknown): number | undefined;
+    getNativeScrollbackWidthEpochRows(): number | undefined;
+    /** False when updates can insert before captured trailing rows. */
+    isNativeScrollbackWidthEpochAppendOnly?(boundary: unknown): boolean;
+    /** Changes when child structure mutates independently of width reflow. */
+    getNativeScrollbackWidthEpochRevision?(): number;
+}
 /**
  * A component that discards rows after they enter native scrollback implements
  * this hook so a destructive full replay can rehydrate its complete frame.
@@ -261,7 +276,7 @@ export interface OverlayHandle {
 /**
  * Container - a component that contains other components
  */
-export declare class Container implements Component, NativeScrollbackCommittedRows, NativeScrollbackReplay {
+export declare class Container implements Component, NativeScrollbackCommittedRows, NativeScrollbackReplay, NativeScrollbackWidthEpoch {
     #private;
     children: Component[];
     setIgnoreTight(ignore: boolean): this;
@@ -287,6 +302,11 @@ export declare class Container implements Component, NativeScrollbackCommittedRo
     setNativeScrollbackCommittedRows(rows: number): void;
     /** Recursively discard layout locks that are meaningful only to the old tape. */
     prepareNativeScrollbackReplay(): void;
+    captureNativeScrollbackWidthEpoch(): unknown;
+    resolveNativeScrollbackWidthEpoch(boundary: unknown): number | undefined;
+    getNativeScrollbackWidthEpochRows(): number | undefined;
+    isNativeScrollbackWidthEpochAppendOnly(boundary: unknown): boolean;
+    getNativeScrollbackWidthEpochRevision(): number;
     render(width: number): readonly string[];
 }
 /**
@@ -346,6 +366,9 @@ export declare class TUI extends Container {
         hidden: boolean;
     }[];
     constructor(terminal: Terminal, showHardwareCursor?: boolean, options?: TUIOptions);
+    captureNativeScrollbackWidthEpoch(): unknown;
+    resolveNativeScrollbackWidthEpoch(boundary: unknown): number | undefined;
+    getNativeScrollbackWidthEpochRows(): number | undefined;
     render(width: number): readonly string[];
     get fullRedraws(): number;
     /**

package/dist/types/utils.d.ts

@@ -46,6 +46,18 @@ export declare function getSegmenter(): Intl.Segmenter;
  * `tabWidth` cells) and OSC 66 text-sizing payloads (scaled by `s=`).
  */
 export declare function visibleWidth(str: string): number;
+/**
+ * True when a row carries a Kitty OSC 66 text-sizing span (`\x1b]66;…`).
+ * Scaled spans must bypass wrapping/padding and, when scaled up, reserve the
+ * terminal rows their multicell glyphs flow into.
+ */
+export declare function isOsc66Line(line: string): boolean;
+/**
+ * Largest `s=` scale among the OSC 66 spans in a line (1 when none is scaled).
+ * A scale-`s` heading occupies `s` terminal rows, so the `s - 1` blank rows
+ * beneath it are the glyph's lower half and must never be erased or overdrawn.
+ */
+export declare function osc66MaxScale(line: string): number;
 /**
  * Normalize text for terminal output without changing logical editor content.
  * Some terminals render precomposed Thai/Lao AM vowels inconsistently during

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "17.2.14",
+	"version": "17.3.0",
 	"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": "17.2.14",
-		"@oh-my-pi/pi-utils": "17.2.14"
+		"@oh-my-pi/pi-natives": "17.3.0",
+		"@oh-my-pi/pi-utils": "17.3.0"
 	},
 	"devDependencies": {
 		"ghostty-web": "^0.4.0"

package/src/components/editor.ts

@@ -391,6 +391,8 @@ export interface EditorTopBorder {
 	content: string;
 	/** Visible width of the content */
 	width: number;
+	/** Optional logical revision that changes independently of available width. */
+	revision?: number;
 }
 
 interface HistoryEntry {
@@ -410,6 +412,8 @@ export class Editor implements Component, Focusable {
 		cursorLine: 0,
 		cursorCol: 0,
 	};
+	#widthEpochText = "";
+	#widthEpochRevision = 0;
 
 	/** Focusable interface - set by TUI when focus changes */
 	focused: boolean = false;
@@ -515,6 +519,9 @@ export class Editor implements Component, Focusable {
 	// per-event rebuilds down to one per rendered frame (see #4145).
 	#topBorderContent?: EditorTopBorder;
 	#topBorderProvider?: (availableWidth: number) => EditorTopBorder | undefined;
+	#topBorderProviderWidth: number | undefined;
+	#topBorderProviderSignature: string | undefined;
+	#topBorderProviderRevision: number | undefined;
 	#borderVisible = true;
 
 	constructor(theme: EditorTheme) {
@@ -536,7 +543,10 @@ export class Editor implements Component, Focusable {
 	 * per-event rebuilds to one per painted frame.
 	 */
 	setTopBorder(content: EditorTopBorder | undefined): void {
+		if (this.#topBorderContent?.content === content?.content && this.#topBorderContent?.width === content?.width)
+			return;
 		this.#topBorderContent = content;
+		this.#widthEpochRevision++;
 	}
 
 	/**
@@ -546,18 +556,26 @@ export class Editor implements Component, Focusable {
 	 *
 	 * Use this when the top border derives from state that mutates far faster
 	 * than the render cadence (session events, streaming, subagent updates).
-	 * The TUI already throttles renders, so a provider is invoked at most once
-	 * per frame and never does wasted work between paints.
+	 * The TUI already throttles renders, so a provider is invoked exactly once
+	 * per frame and does no work between paints. Return a logical `revision` to
+	 * distinguish concurrent status mutations from pure width reflow.
 	 */
 	setTopBorderProvider(provider: ((availableWidth: number) => EditorTopBorder | undefined) | undefined): void {
+		if (this.#topBorderProvider === provider) return;
 		this.#topBorderProvider = provider;
+		this.#topBorderProviderWidth = undefined;
+		this.#topBorderProviderSignature = undefined;
+		this.#topBorderProviderRevision = undefined;
+		this.#widthEpochRevision++;
 	}
 
 	/**
 	 * Show or hide the editor border chrome.
 	 */
 	setBorderVisible(borderVisible: boolean): void {
+		if (this.#borderVisible === borderVisible) return;
 		this.#borderVisible = borderVisible;
+		this.#widthEpochRevision++;
 	}
 
 	setPromptGutter(promptGutter: string | undefined): void {
@@ -578,12 +596,16 @@ export class Editor implements Component, Focusable {
 	 * Use the real terminal cursor instead of rendering a cursor glyph.
 	 */
 	setUseTerminalCursor(useTerminalCursor: boolean): void {
+		if (this.#useTerminalCursor === useTerminalCursor) return;
 		this.#useTerminalCursor = useTerminalCursor;
+		this.#widthEpochRevision++;
 	}
 
 	/** Render a dedicated bottom border so terminal-local IME preedit cannot shift editor chrome. */
 	setImeSafeCursorLayout(enabled: boolean): void {
+		if (this.#imeSafeCursorLayout === enabled) return;
 		this.#imeSafeCursorLayout = enabled;
+		this.#widthEpochRevision++;
 	}
 
 	getUseTerminalCursor(): boolean {
@@ -593,6 +615,7 @@ export class Editor implements Component, Focusable {
 	setMaxHeight(maxHeight: number | undefined): void {
 		if (this.#maxHeight === maxHeight) return;
 		this.#maxHeight = maxHeight;
+		this.#widthEpochRevision++;
 		// Don't reset scrollOffset — #updateScrollOffset will clamp it on next render
 	}
 
@@ -613,6 +636,10 @@ export class Editor implements Component, Focusable {
 		const newMaxVisible = Number.isFinite(maxVisible) ? Math.max(3, Math.min(20, Math.floor(maxVisible))) : 5;
 		if (this.#autocompleteMaxVisible !== newMaxVisible) {
 			this.#autocompleteMaxVisible = newMaxVisible;
+			if (this.#autocompleteState !== null) {
+				this.#autocompleteList?.setMaxVisible(newMaxVisible);
+				this.#widthEpochRevision++;
+			}
 		}
 	}
 
@@ -900,7 +927,27 @@ export class Editor implements Component, Focusable {
 			// Provider (lazy) wins over eager content — a host that installs both
 			// wants the coalesced path; falling back to eager keeps existing
 			// setTopBorder callers working unchanged.
-			const topBorder = this.#topBorderProvider ? this.#topBorderProvider(topFillWidth) : this.#topBorderContent;
+			let topBorder: EditorTopBorder | undefined;
+			if (this.#topBorderProvider) {
+				const previousWidth = this.#topBorderProviderWidth;
+				topBorder = this.#topBorderProvider(topFillWidth);
+				const signature = topBorder ? `${topBorder.width}\0${topBorder.content}` : "";
+				const revision = topBorder?.revision;
+				if (
+					(previousWidth !== undefined &&
+						revision !== undefined &&
+						this.#topBorderProviderRevision !== undefined &&
+						revision !== this.#topBorderProviderRevision) ||
+					(previousWidth === topFillWidth && signature !== this.#topBorderProviderSignature)
+				) {
+					this.#widthEpochRevision++;
+				}
+				this.#topBorderProviderWidth = topFillWidth;
+				this.#topBorderProviderSignature = signature;
+				this.#topBorderProviderRevision = revision;
+			} else {
+				topBorder = this.#topBorderContent;
+			}
 			if (topBorder) {
 				const { content, width: statusWidth } = topBorder;
 				if (statusWidth <= topFillWidth) {
@@ -1240,6 +1287,7 @@ export class Editor implements Component, Focusable {
 					kb.matchesCanonical(canonical, "tui.select.pageDown")
 				) {
 					this.#autocompleteList.handleInput(data);
+					this.#widthEpochRevision++;
 					this.onAutocompleteUpdate?.();
 					return;
 				}
@@ -1670,6 +1718,15 @@ export class Editor implements Component, Focusable {
 		return this.#state.lines.join("\n");
 	}
 
+	getNativeScrollbackWidthEpochRevision(): number {
+		const text = this.getText();
+		if (text !== this.#widthEpochText) {
+			this.#widthEpochText = text;
+			this.#widthEpochRevision++;
+		}
+		return this.#widthEpochRevision;
+	}
+
 	/** Whether the buffer text equals `value`, without `getText()`'s full join —
 	 *  O(1) for the hot per-keystroke probes against short single-line values. */
 	textEquals(value: string): boolean {
@@ -3149,6 +3206,7 @@ export class Editor implements Component, Focusable {
 			this.#autocompletePrefix = suggestions.prefix;
 			this.#autocompleteList = this.#createAutocompleteList(suggestions.prefix, suggestions.items);
 			this.#autocompleteState = "regular";
+			this.#widthEpochRevision++;
 			this.onAutocompleteUpdate?.();
 		} else {
 			this.#cancelAutocomplete();
@@ -3207,6 +3265,7 @@ export class Editor implements Component, Focusable {
 			this.#autocompletePrefix = suggestions.prefix;
 			this.#autocompleteList = this.#createAutocompleteList(suggestions.prefix, suggestions.items);
 			this.#autocompleteState = "force";
+			this.#widthEpochRevision++;
 			this.onAutocompleteUpdate?.();
 		} else {
 			this.#cancelAutocomplete();
@@ -3221,6 +3280,7 @@ export class Editor implements Component, Focusable {
 		this.#autocompleteState = null;
 		this.#autocompleteList = undefined;
 		this.#autocompletePrefix = "";
+		if (wasAutocompleting) this.#widthEpochRevision++;
 		if (notifyCancel && wasAutocompleting) {
 			this.onAutocompleteCancel?.();
 		}
@@ -3252,6 +3312,7 @@ export class Editor implements Component, Focusable {
 			this.#autocompletePrefix = suggestions.prefix;
 			// Always create new SelectList to ensure update
 			this.#autocompleteList = this.#createAutocompleteList(suggestions.prefix, suggestions.items);
+			this.#widthEpochRevision++;
 			this.onAutocompleteUpdate?.();
 		} else {
 			this.#cancelAutocomplete();

package/src/components/image.ts

@@ -309,6 +309,16 @@ export class ImageBudget {
 		}
 	}
 
+	/**
+	 * End the physical-row coordinate epoch after observing its final commit
+	 * watermark. Placement ids and latched archive state survive, but attachment
+	 * rows do not: the next placement emit records them in the new-width frame.
+	 */
+	beginPlacementCoordinateEpoch(): void {
+		for (const state of this.#placementState.values()) state.lastAttachTopFrameRow = undefined;
+		this.#watchedPlacements.clear();
+	}
+
 	/**
 	 * Resolve the placement id and geometry for a direct-placement emit whose
 	 * topmost attached cell sits at `attachTopFrameRow` — the first frame row

package/src/components/markdown.ts

@@ -11,13 +11,19 @@ import { latexToBlock } from "../latex-block";
 import { inlineMathSpanEnd, isBareMathEnvironment, latexToUnicode } from "../latex-to-unicode";
 import type { SymbolTheme } from "../symbols";
 import { TERMINAL } from "../terminal-capabilities";
-import type { Component, NativeScrollbackCommittedRows, NativeScrollbackReplay } from "../tui";
+import type {
+	Component,
+	NativeScrollbackCommittedRows,
+	NativeScrollbackReplay,
+	NativeScrollbackWidthEpoch,
+} from "../tui";
 import {
 	applyBackgroundToLine,
 	Ellipsis,
 	encodeTextSized,
 	getPaddingX,
 	getSegmenter,
+	isOsc66Line,
 	padding,
 	replaceTabs,
 	truncateToWidth,
@@ -38,15 +44,11 @@ function normalizeOsc8Terminators(text: string): string {
 }
 
 // OSC 66 (Kitty text-sizing) heading spans are emitted as a single indivisible
-// unit by the H1 render path. Like image-protocol lines, they must bypass
-// ANSI wrapping and width padding: re-wrapping splits/normalizes the sized span
-// (recomputing the explicit `w=` cell count and hoisting SGR out of the OSC
-// payload), and padding would append trailing cells past the doubled glyph.
-const OSC66_LINE_PREFIX = "\x1b]66;";
-
-function isOsc66Line(line: string): boolean {
-	return line.includes(OSC66_LINE_PREFIX);
-}
+// unit by the H1 render path. Like image-protocol lines, they bypass ANSI
+// wrapping and width padding (see `isOsc66Line` in ../utils): re-wrapping
+// splits/normalizes the sized span (recomputing the explicit `w=` cell count
+// and hoisting SGR out of the OSC payload), and padding would append trailing
+// cells past the doubled glyph.
 
 function normalizeHtmlEntitiesForTerminal(raw: string): string {
 	const parseCodePoint = (value: number): string => {
@@ -1412,7 +1414,9 @@ interface RenderedTableLayout extends TableLayoutLock {
 	endRow: number;
 }
 
-export class Markdown implements Component, NativeScrollbackCommittedRows, NativeScrollbackReplay {
+export class Markdown
+	implements Component, NativeScrollbackCommittedRows, NativeScrollbackReplay, NativeScrollbackWidthEpoch
+{
 	#text: string;
 	#paddingX: number; // Left/right padding
 	#paddingY: number; // Top/bottom padding
@@ -1450,6 +1454,16 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 	// exposure to 0 and re-earns it — the exposure is hard-monotone within a
 	// text lineage.
 	#settledExposedText?: string;
+	// Semantic source state that produced the most recent render. Unlike #text,
+	// it does not advance when streaming updates arrive before the next paint.
+	#lastRenderedText?: string;
+	#lastRenderedTransientRenderCache = false;
+	#lastRenderedHasMutableTrailingRow = false;
+	#widthEpochBoundaries = new WeakMap<
+		object,
+		{ text: string; transientRenderCache: boolean; hasMutableTrailingRow: boolean }
+	>();
+
 	// True while #renderStreamingContentLines renders the frozen token range:
 	// frozen code blocks highlight even in transient mode so their bytes match
 	// the finalized render (they render once into the prefix line cache, so
@@ -1545,6 +1559,56 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 		return this.#lastRenderSettledRows;
 	}
 
+	captureNativeScrollbackWidthEpoch(): unknown {
+		if (this.#lastRenderedText === undefined) return undefined;
+		const marker = {};
+		this.#widthEpochBoundaries.set(marker, {
+			text: this.#lastRenderedText,
+			transientRenderCache: this.#lastRenderedTransientRenderCache,
+			hasMutableTrailingRow: this.#lastRenderedHasMutableTrailingRow,
+		});
+		return marker;
+	}
+
+	resolveNativeScrollbackWidthEpoch(boundary: unknown): number | undefined {
+		if (typeof boundary !== "object" || boundary === null || this.#cachedWidth === undefined) return undefined;
+		const captured = this.#widthEpochBoundaries.get(boundary);
+		if (captured === undefined) return undefined;
+		const snapshot = new Markdown(
+			captured.text,
+			this.#paddingX,
+			this.#paddingY,
+			this.#theme,
+			this.#defaultTextStyle,
+			this.#codeBlockIndent,
+		);
+		snapshot.#ignoreTight = this.#ignoreTight;
+		snapshot.#transientRenderCache = captured.transientRenderCache;
+		return Math.max(
+			0,
+			snapshot.render(this.#cachedWidth).length - this.#paddingY - (captured.hasMutableTrailingRow ? 1 : 0),
+		);
+	}
+
+	getNativeScrollbackWidthEpochRows(): number | undefined {
+		return this.#cachedLines === undefined ? undefined : this.#widthEpochRows(this.#cachedLines.length);
+	}
+
+	isNativeScrollbackWidthEpochAppendOnly(boundary: unknown): boolean {
+		if (typeof boundary !== "object" || boundary === null) return true;
+		return this.#widthEpochBoundaries.get(boundary)?.hasMutableTrailingRow !== true;
+	}
+
+	#widthEpochRows(renderedRows: number): number {
+		return Math.max(0, renderedRows - this.#paddingY - (this.#transientRenderCache ? 1 : 0));
+	}
+
+	#recordLastRenderedState(hasContentRows: boolean): void {
+		this.#lastRenderedText = this.#text;
+		this.#lastRenderedTransientRenderCache = this.#transientRenderCache;
+		this.#lastRenderedHasMutableTrailingRow = this.#transientRenderCache && hasContentRows;
+	}
+
 	/**
 	 * Freeze every table whose first physical row is already part of the native
 	 * scrollback prefix. The recorded widths came from the exact frame that was
@@ -1644,6 +1708,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 		// Returning the cached reference is load-bearing: parents memoize their
 		// concatenation on reference equality.
 		if (this.#cachedLines && this.#cachedText === this.#text && this.#cachedWidth === width) {
+			this.#recordLastRenderedState(this.#cachedLines.length > 0);
 			return this.#cachedLines;
 		}
 
@@ -1660,6 +1725,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 			this.#cachedText = this.#text;
 			this.#cachedWidth = width;
 			this.#cachedLines = EMPTY_RENDER_LINES;
+			this.#recordLastRenderedState(false);
 			return EMPTY_RENDER_LINES;
 		}
 
@@ -1695,6 +1761,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 				this.#cachedText = this.#text;
 				this.#cachedWidth = width;
 				this.#cachedLines = cached.lines;
+				this.#recordLastRenderedState(cached.lines.length > 0);
 				return cached.lines;
 			}
 		}
@@ -1738,6 +1805,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 				})),
 			});
 		}
+		this.#recordLastRenderedState(contentLines.length > 0);
 
 		return result;
 	}

package/src/components/text.ts

@@ -25,11 +25,14 @@ export class Text implements Component {
 	#paddingY: number; // Top/bottom padding
 	#customBgFn?: (text: string) => string;
 	#styleFn?: (text: string) => string;
+	#widthEpochRevision = 0;
 
 	#ignoreTight = false;
 
 	setIgnoreTight(ignore: boolean): this {
+		if (this.#ignoreTight === ignore) return this;
 		this.#ignoreTight = ignore;
+		this.#widthEpochRevision++;
 		this.invalidate();
 		return this;
 	}
@@ -60,15 +63,21 @@ export class Text implements Component {
 		this.#cachedWidth = undefined;
 		this.#cachedWidthEpoch = undefined;
 		this.#cachedLines = undefined;
+		this.#widthEpochRevision++;
 		return true;
 	}
 
+	getNativeScrollbackWidthEpochRevision(): number {
+		return this.#widthEpochRevision;
+	}
+
 	setCustomBgFn(customBgFn?: (text: string) => string): void {
 		this.#customBgFn = customBgFn;
 		this.#cachedText = undefined;
 		this.#cachedWidth = undefined;
 		this.#cachedWidthEpoch = undefined;
 		this.#cachedLines = undefined;
+		this.#widthEpochRevision++;
 	}
 
 	/**
@@ -83,6 +92,7 @@ export class Text implements Component {
 		this.#cachedWidth = undefined;
 		this.#cachedWidthEpoch = undefined;
 		this.#cachedLines = undefined;
+		this.#widthEpochRevision++;
 		return this;
 	}