ruvim 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f942ba8fad5d2732b0369e0f79f0760c326f602bed0d754a578f4ddb28794ba
-  data.tar.gz: 2c82a6317f9e5e34b7319db75ea7bd12b333f6841ce77cd52b5e50edfcbdec22
+  metadata.gz: c463658b0badbad140842446b82818bb797930372d4ccb8ff5e4275fbe627904
+  data.tar.gz: 92b3c9f004f8b075f603d4b8f2e4c48255ac0ef3eea768dd3e290495ab661033
 SHA512:
-  metadata.gz: 97b81ea7eff50fc175d862265224996b358e61b6d3bd4d5710446bdaa7cae4048352fcf8d41b9c81a31f9d1a2bc7c3602490d9e488f75a536aab29b46571db62
-  data.tar.gz: 38e25791b5f3ff239e9b175b02007e0964b3e3ca423abe3e2665eeec615b0b6aefa5458323c2a7ab79bf55f94220985fc3cf4ffa49c93cdd4f1912ac57d585c6
+  metadata.gz: 46ec215ad18a1e72a62d54e0a95b24d87b7ee5b9093300a4597c8d96754ef4a1ce30f964101e1f2cd3dda8ecefcc74d7565602bb80f0eba6ce28cd2fb835a9ad
+  data.tar.gz: 49827d053ac4b9c827b0cbe86ebb00ff8a6609af4998ef5060a2407d0022f33b47327c11eaef4efc75aca03e0ddc07660a8bf12214db28e8c98f58c83c705b60

data/.github/workflows/test.yml

@@ -7,9 +7,13 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ["3.2", "3.3", "3.4", "4.0"]
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
       - run: bundle exec rake ci

data/AGENTS.md

@@ -0,0 +1,84 @@
+This project is RuVim, a Vim-like editor written in Ruby. Always run the full test suite (`rake test` or equivalent) after making code changes and confirm all tests pass before committing.
+
+* check docs/ to understand the specification
+  * docs/spec.md
+  * docs/todo.md
+* When modifying the source code
+  * write tests first, then implement (test-first)
+  * update docs/
+    * catch up changes
+    * move completed tasks to done.md
+  * update CLAUDE.md Source Tree section if files were added, removed, or renamed
+  * commit it
+* After committing, show the commit message
+
+## Source Tree
+
+### Architecture
+
+```
+CLI (exe/ruvim) → CLI.parse() → App.new() → App.run_ui_loop()
+  Input.read_key() → KeymapManager.resolve() → Dispatcher.dispatch()
+  → GlobalCommands.<method>() → Editor state update → Screen.render() → Terminal.write()
+```
+
+### Core (lib/ruvim/)
+
+| File | Description |
+|------|-------------|
+| `app.rb` | Main application loop, input handling, startup |
+| `editor.rb` | Editor state: buffers, windows, options, registers, marks, modes |
+| `buffer.rb` | Text buffer (lines, file I/O, encoding) |
+| `window.rb` | View of a buffer (cursor, scroll, grapheme-aware movement) |
+| `global_commands.rb` | All built-in command implementations (cursor, edit, search, visual, etc.) |
+| `screen.rb` | Rendering: window layout, syntax highlight, line numbers, status line, wrap |
+| `dispatcher.rb` | Routes commands; parses Ex ranges/substitute; shell execution |
+| `keymap_manager.rb` | Key-to-command mapping with layers (filetype > buffer > mode > global) |
+| `input.rb` | Raw keyboard input, ANSI escape sequence parsing |
+| `terminal.rb` | Terminal I/O: raw mode, alternate screen, winsize |
+| `command_line.rb` | Command-line text/cursor state |
+| `command_registry.rb` | Normal/insert mode command registry (singleton) |
+| `ex_command_registry.rb` | Ex command registry (singleton) |
+| `cli.rb` | CLI argument parsing, `--help`, `--version` |
+| `config_loader.rb` | Load `~/.config/ruvim/init.rb` and ftplugin |
+| `config_dsl.rb` | User config DSL: `nmap`, `imap`, `set`, `command`, `colorscheme` |
+| `display_width.rb` | Character display width (CJK, emoji, combining marks) |
+| `text_metrics.rb` | Grapheme-aware text measurement and navigation |
+| `keyword_chars.rb` | Word character definition (iskeyword) |
+| `highlighter.rb` | Syntax highlighting dispatcher (delegates to lang modules) |
+| `lang/base.rb` | Default lang module (no-op fallback for indent/dedent) |
+| `lang/markdown.rb` | Markdown parsing, detection helpers, and syntax highlight colors |
+| `lang/ruby.rb` | Ruby syntax highlighting via Prism lexer; auto-indent calculation |
+| `lang/json.rb` | JSON syntax highlighting via regex |
+| `lang/scheme.rb` | Scheme syntax highlighting via regex |
+| `lang/tsv.rb` | TSV detection and RichView renderer registration |
+| `lang/csv.rb` | CSV detection and RichView renderer registration |
+| `clipboard.rb` | System clipboard access (xclip, pbpaste, etc.) |
+| `context.rb` | Command handler context (editor, window, buffer, invocation) |
+| `command_invocation.rb` | Single command invocation (id, argv, count, bang) |
+| `rich_view.rb` | Rich view mode (TSV/CSV/Markdown rendering) |
+| `rich_view/table_renderer.rb` | Table formatting with display-width-aware column alignment |
+| `rich_view/markdown_renderer.rb` | Markdown rendering (headings, inline, tables, code blocks, HR) |
+
+### Tests (test/)
+
+- Unit: `buffer_test`, `window_test`, `editor_test`, `screen_test`, `display_width_test`, `text_metrics_test`, `keymap_manager_test`, `highlighter_test`, `dispatcher_test`, `config_*_test`, `indent_test`
+- Integration: `app_scenario_test`, `app_motion_test`, `app_text_object_test`, `app_register_test`, `app_dot_repeat_test`, `app_completion_test`, `app_unicode_behavior_test`, `render_snapshot_test`, `on_save_hook_test`
+- Helper: `test_helper.rb` (fresh_editor, Minitest)
+
+### Docs (docs/)
+
+`spec.md` (feature spec), `command.md`, `binding.md`, `config.md`, `tutorial.md`, `vim_diff.md`, `plugin.md`, `todo.md`, `done.md`
+
+## Debugging (Lumitrace)
+
+lumitrace is a tool that records runtime values of each Ruby expression.
+When a test fails, read `lumitrace help` first, then use it.
+Basic: `lumitrace -t exec rake test`
+
+When fixing bugs, do NOT assume the first fix attempt is correct. After applying a fix, re-read the relevant code paths to verify the fix addresses the actual root cause, not a symptom. If the user says 'it hasn't changed' or equivalent, start fresh analysis from the failing behavior.
+
+## misc
+
+The user communicates in both English and Japanese. Respond in the same language the user uses. When the user gives feedback like 変わってないですよ ('it hasn't changed'), treat it as a bug report requiring re-analysis.
+

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/docs/binding.md

@@ -1,5 +1,7 @@
 # RuVim キーバインディング一覧
 
+実行時の現在有効な binding 一覧は `:bindings` で表示できます（layer: `buffer` / `filetype` / `app`）。
+
 ## Normal mode
 
 - `h` : 左へ移動
@@ -47,6 +49,7 @@
 - `'{mark}` / `` `{mark} `` : mark へ jump（行頭寄せ / 正確位置）
 - `''` / `` `` `` : jumplist で前の位置へ jump（行頭寄せ / 正確位置）
 - `r<char>` : 1文字置換
+- `=` + motion / `==` : auto-indent（Ruby filetype 対応）
 - `c` + motion / `cc` : change（削除して Insert mode）
 - `ciw` / `caw` : 単語 text object change（簡易）
 - `ci"` / `ca"` : quote text object change（簡易）
@@ -56,6 +59,7 @@
 - `V` : Visual (linewise)
 - `Ctrl-w w` : 次の window へ移動
 - `Ctrl-w h/j/k/l` : window 間移動（split UI）
+- `Shift+矢印キー` : window 間移動 or 分割（1ウィンドウ時は分割、2個以上なら移動）
 - `u` : Undo
 - `Ctrl-r` : Redo
 - `.` : 直前変更の repeat（現状: `x`, `dd`, `d{motion}`, `p/P`, `r<char>`）
@@ -71,9 +75,15 @@
 - `*` / `#` : カーソル下の単語検索（前/後）
 - `g*` / `g#` : カーソル下の単語を部分一致検索（前/後）
 - `gf` : カーソル下のファイル名を開く（最小。`path` / `suffixesadd` を参照）
+  - `file:line` 形式なら開いた後に `line` 行目へ移動
+- `gr` : Rich mode をトグル（TSV/CSV をテーブル整形表示、同一バッファ上で動作）
 - `Esc` : メッセージ/保留入力のクリア
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 - `矢印キー` : 移動
 - `PageUp` / `PageDown` : 画面単位で移動（概ね表示高さ - 1 行）
+- `Q` : quickfix list を開く（`:copen` 相当）
+- `]q` : 次の quickfix item へジャンプ（`:cnext` 相当）
+- `[q` : 前の quickfix item へジャンプ（`:cprev` 相当）
 - `Enter` : quickfix / location list バッファ上では選択項目へジャンプ（一覧ウィンドウから元の編集ウィンドウへ戻る）
 
 ### count 対応（現状）
@@ -90,6 +100,7 @@
 - `Ctrl-p` : buffer words 補完（前候補）
 - `Esc` : Normal mode に戻る
 - `Ctrl-c` : Normal mode に戻る
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 - `矢印キー` : 移動
 - `PageUp` / `PageDown` : 画面単位で移動
 
@@ -101,8 +112,18 @@
 - `V` : linewise Visual の開始/切替
 - `y` : 選択範囲を yank
 - `d` : 選択範囲を delete
+- `=` : 選択範囲を auto-indent
 - `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` で復帰）
+
+## Rich mode
+
+- Normal mode のキーバインドをほぼそのまま使える（移動・検索・yank 等）
+- バッファを変更する操作（insert/delete/change/paste/replace）はブロック
+- `Esc` : Normal mode に戻る
+- `Ctrl-c` : Normal mode に戻る
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 
 ## Command-line mode
 
@@ -114,6 +135,7 @@
 - `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応）
 - `Esc` : キャンセル
 - `Ctrl-c` : キャンセル
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 
 ### prefix 別の Enter 動作
 
@@ -128,4 +150,5 @@
 - keymap 解決順（現状実装）: `filetype-local -> buffer-local -> mode-local -> global`
 - `~/.config/ruvim/init.rb`（または `$XDG_CONFIG_HOME/ruvim/init.rb`）の `nmap` / `imap` / `map_global` で上書き・追加可能
 - `Ctrl-d/u/f/b/e/y` に加えて、`矢印キー` / `PageUp` / `PageDown` も「既定挙動の前に keymap override を試す」ため `nmap "<PageDown>", ...` のように上書き可能
+- `Ctrl-z` は keymap ではなく app レベルの suspend 処理として扱う（全モード共通）
 - `~/.config/ruvim/ftplugin/<filetype>.rb`（または `$XDG_CONFIG_HOME/ruvim/ftplugin/<filetype>.rb`）では `nmap` / `imap` が filetype-local として登録される

data/docs/command.md

@@ -19,6 +19,16 @@
 - `-c {cmd}`
 - `+{cmd}`, `+{line}`, `+`
 
+補足（現状挙動）:
+
+- `cmd | ruvim`
+  - `stdin` を follow stream として開く（`[stdin]` バッファ）
+  - Normal mode の `Ctrl-c` で stream 停止（上流プロセスには直接 `SIGINT` は送らない）
+- `Ctrl-z`
+  - 全モード共通で shell へ suspend（`SIGTSTP`）
+  - suspend 前に terminal を cooked + main screen へ戻す
+  - `fg` 復帰後は alt screen を再有効化し、画面を全面再描画する
+
 ## Ex コマンド（builtin）
 
 ### `:w` / `:write`
@@ -36,11 +46,22 @@
 - 最後の window / tab のとき: エディタ終了
 - 最後の window / tab で未保存変更がある場合、`!` なしでは拒否
 
+### `:qa` / `:qall`
+
+- 形式: `:qa`, `:qa!`
+- 全ウィンドウ/タブを無視して一括終了
+- 未保存変更があるファイルバッファが存在する場合、`!` なしでは拒否
+
 ### `:wq`
 
 - 形式: `:wq`, `:wq!`, `:wq [path]`
 - 保存して `:q` 相当（window / tab / app を閉じる）
 
+### `:wqa` / `:wqall` / `:xa` / `:xall`
+
+- 形式: `:wqa`, `:wqa!`
+- 変更のある全ファイルバッファを保存して一括終了
+
 ### `:e` / `:edit`
 
 - 形式: `:e[!] [path]`
@@ -48,6 +69,11 @@
 - 引数なし: 現在ファイルを再読込
 - 未保存変更がある場合は `!` なしで拒否
 - `:e!` は未保存変更を破棄して開き直す（undo/redo もクリア）
+- 大きいファイル（閾値以上）は段階読み込みになる場合がある
+  - 読み込み中は status line に `[load/live]`
+  - デフォルトでは先頭 `8MB` を先に表示して、残りを後から追加
+  - 閾値: `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
+  - 先読みサイズ: `RUVIM_ASYNC_FILE_PREFIX_BYTES`
 
 ### `:help`
 
@@ -64,6 +90,16 @@
 - 形式: `:commands`
 - Ex コマンド一覧（alias 含む）を read-only バッファに表示
 
+### `:bindings`
+
+- 形式: `:bindings [mode]`
+- 現在バッファに対して有効な key binding 一覧を read-only バッファに表示
+- layer ごとに表示:
+  - `buffer`
+  - `filetype`
+  - `app`
+- `mode` は任意（例: `normal`, `insert`, `visual_line`, `command_line`。短縮形 `n`, `i`, `v`, `c` なども可）
+
 ### quickfix / location list（最小）
 
 - `:vimgrep /pattern/`
@@ -82,6 +118,17 @@
   - `:grep`, `:make`, `:cfile`, `:lgrep` は未実装
   - 一覧バッファ上で `Enter` からのジャンプは未実装
 
+### `:rich`
+
+- 形式: `:rich [format]`
+- Rich mode を開始 / 終了する（トグル）
+- `format` に `tsv` または `csv` を指定可能（省略時は filetype / 内容から自動判定）
+- 同一バッファ上で動作し、描画時にテーブル整形を適用する
+- Rich mode では移動・検索・yank 等は使えるが、バッファ変更操作はブロックされる
+- 区切り文字は ` | `（スペース+パイプ+スペース）
+- 列幅は画面に見えている行だけから計算（大規模ファイルでも高速）
+- `Esc` / `Ctrl-C` で Normal mode に戻る
+
 ### `:command`
 
 - 形式: `:command Name ex_body`
@@ -137,6 +184,34 @@
 - 表示中 window は別バッファへ切り替えられる
 - `!` 対応（未保存変更バッファを破棄）
 
+### `:args`
+
+- 形式: `:args`
+- 引数リスト（arglist）を表示
+- 現在の引数は `[filename]` 形式で表示される
+
+### `:next`
+
+- 形式: `:next`
+- arglist の次の引数ファイルを開く
+- エラー: 最後の引数で実行時
+
+### `:prev`
+
+- 形式: `:prev`
+- arglist の前の引数ファイルを開く
+- エラー: 最初の引数で実行時
+
+### `:first`
+
+- 形式: `:first`
+- arglist の最初の引数ファイルを開く
+
+### `:last`
+
+- 形式: `:last`
+- arglist の最後の引数ファイルを開く
+
 ### `:split`
 
 - 形式: `:split`
@@ -165,6 +240,13 @@
 - 形式: `:tabprev`
 - 前のタブへ移動
 
+### `:tabs`
+
+- 形式: `:tabs`
+- 全タブページの一覧を表示
+- 各タブに含まれるウィンドウとバッファ名を表示
+- 現在のタブ / ウィンドウは `>` マーカーで示す
+
 ## 内部コマンド（主なもの）
 
 内部コマンドは主に key binding から使われ、`RuVim::CommandRegistry` に登録されます。
@@ -221,6 +303,7 @@
 - `editor.buffer_prev`
 - `buffer.replace_char`
 - `ui.clear_message`
+- `rich.toggle`
 
 ## 検索コマンド（Normal mode）
 
@@ -265,6 +348,7 @@
 - `buffer.visual_delete`
 - blockwise は最小実装（矩形選択 + `y/d`）
 - blockwise の text object 選択 / paste の Vim 互換挙動は未対応
+- `Ctrl-z` で shell へ suspend（`fg` で復帰）
 
 ## repeat（Normal mode）
 
@@ -310,6 +394,7 @@
 
 - `Screen` は行キャッシュを使った簡易差分描画を行う
 - `SIGWINCH` + self-pipe + `IO.select` で入力待機中でもリサイズに即追従
+- `Ctrl-z` suspend/`fg` 復帰後は `Screen` キャッシュを破棄し、全面再描画する
 - command-line は履歴と Ex 補完（コマンド名 + 一部引数の文脈補完）を持つ
 - Insert mode は `Ctrl-n` / `Ctrl-p` の buffer words 補完を持つ
 - 文字幅は `DisplayWidth` の近似実装（tab 展開 + 一部全角幅2）

data/docs/config.md

@@ -217,12 +217,12 @@ setglobal "tabstop=8"
 
 - `path` (`string`, default `nil`) [`PARTIAL`]
   - `gf` などのファイル探索ディレクトリを指定します（`,` 区切り）。
-  - 現状は `gf` の最小探索に利用します。
+  - 現状は `gf` の最小探索に利用します（`file:line` の `line` ジャンプにも対応）。
   - `lib/**` のような再帰探索（簡易）に対応します。
 
 - `suffixesadd` (`string`, default `nil`) [`PARTIAL`]
   - `gf` などで補完する拡張子候補を指定します（`,` 区切り）。
-  - 現状は `gf` の最小探索に利用します。
+  - 現状は `gf` の最小探索に利用します（`file:line` の `path` 部分に適用）。
 
 - `textwidth` (`int`, default `0`) [`定義のみ`]
   - 自動改行幅の指定です。

data/docs/done.md

@@ -30,12 +30,15 @@
 - quickfix / location list（最小）
 - Visual block（`Ctrl-v`、最小）
 - `.` repeat の精度向上（operator + text object + macro 連携）
+- `=` operator（自動インデント: `==`, `=j`, `=k`, `=G`, `=gg`, Visual `=`。Ruby filetype 対応）
 
 ## コマンド / 設計 / 拡張基盤
 
 - `:command`（ユーザー定義 Ex コマンド）
 - `:ruby` / `:rb`
 - バッファ管理コマンド（`:ls`, `:buffers`, `:bnext`, `:bprev`, `:buffer`, `#`）
+- arglist（引数リスト）管理コマンド（`:args`, `:next`, `:prev`, `:first`, `:last`）
+- 複数ファイル起動時に全ファイルをバッファとして読み込む（`:ls` に表示）
 - キーマップのレイヤー化（mode/global/buffer/filetype）
 - option system（global / buffer-local / window-local, `:set` 系）
 - ファイルタイプ検出と ftplugin
@@ -45,6 +48,19 @@
 - block-based keymap DSL（`nmap/imap/map_global ... do |ctx, ...| end`）
 - plugin 向け `ctx.editor / ctx.buffer / ctx.window` API リファレンス（未確定 API 注記つき）
 
+## Rich mode / 構造化データ表示
+
+- Rich View フレームワーク（filetype ごとのレンダラー登録）
+- TSV/CSV テーブルレンダラー（列幅自動計算、CJK 対応、CSV quoted field パース）
+- `:rich [format]` Ex コマンド（トグル）
+- `gr` Normal mode キーバインド（トグル）
+- filetype 検出に `.tsv` / `.csv` 追加
+- Rich View → Rich mode へ変換（仮想バッファ方式から同一バッファ上のモード方式へ）
+- Rich mode の横スクロール修正（`$` で行末に移動した際の縦揃えズレを解消）
+- Markdown Rich mode（見出し・インライン装飾・テーブル罫線・コードブロック・HR・ブロック引用の ANSI レンダリング）
+- `render_rich_view_line_sc` の ANSI エスケープシーケンス対応
+- `ensure_visible_rich` の汎用化（`renderer.cursor_display_col` インターフェース）
+
 ## UI / 画面描画 / 端末挙動
 
 - リサイズ対応（`SIGWINCH` + 即時再描画）
@@ -53,12 +69,14 @@
 - コマンドライン改善（履歴 / 補完 / エラー表示）
 - カーソル位置の強調表示
 - 複数 window / split UI（`:split`, `:vsplit`, window 間移動）
+- ネストしたウィンドウ分割（layout tree: vsplit→split でカラム内だけ上下分割）
 - Tabpage（`:tabnew`, `:tabnext`, `:tabprev`）
 - ヘルプ / コマンド一覧の read-only 仮想バッファ表示
 - intro screen（Vim 風 welcome buffer）
 - エラー表示の改善（最下段・強調表示）
 - PageUp / PageDown 対応
 - `:q` の window/tab/app クローズ挙動を Vim 寄りに調整
+- hit-enter prompt（複数行メッセージ表示: `:ls`, `:args`, `:set`, `:command`）
 
 ## Unicode / 日本語 / 表示幅 / 座標系
 
@@ -69,15 +87,18 @@
 - 表示幅ベース描画の共通化（`TextMetrics` 中心）
 - 日本語/全角を含む操作の整合性確認（`w/b/e`, Visual yank, `p/P`）
 - 描画回帰テストの追加（Unicode / wide char）
+- `truncate` の表示幅計算を文字数ベースから `DisplayWidth` ベースに修正（全角文字を含むエラーメッセージでターミナルがスクロールするバグを修正）
 
 ## 品質 / テスト / CI / パフォーマンス
 
 - テスト追加（Buffer / Dispatcher / Ex parser / KeymapManager）
 - パフォーマンス改善（表示幅ベース水平スクロール / syntax cache）
+- Insert mode ペースト高速化（stdin に pending input がある間はレンダリングをスキップしバッチ処理）
 - rope/piece-table などのバッファ構造検討メモ（`docs/spec.md`）
 - テスト基盤の拡張（結合テスト / snapshot / シナリオ）
 - CI / 開発体験（GitHub Actions, `rake docs:check`, `rake ci`）
 - シンタックスハイライト（最小）
+- Markdown シンタックスハイライト（`Lang::Markdown` に抽出、通常モード + Rich mode で共有）
 - 補完基盤（Ex 補完 / Insert mode 補完）
 
 ## CLI オプション（Vim 風・実装済み / placeholder 含む）