@sayknow-cli/tui 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## [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
+
+- Added bottom-pinned TUI layout support so short initial screens can pad above composer/status components and keep the prompt anchored to the terminal viewport bottom (#1120).
+
 ## [0.6.0] - 2026-06-18
 
 ### Fixed

package/dist/types/tui.d.ts

@@ -156,6 +156,7 @@ export declare class TUI extends Container {
      */
     setClearOnShrink(enabled: boolean): void;
     setFocus(component: Component | null): void;
+    setBottomPinnedComponent(component: Component | null): void;
     /**
      * Show an overlay component with configurable positioning and sizing.
      * Returns a handle to control the overlay's visibility.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/tui",
-	"version": "0.3.1",
+	"version": "0.3.2",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://github.com/jaybeyond/Sayknow_CLI",
 	"author": "jaybeyond",
@@ -38,8 +38,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@sayknow-cli/natives": "0.3.1",
-		"@sayknow-cli/utils": "0.3.1",
+		"@sayknow-cli/natives": "0.3.2",
+		"@sayknow-cli/utils": "0.3.2",
 		"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;
@@ -854,7 +856,13 @@ export class Editor implements Component, Focusable {
 			// When NOT focused, show the placeholder alone with no caret.
 			if (showPlaceholder && !this.focused) {
 				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;
 			}
@@ -1388,6 +1396,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);
 			}
 		}
@@ -2213,6 +2236,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 SKC_TUI_IME_CURSOR=0.
+	readonly #useImeBlockCursor = $flag("SKC_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.
@@ -321,6 +325,7 @@ export class TUI extends Container {
 	#fullRedrawCount = 0;
 	#stopped = false;
 	#terminalUnavailable = false;
+	#bottomPinnedComponent: Component | null = null;
 
 	// Overlay stack for modal components rendered on top of base content
 	overlayStack: {
@@ -336,6 +341,7 @@ export class TUI extends Container {
 		if (showHardwareCursor !== undefined) {
 			this.#showHardwareCursor = showHardwareCursor;
 		}
+		this.#imeCursorActive = !this.#showHardwareCursor && this.#useImeBlockCursor;
 	}
 
 	get fullRedraws(): number {
@@ -349,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();
 		}
@@ -382,6 +389,11 @@ export class TUI extends Container {
 		}
 	}
 
+	setBottomPinnedComponent(component: Component | null): void {
+		this.#bottomPinnedComponent = component;
+		this.requestRender();
+	}
+
 	/**
 	 * Show an overlay component with configurable positioning and sizing.
 	 * Returns a handle to control the overlay's visibility.
@@ -478,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();
@@ -698,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();
@@ -1269,6 +1287,31 @@ export class TUI extends Container {
 		return lines;
 	}
 
+	#padBeforeBottomPinnedComponent(lines: string[], height: number): string[] {
+		const component = this.#bottomPinnedComponent;
+		if (component === null || lines.length >= height) return lines;
+
+		let pinnedStart = -1;
+		for (let i = this.children.length - 1; i >= 0; i--) {
+			if (this.children[i] === component) {
+				pinnedStart = i;
+				break;
+			}
+		}
+		if (pinnedStart < 0) return lines;
+
+		let pinnedLineCount = 0;
+		for (let i = pinnedStart; i < this.children.length; i++) {
+			pinnedLineCount += this.children[i].render(this.terminal.columns).length;
+		}
+
+		const blankRows = height - lines.length;
+		const insertAt = Math.max(0, lines.length - pinnedLineCount);
+		const padded = [...lines];
+		padded.splice(insertAt, 0, ...Array.from({ length: blankRows }, () => ""));
+		return padded;
+	}
+
 	#doRender(): void {
 		if (this.#stopped || !this.terminalAvailable) return;
 		const width = this.terminal.columns;
@@ -1287,6 +1330,10 @@ export class TUI extends Container {
 		let newLines = this.render(width);
 		if (renderMetrics.enabled) renderMetrics.recordHelper("renderTree", renderMetrics.now() - renderTreeStart);
 
+		if (this.#bottomPinnedComponent !== null && height > 0) {
+			newLines = this.#padBeforeBottomPinnedComponent(newLines, height);
+		}
+
 		// Composite overlays into the rendered lines (before differential compare)
 		if (this.overlayStack.length > 0) {
 			newLines = this.#compositeOverlays(newLines, width, height);
@@ -1727,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));
@@ -1744,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 };
 	}
@@ -1761,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);
 	}
 }