feat: enhance UI components with internationalization support and cursor management

- Added i18n support to AgentPickerPanel and TodoPickerPanel for localized text.
- Improved user feedback in FileList with enhanced loading and searching messages.
- Implemented cursor visibility and positioning management in the Ink framework.
- Introduced CursorContext and useCursor hook for better cursor control in terminal applications.
- Refactored file loading logic in FileList for improved performance and responsiveness.
- Removed unused cursor hiding logic from ChatScreen.

Author: MayDay-wpf

source/app.tsx

@@ -1,8 +1,6 @@
 import React, {useState, useEffect, Suspense} from 'react';
 import {Box, Text} from 'ink';
 import {Alert} from '@inkjs/ui';
-import {useCursorHide} from './hooks/ui/useCursorHide.js';
-
 // Lazy load all page components to improve startup time
 // Only load components when they are actually needed
 const WelcomeScreen = React.lazy(() => import('./ui/pages/WelcomeScreen.js'));
@@ -59,9 +57,6 @@ function ShowTaskListWrapper() {
 	const {columns: terminalWidth} = useTerminalSize();
 	const loadingFallback = null;
 
-	// Hide terminal cursor to prevent flickering during page transitions
-	useCursorHide();
-
 	// Global exit handler
 	useGlobalExit(setExitNotification);
 
@@ -173,9 +168,6 @@ function AppContent({
 	// Get terminal size for proper width calculation
 	const {columns: terminalWidth} = useTerminalSize();
 
-	// Hide terminal cursor to prevent flickering during page transitions
-	useCursorHide();
-
 	// Global exit handler (must be inside I18nProvider)
 	useGlobalExit(setExitNotification);
 

source/i18n/lang/en.ts

@@ -638,8 +638,7 @@ export const en: TranslationKeys = {
 			hybridCompress:
 				'Toggle Hybrid Compress mode (AI summary + smart truncation for /compact and auto-compress)',
 			team: 'Toggle Agent Team mode - orchestrate multiple agents working together in independent Git worktrees',
-			branch:
-				'Fork current conversation into a new branch',
+			branch: 'Fork current conversation into a new branch',
 			worktree:
 				'Open Git branch management panel for switching, creating and deleting branches',
 			diff: 'Review file changes from a conversation in IDE diff view',
@@ -692,6 +691,17 @@ export const en: TranslationKeys = {
 			},
 		},
 	},
+	fileList: {
+		loadingFiles: 'Loading files...',
+		noFilesFound: 'No files found',
+		searchingDeeper: 'Searching deeper (depth {depth})...',
+		scanning: 'Scanning... ({count} indexed)',
+		scanningDeeper: 'Searching deeper (depth {depth}, {count} indexed)...',
+		contentSearchHeader: '≡ Content Search',
+		filesHeader: '≡ Files [{mode} • Ctrl+T]',
+		treeMode: 'Tree',
+		listMode: 'List',
+	},
 	ideSelectPanel: {
 		title: 'Select IDE',
 		subtitle: 'Connect to an IDE for integrated development features.',
@@ -1756,6 +1766,32 @@ export const en: TranslationKeys = {
 		failedDisableExitImage: 'Failed to disable exit image',
 		setAsExitImage: 'Set "{name}" as exit image',
 	},
+	agentPickerPanel: {
+		title: 'Sub-Agent Selection',
+		noAgentsWarning:
+			'No sub-agents configured. Please configure sub-agents first.',
+		selectAgent: 'Select Sub-Agent',
+		escHint: '(Press ESC to close)',
+		noDescription: 'No description',
+		scrollHint: '· ↑↓ to scroll',
+		moreAbove: '{count} more above',
+		moreBelow: '{count} more below',
+	},
+	todoPickerPanel: {
+		title: 'TODO Selection',
+		scanning: 'Scanning project for TODO comments...',
+		noTodosFound: 'No TODO comments found in the project',
+		noMatchSearch: 'No TODOs match "{searchQuery}" (Total: {totalCount})',
+		typeToClearSearch: 'Type to filter · Backspace to clear search',
+		selectTodos: 'Select TODOs',
+		filteringLabel: 'Filtering: "{searchQuery}"',
+		typeToFilterHint:
+			'Type to filter · Backspace to clear · Space: toggle · Enter: confirm',
+		typeToSearchHint:
+			'Type to search · Space: toggle · Enter: confirm · Esc: cancel',
+		selectedCount: '{count} TODO(s) selected',
+		noDescription: 'No description',
+	},
 	exitScreen: {
 		title: 'Goodbye',
 		goodbye: 'Thanks for using Snow CLI',

source/i18n/lang/zh-TW.ts

@@ -649,6 +649,17 @@ export const zhTW: TranslationKeys = {
 			},
 		},
 	},
+	fileList: {
+		loadingFiles: '正在載入檔案...',
+		noFilesFound: '未找到檔案',
+		searchingDeeper: '正在搜尋更深目錄（深度 {depth}）...',
+		scanning: '正在掃描...（已索引 {count}）',
+		scanningDeeper: '正在搜尋更深目錄（深度 {depth}，已索引 {count}）...',
+		contentSearchHeader: '≡ 內容搜尋',
+		filesHeader: '≡ 檔案 [{mode} • Ctrl+T]',
+		treeMode: '樹狀',
+		listMode: '清單',
+	},
 	ideSelectPanel: {
 		title: '選擇 IDE',
 		subtitle: '連線至 IDE 以使用整合開發功能。',
@@ -1662,6 +1673,29 @@ export const zhTW: TranslationKeys = {
 		failedDisableExitImage: '關閉結束畫面失敗',
 		setAsExitImage: '已將「{name}」設為結束畫面',
 	},
+	agentPickerPanel: {
+		title: '子代理選擇',
+		noAgentsWarning: '尚未配置子代理。請先配置子代理。',
+		selectAgent: '選擇子代理',
+		escHint: '（按 ESC 關閉）',
+		noDescription: '無描述',
+		scrollHint: '· ↑↓ 捲動',
+		moreAbove: '上方還有 {count} 項',
+		moreBelow: '下方還有 {count} 項',
+	},
+	todoPickerPanel: {
+		title: 'TODO 選擇',
+		scanning: '正在掃描專案中的 TODO 註釋...',
+		noTodosFound: '專案中未找到 TODO 註釋',
+		noMatchSearch: '沒有符合 "{searchQuery}" 的 TODO（總數：{totalCount}）',
+		typeToClearSearch: '輸入以篩選 · 退格鍵清除搜尋',
+		selectTodos: '選擇 TODO',
+		filteringLabel: '篩選: "{searchQuery}"',
+		typeToFilterHint: '輸入篩選 · 退格清除 · 空白鍵: 切換 · Enter: 確認',
+		typeToSearchHint: '輸入搜尋 · 空白鍵: 切換 · Enter: 確認 · Esc: 取消',
+		selectedCount: '已選擇 {count} 個 TODO',
+		noDescription: '無描述',
+	},
 	exitScreen: {
 		title: '再見',
 		goodbye: '感謝使用 Snow CLI',

source/i18n/lang/zh.ts

@@ -648,6 +648,17 @@ export const zh: TranslationKeys = {
 			},
 		},
 	},
+	fileList: {
+		loadingFiles: '正在加载文件...',
+		noFilesFound: '未找到文件',
+		searchingDeeper: '正在搜索更深目录（深度 {depth}）...',
+		scanning: '正在扫描...（已索引 {count}）',
+		scanningDeeper: '正在搜索更深目录（深度 {depth}，已索引 {count}）...',
+		contentSearchHeader: '≡ 内容搜索',
+		filesHeader: '≡ 文件 [{mode} • Ctrl+T]',
+		treeMode: '树形',
+		listMode: '列表',
+	},
 	ideSelectPanel: {
 		title: '选择 IDE',
 		subtitle: '连接到 IDE 以使用集成开发功能。',
@@ -1666,6 +1677,29 @@ export const zh: TranslationKeys = {
 		failedDisableExitImage: '关闭退出画面失败',
 		setAsExitImage: '已将「{name}」设为退出画面',
 	},
+	agentPickerPanel: {
+		title: '子代理选择',
+		noAgentsWarning: '未配置子代理。请先配置子代理。',
+		selectAgent: '选择子代理',
+		escHint: '（按 ESC 关闭）',
+		noDescription: '无描述',
+		scrollHint: '· ↑↓ 滚动',
+		moreAbove: '上方还有 {count} 项',
+		moreBelow: '下方还有 {count} 项',
+	},
+	todoPickerPanel: {
+		title: 'TODO 选择',
+		scanning: '正在扫描项目中的 TODO 注释...',
+		noTodosFound: '项目中未找到 TODO 注释',
+		noMatchSearch: '没有匹配 "{searchQuery}" 的 TODO（总数：{totalCount}）',
+		typeToClearSearch: '输入以筛选 · 退格键清除搜索',
+		selectTodos: '选择 TODO',
+		filteringLabel: '筛选: "{searchQuery}"',
+		typeToFilterHint: '输入筛选 · 退格清除 · 空格: 切换 · 回车: 确认',
+		typeToSearchHint: '输入搜索 · 空格: 切换 · 回车: 确认 · Esc: 取消',
+		selectedCount: '已选择 {count} 个 TODO',
+		noDescription: '无描述',
+	},
 	exitScreen: {
 		title: '再见',
 		goodbye: '感谢使用 Snow CLI',

source/i18n/types.ts

@@ -589,7 +589,7 @@ export type TranslationKeys = {
 			hybridCompress: string;
 			team: string;
 			branch: string; // Fork conversation into a new branch
-		worktree: string; // Git branch management panel
+			worktree: string; // Git branch management panel
 			diff: string;
 			connect: string;
 			disconnect: string;
@@ -636,6 +636,21 @@ export type TranslationKeys = {
 			};
 		};
 	};
+	// File search list (`@` panel)
+	fileList: {
+		loadingFiles: string;
+		noFilesFound: string;
+		// Used while a deeper rescan is queued or running
+		searchingDeeper: string; // {depth}
+		// Inline status while streaming results in
+		scanning: string; // {count}
+		scanningDeeper: string; // {depth} {count}
+		// Header labels
+		contentSearchHeader: string;
+		filesHeader: string; // {mode}
+		treeMode: string;
+		listMode: string;
+	};
 	// IDE Select Panel
 	ideSelectPanel: {
 		title: string;
@@ -1641,6 +1656,29 @@ export type TranslationKeys = {
 		failedDisableExitImage: string;
 		setAsExitImage: string;
 	};
+	agentPickerPanel: {
+		title: string;
+		noAgentsWarning: string;
+		selectAgent: string;
+		escHint: string;
+		noDescription: string;
+		scrollHint: string;
+		moreAbove: string;
+		moreBelow: string;
+	};
+	todoPickerPanel: {
+		title: string;
+		scanning: string;
+		noTodosFound: string;
+		noMatchSearch: string;
+		typeToClearSearch: string;
+		selectTodos: string;
+		filteringLabel: string;
+		typeToFilterHint: string;
+		typeToSearchHint: string;
+		selectedCount: string;
+		noDescription: string;
+	};
 	exitScreen: {
 		title: string;
 		goodbye: string;

source/ui/components/chat/ChatInput.tsx

@@ -1,14 +1,12 @@
 import React, {
-	useCallback,
 	useEffect,
 	useRef,
 	useMemo,
 	lazy,
 	Suspense,
 } from 'react';
-import {Box, Text} from 'ink';
+import {Box, Text, useCursor} from 'ink';
 import {Viewport} from '../../../utils/ui/textBuffer.js';
-import {cpSlice, visualPosToCodePoint} from '../../../utils/core/textUtils.js';
 
 // Lazy load panel components to reduce initial bundle size
 const CommandPanel = lazy(() => import('../panels/CommandPanel.js'));
@@ -826,26 +824,8 @@ export default function ChatInput({
 		isPureBashMode,
 	]);
 
-	// Render cursor based on focus state
-	const renderCursor = useCallback(
-		(char: string) => {
-			if (hasFocus) {
-				// Focused: solid block cursor (use inverted colors)
-				return (
-					<Text
-						backgroundColor={theme.colors.menuNormal}
-						color={theme.colors.background}
-					>
-						{char}
-					</Text>
-				);
-			} else {
-				// Unfocused: no cursor, just render the character normally
-				return <Text>{char}</Text>;
-			}
-		},
-		[hasFocus, theme],
-	);
+	// Real terminal cursor via useCursor hook
+	const {setCursorPosition, cursorRef} = useCursor();
 
 	// Render content with cursor (treat all text including placeholders as plain text)
 	const INPUT_MAX_LINES = 6;
@@ -884,6 +864,16 @@ export default function ChatInput({
 				endLine = startLine + maxLines;
 			}
 
+			// Set real terminal cursor position
+			const hasScrollUp = startLine > 0;
+			const cursorYInContent =
+				cursorRow - startLine + (hasScrollUp ? 1 : 0);
+			if (hasFocus) {
+				setCursorPosition({x: cursorCol, y: cursorYInContent});
+			} else {
+				setCursorPosition(undefined);
+			}
+
 			const renderedLines: React.ReactNode[] = [];
 
 			// Scroll-up indicator
@@ -899,17 +889,9 @@ export default function ChatInput({
 				const line = visualLines[i] || '';
 
 				if (i === cursorRow) {
-					// This line contains the cursor
-					const cursorIndex = visualPosToCodePoint(line, cursorCol);
-					const beforeCursor = cpSlice(line, 0, cursorIndex);
-					const atCursor = cpSlice(line, cursorIndex, cursorIndex + 1) || ' ';
-					const afterCursor = cpSlice(line, cursorIndex + 1);
-
 					renderedLines.push(
 						<Box key={i} flexDirection="row">
-							<Text>{beforeCursor}</Text>
-							{renderCursor(atCursor)}
-							<Text>{afterCursor}</Text>
+							<Text>{line || ' '}</Text>
 							{commandArgsHint && i === visualLines.length - 1 ? (
 								<Text color={theme.colors.menuSecondary} dimColor>
 									{commandArgsHint}
@@ -918,7 +900,6 @@ export default function ChatInput({
 						</Box>,
 					);
 				} else {
-					// No cursor in this line
 					renderedLines.push(<Text key={i}>{line || ' '}</Text>);
 				}
 			}
@@ -937,13 +918,17 @@ export default function ChatInput({
 
 			return <Box flexDirection="column">{renderedLines}</Box>;
 		} else {
+			// Empty input: cursor at start
+			if (hasFocus) {
+				setCursorPosition({x: 0, y: 0});
+			} else {
+				setCursorPosition(undefined);
+			}
+
 			return (
-				<>
-					{renderCursor(' ')}
-					<Text color={theme.colors.menuSecondary} dimColor>
-						{disabled ? t.chatScreen.waitingForResponse : placeholder}
-					</Text>
-				</>
+				<Text color={theme.colors.menuSecondary} dimColor>
+					{disabled ? t.chatScreen.waitingForResponse : placeholder}
+				</Text>
 			);
 		}
 	};
@@ -997,7 +982,9 @@ export default function ChatInput({
 									? '⤢'
 									: '❯'}{' '}
 							</Text>
-							<Box flexGrow={1}>{renderContent()}</Box>
+							<Box ref={cursorRef} flexGrow={1}>
+								{renderContent()}
+							</Box>
 						</Box>
 						<Box flexDirection="row">
 							<Text