한글 / 일본어 / 중국어 입력 + 출력이 깨지지 않게. mode machine (p9-fb-12) 위에 IME safe 입력 흐름.
Allowed dependencies
unicode-width = "0.2" (이미 워크스페이스에 있는지 확인 후 도입).
Public surface
kebab-tui::input::InputBuffer — String + cursor (column 단위 wide-char width 인지). ratatui Span 렌더링 시 unicode-width::UnicodeWidthStr 로 정확한 width.
Behavior contract
IME composing event: crossterm 은 native IME composing surface X — 자모 단위 KeyCode::Char(c) 로 도착. mode machine (p9-fb-12) 에서 INSERT 모드면 모든 Char 가 buffer push, NORMAL 모드면 single-key command.
wide char width: c.width() 로 cursor column 진행. ASCII=1, CJK=2.
buffer 의 byte index vs char index 구분 — backspace 는 마지막 char (pop_char) 단위 삭제, byte slice 금지.
한글 fixture 추가: fixtures/markdown/한글-테스트.md, query 러스트 비동기, 답변 streaming 테스트 답변 등.
Test plan
kind
description
unit
InputBuffer 한글 5 자 push → display_width = 10
unit
backspace 가 자모 1 단위가 아닌 완성형 글자 1 단위 (utf-8 char boundary)
unit
한글 query → SQLite FTS5 정상 검색 (이미 NFC 정규화)
integration
TUI run-loop 모의로 한글 query 입력 → status bar 글자 깨짐 X
DoD
cargo test -p kebab-tui 통과
한글 fixture 추가
README — CJK 입력 동작 정상 명시
Out of scope
macOS IME (Korean composing 시 system level) 회피 — fallback 안내 (외부 editor 사용 권장)
emoji surrogate pair (현재 pulldown-cmark 가 처리)
Notes
2026-05-03 partial: kebab-tui::input::{display_width, truncate_to_display_width} helper 모듈 + Korean/Japanese fixture render audit + 9 unit tests + library.rs 의 중복 truncate 제거 (단일 source). InputBuffer struct 도입은 follow-up — Ask/Search/Editor pane 의 String + cursor 를 일괄 마이그레이션하면 회귀 표면이 커서 위 helper 만 먼저 머지. 백스페이스는 String::pop() 이 char-aware 라 byte-boundary 안전성은 이미 확보된 상태. 후속 spec issue 는 HOTFIXES.md 참조.
2026-05-03 follow-up: InputBuffer { content, cursor_col } struct landed; Search/Ask/FilterEdit migrated; cursor column-aligned via f.set_cursor_position in each render fn (block.inner-derived coordinates, right-edge clamp). Korean FTS5 end-to-end smoke pin in crates/kebab-app/tests/search_korean.rs. lexical_query test helper 가 crates/kebab-app/tests/common/mod.rs 로 promotion. spec status in_progress → completed.
