Lib.rs

› Text editors › reovim-core
#jump #reovim #mode #leap-motion

reovim-plugin-leap

Two-character jump navigation plugin for reovim

by ds1sqe

2 releases

Uses new Rust 2024

0.7.9 Jan 5, 2026
0.7.8 Dec 27, 2025

#11 in #reovim

MIT and AGPL-3.0-only

2MB
39K SLoC

Leap motion plugin for reovim

This plugin provides two-character jump navigation (like leap.nvim/hop.nvim).

Architecture Note

Commands emit EventBus events that are handled by the runtime. Uses PluginStateRegistry for state management.

reovim

A Rust-powered neovim-like text editor.

Project Goals

  • Fastest-reaction editor: Minimal latency, instant response
  • Scalability: Handles large files and complex operations
  • Zero-warning policy: All code must compile warning-free

Features

Core Editing

  • Modal editing (Normal, Insert, Visual, Command modes)
  • Vim-style keybindings (h/j/k/l navigation, w/b word motions)
  • Operators with motions (d, y, c + motion)
  • Visual selection with yank/delete
  • Undo/Redo (u, Ctrl-r)
  • Registers for copy/paste

Navigation

  • Leap motion - Two-character jump (s/S + 2 chars)
  • Telescope fuzzy finder - Files, buffers, grep (Space f)
  • Explorer file browser - Tree view (Space e)
  • Jump list navigation (Ctrl-O, Ctrl-I)

UI

  • Command-line mode (:q, :w, :wq, :set)
  • Line numbers (absolute, relative, hybrid)
  • Which-key popup for keybindings
  • Completion engine (Ctrl-Space)
  • Status line with mode, pending keys, last command
  • Landing page when started without a file

Syntax & Code Intelligence

  • Treesitter syntax highlighting - Accurate parsing for Rust, C, JavaScript, Python, JSON, TOML, Markdown
  • Code folding - za/zo/zc to toggle, zR/zM to open/close all
  • Semantic text objects - af/if (function), ac/ic (class/struct)

Performance

v0.6.0 uses diff-based rendering via FrameBuffer - trades per-render overhead for zero flickering:

Metric v0.5.0 v0.6.0 Change
Window render (10 lines) 1.6 µs 10 µs +6x
Window render (10k lines) 6.9 µs 56 µs +8x
Full screen render 14 µs 62 µs +4x
Char insert RTT 56 µs 108 µs +2x
Move down RTT 751 µs 806 µs +7%
Throughput 144k/sec 18k/sec -87%

Key benefits:

  • Zero flickering - Only changed cells sent to terminal
  • Consistent I/O - Buffer size doesn't affect terminal writes
  • Composable layers - Clean UI component separation
  • Async architecture with tokio runtime
  • Cross-platform terminal support via crossterm

Installation

cargo install reovim

Building from Source

git clone https://github.com/ds1sqe/reovim.git
cd reovim
cargo build --release

Usage

reovim [file]

Server Mode

Reovim can run as a JSON-RPC 2.0 server for programmatic control, enabling integration with external tools, IDEs, and automation scripts. The server accepts multiple sequential connections - clients can connect, disconnect, and reconnect without restarting the server.

# Start server (TCP on 127.0.0.1:12521 by default)
reovim --server

# With a file
reovim --server myfile.txt

# Custom TCP port
reovim --server --listen-tcp 9000

# Unix socket
reovim --listen-socket /tmp/reovim.sock

# Stdio transport (for process piping)
reovim --stdio

# Dual output: render to terminal while serving RPC
reovim --server --terminal

Server Options:

Flag Description
--server Start in server mode (TCP on 127.0.0.1:12521)
--test Exit when all clients disconnect (for testing/CI)
--stdio Use stdio instead of TCP (for process piping, always one-shot)
--listen-socket <PATH> Listen on Unix socket
--listen-tcp <PORT> Listen on custom TCP port
--listen-host <HOST> Bind to specific host (default: 127.0.0.1)
--terminal Also render to terminal in server mode

Default port: 12521 (derived from ASCII: 'r'×100 + 'e'×10 + 'o')

reo-cli Client

A CLI client tool is available for interacting with the server:

# Connect to default server (127.0.0.1:12521)
reo-cli mode                    # Get current mode
reo-cli keys 'iHello<Esc>'      # Inject key sequence
reo-cli cursor                  # Get cursor position

# Connect to custom address
reo-cli --tcp localhost:9000 mode
reo-cli --socket /tmp/reovim.sock mode

# Interactive REPL
reo-cli --interactive

Key Bindings

Most movement commands support a numeric prefix (e.g., 5j moves down 5 lines).

Normal Mode

Key Action
h/j/k/l Move cursor left/down/up/right
w/b Move word forward/backward
0/$ Move to line start/end
gg Go to first line (or {n}gg to go to line n)
G Go to last line (or {n}G to go to line n)
i Enter insert mode
a Enter insert mode after cursor
A Enter insert mode at end of line
o Open new line below and enter insert mode
O Open new line above and enter insert mode
v Enter visual mode
: Enter command mode
x Delete character
p/P Paste after/before cursor
s Leap forward (type 2 chars to jump)
S Leap backward
Space e Toggle explorer
Space f f Telescope find files
Space f g Telescope live grep
Space f b Telescope buffers
Ctrl-Space Trigger completion
za Toggle fold at cursor
zo Open fold at cursor
zc Close fold at cursor
zR Open all folds
zM Close all folds

Insert Mode

Key Action
Escape Return to normal mode
Backspace Delete character before cursor

Visual Mode

Key Action
h/j/k/l Extend selection
d Delete selection
y Yank selection
Escape Return to normal mode

Command Mode

Command Action
:q Quit
:w [file] Write (save)
:wq Write and quit
:set nu / :set number Show line numbers
:set nonu / :set nonumber Hide line numbers
:set rnu / :set relativenumber Show relative line numbers
:set nornu / :set norelativenumber Hide relative line numbers

Architecture

MAIN ──▶ CORE ──▶ SYS
           │
           └── LayerCompositor ──▶ FrameBuffer ──▶ Terminal
  • reovim (MAIN) - Main binary
  • reovim-core (CORE) - Core editor logic (runtime, buffers, events, screen)
  • reovim-sys (SYS) - System abstraction layer (crossterm re-exports)

Rendering Pipeline: LayerCompositor renders UI layers (editor, explorer, overlays) to a FrameBuffer, which diffs against the previous frame to emit minimal terminal updates.

Performance

Run benchmarks:

cargo bench -p reovim-core

Generate performance report:

cargo run -p perf-report -- update --version X.Y.Z

See perf/ for versioned benchmark results.

Documentation

License

MIT

Dependencies

~38–58MB
~1M SLoC