mui 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f64c4815352bf9fcafa99092cea5126496eb9340f0e679b0408e70d59c248627
-  data.tar.gz: 160afb5b1c9891413852c76357470864d3d1a9d3621497f87695313d480ca934
+  metadata.gz: 9515ecfb14d1a9ea5422a842fd22911c303f2465f35827b879117e3cce4d1551
+  data.tar.gz: e6daedc45ebb07f1e8b094f590ae9749bfae49e2ced12017cba16f1c1dc255c0
 SHA512:
-  metadata.gz: cfd12998c552ac377bfb8be5c1b208cc73fc6d5897639e39be6cb29ce67d964dd6dbd71604727578ecd755a930c1a66feff4c800142c513a900b76ad7d8eb20c
-  data.tar.gz: e09e98c9b835227152dc0ecfbf2d0207b5f5545bc300fbdd898fd0fdde79d5bb6906c113729e1a3dc7a1bbf12b467cd7a549cc5e19d04d948d3b94eb6f36885c
+  metadata.gz: 4f493037291b8801dd2fc8a6101fb714110c12653ebb432900eebaa8f135d91597c8c862d5cf2b380e332d689decbada6d06f406e7f8c8eae859819d63887845
+  data.tar.gz: de2b83ea5a999760a171bb037bc264035ef1b43878b806a2b0577099b5601e6e94bdbf6d711604fd9d5a7df01d381665ed734526e1d0f643f896b40e89954604

data/.rubocop_todo.yml

@@ -0,0 +1,158 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-12-11 15:57:29 UTC using RuboCop version 1.81.7.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: Severity.
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'test/fixtures/mui-test-plugin/mui-test-plugin.gemspec'
+
+# Offense count: 3
+# Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
+Lint/DuplicateBranch:
+  Exclude:
+    - 'lib/mui/key_handler/command_mode.rb'
+    - 'lib/mui/plugin_manager.rb'
+    - 'lib/mui/register.rb'
+
+# Offense count: 3
+# Configuration parameters: AllowComments, AllowEmptyLambdas.
+Lint/EmptyBlock:
+  Exclude:
+    - 'test/mui/test_autocmd.rb'
+    - 'test/mui/test_command_registry.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'test/test_helper.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/mui/terminal_adapter/base.rb'
+
+# Offense count: 1
+Lint/UselessConstantScoping:
+  Exclude:
+    - 'lib/mui/buffer_word_cache.rb'
+
+# Offense count: 32
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 49
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ModuleLength:
+  Max: 284
+
+# Offense count: 10
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 9
+
+# Offense count: 12
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 19
+
+# Offense count: 3
+Naming/AccessorMethodName:
+  Exclude:
+    - 'lib/mui/command_context.rb'
+    - 'lib/mui/search_input.rb'
+    - 'test/test_helper.rb'
+
+# Offense count: 37
+# Configuration parameters: EnforcedStyle, AllowedPatterns, ForbiddenIdentifiers, ForbiddenPatterns.
+# SupportedStyles: snake_case, camelCase
+# ForbiddenIdentifiers: __id__, __send__
+Naming/MethodName:
+  Exclude:
+    - 'test/e2e/test_motion.rb'
+    - 'test/e2e/test_vim_operations.rb'
+    - 'test/e2e/test_visual_mode.rb'
+    - 'test/integration/test_editor_integration.rb'
+    - 'test/mui/editor/test_normal_mode.rb'
+    - 'test/mui/key_handler/test_normal_mode.rb'
+    - 'test/mui/key_handler/test_normal_mode_search.rb'
+    - 'test/mui/key_handler/test_visual_line_mode.rb'
+    - 'test/mui/key_handler/test_visual_mode.rb'
+    - 'test/mui/key_handler/test_window_command.rb'
+
+# Offense count: 41
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
+Naming/MethodParameterName:
+  Exclude:
+    - 'lib/mui/buffer.rb'
+    - 'lib/mui/color_manager.rb'
+    - 'lib/mui/color_scheme.rb'
+    - 'lib/mui/layout/calculator.rb'
+    - 'lib/mui/line_renderer.rb'
+    - 'lib/mui/plugin.rb'
+    - 'lib/mui/screen.rb'
+    - 'lib/mui/terminal_adapter/base.rb'
+    - 'lib/mui/terminal_adapter/curses.rb'
+    - 'lib/mui/window.rb'
+    - 'test/e2e/test_helper.rb'
+    - 'test/test_helper.rb'
+
+# Offense count: 6
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/mui/key_handler/insert_mode.rb'
+    - 'lib/mui/undo_manager.rb'
+    - 'lib/mui/window_manager.rb'
+
+# Offense count: 1
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/mui/search_state.rb'
+
+# Offense count: 2
+# Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
+# SupportedStyles: snake_case, normalcase, non_integer
+# AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
+Naming/VariableNumber:
+  Exclude:
+    - 'test/e2e/test_motion.rb'
+    - 'test/mui/test_register.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Style/ComparableClamp:
+  Exclude:
+    - 'lib/mui/screen.rb'
+
+# Offense count: 25
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, AllowedMethods.
+# AllowedMethods: to_ary, to_a, to_c, to_enum, to_h, to_hash, to_i, to_int, to_io, to_open, to_path, to_proc, to_r, to_regexp, to_str, to_s, to_sym
+Style/TrivialAccessors:
+  Exclude:
+    - 'test/mui/test_autocmd.rb'

data/CHANGELOG.md

@@ -1,5 +1,354 @@
 ## [Unreleased]
 
+## [0.2.0] - 2025-12-12
+
+### Added
+- Insert mode completion support for LSP:
+  - `InsertCompletionState` class for managing LSP completion items
+  - `InsertCompletionRenderer` for displaying completion popup below cursor
+  - `Editor#start_insert_completion(items, prefix:)` API for plugins
+  - `Editor#insert_completion_active?` to check completion state
+  - Key bindings in Insert mode:
+    - `↑` / `Ctrl+P`: Select previous completion
+    - `↓` / `Ctrl+N`: Select next completion
+    - `Tab`: Confirm and insert selected completion
+    - `Esc`: Cancel completion popup
+  - Popup automatically repositions above cursor if space is limited
+  - Auto-trigger completion after `.`, `@`, and `::` characters
+  - Uses LSP `textEdit` for precise text replacement
+- Buffer word completion (`Ctrl+N` / `Ctrl+P` in Insert mode):
+  - Collects words from current buffer as completion candidates
+  - `BufferWordCache` class for high-performance word caching
+  - Cache built once when entering Insert mode, updated incrementally on changes
+  - Auto-triggers while typing (1+ character prefix)
+  - Dynamic filtering: completion list updates as you type more characters
+  - Excludes word at cursor position from candidates
+  - Triggered when no LSP completion is active
+- `InsertCompletion` autocmd event for plugins to hook into completion triggers
+- `KeyCode::CTRL_N`, `KeyCode::CTRL_P`, and `KeyCode::CTRL_SPACE` constants
+- `KeyHandler::Base#editor` helper method for accessing editor instance
+- Insert mode plugin keymap support (allows plugins to define Insert mode key bindings)
+- LSP configuration stub (`Mui.lsp` / `Mui::LspConfigStub`):
+  - Allows `.muirc` to call `Mui.lsp { ... }` before mui-lsp gem is loaded
+  - Stub stores configuration (preset servers via `use`, custom servers via `server`)
+  - When mui-lsp gem loads, configurations are automatically migrated to real `ConfigDsl`
+  - `Mui.lsp_server_configs` returns stored server configurations
+- Floating window (popup) support:
+  - `FloatingWindow` class for displaying temporary content like hover info
+  - `editor.show_floating(content, max_width:, max_height:)` to show popup at cursor
+  - `editor.hide_floating` to close the popup
+  - Automatic positioning with screen bounds adjustment
+  - Unicode box-drawing border characters
+  - Scroll support for long content
+  - Auto-close on any key press (Escape only closes without processing)
+  - Configurable via `:floating_window` color scheme element
+- Dynamic custom highlighter management for buffers:
+  - `Buffer#add_custom_highlighter(key, highlighter)` to add named highlighter
+  - `Buffer#remove_custom_highlighter(key)` to remove highlighter by key
+  - `Buffer#custom_highlighter?(key)` to check if highlighter exists
+  - `Window#refresh_highlighters` to rebuild line renderer after highlighter changes
+  - Enables plugins to dynamically add/remove highlighting (e.g., LSP diagnostics)
+- Interactive command execution support for plugins:
+  - `TerminalAdapter#suspend` / `#resume` methods for temporarily exiting curses mode
+  - `Editor#suspend_ui` block helper for safe UI suspension
+  - `CommandContext#run_interactive_command(cmd)` to run external interactive commands (e.g., fzf)
+  - `CommandContext#command_exists?(cmd)` to check if external command is available
+  - Enables plugins to integrate with interactive CLI tools like fzf, less, etc.
+- Custom highlighter support for buffers:
+  - `Buffer#custom_highlighters(color_scheme)` method for buffer-specific highlighting
+  - Window automatically applies custom highlighters from buffer
+  - Enables plugins to provide syntax highlighting for special buffers (e.g., diff output)
+- Diff highlighting color definitions:
+  - Added `diff_add`, `diff_delete`, `diff_hunk`, `diff_header` to ColorScheme elements
+  - All themes now include diff highlighting colors
+- Incremental search (incsearch):
+  - Search results highlight in real-time as you type
+  - Cursor moves to first match while typing
+  - Escape cancels search and restores original cursor position
+  - Backspace updates search results incrementally
+  - Works with both forward (`/`) and backward (`?`) search
+  - Word completion popup shows matching words from buffer as you type
+  - Tab/Shift+Tab to cycle through completion candidates
+  - Completions are extracted from buffer content (identifiers and words)
+- Word search commands (`*` and `#`):
+  - Normal mode: `*` searches forward for word under cursor
+  - Normal mode: `#` searches backward for word under cursor
+  - Uses word boundaries (`\b`) for whole-word matching (Vim behavior)
+  - Visual mode: `*`/`#` searches for selected text
+  - Works in both Visual mode (`v`) and Visual Line mode (`V`)
+  - Special regex characters are escaped for literal matching
+  - Search state is updated so `n`/`N` continues to find matches
+- Visual mode indent commands (Vim-compatible):
+  - `>` to add indent to selected lines (shiftwidth spaces or tab)
+  - `<` to remove indent from selected lines
+  - Works in both Visual mode (`v`) and Visual Line mode (`V`)
+  - Empty lines are skipped (Vim behavior)
+  - Multiple lines indented as single undo group
+  - Cursor moves to first selected line after operation
+  - Configuration options: `shiftwidth` (default: 2), `expandtab` (default: true), `tabstop` (default: 8)
+  - `reselect_after_indent` option (default: false): Keep selection after indent for continuous adjustment
+- Reselect last visual selection (`gv` command):
+  - `gv` in Normal mode restores the previous visual selection
+  - Works with both Visual mode and Visual Line mode
+  - Cursor moves to end of selection
+  - Useful for repeating operations on the same selection (e.g., multiple indents)
+- Asynchronous job execution system (JobManager):
+  - `JobManager` class for managing background tasks with Thread + Queue
+  - `Job` class with status tracking (pending, running, completed, failed, cancelled)
+  - Thread-safe implementation with Mutex protection
+  - `context.run_async { ... }` to run Ruby blocks asynchronously
+  - `context.run_shell_command("cmd")` to run external shell commands via Open3
+  - `context.jobs_running?` to check if any jobs are active
+  - `context.cancel_job(id)` to cancel a running job
+  - Callback support via `on_complete:` parameter
+  - Autocmd events: JobStarted, JobCompleted, JobFailed, JobCancelled
+  - Non-blocking event loop with polling for job results
+- Scratch buffer support:
+  - `editor.open_scratch_buffer(name, content)` to display read-only results
+  - `context.open_scratch_buffer(name, content)` for plugins
+  - Opens in horizontal split window
+  - Ideal for displaying test results, linter output, etc.
+- Readonly buffer protection:
+  - `buffer.readonly` flag to mark buffers as read-only
+  - Edit commands (`i`, `a`, `o`, `O`, `x`, `d`, `c`, `p`, `P`) blocked with error message
+  - `:w` and `:wq` commands blocked on readonly buffers
+  - Navigation and yank operations still allowed
+- Command-line completion (real-time popup):
+  - Auto-completion popup appears as you type in command mode
+  - Command name completion for all Ex commands (`:w`, `:q`, `:tabnew`, etc.)
+  - File path completion for file commands (`:e`, `:w`, `:sp`, `:vs`, `:tabnew`)
+  - Tab to cycle forward through candidates and apply selection
+  - Shift+Tab to cycle backward through candidates
+  - Popup displays up to 10 candidates with scroll support
+  - Completion styles configurable in all 8 themes (`completion_popup`, `completion_popup_selected`)
+- Syntax highlighting for Ruby and C:
+  - Token-based lexer architecture with extensible base class
+  - Ruby lexer with support for: keywords, strings, comments, numbers, symbols, constants, instance variables (`@foo`, `@@bar`), global variables (`$stdout`), method calls (`.to_i`, `.each`)
+  - C lexer with support for: keywords, strings, char literals, comments, numbers, preprocessor directives
+  - Multiline comment support: Ruby `=begin`/`=end`, C `/* */`
+  - Line-based token caching for performance
+  - Language auto-detection from file extension (`.rb`, `.rake`, `.gemspec`, `.c`, `.h`, `.y`)
+  - Syntax colors defined for all 8 built-in themes
+  - Configurable via `set :syntax, true/false` in `.muirc`
+- Tab page functionality (Vim-compatible):
+  - Tab > Window hierarchy: each tab contains independent window layout
+  - `:tabnew` / `:tabe` / `:tabedit` to create new tab
+  - `:tabclose` / `:tabc` to close current tab
+  - `:tabnext` / `:tabn` to go to next tab
+  - `:tabprev` / `:tabp` to go to previous tab
+  - `:tabfirst` / `:tabf` to go to first tab
+  - `:tablast` / `:tabl` to go to last tab
+  - `:Ntabn` / `:tabnext N` to go to specific tab (1-indexed)
+  - `:tabmove N` / `:tabm N` to move current tab to position N
+  - `gt` to go to next tab (wraps around)
+  - `gT` to go to previous tab (wraps around)
+  - Tab bar at top of screen with separator line
+  - Tab bar colors configurable via color scheme (`tab_bar`, `tab_bar_active`)
+  - `:q` closes window → tab → editor (Vim-like behavior)
+- Window split functionality:
+  - `:sp` / `:split` to split window horizontally (top/bottom)
+  - `:vs` / `:vsplit` to split window vertically (left/right)
+  - `:sp <filename>` / `:vs <filename>` to split and open file
+  - `Ctrl-w h/j/k/l` to navigate between split windows
+  - `Ctrl-w w` to cycle to next window
+  - `Ctrl-w c` / `:close` to close current window
+  - `Ctrl-w o` / `:only` to close all windows except current
+  - `:q` / `:wq` / `:q!` in split window closes only that window (Vim-compatible)
+  - `:e <filename>` opens file in current window only (doesn't affect other split windows)
+  - Separator lines between windows with configurable colors
+  - Command line area with configurable background color (no terminal transparency)
+  - Each window has independent cursor position, scroll state, and buffer
+- Japanese and multibyte character input support:
+  - Full UTF-8 input handling in Insert mode via IME
+  - Proper display width calculation for CJK characters (East Asian Width)
+  - Cursor position correctly accounts for double-width characters
+  - UTF-8 byte sequence assembly in terminal adapter
+- Plugin system:
+  - `Mui.use "gem_name"` to declare plugin gems
+  - Lazy gem installation via `bundler/inline` on editor startup
+  - Class-based plugins: `class MyPlugin < Mui::Plugin`
+  - DSL-based plugins: `Mui.define_plugin(:name) { ... }`
+  - Plugin API: `command`, `keymap`, `autocmd`
+  - Plugin dependencies with topological sort for load order
+  - CommandContext for plugin access to editor internals
+- Autocmd event system:
+  - 14 events: BufEnter, BufLeave, BufWrite, BufWritePre, BufWritePost, ModeChanged, CursorMoved, TextChanged, InsertEnter, InsertLeave, JobStarted, JobCompleted, JobFailed, JobCancelled
+  - Pattern matching for file paths (e.g., `"*.rb"`)
+  - `Mui.autocmd :BufEnter, pattern: "*.rb" do |ctx| ... end`
+- Custom commands:
+  - `Mui.command :name do |ctx| ... end`
+  - Execute via `:name` in command mode
+- Custom keymaps:
+  - `Mui.keymap :normal, "key" do |ctx| ... end`
+  - Per-mode key bindings
+- Configuration file support:
+  - `~/.muirc` for global settings
+  - `.lmuirc` for local (per-project) settings
+  - Local settings override global settings
+  - Ruby DSL format: `Mui.set :colorscheme, "theme_name"`
+- Color scheme system:
+  - 256-color terminal support
+  - Built-in themes: `mui` (default), `solarized_dark`, `solarized_light`, `monokai`, `nord`, `gruvbox_dark`, `dracula`, `tokyo_night`
+  - Customizable UI elements: normal text, status line, search highlight, visual selection, line numbers, messages
+- Search functionality:
+  - `/` to search forward (supports regular expressions)
+  - `?` to search backward (supports regular expressions)
+  - `n` to jump to next match (respects search direction)
+  - `N` to jump to previous match (reverses search direction)
+  - Wrap-around search (continues from beginning/end of file)
+  - Search match highlighting across visible lines
+- Undo/Redo functionality:
+  - `u` to undo last change
+  - `Ctrl-r` to redo undone change
+  - Vim-compatible undo granularity: Insert mode session as single undo unit
+  - Support for all editing operations (insert, delete, change, visual mode operations)
+  - Maximum 1000 undo history entries
+- Vim-compatible named registers:
+  - Named registers (`"a` - `"z`): 26 user-specified registers
+  - Unnamed register (`""`): Default register
+  - Yank register (`"0`): Stores last yank, not affected by delete
+  - Delete history registers (`"1` - `"9`): Stores delete history, shifts on each delete
+  - Black hole register (`"_`): Discards content without saving
+  - Usage: `"ayy` (yank to register a), `"ap` (paste from register a)
+- Delete/change operators now save to registers (Vim-compatible behavior):
+  - `dd`, `dw`, etc. save deleted text to unnamed register and delete history
+  - `cc`, `cw`, etc. save changed text to unnamed register and delete history
+  - Visual mode `d`/`c` also save to registers
+- Yank operator (`y`):
+  - `yy` to yank current line
+  - `y` + motion: `yw`, `ye`, `yb`, `y0`, `y$`, `ygg`, `yG`
+  - `yf{char}`, `yt{char}`, `yF{char}`, `yT{char}` to yank to/till character
+  - `y` in Visual mode to yank selection (character-wise and line-wise)
+  - `yw` behaves like `ye` (yanks to end of word) matching Vim behavior
+- Paste commands:
+  - `p` to paste after cursor (character-wise) or below current line (line-wise)
+  - `P` to paste before cursor (character-wise) or above current line (line-wise)
+  - Multi-line character-wise paste support
+- Register system for yank/paste operations
+  - Default register for storing yanked text
+  - Named registers support
+  - Linewise flag to distinguish line-wise vs character-wise yanks
+- TerminalAdapter abstraction layer for custom terminal implementations
+  - `Mui::TerminalAdapter::Base` abstract base class defining the terminal interface
+  - `Mui::TerminalAdapter::Curses` default implementation using Curses library
+  - Users can create custom adapters by subclassing `Base` and passing to `Editor.new(adapter:)`
+  - Example: `Mui::Editor.new(file_path, adapter: MyCustomAdapter.new)`
+- Initial release of Mui, a Vim-like text editor written in Ruby
+- Vim-like modal editing with five modes:
+  - Normal mode: Navigation and text manipulation
+  - Insert mode: Text input
+  - Command mode: Ex commands
+  - Visual mode (`v`): Character-wise selection
+  - Visual Line mode (`V`): Line-wise selection
+- Basic cursor movement with `h`, `j`, `k`, `l` and arrow keys in Normal mode
+- Arrow key cursor movement in Insert mode
+- Motion commands:
+  - Word movements: `w` (word forward), `b` (word backward), `e` (word end)
+  - Line movements: `0` (line start), `^` (first non-blank), `$` (line end)
+  - File movements: `gg` (file start), `G` (file end)
+  - Character search: `f{char}`, `F{char}`, `t{char}`, `T{char}`
+- Text editing operations:
+  - `i` to insert before cursor
+  - `a` to append after cursor
+  - `o` to open new line below
+  - `O` to open new line above
+  - `x` to delete character at cursor
+  - Backspace to delete and join lines
+- Delete operator (`d`):
+  - `dd` to delete current line
+  - `d` + motion: `dw`, `de`, `db`, `d0`, `d$`, `dgg`, `dG`
+  - `df{char}`, `dt{char}`, `dF{char}`, `dT{char}` to delete to/till character
+  - `d` in Visual mode to delete selection (character-wise and line-wise)
+- Change operator (`c`):
+  - `cc` to change current line (clear and enter Insert mode)
+  - `c` + motion: `cw`, `ce`, `cb`, `c0`, `c$`, `cgg`, `cG`
+  - `cf{char}`, `ct{char}`, `cF{char}`, `cT{char}` to change to/till character
+  - `c` in Visual mode to change selection (character-wise and line-wise)
+  - `cw` behaves like `ce` (changes to end of word, preserving space) matching Vim behavior
+- Ex commands:
+  - `:w` to save file
+  - `:w <filename>` to save as
+  - `:q` to quit (with unsaved changes protection)
+  - `:q!` to force quit
+  - `:wq` to save and quit
+  - `:e` to reload current file
+  - `:e <filename>` to open file (Vim-compatible: non-existent files open as new buffer)
+  - `:{number}` to jump to specific line (e.g., `:10` jumps to line 10)
+    - Line numbers are 1-indexed (`:1` = first line)
+    - Out-of-range values are clamped (`:0` → first line, `:999` on 100-line file → last line)
+    - Cursor moves to beginning of line (column 0)
+- Curses-based terminal UI with:
+  - Buffer management
+  - Window with scrolling support
+  - Status line display
+  - Command line input
+- Visual mode features:
+  - Selection highlighting with reverse video
+  - Toggle between Visual and Visual Line mode with `v`/`V`
+  - All motion commands supported (h, j, k, l, w, b, e, 0, ^, $, gg, G, f, F, t, T)
+  - Exit to Normal mode with `Esc`
+- Comprehensive test suite for `Mui::Input` and `Mui::Editor` classes
+  - Unit tests for Buffer, CommandLine, Input, Screen, Window, Selection, and Editor modes
+  - Integration tests for component interactions
+  - E2E tests with ScriptRunner DSL for Vim operation scenarios including Visual mode
+- Test infrastructure with Curses mock and `MuiTestHelper` module
+
+### Changed
+- Reorganized test directory structure to follow standard gem conventions
+  - Unit tests moved to `test/mui/`
+  - Editor mode tests in `test/mui/editor/`
+  - Integration tests in `test/integration/`
+  - E2E tests in `test/e2e/`
+- Refactored test files to use nested classes per method for better readability
+- Improved syntax highlighting performance:
+  - Use `\G` anchor for position-specific regex matching to avoid substring allocation
+  - Pre-compile all regex patterns as class-level constants for one-time compilation at class load
+  - Optimize event sorting in line renderer using array tuples instead of hash arrays
+  - Add style resolution cache to avoid repeated hash merges
+  - Reduce hash lookups in token cache by inlining cache validation
+- Improved buffer change detection performance:
+  - Added `Buffer#change_count` for O(1) change detection
+  - Replaced `buffer.lines.hash` (O(n)) with counter comparison in `TextChanged` event trigger
+- Improved buffer word completion performance:
+  - Use `String#scan` with regex for fast word extraction instead of character-by-character iteration
+  - Direct ASCII code comparison for word character detection instead of regex match per character
+
+### Fixed
+- Command-line completion Tab behavior:
+  - First Tab now confirms current selection without cycling to next candidate
+  - Second Tab and subsequent presses cycle through candidates
+  - Previously, first Tab would skip the initially displayed candidate
+- Command-line completion cursor position:
+  - Cursor now moves to end of buffer after applying completion
+  - Previously, cursor remained at old position after completion
+- Plugin keymap handler now correctly uses active window's buffer instead of initial buffer
+  - Fixes issue where buffer-specific keymaps didn't work in split windows
+- Plugin keymap handler now properly returns handler result
+  - Allows buffer-specific keymaps to conditionally pass through to built-in handlers
+- Plugin keymap now correctly handles Enter key (Curses::KEY_ENTER)
+  - Previously special key codes like Curses::KEY_ENTER (343) were not converted to keymap string
+  - Now Enter key variants (CR, LF, KEY_ENTER) are all mapped to `"\r"` for plugin keymaps
+- Auto-indent on newline in Insert mode
+  - Pressing Enter preserves indentation from the current line
+  - Leading whitespace (spaces and tabs) is automatically inserted on the new line
+  - Whitespace-only lines are cleared when pressing Escape (Vim behavior)
+- Register is now shared globally across tabs and split windows
+  - Yank in one tab/window can be pasted in another
+  - Previously each ModeManager had its own Register instance
+- Visual mode operations now correctly use the active window's buffer
+  - Fixed yank/delete/change/indent operations using stale buffer reference after tab or window switch
+  - Operations now properly target the current active window's buffer
+- Command mode cursor movement with arrow keys
+  - Left/Right arrow keys now move cursor within command line
+  - Previously arrow keys were interpreted as characters (e.g., Left inserted 'a')
+  - Backspace now deletes character before cursor position
+  - Character input now inserts at cursor position
+- Empty command (`:` then Enter) no longer crashes
+  - Previously caused error when trying to look up empty string as plugin command
+- Buffer word completion now works correctly after opening files with `:e` or `:tabe`
+  - `InsertMode` now uses active window's buffer for `BufferWordCache` instead of initial buffer
+  - Previously, completion would use stale buffer reference after switching files
+
 ## [0.1.0] - 2025-11-30
 
 - Initial release

data/exe/mui

@@ -3,5 +3,4 @@
 
 require "mui"
 
-puts "Mui v#{Mui::VERSION} - A Vim-like TUI editor written in Ruby"
-puts "Coming soon..."
+Mui::Editor.new(ARGV[0]).run

data/lib/mui/autocmd.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Mui
+  # Event-driven hook system for plugins
+  class Autocmd
+    EVENTS = %i[
+      BufEnter
+      BufLeave
+      BufWrite
+      BufWritePre
+      BufWritePost
+      ModeChanged
+      CursorMoved
+      TextChanged
+      InsertEnter
+      InsertLeave
+      InsertCompletion
+      JobStarted
+      JobCompleted
+      JobFailed
+      JobCancelled
+    ].freeze
+
+    def initialize
+      @handlers = {}
+      EVENTS.each { |e| @handlers[e] = [] }
+    end
+
+    def register(event, pattern: nil, &block)
+      event = event.to_sym
+      raise ArgumentError, "Unknown event: #{event}" unless EVENTS.include?(event)
+
+      @handlers[event] << { pattern:, handler: block }
+    end
+
+    def trigger(event, context = nil, **kwargs)
+      event = event.to_sym
+      return unless @handlers[event]
+
+      @handlers[event].each do |entry|
+        # Skip pattern matching for non-buffer events (like Job events)
+        next if context && entry[:pattern] && !match_pattern?(context, entry[:pattern])
+
+        # Pass context or kwargs depending on what's available
+        entry[:handler].call(context || kwargs)
+      end
+    end
+
+    private
+
+    def match_pattern?(context, pattern)
+      return true unless pattern
+
+      file_path = context.buffer.file_path
+
+      case pattern
+      when Regexp
+        file_path&.match?(pattern)
+      when String
+        File.fnmatch(pattern, file_path || "")
+      else
+        false
+      end
+    end
+  end
+end