Lumacs

Lumacs

A modern text editor in C++20, inspired by Emacs with powerful Lua scripting support.

Features

✅ Implemented (Phase 4 Complete - 95% Emacs Compatibility)

• Core Editing: Kill ring, mark/region, undo/redo
• Buffer Management: Multiple buffers, window splits
  
• Advanced Features: Registers, keyboard macros, rectangles, minibuffer history
• Search: Incremental search with highlighting
• Theme System: Dracula, Everforest, and default themes with proper background colors
• Per-Window Modelines: Configurable status bars for each buffer
• Lua Scripting: Extensive Lua API for customization

🔄 Planned

• Language modes (Python, C++, JavaScript)
• Plugin system expansion
• Performance optimizations

Tech Stack

• Core: C++20 with modern idioms and ncurses
• Scripting: Lua 5.4 + sol2 bindings
• Build: CMake 3.20+
• Themes: RGB color support with fallbacks

Quick Start

Building

./scripts/build.sh

Running

./build/lumacs [file]

Key Bindings

• Theme Switching: C-x t v (Dracula), C-x t e (Everforest), C-x t d (Default)
• Window Splits: C-x 2 (horizontal), C-x 3 (vertical), C-x 0 (close)
• Buffers: C-x b (switch), C-x k (kill), C-x C-b (list)
• Advanced: F3/F4 (macros), C-x r s/i (registers), C-x r k/y/t (rectangles)

Manual Build

mkdir build && cd build
cmake ..
cmake --build .

With Nix

nix-shell
./scripts/build.sh

Project Structure

lumacs/
├── src/                    # Core implementation
│   ├── main_ncurses.cpp   # ncurses frontend
│   ├── editor_core.cpp    # Editor engine
│   ├── theme.cpp          # Theme system
│   └── lua_api.cpp        # Lua scripting API
├── include/lumacs/         # Public headers
│   ├── editor_core.hpp    # Editor core interface
│   ├── theme.hpp          # Theme system
│   └── lua_api.hpp        # Lua API headers
├── tests/                  # Unit tests
├── scripts/                # Build and utility scripts
├── examples/               # Test files and examples
├── documentation/          # Detailed documentation
├── init.lua               # Main configuration
├── themes.lua             # Theme definitions
└── CMakeLists.txt         # Build configuration

Development

Current Status: Phase 5 In Progress - Face System & Minibuffer

The project uses modern C++ practices:

• RAII for resource management
  
• Smart pointers for ownership
• std::optional for fallible operations
• Modern C++20 features
• Decoupled UI architecture (IEditorView)

Testing

./scripts/test.sh

Customization

• Edit init.lua for keybindings and configuration
• Edit themes.lua for theme customization
• Add new themes in src/theme.cpp

Documentation

• README.md - This file
• CONTINUATION_PROMPT.md - Development continuation guide
• documentation/ - Detailed feature documentation
• examples/ - Test files and usage examples

License

TBD