@gajae-code/tui 0.16.7 → 0.17.1

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [0.17.1] - 2026-09-17
+
+## [0.17.0] - 2026-09-17
+
+### Performance
+
+- Defer resize reflow-decision scans to their consuming branch, skipping them on unchanged-width frames and viewport-only repaints; coalesced resize appends avoid that decision scan while retained-prefix validation may still measure rows, preserving rendering and settled scrollback repair.
+
+- Skip the kitty placement scan on terminals that do not run the kitty graphics protocol, and keep the outgoing logical and raw frames by reference instead of copying them. Both removed a walk over every transcript line from every render frame; emitted bytes are unchanged.
+
 ## [0.16.7] - 2026-09-13
 
 ## [0.16.6] - 2026-09-07

package/dist/types/tui.d.ts

@@ -362,6 +362,8 @@ type TuiRenderCounterSnapshot = {
     debugRedrawAppendWrites: number;
     differentialGuardVisibleWidthCalls: number;
     widthReflowScanRows: number;
+    widthReflowVisibleWidthCalls: number;
+    kittyPlacementScanRows: number;
 };
 /**
  * TUI - Main class for managing terminal UI with differential rendering

package/package.json

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

package/src/tui.ts

@@ -819,6 +819,8 @@ type TuiRenderCounterSnapshot = {
 	debugRedrawAppendWrites: number;
 	differentialGuardVisibleWidthCalls: number;
 	widthReflowScanRows: number;
+	widthReflowVisibleWidthCalls: number;
+	kittyPlacementScanRows: number;
 };
 type RenderCommitWaiter = {
 	resolve: (committed: boolean) => void;
@@ -1183,6 +1185,8 @@ export class TUI extends Container {
 		debugRedrawAppendWrites: 0,
 		differentialGuardVisibleWidthCalls: 0,
 		widthReflowScanRows: 0,
+		widthReflowVisibleWidthCalls: 0,
+		kittyPlacementScanRows: 0,
 	};
 
 	static resetRenderCountersForTest(): void {
@@ -1191,6 +1195,8 @@ export class TUI extends Container {
 			debugRedrawAppendWrites: 0,
 			differentialGuardVisibleWidthCalls: 0,
 			widthReflowScanRows: 0,
+			widthReflowVisibleWidthCalls: 0,
+			kittyPlacementScanRows: 0,
 		};
 	}
 
@@ -4128,7 +4134,12 @@ export class TUI extends Container {
 		lines: string[],
 		owners: ReadonlyMap<string, KittyPlacementOwner>,
 	): KittyPlacementSpan[] {
+		// encodeKittyPlacement is only reachable from renderImage's kitty branch, so a
+		// line rendered under any other protocol cannot carry a placement and the scan
+		// can only return empty. See the commit message for the consumers this covers.
+		if (TERMINAL.imageProtocol !== ImageProtocol.Kitty) return [];
 		const placements: KittyPlacementSpan[] = [];
+		TUI.#renderCounters.kittyPlacementScanRows += lines.length;
 		for (let row = 0; row < lines.length; row++) {
 			for (const placement of extractKittyPlacementReferences(lines[row])) {
 				placements.push({
@@ -4736,8 +4747,9 @@ export class TUI extends Container {
 			if (usedWindowNormalize) renderMetrics.recordLineCount("offscreenScan", diffStart);
 		}
 		const nextKittyPlacementSpans = this.#kittyPlacementSpansForLines(newLines, placementOwners);
-		const previousLogicalFrame = this.#latestRenderedLines.slice();
-		const previousRawFrame = this.#latestRaw.slice();
+		// Reassigned, never mutated in place -- a reference is the snapshot.
+		const previousLogicalFrame = this.#latestRenderedLines;
+		const previousRawFrame = this.#latestRaw;
 		const previousRenderedLength = previousLogicalFrame.length;
 		this.#latestRenderedLines = newLines;
 		this.#latestRenderedTranscriptLineCount = nextTranscriptLineCount;
@@ -5086,13 +5098,6 @@ export class TUI extends Container {
 			return;
 		}
 		const useViewportRepaintPath = this.#viewportRepaintHost();
-		const widthReflowRequired =
-			widthChanged &&
-			this.#previousWidth > 0 &&
-			rawLines.some(line => {
-				TUI.#renderCounters.widthReflowScanRows += 1;
-				return !TERMINAL.isImageLine(line) && visibleWidth(line) > Math.min(this.#previousWidth, width);
-			});
 		if (
 			widthChanged &&
 			!this.#legacyMultiplexerFullRender &&
@@ -5176,6 +5181,16 @@ export class TUI extends Container {
 		// Width changes always need a full re-render because wrapping changes, unless
 		// a proven coalesced append is continuing through the durable append path.
 		if (widthChanged && !coalescedWidthAppend) {
+			// Measure only where the reflow decision is consumed. Viewport-only
+			// resize repaints return above; coalesced appends also skip this scan.
+			const widthReflowRequired =
+				this.#previousWidth > 0 &&
+				rawLines.some(line => {
+					TUI.#renderCounters.widthReflowScanRows += 1;
+					if (TERMINAL.isImageLine(line)) return false;
+					TUI.#renderCounters.widthReflowVisibleWidthCalls += 1;
+					return visibleWidth(line) > Math.min(this.#previousWidth, width);
+				});
 			if (!widthReflowRequired) {
 				this.#widthSettleRepairPending = false;
 				logRedraw(`terminal width changed without reflow (${this.#previousWidth} -> ${width})`);