@gajae-code/tui 0.7.3 → 0.7.5

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+## [0.7.4] - 2026-06-27
+
+### Fixed
+
+- Fixed Korean IME ghost character on macOS: a Hangul syllable committed by the IME immediately after `ctrl+u` (line-delete) is now discarded, preventing it from appearing in the cleared buffer (#1150).
+- Fixed CJK IME composition overlay positioning on macOS: the TUI now shows a steady-block hardware cursor (`\x1b[2 q`) when the soft cursor is active, anchoring the IME overlay to the correct position. Removed the synchronized-output wrapper from standalone cursor nudges, which was flushing terminal state and dismissing the overlay on every keystroke (#1150).
+- Fixed IME preedit caret anchoring so the composition caret stays aligned with the composed text (#1178).
+- Preserve the composer placeholder while an IME cursor is active so the prompt hint does not flicker during composition.
+- Reflow the in-progress prompt draft when the terminal is resized.
+- Repaint the multiplexer viewport on resize so stale rows are not left behind (#1137).
+- Fixed Alt+Enter queue key parsing (#1145).
+- Fixed Windows prompt newline shortcut discoverability (#1134).
+
 ## [0.7.3] - 2026-06-25
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.7.3",
+	"version": "0.7.5",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -38,8 +38,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@gajae-code/natives": "0.7.3",
-		"@gajae-code/utils": "0.7.3",
+		"@gajae-code/natives": "0.7.5",
+		"@gajae-code/utils": "0.7.5",
 		"lru-cache": "11.3.6",
 		"marked": "^18.0.3"
 	},

package/src/components/editor.ts

@@ -385,6 +385,8 @@ export class Editor implements Component, Focusable {
 
 	#theme: EditorTheme;
 	#useTerminalCursor = false;
+	// macOS: Hangul arriving within 50ms of a line-delete is an IME ghost char — discard it.
+	#lastLineDeleteAt = 0;
 
 	/** When set, replaces the normal cursor glyph at end-of-text with this ANSI-styled string. */
 	cursorOverride: string | undefined;
@@ -850,7 +852,13 @@ export class Editor implements Component, Focusable {
 
 			if (showPlaceholder) {
 				const hintText = hintStyle(truncateToWidth(this.#placeholder ?? "", lineContentWidth));
-				displayText = hintText;
+				// Anchor the hardware cursor at the input start (terminal-cursor mode) even
+				// while the placeholder shows. Otherwise no cursor marker is emitted, the
+				// hardware cursor is left at its stale position from the previous frame,
+				// and a composing IME preedit renders there instead of at the prompt.
+				// The marker is zero-width and stripped before output, so the placeholder is unchanged.
+				const anchorCursor = emitCursorMarker && this.#useTerminalCursor && visibleIndex === 0;
+				displayText = anchorCursor ? marker + hintText : hintText;
 				displayWidth = Math.min(visibleWidth(this.#placeholder ?? ""), lineContentWidth);
 				hasCursor = false;
 			}
@@ -1384,6 +1392,21 @@ export class Editor implements Component, Focusable {
 		else {
 			const printableText = extractPrintableText(data);
 			if (printableText) {
+				if (
+					process.platform === "darwin" &&
+					printableText.length === 1 &&
+					Date.now() - this.#lastLineDeleteAt < 50
+				) {
+					const code = printableText.charCodeAt(0);
+					const isHangul =
+						(code >= 0xac00 && code <= 0xd7a3) ||
+						(code >= 0x1100 && code <= 0x11ff) ||
+						(code >= 0x3130 && code <= 0x318f);
+					if (isHangul) {
+						this.#lastLineDeleteAt = 0;
+						return;
+					}
+				}
 				this.#insertCharacter(printableText);
 			}
 		}
@@ -2209,6 +2232,7 @@ export class Editor implements Component, Focusable {
 	#deleteToStartOfLine(): void {
 		this.#historyIndex = -1; // Exit history browsing mode
 		this.#recordUndoState();
+		if (process.platform === "darwin") this.#lastLineDeleteAt = Date.now();
 
 		const currentLine = this.#state.lines[this.#state.cursorLine] || "";
 		let deletedText = "";

package/src/tui.ts

@@ -313,6 +313,10 @@ export class TUI extends Container {
 	#sixelProbeTimeout?: NodeJS.Timeout;
 	#sixelProbeUnsubscribe?: () => void;
 	#showHardwareCursor = $flag("PI_HARDWARE_CURSOR");
+	// macOS: steady-block cursor anchors CJK IME overlays; disable with GJC_TUI_IME_CURSOR=0.
+	readonly #useImeBlockCursor = $flag("GJC_TUI_IME_CURSOR", process.platform === "darwin");
+	// showHardwareCursor=false but cursor is shown for IME anchoring (macOS).
+	#imeCursorActive = false;
 	#clearOnShrink = $flag("PI_CLEAR_ON_SHRINK"); // Clear empty rows when content shrinks (default: off)
 	// Opt-in: reuse the previous normalized off-screen prefix and only normalize/diff the
 	// visible window, bounding per-frame work on huge transcripts. Output stays byte-identical.
@@ -337,6 +341,7 @@ export class TUI extends Container {
 		if (showHardwareCursor !== undefined) {
 			this.#showHardwareCursor = showHardwareCursor;
 		}
+		this.#imeCursorActive = !this.#showHardwareCursor && this.#useImeBlockCursor;
 	}
 
 	get fullRedraws(): number {
@@ -350,6 +355,7 @@ export class TUI extends Container {
 	setShowHardwareCursor(enabled: boolean): void {
 		if (this.#showHardwareCursor === enabled) return;
 		this.#showHardwareCursor = enabled;
+		this.#imeCursorActive = !enabled && this.#useImeBlockCursor;
 		if (!enabled) {
 			this.#hideCursor();
 		}
@@ -484,7 +490,10 @@ export class TUI extends Container {
 		this.#terminalUnavailable = false;
 		this.terminal.start(
 			data => this.#handleInput(data),
-			() => this.requestRender(),
+			() => {
+				this.invalidate();
+				this.requestRender(!(isMultiplexerSession() && !useLegacyMultiplexerFullRender()), "resize");
+			},
 		);
 		this.#hideCursor();
 		this.#querySixelSupport();
@@ -704,6 +713,9 @@ export class TUI extends Container {
 			this.#writeTerminal("\r\n");
 		}
 
+		if (this.#useImeBlockCursor) {
+			this.#writeTerminal("\x1b[0 q");
+		}
 		this.#showCursor();
 		try {
 			this.terminal.stop();
@@ -1762,8 +1774,10 @@ export class TUI extends Container {
 		totalLines: number,
 		fromRow: number,
 	): { seq: string; toRow: number } {
-		// No IME target or no content — hide cursor regardless of preference
-		if (!cursorPos || totalLines <= 0) return { seq: "\x1b[?25l", toRow: fromRow };
+		if (!cursorPos || totalLines <= 0) {
+			const hide = this.#useImeBlockCursor ? "\x1b[0 q\x1b[?25l" : "\x1b[?25l";
+			return { seq: hide, toRow: fromRow };
+		}
 
 		// Clamp cursor position to valid range
 		const targetRow = Math.max(0, Math.min(cursorPos.row, totalLines - 1));
@@ -1779,7 +1793,11 @@ export class TUI extends Container {
 		}
 		// Move to absolute column (1-indexed)
 		seq += `\x1b[${targetCol + 1}G`;
-		seq += this.#showHardwareCursor ? "\x1b[?25h" : "\x1b[?25l";
+		if (this.#showHardwareCursor || this.#imeCursorActive) {
+			seq += this.#useImeBlockCursor ? "\x1b[2 q\x1b[?25h" : "\x1b[?25h";
+		} else {
+			seq += "\x1b[?25l";
+		}
 
 		return { seq, toRow: targetRow };
 	}
@@ -1796,6 +1814,7 @@ export class TUI extends Container {
 		}
 		const { seq, toRow } = this.#cursorControlSequence(cursorPos, totalLines, this.#hardwareCursorRow);
 		this.#hardwareCursorRow = toRow;
-		this.#writeTerminal(`\x1b[?2026h${seq}\x1b[?2026l`);
+		// No \x1b[?2026h/l wrapper: synchronized output flushes terminal state and discards macOS IME composition.
+		this.#writeTerminal(seq);
 	}
 }