kickstart.nvim/lua/kickstart/plugins/debug.lua

-- debug.lua
--
-- Shows how to use the DAP plugin to debug your code.
--
-- Primarily focused on configuring the debugger for Go, but can
-- be extended to other languages as well. That's why it's called
-- kickstart.nvim and not kitchen-sink.nvim ;)

vim.pack.add {
  'https://github.com/mfussenegger/nvim-dap',
  'https://github.com/rcarriga/nvim-dap-ui',
  'https://github.com/nvim-neotest/nvim-nio',
  'https://github.com/mason-org/mason.nvim',
  'https://github.com/jay-babu/mason-nvim-dap.nvim',
  'https://github.com/leoluz/nvim-dap-go',
}

-- Basic debugging keymaps, feel free to change to your liking!
vim.keymap.set('n', '<F5>', function() require('dap').continue() end, { desc = 'Debug: Start/Continue' })
vim.keymap.set('n', '<F1>', function() require('dap').step_into() end, { desc = 'Debug: Step Into' })
vim.keymap.set('n', '<F10>', function() require('dap').step_over() end, { desc = 'Debug: Step Over' })
vim.keymap.set('n', '<F3>', function() require('dap').step_out() end, { desc = 'Debug: Step Out' })
vim.keymap.set('n', '<leader>ba', function() require('dap').toggle_breakpoint() end, { desc = 'Debug: Toggle Breakpoint' })
vim.keymap.set('n', '<leader>Ba', function() require('dap').set_breakpoint(vim.fn.input 'Breakpoint condition: ') end, { desc = 'Debug: Set Breakpoint' })
vim.keymap.set('n', '<leader>bt', function() require('dapui').toggle() end, { desc = 'Debug: Toggle UI' })
vim.keymap.set('n', '<F8>', function() require('dap').terminate() end, { desc = 'Debug: Stop Debugging' })

-- Toggle to see last session result. Without this, you can't see session output in case of unhandled exception.
vim.keymap.set('n', '<F7>', function() require('dapui').toggle() end, { desc = 'Debug: See last session result.' })

local dap = require 'dap'
local dapui = require 'dapui'

require('mason-nvim-dap').setup {
  -- Makes a best effort to setup the various debuggers with
  -- reasonable debug configurations
  automatic_installation = true,

  -- You can provide additional configuration to the handlers,
  -- see mason-nvim-dap README for more information
  handlers = {},

  -- You'll need to check that you have the required things installed
  -- online, please don't ask me how to install them :)
  ensure_installed = {
    'delve',
    'js-debug-adapter',
  },
}

-- Dap UI setup
-- For more information, see |:help nvim-dap-ui|
---@diagnostic disable-next-line: missing-fields
dapui.setup {
  -- Set icons to characters that are more likely to work in every terminal.
  --    Feel free to remove or use ones that you like more! :)
  --    Don't feel like these are good choices.
  icons = { expanded = '▾', collapsed = '▸', current_frame = '*' },
  ---@diagnostic disable-next-line: missing-fields
  controls = {
    icons = {
      pause = '⏸',
      play = '▶',
      step_into = '⏎',
      step_over = '⏭',
      step_out = '⏮',
      step_back = 'b',
      run_last = '▶▶',
      terminate = '⏹',
      disconnect = '⏏',
    },
  },
}

-- Change breakpoint icons
-- vim.api.nvim_set_hl(0, 'DapBreak', { fg = '#e51400' })
-- vim.api.nvim_set_hl(0, 'DapStop', { fg = '#ffcc00' })
-- local breakpoint_icons = vim.g.have_nerd_font
--     and { Breakpoint = '', BreakpointCondition = '', BreakpointRejected = '', LogPoint = '', Stopped = '' }
--   or { Breakpoint = '●', BreakpointCondition = '⊜', BreakpointRejected = '⊘', LogPoint = '◆', Stopped = '⭔' }
-- for type, icon in pairs(breakpoint_icons) do
--   local tp = 'Dap' .. type
--   local hl = (type == 'Stopped') and 'DapStop' or 'DapBreak'
--   vim.fn.sign_define(tp, { text = icon, texthl = hl, numhl = hl })
-- end

dap.listeners.after.event_initialized['dapui_config'] = dapui.open
dap.listeners.before.event_terminated['dapui_config'] = dapui.close
dap.listeners.before.event_exited['dapui_config'] = dapui.close

-- Install golang specific config
require('dap-go').setup {
  delve = {
    -- On Windows delve must be run attached or it crashes.
    -- See https://github.com/leoluz/nvim-dap-go/blob/main/README.md#configuring
    detached = vim.fn.has 'win32' == 0,
  },
}

-- ==========================================
-- JavaScript / TypeScript / Next.js Setup
-- ==========================================

-- 1. Define the adapters using the js-debug-adapter installed by Mason
-- We use the direct path to dapDebugServer.js to avoid PATH/binary linking issues.
local js_debug_adapter_path = vim.fs.joinpath(
  vim.fn.stdpath('data'),
  'mason',
  'packages',
  'js-debug-adapter',
  'js-debug',
  'src',
  'dapDebugServer.js'
)

local node_terminal = {
  type = 'server',
  host = 'localhost',
  port = '${port}',
  executable = {
    command = 'node',
    args = {
      js_debug_adapter_path,
      '${port}',
    },
  },
}

local chrome = {
  type = 'server',
  host = 'localhost',
  port = '${port}',
  executable = {
    command = 'node',
    args = {
      js_debug_adapter_path,
      '${port}',
    },
  },
}

require('dap').adapters['pwa-node'] = node_terminal
require('dap').adapters['node_terminal'] = node_terminal

require('dap').adapters['pwa-chrome'] = chrome
require('dap').adapters['chrome'] = chrome

-- 2. Define configurations for TS/JS
local js_based_languages = { 'typescript', 'javascript', 'typescriptreact' }

for _, language in ipairs(js_based_languages) do
  require('dap').configurations[language] = {
    -- Server-side Next.js debugging
    {
      type = 'pwa-node',
      request = 'launch',
      name = 'Nvim: Debug JS Server',
      runtimeExecutable = 'npm',
      runtimeArgs = { 'run', 'dev' },
      cwd = '${workspaceFolder}',
      -- 'integratedTerminal' launches a Neovim terminal split and runs the command there
      console = 'integratedTerminal',
      -- sourceMaps = true, -- Uncomment if breakpoints in `.next` aren't mapping correctly
    },
    -- Client-side Next.js debugging
    {
      type = 'pwa-chrome',
      request = 'launch',
      name = 'Nvim: Debug JS Client',
      url = 'http://localhost:3000',
      webRoot = '${workspaceFolder}',
      -- By default, pwa-chrome uses a clean, isolated Chrome profile.
      -- Uncomment the line below if you want it to use your default Chrome profile (so you can use your extensions).
      -- userDataDir = false,
      -- sourceMaps = true,
    },
  }
end