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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
use hjkl_buffer::Buffer;
use hjkl_engine::{Editor, Host, Options};
use std::path::PathBuf;
use super::{App, DiskState, STATUS_LINE_HEIGHT};
use crate::host::TuiHost;
impl App {
/// Switch the focused window to display slot `idx` and refresh its
/// viewport spans. Records the previous slot index in `prev_active`
/// for alt-buffer (`<C-^>` / `:b#`).
pub(crate) fn switch_to(&mut self, idx: usize) {
let current_slot = self.focused_slot_idx();
if idx != current_slot {
self.prev_active = Some(current_slot);
// Carry the register bank across slots so vim's yank/paste
// works cross-buffer (`yy` in slot 0, `p` in slot 1).
let regs = self.slots[current_slot].editor.registers().clone();
*self.slots[idx].editor.registers_mut() = regs;
}
// Point the focused window at the new slot.
let fw = self.focused_window();
self.windows[fw].as_mut().expect("focused_window open").slot = idx;
if let Ok(size) = crossterm::terminal::size() {
let vp = self.active_mut().editor.host_mut().viewport_mut();
vp.width = size.0;
vp.height = size.1.saturating_sub(STATUS_LINE_HEIGHT);
}
let buffer_id = self.active().buffer_id;
let (vp_top, vp_height) = {
let vp = self.active().editor.host().viewport();
(vp.top_row, vp.height as usize)
};
// T3/T4: Re-install cached spans from the last completed parse for
// this slot — gives the first frame after a buffer switch correct
// highlight colours while the fresh parse runs in the background.
// T4: Drop all three caches if the buffer's dirty_gen has advanced
// since they were computed (stale spans would show wrong highlights).
// Uses the merged install so top + bottom + viewport all contribute.
let cached_spans_installed = {
let current_dg = self.slots[idx].editor.buffer().dirty_gen();
// Check staleness: if any cache exists, its dirty_gen key must match.
let any_stale = [
&self.slots[idx].viewport_render_output,
&self.slots[idx].top_render_output,
&self.slots[idx].bottom_render_output,
]
.iter()
.any(|c| c.as_ref().is_some_and(|o| o.key.0 != current_dg));
if any_stale {
self.slots[idx].viewport_render_output = None;
self.slots[idx].top_render_output = None;
self.slots[idx].bottom_render_output = None;
false
} else {
let has_any = self.slots[idx].viewport_render_output.is_some()
|| self.slots[idx].top_render_output.is_some()
|| self.slots[idx].bottom_render_output.is_some();
if has_any {
// Install the diag signs from the viewport cache (most recent live parse).
if let Some(ref vp) = self.slots[idx].viewport_render_output {
let signs = vp.signs.clone();
self.slots[idx].diag_signs = signs;
}
self.install_merged_spans_for_slot(idx);
}
has_any
}
};
// Fall back to the cheap preview render when no valid cache.
if !cached_spans_installed
&& let Some(out) = self.syntax.preview_render(
buffer_id,
self.active().editor.buffer(),
vp_top,
vp_height,
)
{
self.active_mut()
.editor
.install_ratatui_syntax_spans(out.spans);
}
self.active_mut().last_recompute_key = None;
self.recompute_and_install();
self.refresh_git_signs_force();
}
/// `:bnext` — cycle active forward. No-op when only one slot.
pub(crate) fn buffer_next(&mut self) {
if !self.require_multi_buffer() {
return;
}
let next = (self.focused_slot_idx() + 1) % self.slots.len();
self.switch_to(next);
}
/// `:bprev` — cycle active backward. No-op when only one slot.
pub(crate) fn buffer_prev(&mut self) {
if !self.require_multi_buffer() {
return;
}
let prev = (self.focused_slot_idx() + self.slots.len() - 1) % self.slots.len();
self.switch_to(prev);
}
/// `<C-^>` / `:b#` — switch to the previously-active buffer slot.
pub(crate) fn buffer_alt(&mut self) {
if !self.require_multi_buffer() {
return;
}
match self.prev_active {
Some(i) if i < self.slots.len() => {
self.switch_to(i);
}
_ => {
self.bus.warn("no alternate buffer");
}
}
}
/// `:bdelete[!]` — close the active slot. With more than one slot
/// open the slot is removed; on the last slot the buffer is reset
/// to an empty unnamed scratch buffer (vim parity for `:bd` on the
/// only buffer leaving an empty editor instead of quitting).
pub(crate) fn buffer_delete(&mut self, force: bool) {
if !force && self.active().dirty {
self.bus
.error("E89: No write since last change (add ! to override)");
return;
}
let active_slot = self.focused_slot_idx();
if self.slots.len() == 1 {
self.lsp_detach_buffer(active_slot);
let old_id = self.active().buffer_id;
self.syntax.forget(old_id);
let new_id = self.next_buffer_id;
self.next_buffer_id += 1;
let host = TuiHost::new();
let mut editor = Editor::new(Buffer::new(), host, Options::default());
if let Ok(size) = crossterm::terminal::size() {
let vp = editor.host_mut().viewport_mut();
vp.width = size.0;
vp.height = size.1.saturating_sub(STATUS_LINE_HEIGHT);
}
let _ = editor.take_content_edits();
let _ = editor.take_content_reset();
let slot = &mut self.slots[0];
slot.buffer_id = new_id;
slot.editor = editor;
slot.filename = None;
slot.dirty = false;
slot.is_new_file = false;
slot.is_untracked = false;
slot.diag_signs.clear();
slot.git_signs.clear();
slot.last_git_dirty_gen = None;
slot.last_recompute_key = None;
slot.viewport_render_output = None;
slot.top_render_output = None;
slot.bottom_render_output = None;
slot.saved_hash = 0;
slot.saved_len = 0;
slot.disk_mtime = None;
slot.disk_len = None;
slot.disk_state = DiskState::Synced;
slot.snapshot_saved();
// Keep all windows pointing at slot 0 (the only one).
for win in self.windows.iter_mut().flatten() {
win.slot = 0;
}
self.bus.info("buffer closed (replaced with [No Name])");
return;
}
self.lsp_detach_buffer(active_slot);
let removed = self.slots.remove(active_slot);
self.syntax.forget(removed.buffer_id);
// Fix up all window slot pointers that reference the removed or shifted slots.
let slot_count = self.slots.len();
for win in self.windows.iter_mut().flatten() {
if win.slot == active_slot {
// Was pointing at the removed slot — redirect to slot before it (or 0).
win.slot = if active_slot > 0 { active_slot - 1 } else { 0 };
} else if win.slot > active_slot {
// Shift down due to the Vec::remove.
win.slot -= 1;
}
// Clamp to valid range just in case.
win.slot = win.slot.min(slot_count.saturating_sub(1));
}
let target = self.focused_slot_idx();
self.switch_to(target);
// Clear alt-buffer pointer after the switch: prev_active may refer
// to a removed or re-indexed slot. Reset unconditionally.
self.prev_active = None;
let name = removed
.filename
.as_ref()
.map(|p| p.display().to_string())
.unwrap_or_else(|| "[No Name]".into());
self.bus.info(format!("buffer closed: \"{name}\""));
}
/// `:bwipeout[!]` — completely remove the active buffer: drop marks,
/// jumplist entries, and all per-buffer cached state. With more than
/// one slot open the slot is removed (same mechanics as `buffer_delete`
/// since the slot — and its editor — vanish entirely). On the last
/// slot a fresh scratch buffer is installed and the old editor's marks
/// and jumplists are explicitly discarded before replacement, ensuring
/// no state leaks into the new session.
pub(crate) fn buffer_wipe(&mut self, force: bool) {
if !force && self.active().dirty {
self.bus
.error("E89: No write since last change (add ! to override)");
return;
}
let active_slot = self.focused_slot_idx();
if self.slots.len() == 1 {
// Explicitly wipe marks and jumplists before discarding the editor
// so no state leaks into the replacement scratch buffer.
{
let editor = &mut self.slots[0].editor;
let mark_chars: Vec<char> = editor.marks().map(|(c, _)| c).collect();
for c in mark_chars {
editor.clear_mark(c);
}
editor.jump_back_list_mut().clear();
editor.jump_fwd_list_mut().clear();
}
// Also clear LSP diagnostics for the wiped buffer.
{
let slot = &mut self.slots[0];
slot.lsp_diags.clear();
slot.diag_signs_lsp.clear();
}
self.lsp_detach_buffer(active_slot);
let old_id = self.active().buffer_id;
self.syntax.forget(old_id);
let new_id = self.next_buffer_id;
self.next_buffer_id += 1;
let host = TuiHost::new();
let mut editor = Editor::new(Buffer::new(), host, Options::default());
if let Ok(size) = crossterm::terminal::size() {
let vp = editor.host_mut().viewport_mut();
vp.width = size.0;
vp.height = size.1.saturating_sub(STATUS_LINE_HEIGHT);
}
let _ = editor.take_content_edits();
let _ = editor.take_content_reset();
let slot = &mut self.slots[0];
slot.buffer_id = new_id;
slot.editor = editor;
slot.filename = None;
slot.dirty = false;
slot.is_new_file = false;
slot.is_untracked = false;
slot.diag_signs.clear();
slot.git_signs.clear();
slot.last_git_dirty_gen = None;
slot.last_recompute_key = None;
slot.viewport_render_output = None;
slot.top_render_output = None;
slot.bottom_render_output = None;
slot.saved_hash = 0;
slot.saved_len = 0;
slot.disk_mtime = None;
slot.disk_len = None;
slot.disk_state = DiskState::Synced;
slot.snapshot_saved();
// Keep all windows pointing at slot 0 (the only one).
for win in self.windows.iter_mut().flatten() {
win.slot = 0;
}
self.bus.info("buffer wiped (replaced with [No Name])");
return;
}
// Multi-slot: removing the slot entirely discards the editor (and all
// its marks/jumps) — same mechanics as buffer_delete.
self.lsp_detach_buffer(active_slot);
let removed = self.slots.remove(active_slot);
self.syntax.forget(removed.buffer_id);
let slot_count = self.slots.len();
for win in self.windows.iter_mut().flatten() {
if win.slot == active_slot {
win.slot = if active_slot > 0 { active_slot - 1 } else { 0 };
} else if win.slot > active_slot {
win.slot -= 1;
}
win.slot = win.slot.min(slot_count.saturating_sub(1));
}
let target = self.focused_slot_idx();
self.switch_to(target);
self.prev_active = None;
let name = removed
.filename
.as_ref()
.map(|p| p.display().to_string())
.unwrap_or_else(|| "[No Name]".into());
self.bus.info(format!("buffer wiped: \"{name}\""));
}
/// Returns `true` when multiple slots are open; otherwise sets the
/// "only one buffer open" status message and returns `false`.
pub(crate) fn require_multi_buffer(&mut self) -> bool {
if self.slots.len() <= 1 {
self.bus.warn("only one buffer open");
return false;
}
true
}
/// `:ls` / `:buffers` — render the buffer list to a single status
/// line. Marks: `%` active, `+` modified.
pub(crate) fn list_buffers(&self) -> String {
let active_slot = self.focused_slot_idx();
let mut parts = Vec::with_capacity(self.slots.len());
for (i, slot) in self.slots.iter().enumerate() {
let active = if i == active_slot { '%' } else { ' ' };
let modf = if slot.dirty { '+' } else { ' ' };
let name = slot
.filename
.as_ref()
.map(|p| p.display().to_string())
.unwrap_or_else(|| "[No Name]".into());
parts.push(format!("{}:{active}{modf} \"{name}\"", i + 1));
}
parts.join(" | ")
}
/// Allocate a fresh `BufferId` and load `path` into a new slot.
/// Returns the index of the newly pushed slot (does NOT switch).
pub(crate) fn open_new_slot(&mut self, path: PathBuf) -> Result<usize, String> {
let buffer_id = self.next_buffer_id;
self.next_buffer_id += 1;
let slot = super::build_slot(&mut self.syntax, buffer_id, Some(path), &self.config)?;
self.slots.push(slot);
let idx = self.slots.len() - 1;
self.lsp_attach_buffer(idx);
Ok(idx)
}
/// Dispatch a buffer-navigation [`crate::keymap_actions::AppAction`].
///
/// Handles variants:
/// - BufferNext / BufferPrev / BufferAlt
/// - BufferCycleH / BufferCycleL (predicate-gated: fall back to viewport motion)
/// - Tabnext / Tabprev (delegated through dispatch_ex)
pub(crate) fn dispatch_buffer_action(
&mut self,
action: crate::keymap_actions::AppAction,
count: usize,
) {
use crate::keymap_actions::AppAction;
match action {
AppAction::Tabnext => {
for _ in 0..count {
self.dispatch_ex("tabnext");
}
}
AppAction::Tabprev => {
for _ in 0..count {
self.dispatch_ex("tabprev");
}
}
AppAction::BufferNext => self.buffer_next(),
AppAction::BufferPrev => self.buffer_prev(),
AppAction::BufferAlt => self.buffer_alt(),
AppAction::BufferCycleH => {
if self.slots.len() > 1 {
self.buffer_prev();
} else {
// Single slot: fall back to viewport-top motion.
let n = self.pending_count.take_or(1) as usize;
self.active_mut()
.editor
.apply_motion(hjkl_vim::MotionKind::ViewportTop, n);
}
}
AppAction::BufferCycleL => {
if self.slots.len() > 1 {
self.buffer_next();
} else {
// Single slot: fall back to viewport-bottom motion.
let n = self.pending_count.take_or(1) as usize;
self.active_mut()
.editor
.apply_motion(hjkl_vim::MotionKind::ViewportBottom, n);
}
}
_ => {}
}
}
}