ruvim 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d2d270426e0c654c22de404d8745368dbc7a5eb98fc91eecad94624a3b91b6c
-  data.tar.gz: 75ad40c44e89934ab1746d43aee2ac09c695513d6edb6f7e71d0b888126931a8
+  metadata.gz: c463658b0badbad140842446b82818bb797930372d4ccb8ff5e4275fbe627904
+  data.tar.gz: 92b3c9f004f8b075f603d4b8f2e4c48255ac0ef3eea768dd3e290495ab661033
 SHA512:
-  metadata.gz: 938e1eb393efd57f97260526fc40f375d27ca0aecf9b370d0b0b41b7c3f535026b1c8be82588a2713025c615e4e5222abe871f46918fbc08f3fef9b35347e023
-  data.tar.gz: f0a3fb80d5f3e2395daf0c689fd4129bfd6ff026e3184eb8f0e58ffc68f19ede36be7ac6c914fa3a2a70bd9b7c9bb95ae60bf292f760ce7691b498a0b12d66a7
+  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,20 +59,32 @@
 - `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>`）
 - `Ctrl-o` : jumplist の古い位置へ
 - `Ctrl-i` : jumplist の新しい位置へ（端末では Tab と同じコード）
+- `Ctrl-d` / `Ctrl-u` : 半ページ下/上へ移動（概ね表示高さの半分）
+- `Ctrl-f` / `Ctrl-b` : 1ページ下/上へ移動（`PageDown` / `PageUp` 相当）
+- `Ctrl-e` / `Ctrl-y` : カーソル位置をなるべく保ったまま画面を1行下/上へスクロール（最小実装）
 - `q{reg}` : macro 記録開始/終了（再度 `q` で停止）
 - `@{reg}` / `@@` : macro 再生 / 直前 macro 再生
 - `n` : 直前検索を次へ
 - `N` : 直前検索を前へ（逆方向）
 - `*` / `#` : カーソル下の単語検索（前/後）
 - `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 対応（現状）
 
@@ -85,6 +100,7 @@
 - `Ctrl-p` : buffer words 補完（前候補）
 - `Esc` : Normal mode に戻る
 - `Ctrl-c` : Normal mode に戻る
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 - `矢印キー` : 移動
 - `PageUp` / `PageDown` : 画面単位で移動
 
@@ -96,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
 
@@ -109,6 +135,7 @@
 - `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応）
 - `Esc` : キャンセル
 - `Ctrl-c` : キャンセル
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 
 ### prefix 別の Enter 動作
 
@@ -122,4 +149,6 @@
 - `d` は keymap の固定列ではなく operator-pending 状態機械で解釈
 - 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`
@@ -94,8 +141,17 @@
 - 形式: `:ruby <code>`
 - 形式: `:rb <code>`
 - Ruby コードを評価し、返り値をステータスに表示
+- `stdout` / `stderr` に出力があった場合は `[Ruby Output]` 仮想バッファに表示（返り値も末尾に表示）
 - 利用可能: `ctx`, `editor`, `buffer`, `window`
 
+### `:!`（shell 実行, 最小）
+
+- 形式: `:!<command>`
+- shell コマンドを同期実行します
+- `stdout` / `stderr` に出力があった場合は `[Shell Output]` 仮想バッファに表示（終了ステータスも表示）
+- 出力がない場合は `shell exit N` をステータス表示
+- `-Z`（restricted mode）では無効
+
 ### `:ls` / `:buffers`
 
 - 形式: `:ls`
@@ -121,6 +177,41 @@
 - バッファ ID / 名前 / `#`（alternate）で切替
 - `!` 対応（未保存変更を無視して切替）
 
+### `:bdelete` / `:bd`
+
+- 形式: `:bdelete [id|name|#]`
+- 現在バッファ（または指定バッファ）を一覧から削除
+- 表示中 window は別バッファへ切り替えられる
+- `!` 対応（未保存変更バッファを破棄）
+
+### `:args`
+
+- 形式: `:args`
+- 引数リスト（arglist）を表示
+- 現在の引数は `[filename]` 形式で表示される
+
+### `:next`
+
+- 形式: `:next`
+- arglist の次の引数ファイルを開く
+- エラー: 最後の引数で実行時
+
+### `:prev`
+
+- 形式: `:prev`
+- arglist の前の引数ファイルを開く
+- エラー: 最初の引数で実行時
+
+### `:first`
+
+- 形式: `:first`
+- arglist の最初の引数ファイルを開く
+
+### `:last`
+
+- 形式: `:last`
+- arglist の最後の引数ファイルを開く
+
 ### `:split`
 
 - 形式: `:split`
@@ -149,6 +240,13 @@
 - 形式: `:tabprev`
 - 前のタブへ移動
 
+### `:tabs`
+
+- 形式: `:tabs`
+- 全タブページの一覧を表示
+- 各タブに含まれるウィンドウとバッファ名を表示
+- 現在のタブ / ウィンドウは `>` マーカーで示す
+
 ## 内部コマンド（主なもの）
 
 内部コマンドは主に key binding から使われ、`RuVim::CommandRegistry` に登録されます。
@@ -205,6 +303,7 @@
 - `editor.buffer_prev`
 - `buffer.replace_char`
 - `ui.clear_message`
+- `rich.toggle`
 
 ## 検索コマンド（Normal mode）
 
@@ -249,6 +348,7 @@
 - `buffer.visual_delete`
 - blockwise は最小実装（矩形選択 + `y/d`）
 - blockwise の text object 選択 / paste の Vim 互換挙動は未対応
+- `Ctrl-z` で shell へ suspend（`fg` で復帰）
 
 ## repeat（Normal mode）
 
@@ -294,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）