Skip to content

Vim Code map

github-actions[bot] edited this page Oct 6, 2026 · 2 revisions

Vim Code map

vim 구현의 파일 경로가 사는 유일한 페이지다. 다른 페이지는 경로를 적지 않고 여기를 가리킨다. 링크는 main 을 가리키므로 파일이 옮겨지면 404 가 된다 — 그리고 리포의 lint:wiki 게이트가 그보다 먼저 빨간불을 낸다. 단 아래 다섯 절의 검사 강도가 서로 다르다 — 마지막 절의 도입부를 볼 것.

§ 는 vim 설계서의 절 번호다. 설계서 자체는 내부 문서(리포 밖)지만, 같은 § 가 각 모듈의 헤더 주석에 붙어 있다 — 공개된 등가물은 그 헤더 주석이고, 어긋나면 헤더가 옳다.

core — 순수 상태기계 (ProseMirror 무의존)

파일 무엇
state-machine.ts 모달 상태기계 (설계 §14)
goal-column.ts goal column(vim curswant) 규칙 — 명령마다 유지 / 잊음 / 줄 끝, find 는 성공했을 때만 잊음
step-kit.ts 상태기계 공용 프리미티브 — 모션 표 · count 산술 · StepResult 생성
normal-keys.ts normal 모드 단일 키와 Escape
visual-keys.ts visual 모드 단일 키
pending-keys.ts 대기 중인 시퀀스의 두 번째 키 — 오퍼레이터 · g/z · find 대상
command-lines.ts ex : 줄과 /·? 검색 줄 입력
types.ts core 어휘 — KeyToken · CoreCommand intent
keys.ts 키스트로크 정규화 (물리키 / raw 분리)
visual-state.ts VisualState 기록 (설계 §6)
hangul.ts 한글 find 타겟 매칭 — 초성 검색 (설계 §5)

adapters — core 의 intent 를 PM 위에서 실행

파일 무엇
execute-command.ts CoreCommand 실행 진입점 (설계 §2)
motions.ts 모션 해석 — EditorState + 위치 + motion → 목표 위치 (dispatch 는 plugin, 설계 §2)
line-sequence.ts 커서 줄 목록 — j/k · w/b · gg/G · :N 이 걷는 줄 모델 (문서별 캐시)
vertical-walk.ts 세로 모션 j/k — goal 칼럼 줄 이동과 표 행 이동
word-motions.ts 단어 모션 w/b 와 cw 의 단어 끝
find-char.ts f/F/t/T 문자 찾기 해석
operations.ts 줄·문자 오퍼레이션 d/c/y (설계 §9)
line-units.ts "줄이란 무엇인가" (설계 §9)
cursor-line-columns.ts 커서 줄의 컬럼 프리미티브
cursor-selection.ts normal 모드 커서 위치를 PM selection 으로 바꾸는 유일한 곳 (visual·편집 후 착지는 따로) · 그 역 vimCursor
normal-cursor.ts normal 모드 커서를 글자 위에 둔다 — insert Esc 의 한 칸 뒤로, 줄 끝 caret 의 clamp
graphemes.ts 커서 단위 — grapheme 경계 (설계 §6)
search.ts / 검색 어댑터 (#372)
register.ts vim register (설계 §6)
paste.ts paste — register · 예산 (설계 §6/§9)
atom-insert.ts atom 위 insert 진입 프리플라이트
insert-entry.ts PM insert 모드 화살표로 코드블록 island 진입 (#477)
code-block-landing.ts 코드블록 진입 착지 정책
esc-arbitration.ts insert-Esc 중재 (설계 §4/§5c)
scroll.ts z 계열 스크롤 + 커서 팔로우
suspension.ts 입력 섬 판정 + island 라벨 (설계 §4)

루트와 렌더 — 플러그인 본체 · 배선 · 커서 CSS

파일 무엇
index.ts 항상 설치되는 Extension — priority 10000 (설계 §2/§7)
vim-plugin.ts PM Plugin 본체 (설계 §2/§3/§4/§5)
vim-plugin-state.ts 플러그인 상태 — 무의존 leaf (PR #491 분리)
vim-plugin-reducer.ts plugin StateField 의 apply/init — §5b 우선순위 사다리(vim meta → 외부 명령 → untagged 편집 → 외부 선택)
vim-pointer-goal.ts 포인터 누름이 커서를 실제로 옮겼을 때만 goal 칼럼을 잊게 하는 감시
vim-island-sync.ts PluginView 생애주기 (PR #491 분리)
vim-selection-commands.ts selection 커맨드 — dispatchCursor 의 집 (PR #491 분리)
vim-keys.ts PluginKey · 모달 상태 질의 · 외부편집 태깅 chainWithVimExternalEdit
vim-status.ts 상태 피드 arbitration (설계 §8)
vim-lifecycle.ts 설정 토글 배선 (설계 §7)
vim-activation.ts 문서 활성화 경계 — 탭 전환 리셋
vim-search-line.ts StatusBar input ↔ core 배선 (IME 정공법)
replace-editor-state.ts EditorState 전체 교체의 관문 — 전 호출부가 여기를 지난다(관례이고 게이트는 없다)
vim.css WYSIWYG 블록 커서 렌더 (설계 §10) — normal 모드 데코레이션 · 비활성 창 hollow

CM 표면 — source mode · 코드블록 island

WYSIWYG 이 자체 엔진인 반면 이쪽은 @replit/codemirror-vim 어댑터다 (Overview 참조). 위의 세 절과 같이 게이트가 전수로 지킨다 — 이름이 vim 인 파일이 src/ 어디에 생겨도 잡힌다(src/spike/ 프로브는 제외).

파일 무엇
vim-mode.ts 어댑터 설치 — 동적 import · 모듈 캐시
vim-controller.ts CM 쪽 모드 배선과 상태 보고
vim-ime-guard.ts CM 표면의 IME 가드 (beforeinput 취소)
vim-code-block-boundary.ts 코드블록 경계 — Esc 계단 · 경계 j/k
code-block-vim-island.ts 섬 배선 — 동기 editing-host 장벽 · PM↔CM 핸드오프 · 상태 피드
vim-island-markers.ts 마커 상수 leaf — sanitizer 와 공용 (설계 §4)
VimSearchInput.tsx 검색 input — IME 목적지

vim 디렉터리 밖 — vim 이 의존하는 공용 파일

위의 네 절과 성격이 다르다. 위는 게이트가 전수로 지켜서 파일이 늘면 지도가 빨간불을 내지만, 이 절은 사람이 고른 목록이고 게이트는 링크가 살아 있는지만 본다. 전수를 걸 수 없는 이유는 이 파일들이 사는 디렉터리가 vim 소유가 아니기 때문이다.

즉 여기 없다고 해서 vim 과 무관하다는 뜻이 아니다. 어떤 페이지가 이름 붙여 설명하는 동작의 집이 여기 없으면, 그건 빠진 것이다 — 행을 더할 것.

파일 무엇
syntax-reveal-state.ts vim reducer 가 읽는 syntax reveal 태그의 계약 · expand/collapse 의 goal 보존
use-source-mode.ts source mode 복귀 — churn 방어 4번이 사는 곳 (양 브랜치)
focus-editor-view.ts editable 게이트 폴백 — non-editable 뷰에서 focus() 가 no-op
code-block-cm-registry.ts leaf 채널 — editable 브로드캐스트 · vim on/off · entry 핸드오프
use-atom-block-behavior.ts 모든 atom 블록 뷰의 공유 경계 동작
StatusBar.tsx 모드 · 명령 · island 라벨 렌더

테스트는 각 모듈 옆 __tests__/ 에 있다 — vim 테스트는 위 디렉터리들 각각의 __tests__/ 에 흩어져 있다(extensions/plugins/vim/ · components/editor/ · extensions/ · nodes/views/ · hooks/ · stores/). 이 지도는 프로덕션 파일만 다룬다.

baram

Vim

링크 없는 항목은 아직 쓰지 않았다. 그 주제의 현재 출처는 해당 모듈의 헤더 주석이고, 어느 파일인지는 Code map 이, 구현 현황은 #298 · #372 가 답한다.

CLI

링크 없는 항목은 아직 쓰지 않았다. 쓰는 법은 사용자 문서 가, 구현 현황과 다음 단계는 추적 이슈 가, 계약은 src-tauri/src/cli/ 의 모듈 헤더와 함수 · 타입의 문서 주석이 답한다.

Clone this wiki locally