Repository navigation
Vim Code map
vim 구현의 파일 경로가 사는 유일한 페이지다. 다른 페이지는 경로를 적지 않고 여기를 가리킨다.
링크는 main 을 가리키므로 파일이 옮겨지면 404 가 된다 — 그리고 리포의 lint:wiki 게이트가
그보다 먼저 빨간불을 낸다. 단 아래 다섯 절의 검사 강도가 서로 다르다 — 마지막 절의 도입부를 볼 것.
§ 는 vim 설계서의 절 번호다. 설계서 자체는 내부 문서(리포 밖)지만, 같은 § 가 각 모듈의 헤더
주석에 붙어 있다 — 공개된 등가물은 그 헤더 주석이고, 어긋나면 헤더가 옳다.
| 파일 | 무엇 |
|---|---|
| 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) |
| 파일 | 무엇 |
|---|---|
| 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) |
| 파일 | 무엇 |
|---|---|
| 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 |
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 과 무관하다는 뜻이 아니다. 어떤 페이지가 이름 붙여 설명하는 동작의 집이 여기 없으면, 그건 빠진 것이다 — 행을 더할 것.
| 파일 | 무엇 |
|---|---|
| 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/). 이 지도는 프로덕션 파일만 다룬다.
이 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