turbo-debug.nvim/CHANGELOG.md

# Changelog

## 0.2.0 — 2026-04-12

Major UI rework and stability release. Two floating chrome bars replace the
old single toolbar, every resize/tabline-toggle edge case is handled, and
every highlight now derives from the user's colorscheme.

### Breaking changes

- **`quit_exits_mode` option removed.** `q` is now context-aware: if a DAP
  session is running, `q` terminates the session but keeps debug mode
  active (so you can read the Console / inspect post-mortem state). Press
  `q` again to exit debug mode.
- **`help_on_enter` default is now `false`** (was `true`). The control bar
  always shows `(?) help`, so the auto-popup is no longer needed. Set to
  `true` to restore the splash behavior.
- **Default layout changed.** Sidebar panes are now Call Stack → Scopes →
  Watches → Breakpoints (all 25%). REPL is no longer in the default
  layout — press `E` during debug mode to open it as a floating window.
- **Console pane sizing.** Bottom Console pane is `max(8 rows, 20% of
  editor lines)` (previously hardcoded). Configurable via `console_height`.

### Added

- **Two-bar floating chrome**, independent of any statusline plugin:
  - Status bar (top, 2 rows): brand, live `dap.status()` text, state chip
    (` DEBUG · READY ` / ` · RUNNING ` / ` · PAUSED `)
  - Control bar (bottom, 2 rows, above statusline): clickable buttons for
    continue, step over, step into, step out, restart (during session),
    terminate; `(?) help` right-anchored
  - Italic qualifiers (`over`, `into`, `out`) on step controls — dropped
    automatically at narrow widths
- **Keymap-aware control bar**: legend reflects the user's actual
  remapped keys (honors `keys` override; disabled actions are omitted)
- **IP arrow markers** on stopped lines: paired 👉 gutter sign (priority
  500 so it always wins over breakpoint signs) + 👈 REASON virtual text
  at EOL
- **Optional debug-mode colorscheme** via `colorscheme` option — theme
  swaps on debug enter, restores on exit
- **Theme-agnostic separator color**: derives from `WinBar.fg` so the bar
  chrome matches any colorscheme; global `WinSeparator` override during
  debug mode gives the whole UI a consistent edge color
- **`clear_console_on_start`** (default `true`): wipe Console scrollback
  on session start/restart while preserving the terminal channel
- **`collapsed_scopes`** (default `{ "Registers" }`): auto-collapse noisy
  scopes; codelldb doesn't mark Registers expensive even though it's a
  huge dump
- **`max_value_width`** (default `2000`): per-line truncation for values
  in Scopes/Watches; prevents register-dump bleed
- **`console_refresh_ms`** (default `50`): trailing-edge throttle for
  Console repaints under high-throughput stdout
- **`sidebar`** option — `"left"` (default) or `"right"`
- **`active_window_highlight`** (default `true`): dim inactive dapui pane
  borders so the focused pane is visually obvious
- **`W` and `K` in visual mode**: watch / hover operate on the selection
- Live `dap.status()` polling via `User DapProgressUpdate` autocmd —
  status text stays current across progress messages
- Source window is focused before DAP jumps on `event_stopped`, so
  stepped-into library files open in the source area (not in a bar or
  dapui pane)
- Console repaint throttle prevents editor lag under chatty programs

### Changed

- Bars are now real splits (not overlapping floats) — dapui and source
  windows tuck between them naturally
- `pin_dapui_sizes()` only re-pins on EXTERNAL geometry changes
  (bufferline tabline toggle, `wincmd =`) detected by total-height
  delta; user's manual pane drags survive
- `ensure_dapui()` runs ONCE per plugin lifetime (not per `M.enter`),
  avoiding "Debug adapter didn't respond" timeouts on toggle
- Bars clamp to exactly 2 rows on every VimResized / WinResized (prevents
  stray EOB `~` when nvim grows a fixed-height window)
- `setup()` is now fully idempotent — safe to call multiple times with
  different opts, and `plugin/turbo-debug.lua`'s deferred auto-setup
  yields to explicit user `setup({...})`
- Copyright holder updated to `Stephen Waits <steve@waits.net>`

### Fixed

- Bars recreate themselves if killed by shrink-below-minimum resize or
  tabline appearance/disappearance
- Inherited `winbar` from the splitting source window is cleared on bar
  windows (was showing phantom separator rows)
- Layout re-asserts correctly after `wincmd =` (tiny-equalizer pass)
- Sidebar proportions stable across re-entry (no drift across toggles)
- Bar separators bright on both outward edges (top-of-sbar, bottom-of-cbar)
- Deferred dependency loading: `plugin/turbo-debug.lua` waits for
  `vim.pack.add` to finalize runtimepath before calling `setup()`

### Internal

- Extracted 10+ helper functions in `mode.lua` (`win_ok`, `buf_ok`,
  `is_dapui_pane_ft`, `for_each_dapui_pane`, `safe_extmark`,
  `bar_set_lines`, `safe_set_height`, `if_still_active`,
  `invalidate_dead_bars`, `focus_source_win`, `unset_and_restore`,
  `install_cs_listener`) — deduped ~25 call sites
- Data-driven sign definitions (`breakpoints.lua`) and Python
  interpreter candidate probing
- Dead code removed: unused `reposition_bars` stub, vestigial
  `sbar_zones` / `handle_sbar_click` click infrastructure (status bar
  has no clickable zones)
- Added regression tests: `test_render_bars` (sbar/cbar output,
  dimensions, zones, overflow fallback), `test_highlights_cs`
  (ColorScheme augroups, highlight re-apply), `test_helpers`
  (keyof branching, source_window filtering)
- `stylua.toml` added; all Lua code formatted

## 0.1.0 — 2026-04-11

Initial release.

### Features

- **Zero-config debugging** — one line install, everything works
- **Modal keybindings** — single-key debug controls (`c`/`s`/`d`/`r`/`q`), active only during debug mode, cleanly removed on exit
- **Persistent breakpoints** — survive Neovim restarts via persistent-breakpoints.nvim
- **Inline virtual text** — variable values shown in source code during stepping
- **Hover inspection** (`K`) and **watch expressions** (`W`) from the code window
- **REPL eval** (`E`) — floating REPL for expression evaluation
- **Help splash** — centered keybinding reference on debug mode entry (3s auto-dismiss), re-openable with `?`
- **Debug mode chrome** — winbar indicator, cursor highlight, dapui panel titles
- **dapui integration** — opinionated layout with controls toolbar, labeled panels (Scopes, Watches, Call Stack, Console, REPL)
- **which-key support** — `<leader>d` debug group registered automatically if which-key is installed
- **`quit_exits_mode`** option — control whether `q` terminates only or also exits debug mode

### Adapters (12 languages)

- **Python** — debugpy with virtualenv auto-detection (VIRTUAL_ENV, CONDA_PREFIX, .venv)
- **Rust** — codelldb with `cargo build` integration and `vim.ui.select` binary picker
- **Go** — delve with auto-launch (file and package configs)
- **C / C++ / Swift** — codelldb with executable prompt
- **JavaScript / TypeScript** — js-debug-adapter (pwa-node, launch + attach)
- **C#** — netcoredbg
- **Java** — java-debug-adapter
- **Kotlin** — kotlin-debug-adapter
- **PHP** — php-debug (Xdebug listener)
- **Ruby** — rdbg (launch + attach)
- **Lua (Neovim)** — osv (optional, graceful skip if not installed)

### Keybinding scheme

- `<leader>dd` — toggle debug mode
- `<leader>dx` / `<leader>dX` / `<leader>dD` — breakpoints (always available)
- `c s d r C x X D W K E q R ?` — modal keys (debug mode only)