// packages/core — 터미널 화면 및 키스트로크 스트림에서 "지금 치고 있는 입력 줄" 과 Vim 모드를 뽑는다. // // 터미널은 화면 버퍼 전체가 입력창으로 읽히거나(Windows Terminal 등: 상태줄·명령·출력 포함), // 캔버스/레거시 표면(Kitedesk, WezTerm, Alacritty, xterm.js 등: UIA 텍스트 길이 0)으로 노출된다. // 또한 터미널 내부에서 Vim/Neovim 을 쓸 때는 화면 중간 줄을 편집하면서 하단 상태줄(-- INSERT --, // -- NORMAL --, :wq 등)이 함께 바뀐다. // 순수 함수와 순수 상태 머신만 둔다 — 다른 core 모듈을 import 하지 않는다 // (input-intelligence 가 이 모듈을 다시 export 한다). /** 상자·블록·도형·기타 기호·딩뱃 — 터미널 UI/상태줄의 지문이다. */ export const NON_PROSE_GLYPH_PATTERN = /[←-⇿─-➿⬀-⯿]/u /** * 입력 줄의 시작 표시: Claude Code/Codex `>`·`›`, starship `❯`, PowerShell `PS …>`, cmd `C:\…>`, * POSIX `$ # %`(단독이거나 앞에 경로·호스트 표지가 있을 때만 — 출력의 `100% 완료` 를 입력으로 보지 않는다). */ const TERMINAL_PROMPT_PATTERN = /^(?:PS [^>\n]{1,260}>|[A-Za-z]:\\[^>\n]{0,260}>|(?:[^\s]*[@:~/\\][^\s]*)?[$#%]|>|›|❯|»)[ \u00A0]?(.*)$/u /** 테두리·상자 줄(─━═╭╮╰╯ 등)이나 비어 있는 줄에서 입력 영역이 끝난다. */ const TERMINAL_BORDER_PATTERN = /^[\s─━═┄┈╌╍╭╮╰╯┌┐└┘├┤┬┴┼│┃║▔▁▏▕-]*$/u const TERMINAL_EDGE_PATTERN = /^[\s│┃║]+|[\s│┃║]+$/gu const TERMINAL_SCAN_LINES = 40 export type TerminalVimMode = 'insert' | 'normal' | 'command' | null export interface TerminalActiveContext { prefix: string caretReliable: boolean vimMode: TerminalVimMode isVimScreen: boolean } const VIM_INSERT_LINE_PATTERN = /(?:--\s*(?:INSERT|REPLACE|끼워넣기|바꾸기|\(insert\))\s*--|\b(?:INSERT|REPLACE)\b.*(?:\d+,\d+|\d+%|Top|Bot|All))/iu const VIM_NORMAL_LINE_PATTERN = /(?:--\s*(?:NORMAL|VISUAL|SELECT|비주얼|선택)(?:\s+LINE|\s+BLOCK)?\s*--|\b(?:NORMAL|VISUAL)\b.*(?:\d+,\d+|\d+%|Top|Bot|All))/iu const VIM_RULER_LINE_PATTERN = /\s{2,}\d+,\d+(?:-\d+)?\s+(?:All|Top|Bot|\d+%)\s*$/u const VIM_TILDE_LINE_PATTERN = /^\s*~\s*$/u const VIM_COMMAND_LINE_PATTERN = /^:([ㄱ-ㅎㅏ-ㅣ가-힣A-Za-z0-9!%\s_.-]{1,60})$/u const VIM_SHELL_LAUNCH_PATTERN = /^(?:sudo\s+)?(?:vim|nvim|vi|vimdiff|view|gvim|neovide)(?:\s|$)/u const VIM_WINDOW_TITLE_PATTERN = /(?:^|[\s\-—–\\/])(?:n?vim|vi|gvim|neovide)(?:$|[\s\-—–.])/iu /** * 터미널 화면 텍스트에서 "지금 치고 있는 입력" 을 뽑는다. * * 문서형 터미널은 캐럿 위치를 주지 않고 화면 전체를 돌려준다 — 마지막 줄은 대개 * 상태줄이다. 아래에서 위로 가장 가까운 프롬프트 줄을 찾고, 그 아래로 테두리/빈 줄이 * 나올 때까지의 이어진 줄(줄바꿈된 긴 입력)을 붙인다. 프롬프트를 못 찾으면 null — * 제안하지 않는다(출력·상태줄로 제안을 만들지 않는다). */ export function extractTerminalPromptPrefix(screen: string | null | undefined): string | null { if (!screen) return null const lines = screen.replace(/\r/g, '').split('\n') const start = Math.max(0, lines.length - TERMINAL_SCAN_LINES) for (let i = lines.length - 1; i >= start; i--) { const rawLine = lines[i] const hasSingleTrailingSpace = !/[│┃║]\s*$/u.test(rawLine) && /\S $/u.test(rawLine) const line = rawLine.replace(TERMINAL_EDGE_PATTERN, '') const match = TERMINAL_PROMPT_PATTERN.exec(line) if (!match) continue const parts = [match[1].trimEnd()] let lastIdx = i for (let j = i + 1; j < lines.length; j++) { const raw = lines[j] if (TERMINAL_BORDER_PATTERN.test(raw)) break const continuation = raw.replace(TERMINAL_EDGE_PATTERN, '') // 상태줄 기호(◑ ▕░ 등)가 섞인 줄은 입력이 아니다. if (!continuation || NON_PROSE_GLYPH_PATTERN.test(continuation)) break parts.push(continuation) lastIdx = j } const joined = parts.join(' ').replace(/\s+/gu, ' ').trimStart() const tailHasSpace = lastIdx === i ? hasSingleTrailingSpace : !/[│┃║]\s*$/u.test(lines[lastIdx]) && /\S $/u.test(lines[lastIdx]) return joined && tailHasSpace ? `${joined} ` : joined } return null } function isTerminalStatusOrNoiseLine(rawLine: string): boolean { const line = rawLine.replace(TERMINAL_EDGE_PATTERN, '') if (!line.trim()) return true if (TERMINAL_BORDER_PATTERN.test(rawLine)) return true if (NON_PROSE_GLYPH_PATTERN.test(line)) return true if (VIM_TILDE_LINE_PATTERN.test(line)) return true if (VIM_INSERT_LINE_PATTERN.test(line) || VIM_NORMAL_LINE_PATTERN.test(line)) return true if (VIM_RULER_LINE_PATTERN.test(line)) return true return false } function trimGridPadding(rawLine: string): string { if (!/[│┃║]\s*$/u.test(rawLine) && /\S $/u.test(rawLine)) { return `${rawLine.trimEnd()} ` } return rawLine.trimEnd() } function stripPromptFromLine(line: string): string { const hasSingleSpace = !/[│┃║]\s*$/u.test(line) && /\S $/u.test(line) const cleaned = line.replace(TERMINAL_EDGE_PATTERN, '') const match = TERMINAL_PROMPT_PATTERN.exec(cleaned) if (match) { const body = match[1].trimEnd() return body && hasSingleSpace ? `${body} ` : body } // Vim 줄 번호 표시(" 12 dkssudgktpdy")가 앞에 있으면 걷어낸다. const lineNumMatch = /^\s*\d+\s+(.*)$/u.exec(cleaned) if (lineNumMatch) { const body = lineNumMatch[1].trimEnd() return body && hasSingleSpace ? `${body} ` : body } return cleaned && hasSingleSpace ? `${cleaned} ` : cleaned } function commonSuffixLength(a: string, b: string): number { const max = Math.min(a.length, b.length) let count = 0 while (count < max && a[a.length - 1 - count] === b[b.length - 1 - count]) { count += 1 } return count } /** * 터미널 화면 스냅샷(직전/현재)에서 Vim 모드와 현재 편집 중인 활성 줄 접두를 추출한다. */ export function extractTerminalActiveContext( prevScreen: string | null | undefined, currScreen: string | null | undefined, lastActivePrefix?: string | null, windowTitle?: string | null, trackerVimMode?: TerminalVimMode ): TerminalActiveContext { if (!currScreen) { return { prefix: '', caretReliable: false, vimMode: null, isVimScreen: false } } const currLines = currScreen.replace(/\r/g, '').split('\n') const nonEmptyBottom: string[] = [] for (let i = currLines.length - 1; i >= 0 && nonEmptyBottom.length < 5; i -= 1) { const cleaned = currLines[i].replace(TERMINAL_EDGE_PATTERN, '').trimEnd() if (cleaned.trim().length > 0) { nonEmptyBottom.push(cleaned) } } const tildeCount = currLines.filter((line) => VIM_TILDE_LINE_PATTERN.test(line)).length const hasInsertIndicator = nonEmptyBottom.some((line) => VIM_INSERT_LINE_PATTERN.test(line)) const hasNormalIndicator = nonEmptyBottom.some((line) => VIM_NORMAL_LINE_PATTERN.test(line)) const hasRulerIndicator = nonEmptyBottom.some((line) => VIM_RULER_LINE_PATTERN.test(line)) const titleLooksLikeVim = !!windowTitle && VIM_WINDOW_TITLE_PATTERN.test(windowTitle) const hasVimBufferChrome = tildeCount >= 2 || hasInsertIndicator || hasNormalIndicator || hasRulerIndicator // 1. Vim 명령줄 모드 (:ㅈㅂ, :wq, :q! 등) for (let i = 0; i < Math.min(2, nonEmptyBottom.length); i += 1) { const candidate = nonEmptyBottom[i].replace(/\s+\d+,\d+.*$/u, '').trimEnd() if (VIM_COMMAND_LINE_PATTERN.test(candidate)) { return { prefix: candidate, caretReliable: true, vimMode: 'command', isVimScreen: true } } } // 2. 화면에 Vim 상태줄·물결표(~)·룰러가 전혀 없고 셸 프롬프트(PS ...>, $ 등)가 있으면 // 창 제목에 vim/nvim 이 남아 있더라도 일반 셸 입력 줄로 처리한다. if (!hasVimBufferChrome) { const promptPrefix = extractTerminalPromptPrefix(currScreen) if (promptPrefix !== null) { return { prefix: promptPrefix, caretReliable: true, vimMode: null, isVimScreen: false } } } const isVimScreen = hasVimBufferChrome || titleLooksLikeVim let vimMode: TerminalVimMode = null if (hasInsertIndicator) { vimMode = 'insert' } else if (hasNormalIndicator) { vimMode = 'normal' } else if (isVimScreen) { vimMode = trackerVimMode === 'insert' ? 'insert' : 'normal' } // 3. Vim 노멀/비주얼 모드에서는 일반 텍스트 교정을 막는다. if (vimMode === 'normal') { return { prefix: '', caretReliable: false, vimMode: 'normal', isVimScreen: true } } // 3. 직전 스냅샷과 현재 스냅샷을 줄 단위로 비교해 실제 타이핑이 일어난 내용 줄을 찾는다. if (prevScreen && prevScreen !== currScreen) { const prevLines = prevScreen.replace(/\r/g, '').split('\n') const scanStart = Math.max(0, currLines.length - TERMINAL_SCAN_LINES) for (let i = currLines.length - 1; i >= scanStart; i -= 1) { const currRaw = currLines[i] if (isTerminalStatusOrNoiseLine(currRaw)) continue const prevRaw = prevLines[i] ?? '' const currClean = trimGridPadding(currRaw) const prevClean = trimGridPadding(prevRaw) if (currClean === prevClean) continue const suffixLen = commonSuffixLength(prevClean, currClean) const editEnd = Math.max(0, currClean.length - suffixLen) const editedSlice = editEnd > 0 ? currClean.slice(0, editEnd) : currClean const prefix = stripPromptFromLine(editedSlice) if (prefix.trim().length > 0) { return { prefix, caretReliable: true, vimMode, isVimScreen } } } } // 4. 화면이 직전 스냅샷과 같고(예: 멈춤 뒤 settle 타이머) 마지막 활성 줄이 여전히 화면에 있으면 유지한다. if (lastActivePrefix && lastActivePrefix.trim().length > 0) { const trimmedLast = lastActivePrefix.trimEnd() if (currScreen.includes(trimmedLast)) { const keepTrailingSpace = !lastActivePrefix.endsWith(' ') && currScreen.includes(`${trimmedLast} `) return { prefix: keepTrailingSpace ? `${trimmedLast} ` : lastActivePrefix, caretReliable: true, vimMode, isVimScreen } } } // 5. 셸 프롬프트 줄 폴백 const promptPrefix = extractTerminalPromptPrefix(currScreen) if (promptPrefix !== null) { return { prefix: promptPrefix, caretReliable: true, vimMode, isVimScreen } } // 6. Vim INSERT 모드인데 직전 화면이 없으면 가장 아래쪽 일반 내용 줄을 사용한다. if (vimMode === 'insert') { for (let i = currLines.length - 1; i >= 0; i -= 1) { if (isTerminalStatusOrNoiseLine(currLines[i])) continue const prefix = stripPromptFromLine(trimGridPadding(currLines[i])) if (prefix.trim().length > 0) { return { prefix, caretReliable: true, vimMode: 'insert', isVimScreen: true } } } } return { prefix: '', caretReliable: false, vimMode, isVimScreen } } // ============================================================ // 두벌식 키 스트림 조합기 + 터미널/Vim 키스트로크 추적기 // ============================================================ const CHO = [ 'ㄱ', 'ㄲ', 'ㄴ', 'ㄷ', 'ㄸ', 'ㄹ', 'ㅁ', 'ㅂ', 'ㅃ', 'ㅅ', 'ㅆ', 'ㅇ', 'ㅈ', 'ㅉ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ' ] as const const JUNG = [ 'ㅏ', 'ㅐ', 'ㅑ', 'ㅒ', 'ㅓ', 'ㅔ', 'ㅕ', 'ㅖ', 'ㅗ', 'ㅘ', 'ㅙ', 'ㅚ', 'ㅛ', 'ㅜ', 'ㅝ', 'ㅞ', 'ㅟ', 'ㅠ', 'ㅡ', 'ㅢ', 'ㅣ' ] as const const JONG = [ '', 'ㄱ', 'ㄲ', 'ㄳ', 'ㄴ', 'ㄵ', 'ㄶ', 'ㄷ', 'ㄹ', 'ㄺ', 'ㄻ', 'ㄼ', 'ㄽ', 'ㄾ', 'ㄿ', 'ㅀ', 'ㅁ', 'ㅂ', 'ㅄ', 'ㅅ', 'ㅆ', 'ㅇ', 'ㅈ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ' ] as const const KEY_TO_JAMO: Readonly> = { q: 'ㅂ', Q: 'ㅃ', w: 'ㅈ', W: 'ㅉ', e: 'ㄷ', E: 'ㄸ', r: 'ㄱ', R: 'ㄲ', t: 'ㅅ', T: 'ㅆ', y: 'ㅛ', u: 'ㅕ', i: 'ㅑ', o: 'ㅐ', O: 'ㅒ', p: 'ㅔ', P: 'ㅖ', a: 'ㅁ', s: 'ㄴ', d: 'ㅇ', f: 'ㄹ', g: 'ㅎ', h: 'ㅗ', j: 'ㅓ', k: 'ㅏ', l: 'ㅣ', z: 'ㅋ', x: 'ㅌ', c: 'ㅊ', v: 'ㅍ', b: 'ㅠ', n: 'ㅜ', m: 'ㅡ' } const COMPOUND_VOWEL: Readonly> = { 'ㅗㅏ': 'ㅘ', 'ㅗㅐ': 'ㅙ', 'ㅗㅣ': 'ㅚ', 'ㅜㅓ': 'ㅝ', 'ㅜㅔ': 'ㅞ', 'ㅜㅣ': 'ㅟ', 'ㅡㅣ': 'ㅢ' } const COMPOUND_JONG: Readonly> = { 'ㄱㅅ': 'ㄳ', 'ㄴㅈ': 'ㄵ', 'ㄴㅎ': 'ㄶ', 'ㄹㄱ': 'ㄺ', 'ㄹㅁ': 'ㄻ', 'ㄹㅂ': 'ㄼ', 'ㄹㅅ': 'ㄽ', 'ㄹㅌ': 'ㄾ', 'ㄹㅍ': 'ㄿ', 'ㄹㅎ': 'ㅀ', 'ㅂㅅ': 'ㅄ' } /** * 영문 두벌식 키열을 Windows 한국어 IME 와 동일하게 조합한다. */ export function composeHangul2Set(keys: string): string { const jamos: string[] = [] for (const ch of keys) { const mapped = KEY_TO_JAMO[ch] ?? KEY_TO_JAMO[ch.toLowerCase()] if (!mapped) { jamos.push(ch) } else { jamos.push(mapped) } } let out = '' let i = 0 const isConsonant = (j: string): boolean => CHO.includes(j as (typeof CHO)[number]) const isVowel = (j: string): boolean => JUNG.includes(j as (typeof JUNG)[number]) while (i < jamos.length) { const curr = jamos[i] // 자음 + 모음 → 음절 시작 if (isConsonant(curr) && i + 1 < jamos.length && isVowel(jamos[i + 1])) { const choIdx = CHO.indexOf(curr as (typeof CHO)[number]) let v = jamos[i + 1] i += 2 if (i < jamos.length && isVowel(jamos[i]) && COMPOUND_VOWEL[v + jamos[i]]) { v = COMPOUND_VOWEL[v + jamos[i]] i += 1 } const jungIdx = JUNG.indexOf(v as (typeof JUNG)[number]) let jong = '' // 받침 확인 (다음 자음이 모음과 결합해 연음되면 받침으로 쓰지 않는다) if (i < jamos.length && isConsonant(jamos[i])) { const c1 = jamos[i] const nextIsVowel = i + 1 < jamos.length && isVowel(jamos[i + 1]) if (!nextIsVowel && JONG.includes(c1 as (typeof JONG)[number])) { jong = c1 i += 1 if (i < jamos.length && isConsonant(jamos[i])) { const c2 = jamos[i] const afterC2IsVowel = i + 1 < jamos.length && isVowel(jamos[i + 1]) const compound = COMPOUND_JONG[c1 + c2] if (!afterC2IsVowel && compound) { jong = compound i += 1 } } } } const jongIdx = JONG.indexOf(jong as (typeof JONG)[number]) out += String.fromCharCode(0xac00 + (choIdx * 21 + jungIdx) * 28 + Math.max(0, jongIdx)) continue } // 단독 모음 합성 (ㅗ + ㅏ = ㅘ 등) if (isVowel(curr) && i + 1 < jamos.length && isVowel(jamos[i + 1]) && COMPOUND_VOWEL[curr + jamos[i + 1]]) { out += COMPOUND_VOWEL[curr + jamos[i + 1]] i += 2 continue } out += curr i += 1 } return out } const SHIFTED_DIGITS = ')!@#$%^&*(' export function vkToPrintableChar(vk: number, shift: boolean): string | null { if (vk >= 0x41 && vk <= 0x5a) { return shift ? String.fromCharCode(vk) : String.fromCharCode(vk + 32) } if (vk >= 0x30 && vk <= 0x39) { return shift ? (SHIFTED_DIGITS[vk - 0x30] ?? null) : String.fromCharCode(vk) } if (vk >= 0x60 && vk <= 0x69) { return String.fromCharCode(vk - 0x30) } switch (vk) { case 0xba: return shift ? ':' : ';' case 0xbb: return shift ? '+' : '=' case 0xbc: return shift ? '<' : ',' case 0xbd: return shift ? '_' : '-' case 0xbe: return shift ? '>' : '.' case 0xbf: return shift ? '?' : '/' case 0xc0: return shift ? '~' : '`' case 0xdb: return shift ? '{' : '[' case 0xdc: return shift ? '|' : '\\' case 0xdd: return shift ? '}' : ']' case 0xde: return shift ? '"' : "'" default: return null } } export interface TerminalKeyInput { hwnd: number | null windowTitle?: string | null vk: number | null rawKeycode?: number shift: boolean ctrl: boolean alt: boolean meta: boolean koreanIme?: boolean | null now?: number } /** * 터미널 및 Vim 키스트로크 추적기. * * UIA 가 터미널 줄 끝 공백을 잘라 버리거나(Windows Terminal), 캔버스/원격 터미널(Kitedesk, * WezTerm, Alacritty, xterm.js 등)에서 텍스트를 전혀 돌려주지 않을 때(len=0), 그리고 Vim 의 * 노멀/입력/명령줄 모드를 오갈 때 정확한 현재 줄 접두와 조합 상태를 복원한다. */ export class TerminalKeystrokeTracker { private _hwnd: number | null = null private _committed = '' private _composingKeys = '' private _koreanIme = false private _imm32Supported = false private _imeObserved = false private _lastImeToggleAt = 0 private _vimSession = false private _vimMode: TerminalVimMode = null private _pendingVimOperator = '' private _afterEscape = false private _lastKeyWasSpace = false private _shellPromptScreen = false private _prevScreen: string | null = null private _lastScreenPrefix: string | null = null private _unreplacedStart = 0 private _lastXtermValue = '' reset(): void { this._committed = '' this._composingKeys = '' this._pendingVimOperator = '' this._afterEscape = false this._lastKeyWasSpace = false this._lastScreenPrefix = null this._unreplacedStart = 0 } hasObservedImeForHwnd(hwnd: number | null): boolean { return hwnd !== null && this._hwnd === hwnd && this._imeObserved } /** * 키다운 훅 도중(WM_KEYDOWN 처리 중)이 아니라 유휴 스냅샷 시점에 관측한 IME 상태를 반영한다. * 포커스 직후 첫 스냅샷에서 한글 IME 가 감지되면 아직 치환되지 않은 영문 키 꼬리를 두벌식 한글로 복원한다. */ syncKoreanIme(koreanIme: boolean | null | undefined): void { this._imeObserved = true if (typeof koreanIme !== 'boolean') return if (koreanIme) { this._imm32Supported = true this._koreanIme = true this._convertUnreplacedAsciiTailToHangul() } else if (this._imm32Supported) { this._flushComposing() this._koreanIme = false } } onPointerOrFocusChange(hwnd?: number | null): void { if (hwnd !== undefined && hwnd !== this._hwnd) { this._hwnd = hwnd this._imm32Supported = false this._imeObserved = false this._vimSession = false this._vimMode = null this._shellPromptScreen = false this._prevScreen = null this._lastXtermValue = '' } this.reset() } onKeyDown(input: TerminalKeyInput): void { const now = input.now ?? Date.now() if (input.hwnd !== null && input.hwnd !== this._hwnd) { this._hwnd = input.hwnd this._imm32Supported = false this._imeObserved = false this._vimSession = false this._vimMode = null this._shellPromptScreen = false this._prevScreen = null this._lastXtermValue = '' this.reset() } if (!this._shellPromptScreen && input.windowTitle && VIM_WINDOW_TITLE_PATTERN.test(input.windowTitle)) { this._vimSession = true if (this._vimMode === null) this._vimMode = 'normal' } // 한/영 전환 키 (VK_HANGUL = 0x15, uiohook keycode = 112) if (input.rawKeycode === 112 || input.vk === 0x15) { this._flushComposing() // Vim 노멀 모드(또는 Esc 직후)에서 i/a/o 를 눌러 입력 모드로 들어간 직후 한/영 키를 눌렀다면 // 앞에 찍힌 i/a/o 는 Vim 명령이므로 버퍼에서 비운다. if ( (this._afterEscape || this._vimSession) && /^[hjklwbe0$dugG]*[iIaAoOsSCR]$/u.test(this._committed) ) { this._committed = '' this._vimSession = true this._vimMode = 'insert' this._afterEscape = false } this._koreanIme = !this._koreanIme this._imeObserved = true this._lastImeToggleAt = now return } // Chromium/Electron(Agent Switchboard, VS Code 등)은 TSF IME 를 사용해 최상위 HWND 의 // ImmGetDefaultIMEWnd(IMC_GETCONVERSIONMODE)가 한글 상태에서도 항상 false(0)를 돌려준다. // 따라서 해당 창에서 한 번이라도 true 가 관측된 경우(_imm32Supported)에만 false 로의 하향 동기화를 허용한다. if (typeof input.koreanIme === 'boolean') { this._imeObserved = true if (input.koreanIme) { this._imm32Supported = true } if ((input.koreanIme || this._imm32Supported) && now - this._lastImeToggleAt > 250) { if (this._koreanIme && !input.koreanIme) { this._flushComposing() } this._koreanIme = input.koreanIme } } const { vk, shift, ctrl, alt, meta } = input // 순수 수정자 키(Shift/Ctrl/Alt/Win) 단독 눌림·키 반복은 버퍼나 조합 상태를 바꾸지 않는다. if ( vk === 0x10 || vk === 0x11 || vk === 0x12 || vk === 0x5b || vk === 0x5c || (vk !== null && vk >= 0xa0 && vk <= 0xa5) ) { return } // D3RO Voice 전역 제안/음성 단축키(Ctrl+Alt+방향키/Enter/Space/Backspace)는 OS globalShortcut 이 가로채므로 // 터미널 입력 줄 버퍼를 초기화하지 않는다. if ( ctrl && alt && !meta && (vk === 0x0d || vk === 0x20 || vk === 0x08 || (vk !== null && vk >= 0x25 && vk <= 0x28)) ) { return } // Escape 또는 Ctrl+[ / Ctrl+C → 현재 줄 초기화 (실제 Esc/Ctrl+[ 만 _afterEscape 설정) const isRealEscape = vk === 0x1b || (ctrl && !alt && !meta && vk === 0xdb) const isCtrlC = ctrl && !alt && !meta && vk === 0x43 if (isRealEscape || isCtrlC) { this.reset() if (isRealEscape) { this._afterEscape = true } if (this._vimSession) { this._vimMode = 'normal' } return } // 기타 단축키(Ctrl/Alt/Meta 조합)는 버퍼를 비운다. if (ctrl || alt || meta) { this.reset() return } if (vk === null) { this._lastKeyWasSpace = false return } // Enter (0x0D) if (vk === 0x0d) { this._lastKeyWasSpace = false const fullLine = this.currentPrefix().trim() if (VIM_SHELL_LAUNCH_PATTERN.test(fullLine)) { this._vimSession = true this._vimMode = 'normal' } else if (this._vimMode === 'command') { const cmd = fullLine.replace(/^:/u, '').trim() if (/^(?:q|qa|wq|wqa|x|xa)!?$/u.test(cmd)) { this._vimSession = false this._vimMode = null } else { this._vimMode = 'normal' } } this.reset() return } // Tab (0x09), 화살표(0x25..0x28), Home/End/PgUp/PgDn/Delete(0x21..0x24, 0x2E) if (vk === 0x09 || (vk >= 0x21 && vk <= 0x28) || vk === 0x2e) { this.reset() return } // Backspace (0x08) if (vk === 0x08) { this._lastKeyWasSpace = false if (this._composingKeys.length > 0) { this._composingKeys = this._composingKeys.slice(0, -1) return } if (this._committed.length > 0) { this._committed = this._committed.slice(0, -1) this._unreplacedStart = Math.min(this._unreplacedStart, this._committed.length) if (this._vimMode === 'command' && this._committed.length === 0) { this._vimMode = 'normal' } } return } // Space (0x20) if (vk === 0x20) { if (this._vimMode === 'normal') { this._pendingVimOperator = '' this._lastKeyWasSpace = false return } this._flushComposing() this._committed += ' ' this._lastKeyWasSpace = true return } this._lastKeyWasSpace = false const ch = vkToPrintableChar(vk, shift) if (!ch) return // Vim 노멀 모드에서의 키 처리 if (this._vimMode === 'normal') { this._handleVimNormalChar(ch) return } // 아직 vimSession 이 확정되지 않았더라도 Esc 직후나 줄 맨 앞에서 ':' 를 치면 즉시 Vim 명령줄 모드로 본다. if (ch === ':' && (this._afterEscape || (this._committed.length === 0 && this._composingKeys.length === 0))) { this._flushComposing() this._vimSession = true this._vimMode = 'command' this._afterEscape = false this._committed = ':' return } // 알파벳 키 (A..Z) if (vk >= 0x41 && vk <= 0x5a) { // Esc 직후 영문 상태에서 노멀 모드 이동키(h/j/k/l 2회 이상 또는 기존 vimSession) 뒤에 i/a/o/s 를 친 경우 if ( this._afterEscape && !this._koreanIme && /^[iIaAoOsSCR]$/u.test(ch) && /^[hjklwbe0$dugG]*$/u.test(this._committed) && (this._vimSession || /[hjkl]{2,}/u.test(this._committed)) ) { this._vimSession = true this._vimMode = 'insert' this._afterEscape = false this._committed = '' this._composingKeys = '' return } if (this._koreanIme) { const normKey = /^[QWERTPO]$/u.test(ch) ? ch : ch.toLowerCase() this._composingKeys += normKey this._commitOverflowSyllables() } else { this._flushComposing() this._committed += ch } return } // 숫자 및 문장부호: 한글 조합을 먼저 확정하고 문자를 추가한다. this._flushComposing() this._committed += ch } /** * 프로그램(오타 교정)이 커서 앞 deleteCount 글자를 지우고 insertText 를 넣었을 때 버퍼를 동기화한다. * 비동기 치환 도중 사용자가 추가로 친 글자(baseLength 이후)가 있으면 유실하지 않고 뒤에 보존한다. */ applyReplacement(deleteCount: number, insertText: string, baseLength?: number): void { const full = this.currentPrefix() const targetEnd = baseLength !== undefined && baseLength >= 0 ? Math.min(baseLength, full.length) : full.length const keepLen = Math.max(0, targetEnd - Math.max(0, deleteCount)) const typedAfterStart = full.slice(targetEnd) this._committed = full.slice(0, keepLen) + insertText + typedAfterStart this._composingKeys = '' this._lastKeyWasSpace = this._committed.endsWith(' ') this._lastScreenPrefix = this._committed this._unreplacedStart = keepLen + insertText.length } currentPrefix(): string { return this._committed + (this._composingKeys ? composeHangul2Set(this._composingKeys) : '') } get isComposing(): boolean { return this._composingKeys.length > 0 } get vimMode(): TerminalVimMode { return this._vimMode } /** * UIA 텍스트가 없는 터미널(Kitedesk, 캔버스 터미널 등)에서 현재 키스트로크 문맥을 돌려준다. */ getSnapshot( hwnd: number | null, windowTitle?: string | null ): { prefix: string; caretReliable: boolean; isComposing: boolean; vimMode: TerminalVimMode } { if (hwnd !== null && this._hwnd !== null && hwnd !== this._hwnd) { return { prefix: '', caretReliable: false, isComposing: false, vimMode: null } } if (windowTitle && VIM_WINDOW_TITLE_PATTERN.test(windowTitle)) { this._vimSession = true } if (this._vimMode === 'normal') { return { prefix: '', caretReliable: false, isComposing: false, vimMode: 'normal' } } const prefix = this.currentPrefix() return { prefix, caretReliable: prefix.length > 0, isComposing: this.isComposing, vimMode: this._vimMode } } /** * UIA 화면 버퍼가 있는 터미널(Windows Terminal, pwsh, cmd 등)에서 화면 파싱과 키스트로크 버퍼를 결합한다. */ reconcileWithScreen( currScreen: string | null | undefined, windowTitle?: string | null ): { prefix: string; caretReliable: boolean; isComposing: boolean; vimMode: TerminalVimMode } { const screenCtx = extractTerminalActiveContext( this._prevScreen, currScreen, this._lastScreenPrefix, windowTitle, this._vimMode ) this._prevScreen = currScreen ?? null if (screenCtx.isVimScreen) { this._shellPromptScreen = false this._vimSession = true if (screenCtx.vimMode !== null) { if (screenCtx.vimMode === 'normal' && this._vimMode !== 'normal') { this.reset() } this._vimMode = screenCtx.vimMode } } else if (screenCtx.prefix.length > 0) { this._shellPromptScreen = true this._vimSession = false this._vimMode = null } if (this._vimMode === 'normal' || screenCtx.vimMode === 'normal') { return { prefix: '', caretReliable: false, isComposing: false, vimMode: 'normal' } } const tracked = this.currentPrefix() // Vim 명령줄(:ㅈㅂ 등)은 화면에 실제 ':...' 줄이 보이면 그 줄을 정본으로 삼고, // 아직 화면에 반영되지 않은 방금 친 키가 있을 때만(tracked 가 screenCtx.prefix 로 시작할 때) tracked 를 쓴다. if (screenCtx.vimMode === 'command' || this._vimMode === 'command') { let cmdPrefix: string if (screenCtx.prefix.startsWith(':')) { cmdPrefix = tracked.startsWith(screenCtx.prefix) && tracked.length > screenCtx.prefix.length ? tracked : screenCtx.prefix } else if (tracked.startsWith(':')) { cmdPrefix = tracked } else { cmdPrefix = screenCtx.prefix || tracked } this._committed = cmdPrefix this._composingKeys = '' this._lastScreenPrefix = cmdPrefix return { prefix: cmdPrefix, caretReliable: cmdPrefix.length > 1, isComposing: this.isComposing, vimMode: 'command' } } // Windows Terminal 등 그리드 터미널은 줄 끝 공백을 UIA 텍스트에서 잘라 버린다. // 방금 Space 키를 쳤다면(또는 키 버퍼 끝에 공백이 있다면) 화면 줄 끝에 공백을 복원한다. let resolved = screenCtx.prefix if (!resolved.trim() && tracked.length > 0) { resolved = tracked } else if (resolved.trim().length > 0 && !resolved.endsWith(' ') && this._lastKeyWasSpace) { resolved = resolved.trimEnd() + ' ' } if (/[가-힣ㄱ-ㆎ]\s*$/u.test(resolved)) { this._koreanIme = true this._imeObserved = true this._convertUnreplacedAsciiTailToHangul() } else if (/[A-Za-z]\s*$/u.test(resolved)) { this._imeObserved = true } this._lastScreenPrefix = resolved return { prefix: resolved, caretReliable: resolved.trim().length > 0, isComposing: this.isComposing, vimMode: this._vimMode ?? screenCtx.vimMode } } /** * xterm.js(`xterm-helper-textarea`)의 `.value` 와 키스트로크 버퍼를 결합한다. * * xterm.js 는 Backspace·Space·영문 키를 `preventDefault()` 로 가로채 PTY 로만 보내고 * `