ruvim 0.4.0 → 0.6.0

data/benchmark/file_load.rb

@@ -0,0 +1,140 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Benchmark file loading hotspots
+#
+# Usage: ruby benchmark/file_load.rb [path]
+#   Default: huge_file in project root
+
+require "benchmark"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ruvim/buffer"
+require "ruvim/lang/registry"
+require "ruvim/lang/base"
+
+FILE = ARGV[0] || File.expand_path("../huge_file", __dir__)
+unless File.exist?(FILE)
+  abort "File not found: #{FILE}\nUsage: ruby benchmark/file_load.rb [path]"
+end
+
+size_mb = File.size(FILE) / 1024.0 / 1024.0
+puts "File Load Benchmark"
+puts "=" * 60
+puts "Ruby: #{RUBY_VERSION}"
+puts "File: #{FILE}"
+puts "Size: %.1f MB" % size_mb
+puts
+
+# ---------------------------------------------------------------------------
+# 1. Raw IO read
+# ---------------------------------------------------------------------------
+puts "--- 1. Raw file read ---"
+Benchmark.bm(25) do |x|
+  x.report("File.binread") do
+    data = File.binread(FILE)
+    data.size  # force read
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 2. decode_text (encoding detection)
+# ---------------------------------------------------------------------------
+puts "--- 2. decode_text ---"
+raw = File.binread(FILE)
+Benchmark.bm(25) do |x|
+  x.report("decode_text") do
+    RuVim::Buffer.decode_text(raw)
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 3. split_lines (String#split)
+# ---------------------------------------------------------------------------
+puts "--- 3. split_lines ---"
+decoded = RuVim::Buffer.decode_text(raw)
+Benchmark.bm(25) do |x|
+  x.report("split(\"\\n\", -1)") do
+    decoded.split("\n", -1)
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 4. Full Buffer.from_file
+# ---------------------------------------------------------------------------
+puts "--- 4. Full Buffer.from_file ---"
+Benchmark.bm(25) do |x|
+  x.report("Buffer.from_file") do
+    RuVim::Buffer.from_file(id: 1, path: FILE)
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 5. Chunked read (simulating Stream::FileLoad)
+# ---------------------------------------------------------------------------
+puts "--- 5. Chunked read (4MB flush, simulating async load) ---"
+CHUNK = 1 * 1024 * 1024
+FLUSH = 4 * 1024 * 1024
+Benchmark.bm(25) do |x|
+  x.report("chunked read+split") do
+    io = File.open(FILE, "rb")
+    lines = [""]
+    pending = "".b
+    begin
+      loop do
+        chunk = io.readpartial(CHUNK)
+        pending << chunk
+        next if pending.bytesize < FLUSH
+
+        last_nl = pending.rindex("\n".b)
+        if last_nl
+          send_bytes = pending[0..last_nl]
+          pending = pending[(last_nl + 1)..] || "".b
+        else
+          send_bytes = pending
+          pending = "".b
+        end
+        decoded = RuVim::Buffer.decode_text(send_bytes)
+        parts = decoded.split("\n", -1)
+        head = parts.shift || ""
+        lines[-1] = lines[-1] + head unless head.empty?
+        lines.concat(parts) unless parts.empty?
+      end
+    rescue EOFError
+      unless pending.empty?
+        decoded = RuVim::Buffer.decode_text(pending)
+        parts = decoded.split("\n", -1)
+        head = parts.shift || ""
+        lines[-1] = lines[-1] + head unless head.empty?
+        lines.concat(parts) unless parts.empty?
+      end
+    ensure
+      io.close
+    end
+    puts "    lines loaded: #{lines.size}"
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 6. Memory profile
+# ---------------------------------------------------------------------------
+puts "--- 6. Memory usage ---"
+GC.start
+before = GC.stat[:malloc_increase_bytes_limit]
+mem_before = `ps -o rss= -p #{$$}`.strip.to_i
+buf = RuVim::Buffer.from_file(id: 2, path: FILE)
+GC.start
+mem_after = `ps -o rss= -p #{$$}`.strip.to_i
+puts "  Lines: #{buf.line_count}"
+puts "  RSS before: #{mem_before / 1024} MB"
+puts "  RSS after:  #{mem_after / 1024} MB"
+puts "  RSS delta:  #{(mem_after - mem_before) / 1024} MB"
+
+puts
+puts "=" * 60
+puts "Done."

data/benchmark/hotspots.rb

@@ -0,0 +1,178 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Benchmark for C-extension candidate hotspots in RuVim
+#
+# Usage: ruby benchmark/hotspots.rb
+
+require "benchmark"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ruvim/display_width"
+require "ruvim/text_metrics"
+require "ruvim/highlighter"
+require "ruvim/lang/registry"
+require "ruvim/lang/base"
+require "ruvim/lang/ruby"
+require "ruvim/lang/c"
+require "ruvim/lang/markdown"
+require "ruvim/lang/json"
+require "ruvim/lang/javascript"
+
+# ---------------------------------------------------------------------------
+# Test data
+# ---------------------------------------------------------------------------
+ASCII_LINE   = '  def foo(bar, baz) = bar + baz # comment with some padding text here!!!' * 2
+CJK_LINE     = "日本語テキスト　漢字カタカナ　テスト用の行　全角文字を含む行" * 2
+MIXED_LINE   = "Hello 世界! def foo(x) = x + 1  # コメント 🚀 emoji test"
+EMOJI_LINE   = "🎉🔥💡🚀✨🎊🌟💎🏆🎯" * 5
+TAB_LINE     = "\t\tif (x > 0) {\n\t\t\treturn x;\n\t\t}"
+
+RUBY_LINE    = '  def initialize(name, value: nil) # keyword args'
+C_LINE       = '  int *ptr = malloc(sizeof(struct node)); /* alloc */'
+MD_LINE      = '## Heading with **bold** and `code` and [link](url)'
+JSON_LINE    = '  {"key": "value", "number": 42, "bool": true, "null": null}'
+JS_LINE      = '  const fn = async (x) => { return await fetch(url); };'
+
+LINES_80COL  = [ASCII_LINE, CJK_LINE, MIXED_LINE, RUBY_LINE, C_LINE].freeze
+SCREEN_WIDTH = 120
+SCREEN_ROWS  = 50
+
+N_ITER = 10_000
+N_RENDER = 2_000
+
+puts "RuVim Hotspot Benchmark"
+puts "=" * 60
+puts "Ruby: #{RUBY_VERSION} (#{RUBY_PLATFORM})"
+puts "Iterations: #{N_ITER} (width), #{N_RENDER} (render)"
+puts
+
+# ---------------------------------------------------------------------------
+# 1. DisplayWidth.cell_width — per-character width lookup
+# ---------------------------------------------------------------------------
+puts "--- 1. DisplayWidth.cell_width ---"
+chars = {
+  "ASCII 'A'"   => "A",
+  "CJK '漢'"    => "漢",
+  "Emoji '🚀'"  => "🚀",
+  "Combining"   => "\u0301",   # combining acute
+  "Tab"         => "\t",
+}
+Benchmark.bm(20) do |x|
+  chars.each do |label, ch|
+    x.report(label) { N_ITER.times { RuVim::DisplayWidth.cell_width(ch) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 2. DisplayWidth.display_width — whole-line width
+# ---------------------------------------------------------------------------
+puts "--- 2. DisplayWidth.display_width ---"
+lines = {
+  "ASCII (140c)"  => ASCII_LINE,
+  "CJK (56c)"     => CJK_LINE,
+  "Mixed"         => MIXED_LINE,
+  "Emoji (50c)"   => EMOJI_LINE,
+  "Tabs"          => TAB_LINE,
+}
+Benchmark.bm(20) do |x|
+  lines.each do |label, line|
+    x.report(label) { N_ITER.times { RuVim::DisplayWidth.display_width(line) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 3. TextMetrics.clip_cells_for_width — cell array construction
+# ---------------------------------------------------------------------------
+puts "--- 3. TextMetrics.clip_cells_for_width ---"
+Benchmark.bm(20) do |x|
+  lines.each do |label, line|
+    x.report(label) { N_RENDER.times { RuVim::TextMetrics.clip_cells_for_width(line, SCREEN_WIDTH) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 4. TextMetrics.char_index_for_screen_col — cursor positioning
+# ---------------------------------------------------------------------------
+puts "--- 4. TextMetrics.char_index_for_screen_col ---"
+Benchmark.bm(20) do |x|
+  lines.each do |label, line|
+    target = RuVim::DisplayWidth.display_width(line) / 2
+    x.report(label) { N_ITER.times { RuVim::TextMetrics.char_index_for_screen_col(line, target) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 5. Highlighter.color_columns — syntax highlighting
+# ---------------------------------------------------------------------------
+puts "--- 5. Highlighter.color_columns ---"
+highlight_cases = {
+  "Ruby"       => ["ruby", RUBY_LINE],
+  "C"          => ["c", C_LINE],
+  "Markdown"   => ["markdown", MD_LINE],
+  "JSON"       => ["json", JSON_LINE],
+  "JavaScript" => ["javascript", JS_LINE],
+}
+Benchmark.bm(20) do |x|
+  highlight_cases.each do |label, (ft, line)|
+    x.report(label) { N_RENDER.times { RuVim::Highlighter.color_columns(ft, line) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 6. Simulated full-screen render pass (clip + highlight per line)
+# ---------------------------------------------------------------------------
+puts "--- 6. Simulated screen render (#{SCREEN_ROWS} lines × #{SCREEN_WIDTH} cols) ---"
+screen_lines = Array.new(SCREEN_ROWS) { |i| LINES_80COL[i % LINES_80COL.size] }
+Benchmark.bm(20) do |x|
+  x.report("clip_cells only") do
+    N_RENDER.times do
+      screen_lines.each { |line| RuVim::TextMetrics.clip_cells_for_width(line, SCREEN_WIDTH) }
+    end
+  end
+  x.report("highlight only") do
+    N_RENDER.times do
+      screen_lines.each_with_index do |line, i|
+        ft = %w[ruby c markdown json javascript][i % 5]
+        RuVim::Highlighter.color_columns(ft, line)
+      end
+    end
+  end
+  x.report("clip + highlight") do
+    N_RENDER.times do
+      screen_lines.each_with_index do |line, i|
+        ft = %w[ruby c markdown json javascript][i % 5]
+        RuVim::TextMetrics.clip_cells_for_width(line, SCREEN_WIDTH)
+        RuVim::Highlighter.color_columns(ft, line)
+      end
+    end
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 7. DisplayWidth.expand_tabs
+# ---------------------------------------------------------------------------
+puts "--- 7. DisplayWidth.expand_tabs ---"
+tab_lines = {
+  "2 tabs"   => "\t\tcode here",
+  "mixed"    => "abc\tdef\tghi\tjkl",
+  "heavy"    => "\t" * 20 + "end",
+}
+Benchmark.bm(20) do |x|
+  tab_lines.each do |label, line|
+    x.report(label) { N_ITER.times { RuVim::DisplayWidth.expand_tabs(line) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# Summary
+# ---------------------------------------------------------------------------
+puts "=" * 60
+puts "Done. Compare user+sys times to identify C-extension priorities."

data/docs/binding.md

@@ -90,8 +90,9 @@
 - `gr` : Rich mode をトグル（TSV/CSV をテーブル整形表示、同一バッファ上で動作）
 - `g/` : 検索パターンにマッチする行だけを集めたフィルタバッファを作成（再帰フィルタ可、Enter で元行へジャンプ、`:q` で戻る）
 - `Ctrl-g` : Git コマンドモード（`:git ` がプリセットされたコマンドラインに入る）
-  - `blame` → Git blame を開く / `status` → Git status / `diff` → Git diff / `log` → Git log
+  - `blame` → Git blame を開く / `status` → Git status / `diff` → Git diff / `log` → Git log / `branch` → ブランチ一覧
   - Blame バッファ内: `p` 親コミットの blame へ遷移 / `P` 前の blame へ戻る / `c` コミット詳細を表示
+  - Branch バッファ内: `Enter` で `:git checkout <branch>` をコマンドラインにプリセット（即時実行ではなく確認ステップあり）
 - `Ctrl-c` : stdin stream 停止（stdin バッファ表示時）
 - `Esc` : メッセージ/保留入力のクリア
 - `Ctrl-z` : shell へ suspend（`fg` で復帰）
@@ -148,7 +149,7 @@
 - `Backspace` : 1文字削除
 - `Up` / `Down` : 履歴移動
 - `Left` / `Right` : カーソル移動
-- `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応）
+- `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応。`:git`/`:gh` サブコマンドも補完可能）
 - `Esc` : キャンセル
 - `Ctrl-c` : キャンセル
 - `Ctrl-z` : shell へ suspend（`fg` で復帰）

data/docs/command.md

@@ -71,7 +71,7 @@
 - 未保存変更がある場合は `!` なしで拒否
 - `:e!` は未保存変更を破棄して開き直す（undo/redo もクリア）
 - 大きいファイル（閾値以上）は段階読み込みになる場合がある
-  - 読み込み中は status line に `[load/live]`
+  - 読み込み中は statusline に `[load/live]`
   - デフォルトでは先頭 `8MB` を先に表示して、残りを後から追加
   - 閾値: `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
   - 先読みサイズ: `RUVIM_ASYNC_FILE_PREFIX_BYTES`
@@ -115,13 +115,49 @@
   - current window の location list を開く / 閉じる
 - `:lnext` / `:ln`, `:lprev` / `:lp`
   - location list 項目を前後移動して該当位置へジャンプ
-- `:grep /pattern/ [path...]`
+- `:grep pattern [path...]`
   - 外部 grep（`grepprg`）を実行して quickfix list を作成
-- `:lgrep /pattern/ [path...]`
+  - シェル経由ではなく argv 配列で安全に実行（シェルインジェクション対策済み）
+  - ワイルドカード（`*.txt` 等）は Ruby の `Dir.glob` で展開
+  - `-Z`（restricted mode）では無効
+- `:lgrep pattern [path...]`
   - 外部 grep（`grepprg`）を実行して location list を作成
+  - `:grep` と同じセキュリティ仕様
+- 一覧バッファ上で `Enter` : 選択項目へジャンプ（一覧ウィンドウから元の編集ウィンドウへ戻る）
 - 現状の制限:
   - `:make`, `:cfile`, `:lfile` は未実装
-  - 一覧バッファ上で `Enter` からのジャンプは未実装
+
+### `:git`
+
+- 形式: `:git <subcommand> [args...]`
+- Git 操作の統合インターフェース
+- `-Z`（restricted mode）では無効
+- サブコマンド:
+  - `blame` : 現在ファイルの git blame を表示（read-only バッファ）
+    - blame バッファ内: `p` 親コミットの blame / `P` 前の blame へ戻る / `c` コミット詳細
+  - `status` : git status を表示
+  - `diff` : git diff を表示
+  - `log` : git log を表示
+  - `branch` : ブランチ一覧を表示
+    - branch バッファ内: `Enter` で `:git checkout <branch>` をコマンドラインにプリセット（確認ステップあり）
+  - `checkout <branch>` : 指定ブランチへチェックアウト
+  - `commit` : コミットメッセージ入力バッファを開く
+  - `grep <pattern> [args...]` : git grep -n を実行、結果バッファで Enter ジャンプ
+  - その他の未知サブコマンド: `:!` と同様に alternate screen でシェル実行（例: `:git stash`, `:git rebase -i`）
+- Git バッファは `Esc` / `Ctrl-c` で閉じる
+- Tab 補完: `git help -a` の出力から全サブコマンドを補完候補として提示（セッション内キャッシュ）
+
+### `:gh`
+
+- 形式: `:gh <subcommand> [args...]`
+- GitHub 連携の統合インターフェース
+- `-Z`（restricted mode）では無効
+- サブコマンド:
+  - `link` : 現在ファイル/選択範囲の GitHub URL を生成してクリップボードにコピー
+  - `browse` : 現在ファイルの GitHub URL をブラウザで開く
+  - `pr` : 現在ブランチの PR ページをブラウザで開く
+  - その他の未知サブコマンド: `:!` と同様に alternate screen でシェル実行（例: `:gh issue list`）
+- Tab 補完: `gh help` の出力からサブコマンドを補完候補として提示（セッション内キャッシュ）
 
 ### `:rich`
 
@@ -154,7 +190,7 @@
 - `G` で末尾に移動すれば追従が再開される
 - `:follow` を再度実行すると停止
 - `Ctrl-C`（ノーマルモード）で follow を停止
-- ステータスラインに `[follow]` と表示される（inotify 使用時は `[follow/i]`）
+- statusline に `[follow]` と表示される（inotify 使用時は `[follow/i]`）
 - ファイルが紐づいていないバッファではエラー
 - 未保存の変更があるバッファでは follow 開始不可
 - follow 中のバッファは変更不可（modifiable が false）
@@ -179,14 +215,50 @@
 - `stdout` / `stderr` に出力があった場合は `[Ruby Output]` 仮想バッファに表示（返り値も末尾に表示）
 - 利用可能: `ctx`, `editor`, `buffer`, `window`
 
-### `:!`（shell 実行, 最小）
+### `:r` / `:read`（ファイル・コマンド出力の挿入）
+
+- 形式: `:r <file>` または `:r !<command>`
+- ファイルの内容またはシェルコマンドの stdout をカーソル行の下に挿入します
+- 行番号指定可: `:3r file.txt`（3行目の下に挿入）
+- `:r !command` で stderr が出た場合、最初の行をエラーメッセージとして表示します
+
+### `:w !`（バッファ内容をコマンドへパイプ）
+
+- 形式: `:w !<command>` または `:'<,'>w !<command>`
+- バッファ（または範囲指定された行）の内容をシェルコマンドの stdin に渡します
+- 例: `:w !wc -l`（行数カウント）、`:'<,'>w !sort`（選択範囲をソート）
+
+### `:!`（shell 実行）
 
 - 形式: `:!<command>`
-- shell コマンドを同期実行します
-- `stdout` / `stderr` に出力があった場合は `[Shell Output]` 仮想バッファに表示（終了ステータスも表示）
-- 出力がない場合は `shell exit N` をステータス表示
+- alternate screen を一時的に抜けて main screen 上で shell コマンドを同期実行します（Vim 互換）
+- 実行後 "Press ENTER or type command to continue" を表示し、入力待ち後にエディタに復帰
+- 完了後は `shell exit N` をステータス表示
 - `-Z`（restricted mode）では無効
 
+### `:run`（コマンド実行＋結果バッファ）
+
+- 形式: `:run [command]`
+- シェルコマンドを実行し、出力を `[Shell Output]` バッファにストリーム表示（PTY 経由でリアルタイム）
+- `[Shell Output]` バッファは read-only で、最大1つ（再利用される）
+- stdout / stderr はマージされて表示
+- コマンド中の `%` は現在のファイル名に展開される
+- コマンド文字列はシェル引用符を保持（raw 解析）
+- 変更のあるバッファは実行前に自動保存される
+- 引数なしの場合:
+  - そのバッファで直前に実行したコマンドがあればそれを再実行
+  - なければ `runprg` オプションの値を使用
+- バッファごとに実行履歴（直前のコマンド）を保持
+- 実行中のコマンドはステータスラインに表示（`[run] command`、完了後は `[run/exit N] command`）
+- `Ctrl-C` で実行中のプロセスを停止
+- `runprg` オプション: ファイルタイプごとのデフォルト実行コマンド
+  - Ruby: `ruby -w %`
+  - Python: `python3 %`
+  - C: `gcc -Wall -o /tmp/a.out % && /tmp/a.out`
+  - C++: `g++ -Wall -o /tmp/a.out % && /tmp/a.out`
+  - Scheme: `gosh %`
+  - JavaScript: `node %`
+
 ### `:ls` / `:buffers`
 
 - 形式: `:ls`

data/docs/done.md

@@ -47,6 +47,7 @@
 - `docs/plugin.md`（拡張 / plugin 的な書き方）
 - block-based keymap DSL（`nmap/imap/map_global ... do |ctx, ...| end`）
 - plugin 向け `ctx.editor / ctx.buffer / ctx.window` API リファレンス（未確定 API 注記つき）
+- `:run` コマンド（PTY ストリーミング、`runprg` オプション、バッファごと実行履歴、`%` ファイル名展開、auto-save、Ctrl-C 停止、status line にコマンド表示）
 
 ## Rich mode / 構造化データ表示
 
@@ -77,6 +78,7 @@
 - PageUp / PageDown 対応
 - `:q` の window/tab/app クローズ挙動を Vim 寄りに調整
 - hit-enter prompt（複数行メッセージ表示: `:ls`, `:args`, `:set`, `:command`）
+- カーソル形状制御（DECSCUSR: Normal では非表示+セル反転、Insert ではバーカーソル）
 
 ## Unicode / 日本語 / 表示幅 / 座標系
 
@@ -99,7 +101,11 @@
 - CI / 開発体験（GitHub Actions, `rake docs:check`, `rake ci`）
 - シンタックスハイライト（最小）
 - Markdown シンタックスハイライト（`Lang::Markdown` に抽出、通常モード + Rich mode で共有）
+- C 言語モード（`Lang::C`）: シンタックスハイライト・スマートインデント・保存時 gcc チェック
+- C++ 言語モード（`Lang::Cpp`）: C の全機能 + C++ 固有キーワード・アクセス指定子インデント・保存時 g++ チェック
 - 補完基盤（Ex 補完 / Insert mode 補完）
+- git/gh サブコマンドの Tab 補完（`git help -a` / `gh help` から動的取得、セッション内キャッシュ）
+- 未知の `:git` / `:gh` サブコマンドのシェルフォールバック実行
 
 ## CLI オプション（Vim 風・実装済み / placeholder 含む）
 
@@ -124,6 +130,23 @@
 - `-q {errorfile}`（quickfix 読み込み起動）
 - `-S [session]`（session 読み込み）
 
+## セキュリティ修正
+
+- `:grep` / `:lgrep` のシェルインジェクション対策（argv 配列実行 + `Dir.glob` 展開）
+- Rich view レンダリング時のターミナルエスケープインジェクション対策（制御文字の無害化）
+- Restricted mode (`-Z`) の網羅強化（`:grep`, `:lgrep`, `:git`, `:gh` を無効化）
+- Git branch checkout の安全化（Enter で即時実行せずコマンドラインにプリセットして確認ステップを挟む）
+- 非同期ファイルローダーの OOM 対策（`bulk_once` モード廃止、チャンク読み込み）
+- 特殊ファイル（FIFO/デバイス/ソケット）の読み込み拒否（`Buffer.ensure_regular_file!` で統一ガード）
+
+## Stream クラス階層化 / StreamMixer リネーム
+
+- `@loading_state` を Stream に統合し、非同期ファイルロード状態を `Stream::FileLoad` で管理
+- Stream を基底クラス + 5 サブクラス（`Stdin`, `Run`, `Follow`, `FileLoad`, `Git`）に分離
+- fire-on-new パターン: `new` 時点でスレッド/ウォッチャーを即時起動
+- `stop_handler` をコンストラクタで渡す（`attr_reader`）
+- `StreamHandler` を `StreamMixer` にリネーム（責務を明確化: イベントキューの合流・分配）
+
 ## ドキュメント整理 / 仕様整備
 
 - `docs/spec.md`, `docs/tutorial.md`, `docs/binding.md`, `docs/command.md`, `docs/config.md`, `docs/vim_diff.md` の継続更新