feat!: remove support to older than 0.11 nvim versions

sidlatau · sidlatau · commit 5c0ad1f01365 · 2026-05-03T15:51:28.000+03:00
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml
@@ -45,7 +45,7 @@ body:
           - **OS**: Ubuntu 20.04
           - **Flutter version**: 3.7.0
           - **Is flutter in $PATH**: yes
-          - **neovim version**: 0.8.3
+          - **neovim version**: 0.11.0
       value: |
         - OS:
         - Flutter version:
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
@@ -42,7 +42,7 @@ jobs:
         uses: kdheepak/panvimdoc@main
         with:
           vimdoc: flutter-tools
-          version: "Neovim >= 0.8.0"
+          version: "Neovim >= 0.11"
           demojify: true
           treesitter: true
       - name: Push changes
diff --git a/README.md b/README.md
@@ -32,16 +32,15 @@ nnoremap K <Cmd>lua vim.lsp.buf.hover()<CR>
 nnoremap gd <Cmd>lua vim.lsp.buf.definition()<CR>
  " Open code actions using the default lsp UI, if you want to change this please see the plugins above
 nnoremap <leader>ca <Cmd>lua vim.lsp.buf.code_action()<CR>
- " Open code actions for the selected visual range
-xnoremap <leader>ca <Cmd>lua vim.lsp.buf.range_code_action()<CR>
+xnoremap <leader>ca <Cmd>lua vim.lsp.buf.code_action()<CR>
 ```
 
 Please note this is not a replacement for reading the documentation, this is only to show new users what
 some basic setup might look like.
 
 ## Prerequisites
 
-- neovim 0.8.0+
+- Neovim 0.11+
 
 ## Installation
 
@@ -159,14 +158,21 @@ require("flutter-tools").setup {} -- use defaults
 - `FlutterDetach` - Ends a running session locally but keeps the process running on the device.
 - `FlutterOutlineToggle` - Toggle the outline window showing the widget tree for the given file.
 - `FlutterOutlineOpen` - Opens an outline window showing the widget tree for the given file.
+- `FlutterVisualDebug` - Toggle Flutter visual debugging.
+- `FlutterChangeTargetPlatform` - Cycle the target platform override for the running app.
+- `FlutterToggleBrightness` - Toggle the app brightness override.
 - `FlutterDevTools` - Starts a Dart Dev Tools server.
 - `FlutterDevToolsActivate` - Activates a Dart Dev Tools server.
+- `FlutterOpenDevTools` - Open the currently connected DevTools page.
+- `FlutterInspectWidget` - Toggle widget inspection for the running app.
 - `FlutterCopyProfilerUrl` - Copies the profiler url to your system clipboard (+ register). Note that commands `FlutterRun` and
   `FlutterDevTools` must be executed first.
+- `FlutterPubGet` - Run `flutter pub get` in the project root.
+- `FlutterPubUpgrade [args]` - Run `flutter pub upgrade` with optional extra arguments.
 - `FlutterLspRestart` - This command restarts the dart language server, and is intended for situations where it begins to work incorrectly.
 - `FlutterSuper` - Go to super class, method using custom LSP method `dart/textDocument/super`.
 - `FlutterReanalyze` - Forces LSP server reanalyze using custom LSP method `dart/reanalyze`.
-- `FlutterRename` - Renames and updates imports if `lsp.settings.renameFilesWithClasses == "always"`
+- `FlutterRename` - Rename a symbol and update imports if `lsp.settings.renameFilesWithClasses == "always"`.
 - `FlutterLogClear` - Clears the log buffer.
 - `FlutterLogToggle` - Toggles the log buffer.
 
diff --git a/doc/flutter-tools.txt b/doc/flutter-tools.txt
@@ -1,5 +1,5 @@
 *flutter-tools.txt*
-                             For Neovim >= 0.8.0    Last change: 2026 April 23
+                              For Neovim >= 0.11    Last change: 2026 May 03
 
 ==============================================================================
 Table of Contents                            *flutter-tools-table-of-contents*
@@ -62,9 +62,8 @@ A minimal native LSP configuration might look like:
      " Jump to definition
     nnoremap gd <Cmd>lua vim.lsp.buf.definition()<CR>
      " Open code actions using the default lsp UI, if you want to change this please see the plugins above
-    nnoremap <leader>ca <Cmd>lua vim.lsp.buf.code_action()<CR>
-     " Open code actions for the selected visual range
-    xnoremap <leader>ca <Cmd>lua vim.lsp.buf.range_code_action()<CR>
+     nnoremap <leader>ca <Cmd>lua vim.lsp.buf.code_action()<CR>
+     xnoremap <leader>ca <Cmd>lua vim.lsp.buf.code_action()<CR>
 <
 
 Please note this is not a replacement for reading the documentation, this is
@@ -73,7 +72,7 @@ only to show new users what some basic setup might look like.
 
 PREREQUISITES                 *flutter-tools-flutter-tools.nvim-prerequisites*
 
-- neovim 0.8.0+
+- Neovim 0.11+
 
 
 INSTALLATION                   *flutter-tools-flutter-tools.nvim-installation*
@@ -193,14 +192,21 @@ APP VERSION
 - `FlutterDetach` - Ends a running session locally but keeps the process running on the device.
 - `FlutterOutlineToggle` - Toggle the outline window showing the widget tree for the given file.
 - `FlutterOutlineOpen` - Opens an outline window showing the widget tree for the given file.
+- `FlutterVisualDebug` - Toggle Flutter visual debugging.
+- `FlutterChangeTargetPlatform` - Cycle the target platform override for the running app.
+- `FlutterToggleBrightness` - Toggle the app brightness override.
 - `FlutterDevTools` - Starts a Dart Dev Tools server.
 - `FlutterDevToolsActivate` - Activates a Dart Dev Tools server.
+- `FlutterOpenDevTools` - Open the currently connected DevTools page.
+- `FlutterInspectWidget` - Toggle widget inspection for the running app.
 - `FlutterCopyProfilerUrl` - Copies the profiler url to your system clipboard (+ register). Note that commands `FlutterRun` and
     `FlutterDevTools` must be executed first.
+- `FlutterPubGet` - Run `flutter pub get` in the project root.
+- `FlutterPubUpgrade [args]` - Run `flutter pub upgrade` with optional extra arguments.
 - `FlutterLspRestart` - This command restarts the dart language server, and is intended for situations where it begins to work incorrectly.
 - `FlutterSuper` - Go to super class, method using custom LSP method `dart/textDocument/super`.
 - `FlutterReanalyze` - Forces LSP server reanalyze using custom LSP method `dart/reanalyze`.
-- `FlutterRename` - Renames and updates imports if `lsp.settings.renameFilesWithClasses == "always"`
+- `FlutterRename` - Rename a symbol and update imports if `lsp.settings.renameFilesWithClasses == "always"`.
 - `FlutterLogClear` - Clears the log buffer.
 - `FlutterLogToggle` - Toggles the log buffer.
 
diff --git a/lua/flutter-tools/config.lua b/lua/flutter-tools/config.lua
@@ -65,17 +65,9 @@ local function validate_prefs(prefs)
       end
     )
   end
-  if vim.fn.has("nvim-0.11") == 1 then
-    vim.validate("outline", prefs.outline, "table", true)
-    vim.validate("dev_log", prefs.dev_log, "table", true)
-    vim.validate("closing_tags", prefs.closing_tags, "table", true)
-  else
-    vim.validate({
-      outline = { prefs.outline, "table", true },
-      dev_log = { prefs.dev_log, "table", true },
-      closing_tags = { prefs.closing_tags, "table", true },
-    })
-  end
+  vim.validate("outline", prefs.outline, "table", true)
+  vim.validate("dev_log", prefs.dev_log, "table", true)
+  vim.validate("closing_tags", prefs.closing_tags, "table", true)
 end
 
 ---Create a proportional split using a percentage specified as a float
diff --git a/lua/flutter-tools/dev_tools.lua b/lua/flutter-tools/dev_tools.lua
@@ -207,7 +207,7 @@ end
 
 function M.stop()
   if devtools_pid then
-    local uv = vim.loop
+    local uv = vim.uv
     uv.kill(devtools_pid, uv.constants.SIGTERM)
     devtools_pid = nil
     devtools_url = nil
diff --git a/lua/flutter-tools/devices.lua b/lua/flutter-tools/devices.lua
@@ -64,7 +64,15 @@ function M.to_selection_entries(result, device_type)
   if not result or #result < 1 then return {} end
   if not device_type then device_type = DEVICE end
   local devices = get_devices(result, device_type)
-  if #devices == 0 then vim.tbl_map(function(item) return { text = item } end, result) end
+  if #devices == 0 then
+    return vim.tbl_map(function(item)
+      return {
+        text = item,
+        type = ui.entry_type.INFO,
+        data = nil,
+      }
+    end, result)
+  end
   return vim.tbl_map(function(device)
     local has_platform = device.platform and device.platform ~= ""
     return {
diff --git a/lua/flutter-tools/executable.lua b/lua/flutter-tools/executable.lua
@@ -30,7 +30,7 @@ local Job = require("plenary.job")
 
 local fn = vim.fn
 local fs = vim.fs
-local luv = vim.loop
+local uv = vim.uv
 
 local M = {}
 
@@ -124,13 +124,13 @@ end
 
 local function flutter_bin_from_fvm()
   local fvm_root =
-    fs.dirname(fs.find(".fvm", { path = luv.cwd(), upward = true, type = "directory" })[1])
+    fs.dirname(fs.find(".fvm", { path = uv.cwd(), upward = true, type = "directory" })[1])
 
   local binary_name = path.is_windows and "flutter.bat" or "flutter"
   local flutter_bin_symlink = path.join(fvm_root, ".fvm", "flutter_sdk", "bin", binary_name)
   flutter_bin_symlink = fn.exepath(flutter_bin_symlink)
 
-  local flutter_bin = luv.fs_realpath(flutter_bin_symlink)
+  local flutter_bin = uv.fs_realpath(flutter_bin_symlink)
   if path.exists(flutter_bin_symlink) and path.exists(flutter_bin) then return flutter_bin end
 end
 
diff --git a/lua/flutter-tools/lsp/color/utils.lua b/lua/flutter-tools/lsp/color/utils.lua
@@ -32,32 +32,15 @@ end
 ---@return RGB rgb_table
 --- FIXME: this currently does not support transparent backgrounds. Need a replacement for bg_rgb
 function M.rgba_to_rgb(rgba, bg_rgb)
-  if vim.fn.has("nvim-0.11") == 1 then
-    vim.validate("rgba", rgba, "table", true)
-    vim.validate("bg_rgb", bg_rgb, "table", false)
-    vim.validate("r", rgba.r, "number", true)
-    vim.validate("g", rgba.g, "number", true)
-    vim.validate("b", rgba.b, "number", true)
-    vim.validate("a", rgba.a, "number", true)
-    vim.validate("bg_r", bg_rgb.r, "number", true)
-    vim.validate("bg_g", bg_rgb.g, "number", true)
-    vim.validate("bg_b", bg_rgb.b, "number", true)
-  else
-    vim.validate({
-      rgba = { rgba, "table", true },
-      bg_rgb = { bg_rgb, "table", false },
-      r = { rgba.r, "number", true },
-      g = { rgba.g, "number", true },
-      b = { rgba.b, "number", true },
-      a = { rgba.a, "number", true },
-    })
-
-    vim.validate({
-      bg_r = { bg_rgb.r, "number", true },
-      bg_g = { bg_rgb.g, "number", true },
-      bg_b = { bg_rgb.b, "number", true },
-    })
-  end
+  vim.validate("rgba", rgba, "table", true)
+  vim.validate("bg_rgb", bg_rgb, "table", false)
+  vim.validate("r", rgba.r, "number", true)
+  vim.validate("g", rgba.g, "number", true)
+  vim.validate("b", rgba.b, "number", true)
+  vim.validate("a", rgba.a, "number", true)
+  vim.validate("bg_r", bg_rgb.r, "number", true)
+  vim.validate("bg_g", bg_rgb.g, "number", true)
+  vim.validate("bg_b", bg_rgb.b, "number", true)
 
   local r = rgba.r * rgba.a + bg_rgb.r * (1 - rgba.a)
   local g = rgba.g * rgba.a + bg_rgb.g * (1 - rgba.a)
@@ -70,19 +53,10 @@ end
 ---@param rgb RGB with keys 'r', 'g', 'b' in [0,255]
 ---@return string 6 digit hex representing the rgb params
 local function rgb_to_hex(rgb)
-  if vim.fn.has("nvim-0.11") == 1 then
-    vim.validate("rgb", rgb, "table", false)
-    vim.validate("r", rgb.r, "number", false)
-    vim.validate("g", rgb.g, "number", false)
-    vim.validate("b", rgb.b, "number", false)
-  else
-    vim.validate({
-      rgb = { rgb, "table", false },
-      r = { rgb.r, "number", false },
-      g = { rgb.g, "number", false },
-      b = { rgb.b, "number", false },
-    })
-  end
+  vim.validate("rgb", rgb, "table", false)
+  vim.validate("r", rgb.r, "number", false)
+  vim.validate("g", rgb.g, "number", false)
+  vim.validate("b", rgb.b, "number", false)
   return tohex(bor(lshift(rgb.r, 16), lshift(rgb.g, 8), rgb.b), 6)
 end
 
@@ -98,11 +72,7 @@ function M.rgba_to_hex(rgba, bg_rgb) return rgb_to_hex(M.rgba_to_rgb(rgba, bg_rg
 ---@param rgb_24bit number 24-bit RGB value
 ---@return RGB
 function M.decode_24bit_rgb(rgb_24bit)
-  if vim.fn.has("nvim-0.11") == 1 then
-    vim.validate("rgb_24bit", rgb_24bit, "number", true)
-  else
-    vim.validate({ rgb_24bit = { rgb_24bit, "number", true } })
-  end
+  vim.validate("rgb_24bit", rgb_24bit, "number", true)
   local r = band(rshift(rgb_24bit, 16), 255)
   local g = band(rshift(rgb_24bit, 8), 255)
   local b = band(rgb_24bit, 255)
@@ -219,15 +189,8 @@ end
 ---@param color_infos table of `ColorInformation` objects to highlight.
 -- See https://microsoft.github.io/language-server-protocol/specification#textDocument_documentColor
 function M.buf_color(client_id, bufnr, color_infos, _)
-  if vim.fn.has("nvim-0.11") == 1 then
-    vim.validate("bufnr", bufnr, "number", true)
-    vim.validate("color_infos", color_infos, "table", true)
-  else
-    vim.validate({
-      bufnr = { bufnr, "number", true },
-      color_infos = { color_infos, "table", true },
-    })
-  end
+  vim.validate("bufnr", bufnr, "number", true)
+  vim.validate("color_infos", color_infos, "table", true)
   if not color_infos or not bufnr then return end
   local c = config.lsp.color
 
@@ -250,15 +213,8 @@ end
 ---@param client_id number client id
 ---@param bufnr number buffer id
 function M.buf_clear_color(client_id, bufnr)
-  if vim.fn.has("nvim-0.11") == 1 then
-    vim.validate("client_id", client_id, "number", true)
-    vim.validate("bufnr", bufnr, "number", true)
-  else
-    vim.validate({
-      client_id = { client_id, "number", true },
-      bufnr = { bufnr, "number", true },
-    })
-  end
+  vim.validate("client_id", client_id, "number", true)
+  vim.validate("bufnr", bufnr, "number", true)
   if api.nvim_buf_is_valid(bufnr) then api.nvim_buf_clear_namespace(bufnr, CLIENT_NS, 0, -1) end
 end
 
diff --git a/lua/flutter-tools/lsp/utils.lua b/lua/flutter-tools/lsp/utils.lua
@@ -4,8 +4,7 @@ local lsp = vim.lsp
 
 M.SERVER_NAME = "dartls"
 
--- TODO: Remove after compatibility with Neovim=0.9 is dropped
-local get_clients = vim.fn.has("nvim-0.10") == 1 and lsp.get_clients or lsp.get_active_clients
+local get_clients = lsp.get_clients
 
 ---@param bufnr number?
 ---@return vim.lsp.Client?
diff --git a/lua/flutter-tools/resolve_url.lua b/lua/flutter-tools/resolve_url.lua
@@ -2,9 +2,11 @@
 -- https://github.com/dart-lang/dart-vim-plugin/blob/4bdc04e2540edf90fda2812434c11d19dc04bc8f/autoload/dart.vim#L94
 local M = {}
 
+local uv = vim.uv
+
 local function resolve(path)
-  -- Use vim.loop.fs_realpath to resolve symbolic links and get the absolute path
-  local real_path = vim.loop.fs_realpath(path)
+  -- Use vim.uv.fs_realpath to resolve symbolic links and get the absolute path
+  local real_path = uv.fs_realpath(path)
   -- If the path cannot be resolved, return the original
   return real_path or path
 end
diff --git a/lua/flutter-tools/runners/debugger_runner.lua b/lua/flutter-tools/runners/debugger_runner.lua
@@ -146,7 +146,7 @@ local function handle_inspect_event(isolate_id)
 
     if location and location.file and location.line then
       local file = location.file:gsub("^file://", "")
-      if vim.loop.os_uname().sysname == "Windows_NT" then
+      if vim.uv.os_uname().sysname == "Windows_NT" then
         -- On Windows, the file URI may start with an extra slash
         file = file:gsub("^/", "")
       end
diff --git a/lua/flutter-tools/ui.lua b/lua/flutter-tools/ui.lua
@@ -5,6 +5,7 @@ local fmt = string.format
 local entry_type = {
   CODE_ACTION = 1,
   DEVICE = 2,
+  INFO = 3,
 }
 
 ---@generic T
@@ -109,6 +110,12 @@ local function get_telescope_picker_config(items, title, on_select)
           hint = data.platform,
           command = function() on_select(data) end,
         }
+      elseif item.type == entry_type.INFO then
+        return {
+          id = item.text,
+          label = item.text,
+          command = function() end,
+        }
       end
     end, filtered),
     { title = title }
@@ -129,7 +136,7 @@ function M.select(opts)
     -- custom key for dressing.nvim
     telescope = get_telescope_picker_config(lines, title, on_select),
   }, function(item)
-    if not item then return end
+    if not item or item.data == nil then return end
     on_select(item.data)
   end)
 end
diff --git a/lua/flutter-tools/utils/config_utils.lua b/lua/flutter-tools/utils/config_utils.lua
@@ -11,7 +11,7 @@ local lsp = lazy.require("flutter-tools.lsp") ---@module "flutter-tools.utils"
 function M.get_cwd(project_conf)
   if project_conf and project_conf.cwd then
     local resolved_path = path.get_absolute_path(project_conf.cwd)
-    if not vim.loop.fs_stat(resolved_path) then
+    if not vim.uv.fs_stat(resolved_path) then
       return ui.notify("Provided cwd does not exist: " .. resolved_path, ui.ERROR)
     end
     return resolved_path
diff --git a/lua/flutter-tools/utils/init.lua b/lua/flutter-tools/utils/init.lua
@@ -146,9 +146,7 @@ function M.emit_event(event, opts)
   api.nvim_exec_autocmds("User", { pattern = event, data = data })
 end
 
--- TODO: Remove after compatibility with Neovim=0.9 is dropped
-M.islist = vim.fn.has("nvim-0.10") == 1 and vim.islist or vim.tbl_islist
-local flatten = function(t) return vim.iter(t):flatten():totable() end
-M.flatten = vim.fn.has("nvim-0.11") == 1 and flatten or vim.tbl_flatten
+M.islist = vim.islist
+M.flatten = function(t) return vim.iter(t):flatten():totable() end
 
 return M
diff --git a/lua/flutter-tools/utils/path.lua b/lua/flutter-tools/utils/path.lua
diff --git a/lua/flutter-tools/vm_service.lua b/lua/flutter-tools/vm_service.lua
diff --git a/tests/devices_spec.lua b/tests/devices_spec.lua
diff --git a/tests/minimal_init.lua b/tests/minimal_init.lua
diff --git a/tests/path_spec.lua b/tests/path_spec.lua
