turbo-debug.nvim/lua/turbo-debug/config.lua

local M = {}

M.defaults = {
  -- The 3-row control bar shows `(?)help` so users can always see where to
  -- get the key reference. No auto-popup needed on entry.
  help_on_enter = false,
  builtin_adapters = true,

  -- When `c` is pressed with no breakpoints set, launch the first adapter
  -- configuration for the filetype with stopOnEntry so the debugger pauses
  -- at the program's entry point. Matches the Turbo Pascal "press key to
  -- start debugging" model. Set false to always run until a breakpoint.
  stop_on_entry_when_no_breakpoints = true,

  -- Maximum per-line character width for variable values rendered in dapui
  -- panes. Anything over this gets truncated with `…`. Set to 0 to disable.
  -- Default 2000 only catches pathological multi-KB register/memory dumps;
  -- normal values pass through and wrap naturally inside the pane.
  max_value_width = 2000,

  -- Throttle window (ms) for console repaints when the debugged program
  -- outputs. Trailing-edge — max 1000/console_refresh_ms redraws per second.
  console_refresh_ms = 50,

  -- Scope names (from the DAP adapter) to default-collapse. dapui auto-
  -- collapses scopes that the adapter marks `expensive`, but many adapters
  -- (codelldb for Rust/C++, for example) don't mark Registers expensive
  -- even though it's a huge dump. Any scope name in this list is treated
  -- as expensive by intercepting the `scopes` response before dapui sees
  -- it. Users can click/<CR> to expand manually.
  collapsed_scopes = { "Registers" },

  -- Clear the Console pane on session start/restart. Disabled by default
  -- because safe clearing is tricky: dapui's console buffer becomes a
  -- terminal buffer once a session starts, and manipulating terminal
  -- buffers mid-session destabilizes the adapter. Opt in explicitly if
  -- you want it and accept the risk.
  clear_console_on_start = false,

  -- modal keys (active only during debug mode, single-key)
  keys = {
    continue = "c",
    step_over = "s",
    step_into = "d",
    step_out = "r",
    run_to_cursor = "C",
    breakpoint = "x",
    cond_breakpoint = "X",
    clear_breakpoints = "D",
    watch = "W",
    hover = "K",
    eval = "E",
    terminate = "q",
    restart = "R",
    help = "?",
  },

  -- global keys (always available, <leader>d prefix)
  global_keys = {
    toggle = "<leader>dd",
    breakpoint = "<leader>dx",
    cond_breakpoint = "<leader>dX",
    clear_breakpoints = "<leader>dD",
  },

  -- sidebar position: "left" (default) or "right"
  sidebar = "left",

  -- highlight the active dapui pane's border/separator vs. dim inactive panes
  active_window_highlight = true,

  dapui = {
    -- Unicode icons via byte escapes so they survive tool round-trips.
    -- ▾ U+25BE down-triangle (expanded), ▸ U+25B8 right-triangle (collapsed),
    -- ▶ U+25B6 right-pointing triangle (current frame / play-head)
    icons = {
      expanded      = "\xe2\x96\xbe",
      collapsed     = "\xe2\x96\xb8",
      current_frame = "\xe2\x96\xb6",
    },
    controls = {
      enabled = true,
      element = "repl",
      -- ▶ play, ⏸ pause, ⤓ step-into, ⇒ step-over, ⤒ step-out, ↶ step-back,
      -- ↻ run-last, ■ terminate, ⊗ disconnect
      icons = {
        play       = "\xe2\x96\xb6",
        pause      = "\xe2\x8f\xb8",
        step_into  = "\xe2\xa4\x93",
        step_over  = "\xe2\x87\x92",
        step_out   = "\xe2\xa4\x92",
        step_back  = "\xe2\x86\xb6",
        run_last   = "\xe2\x86\xbb",
        terminate  = "\xe2\x96\xa0",
        disconnect = "\xe2\x8a\x97",
      },
    },
    floating = { border = "rounded", mappings = { close = { "q", "<Esc>" } } },
    render = { indent = 2, max_type_length = 20 },
    -- dapui's `expand_lines` spawns a cursor-pinned floating window when a
    -- line is longer than the pane width — that float bleeds across the
    -- entire screen for long register dumps. We wrap inside the pane instead
    -- (wrap=true + breakindent + showbreak in set_dapui_window_opts), so this
    -- hover is both redundant and destructive. Kill it.
    expand_lines = false,
    -- layouts are built dynamically from `sidebar` in mode.lua; override
    -- `layouts` here to fully customize.
    layouts = nil,
  },

  virtual_text = {
    enabled = true,
    commented = true,
    virt_text_pos = "eol",
    show_stop_reason = true,
    highlight_changed_variables = true,
    highlight_new_as_changed = false,
    only_first_definition = false,
    all_frames = false,
    display_callback = function(variable)
      if #variable.value > 80 then return " = " .. variable.value:sub(1, 77) .. "…" end
      return " = " .. variable.value
    end,
  },

  adapters = {},
}

M.opts = M.defaults

function M.merge(user_opts)
  M.opts = vim.tbl_deep_extend("force", vim.deepcopy(M.defaults), user_opts or {})
  if user_opts then
    for _, tbl_name in ipairs({ "keys", "global_keys" }) do
      if user_opts[tbl_name] then
        for k, v in pairs(user_opts[tbl_name]) do
          if v == false then M.opts[tbl_name][k] = false end
        end
      end
    end
  end
  return M.opts
end

return M