486 lines
21 KiB
Lua
486 lines
21 KiB
Lua
-- ========================================================================
|
|
-- FLUTTER/DART PROFILE - Language-specific plugins and LSP configuration
|
|
-- ========================================================================
|
|
--
|
|
-- This file contains all Flutter and Dart-specific plugins and configurations.
|
|
-- These plugins will ONLY load when you open a .dart file, keeping your
|
|
-- startup time fast and avoiding conflicts with other languages.
|
|
--
|
|
-- Key features to configure here:
|
|
-- - Flutter tools (hot reload, device management, widget inspector)
|
|
-- - Dart LSP (dartls via flutter-tools)
|
|
-- - Dart-specific formatters and linters
|
|
-- - Flutter-specific keymaps (e.g., <leader>fr for Flutter Run)
|
|
--
|
|
-- Usage: Just open a .dart file and these plugins will automatically load!
|
|
-- ========================================================================
|
|
|
|
return {
|
|
-- ========================================================================
|
|
-- NVIM-DAP - Debug Adapter Protocol for Flutter debugging
|
|
-- ========================================================================
|
|
-- Load DAP when opening Dart files to enable breakpoint debugging
|
|
{
|
|
'mfussenegger/nvim-dap',
|
|
ft = 'dart',
|
|
dependencies = {
|
|
'rcarriga/nvim-dap-ui',
|
|
'nvim-neotest/nvim-nio',
|
|
},
|
|
},
|
|
|
|
-- ========================================================================
|
|
-- FLUTTER TOOLS - Complete Flutter development environment
|
|
-- ========================================================================
|
|
-- Provides Flutter-specific features like hot reload, device management,
|
|
-- widget inspector, and integrates the Dart LSP server.
|
|
--
|
|
-- Flutter-specific keymaps (available in .dart files):
|
|
-- <Space>fr - Flutter Run (start app)
|
|
-- <Space>fq - Flutter Quit (stop app)
|
|
-- <Space>fR - Flutter Hot Restart
|
|
-- <Space>fh - Flutter Hot Reload
|
|
-- <Space>fd - Flutter Devices (show connected devices)
|
|
-- <Space>fe - Flutter Emulators (launch emulator)
|
|
-- <Space>fo - Flutter Outline (toggle outline/widget tree)
|
|
-- <Space>ft - Flutter DevTools (start DevTools server)
|
|
-- <Space>fa - Flutter Attach (attach to running app)
|
|
-- <Space>fD - Flutter Detach (detach from running app)
|
|
-- <Space>fL - Flutter Log Toggle (show/hide logs)
|
|
-- <Space>fc - Flutter Copy Profiler URL (for DevTools)
|
|
--
|
|
-- Debug keymaps:
|
|
-- <F5> - Start/Continue debugging
|
|
-- <F10> - Step over
|
|
-- <F11> - Step into
|
|
-- <F12> - Step out
|
|
-- <leader>db - Toggle breakpoint
|
|
-- <leader>dB - Set conditional breakpoint
|
|
-- <leader>dc - Continue
|
|
-- <leader>dt - Terminate debugging
|
|
-- ========================================================================
|
|
{
|
|
'nvim-flutter/flutter-tools.nvim',
|
|
ft = 'dart', -- Only load when opening Dart files
|
|
dependencies = {
|
|
'nvim-lua/plenary.nvim',
|
|
'stevearc/dressing.nvim', -- Optional: better UI for Flutter commands
|
|
'mfussenegger/nvim-dap',
|
|
'rcarriga/nvim-dap-ui',
|
|
'nvim-neotest/nvim-nio',
|
|
},
|
|
config = function()
|
|
-- Get shared LSP capabilities from blink.cmp
|
|
local capabilities = require('blink.cmp').get_lsp_capabilities()
|
|
|
|
require('flutter-tools').setup {
|
|
-- UI configuration
|
|
ui = {
|
|
border = 'rounded', -- border type for floating windows
|
|
notification_style = 'native', -- 'native' or 'plugin' (native uses vim.notify)
|
|
},
|
|
|
|
-- Flutter SDK path (usually auto-detected, but you can specify if needed)
|
|
-- flutter_path = '/path/to/flutter/bin/flutter',
|
|
-- flutter_lookup_cmd = nil, -- example: "dirname $(which flutter)" or "asdf where flutter"
|
|
|
|
-- FVM support - takes priority over path, uses <workspace>/.fvm/flutter_sdk if enabled
|
|
fvm = false,
|
|
|
|
-- Root patterns to find the root of your flutter project
|
|
root_patterns = { '.git', 'pubspec.yaml' },
|
|
|
|
-- Uncomment to set a default device (get ID from `flutter devices`)
|
|
-- device = {
|
|
-- id = 'chrome', -- or 'macos', 'emulator-5554', etc.
|
|
-- },
|
|
|
|
lsp = {
|
|
capabilities = capabilities,
|
|
|
|
-- Suppress didChange errors during snippet expansion
|
|
on_attach = function(client, bufnr)
|
|
-- Reduce didChange notification frequency to prevent errors with snippets
|
|
client.server_capabilities.textDocumentSync = vim.tbl_deep_extend('force', client.server_capabilities.textDocumentSync or {}, {
|
|
change = 2, -- 2 = Incremental (less prone to errors than full sync)
|
|
})
|
|
|
|
-- Filter out didChange error notifications (they're harmless during snippet expansion)
|
|
-- We'll use an autocmd to do this after noice.nvim is loaded
|
|
vim.api.nvim_create_autocmd('User', {
|
|
pattern = 'VeryLazy',
|
|
once = true,
|
|
callback = function()
|
|
local notify = vim.notify
|
|
vim.notify = function(msg, level, opts)
|
|
if type(msg) == 'string' and msg:match('textDocument/didChange') then
|
|
return -- Suppress this specific error
|
|
end
|
|
notify(msg, level, opts)
|
|
end
|
|
end,
|
|
})
|
|
end,
|
|
|
|
-- Color preview for dart variables (Colors.red, Color(0xFF...), etc.)
|
|
-- This shows the actual Material Design colors inline!
|
|
color = {
|
|
enabled = true, -- whether or not to highlight color variables at all, only supported on flutter >= 2.10
|
|
background = true, -- highlight the background
|
|
background_color = nil, -- required, when background is transparent (i.e. background_color = { r = 19, g = 17, b = 24},)
|
|
foreground = false, -- highlight the foreground
|
|
virtual_text = true, -- show the highlight using virtual text
|
|
virtual_text_str = '■', -- the virtual text character to highlight
|
|
},
|
|
-- Settings passed to the Dart LSP
|
|
settings = {
|
|
-- Show TODOs in the problems pane
|
|
showTodos = true,
|
|
-- Completion settings
|
|
completeFunctionCalls = true,
|
|
-- Enable/disable specific lints
|
|
-- analysisExcludedFolders = {},
|
|
renameFilesWithClasses = 'prompt', -- "always" or "prompt"
|
|
enableSnippets = true,
|
|
updateImportsOnRename = true, -- Whether to update imports and other directives when files are renamed
|
|
},
|
|
},
|
|
|
|
-- Flutter-specific settings
|
|
decorations = {
|
|
statusline = {
|
|
-- Set to true to show Flutter app info in statusline
|
|
app_version = false,
|
|
device = true, -- Show device name
|
|
},
|
|
},
|
|
|
|
widget_guides = {
|
|
enabled = true, -- Show visual guides for widget nesting
|
|
},
|
|
|
|
closing_tags = {
|
|
highlight = 'Comment', -- Highlight color for closing tags
|
|
prefix = '// ', -- Text to show before closing tag
|
|
enabled = true, -- Show closing tags for widgets
|
|
},
|
|
|
|
dev_log = {
|
|
enabled = true,
|
|
notify_errors = false, -- Don't show error notifications for log buffer issues
|
|
open_cmd = 'tabedit', -- Open logs in a new tab
|
|
focus_on_open = false, -- Don't auto-focus the log window
|
|
},
|
|
|
|
dev_tools = {
|
|
autostart = false, -- autostart devtools server if not detected
|
|
auto_open_browser = false, -- Automatically opens devtools in the browser
|
|
},
|
|
|
|
outline = {
|
|
open_cmd = '30vnew', -- command to use to open the outline buffer
|
|
auto_open = false, -- if true this will open the outline automatically when it is first populated
|
|
},
|
|
|
|
debugger = {
|
|
enabled = true, -- Enable Flutter debugger integration
|
|
run_via_dap = true, -- Use DAP for debugging
|
|
-- if empty dap will not stop on any exceptions, otherwise it will stop on those specified
|
|
-- see |:help dap.set_exception_breakpoints()| for more info
|
|
exception_breakpoints = {},
|
|
-- Whether to call toString() on objects in debug views like hovers and the variables list.
|
|
-- Invoking toString() has a performance cost and may introduce side-effects,
|
|
-- although users may expected this functionality. null is treated like false.
|
|
evaluate_to_string_in_debug_views = true,
|
|
-- Flutter tools will automatically register DAP configurations
|
|
-- No need to manually configure launch.json
|
|
},
|
|
}
|
|
|
|
-- ========================================================================
|
|
-- DAP UI SETUP - Beautiful debugging interface
|
|
-- ========================================================================
|
|
local dap, dapui = require 'dap', require 'dapui'
|
|
|
|
-- Configure DAP UI to open in tabs for better half-width screen support
|
|
dapui.setup {
|
|
icons = { expanded = '▾', collapsed = '▸', current_frame = '*' },
|
|
controls = {
|
|
icons = {
|
|
pause = '⏸',
|
|
play = '▶',
|
|
step_into = '⏎',
|
|
step_over = '⏭',
|
|
step_out = '⏮',
|
|
step_back = 'b',
|
|
run_last = '▶▶',
|
|
terminate = '⏹',
|
|
disconnect = '⏏',
|
|
},
|
|
},
|
|
-- Open each element in a new tab instead of side panels
|
|
-- This prevents layout issues on small/half-width screens
|
|
layouts = {
|
|
{
|
|
elements = {
|
|
{ id = 'scopes', size = 0.25 },
|
|
{ id = 'breakpoints', size = 0.25 },
|
|
{ id = 'stacks', size = 0.25 },
|
|
{ id = 'watches', size = 0.25 },
|
|
},
|
|
size = 40,
|
|
position = 'right',
|
|
},
|
|
{
|
|
elements = {
|
|
{ id = 'repl', size = 0.5 },
|
|
{ id = 'console', size = 0.5 },
|
|
},
|
|
size = 10,
|
|
position = 'bottom',
|
|
},
|
|
},
|
|
-- Override element window commands to open in tabs
|
|
element_mappings = {},
|
|
windows = { indent = 1 },
|
|
}
|
|
|
|
-- Custom function to open DAP UI elements in tabs
|
|
local function open_dapui_in_tabs()
|
|
-- Save current tab to return to it
|
|
local current_tab = vim.fn.tabpagenr()
|
|
|
|
-- Create new tab with a named buffer for debug views
|
|
vim.cmd 'tabnew'
|
|
local debug_buf = vim.api.nvim_create_buf(false, true)
|
|
vim.api.nvim_buf_set_name(debug_buf, 'Flutter Debug')
|
|
vim.api.nvim_set_current_buf(debug_buf)
|
|
|
|
-- Open DAP UI in this tab
|
|
dapui.open()
|
|
|
|
-- Return to original tab so user continues coding there
|
|
vim.cmd('tabnext ' .. current_tab)
|
|
end
|
|
|
|
-- Custom function to close DAP UI tabs
|
|
local function close_dapui_tabs()
|
|
dapui.close()
|
|
|
|
-- Find and close the Flutter Debug tab
|
|
local current_tab = vim.fn.tabpagenr()
|
|
for i = 1, vim.fn.tabpagenr '$' do
|
|
vim.cmd('tabnext ' .. i)
|
|
local bufname = vim.api.nvim_buf_get_name(0)
|
|
if bufname:match('Flutter Debug') then
|
|
vim.cmd 'tabclose'
|
|
break
|
|
end
|
|
end
|
|
|
|
-- Return to original tab
|
|
if vim.fn.tabpagenr '$' >= current_tab then
|
|
vim.cmd('tabnext ' .. current_tab)
|
|
end
|
|
end
|
|
|
|
-- Automatically open/close DAP UI in tabs
|
|
dap.listeners.after.event_initialized['dapui_config'] = open_dapui_in_tabs
|
|
dap.listeners.before.event_terminated['dapui_config'] = close_dapui_tabs
|
|
dap.listeners.before.event_exited['dapui_config'] = close_dapui_tabs
|
|
|
|
-- Fix for Flutter Tools log buffer - make it non-saveable
|
|
-- This prevents Vim from asking to save changes to the log file on exit
|
|
vim.api.nvim_create_autocmd({ 'BufEnter', 'BufWinEnter' }, {
|
|
pattern = '*',
|
|
callback = function(args)
|
|
local bufname = vim.api.nvim_buf_get_name(args.buf)
|
|
-- Check if this is a Flutter log buffer
|
|
if bufname:match('__FLUTTER_DEV_LOG__') or vim.bo[args.buf].filetype == 'log' then
|
|
vim.bo[args.buf].modifiable = true -- Allow Flutter to write to it
|
|
vim.bo[args.buf].modified = false -- Mark as unmodified
|
|
vim.bo[args.buf].buftype = 'nofile' -- Don't associate with a file (prevents save prompt)
|
|
vim.bo[args.buf].swapfile = false -- Don't create swap file
|
|
end
|
|
end,
|
|
})
|
|
|
|
-- Keep log buffer marked as unmodified whenever it changes
|
|
-- This prevents the "save changes?" prompt on exit
|
|
vim.api.nvim_create_autocmd('BufModifiedSet', {
|
|
pattern = '*',
|
|
callback = function(args)
|
|
local bufname = vim.api.nvim_buf_get_name(args.buf)
|
|
if bufname:match('__FLUTTER_DEV_LOG__') then
|
|
vim.bo[args.buf].modifiable = true
|
|
vim.bo[args.buf].modified = false -- Keep it marked as unmodified
|
|
end
|
|
end,
|
|
})
|
|
|
|
-- ========================================================================
|
|
-- ENABLE TREESITTER FOLDING FOR DART FILES
|
|
-- ========================================================================
|
|
-- Set fold method to use Treesitter for Flutter widgets
|
|
-- Using multiple autocmds to ensure it sticks (some plugins override it)
|
|
local fold_augroup = vim.api.nvim_create_augroup('DartFolding', { clear = true })
|
|
|
|
vim.api.nvim_create_autocmd({ 'BufRead', 'BufEnter', 'BufWinEnter' }, {
|
|
group = fold_augroup,
|
|
pattern = '*.dart',
|
|
callback = function()
|
|
vim.opt_local.foldmethod = 'expr'
|
|
vim.opt_local.foldexpr = 'nvim_treesitter#foldexpr()'
|
|
vim.opt_local.foldlevel = 99 -- High level = everything unfolded
|
|
vim.opt_local.foldlevelstart = 99 -- Start with everything unfolded
|
|
|
|
-- Hide fold column (no extra column, folds still work!)
|
|
vim.opt_local.foldcolumn = '0'
|
|
|
|
-- Minimal fold display (VS Code style - just shows first line)
|
|
vim.opt_local.foldtext = ''
|
|
end,
|
|
})
|
|
|
|
-- Also set after LSP attaches (flutter-tools might reset it)
|
|
vim.api.nvim_create_autocmd('LspAttach', {
|
|
group = fold_augroup,
|
|
callback = function(args)
|
|
local client = vim.lsp.get_client_by_id(args.data.client_id)
|
|
if client and client.name == 'dartls' then
|
|
vim.opt_local.foldmethod = 'expr'
|
|
vim.opt_local.foldexpr = 'nvim_treesitter#foldexpr()'
|
|
vim.opt_local.foldlevel = 99 -- Everything unfolded
|
|
end
|
|
end,
|
|
})
|
|
|
|
-- ========================================================================
|
|
-- FLUTTER-SPECIFIC KEYMAPS
|
|
-- ========================================================================
|
|
-- These keymaps are only available when editing Dart files
|
|
-- They provide quick access to common Flutter commands
|
|
-- ========================================================================
|
|
vim.api.nvim_create_autocmd('FileType', {
|
|
pattern = 'dart',
|
|
callback = function()
|
|
local opts = { buffer = true, silent = true }
|
|
|
|
-- ========================================================================
|
|
-- ENABLE TREESITTER FOLDING FOR DART FILES
|
|
-- ========================================================================
|
|
-- Set fold method to use Treesitter for Flutter widgets
|
|
vim.opt_local.foldmethod = 'expr'
|
|
vim.opt_local.foldexpr = 'nvim_treesitter#foldexpr()'
|
|
vim.opt_local.foldenable = false -- Start with folds open
|
|
vim.opt_local.foldlevel = 99
|
|
vim.opt_local.foldlevelstart = 99
|
|
|
|
-- Flutter run/quit
|
|
-- WORKFLOW:
|
|
-- 1. First time: <leader>fd to select device
|
|
-- 2. Then: <leader>fr to run (uses selected device)
|
|
-- 3. Subsequent runs: <leader>fr uses same device
|
|
vim.keymap.set('n', '<leader>fr', '<cmd>FlutterRun<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Run app' }))
|
|
vim.keymap.set('n', '<leader>fR', '<cmd>FlutterRestart<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Hot restart' }))
|
|
vim.keymap.set('n', '<leader>fh', '<cmd>FlutterReload<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Hot reload' }))
|
|
vim.keymap.set('n', '<leader>fq', '<cmd>FlutterQuit<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Quit app' }))
|
|
|
|
-- Code Actions (Cmd+. equivalent) - wrap, remove, extract widgets, etc.
|
|
vim.keymap.set('n', '<leader>.', vim.lsp.buf.code_action, vim.tbl_extend('force', opts, { desc = 'Flutter: Code actions (Cmd+.)' }))
|
|
vim.keymap.set('v', '<leader>.', vim.lsp.buf.code_action, vim.tbl_extend('force', opts, { desc = 'Flutter: Code actions (Cmd+.)' }))
|
|
-- Alternative: use the default LSP keymap
|
|
vim.keymap.set('n', 'gra', vim.lsp.buf.code_action, vim.tbl_extend('force', opts, { desc = '[G]oto Code [A]ction' }))
|
|
vim.keymap.set('v', 'gra', vim.lsp.buf.code_action, vim.tbl_extend('force', opts, { desc = '[G]oto Code [A]ction' }))
|
|
|
|
-- Device management
|
|
-- Use <leader>fd to see/select devices FIRST, then <leader>fr will use that device
|
|
vim.keymap.set('n', '<leader>fd', '<cmd>FlutterDevices<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Select device' }))
|
|
vim.keymap.set('n', '<leader>fe', '<cmd>FlutterEmulators<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Launch emulator' }))
|
|
|
|
-- Dev tools and debugging
|
|
vim.keymap.set('n', '<leader>fo', '<cmd>FlutterOutlineToggle<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Toggle outline' }))
|
|
vim.keymap.set('n', '<leader>ft', '<cmd>FlutterDevTools<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Start DevTools' }))
|
|
vim.keymap.set(
|
|
'n',
|
|
'<leader>fc',
|
|
'<cmd>FlutterCopyProfilerUrl<cr>',
|
|
vim.tbl_extend('force', opts, { desc = 'Flutter: Copy profiler URL' })
|
|
)
|
|
|
|
-- Attach/Detach
|
|
vim.keymap.set('n', '<leader>fa', '<cmd>FlutterAttach<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Attach to app' }))
|
|
vim.keymap.set('n', '<leader>fD', '<cmd>FlutterDetach<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Detach from app' }))
|
|
|
|
-- Logs
|
|
vim.keymap.set('n', '<leader>fL', '<cmd>FlutterLogToggle<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Toggle logs' }))
|
|
|
|
-- LSP
|
|
vim.keymap.set('n', '<leader>fl', '<cmd>FlutterLspRestart<cr>', vim.tbl_extend('force', opts, { desc = 'Flutter: Restart LSP' }))
|
|
|
|
-- ========================================================================
|
|
-- DEBUG KEYMAPS - Available only in Dart files
|
|
-- ========================================================================
|
|
-- Function key shortcuts (standard debugging)
|
|
vim.keymap.set('n', '<F5>', function()
|
|
require('dap').continue()
|
|
end, vim.tbl_extend('force', opts, { desc = 'Debug: Start/Continue' }))
|
|
|
|
vim.keymap.set('n', '<F10>', function()
|
|
require('dap').step_over()
|
|
end, vim.tbl_extend('force', opts, { desc = 'Debug: Step Over' }))
|
|
|
|
vim.keymap.set('n', '<F11>', function()
|
|
require('dap').step_into()
|
|
end, vim.tbl_extend('force', opts, { desc = 'Debug: Step Into' }))
|
|
|
|
vim.keymap.set('n', '<F12>', function()
|
|
require('dap').step_out()
|
|
end, vim.tbl_extend('force', opts, { desc = 'Debug: Step Out' }))
|
|
|
|
-- Leader-based debug commands
|
|
vim.keymap.set('n', '<leader>db', function()
|
|
require('dap').toggle_breakpoint()
|
|
end, vim.tbl_extend('force', opts, { desc = '[D]ebug: Toggle [B]reakpoint' }))
|
|
|
|
vim.keymap.set('n', '<leader>dB', function()
|
|
require('dap').set_breakpoint(vim.fn.input 'Breakpoint condition: ')
|
|
end, vim.tbl_extend('force', opts, { desc = '[D]ebug: Set Conditional [B]reakpoint' }))
|
|
|
|
vim.keymap.set('n', '<leader>dc', function()
|
|
require('dap').continue()
|
|
end, vim.tbl_extend('force', opts, { desc = '[D]ebug: [C]ontinue' }))
|
|
|
|
vim.keymap.set('n', '<leader>dt', function()
|
|
require('dap').terminate()
|
|
end, vim.tbl_extend('force', opts, { desc = '[D]ebug: [T]erminate' }))
|
|
|
|
vim.keymap.set('n', '<leader>du', function()
|
|
require('dapui').toggle()
|
|
end, vim.tbl_extend('force', opts, { desc = '[D]ebug: Toggle [U]I' }))
|
|
|
|
-- Register groups with which-key
|
|
require('which-key').add {
|
|
{ '<leader>f', group = '[F]lutter', mode = 'n' },
|
|
{ '<leader>d', group = '[D]ebug', mode = 'n' },
|
|
}
|
|
end,
|
|
})
|
|
end,
|
|
},
|
|
|
|
-- ========================================================================
|
|
-- DART TREESITTER - Ensure dart parser is installed for proper folding
|
|
-- ========================================================================
|
|
{
|
|
'nvim-treesitter/nvim-treesitter',
|
|
ft = 'dart',
|
|
opts = function(_, opts)
|
|
-- Ensure Dart parser is installed
|
|
opts.ensure_installed = opts.ensure_installed or {}
|
|
vim.list_extend(opts.ensure_installed, { 'dart' })
|
|
return opts
|
|
end,
|
|
},
|
|
}
|