feat(desktop): built-in Han/Eng layout auto-switching, terminal/Vim support, and Unicode input

This commit is contained in:
Yun Chan 2026-10-27 10:48:07 +09:00
parent 1da04b9e46
commit a3ac44da2b
109 changed files with 8234 additions and 242 deletions

View file

@ -53,7 +53,18 @@ export type {
LocalSuggestionHints,
SuggestionJoint
} from './suggestion-text'
export { extractTerminalPromptPrefix } from './terminal-prompt'
export {
TerminalKeystrokeTracker,
composeHangul2Set,
extractTerminalActiveContext,
extractTerminalPromptPrefix,
vkToPrintableChar
} from './terminal-prompt'
export type {
TerminalActiveContext,
TerminalKeyInput,
TerminalVimMode
} from './terminal-prompt'
// ============================================================
// 기하 — 정본은 popup-placement.ts (좌표 공간 · 배치 정책). 기존 import 경로를 유지한다.
@ -203,10 +214,11 @@ export const PASTE_INSERTION_THRESHOLD_CHARS = 200
* 끝에서 쓰거나 지운 것이다. 같으면(편집 없음) true.
*/
export function isEditAtTextEnd(prevRaw: string, nextRaw: string): boolean {
// RichEdit 계열(카카오톡 등)은 값 끝에 줄끝 문자(\r)를 붙여 돌려준다. 그대로 비교하면 모든 편집이
// "뒤에 기존 글이 남은 중간 편집" 이 되어 caret-unknown 으로 막혔다(실측 2026-10-03, 카톡 79회).
const prevText = prevRaw.replace(/[\r\n\u200b\ufeff]+$/u, '')
const nextText = nextRaw.replace(/[\r\n\u200b\ufeff]+$/u, '')
// RichEdit 계열(카카오톡 등)은 값 끝에 줄끝 문자(\r)를 붙여 돌려주고, 한영 자동 전환 직후에는
// 교체 전후 텍스트가 모두 공백("dkssud " → "안녕 ")으로 끝난다. 끝 공백·줄끝 문자를 그대로 비교하면
// 마지막 글자(' ')가 같아 중간 편집으로 오인하고 caret-unknown 으로 막힌다(실측 2026-10-03·2026-10-26).
const prevText = prevRaw.replace(/[\s\u200b\ufeff]+$/u, '')
const nextText = nextRaw.replace(/[\s\u200b\ufeff]+$/u, '')
if (prevText === nextText) return true
let prefix = 0
const maxPrefix = Math.min(prevText.length, nextText.length)
@ -434,6 +446,8 @@ export type SuggestionSkipReason =
* 접두가 "문서 끝" 이라 실제 커서 위치와 무관하다 — 수락하면 문서 중간에 엉뚱한 문장이 붙는다.
*/
| 'caret-unknown'
/** 주소·경로·쿼리를 치는 중 — 문장을 이어 쓸 자리가 아니다 */
| 'address-input'
export type SuggestionDecision =
| { action: 'request'; prefix: string }
@ -480,6 +494,21 @@ export interface SuggestionPolicyInput {
* 순서가 중요하다: 비활성·보안(비밀번호)·IME 조합은 다른 어떤 조건보다 먼저 차단한다.
* `clear` 는 "오버레이를 지워야 한다"는 뜻이고, `skip` 은 "이번엔 넘어간다"이다.
*/
/**
* 커서 앞 마지막 덩어리(공백 없는 토큰)가 주소·경로·쿼리인가.
* "https://…", "www.…", "example.com/…", "D:/work/…", "?utm_source=…" 처럼 생겼으면 그렇다.
* 한글 문장 속 "1/2" 같은 짧은 것은 아니다(점·슬래시 구조가 있어야 한다).
*/
export function isAddressInput(prefix: string): boolean {
if (/\s$/u.test(prefix)) return false
const token = prefix.split(/\s+/u).pop() ?? ''
if (token.length < 4) return false
if (/^(https?:\/\/|www\.|file:)/iu.test(token) || token.includes('://')) return true
if (/^[a-z0-9-]+(\.[a-z0-9-]+)+(\/|$|\?|#|:)/iu.test(token) && /\.[a-z]{2,}/iu.test(token)) return true
if (/^[a-z]:[\\/]/iu.test(token) || /^\.{0,2}\//u.test(token)) return true
return /[?&][\w.-]+=/u.test(token)
}
export function decideSuggestion(input: SuggestionPolicyInput): SuggestionDecision {
if (!input.enabled) return { action: 'clear', reason: 'disabled' }
if (input.isPassword) return { action: 'clear', reason: 'password-field' }
@ -508,6 +537,8 @@ export function decideSuggestion(input: SuggestionPolicyInput): SuggestionDecisi
const prefix = normalizeRequestPrefix(input.prefix)
if (!prefix) return { action: 'clear', reason: 'empty-prefix' }
// 주소창·경로 입력 중에는 문장을 제안하지 않는다(실측: "haramlog.app/ja/beta" 에 고객센터식 문장 12개).
if (isAddressInput(input.prefix)) return { action: 'clear', reason: 'address-input' }
// 문장이 끝났다고 막지 않는다.
//
// 이 기능은 "다음 문장 제안" 이다 — 마침표/물음표 뒤야말로 다음 문장이 필요한
@ -755,7 +786,16 @@ export const TERMINAL_APPS: readonly string[] = Object.freeze([
'pwsh',
'mintty',
'alacritty',
'wezterm',
'wezterm-gui',
'kitty',
'ghostty',
'putty',
'MobaXterm',
'Kitedesk',
'nvim-qt',
'neovide',
'gvim',
'Hyper',
'Tabby',
'Warp'
@ -788,10 +828,23 @@ export const LEARNING_EXCLUDED_APPS: readonly string[] = Object.freeze([
'clion64',
'goland64',
'studio64',
'sublime_text',
'Agent Switchboard'
'sublime_text'
])
/**
* 그 앱 안에서만 배우는 앱 — 표본(typing_samples)에만 앱 이름과 함께 저장하고, 공용 문구·그래프에는 넣지 않는다.
* 제안할 때는 같은 앱의 표본에서만 이어 쓴 글을 찾는다.
*
* Agent Switchboard 는 사용자가 가장 많이 타이핑하는 곳인데(2026-10-25), 2026-09-24 에 학습 제외였다 — 개발 지시가
* 카카오톡 제안으로 번졌기 때문. 앱 안으로 가두면 번지지 않으면서 그 앱의 제안에는 재료가 생긴다.
*/
export const APP_SCOPED_LEARNING_APPS: readonly string[] = Object.freeze(['Agent Switchboard'])
/** 이 앱의 글은 그 앱 안에서만 쓰는가 (공용 문구·그래프 금지). */
export function isAppScopedLearning(appName: string | null | undefined): boolean {
return !!appName && isAppExcluded(appName, APP_SCOPED_LEARNING_APPS)
}
/**
* 제안 이력에 입력 문맥(접두) 원문을 남겨도 되는가.
*
@ -817,6 +870,36 @@ export function shouldLearnFromApp(appName: string | null | undefined): boolean
return !(appName && isAppExcluded(appName, LEARNING_EXCLUDED_APPS))
}
/**
* 터미널·코드 에디터·에이전트 허브(예: Integrated Terminal 이나 캔버스 터미널이 들어 있는 개발 도구)인가.
*
* 이 표면에서는:
* 1) 일반 철자·모델 오타 교정은 끄고 한영 자판 전환(layoutOnly)만 수행하며,
* 2) UIA 가 텍스트를 돌려주지 않는 캔버스 영역(xterm.js, Kitedesk 등)에서도 키스트로크 추적으로
* 한영 자판 자동 전환과 Vim 모드 전환을 지원한다.
*/
export function isTerminalOrDeveloperSurface(appName: string | null | undefined): boolean {
if (!appName) return false
return isTerminalApp(appName) || !shouldLearnFromApp(appName) || isAppScopedLearning(appName)
}
/**
* xterm.js 기반 임베디드 터미널(Agent Switchboard, VS Code, Cursor, Hyper, Tabby 등)의 숨은 입력창인가.
*
* `<textarea class="xterm-helper-textarea" aria-label="Terminal input">` 는 UIA 에서 편집 가능한
* ValuePattern 컨트롤로 잡히지만, xterm.js 가 Backspace·Space·영문 키를 `preventDefault()` 로 가로채
* PTY 로만 보내고 `<textarea>.value` 는 Enter/Ctrl+C 전까지 비우지 않는다.
* 따라서 `<textarea>.value` 를 일반 입력칸 텍스트로 쓰면 교정 후에도 옛 한글이 그대로 남아 무한 재교정이 일어난다.
*/
export function isXtermHelperControl(
snapshot: Pick<FocusSnapshot, 'className' | 'controlName'>
): boolean {
const cls = snapshot.className?.trim().toLowerCase() ?? ''
if (cls.includes('xterm-helper-textarea')) return true
const name = snapshot.controlName?.trim().toLowerCase() ?? ''
return name === 'terminal input'
}
/** 공백을 뺀 글자 중 문자(모든 언어)가 이 비율 이상이어야 문장으로 본다. */
const MIN_LETTER_RATIO = 0.6
@ -1210,6 +1293,8 @@ export interface SuggestionCandidate {
rank: number
/** 접두와의 이음새 — 생략하면 'separate' (joinSuggestion 참고) */
joint?: SuggestionJoint
/** 'personal' = 모델을 기다리지 않고 먼저 띄운 내 기록(개인 n-gram) 후보. 생략하면 모델 후보 */
source?: 'personal'
}
/**
@ -1268,6 +1353,11 @@ export interface SuggestionState {
minPrefixChars: number
/** 응답 제한 (ms) — 넘기면 이번 요청을 버린다 (모델이 느린 하드웨어 보호) */
requestTimeoutMs: number
/**
* 후보 없이 끝났음을 잠깐 알린다 — "생성 중" 이 떴다가 말없이 사라지면 고장처럼 보였다(2026-10-25 사용자 요청).
* 'no-suggestion' 이면 오버레이가 "제안 사항 없음" 을 1초 보여 주고 닫힌다.
*/
notice: 'no-suggestion' | null
/** 연속 실패로 잠시 쉬는 중인가 */
coolingDown: boolean
/** 학습 동의 상태 요약 (UI 표시) */