ruvim 0.2.0 → 0.3.0

data/docs/spec.md

@@ -89,10 +89,10 @@ RuVim は Vim と同様に、用途ごとに座標系を分けています。
 エディタ全体の実行状態です。
 
 - buffers / windows 管理
-- window order / split layout（`single` / `horizontal` / `vertical`）
-- tabpages 管理（タブごとに window set / current window / layout を保持）
+- layout tree（ネストしたウィンドウ分割をツリーで管理）
+- tabpages 管理（タブごとに layout tree / current window を保持）
 - current window の管理
-- mode 管理（`:normal`, `:insert`, `:command_line`）
+- mode 管理（`:normal`, `:insert`, `:command_line`, `:rich`）
 - ステータスメッセージ
 - コマンドライン状態
 
@@ -166,7 +166,8 @@ RuVim::ExCommandRegistry.instance.register(
 2. `RuVim::App` が mode ごとに処理を分岐
 3. Normal mode のキーは `RuVim::KeymapManager` で解決
 4. `RuVim::Dispatcher` が内部コマンド or Ex コマンドを実行
-5. `RuVim::Screen` が再描画
+5. Insert mode でキー処理後、stdin に未読データが残っていればレンダリングをスキップして追加のキーを読み取り・処理する（ペースト高速化）
+6. `RuVim::Screen` が再描画
 
 ## 起動オプション（CLI, 現状）
 
@@ -211,6 +212,17 @@ RuVim::ExCommandRegistry.instance.register(
 - `+{cmd}`, `+{line}`, `+`
   - 起動後の Ex 実行 / 行ジャンプ / 最終行ジャンプ
 
+補足（現状実装）:
+
+- `stdin` が non-TTY で、起動引数ファイルがない場合は `stdin` を follow stream として開く
+  - バッファ名は `[stdin]`
+  - status line に `[stdin/live]`, `[stdin/closed]`, `[stdin/error]` を表示
+  - Normal mode の `Ctrl-c` はデフォルトバインドで `stdin` stream stop（上流 PID へ直接 signal は送らない）
+- `Ctrl-z` は全モード共通で suspend
+  - suspend 前に terminal を cooked + main screen に戻す
+  - `SIGTSTP` を自身に送って停止
+  - `fg` 復帰後に raw + alt screen を再有効化して再描画
+
 起動時コマンド（`-c`, `+...`）は、初期 buffer / file open / intro screen 構築の後に実行します。
 `--cmd` はそれより前で、user config 読み込み前に実行します。
 
@@ -253,6 +265,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `p`, `P`: paste
 - `r<char>`: 1文字置換
 - `c` + motion / `cc`: change（削除して Insert mode）
+- `=` + motion / `==`: auto-indent（Ruby filetype でインデント自動調整。`=j`, `=G` 等）
 - `v`: Visual (characterwise)
 - `V`: Visual (linewise)
 - `Ctrl-v`: Visual (blockwise, 最小)
@@ -263,6 +276,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `N`: 直前検索を逆方向に繰り返し
 - `1..9` + 動作: count（例: `3j`, `2x`）
 - 矢印キー: 移動
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 
 ### Insert mode
 
@@ -273,6 +287,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `Esc`: Normal mode に戻る
 - `Ctrl-c`: Normal mode に戻る（終了しない）
 - 矢印キー: 移動
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 
 ### Visual mode（現状）
 
@@ -284,8 +299,20 @@ RuVim::ExCommandRegistry.instance.register(
 - `d`: 選択範囲を delete
 - `i`/`a` + object: text object を選択（`iw`, `aw`, `ip`, `ap`, `i"`, `a"`, ``i` ``, ``a` ``, `i)`, `a)`, `i]`, `a]`, `i}`, `a}`）
 - `Esc` / `Ctrl-c`: Normal mode に戻る
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 - blockwise の text object 選択 / paste の Vim 互換挙動は未対応
 
+### Rich mode
+
+- `:rich [format]` / `gr` で入る（トグル）
+- 同一バッファ上で動作（仮想バッファを作らない）
+- Normal mode とほぼ同じキーバインドが使える（移動・検索・yank 等）
+- バッファを変更する操作（insert/delete/change/paste/replace）はブロック
+- `Esc` / `Ctrl-C` で Normal mode に戻る
+- ステータスラインに `-- RICH --` を表示
+- 描画時に表示行をテーブル整形（`TableRenderer` を利用）
+- wrap は強制 OFF
+
 ### Command-line mode
 
 - `:` で入る
@@ -297,16 +324,36 @@ RuVim::ExCommandRegistry.instance.register(
 - `Tab` (`Ctrl-i`) で Ex 補完
   - コマンド名
   - 一部引数（path / buffer / option）
+- `Ctrl-z` で shell へ suspend（`fg` で復帰）
+
+### Hit-enter prompt（複数行メッセージ表示）
+
+`:ls` や `:set`（引数なし）など、複数行にわたる出力を行うコマンドの結果を表示するモード。
+
+- 画面下部にメッセージ行をオーバーレイ描画
+- 最下行に「Press ENTER or type command to continue」を反転表示
+- ステータスラインは非表示（Vim と同様）
+- 対象コマンド: `:ls` / `:buffers`, `:args`, `:set`（引数なし）, `:command`（引数なし）
+- 1行以下の出力時は通常の `echo` を使用
+
+#### キー操作
+
+- `Enter` / `Space` / `Escape` / `Ctrl-C` / その他のキー → dismiss（通常モードに戻る）
+- `:` → dismiss して Command-line mode に入る
+- `/` / `?` → dismiss して検索 Command-line mode に入る
 
 ## Ex コマンド仕様（現状 builtin）
 
 - `:w [path]` / `:write [path]`
 - `:q[!]` / `:quit[!]`
+- `:qa[!]` / `:qall[!]`
 - `:wq[!] [path]`
+- `:wqa[!]` / `:wqall[!]` / `:xa[!]` / `:xall[!]`
 - `:e <path>` / `:edit <path>`
 - `:e[!] [path]` / `:edit[!] [path]`
 - `:help [topic]`
 - `:commands`
+- `:bindings [mode]`
 - `:command[!] <Name> <ex-body>`
 - `:ruby <code>` / `:rb <code>`
 - `:!<command>`
@@ -323,6 +370,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `:vimgrep`, `:lvimgrep`
 - `:copen`, `:cclose`, `:cnext` / `:cn`, `:cprev` / `:cp`
 - `:lopen`, `:lclose`, `:lnext` / `:ln`, `:lprev` / `:lp`
+- `:rich [format]`
 
 ## 検索仕様（現状）
 
@@ -347,10 +395,20 @@ RuVim::ExCommandRegistry.instance.register(
 - `:q` は未保存変更があると拒否
 - `:q` は Vim 寄りに、複数 window 時は current window を閉じる（window が1つで tab が複数なら current tab を閉じる）
 - `:q!` は強制的に window / tab / app を閉じる
+- `:qa` は全ウィンドウ/タブを無視して一括終了（未保存バッファがあると拒否、`:qa!` で強制）
+- `:wqa` は全バッファを保存して一括終了
 - `:e` は未保存変更があると拒否（`!` で破棄可）
 - `:e!`（引数なし）は現在ファイルの再読込（undo/redo クリア）
 - `:buffer!`, `:bnext!`, `:bprev!` は未保存変更があっても切替
 - `:w!` は現状 `:w` と同等に受理（権限昇格などは未実装）
+- `:bindings` は current buffer 文脈の有効 key binding を layer 別（`buffer`, `filetype`, `app`）に一覧表示
+  - 任意で mode filter を受ける（例 `:bindings normal`）
+- 大きいファイルを開くときは、閾値以上で段階読み込みになる場合がある
+  - status line に `[load/live]`（失敗時 `[load/error]`）
+  - デフォルト実装は先頭 `8MB` を先に表示し、残りをバックグラウンド読み込み後に反映
+  - 環境変数:
+    - `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
+    - `RUVIM_ASYNC_FILE_PREFIX_BYTES`
 
 ### `:command`（現状仕様）
 
@@ -395,6 +453,16 @@ RuVim::ExCommandRegistry.instance.register(
 - バッファ切替時に直前バッファを更新
 - `:buffer #` で切替可能
 
+### arglist（引数リスト）
+
+- `Editor#arglist` と `Editor#arglist_index` を保持
+- 起動時に複数ファイル引数があるとarglistが初期化される
+- 複数ファイル起動時、レイアウトオプション未指定でも全ファイルをバッファとして読み込む（`:ls` に表示される）
+- `:args` : arglistを表示（現在の引数は `[filename]` で表示）
+- `:next` / `:prev` : arglist内を移動
+- `:first` / `:last` : arglistの最初/最後に移動
+- arglist移動時にalternate bufferも更新される
+
 ## 画面描画仕様（現状）
 
 ANSI エスケープシーケンスによる再描画です。
@@ -409,19 +477,24 @@ ANSI エスケープシーケンスによる再描画です。
 - ファイル未指定起動時は Vim 風 intro screen を表示（RuVim では intro 用の read-only 特殊バッファ）
 - カーソル位置の文字を反転表示（見やすさ向上）
 
-### split UI（現状）
+### split UI
 
 - `:split` / `:vsplit` で複数 window を作成
-- レイアウトは簡易タイル（等分割）
-  - `horizontal`: 上下分割
-  - `vertical`: 左右分割
-- nested split / Vim の厳密な window tree は未実装
+- レイアウトはツリー構造（ネストした分割に対応）
+  - `hsplit`: 上下分割
+  - `vsplit`: 左右分割
+  - 例: vsplit 後に右ウィンドウを split すると、右カラムだけが上下分割される
+- 同方向の分割は親ノードにマージ（hsplit の中で hsplit しても 1 レベルに統合）
+- `close_window` でツリーを簡略化（子が 1 個になった分割ノードは子に置き換え）
+- `focus_window_direction` は正規化座標空間で最近接ウィンドウを選択
 - 各 window は cursor / scroll を独立して保持
 
 ### Tabpage（現状）
 
 - `:tabnew [path]` で新しいタブを作成
 - `:tabnext`, `:tabprev` で移動
+- `:tabs` で全タブ一覧を表示（各タブのウィンドウとバッファ名）
+- ステータスラインに `tab:n/m` を表示（タブが2つ以上のとき）
 - 各タブは以下を独立に保持
   - window list（表示中 window 群）
   - current window
@@ -434,6 +507,12 @@ ANSI エスケープシーケンスによる再描画です。
 - 入力待機は `stdin + resize通知` を `IO.select` で待つ
 - 描画ごとに `winsize` を再取得して viewport を再計算
 
+### suspend / resume（現状）
+
+- `Ctrl-z` 入力は app レベルで処理し、モードに関係なく suspend する
+- suspend 時は terminal を cooked + main screen に戻してから `SIGTSTP` を送る
+- `fg` 復帰時は alt screen を再有効化し、`Screen` キャッシュを破棄して全面再描画する
+
 ### Command-line 改善（現状）
 
 - prefix ごとの履歴保持（`:` `/` `?`）
@@ -518,12 +597,15 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 - `diw`, `daw` : text object word（簡易）
 - `di"`, `da"`, `di)`, `da)` : delimiter text object（簡易・同一行中心）
 
-設計上は operator-pending 状態機械を導入しており、`d/y/c` を同じ流れで扱います。
+設計上は operator-pending 状態機械を導入しており、`d/y/c/=` を同じ流れで扱います。
 
 補足:
 
 - 現状 `y` operator も実装済み（`yy`, `yw`）
 - 現状 `c` operator も実装済み（`cw`, `cc`, `c$`, `ciw`, `caw` など）
+- 現状 `=` operator も実装済み（`==`, `=j`, `=k`, `=G`, `=gg`、Visual `=`）
+  - Ruby filetype の場合にネスト構造に基づく自動インデントを適用
+  - 他の filetype はフォールバック（現在のインデント維持）
 
 ### text object（現状）
 
@@ -594,7 +676,7 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 - 代表例:
   - window-local: `number`, `relativenumber`, `wrap`, `linebreak`, `breakindent`, `cursorline`, `scrolloff`, `sidescrolloff`
   - global: `ignorecase`, `smartcase`, `hlsearch`, `incsearch`, `splitbelow`, `splitright`, `hidden`, `clipboard`, `timeoutlen`
-  - buffer-local: `tabstop`, `expandtab`, `shiftwidth`, `softtabstop`, `autoindent`, `smartindent`, `filetype`
+  - buffer-local: `tabstop`, `expandtab`, `shiftwidth`, `softtabstop`, `autoindent`, `smartindent`, `filetype`, `onsavehook`
 - 詳細な一覧・実装状況は `docs/config.md` を参照
 
 ## Filetype / ftplugin（現状の基礎）
@@ -608,19 +690,82 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
   - `setlocal` / `setglobal` / `set`（DSL）で option 変更可
 - 同一 buffer の同一 filetype ftplugin は一度だけ読み込む
 
+## Lang モジュール on_save フック
+
+- Lang モジュールに `on_save(ctx, path)` ライフサイクルフックを定義
+- `:w` でファイル保存後、`onsavehook` オプションが有効（デフォルト `true`）なら `buffer.lang_module.on_save(ctx, target)` を呼び出す
+- `Lang::Base.on_save` はデフォルトで何もしない（no-op）
+- `Lang::Ruby.on_save` は `ruby -wc` で構文チェックを実行し、エラー/警告を quickfix list に展開する
+  - エラー出力を `filename:line:` 形式でパースし quickfix items に変換
+  - 複数エラー時はヒント `(]q to see next, N total)` を表示
+  - 正常時は quickfix list を空にクリアする
+- `:set noonsavehook` で無効化可能
+
 ## シンタックスハイライト（最小）
 
 - 描画時に filetype ごとの regex ベース highlighter を適用
 - 現状の対応 filetype:
   - `ruby`
   - `json`
+  - `markdown`（見出し・フェンス・HR・ブロック引用・インライン装飾）
 - 優先度（高 -> 低）:
   - cursor / visual
   - search highlight
   - syntax highlight
-- 実装は `lib/ruvim/highlighter.rb`
+- 実装は `lib/ruvim/highlighter.rb`（ディスパッチャ）+ `lib/ruvim/lang/markdown.rb`（言語固有ロジック）
 - Vim の syntax / treesitter 相当の互換性はない（最小実装）
 
+## Rich mode（構造化データ表示）
+
+構造化データ（TSV/CSV）や Markdown を見やすく整形して表示するモードです。
+Visual mode と同様に Normal mode の上に乗るモードとして設計されています。
+
+- **アーキテクチャ**: filetype ごとにレンダラーを登録できる汎用フレームワーク
+  - `RuVim::RichView` モジュール（`lib/ruvim/rich_view.rb`）
+  - レンダラー登録: `RichView.register(filetype, renderer)`
+  - レンダラー: `TableRenderer`（TSV/CSV）、`MarkdownRenderer`（Markdown）
+- **起動方法**:
+  - `:rich [format]` Ex コマンド（トグル）
+  - `gr` Normal mode キーバインド（トグル）
+- **モード仕様**:
+  - 同一バッファ上で動作（仮想バッファを作成しない）
+  - `Editor#rich_state` に format/delimiter を保持
+  - Normal mode とほぼ同じキーバインドが使える（移動・検索・yank 等）
+  - バッファを変更する操作（insert/delete/change/paste/replace）はブロック
+  - `Esc` / `Ctrl-C` で Normal mode に戻る
+  - ステータスラインに `-- RICH --` を表示
+  - wrap は強制 OFF
+- **レンダリング**:
+  - `Screen` の `plain_window_render_rows` で `editor.rich_mode?` を判定
+  - Rich mode の場合、表示行だけを `RichView.render_visible_lines` で整形
+  - バッファ内容は変更せず、描画パイプラインでの変換のみ
+  - `render_rich_view_line_sc` は ANSI エスケープシーケンスを幅ゼロとして扱い、横スクロール時もスタイルを正しく維持
+- **横スクロール**:
+  - 表示カラム（display column）ベースでスクロール量を管理（`@rich_col_offset_sc`）
+  - `renderer.cursor_display_col` で raw バッファの `cursor_x` を整形後の表示カラムに変換し、スクロールオフセットを決定
+  - `render_rich_view_line_sc` で各行を同じ表示カラム数だけスキップして描画（CJK/ASCII 混在でも列揃えが保たれる）
+  - ワイド文字がビューポート左端をまたぐ場合はスペースで置換（部分表示は不可）
+  - カーソルの画面位置も整形後の表示カラム座標で計算
+- **テーブルレンダラー仕様**:
+  - 区切り表示: ` | `（スペース+パイプ+スペース）
+  - 列幅は画面に見えている行だけから計算（大規模ファイルでも高速）
+  - CJK 文字の表示幅を `DisplayWidth.display_width` で正確に計算
+  - CSV は最小限の quoted field パース対応
+  - 列が1つしかない場合は元の行をそのまま返す
+- **Markdown レンダラー仕様**:
+  - インラインマーカー（`#`, `**`, `*`, `` ` `` 等）は残し、ANSI スタイルを重ねる
+  - 見出し H1-H6: レベル別 bold + 色
+  - インライン装飾: `**bold**`, `*italic*`, `` `code` ``, `[text](url)`, チェックボックス
+  - コードブロック: `` ``` ``/`~~~` フェンスで状態追跡、内容を暖色表示
+  - コードフェンス状態は `pre_context_lines` で表示領域前の行から引き継ぎ
+  - テーブル: `|...|` パターンを検出し、列幅揃え + box-drawing 罫線（`│`, `─`, `┼`, `├`, `┤`）
+  - HR: `---`/`***`/`___` を `─` 線に置換
+  - ブロック引用: `>` で始まる行を cyan 表示
+  - テーブル行のカーソルマッピングはパディング後の位置を計算
+- **filetype 検出**:
+  - `.tsv` → `tsv`, `.csv` → `csv`, `.md` → `markdown`
+  - `:rich`（引数なし）は filetype から判定、不明なら内容を見て自動推測
+
 ## シングルトン方針
 
 グローバルに共有して良い「定義系」だけシングルトンにしています。

data/docs/todo.md

@@ -85,7 +85,7 @@
 - session file（`-S [session]` placeholder 実体化）
 - `wrap` / `linebreak` / `breakindent` / `showbreak` の整合性
 - `wildmenu` / `completeopt` / `pumheight` の UI コンポーネント寄せ
-- arglist（複数ファイル通常起動 + `:args/:next/:prev`）
+- arglist 残件（`:args/:next/:prev` の挙動精度向上）
 
 ### この順番の理由（依存）
 
@@ -120,10 +120,6 @@
 
 ### P1: Vim 運用でよく触る基盤（あると詰まりにくい）
 
-- arglist（複数ファイル通常起動 + 操作）
-  - 複数ファイル引数（通常起動）
-  - `:args`, `:next`, `:prev`, `:first`, `:last`
-  - `alternate buffer (#)` との整合
 - `Ctrl-w` window 操作の拡張
   - `Ctrl-w c`（window close）
   - `Ctrl-w o`（only / 他 window を閉じる）

data/docs/vim_diff.md

@@ -1,180 +1,102 @@
-# RuVim と Vim の違い（現状）
-
-この文書は、現時点の RuVim 実装と本家 Vim の違いをまとめたものです。
-
-## 位置づけ
-
-- RuVim は「Vim ライクな Ruby 製ターミナルエディタ」
-- 現状は Vim 完全互換ではない
-- Vim の操作感を優先して、一部を簡略化している
-
-## 大きな違い（全体）
-
-- Vim script 互換はない
-  - 代わりに `:ruby` / `:rb`
-- プラグイン互換はない
-- split UI は簡易実装（等分割タイル）
-  - `:split`, `:vsplit` はある
-  - Vim の nested window tree / 高度な window 操作は未実装
-- tabpage は最小実装
-  - `:tabnew`, `:tabnext`, `:tabprev` はある
-  - Vim の高度な tab 操作/コマンド群は未実装
-- register は `unnamed` / `named` / `"_` / `0` / `1-9` / `"+` / `"*` の基礎を実装
-- option system は基礎のみ（`:set`, `:setlocal`, `:setglobal`, `number`, `relativenumber`, `ignorecase`, `smartcase`, `hlsearch`, `tabstop`, `filetype`）
-- filetype 検出 / ftplugin は基礎のみ（拡張子中心の簡易判定）
-- Ex コマンドは一部のみ
-
-## コマンドライン / Ex の違い
-
-- `:w`, `:q`, `:wq`, `:e`, `:buffer`, `:bnext`, `:bprev`, `:ls` などはあるが一部のみ
-- quickfix / location list は最小実装のみ
-  - `:vimgrep`, `:lvimgrep`, `:copen/:cnext`, `:lopen/:lnext` など
-  - `qf/location list` 一覧バッファで `Enter` による選択ジャンプは対応
-  - `:grep`, `:make`, `:cfile`, `:lgrep` は未実装
-- `:command` はあるが、現状は「Ex 文字列エイリアス展開」に近い簡易実装
-- `:ruby` はあるが、Vim の `:ruby` 機能互換ではなく RuVim 独自の Ruby eval 入口
-- `:w!` は現状 `:w` とほぼ同じ（権限昇格や readonly 強制保存の完全な意味は未実装）
-
-## モード / 編集操作の違い
-
-- Normal / Insert / Command-line / Visual（charwise, linewise, blockwise 最小）は実装済み
-- Visual mode は最小実装
-  - `y`, `d` 中心
-  - `Ctrl-v` blockwise は矩形選択 + `y/d` の最小対応
-  - blockwise text object / paste の Vim 互換挙動は未実装
-  - Vim の細かい選択挙動や text object は一部未実装
-- operator-pending は `d`, `y`, `c` の一部を実装
-  - text object は `iw/aw`, `ip/ap`, `i"/a"`, ``i`/a` ``, `i)/a)`, `i]/a]`, `i}/a}` を実装（簡易）
-  - Vim の text object 群全体は未実装
-- word motion（`w`, `b`, `e`）は簡易定義
-  - Vim の厳密な単語境界とは一致しない場合がある
-- undo 粒度は簡略化
-  - Insert mode は「入ってから出るまで」を 1 undo 単位
-- `.` repeat は拡張済みだが完全互換ではない
-  - `x`, `dd`, `d{motion}`, `p/P`, `r<char>`, `i/a/A/I/o/O`, `cc`, `c{motion}` を対象
+# RuVim と Vim の違い
+
+RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim 完全互換ではなく、Vim の操作感を優先しつつ一部を独自拡張・簡略化しています。
+
+## RuVim の独自機能・強み
+
+### Ruby ネイティブな拡張性
+
+- 設定ファイルは Ruby DSL（`~/.config/ruvim/init.rb`）
+  - `nmap`, `imap`, `map_global`, `command`, `ex_command`, `ex_command_call`
+  - Vim script 不要で Ruby の全機能を利用可能
+- `:ruby` / `:rb` で実行中に Ruby eval が可能（Vim の `:ruby` とは別物）
+- plugin 向け `ctx.editor / ctx.buffer / ctx.window` API
+
+### ネストしたウィンドウ分割（Layout Tree）
+
+- `:vsplit` 後に `:split` すると、対象カラムだけが上下分割される（Vim と同様のツリー構造）
+- 同方向の連続分割は自動的にフラット化（例: hsplit の中で hsplit → 1 レベルに統合）
+- `Shift+Arrow` キーによるスマート分割
+  - 同軸方向に既存ウィンドウがあればフォーカス移動
+  - なければ新規分割（cross-direction split にも対応）
+  - ツリーパスベースの判定で、別領域のウィンドウに影響されない
+
+### Rich View モード
+
+- TSV / CSV / Markdown をフォーマットして閲覧できる構造化データ表示モード
+- CJK 文字幅を考慮したカラム整列
+
+### 検索は Ruby 正規表現
+
+- `/`, `?`, `:s` はすべて Ruby の `Regexp` を使用
+- Vim regex と異なる点はあるが、Ruby 利用者には馴染みやすい
+- `:help regex` でヘルプ表示
+
+## Vim と同等に実装済みの機能
+
+### モード・編集操作
+
+- Normal / Insert / Command-line / Visual（charwise, linewise, blockwise）
+- operator-pending: `d`, `y`, `c` + motion / text object
+- text object: `iw/aw`, `ip/ap`, `i"/a"`, `` i`/a` ``, `i)/a)`, `i]/a]`, `i}/a}`
+- `.` repeat: `x`, `dd`, `d{motion}`, `p/P`, `r<char>`, `i/a/A/I/o/O`, `cc`, `c{motion}`
   - macro 記録中の `.` は内部再生キーを macro に混ぜない
-  - Vim の細かい repeat 粒度/カウント互換は未実装
+- word motion: `w`, `b`, `e`（`iskeyword` 対応）
+- macros: `q{reg}`, `@{reg}`, `@@`
+- marks / jumps: `m`, `'`, `` ` ``, `''`, ` `` `, `<C-o>`, `<C-i>`
+
+### レジスタ
+
+- unnamed（`"`）, named（`"a`〜`"z`, `"A` append）, black hole（`"_`）
+- yank `"0`, numbered delete `"1`〜`"9`
+- system clipboard `"+`, `"*`（`pbcopy/pbpaste`, `wl-copy/wl-paste`, `xclip`, `xsel`）
+
+### Ex コマンド
+
+- `:w`, `:q`, `:wq`, `:e`, `:buffer`, `:bnext`, `:bprev`, `:ls`, `:split`, `:vsplit`
+- `:qa`, `:qa!`, `:wqa`
+- quickfix / location list: `:vimgrep`, `:lvimgrep`, `:copen`, `:cnext`, `:lopen`, `:lnext`
+- tabpage: `:tabnew`, `:tabnext`, `:tabprev`
+
+### option system
 
-## レジスタ / yank / paste の違い
+- `:set`, `:setlocal`, `:setglobal`（global / buffer-local / window-local）
+- 表示系: `number`, `relativenumber`, `cursorline`, `wrap`, `linebreak`, `breakindent`, `showbreak`, `list`, `listchars`, `colorcolumn`, `signcolumn`, `numberwidth`, `scrolloff`, `sidescrolloff`, `termguicolors`
+- インデント: `shiftwidth`, `softtabstop`, `expandtab`, `autoindent`, `smartindent`, `tabstop`
+- 検索: `ignorecase`, `smartcase`, `hlsearch`, `incsearch`
+- 分割: `splitbelow`, `splitright`
+- その他: `hidden`, `autowrite`, `clipboard`, `timeoutlen`, `ttimeoutlen`, `backspace`, `whichwrap`, `iskeyword`, `filetype`, `path`, `suffixesadd`, `grepprg`, `grepformat`, 補完系（`completeopt`, `pumheight`, `wildmode`, `wildmenu`, `wildignore`, `wildignorecase`）
 
-- unnamed register（`"`）と named register（`"a`, `"A` append）を実装
-- black hole（`"_`）、yank `0`、numbered delete `1-9`（簡易）を実装
-- `"+`, `"*` は環境依存の system clipboard と連携（`pbcopy/pbpaste`, `wl-copy/wl-paste`, `xclip`, `xsel` のいずれか）
-- small delete register `-` など Vim の全 register 種別は未実装
-- paste の挙動は基本的な `charwise` / `linewise` 対応まで
-- Vim の細かいカーソル位置ルールとは差がある可能性がある
+### その他
 
-## 画面描画 / 端末挙動の違い
+- filetype 検出（拡張子 + shebang）/ ftplugin
+- syntax highlight: Ruby（Prism lexer）, JSON, Markdown, Scheme, TSV/CSV
+- 補完: Ex コマンド名 + 引数補完, Insert mode buffer words（`Ctrl-n` / `Ctrl-p`）
+- CLI: `--help`, `--version`, `--clean`, `-u`, `-R`, `-M`, `-Z`, `-o/-O/-p`, `-c`, `+{cmd}`, `-V`, `--startuptime`, `--cmd`
 
-- ANSI + raw mode の自前描画
-- 行キャッシュによる簡易差分描画（Vim の描画最適化とは別実装）
+## 動作の微細な差分
+
+- undo 粒度は簡略化（Insert mode は「入ってから出るまで」が 1 undo 単位）
+- `.` repeat のカウント互換は完全ではない
+- word motion の単語境界定義が Vim と一致しない場合がある
+- paste のカーソル位置ルールに Vim との差がある可能性がある
+- 文字幅対応は近似（CJK / emoji 幅2 / grapheme cluster は対応するが、East Asian Width 完全互換ではない）
+- ANSI + raw mode の自前描画（行キャッシュによる簡易差分描画で Vim の描画最適化とは別実装）
 - `SIGWINCH + self-pipe + IO.select` でリサイズ追従
-- 文字幅対応は近似実装
-  - タブ展開あり
-  - 一部全角/emoji 幅2対応
-  - 左右移動は grapheme cluster を考慮
-  - East Asian Width / grapheme cluster 完全互換ではない
-
-## スクリプト / 設定の違い
-
-- XDG 設定ファイル（`$XDG_CONFIG_HOME/ruvim/init.rb` または `~/.config/ruvim/init.rb`）を Ruby DSL（`ConfigDSL`）で読む
-- Vim script 互換設定ファイルではない
-- CLI の `-u {path|NONE}` / `--clean` は一部実装済み（Vim 互換の全オプションは未実装）
-- 現状の DSL 例:
-  - `nmap`, `imap`, `map_global`
-  - `command`
-  - `ex_command`
-  - `ex_command_call`
-
-## CLI オプションの違い
-
-- 実装済み（現状）
-  - `--help`, `--version`
-  - `--clean`
-  - `-u {path|NONE}`
-  - `-R`, `-M`, `-Z`, `-n`（`-n` は現状 no-op）
-  - `-d`（placeholder: 未実装メッセージ）
-  - `-q {errorfile}`（placeholder: 未実装メッセージ）
-  - `-S [session]`（placeholder: 未実装メッセージ）
-  - `-o[N]`, `-O[N]`, `-p[N]`（基礎）
-  - `-V[N]`, `--verbose[=N]`（簡易）
-  - `--startuptime FILE`（簡易）
-  - `--cmd {cmd}`（pre-config Ex 実行）
-  - `-c {cmd}`
-  - `+{cmd}`, `+{line}`, `+`
-- 未実装（Vim で定番だが RuVim は未対応）
-  - 実処理としては `-S`, `-q`, `-d` など（現状は placeholder のみ）
-- 複数ファイル引数は `-o/-O/-p` 時のみ対応（通常起動の arglist 相当は未実装）
-
-## option（設定）の違い
-
-- 現状の実装済み option は少数（`number`, `relativenumber`, `ignorecase`, `smartcase`, `hlsearch`, `tabstop`, `filetype`）
-- Vim の option 名短縮（例: `nu`, `ts`）は未対応
-- `:set` の高度な構文（`+=`, `-=`, `^=`, `&`, `<` など）は未対応
-- `:set all` や詳細な一覧表示は未対応（簡易表示のみ）
-
-### Vim にあるが未実装の代表例（RuVim 現状）
-
-- 表示系
-  - `relativenumber`
-  - `cursorline`
-  - `wrap`
-  - `list`, `listchars`
-  - `colorcolumn`
-  - `signcolumn`
-  - `numberwidth`
-  - `scrolloff`, `sidescrolloff`
-- インデント/編集系
-  - `shiftwidth`
-  - `softtabstop`
-  - `expandtab`
-  - `autoindent`
-  - `smartindent`
-- 検索系
-  - `ignorecase`
-  - `smartcase`
-  - `hlsearch`
-  - `incsearch`
-- split / window 系
-  - `splitbelow`
-  - `splitright`
-  - `winfixheight`
-  - `winfixwidth`
-- ファイル / 永続化系
-  - `swapfile`
-  - `backup`
-  - `writebackup`
-  - `undofile`
-  - `undodir`
-- UI / 端末 / パフォーマンス系
-  - `termguicolors`
-  - `timeoutlen`
-  - `ttimeoutlen`
-  - `updatetime`
-
-注記:
-- これは網羅一覧ではなく、よく使われるものの代表例です。
-- 実装済み option の一覧は `docs/config.md` を参照。
-
-## 未実装（Vim との差分として大きいもの）
-
-- text objects は一部のみ（`iw/aw`, `ip/ap`, `i"/a"`, ``i`/a` ``, `i)/a)`, `i]/a]`, `i}/a}`）
-- change operator（`c` 系）は基礎のみ
-- macros / replay は基礎のみ（`q{reg}`, `@{reg}`, `@@`）
-- marks / jumps は基礎のみ（`m`, `'`, `` ` ``, `''`, `````, `<C-o>`, `<C-i>`）
-- search regex 互換（現状は Ruby 正規表現）
-- search は Ruby 正規表現ベース（Vim regex と非互換な点あり）
-- substitute は最小実装（`:%s/.../.../g` のみ、Vim の置換フラグ群は未対応）
-- folds
-- syntax highlight は最小実装（regex ベース / `ruby`, `json` のみ）
-- 補完は基礎のみ
-  - Ex 補完（コマンド名 + 一部引数）
-  - Insert mode buffer words 補完（`Ctrl-n` / `Ctrl-p`）
-- LSP / diagnostics
-- job/channel/terminal 連携
+- `:w!` は現状 `:w` とほぼ同じ（権限昇格や readonly 強制保存は未実装）
+- `:command` は Ex 文字列エイリアス展開の簡易実装
+- Visual blockwise は矩形選択 + `y/d` の最小対応（blockwise text object / paste の Vim 互換挙動は未実装）
+- option 名短縮（`nu`, `ts` 等）は未対応
+- `:set` の高度な構文（`+=`, `-=`, `^=` 等）は未対応
+- small delete register `"-` は未実装
 
-## 互換性の考え方（現状）
+## 未実装の主要機能
 
-- Vim の「概念（buffer / window / mode / operator / Ex）」は寄せる
-- 挙動の細部は MVP 実装として簡略化
-- 後方互換性より、Ruby で拡張しやすい構造を優先
+- Vim script 互換 / プラグイン互換
+- folds
+- LSP / diagnostics
+- job / channel / terminal 連携
+- `:grep`, `:make`, `:cfile`, `:lgrep`
+- substitute の高度なフラグ群（現状は `:%s/.../.../g` のみ）
+- swap / backup / undofile（永続 undo）
+- `-d`（diff mode）, `-q`（quickfix mode）, `-S`（session）は placeholder のみ