watchdiff-tui 0.2.0

A high-performance file watcher with beautiful TUI showing real-time diffs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

fn main() -> anyhow::Result<()> {
    println!("🎯 WatchDiff Vim Mode Demo");
    println!("==========================\n");
    
    // Show vim mode features
    demonstrate_vim_features();
    
    // Show example usage
    demonstrate_usage_example();
    
    Ok(())
}

fn demonstrate_vim_features() {
    println!("⌨️  Vim Mode Features:");
    println!("----------------------");
    
    println!("🔄 Mode Toggle:");
    println!("  • ESC: Enable vim mode");
    println!("  • i:   Disable vim mode");
    println!();
    
    println!("🧭 Basic Navigation:");
    println!("  • h: Move left (file list scroll)");
    println!("  • j: Move down (diff scroll down)");
    println!("  • k: Move up (diff scroll up)");
    println!("  • l: Move right (file list scroll)");
    println!();
    
    println!("🚀 Advanced Navigation:");
    println!("  • gg: Go to top of diff");
    println!("  • G:  Go to bottom of diff");
    println!("  • w:  Jump forward 5 lines");
    println!("  • b:  Jump backward 5 lines");
    println!("  • 0:  Go to leftmost position");
    println!("  • $:  Go to rightmost position");
    println!();
    
    println!("📄 Page Navigation:");
    println!("  • Ctrl+d: Half page down");
    println!("  • Ctrl+u: Half page up");
    println!("  • Ctrl+f: Full page down");
    println!("  • Ctrl+b: Full page up");
    println!();
    
    println!("💡 UI Features:");
    println!("  • Yellow 'VIM' indicator when active");
    println!("  • Key sequence display (e.g., 'g' while typing 'gg')");
    println!("  • Context-sensitive help text");
    println!("  • Comprehensive help screen (press 'h')");
    println!();
    
    println!("🎯 Usage Example:");
    println!("  1. Run: watchdiff-tui /path/to/project");
    println!("  2. Press ESC to enable vim mode");
    println!("  3. Use hjkl to navigate");
    println!("  4. Type 'gg' to go to top");
    println!("  5. Type 'G' to go to bottom");
    println!("  6. Press 'i' to return to normal mode");
    println!();
    
    println!("✨ Benefits:");
    println!("  • Familiar vim keybindings for vim users");
    println!("  • Faster navigation than arrow keys");
    println!("  • Multi-key command sequences");
    println!("  • Visual feedback and mode awareness");
    println!("  • Seamless integration with existing features");
}

fn demonstrate_usage_example() {
    println!("📖 Interactive Demo:");
    println!("--------------------");
    println!();
    println!("To try vim mode in WatchDiff:");
    println!();
    println!("1. Start WatchDiff:");
    println!("   $ watchdiff-tui /path/to/your/project");
    println!();
    println!("2. You'll see the TUI with status showing:");
    println!("   [ESC for vim mode]");
    println!();
    println!("3. Press ESC to enable vim mode:");
    println!("   Status changes to: [VIM] mode active");
    println!();
    println!("4. Try vim navigation:");
    println!("   • j/k to scroll through diffs");
    println!("   • gg to jump to top");
    println!("   • G to jump to bottom");
    println!("   • h/l to scroll file list");
    println!();
    println!("5. Press 'i' to exit vim mode");
    println!("6. Press 'h' for complete help screen");
    println!();
    println!("🎮 Multi-key sequences work just like vim:");
    println!("   • Type 'g' then 'g' quickly for 'gg' command");
    println!("   • Status shows partial sequences as you type");
    println!("   • Sequences timeout after 1 second if incomplete");
    println!();
    println!("🔧 Implementation highlights:");
    println!("   • Stateful key sequence detection");
    println!("   • Mode-aware UI indicators");
    println!("   • Seamless integration with existing navigation");
    println!("   • Comprehensive vim movement set");
}

// Note: This is a demonstration script explaining the vim mode functionality
// The actual vim mode is implemented in src/ui/tui.rs and integrated into the TUI