migration complete

lua/custom/plugins/flutter.lua

@@ -0,0 +1,485 @@
+-- ========================================================================
+-- 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,
+  },
+}