Merge 7d077f43f7 into 3f5ed9e979

* deps: add nvim-dap-go

* go: use dap-go plugin for dap configurations

* docs: update release notes

---------

Co-authored-by: Pei Yang Ching <pei.ching@check24.de>

docs/release-notes/rl-0.7.md

@@ -29,6 +29,7 @@ Release notes for release 0.7
 - Fix broken treesitter-context keybinds in visual mode
 - Deprecate use of `__empty` to define empty tables in lua. Empty attrset are no
   longer filtered and thus should be used instead.
+- Add dap-go for better dap configurations
 
 [jacekpoz](https://github.com/jacekpoz):
 
@@ -40,7 +41,11 @@ Release notes for release 0.7
 
 - Move the `theme` dag entry to before `luaScript`.
 
-- Add rustfmt as the default formatter for Rust
+- Add rustfmt as the default formatter for Rust.
+
+- Enabled the terminal integration of catppuccin for theming Neovim's built-in terminal (this also affects toggleterm).
+
+- Migrate bufferline to setupOpts for more customizability
 
 [NotAShelf](https://github.com/notashelf):
 

flake.lock

@@ -1069,6 +1069,22 @@
         "type": "github"
       }
     },
+    "plugin-nvim-dap-go": {
+      "flake": false,
+      "locked": {
+        "lastModified": 1716775637,
+        "narHash": "sha256-B8A+ven18YgePLxAN3Q/j5NFb0FeTHCQak1uzaNDX9c=",
+        "owner": "leoluz",
+        "repo": "nvim-dap-go",
+        "rev": "a0c5a2b991d7e9304a9a032cf177e22a4b0acda1",
+        "type": "github"
+      },
+      "original": {
+        "owner": "leoluz",
+        "repo": "nvim-dap-go",
+        "type": "github"
+      }
+    },
     "plugin-nvim-dap-ui": {
       "flake": false,
       "locked": {
@@ -1823,6 +1839,7 @@
         "plugin-nvim-colorizer-lua": "plugin-nvim-colorizer-lua",
         "plugin-nvim-cursorline": "plugin-nvim-cursorline",
         "plugin-nvim-dap": "plugin-nvim-dap",
+        "plugin-nvim-dap-go": "plugin-nvim-dap-go",
         "plugin-nvim-dap-ui": "plugin-nvim-dap-ui",
         "plugin-nvim-docs-view": "plugin-nvim-docs-view",
         "plugin-nvim-lightbulb": "plugin-nvim-lightbulb",

flake.nix

@@ -216,6 +216,11 @@
       flake = false;
     };
 
+    plugin-nvim-dap-go = {
+      url = "github:leoluz/nvim-dap-go";
+      flake = false;
+    };
+
     # Filetrees
     plugin-nvim-tree-lua = {
       url = "github:nvim-tree/nvim-tree.lua";

modules/modules.nix

@@ -10,6 +10,7 @@
   # Contains configuration for core neovim features
   # such as spellchecking, mappings, and the init script (init.vim).
   neovim = map (p: ./neovim + "/${p}") [
+    "global"
     "init"
     "mappings"
   ];

modules/neovim/global/default.nix

@@ -0,0 +1,12 @@
+{lib, ...}: let
+  inherit (lib.lists) concatLists;
+  inherit (lib.filesystem) listFilesRecursive;
+in {
+  imports = concatLists [
+    # Configuration options for Neovim UI
+    (listFilesRecursive ./ui)
+
+    # vim.diagnostics
+    [./diagnostics.nix]
+  ];
+}

modules/neovim/global/diagnostics.nix

@@ -0,0 +1,115 @@
+{
+  config,
+  lib,
+  ...
+}: let
+  inherit (lib.options) mkOption mkEnableOption;
+  inherit (lib.types) str bool enum either;
+in {
+  options.vim.diagnostics = {
+    virtual_text = mkOption {
+      type = bool;
+      default = true;
+      description = ''
+        Whether to use virtual text for diagnostics.
+
+        If multiple diagnostics are set for a namespace, one
+        prefix per diagnostic + the last diagnostic message
+        are shown.
+      '';
+    };
+
+    update_in_insert = mkOption {
+      type = bool;
+      default = false;
+      description = ''
+        Whether to update diagnostics in insert mode.
+
+        This is useful for slow diagnostics sources, but can
+        also cause lag in insert mode.
+      '';
+    };
+
+    underline = mkOption {
+      type = bool;
+      default = true;
+      description = ''
+        Whether to underline diagnostics.
+      '';
+    };
+
+    severity_sort = mkOption {
+      type = bool;
+      default = false;
+      description = ''
+        Whether to sort diagnostics by severity.
+
+        This affects the order in which signs and
+        virtual text are displayed. When true, higher
+        severities are displayed before lower severities (e.g.
+        ERROR is displayed before WARN)
+      '';
+    };
+
+    float = {
+      focusable = mkOption {
+        type = bool;
+        default = false;
+        description = ''
+          Whether the floating window is focusable.
+          When true, the floating window can be focused and
+          interacted with. When false, the floating window is
+          not focusable and will not receive input.
+        '';
+      };
+
+      border = mkOption {
+        type = enum ["none" "single" "double" "rounded" "solid" "shadow"];
+        default = config.vim.ui.border.globalStyle;
+        description = ''
+          The border style of the floating window.
+
+          Possible values:
+            - none
+            - single
+            - double
+            - rounded
+            - solid
+            - shadow
+
+          See `:h nvim_open_win` for the available border
+          styles and their definitions.
+        '';
+      };
+
+      source = mkOption {
+        type = either bool (enum ["always" "if_many"]);
+        default = "auto";
+        description = ''
+            The source of the floating window.
+            Possible values:
+          - auto: Use the same source as the diagnostics
+            window.
+          - window: Use the window source.
+          - buffer: Use the buffer source.
+        '';
+      };
+
+      prefix = mkOption {
+        type = str;
+        default = "";
+        description = ''
+          Prefix string for each diagnostic in the floating window
+        '';
+      };
+
+      suffix = mkOption {
+        type = str;
+        default = "";
+        description = ''
+          Suffix string for each diagnostic in the floating window
+        '';
+      };
+    };
+  };
+}

modules/neovim/global/ui/borders.nix

@@ -0,0 +1,51 @@
+{
+  config,
+  lib,
+  ...
+}: let
+  inherit (lib.options) mkOption mkEnableOption;
+  inherit (lib.attrsets) mapAttrs;
+  inherit (lib.lists) optionals;
+  inherit (lib.types) enum;
+
+  cfg = config.vim.ui.borders;
+
+  # See `:h nvim_open_win` for the available border styles
+  # this list can be updated if additional styles are added.
+  defaultStyles = ["none" "single" "double" "rounded" "solid" "shadow"];
+in {
+  options.vim.ui.borders = {
+    enable = mkEnableOption "visible borders for windows that support configurable borders";
+
+    # TODO: support configurable border elements with a lua table converted from a list of str
+    # e.g. [ "╔" "═" "╗" "║" "╝" "═" "╚" "║" ]
+    globalStyle = mkOption {
+      type = enum defaultStyles;
+      default = "single";
+      description = ''
+        The global border style to use.
+      '';
+    };
+
+    plugins = let
+      mkPluginStyleOption = name: {
+        enable = mkEnableOption "borders for the ${name} plugin" // {default = cfg.enable;};
+
+        style = mkOption {
+          type = enum (defaultStyles ++ optionals (name != "which-key") ["shadow"]);
+          default = cfg.globalStyle;
+          description = "The border style to use for the ${name} plugin";
+        };
+      };
+    in
+      mapAttrs (_: mkPluginStyleOption) {
+        # despite not having it listed in example configuration, which-key does support the rounded type
+        # additionally, it supports a "shadow" type that is similar to none but is of higher contrast
+        which-key = "which-key";
+        lspsaga = "lspsaga";
+        nvim-cmp = "nvim-cmp";
+        lsp-signature = "lsp-signature";
+        code-action-menu = "code-actions-menu";
+      };
+  };
+}

modules/neovim/global/ui/icons.nix

@@ -0,0 +1,32 @@
+{lib, ...}: let
+  inherit (lib.options) mkOption;
+  inherit (lib.types) str;
+in {
+  options.vim.ui.icons = {
+    diagnostics = {
+      ERROR = mkOption {
+        type = str;
+        default = " ";
+        description = "The icon to use for error messages";
+      };
+
+      WARN = mkOption {
+        type = str;
+        default = " ";
+        description = "The icon to use for warning messages";
+      };
+
+      INFO = mkOption {
+        type = str;
+        default = " ";
+        description = "The icon to use for info messages";
+      };
+
+      HINT = mkOption {
+        type = str;
+        default = " ";
+        description = "The icon to use for hint messages";
+      };
+    };
+  };
+}

modules/plugins/autopairs/nvim-autopairs/config.nix

@@ -4,8 +4,8 @@
   ...
 }: let
   inherit (lib.modules) mkIf;
+  inherit (lib.trivial) boolToString;
   inherit (lib.nvim.dag) entryAnywhere;
-  inherit (lib.nvim.lua) toLuaObject;
 
   cfg = config.vim.autopairs;
 in {
@@ -13,7 +13,7 @@ in {
     vim.startPlugins = ["nvim-autopairs"];
 
     vim.luaConfigRC.autopairs = entryAnywhere ''
-      require("nvim-autopairs").setup({ map_cr = ${toLuaObject (!config.vim.autocomplete.enable)} })
+      require("nvim-autopairs").setup({ map_cr = ${boolToString (!config.vim.autocomplete.enable)} })
     '';
   };
 }

modules/plugins/languages/clang.nix

@@ -35,7 +35,7 @@
       '';
     };
     clangd = {
-      package = pkgs.clang-tools_16;
+      package = pkgs.clang-tools;
       lspConfig = ''
         local clangd_cap = capabilities
         -- use same offsetEncoding as null-ls

modules/plugins/languages/go.nix

@@ -12,6 +12,7 @@
   inherit (lib.types) bool enum either listOf package str;
   inherit (lib.nvim.types) mkGrammarOption;
   inherit (lib.nvim.lua) expToLua;
+  inherit (lib.nvim.dag) entryAfter;
 
   cfg = config.vim.languages.go;
 
@@ -37,40 +38,6 @@
   debuggers = {
     delve = {
       package = pkgs.delve;
-      dapConfig = ''
-        dap.adapters.delve = {
-          type = "server",
-          port = "''${port}",
-          executable = {
-            command = "${getExe cfg.dap.package}",
-            args = { "dap", "-l", "127.0.0.1:''${port}" },
-          },
-        }
-
-        dap.configurations.go = {
-          {
-            type = "delve",
-            name = "Debug",
-            request = "launch",
-            program = "''${file}",
-          },
-          {
-            type = "delve",
-            name = "Debug test", -- configuration for debugging test files
-            request = "launch",
-            mode = "test",
-            program = "''${file}",
-          },
-          -- works with go.mod packages and sub packages
-          {
-            type = "delve",
-            name = "Debug test (go.mod)",
-            request = "launch",
-            mode = "test",
-            program = "./''${relativeFileDirname}",
-          },
-        }
-      '';
     };
   };
 in {
@@ -102,15 +69,17 @@ in {
 
     dap = {
       enable = mkOption {
-        description = "Enable Go Debug Adapter";
+        description = "Enable Go Debug Adapter via nvim-dap-go plugin";
         type = bool;
         default = config.vim.languages.enableDAP;
       };
+
       debugger = mkOption {
         description = "Go debugger to use";
         type = enum (attrNames debuggers);
         default = defaultDebugger;
       };
+
       package = mkOption {
         description = "Go debugger package.";
         type = package;
@@ -131,8 +100,17 @@ in {
     })
 
     (mkIf cfg.dap.enable {
-      vim.debugger.nvim-dap.enable = true;
-      vim.debugger.nvim-dap.sources.go-debugger = debuggers.${cfg.dap.debugger}.dapConfig;
+      vim = {
+        startPlugins = ["nvim-dap-go"];
+        luaConfigRC.nvim-dap-go = entryAfter ["nvim-dap"] ''
+          require('dap-go').setup {
+            delve = {
+              path = '${getExe cfg.dap.package}',
+            }
+          }
+        '';
+        debugger.nvim-dap.enable = true;
+      };
     })
   ]);
 }

modules/plugins/tabline/nvim-bufferline/config.nix

@@ -6,101 +6,42 @@
   inherit (lib.modules) mkIf mkMerge;
   inherit (lib.nvim.binds) mkLuaBinding mkBinding pushDownDefault;
   inherit (lib.nvim.dag) entryAnywhere;
+  inherit (lib.nvim.lua) toLuaObject;
 
   cfg = config.vim.tabline.nvimBufferline;
-
   self = import ./nvim-bufferline.nix {inherit lib;};
   inherit (self.options.vim.tabline.nvimBufferline) mappings;
 in {
-  config = mkIf cfg.enable (
-    let
-      mouse = {
-        right = "'vertical sbuffer %d'";
-        close = ''
-          function(bufnum)
-            require("bufdelete").bufdelete(bufnum, false)
-          end
-        '';
+  config = mkIf cfg.enable {
+    vim = {
+      startPlugins = [
+        (assert config.vim.visuals.nvimWebDevicons.enable; "nvim-bufferline-lua")
+        "bufdelete-nvim"
+      ];
+
+      maps.normal = mkMerge [
+        (mkLuaBinding cfg.mappings.closeCurrent "require(\"bufdelete\").bufdelete" mappings.closeCurrent.description)
+        (mkBinding cfg.mappings.cycleNext ":BufferLineCycleNext<CR>" mappings.cycleNext.description)
+        (mkBinding cfg.mappings.cycleNext ":BufferLineCycleNext<CR>" mappings.cycleNext.description)
+        (mkBinding cfg.mappings.cyclePrevious ":BufferLineCyclePrev<CR>" mappings.cyclePrevious.description)
+        (mkBinding cfg.mappings.pick ":BufferLinePick<CR>" mappings.pick.description)
+        (mkBinding cfg.mappings.sortByExtension ":BufferLineSortByExtension<CR>" mappings.sortByExtension.description)
+        (mkBinding cfg.mappings.sortByDirectory ":BufferLineSortByDirectory<CR>" mappings.sortByDirectory.description)
+        (mkLuaBinding cfg.mappings.sortById "function() require(\"bufferline\").sort_buffers_by(function (buf_a, buf_b) return buf_a.id < buf_b.id end) end" mappings.sortById.description)
+        (mkBinding cfg.mappings.moveNext ":BufferLineMoveNext<CR>" mappings.moveNext.description)
+        (mkBinding cfg.mappings.movePrevious ":BufferLineMovePrev<CR>" mappings.movePrevious.description)
+      ];
+
+      binds.whichKey.register = pushDownDefault {
+        "<leader>b" = "+Buffer";
+        "<leader>bm" = "BufferLineMove";
+        "<leader>bs" = "BufferLineSort";
+        "<leader>bsi" = "BufferLineSortById";
       };
-    in {
-      vim = {
-        startPlugins = [
-          (assert config.vim.visuals.nvimWebDevicons.enable; "nvim-bufferline-lua")
-          "bufdelete-nvim"
-        ];
 
-        maps.normal = mkMerge [
-          (mkLuaBinding cfg.mappings.closeCurrent "require(\"bufdelete\").bufdelete" mappings.closeCurrent.description)
-          (mkBinding cfg.mappings.cycleNext ":BufferLineCycleNext<CR>" mappings.cycleNext.description)
-          (mkBinding cfg.mappings.cycleNext ":BufferLineCycleNext<CR>" mappings.cycleNext.description)
-          (mkBinding cfg.mappings.cyclePrevious ":BufferLineCyclePrev<CR>" mappings.cyclePrevious.description)
-          (mkBinding cfg.mappings.pick ":BufferLinePick<CR>" mappings.pick.description)
-          (mkBinding cfg.mappings.sortByExtension ":BufferLineSortByExtension<CR>" mappings.sortByExtension.description)
-          (mkBinding cfg.mappings.sortByDirectory ":BufferLineSortByDirectory<CR>" mappings.sortByDirectory.description)
-          (mkLuaBinding cfg.mappings.sortById "function() require(\"bufferline\").sort_buffers_by(function (buf_a, buf_b) return buf_a.id < buf_b.id end) end" mappings.sortById.description)
-          (mkBinding cfg.mappings.moveNext ":BufferLineMoveNext<CR>" mappings.moveNext.description)
-          (mkBinding cfg.mappings.movePrevious ":BufferLineMovePrev<CR>" mappings.movePrevious.description)
-        ];
-
-        binds.whichKey.register = pushDownDefault {
-          "<leader>b" = "+Buffer";
-          "<leader>bm" = "BufferLineMove";
-          "<leader>bs" = "BufferLineSort";
-          "<leader>bsi" = "BufferLineSortById";
-        };
-
-        luaConfigRC.nvimBufferline = entryAnywhere ''
-          require("bufferline").setup{
-             options = {
-                mode = "buffers",
-                numbers = "both",
-                close_command = ${mouse.close},
-                right_mouse_command = ${mouse.right},
-                indicator = {
-                  style = 'icon',
-                  indicator_icon = '▎',
-                },
-                buffer_close_icon = '󰅖',
-                modified_icon = '●',
-                close_icon = '',
-                left_trunc_marker = '',
-                right_trunc_marker = '',
-                max_name_length = 18,
-                max_prefix_length = 15,
-                tab_size = 18,
-                show_buffer_icons = true,
-                show_buffer_close_icons = true,
-                show_close_icon = true,
-                show_tab_indicators = true,
-                persist_buffer_sort = true,
-                --separator_style = "thin",
-                separator_style = { " ", " " },
-                enforce_regular_tabs = true,
-                always_show_bufferline = true,
-                offsets = {
-                  {filetype = "NvimTree", text = "File Explorer", text_align = "center"}
-                },
-                sort_by = 'extension',
-                diagnostics = "nvim_lsp", -- TODO: use coc if it's enabled
-                diagnostics_update_in_insert = true,
-                diagnostics_indicator = function(count, level, diagnostics_dict, context)
-                   local s = ""
-                   for e, n in pairs(diagnostics_dict) do
-                      local sym = e == "error" and ""
-                         or (e == "warning" and "" or "" )
-                      if(sym ~= "") then
-                      s = s .. " " .. n .. sym
-                      end
-                   end
-                   return s
-                end,
-                numbers = function(opts)
-                  return string.format('%s·%s', opts.raise(opts.id), opts.lower(opts.ordinal))
-                end,
-             }
-          }
-        '';
-      };
-    }
-  );
+      luaConfigRC.nvimBufferline = entryAnywhere ''
+        require("bufferline").setup(${toLuaObject cfg.setupOpts})
+      '';
+    };
+  };
 }

modules/plugins/tabline/nvim-bufferline/nvim-bufferline.nix

@@ -1,6 +1,9 @@
 {lib, ...}: let
-  inherit (lib.options) mkEnableOption;
+  inherit (lib.options) mkOption mkEnableOption literalExpression;
+  inherit (lib.types) enum bool either nullOr str int listOf attrs;
+  inherit (lib.generators) mkLuaInline;
   inherit (lib.nvim.binds) mkMappingOption;
+  inherit (lib.nvim.types) mkPluginSetupOption luaInline;
 in {
   options.vim.tabline.nvimBufferline = {
     enable = mkEnableOption "neovim bufferline";
@@ -16,5 +19,385 @@ in {
       moveNext = mkMappingOption "Move next buffer" "<leader>bmn";
       movePrevious = mkMappingOption "Move previous buffer" "<leader>bmp";
     };
+
+    setupOpts = mkPluginSetupOption "Bufferline-nvim" {
+      highlights = mkOption {
+        type = either attrs luaInline;
+        default = {};
+        description = ''
+          Overrides the highlight groups of bufferline.
+
+          See `:help bufferline-highlights`.
+        '';
+      };
+
+      options = {
+        mode = mkOption {
+          type = enum ["tabs" "buffers"];
+          default = "buffers";
+          description = "Mode to use for bufferline";
+        };
+
+        style_preset = mkOption {
+          type = enum ["default" "minimal" "no_bold" "no_italic"];
+          default = "default";
+          apply = value: mkLuaInline "require('bufferline').style_preset.${value}";
+          description = "The base style of bufferline";
+        };
+
+        themable = mkOption {
+          type = bool;
+          default = true;
+          description = ''
+            Whether or not to allow highlight groups to be overriden.
+
+            While false, bufferline.nvim sets highlights as default.
+          '';
+        };
+
+        numbers = mkOption {
+          type = either (enum ["none" "ordinal" "buffer_id" "both"]) luaInline;
+          default = mkLuaInline ''
+            function(opts)
+              return string.format('%s·%s', opts.raise(opts.id), opts.lower(opts.ordinal))
+            end
+          '';
+          description = "Whether or not to show buffer numbers";
+        };
+
+        close_command = mkOption {
+          type = either str luaInline;
+          default = mkLuaInline ''
+            function(bufnum)
+              require("bufdelete").bufdelete(bufnum, false)
+            end
+          '';
+          description = "Command to run when closing a buffer";
+        };
+
+        right_mouse_command = mkOption {
+          type = nullOr (either str luaInline);
+          default = "vertical sbuffer %d";
+          description = "Command to run when right clicking a buffer";
+        };
+
+        left_mouse_command = mkOption {
+          type = nullOr (either str luaInline);
+          default = "buffer %d";
+          description = "Command to run when left clicking a buffer";
+        };
+
+        middle_mouse_command = mkOption {
+          type = nullOr (either str luaInline);
+          default = null;
+          description = "Command to run when middle clicking a buffer";
+        };
+
+        indicator = {
+          icon = mkOption {
+            type = nullOr str;
+            default = null;
+            description = ''
+              The indicatotor icon to use for the current buffer.
+
+              ::: {.warning}
+              This **must** be ommitted while style is not `icon`
+              :::
+            '';
+          };
+
+          style = mkOption {
+            type = enum ["icon" "underline" "none"];
+            default = "underline";
+            description = "Style for indicator";
+          };
+        };
+
+        buffer_close_icon = mkOption {
+          type = str;
+          default = " 󰅖 ";
+          description = "Icon for close button";
+        };
+
+        modified_icon = mkOption {
+          type = str;
+          default = "● ";
+          description = "Icon for modified buffer";
+        };
+
+        close_icon = mkOption {
+          type = str;
+          default = "  ";
+          description = "Icon for close button";
+        };
+
+        left_trunc_marker = mkOption {
+          type = str;
+          default = "";
+          description = "Icon for left truncation";
+        };
+
+        right_trunc_marker = mkOption {
+          type = str;
+          default = "";
+          description = "Icon for right truncation";
+        };
+
+        name_formatter = mkOption {
+          type = nullOr luaInline;
+          default = null;
+          description = ''
+            `name_formatter` can be used to change the buffer's label in the
+            bufferline.
+
+            ::: {.note}
+            Some names can/will break the bufferline so use this at your
+            discretion knowing that it has some limitations that will
+            **NOT** be fixed.
+            :::
+          '';
+        };
+
+        max_name_length = mkOption {
+          type = int;
+          default = 18;
+          description = "Max name length";
+        };
+
+        max_prefix_length = mkOption {
+          type = int;
+          default = 15;
+          description = "Length of the prefix used when a buffer is de-duplicated";
+        };
+
+        truncate_names = mkOption {
+          type = bool;
+          default = true;
+          description = "Truncate names";
+        };
+
+        tab_size = mkOption {
+          type = int;
+          default = 18;
+          description = "The size of the tabs in bufferline";
+        };
+
+        diagnostics = mkOption {
+          type = enum [false "nvim_lsp" "coc"];
+          default = "nvim_lsp";
+          description = "Diagnostics provider to be used in buffer LSP indicators";
+        };
+
+        diagnostics_update_in_insert = mkOption {
+          type = bool;
+          default = false;
+          description = ''
+            Whether to update diagnostics while in insert mode.
+
+            Setting this to true has performance implications, but they may be
+            negligible depending on your setup. Set it to true if you know what
+            you are doing.
+          '';
+        };
+
+        diagnostics_indicator = mkOption {
+          type = nullOr luaInline;
+          default = mkLuaInline ''
+            function(count, level, diagnostics_dict, context)
+              local s = " "
+                for e, n in pairs(diagnostics_dict) do
+                  local sym = e == "error" and "   "
+                    or (e == "warning" and "   " or "  " )
+                  s = s .. n .. sym
+                end
+              return s
+            end
+          '';
+
+          description = ''
+            Function to get the diagnostics indicator.
+            The function should return a string to be used as the indicator.
+
+            Can be set to nil to keep the buffer name highlight, but delete the
+            highlighting.
+          '';
+        };
+
+        custom_filter = mkOption {
+          type = nullOr luaInline;
+          default = null;
+          example = literalExpression ''
+            custom_filter = function(buf_number, buf_numbers)
+              -- filter out filetypes you don't want to see
+              if vim.bo[buf_number].filetype ~= "<i-dont-want-to-see-this>" then
+                return true
+              end
+              -- filter out by buffer name
+              if vim.fn.bufname(buf_number) ~= "<buffer-name-I-dont-want>" then
+                  return true
+              end
+              -- filter out based on arbitrary rules
+              -- e.g. filter out vim wiki buffer from tabline in your work repo
+              if vim.fn.getcwd() == "<work-repo>" and vim.bo[buf_number].filetype ~= "wiki" then
+                  return true
+              end
+              -- filter out by it's index number in list (don't show first buffer)
+              if buf_numbers[1] ~= buf_number then
+                  return true
+              end
+            end
+          '';
+
+          description = ''
+            Custom filter function for filtering out buffers.
+
+            ::: {.note}
+            This will be called a lot, so you are encouraged to keep it as
+            short and lightweight as possible unless you are fully aware
+            of the performance implications.
+            :::
+          '';
+        };
+
+        offsets = mkOption {
+          type = listOf attrs;
+          default = [
+            {
+              filetype = "NvimTree";
+              text = "File Explorer";
+              highlight = "Directory";
+              separator = true;
+            }
+          ];
+          description = "The windows to offset bufferline above, see `:help bufferline-offset`";
+        };
+
+        color_icons = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not to add filetype icon highlights";
+        };
+
+        get_element_icon = mkOption {
+          type = nullOr luaInline;
+          default = null;
+          example = literalExpression ''
+            function(element)
+              local custom_map = {my_thing_ft: {icon = "my_thing_icon", hl = "DevIconDefault"}}
+              return custom_map[element.filetype]
+            end
+          '';
+          description = "The function bufferline uses to get the icon. Recommended to leave as default.";
+        };
+
+        show_buffer_icons = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not to show buffer icons";
+        };
+
+        show_buffer_close_icons = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not to show buffer close icons";
+        };
+
+        show_close_icon = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not to show the close icon";
+        };
+
+        show_tab_indicators = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not to show tab indicators";
+        };
+
+        show_duplicate_prefix = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not to show duplicate buffer prefixes";
+        };
+
+        duplicates_across_groups = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether to consider duplicate paths in different groups as duplicates";
+        };
+
+        persist_buffer_sort = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether or not custom sorted buffers should persist";
+        };
+
+        move_wraps_at_ends = mkOption {
+          type = bool;
+          default = false;
+          description = "Whether or not the move command \"wraps\" at the first or last position";
+        };
+
+        seperator_style = mkOption {
+          type = either (enum ["thick" "thin" "slope" "slant"]) (listOf str);
+          default = [" " " "];
+          description = ''
+            Style of the buffer separator.
+
+            Can be either one of the suspported values, or a list containing
+            **at most** two elements for `focused` and `unfocused` respectively.
+          '';
+        };
+
+        separator_style = mkOption {
+          type = nullOr (either (enum ["slant" "padded_slant" "slope" "padded_slope" "thick" "thin"]) (listOf str));
+          default = "thin";
+          description = ''
+            The type of separator used to separate buffers and tabs.
+
+            Either one of the listed types, or a list of 2 characters for either side.
+          '';
+        };
+
+        enforce_regular_tabs = mkOption {
+          type = bool;
+          default = false;
+          description = "Whether to enforce regular tabs";
+        };
+
+        always_show_bufferline = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether to always show bufferline";
+        };
+
+        auto_toggle_bufferline = mkOption {
+          type = bool;
+          default = true;
+          description = "Whether to auto toggle bufferline";
+        };
+
+        hover = {
+          enabled = mkEnableOption "hover" // {default = true;};
+          delay = mkOption {
+            type = int;
+            default = 200;
+            description = "Delay for hover, in ms";
+          };
+
+          reveal = mkOption {
+            type = listOf str;
+            default = ["close"];
+            description = "Reveal hover window";
+          };
+        };
+
+        sort_by = mkOption {
+          type = either (enum ["insert_after_current" "insert_at_end" "id" "extension" "relative_directory" "directory" "tabs"]) luaInline;
+          default = "extension";
+          description = "Method to sort buffers by. Must be one of the supported values, or an inline Lua value.";
+        };
+      };
+    };
   };
 }

modules/plugins/theme/supported_themes.nix

@@ -53,6 +53,7 @@ in {
       require('catppuccin').setup {
         flavour = "${style}",
         transparent_background = ${boolToString transparent},
+        term_colors = true,
         integrations = {
       	  nvimtree = {
       		  enabled = true,

modules/plugins/ui/borders/borders.nix

@@ -1,46 +0,0 @@
-{
-  config,
-  lib,
-  ...
-}: let
-  inherit (lib.options) mkOption mkEnableOption;
-  inherit (lib.lists) optionals;
-  inherit (lib.types) enum;
-
-  cfg = config.vim.ui.borders;
-
-  defaultStyles = ["none" "single" "double" "rounded"];
-in {
-  options.vim.ui.borders = {
-    enable = mkEnableOption "visible borders for most windows";
-
-    globalStyle = mkOption {
-      type = enum defaultStyles;
-      default = "rounded";
-      description = ''
-        The global border style to use.
-      '';
-    };
-
-    # TODO: make per-plugin borders configurable
-    plugins = let
-      mkPluginStyleOption = name: {
-        enable = mkEnableOption "borders for the ${name} plugin" // {default = cfg.enable;};
-
-        style = mkOption {
-          type = enum (defaultStyles ++ optionals (name != "which-key") ["shadow"]);
-          default = cfg.globalStyle;
-          description = "The border style to use for the ${name} plugin";
-        };
-      };
-    in {
-      # despite not having it listed in example configuration, which-key does support the rounded type
-      # additionally, it supports a "shadow" type that is similar to none but is of higher contrast
-      which-key = mkPluginStyleOption "which-key";
-      lspsaga = mkPluginStyleOption "lspsaga";
-      nvim-cmp = mkPluginStyleOption "nvim-cmp";
-      lsp-signature = mkPluginStyleOption "lsp-signature";
-      code-action-menu = mkPluginStyleOption "code-actions-menu";
-    };
-  };
-}

modules/plugins/ui/borders/default.nix

@@ -1,5 +0,0 @@
-{
-  imports = [
-    ./borders.nix
-  ];
-}

modules/plugins/ui/default.nix

@@ -1,12 +1,11 @@
 {
   imports = [
-    ./noice
-    ./modes
-    ./notifications
-    ./smartcolumn
+    ./breadcrumbs
     ./colorizer
     ./illuminate
-    ./breadcrumbs
-    ./borders
+    ./modes
+    ./noice
+    ./notifications
+    ./smartcolumn
   ];
 }