chore: release 0.2.0

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`). Control bar always
  shows `(?) help`, so the auto-popup is no longer needed.
- Default layout changed: sidebar is 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 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),
  control bar (bottom, 2 rows, clickable flow buttons + `(?) help`
  right-anchored). Italic qualifiers on step controls auto-drop at
  narrow widths.
- Keymap-aware control bar — legend reflects user's actual remapped
  keys; disabled actions are omitted entirely.
- IP arrow markers on stopped lines: 👉 gutter sign (priority 500) +
  👈 REASON virtual text at EOL.
- Optional debug-mode colorscheme via `colorscheme` option.
- Theme-agnostic separator color (derives from WinBar.fg); global
  WinSeparator override during debug mode for consistent edge color.
- `clear_console_on_start` (default true) — wipe Console scrollback on
  session start while preserving the terminal channel.
- `collapsed_scopes` (default {"Registers"}) — auto-collapse noisy
  scopes that adapters don't flag expensive.
- `max_value_width` (default 2000) — per-line truncation for values in
  Scopes/Watches.
- `console_refresh_ms` (default 50) — trailing-edge Console repaint
  throttle.
- `sidebar` option — "left" (default) or "right".
- `active_window_highlight` (default true) — dim inactive dapui pane
  borders.
- `W` and `K` now work in visual mode (operate on the selection).
- Source window focused before DAP jumps on event_stopped.

CHANGED
- Bars are real splits (not overlapping floats).
- pin_dapui_sizes() only re-pins on external geometry changes (tabline
  toggle); user manual pane drags survive.
- ensure_dapui() runs ONCE per plugin lifetime, avoiding "Debug adapter
  didn't respond" timeouts on toggle.
- Bars clamp to exactly 2 rows on every resize (no stray EOB `~`).
- setup() is fully idempotent; plugin/turbo-debug.lua's deferred
  auto-setup yields to explicit user setup({...}).
- Copyright holder: Stephen Waits <steve@waits.net>.

FIXED
- Bars recreate if killed by shrink-below-minimum resize or tabline
  appear/disappear.
- Inherited winbar cleared on bar windows (no phantom separator rows).
- Layout re-asserts after `wincmd =`.
- Sidebar proportions stable across re-entry.
- Bar separators bright on both outward edges.
- Deferred dependency loading waits for vim.pack.add to finalize.

INTERNAL
- Extracted 10+ helper functions in mode.lua; deduped ~25 call sites.
- Data-driven sign definitions and Python interpreter probing.
- Dead code removed: unused reposition_bars, vestigial sbar_zones/
  handle_sbar_click.
- Added regression tests: test_render_bars, test_highlights_cs,
  test_helpers.
- stylua.toml added; all Lua code formatted.

See CHANGELOG.md for the full 0.2.0 entry.

README.md

@@ -97,7 +97,12 @@ require("turbo-debug").setup({
     toggle = "<leader>D",  -- change the toggle chord
   },
   sidebar = "right",       -- "left" (default) or "right"
-  help_on_enter = false,   -- disable the help splash
+  help_on_enter = true,    -- show help popup on debug mode entry (default false)
+
+  -- Optional theme swap for debug sessions. `nil` (default) keeps the
+  -- current colorscheme; any string is passed to `:colorscheme` on enter
+  -- and the original is restored on exit.
+  colorscheme = nil,
 
   -- Auto stop-on-entry when no breakpoints are set (Turbo Pascal model):
   -- press `c` on an empty-BP project and the debugger pauses at main().
@@ -112,23 +117,44 @@ require("turbo-debug").setup({
   -- Console repaint throttle (ms). Max 1000/console_refresh_ms redraws per
   -- second when the debugged program spams stdout. Prevents editor DOS.
   console_refresh_ms = 50,
+
+  -- Clear the Console pane on session start/restart (preserves the
+  -- terminal channel — only wipes scrollback).
+  clear_console_on_start = true,
+
+  -- Scope names to default-collapse in Scopes. dapui auto-collapses any
+  -- scope the adapter marks `expensive`, but codelldb doesn't flag
+  -- Registers as expensive even though it's a huge dump.
+  collapsed_scopes = { "Registers" },
+
+  -- Dim inactive dapui pane borders so the focused pane is obvious.
+  active_window_highlight = true,
 })
 ```
 
-### Control bar
+### Chrome bars
 
-When debug mode is active a 1-row floating bar appears directly above your
-statusline, showing:
+When debug mode is active, two 2-row floating bars appear, completely
+independent of lualine, heirline, or any other statusline plugin:
 
-- `● READY` / `● RUNNING` / `● PAUSED` session state chip (color-coded)
-- Clickable controls:  continue `▶`,  step over,  step into,  step out,
-  restart,  terminate,  exit debug mode
-- `dap.status()` progress text (right-aligned)
-- Cursor position
+**Status bar (top)** shows:
+- The `turbo-debug` brand
+- Live `dap.status()` progress text
+- Session state chip: ` DEBUG · READY ` / ` · RUNNING ` / ` · PAUSED `
+  (color-coded via `DiagnosticHint` / `DiagnosticInfo` / `DiagnosticError`)
 
-The bar is completely independent of lualine, heirline, or any other
-statusline plugin — it opens in its own floating window and closes cleanly
-when debug mode exits.
+**Control bar (bottom, above your statusline)** shows:
+- Clickable buttons: `(c)ontinue` / `(s)tep` *over* / `(d)escend` *into* /
+  `(r)eturn` *out* / `(R)estart` (during session) / `(q) terminate`
+- `(?) help` right-anchored
+- Italic qualifiers (`over`, `into`, `out`) are inline when width allows;
+  auto-dropped on narrow terminals
+
+Both bars:
+- Recreate themselves if killed by layout changes (bufferline tabline
+  toggles, `wincmd =`, etc.)
+- Re-render on every DAP state change (|User DapProgressUpdate|)
+- Close cleanly on exit
 
 ### Design notes
 
@@ -136,18 +162,21 @@ when debug mode exits.
   the help popup (`?`), the hover popup (`K`), and the debug-eval popup
   (`E`). Floating windows are the only windows Neovim draws borders around
   in the terminal grid. Splits (the Scopes/Watches/Stacks/Breakpoints/
-  REPL/Console panes) use the user's `WinSeparator` character — that's a
+  Console panes) use the user's `WinSeparator` character — that's a
   terminal-rendering limit, not a plugin choice.
 
 - **No hardcoded colors.** Every highlight links to a standard group
   (`DiagnosticError`, `Function`, `Comment`, `CursorLine`, `Visual`,
-  `Search`, `Title`, `Special`, etc.) so the plugin automatically inherits
-  your colorscheme on the fly. Switch themes mid-session and everything
-  re-paints.
+  `Search`, `Title`, `Special`, `WinBar`, etc.) so the plugin
+  automatically inherits your colorscheme on the fly. Switch themes
+  mid-session (or set `colorscheme = "high-contrast"` in `setup()` for
+  a dedicated debug theme) and everything re-paints.
 
-- **Nerd Font Codicons** for all functional iconography (gutter signs,
-  control buttons, pane titles). Emoji (`👈` / `👉`) for the paused-line
-  arrows, because fingers-pointing-at-the-line is unmissable.
+- **Emoji** (supplementary-plane, not VS16-dependent) for iconography:
+  🔴 🟡 ⭕ 👉 📝 for gutter signs; 🟢 🚀 👣 🔽 🔼 🔄 🛑 for control
+  buttons; 🔎 👀 📚 🔴 💻 for pane titles. Colored emoji render
+  consistently in modern terminals (Ghostty, Kitty, WezTerm, iTerm)
+  without font-dependent rendering quirks.
 
 ## Supported Languages