raxol

## [0.4.2] - 2025-06-11

### Added

- **Terminal Buffer Management Refactoring:**

  - Split `manager.ex` into specialized modules:
    - `State` - Buffer initialization and state management
    - `Cursor` - Cursor position and movement
    - `Damage` - Damaged regions tracking
    - `Memory` - Memory usage and limits
    - `Scrollback` - Scrollback buffer operations
    - `Buffer` - Buffer operations and synchronization
    - `Manager` - Main facade coordination
  - Improved code organization and maintainability
  - Enhanced test coverage
  - Better error handling
  - Clearer interfaces

- **Plugin System Improvements:**

  - Implemented Tarjan's algorithm for dependency resolution
  - Enhanced version constraint handling
  - Added detailed dependency chain reporting
  - Improved error handling and diagnostics
  - Optimized dependency graph operations

- **Component System Enhancements:**

  - Harmonized API for all input components
  - Improved theme and style prop support
  - Enhanced lifecycle hooks
  - Better accessibility integration
  - Comprehensive test coverage

- **Performance Infrastructure:**

  - New `Raxol.Test.PerformanceHelper` module
  - Performance test suite for terminal manager
  - Event processing benchmarks
  - Screen update benchmarks
  - Concurrent operation benchmarks

- **Documentation Improvements:**
  - Completed comprehensive guides
  - Enhanced API documentation
  - Improved architecture documentation
  - Added migration guide
  - Updated component documentation

### Changed

- **Test Infrastructure:**

  - Replaced `Process.sleep` with event-based synchronization
  - Enhanced plugin test fixtures
  - Improved error handling
  - Better resource cleanup
  - Clear test boundaries

- **Terminal Command Handling:**

  - Standardized error/result tuples
  - Improved error propagation
  - Enhanced command handler organization
  - Better test coverage

- **Component System:**
  - Migrated to `Raxol.UI.Components` namespace
  - Improved theme handling
  - Enhanced style prop support
  - Better lifecycle management

### Deprecated

- Old event system
- Legacy rendering approach
- Previous styling methods
- `Raxol.Terminal.CommandHistory` (Use `Raxol.Terminal.Commands.History` instead)

### Removed

- Redundant `Raxol.Core.Runtime.Plugins.Commands` GenServer
- Redundant clipboard modules
- `Raxol.UI.Components.ScreenModes` module
- Direct `:meck` usage from test files

### Fixed

- **SelectList Mouse Focus Bug:**

  - Fixed focus update on mouse clicks
  - Improved test coverage
  - Enhanced mouse interaction handling

- **Accessibility Tests:**

  - Fixed color suggestion tests
  - Improved test reliability
  - Enhanced accessibility coverage

- **Test Suite:**
  - Resolved compilation errors
  - Fixed helper function scoping
  - Improved test organization

### Next Focus

1. Address remaining test failures
2. Complete OSC 4 handler implementation
3. Implement robust anchor checking
4. Document test writing guide
5. Continue code quality improvements

## [0.4.0] - 2025-05-10

### Added

- Initial public release
- Core terminal functionality
- Basic component system
- Plugin architecture
- Testing infrastructure

## [0.5.0] - 2025-06-12

### Added

- **Progress Component:**

  - New `Raxol.UI.Components.Progress` module with multiple progress indicators:
    - Progress bars with customizable styles and labels
    - Spinner animations with multiple animation types
    - Indeterminate progress bars
    - Circular progress indicators
  - Comprehensive test coverage for all progress variants
  - Full documentation with examples and usage guidelines

- **Documentation Overhaul:**

  - Major updates to all component documentation in `docs/components/`
  - Improved structure, navigation, and cross-references
  - Added mermaid diagrams and comprehensive API references
  - Expanded best practices and common pitfalls sections

- **Test Suite Improvements:**

  - Enhanced test coverage and organization
  - Updated test fixtures and support files
  - Improved reliability and maintainability

- **Code Style and Formatting:**

  - Applied consistent formatting across all Elixir source files
  - Improved code readability and maintainability

- **Utility Scripts:**
  - Added scripts for code maintenance and consistency

### Changed

- Updated guides and general documentation for clarity and completeness
- Refined documentation links and fixed broken references

### Removed

- Obsolete migration and test consolidation guides

- **Native Dependency Management:**
  - Removed vendored `termbox2` C source from `lib/termbox2_nif/c_src/termbox2`
  - Now uses the official [termbox2](https://github.com/termbox/termbox2) as a git submodule
  - Developers must run `git submodule update --init --recursive` before building
  - Updated build and documentation to reflect this change

## [0.6.0] - 2025-01-27

### Added

- **Comprehensive Documentation Renderer:**

  - Markdown to HTML conversion with Earmark integration
  - Table of contents generation with anchor links
  - Search index creation with metadata extraction
  - Code block extraction and processing
  - Full documentation rendering with metadata and navigation
  - Graceful fallbacks when dependencies aren't available

- **Window Event Handling:**

  - Complete window event processing in terminal driver
  - Resize event handling with dimension updates
  - Title and icon name change processing
  - Proper logging and error handling for window events

- **Shared Helper Modules:**
  - `Raxol.Core.Runtime.ShutdownHelper` for graceful shutdown logic
  - `Raxol.Core.Runtime.GenServerStartupHelper` for startup patterns
  - `Raxol.Core.Runtime.ComponentStateHelper` for state management
  - `Raxol.Benchmarks.DataGenerator` for benchmark data generation
  - `Raxol.Core.StateManager` for shared state patterns
  - `Raxol.Terminal.Scroll.PatternAnalyzer` for scroll analysis
  - `Raxol.EmulatorPluginTestHelper` for test setup

### Changed

- **Major Code Quality Improvements:**

  - Eliminated all duplicate code across the codebase
  - Reduced software design suggestions from 44 to 0
  - Improved modularity and maintainability
  - Enhanced code organization and structure

- **Refactored Components:**

  - Removed duplicate character operations in favor of char_editor
  - Extracted shared event handling in button component
  - Unified scroll region logic into single helper
  - Delegated duplicate auth functions to public auth.ex
  - Removed embedded CharacterHandler in text_input
  - Created shared color parsing delegation
  - Unified component state update patterns

- **Test Suite Improvements:**
  - Created shared test helper for emulator plugin tests
  - Removed duplicate cursor manager tests
  - Eliminated duplicate notification plugin test file
  - Improved test organization and maintainability

### Removed

- **Legacy and Duplicate Modules:**
  - `lib/raxol/terminal/input_manager.ex` (legacy version)
  - `lib/raxol/core/cache/unified_cache.ex` (duplicate of system cache)
  - `lib/raxol/terminal/buffer/char_operations.ex` (duplicate functionality)
  - `test/raxol/plugins/notification_plugin_test.exs` (duplicate of core version)
  - `test/raxol/terminal/cache/unified_cache_test.exs` (duplicate tests)

### Fixed

- **All TODO Items:**
  - Implemented window resize processing
  - Implemented window event handling
  - Implemented comprehensive documentation renderer functionality
  - No more TODO comments in the codebase

## [0.5.2] - 2025-01-27

### Added

- **Enhanced Demo Runner:**

  - **Command Line Interface**: Added comprehensive command line argument support to `scripts/bin/demo.exs`
    - `--list`: List all available demos with descriptions
    - `--help`: Show detailed usage information and examples
    - `--version`: Display version information
    - `--info DEMO`: Show detailed information about a specific demo
    - `--search TERM`: Search demos by name or description
    - Direct demo execution: `mix run bin/demo.exs form`
  - **Interactive Menu Improvements**:
    - Categorized demo display (Basic Examples, Advanced Features, Showcases, WIP)
    - Enhanced navigation with keyboard shortcuts
    - Better error handling and user feedback
    - Similar demo suggestions for typos
  - **Auto-discovery**: Automatic detection of available demo modules in `Raxol.Examples` namespace
  - **Error Handling**: Robust validation and error reporting for demo modules
  - **Performance Monitoring**: Demo execution timing and monitoring capabilities
  - **Configuration Support**: Optional configuration file support for customizing demo behavior

- **Documentation Updates**:
  - Updated README with comprehensive demo usage instructions
  - Added demo examples to Quick Start guide
  - Enhanced documentation with interactive demo capabilities

### Changed

- **Demo Script Architecture**:
  - Refactored `scripts/bin/demo.exs` for better maintainability
  - Improved code organization with dedicated modules
  - Enhanced user experience with better feedback and error handling

### Fixed

- **Demo Discovery**: Resolved issues with demo module loading and validation
- **User Experience**: Improved error messages and help text clarity

### Next Focus

1. Continue enhancing demo system with additional features
2. Add more comprehensive demo examples
3. Implement demo recording and playback capabilities
4. Enhance configuration and customization options

## [0.5.1] - 2025-01-27

### Added

- **Terminal System Major Enhancements:**

  - Comprehensive refactoring of terminal buffer, ANSI, plugin, and rendering subsystems
  - Enhanced ANSI state machine with improved escape sequence handling
  - Better sixel graphics support and parsing
  - Improved mouse tracking and window manipulation
  - Enhanced buffer management with unified operations
  - Better character handling and clipboard integration
  - Comprehensive test coverage for all terminal subsystems

- **Core System Improvements:**

  - Enhanced metrics aggregation and visualization
  - Improved performance monitoring and system utilities
  - Better UX refinement with accessibility integration
  - Enhanced color system and theme management
  - Improved application lifecycle management

- **UI Component Updates:**

  - Updated base component lifecycle management
  - Enhanced input field components (multi-line, password, select)
  - Improved progress spinner and layout engine
  - Better rendering pipeline and container management
  - Enhanced test coverage for UI components

- **Testing Infrastructure:**

  - Expanded test suite with improved coverage
  - Enhanced test fixtures and support scripts
  - Better plugin test organization and reliability
  - Improved mock implementations and test helpers
  - Added comprehensive test documentation

- **Documentation and Configuration:**
  - Added compilation error plan and critical fixes reference
  - Enhanced plugin test backups and documentation
  - Updated configuration and application startup
  - Improved plugin events and metrics collector
  - Better script organization and maintenance

### Changed

- **Code Quality:**

  - Applied consistent formatting across all Elixir source files
  - Improved code readability and maintainability
  - Enhanced error handling and validation
  - Better separation of concerns in terminal subsystems
  - Standardized API patterns across components

- **Performance:**
  - Optimized terminal operations and buffer management
  - Improved rendering pipeline efficiency
  - Enhanced memory management and resource cleanup
  - Better concurrent operation handling

### Fixed

- **Terminal Operations:**

  - Fixed ANSI sequence parsing edge cases
  - Improved buffer scroll region handling
  - Enhanced cursor positioning accuracy
  - Better window state management
  - Fixed sixel graphics rendering issues

- **Test Reliability:**
  - Resolved test compilation errors
  - Fixed mock implementation inconsistencies
  - Improved test isolation and cleanup
  - Enhanced test data management

### Removed

- Obsolete UI component files
- Redundant test fixtures
- Unused configuration options

## [0.5.2] - 2025-01-27

### Added

- **Enhanced Buffer Manager Compression:**

  - Implemented comprehensive buffer compression in `Raxol.Terminal.Buffer.EnhancedManager`
  - Added multiple compression algorithms:
    - Simple compression for empty cell optimization
    - Run-length encoding for repeated characters
    - LZ4 compression support (framework ready)
  - Threshold-based compression activation
  - Style attribute minimization to reduce memory usage
  - Performance metrics tracking for compression operations
  - Automatic compression state updates and optimization

- **Buffer Compression Features:**

  - Cell-level compression with empty cell detection
  - Style attribute optimization (removes default attributes)
  - Run-length encoding for identical consecutive cells
  - Configurable compression thresholds and algorithms
  - Memory usage estimation and monitoring
  - Compression ratio tracking and statistics

### Changed

- **Buffer Management:**
  - Enhanced memory efficiency through intelligent compression
  - Improved performance monitoring for buffer operations
  - Better memory usage optimization strategies

### Fixed

- **Code Quality:**
  - Resolved TODO items in buffer compression implementation
  - Improved code maintainability and documentation

## [0.5.3] - 2025-01-27

### Fixed

- **Enhanced Buffer Manager:**
  - Implemented buffer eviction logic in `Raxol.Terminal.Buffer.EnhancedManager`
  - Added automatic pool size management to prevent memory overflow
  - Resolved TODO item for buffer eviction implementation
  - Improved memory management efficiency