@gajae-code/tui 0.17.1 → 0.17.4

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [0.17.4] - 2026-09-23
+
+## [0.17.3] - 2026-09-22
+
+### Performance
+
+- Avoid unsupported Kitty placement extraction on ordinary non-Kitty input frames.
+- Reuse unchanged editor logical-line layouts, including keyboard shrink/join paths that previously retained deleted-line cache entries.
+- Reuse the byte/line admission decision for exact cached Markdown highlights instead of rescanning unchanged fenced code.
+- Add a native-highlight input-to-synchronized-write benchmark with same-frame visibility checks. Scheduling, preparation, force precedence, and output revisions are unchanged.
+
+- Avoid allocating fallback arrays while attributing Kitty placements during frame assembly. Emitted terminal bytes are unchanged.
+
+- Hold the raw frame by reference instead of copying every transcript line during frame assembly. Emitted terminal bytes are unchanged.
+
+## [0.17.2] - 2026-09-18
+
 ## [0.17.1] - 2026-09-17
 
 ## [0.17.0] - 2026-09-17

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

@@ -98,6 +98,8 @@ export declare class Editor implements Component, Focusable {
     invalidate(): void;
     render(width: number): string[];
     handleInput(data: string): void;
+    /** Test-only seam: retained per-logical-line layout entries. */
+    get logicalLayoutCacheSize(): number;
     /** Test-only seam: current wrap-cache entry count (memory-bound assertions). */
     get wrappedLineCacheSize(): number;
     getText(): string;

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

@@ -21,6 +21,7 @@ export declare function resetMarkdownHighlightCallCount(): void;
 export declare const __markdownPerfCounters: {
     lexerInvocations: number;
     lexedBytes: number;
+    highlightAdmissionScans: number;
     reset(): void;
 };
 /** Drop all L2 cache entries. Call on theme change to prevent stale styled output. */

package/dist/types/tui.d.ts

@@ -364,6 +364,7 @@ type TuiRenderCounterSnapshot = {
     widthReflowScanRows: number;
     widthReflowVisibleWidthCalls: number;
     kittyPlacementScanRows: number;
+    kittyPlacementReferenceRows: 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.17.1",
+	"version": "0.17.4",
 	"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.17.1",
-		"@gajae-code/utils": "0.17.1",
+		"@gajae-code/natives": "0.17.4",
+		"@gajae-code/utils": "0.17.4",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},

package/src/components/editor.ts

@@ -443,6 +443,7 @@ export class Editor implements Component, Focusable {
 	#wrappedLineCache: CachedWrappedLine[] = [];
 	#docVersion = 0;
 	#layoutCache: LayoutCache | undefined;
+	#logicalLayoutCache: Array<{ text: string; width: number; cursorCol: number | undefined; lines: LayoutLine[] }> = [];
 
 	// Emacs-style kill ring
 	#killRing = new KillRing();
@@ -754,11 +755,20 @@ export class Editor implements Component, Focusable {
 	}
 
 	invalidate(): void {
+		this.#logicalLayoutCache.length = 0;
 		this.#wrappedLineCache.length = 0;
 		this.#layoutCache = undefined;
 	}
 
+	#trimLogicalLayoutCache(): void {
+		// Retain at most one layout per current logical line, never deleted tails.
+		if (this.#logicalLayoutCache.length > this.#state.lines.length) {
+			this.#logicalLayoutCache.length = this.#state.lines.length;
+		}
+	}
+
 	#bumpDocumentVersion(): void {
+		this.#trimLogicalLayoutCache();
 		this.#docVersion += 1;
 		this.#layoutCache = undefined;
 	}
@@ -1163,6 +1173,16 @@ export class Editor implements Component, Focusable {
 	}
 
 	handleInput(data: string): void {
+		try {
+			this.#handleInput(data);
+		} finally {
+			// Undo snapshots invalidate before mutation; trim after all input paths,
+			// including early returns and nested bracketed-paste handling.
+			this.#trimLogicalLayoutCache();
+		}
+	}
+
+	#handleInput(data: string): void {
 		const kb = getKeybindings();
 
 		// Handle character jump mode (awaiting next character to jump to)
@@ -1585,6 +1605,11 @@ export class Editor implements Component, Focusable {
 		return wrapped;
 	}
 
+	/** Test-only seam: retained per-logical-line layout entries. */
+	get logicalLayoutCacheSize(): number {
+		return this.#logicalLayoutCache.length;
+	}
+
 	/** Test-only seam: current wrap-cache entry count (memory-bound assertions). */
 	get wrappedLineCacheSize(): number {
 		return this.#wrappedLineCache.length;
@@ -1624,6 +1649,16 @@ export class Editor implements Component, Focusable {
 	}
 
 	#layoutLogicalLine(lineIndex: number, contentWidth: number): LayoutLine[] {
+		const text = this.#state.lines[lineIndex] || "";
+		const cursorCol = lineIndex === this.#state.cursorLine ? this.#state.cursorCol : undefined;
+		const cached = this.#logicalLayoutCache[lineIndex];
+		if (cached?.text === text && cached.width === contentWidth && cached.cursorCol === cursorCol) return cached.lines;
+		const lines = this.#buildLogicalLine(lineIndex, contentWidth);
+		this.#logicalLayoutCache[lineIndex] = { text, width: contentWidth, cursorCol, lines };
+		return lines;
+	}
+
+	#buildLogicalLine(lineIndex: number, contentWidth: number): LayoutLine[] {
 		__editorPerfCounters.layoutLogicalLinesProcessed += 1;
 		const line = this.#state.lines[lineIndex] || "";
 		const isCurrentLine = lineIndex === this.#state.cursorLine;
@@ -1722,6 +1757,7 @@ export class Editor implements Component, Focusable {
 	}
 
 	#layoutText(contentWidth: number): LayoutLine[] {
+		this.#trimLogicalLayoutCache();
 		__editorPerfCounters.layoutTextInvocations += 1;
 		const key = this.#makeLayoutCacheKey(contentWidth);
 		const cached = this.#layoutCache;

package/src/components/markdown.ts

@@ -214,9 +214,11 @@ export function resetMarkdownHighlightCallCount(): void {
 export const __markdownPerfCounters = {
 	lexerInvocations: 0,
 	lexedBytes: 0,
+	highlightAdmissionScans: 0,
 	reset(): void {
 		this.lexerInvocations = 0;
 		this.lexedBytes = 0;
+		this.highlightAdmissionScans = 0;
 	},
 };
 
@@ -452,6 +454,7 @@ export class Markdown implements Component {
 	}
 
 	#exceedsHighlightCap(code: string): boolean {
+		__markdownPerfCounters.highlightAdmissionScans += 1;
 		// UTF-8 requires at least one byte per UTF-16 code unit, including lone
 		// surrogates. Reject obviously oversized input without scanning or hashing it.
 		if (code.length > MAX_HIGHLIGHT_BYTES) return true;
@@ -467,10 +470,13 @@ export class Markdown implements Component {
 
 	#highlightCodeBlock(code: string, lang: string): string[] | null {
 		if (!this.#theme.highlightCode) return null;
-		if (this.#exceedsHighlightCap(code)) return null;
+		// Avoid building/hashing keys for obviously oversized input. A cache hit
+		// already passed the immutable byte/line caps; only misses need a scan.
+		if (code.length > MAX_HIGHLIGHT_BYTES) return null;
 		const key = `${objectId(this.#theme)}\x00${lang}\x00${code}`;
 		const cached = highlightCache.get(key);
 		if (cached?.lang === lang && cached.code === code) return cached.lines;
+		if (this.#exceedsHighlightCap(code)) return null;
 		highlightCallCount += 1;
 		const result = this.#theme.highlightCode(code, lang || undefined);
 		highlightCache.set(key, { lang, code, lines: result });

package/src/tui.ts

@@ -821,6 +821,7 @@ type TuiRenderCounterSnapshot = {
 	widthReflowScanRows: number;
 	widthReflowVisibleWidthCalls: number;
 	kittyPlacementScanRows: number;
+	kittyPlacementReferenceRows: number;
 };
 type RenderCommitWaiter = {
 	resolve: (committed: boolean) => void;
@@ -1187,6 +1188,7 @@ export class TUI extends Container {
 		widthReflowScanRows: 0,
 		widthReflowVisibleWidthCalls: 0,
 		kittyPlacementScanRows: 0,
+		kittyPlacementReferenceRows: 0,
 	};
 
 	static resetRenderCountersForTest(): void {
@@ -1197,6 +1199,7 @@ export class TUI extends Container {
 			widthReflowScanRows: 0,
 			widthReflowVisibleWidthCalls: 0,
 			kittyPlacementScanRows: 0,
+			kittyPlacementReferenceRows: 0,
 		};
 	}
 
@@ -4624,7 +4627,12 @@ export class TUI extends Container {
 			const safeLines = reuseCached ? cached.safeLines : rendered.lines.map(stripTerminalEraseControls);
 			const kittyPlacements = reuseCached
 				? cached.kittyPlacements
-				: rendered.lines.map(line => [...extractKittyPlacementReferences(line)]);
+				: TERMINAL.imageProtocol === ImageProtocol.Kitty
+					? rendered.lines.map(line => {
+							TUI.#renderCounters.kittyPlacementReferenceRows++;
+							return [...extractKittyPlacementReferences(line)];
+						})
+					: [];
 			if (!reuseCached && componentRevision !== undefined && source !== null) {
 				this.#viewportAnchorRenderCache = {
 					component: child,
@@ -4644,8 +4652,11 @@ export class TUI extends Container {
 			}
 			const owner: KittyPlacementOwner = hasStickySuffix && childIndex >= pinnedChildIndex ? "suffix" : "transcript";
 			for (let lineIndex = 0; lineIndex < rendered.lines.length; lineIndex++) {
-				for (const placement of kittyPlacements[lineIndex] ?? []) {
-					placementOwners.set(this.#kittyPlacementKey(placement), owner);
+				const placements = kittyPlacements[lineIndex];
+				if (placements !== undefined) {
+					for (const placement of placements) {
+						placementOwners.set(this.#kittyPlacementKey(placement), owner);
+					}
 				}
 				renderedLines.push(safeLines[lineIndex] ?? rendered.lines[lineIndex]!);
 			}
@@ -4705,7 +4716,8 @@ export class TUI extends Container {
 		// re-normalized and the diff starts at the window. Output is byte-identical to the
 		// full path (reused entries are deterministic normalizations of identical raw lines).
 		const VIEWPORT_NORMALIZE_OVERSCAN = 8;
-		const rawLines = newLines.slice();
+		// Reassigned below, never mutated in place -- a reference is the snapshot.
+		const rawLines = newLines;
 		const total = rawLines.length;
 		let diffStart = 0;
 		let usedWindowNormalize = false;