Repository navigation
Vim Source mode and code block CM
세 편집 표면 중 둘은 CodeMirror 다 — source mode 전체와, WYSIWYG 안의 코드블록 하나하나.
이쪽은 자체 엔진이 아니라 @replit/codemirror-vim 어댑터를 쓴다.
source mode 와 코드블록은 실제로 줄과 칼럼으로 된 평문 버퍼다. vim 의 모델이 전제하는 바로 그것이라, 검증된 어댑터를 쓰지 않을 이유가 없다. 직접 만들면 기능의 긴 꼬리를 처음부터 다시 만드는 일이고 얻는 것이 없다. 왜 WYSIWYG 만 다른지는 Overview 에 있다.
그래서 이 페이지의 내용은 vim 자체가 아니라 어댑터를 이 앱에 붙이는 자리다 — 로딩, 한글 IME, 블록 경계, 그리고 섬의 수명.
vim 모듈은 동적 import 다. 설정을 켜지 않는 사용자는 내려받지 않는다. 모듈 promise 는 캐시되어 source mode 를 드나들 때마다, 그리고 코드블록마다 같은 모듈을 공유한다.
확장은 Prec.highest(vim()) 으로 세운다. vim 의 키 처리는 자기 ViewPlugin 핸들러에서
일어나므로 어떤 keymap 도 그 위에 앉을 수 없다. 이 사실이 아래 경계 처리의 모양을 정한다.
실기기(Tauri / WKWebView)에서 잰 결과가 설계를 정했다. 이 WebKit 은 한글 2벌식에 대해
composition 이벤트를 하나도 내지 않고, 취소 가능한 beforeinput(insertText ·
insertReplacementText)으로 텍스트를 넣는데 그것이 keydown 보다 먼저다.
따라서 keydown 단계의 방어는 원리적으로 동작할 수 없다. 자모는 keydown 이 오기 전에 이미
들어가 있다. 그래서 방어가 beforeinput 취소인 것이고, 그러면서도 keydown 은 정상 경로로
vim 에 도달한다(어댑터의 non-ASCII 코드 폴백이 ㅓ/KeyJ 를 j 로 읽는다).
normal 과 visual 에만 건다. insert 와 replace(R)는 진짜 텍스트 입력이 필요하다.
소문자 r 은 모드를 바꾸지 않고 normal 에 머무르므로, 삽입은 취소되고 뒤따르는 keydown 이
vim 의 리터럴 치환을 구동한다 — 그게 맞는 동작이다.
실기기에서 드러난 것: 어댑터의 덮어쓰기 분기는 key.length 가 1이면 keydown 에서 e.key 를
직접 삽입하는데, macOS WKWebView 는 한글 keydown 에 진짜 자모를 실어 보낸다(key="ㅇ").
그래서 vim 이 한 번 넣고, 취소할 수 없는 composition 이 또 한 번 확정한다 — 한 번 누를 때마다
두 글자.
처치의 모양이 중요하다. keydown 을 막으면 안 된다 — CodeMirror 의 InputState 기록이
굶어서 composition 대기 상태가 풀리지 않고, 그러면 Safari 가 사용자의 다음 Esc 를 삼킨다.
키 기반 판정도 안 된다 — 직접 입력 레이아웃(é·ñ·κ)의 덮어쓰기가 깨진다.
그래서 덮어쓰기 메서드 자체를 에디터마다 감싸고, IME 가 그 텍스트를 소유할 때만 건너뛴다. 증거는 둘이다:
-
CodeMirror 자신의 composition 상태를 읽는다. 로컬
compositionend리스너가 아니다 — Safari 는 dead-key 조합에서compositionend를 아예 안 낼 때가 있고 CM 은 DOM 이벤트 없이 내부 타이머로 회복한다. 로컬 플래그였다면 참으로 굳어 replace 입력이 영구히 죽는다. -
짧은 창 안에서 본
insertText/insertCompositionTextbeforeinput. 창을 두는 이유는 오래된 증거가 나중의 직접 입력을 억누르면 안 되기 때문이다. 양쪽을 NFC 정규화해 맞춰 보고 (InputEvent의 data 에는 정규화 계약이 없다), 맞으면 소비한다 — IME 삽입 하나가 수동 덮어쓰기를 최대 하나만 억제하도록.
직접 레이아웃 문자는 두 증거 중 아무것도 못 만들므로 온전한 덮어쓰기 의미론을 유지한다. 메서드를 감싼 덕에 어댑터의 keypress 옆문도 같이 닫힌다.
표준 순서 스트림(keydown 이 compositionstart 보다 먼저 — 최신 WebKit 의 교정된 순서,
printable key 를 보고하는 Chromium IME)에서는 첫 조합 문자에 IME 증거가 없어 다시
두 번 들어간다. 이 구현은 측정된 WKWebView 표면을 겨냥한 것이다.
첫 덮어쓰기를 미뤄 분류하는 방식은 의도적으로 기각했다 — 지연이 빠른 입력의 순서를 뒤집는다. 다른 표면을 지원하게 되면 여기부터 다시 재야 한다.
vim 의 키 처리가 CodeMirror 의 contentDOM 리스너에서 돌고 그 위에 keymap 을 얹을 수 없으므로, 경계 넘기는 CM 루트에서 capture 단계로 듣는다. 조상이어야 하는 이유가 있다 — 같은 타깃에서는 capture 리스너조차 등록 순서로 돌고, CodeMirror 가 먼저 등록했다.
: 와 / 패널은 contentDOM 밖에 마운트되므로 composedPath 로 걸러 낸다. 그래서 :quit 에
타이핑한 u 가 ProseMirror 의 undo 로 새지 않는다.
소비는 preventDefault + stopPropagation 이고 stopImmediatePropagation 은 아니다 —
CodeMirror 의 같은 타깃 기록 리스너가 계속 돌아야 한다.
코드블록의 vim 결합부는 NodeView 에서 분리된 collaborator 이고, 두 수명이 다르다는 것이 그 모듈의 계약이다.
| 수명 | 무엇이 산다 |
|---|---|
| NodeView (생성 → 파괴) | 레지스트리 구독(vim on/off 브로드캐스트, 명시적 entry 채널), 컨테이너 mousedown 진입, 그리고 설정 재생성을 살아남아야 하는 복원 메모 |
| CM 인스턴스 (attach → detach, 재생성마다 반복) | vim controller, 섬 상태 리스너(focusin · focusout · keydown), 그리고 바로 그 인스턴스를 캡처한 클로저들 |
detachCM 은 복원 메모를 보존한다 — 재생성 뒤의 복원이 그 메모로 산다. 레지스트리를
해제하는 것은 destroy 뿐이다. 이건 핀이 아니라 규약이다 — destroy 를 거치지 않는 teardown
경로를 새로 만들면 레지스트리가 샌다.
의존 방향은 한쪽이다: NodeView → 결합부 → (controller · 상태 · 키 · 레지스트리). 결합부는
NodeView 클래스도 vim-plugin.ts 도 import 하지 않는다(vim-keys · vim-status 같은 leaf 는 쓴다).
진입이 "됐다 안 됐다" 했던 비결정성과 그 핸드오프 채널은 Input islands and block entry 에 있다.
이 wiki 는 baram 리포의 wiki/ 에서
생성됩니다. 여기서 편집하지 마세요 — 다음 게시가 덮어씁니다. 고칠 것은 리포에 PR 로 보내 주세요.
링크 없는 항목은 아직 쓰지 않았다. 그 주제의 현재 출처는 해당 모듈의 헤더 주석이고, 어느 파일인지는 Code map 이, 구현 현황은 #298 · #372 가 답한다.
- Overview
- Architecture
- Core state machine — 미작성
- Adapters — 미작성
- Hangul and IME — 미작성
- Input islands and block entry
- Search — 미작성
- Source mode and code block CM
- Lifecycle and settings — 미작성
- WebKit selection churn
- PM machinery in non-editable views — 미작성
- Performance — 미작성
- Resource and security boundaries — 미작성
- Internal contracts — 미작성
- Command reference — 미작성
- Testing methodology — 미작성
- Code map
- Decisions and history
링크 없는 항목은 아직 쓰지 않았다. 쓰는 법은 사용자 문서 가,
구현 현황과 다음 단계는 추적 이슈 가, 계약은
src-tauri/src/cli/ 의 모듈 헤더와 함수 · 타입의 문서 주석이 답한다.
- Overview
- Architecture
- Vault resolution and app config — 미작성
- Paths and vault boundary
- Output contract
- Links and app parity
- MCP server
- Testing methodology — 미작성
- Code map — 미작성
- Decisions and history