nvim: complete refactoring

.config/nvim/lua/plugins/barbecue.lua

@@ -1,5 +1,5 @@
 return {
-  {
+  -- vs code like topbar
     "utilyre/barbecue.nvim",
     name = "barbecue",
     version = "*",
@@ -10,7 +10,6 @@ return {
     opts = {
       theme = {
         normal = { bg = "#272727" },
-      }
+      },
     },
-  }
 }

.config/nvim/lua/plugins/blink-pairs.lua

@@ -1,10 +1,9 @@
 return {
+  -- rainbow auto-pairs
   "saghen/blink.pairs",
   version = "*", -- (recommended) only required with prebuilt binaries
-
   -- download prebuilt binaries from github releases
   dependencies = "saghen/blink.download",
-
   --- @module 'blink.pairs'
   --- @type blink.pairs.Config
   opts = {

.config/nvim/lua/plugins/comment.lua

@@ -1,7 +1,5 @@
 return {
   -- commenting improvements
-  {
-    'numtostr/comment.nvim',
-    opts = {}
-  }
+  "numtostr/comment.nvim",
+  opts = {},
 }

.config/nvim/lua/plugins/conform.lua

@@ -1,20 +1,18 @@
 return {
   -- improved refactoring
-  {
-    "stevearc/conform.nvim",
-    config = function()
-      require("conform").setup({
-        formatters_by_ft = {
-          lua = { "stylua" },
-          markdown = { "mdformat" },
-          python = { "isort", "yapf" },
-          sh = { "shfmt" },
-          bash = { "shfmt" },
-          zsh = { "shfmt" },
-          tex = { "latexindent" },
-          yaml = { "yamlfmt" },
-        },
-      })
-    end,
-  },
+  "stevearc/conform.nvim",
+  config = function()
+    require("conform").setup({
+      formatters_by_ft = {
+        lua = { "stylua" },
+        markdown = { "mdformat" },
+        python = { "isort", "yapf" },
+        sh = { "shfmt" },
+        bash = { "shfmt" },
+        zsh = { "shfmt" },
+        tex = { "latexindent" },
+        yaml = { "yamlfmt" },
+      },
+    })
+  end,
 }

.config/nvim/lua/plugins/csvview.lua

@@ -1,17 +1,16 @@
 return {
-  {
-    "hat0uma/csvview.nvim",
-    opts = {
-      parser = { comments = { "#", "//" } },
-      keymaps = {
-        textobject_field_inner = { "if", mode = { "o", "x" } },
-        textobject_field_outer = { "af", mode = { "o", "x" } },
-        jump_next_field_end = { "<Tab>", mode = { "n", "v" } },
-        jump_prev_field_end = { "<S-Tab>", mode = { "n", "v" } },
-        jump_next_row = { "<Enter>", mode = { "n", "v" } },
-        jump_prev_row = { "<S-Enter>", mode = { "n", "v" } },
-      },
+  -- improved csv handling
+  "hat0uma/csvview.nvim",
+  opts = {
+    parser = { comments = { "#", "//" } },
+    keymaps = {
+      textobject_field_inner = { "if", mode = { "o", "x" } },
+      textobject_field_outer = { "af", mode = { "o", "x" } },
+      jump_next_field_end = { "<Tab>", mode = { "n", "v" } },
+      jump_prev_field_end = { "<S-Tab>", mode = { "n", "v" } },
+      jump_next_row = { "<Enter>", mode = { "n", "v" } },
+      jump_prev_row = { "<S-Enter>", mode = { "n", "v" } },
     },
-    cmd = { "CsvViewEnable", "CsvViewDisable", "CsvViewToggle" },
-  }
+  },
+  cmd = { "CsvViewEnable", "CsvViewDisable", "CsvViewToggle" },
 }

.config/nvim/lua/plugins/diffview.lua

@@ -1,7 +1,5 @@
 return {
   -- side by side git diffs for merge conflicts
-  {
-    'sindrets/diffview.nvim',
-    opts = {}
-  }
+  "sindrets/diffview.nvim",
+  opts = {},
 }

.config/nvim/lua/plugins/fterm.lua

@@ -1,7 +1,5 @@
 return {
   -- floating terminal to toggle
-  {
-    'numtostr/fterm.nvim',
-    opts = {}
-  }
+  "numtostr/fterm.nvim",
+  opts = {},
 }

.config/nvim/lua/plugins/gitsigns.lua

@@ -1,7 +1,5 @@
 return {
   -- display git status per line
-  {
-    'lewis6991/gitsigns.nvim',
-    opts = {}
-  }
+  "lewis6991/gitsigns.nvim",
+  opts = {},
 }

.config/nvim/lua/plugins/goto-preview.lua

@@ -1,6 +1,7 @@
 return {
+  -- preview definitions using floating windows
   "rmagatti/goto-preview",
-  dependencies = 'rmagatti/logger.nvim',
+  dependencies = "rmagatti/logger.nvim",
   config = function()
     require("goto-preview").setup({})
   end,

.config/nvim/lua/plugins/indent-blankline.lua

@@ -1,9 +1,7 @@
 return {
   -- show indentation lines
-  {
-    'lukas-reineke/indent-blankline.nvim',
-    event = "BufReadPre",
-    main = "ibl",
-    opts = {}
-  }
+  "lukas-reineke/indent-blankline.nvim",
+  event = "BufReadPre",
+  main = "ibl",
+  opts = {},
 }

.config/nvim/lua/plugins/knap.lua

@@ -1,9 +1,8 @@
 return {
   {
-    'frabjous/knap',
-    ft = { 'tex' },
+    "frabjous/knap",
+    ft = { "tex" },
     config = function()
-
       local function detect_engine()
         local first_line = vim.api.nvim_buf_get_lines(0, 0, 1, false)[1] or ""
         if first_line:match("^%%%s*xelatex") then
@@ -17,11 +16,9 @@ return {
         local engine = detect_engine()
 
         if engine == "xelatex" then
-          vim.g.knap_settings.textopdf =
-            "xelatex -synctex=1 -interaction=batchmode %docroot%"
+          vim.g.knap_settings.textopdf = "xelatex -synctex=1 -interaction=batchmode %docroot%"
         else
-          vim.g.knap_settings.textopdf =
-            "pdflatex -synctex=1 -interaction=batchmode %docroot%"
+          vim.g.knap_settings.textopdf = "pdflatex -synctex=1 -interaction=batchmode %docroot%"
         end
       end
 
@@ -29,27 +26,25 @@ return {
         delay = 100,
         texoutputext = "pdf",
         textopdf = "xelatex -synctex=1 -interaction=batchmode %docroot%",
-        textopdfviewerlaunch =
-          "zathura --synctex-editor-command 'nvim --headless -es --cmd \"lua require('\"'\"'knaphelper'\"'\"').relayjump('\"'\"'%servername%'\"'\"','\"'\"'%{input}'\"'\"',%{line},0)\"' ./%outputfile%",
+        textopdfviewerlaunch = "zathura --synctex-editor-command 'nvim --headless -es --cmd \"lua require('\"'\"'knaphelper'\"'\"').relayjump('\"'\"'%servername%'\"'\"','\"'\"'%{input}'\"'\"',%{line},0)\"' ./%outputfile%",
         textopdfviewerrefresh = "reload",
-        textopdfforwardjump =
-          "zathura --synctex-forward=%line%:%column%:%srcfile% %outputfile%",
+        textopdfforwardjump = "zathura --synctex-forward=%line%:%column%:%srcfile% %outputfile%",
       }
 
       vim.api.nvim_create_autocmd("User", {
         pattern = "KnapShowView",
-        callback = set_engine
+        callback = set_engine,
       })
 
       vim.api.nvim_create_autocmd("User", {
         pattern = "KnapCompile",
-        callback = set_engine
+        callback = set_engine,
       })
 
       vim.api.nvim_create_autocmd("BufWritePost", {
         pattern = "*.tex",
-        callback = set_engine
+        callback = set_engine,
       })
-    end
-  }
+    end,
+  },
 }

.config/nvim/lua/plugins/leap.lua

@@ -1,15 +1,13 @@
 return {
   -- improved movement
-  {
-    "ggandor/leap.nvim",
-    config = function()
-      require("leap").opts.highlight_unlabeled_phase_one_targets = true
-      require("leap").opts.equivalence_classes = { " \t\r\n", "([{", ")]}", "'\"`" }
-      require("leap").opts.special_keys.prev_target = "<backspace>"
-      require("leap").opts.special_keys.prev_group = "<backspace>"
-      require("leap.user").set_repeat_keys("<enter>", "<backspace>")
-      require("leap").opts.safe_labels = "sfnut/SFNLHMUGTZ?"
-      require("leap").opts.labels = "sfnjklhodweimbuyvrgtaqpcxz/SFNJKLHODWEIMBUYVRGTAQPCXZ?"
-    end,
-  },
+  "ggandor/leap.nvim",
+  config = function()
+    require("leap").opts.highlight_unlabeled_phase_one_targets = true
+    require("leap").opts.equivalence_classes = { " \t\r\n", "([{", ")]}", "'\"`" }
+    require("leap").opts.special_keys.prev_target = "<backspace>"
+    require("leap").opts.special_keys.prev_group = "<backspace>"
+    require("leap.user").set_repeat_keys("<enter>", "<backspace>")
+    require("leap").opts.safe_labels = "sfnut/SFNLHMUGTZ?"
+    require("leap").opts.labels = "sfnjklhodweimbuyvrgtaqpcxz/SFNJKLHODWEIMBUYVRGTAQPCXZ?"
+  end,
 }

.config/nvim/lua/plugins/lsp_signature.lua

@@ -1,14 +1,12 @@
 return {
   -- show function signature while typing
-  {
-    'ray-x/lsp_signature.nvim',
-    opts = {
-      bind = true,
-      handler_opts = {
-        border = "none"
-      },
-      hint_prefix = Hint_sign,
-      hint_scheme = "DiagnosticSignHint"
-    }
-  }
+  "ray-x/lsp_signature.nvim",
+  opts = {
+    bind = true,
+    handler_opts = {
+      border = "none",
+    },
+    hint_prefix = Hint_sign,
+    hint_scheme = "DiagnosticSignHint",
+  },
 }

.config/nvim/lua/plugins/lualine.lua

@@ -1,82 +1,80 @@
 return {
   -- statusline
-  {
-    "nvim-lualine/lualine.nvim",
-    dependencies = {
-      {
-        "nvim-tree/nvim-web-devicons",
-        lazy = true,
-      },
-      {
-        "f-person/git-blame.nvim",
-        config = function()
-          vim.g.gitblame_display_virtual_text = 0
-        end,
-      },
-      { "tiyn/tccs.nvim" },
-      {
-        "tiyn/action-hints.nvim",
-        config = function()
-          require("action-hints").setup({
-            template = {
-              -- definition = { text = "D", color = "#add8e6" },
-              -- references = { text = "R%s", color = "#ff6666" },
-              definition = { text = Definition_sign, color = "#add8e6" },
-              references = { text = Reference_sign, color = "#ff6666" },
-            },
-          })
-        end,
-      },
+  "nvim-lualine/lualine.nvim",
+  dependencies = {
+    {
+      "nvim-tree/nvim-web-devicons",
+      lazy = true,
     },
-    config = function()
-      require("lualine").setup({
-        options = {
-          globalstatus = true,
-          symbols = {
-            error = Error_sign,
-            warn = Warn_sign,
-            hint = Hint_sign,
-            info = Info_sign,
+    {
+      "f-person/git-blame.nvim",
+      config = function()
+        vim.g.gitblame_display_virtual_text = 0
+      end,
+    },
+    { "tiyn/tccs.nvim" },
+    {
+      "tiyn/action-hints.nvim",
+      config = function()
+        require("action-hints").setup({
+          template = {
+            -- definition = { text = "D", color = "#add8e6" },
+            -- references = { text = "R%s", color = "#ff6666" },
+            definition = { text = Definition_sign, color = "#add8e6" },
+            references = { text = Reference_sign, color = "#ff6666" },
           },
-          theme = "tccs",
-          component_separators = { left = "", right = "" },
-          section_separators = { left = "", right = "" },
-        },
-        sections = {
-          lualine_b = {
-            {
-              require("gitblame").get_current_blame_text,
-              cond = require("gitblame").is_blame_text_available,
-            },
-          },
-          lualine_c = {},
-          lualine_x = {
-            require("action-hints").statusline,
-            "encoding",
-            "fileformat",
-            {
-              "filetype",
-              icon_only = true,
-            },
-          },
-          lualine_y = {
-            {
-              "filename",
-              file_status = true,
-              newfile_status = true,
-              path = 1,
-              shorting_target = 50,
-              symbols = {
-                modified = Lualine_signs["modified"],
-                readonly = Lualine_signs["readonly"],
-                unnamed = Lualine_signs["unnamed"],
-                newfile = Lualine_signs["newfile"],
-              },
-            },
-          },
-          lualine_z = { "progress", "location" },
-        },
-      })
-    end,
+        })
+      end,
+    },
   },
+  config = function()
+    require("lualine").setup({
+      options = {
+        globalstatus = true,
+        symbols = {
+          error = Error_sign,
+          warn = Warn_sign,
+          hint = Hint_sign,
+          info = Info_sign,
+        },
+        theme = "tccs",
+        component_separators = { left = "", right = "" },
+        section_separators = { left = "", right = "" },
+      },
+      sections = {
+        lualine_b = {
+          {
+            require("gitblame").get_current_blame_text,
+            cond = require("gitblame").is_blame_text_available,
+          },
+        },
+        lualine_c = {},
+        lualine_x = {
+          require("action-hints").statusline,
+          "encoding",
+          "fileformat",
+          {
+            "filetype",
+            icon_only = true,
+          },
+        },
+        lualine_y = {
+          {
+            "filename",
+            file_status = true,
+            newfile_status = true,
+            path = 1,
+            shorting_target = 50,
+            symbols = {
+              modified = Lualine_signs["modified"],
+              readonly = Lualine_signs["readonly"],
+              unnamed = Lualine_signs["unnamed"],
+              newfile = Lualine_signs["newfile"],
+            },
+          },
+        },
+        lualine_z = { "progress", "location" },
+      },
+    })
+  end,
 }

.config/nvim/lua/plugins/mason.lua

@@ -1,52 +1,50 @@
 return {
   -- lang server installations
-  {
-    "williamboman/mason.nvim",
-    dependencies = {
-      {
-        "nvimtools/none-ls.nvim",
-        config = function()
-          require("null-ls").setup({
-            sources = {
-              -- assembler
-              require("null-ls").builtins.formatting.asmfmt,
-              -- lua
-              require("null-ls").builtins.formatting.stylua,
-              -- markdown
-              require("null-ls").builtins.formatting.mdformat,
-              -- python
-              require("null-ls").builtins.formatting.isort,
-              require("null-ls").builtins.formatting.yapf,
-              -- shell
-              require("null-ls").builtins.formatting.shfmt,
-              -- yaml
-              require("null-ls").builtins.formatting.yamlfmt,
-            },
-          })
-        end,
-      },
-      {
-        "jay-babu/mason-null-ls.nvim",
-        opts = {
-          automatic_installation = true,
-          ensure_installed = {
+  "williamboman/mason.nvim",
+  dependencies = {
+    {
+      "nvimtools/none-ls.nvim",
+      config = function()
+        require("null-ls").setup({
+          sources = {
             -- assembler
-            "asmfmt",
+            require("null-ls").builtins.formatting.asmfmt,
             -- lua
-            "stylua",
+            require("null-ls").builtins.formatting.stylua,
             -- markdown
-            "mdformat",
+            require("null-ls").builtins.formatting.mdformat,
             -- python
-            "isort",
-            "yapf",
+            require("null-ls").builtins.formatting.isort,
+            require("null-ls").builtins.formatting.yapf,
             -- shell
-            "shfmt",
+            require("null-ls").builtins.formatting.shfmt,
             -- yaml
-            "yamlfmt",
+            require("null-ls").builtins.formatting.yamlfmt,
           },
+        })
+      end,
+    },
+    {
+      "jay-babu/mason-null-ls.nvim",
+      opts = {
+        automatic_installation = true,
+        ensure_installed = {
+          -- assembler
+          "asmfmt",
+          -- lua
+          "stylua",
+          -- markdown
+          "mdformat",
+          -- python
+          "isort",
+          "yapf",
+          -- shell
+          "shfmt",
+          -- yaml
+          "yamlfmt",
         },
       },
     },
-    opts = { ui = { icons = Install_signs } },
   },
+  opts = { ui = { icons = Install_signs } },
 }

.config/nvim/lua/plugins/modes.lua

@@ -1,8 +1,7 @@
 return {
-  {
-    "mvllow/modes.nvim",
-    config = function()
-      require("modes").setup()
-    end,
-  },
+  -- decorations for the current line mode
+  "mvllow/modes.nvim",
+  config = function()
+    require("modes").setup()
+  end,
 }

.config/nvim/lua/plugins/molten.lua

@@ -1,61 +1,60 @@
 return {
-  {
-    "benlubas/molten-nvim",
-    version = "^1.0.0",
-    dependencies = {
-      {
-        "3rd/image.nvim",
-        opts = {
-          backend = "ueberzug",
-          max_width = 100,
-          max_height = 12,
-          max_height_window_percentage = math.huge,
-          max_width_window_percentage = math.huge,
-          window_overlap_clear_enabled = true,
-          window_overlap_clear_ft_ignore = { "cmp_menu", "cmp_docs", "" },
-        },
+  -- jupyter notebook support
+  "benlubas/molten-nvim",
+  version = "^1.0.0",
+  dependencies = {
+    {
+      "3rd/image.nvim",
+      opts = {
+        backend = "ueberzug",
+        max_width = 100,
+        max_height = 12,
+        max_height_window_percentage = math.huge,
+        max_width_window_percentage = math.huge,
+        window_overlap_clear_enabled = true,
+        window_overlap_clear_ft_ignore = { "cmp_menu", "cmp_docs", "" },
       },
-      {
-        "quarto-dev/quarto-nvim",
-        dependencies = {
-          "jmbuhr/otter.nvim",
-          "nvim-treesitter/nvim-treesitter",
-        },
-        opts = {
-          lspFeatures = {
-            languages = { "python" },
-            chunks = "all",
-            diagnostics = {
-              enabled = true,
-              triggers = { "BufWritePost" },
-            },
-            completion = {
-              enabled = true,
-            },
-          },
-          codeRunner = {
+    },
+    {
+      "quarto-dev/quarto-nvim",
+      dependencies = {
+        "jmbuhr/otter.nvim",
+        "nvim-treesitter/nvim-treesitter",
+      },
+      opts = {
+        lspFeatures = {
+          languages = { "python" },
+          chunks = "all",
+          diagnostics = {
+            enabled = true,
+            triggers = { "BufWritePost" },
+          },
+          completion = {
             enabled = true,
-            default_method = "molten",
           },
         },
-      },
-      {
-        "GCBallesteros/jupytext.nvim",
-        opts = {
-          style = "markdown",
-          output_extension = "md",
-          force_ft = "markdown",
+        codeRunner = {
+          enabled = true,
+          default_method = "molten",
         },
       },
     },
-    build = ":UpdateRemotePlugins",
-    init = function()
-      vim.g.molten_auto_open_output = false
-      vim.g.molten_wrap_output = true
-      vim.g.molten_virt_text_output = true
-      vim.g.molten_virt_lines_off_by_1 = true
-      vim.g.molten_image_provider = "image.nvim"
-      vim.g.molten_output_win_max_height = 20
-    end,
+    {
+      "GCBallesteros/jupytext.nvim",
+      opts = {
+        style = "markdown",
+        output_extension = "md",
+        force_ft = "markdown",
+      },
+    },
   },
+  build = ":UpdateRemotePlugins",
+  init = function()
+    vim.g.molten_auto_open_output = false
+    vim.g.molten_wrap_output = true
+    vim.g.molten_virt_text_output = true
+    vim.g.molten_virt_lines_off_by_1 = true
+    vim.g.molten_image_provider = "image.nvim"
+    vim.g.molten_output_win_max_height = 20
+  end,
 }

.config/nvim/lua/plugins/nvim-cmp.lua

@@ -1,88 +1,86 @@
 return {
   -- autocompletion and its sources and snippets
-  {
-    'hrsh7th/nvim-cmp',
-    dependencies = {
-      'nvim-lua/plenary.nvim',
-      'onsails/lspkind-nvim',
-      -- cmp sources
-      'hrsh7th/cmp-buffer',
-      'hrsh7th/cmp-path',
-      'uga-rosa/cmp-dictionary',
-      'lukas-reineke/cmp-under-comparator',
-      -- luasnip
-      {
-        'l3mon4d3/luasnip',
-        config = function()
-          require("luasnip.loaders.from_snipmate").lazy_load()
-        end,
-        version = "v2.*",
-        build = "make install_jsregexp",
-        dependencies = { 'saadparwaiz1/cmp_luasnip' }
-      },
+  "hrsh7th/nvim-cmp",
+  dependencies = {
+    "nvim-lua/plenary.nvim",
+    "onsails/lspkind-nvim",
+    -- cmp sources
+    "hrsh7th/cmp-buffer",
+    "hrsh7th/cmp-path",
+    "uga-rosa/cmp-dictionary",
+    "lukas-reineke/cmp-under-comparator",
+    -- luasnip
+    {
+      "l3mon4d3/luasnip",
+      config = function()
+        require("luasnip.loaders.from_snipmate").lazy_load()
+      end,
+      version = "v2.*",
+      build = "make install_jsregexp",
+      dependencies = { "saadparwaiz1/cmp_luasnip" },
     },
-    config = function()
-      local cmp = require("cmp")
-      cmp.setup {
-        sorting = {
-          comparators = {
-            cmp.config.compare.offset,
-            cmp.config.compare.exact,
-            cmp.config.compare.score,
-            require "cmp-under-comparator".under,
-            cmp.config.compare.kind,
-            cmp.config.compare.sort_text,
-            cmp.config.compare.length,
-            cmp.config.compare.order
-          },
+  },
+  config = function()
+    local cmp = require("cmp")
+    cmp.setup({
+      sorting = {
+        comparators = {
+          cmp.config.compare.offset,
+          cmp.config.compare.exact,
+          cmp.config.compare.score,
+          require("cmp-under-comparator").under,
+          cmp.config.compare.kind,
+          cmp.config.compare.sort_text,
+          cmp.config.compare.length,
+          cmp.config.compare.order,
         },
-        snippet = {
-          expand = function(args)
-            require("luasnip").lsp_expand(args.body)
+      },
+      snippet = {
+        expand = function(args)
+          require("luasnip").lsp_expand(args.body)
+        end,
+      },
+      mapping = {
+        ["<S-Tab>"] = cmp.mapping(function(fallback)
+          if cmp.visible() then
+            cmp.select_prev_item()
+          elseif require("luasnip").jumpable(-1) then
+            require("luasnip").jump(-1)
+          else
+            fallback()
           end
-        },
-        mapping = {
-          ['<S-Tab>'] = cmp.mapping(function(fallback)
-            if cmp.visible() then
-              cmp.select_prev_item()
-            elseif require("luasnip").jumpable(-1) then
-              require("luasnip").jump(-1)
-            else
-              fallback()
-            end
-          end, { "i", "s" }),
-          ['<Tab>'] = cmp.mapping(function(fallback)
-            if cmp.visible() then
-              cmp.select_next_item()
-            elseif require("luasnip").expand_or_jumpable() then
-              require("luasnip").expand_or_jump()
-            else
-              fallback()
-            end
-          end, { "i", "s" }),
-          ['<C-e>'] = cmp.mapping.close(),
-          ['<CR>'] = cmp.mapping.confirm {
-            behavior = cmp.ConfirmBehavior.Replace,
-            select = true
-          }
-        },
-        sources = {
-          { name = 'nvim_lsp' },
-          { name = 'luasnip' },
-          { name = 'path' },
-          { name = 'buffer' },
-          { name = 'dictionary' }
-        },
-        formatting = {
-          format = require("lspkind").cmp_format({
-            mode = "symbol_text",
-            preset = "codicons",
-            maxwidth = 50,
-            menu = Menu_signs,
-            symbol_map = Lsp_signs
-          })
-        }
-      }
-    end
-  }
+        end, { "i", "s" }),
+        ["<Tab>"] = cmp.mapping(function(fallback)
+          if cmp.visible() then
+            cmp.select_next_item()
+          elseif require("luasnip").expand_or_jumpable() then
+            require("luasnip").expand_or_jump()
+          else
+            fallback()
+          end
+        end, { "i", "s" }),
+        ["<C-e>"] = cmp.mapping.close(),
+        ["<CR>"] = cmp.mapping.confirm({
+          behavior = cmp.ConfirmBehavior.Replace,
+          select = true,
+        }),
+      },
+      sources = {
+        { name = "nvim_lsp" },
+        { name = "luasnip" },
+        { name = "path" },
+        { name = "buffer" },
+        { name = "dictionary" },
+      },
+      formatting = {
+        format = require("lspkind").cmp_format({
+          mode = "symbol_text",
+          preset = "codicons",
+          maxwidth = 50,
+          menu = Menu_signs,
+          symbol_map = Lsp_signs,
+        }),
+      },
+    })
+  end,
 }

.config/nvim/lua/plugins/nvim-colorizer.lua

@@ -1,29 +1,27 @@
 return {
   -- showing color of hex values, etc
-  {
-    'ChristianChiarulli/nvim-colorizer.lua',
-    opts = {
-      filetypes = {
-        '*',
-        '!markdown'
-      },
-      user_default_options = {
-        RGB = true,
-        RRGGBB = true,
-        RRGGBBAA = true,
-        AARRGGBB = true,
-        rgb_fn = true,
-        hsl_fn = true,
-        css_fn = true,
-        mode = "virtualtext",
-        virtualtext = " ",
-      },
-      -- all the sub-options of filetypes apply to buftypes
-      buftypes = {
-        "*",
-        "!prompt",
-        "!popup"
-      },
-    }
-  }
+  "ChristianChiarulli/nvim-colorizer.lua",
+  opts = {
+    filetypes = {
+      "*",
+      "!markdown",
+    },
+    user_default_options = {
+      RGB = true,
+      RRGGBB = true,
+      RRGGBBAA = true,
+      AARRGGBB = true,
+      rgb_fn = true,
+      hsl_fn = true,
+      css_fn = true,
+      mode = "virtualtext",
+      virtualtext = " ",
+    },
+    -- all the sub-options of filetypes apply to buftypes
+    buftypes = {
+      "*",
+      "!prompt",
+      "!popup",
+    },
+  },
 }

.config/nvim/lua/plugins/nvim-docs-view.lua

@@ -1,4 +1,5 @@
 return {
+  -- hover documentation
   "tiyn/nvim-docs-view",
   lazy = true,
   cmd = "DocsViewToggle",

.config/nvim/lua/plugins/nvim-hlslens.lua

@@ -1,8 +1,7 @@
 return {
-  {
-    'kevinhwang91/nvim-hlslens',
-    opts = {
-      calm_down = true,
-    }
-  }
+  -- improved virtual text
+  "kevinhwang91/nvim-hlslens",
+  opts = {
+    calm_down = true,
+  },
 }

.config/nvim/lua/plugins/nvim-lilypond-suite.lua

@@ -1,4 +1,5 @@
 return {
+  -- lillypond integration
   "martineausimon/nvim-lilypond-suite",
   dependencies = "uga-rosa/cmp-dictionary",
   config = function()

.config/nvim/lua/plugins/nvim-lspconfig.lua

@@ -1,98 +1,99 @@
 return {
   -- lang server management
-  {
-    "neovim/nvim-lspconfig",
-    dependencies = {
-      "williamboman/mason-lspconfig.nvim",
-      {
-        "mrcjkb/rustaceanvim",
-        version = "^6",
-        lazy = false,
-      },
-      {
-        "hrsh7th/cmp-nvim-lsp",
-        config = function()
-          Capabilities = require("cmp_nvim_lsp").default_capabilities()
-          Capabilities.textDocument.foldingRange = {
-            dynamicRegistration = false,
-            lineFoldingOnly = true,
-          }
-        end,
-      },
+  "neovim/nvim-lspconfig",
+  dependencies = {
+    "williamboman/mason-lspconfig.nvim",
+    {
+      "mrcjkb/rustaceanvim",
+      version = "^6",
+      lazy = false,
     },
-    config = function()
-      require("mason-lspconfig").setup({
-        automatic_setup = true,
-        ensure_installed = {
-          -- assembler
-          "asm_lsp",
-          -- c
-          "clangd",
-          -- docker
-          "dockerls",
-          -- go
-          "gopls",
-          -- html
-          "html",
-          -- json
-          "jsonls",
-          -- xml
-          "lemminx",
-          -- latex
-          "ltex",
-          "texlab",
-          -- lua
-          "lua_ls",
-          -- markdown
-          "marksman",
-          -- nim
-          "nimls",
-          -- python
-          "pyright",
-          -- r
-          "r_language_server",
-          -- shell
-          "bashls",
-          -- sql
-          "sqlls",
-          -- typescript / javascript
-          "ts_ls",
-          -- yaml
-          "yamlls",
-        },
-      })
-      local default_flags = {
-        debounce_text_changes = 150,
-        allow_incremental_sync = true,
-        progress = true,
-      }
-      local servers = {
-        ltex = {
-          settings = {
-            ltex = {
-              -- language = "de-DE",
-              enabled = { "latex", "markdown" },
-              dictionary = Dictionaries,
-            },
+    {
+      "hrsh7th/cmp-nvim-lsp",
+      config = function()
+        Capabilities = require("cmp_nvim_lsp").default_capabilities()
+        Capabilities.textDocument.foldingRange = {
+          dynamicRegistration = false,
+          lineFoldingOnly = true,
+        }
+      end,
+    },
+  },
+  config = function()
+    require("mason-lspconfig").setup({
+      automatic_setup = true,
+      ensure_installed = {
+        -- assembler
+        "asm_lsp",
+        -- c
+        "clangd",
+        -- docker
+        "dockerls",
+        -- go
+        "gopls",
+        -- html
+        "html",
+        -- json
+        "jsonls",
+        -- xml
+        "lemminx",
+        -- latex
+        "ltex",
+        "texlab",
+        -- lua
+        "lua_ls",
+        -- markdown
+        "marksman",
+        -- nim
+        "nimls",
+        -- python
+        "pyright",
+        -- r
+        "r_language_server",
+        -- shell
+        "bashls",
+        -- sql
+        "sqlls",
+        -- typescript / javascript
+        "ts_ls",
+        -- yaml
+        "yamlls",
+      },
+    })
+    local default_flags = {
+      debounce_text_changes = 150,
+      allow_incremental_sync = true,
+      progress = true,
+    }
+    local servers = {
+      ltex = {
+        settings = {
+          ltex = {
+            -- language = "de-DE",
+            enabled = { "latex", "markdown" },
+            dictionary = Dictionaries,
           },
         },
-        lua_ls = {
-          settings = {
-            lua = {
-              diagnostics = { globals = { "vim" } },
-              telemetry = { enable = false },
-            },
+      },
+      lua_ls = {
+        settings = {
+          lua = {
+            diagnostics = { globals = { "vim" } },
+            telemetry = { enable = false },
           },
         },
-        pyright = {}
-      }
-      for name, config in pairs(servers) do
-        vim.lsp.config(name, vim.tbl_extend("force", config, {
+      },
+      pyright = {},
+    }
+    for name, config in pairs(servers) do
+      vim.lsp.config(
+        name,
+        vim.tbl_extend("force", config, {
           on_attach = on_attach,
           capabilities = Capabilities,
           flags = default_flags,
-        }))
-      end
-    end,
-  },
+        })
+      )
+    end
+  end,
 }

.config/nvim/lua/plugins/nvim-scrollbar.lua

@@ -1,59 +1,57 @@
 return {
   -- scrollbar with git and diagnostics support for easier navigation
-  {
-    'petertriho/nvim-scrollbar',
-    dependencies = {
-      'kevinhwang91/nvim-hlslens',
-      'lewis6991/gitsigns.nvim'
-    },
-    config = function()
-      require("scrollbar").setup({
-        marks = {
-          Cursor = {
-            highlight = "Normal"
-          },
-          Search = {
-            highlight = "Special"
-          },
-          Error = {
-            highlight = "DiagnosticSignError"
-          },
-          Warn = {
-            highlight = "DiagnosticSignWarn"
-          },
-          Info = {
-            highlight = "DiagnosticSignInfo"
-          },
-          Hint = {
-            highlight = "DiagnosticSignHint"
-          },
-          Misc = {
-            highlight = "Special"
-          },
-          GitAdd = {
-            highlight = "GitGutterAdd"
-          },
-          GitChange = {
-            highlight = "GitGutterChange"
-          },
-          GitDelete = {
-            highlight = "GitGutterDelete"
-          }
+  "petertriho/nvim-scrollbar",
+  dependencies = {
+    "kevinhwang91/nvim-hlslens",
+    "lewis6991/gitsigns.nvim",
+  },
+  config = function()
+    require("scrollbar").setup({
+      marks = {
+        Cursor = {
+          highlight = "Normal",
         },
-        excluded_filetypes = {
-          "cmp_docs",
-          "cmp_menu",
-          "noice",
-          "prompt",
-          "TelescopePrompt",
-          "NvimTree",
-          "Navbuddy",
-          "FTerm",
-          "",
+        Search = {
+          highlight = "Special",
         },
-      })
-      require("scrollbar.handlers.search").setup()
-      require("scrollbar.handlers.gitsigns").setup()
-    end
-  }
+        Error = {
+          highlight = "DiagnosticSignError",
+        },
+        Warn = {
+          highlight = "DiagnosticSignWarn",
+        },
+        Info = {
+          highlight = "DiagnosticSignInfo",
+        },
+        Hint = {
+          highlight = "DiagnosticSignHint",
+        },
+        Misc = {
+          highlight = "Special",
+        },
+        GitAdd = {
+          highlight = "GitGutterAdd",
+        },
+        GitChange = {
+          highlight = "GitGutterChange",
+        },
+        GitDelete = {
+          highlight = "GitGutterDelete",
+        },
+      },
+      excluded_filetypes = {
+        "cmp_docs",
+        "cmp_menu",
+        "noice",
+        "prompt",
+        "TelescopePrompt",
+        "NvimTree",
+        "Navbuddy",
+        "FTerm",
+        "",
+      },
+    })
+    require("scrollbar.handlers.search").setup()
+    require("scrollbar.handlers.gitsigns").setup()
+  end,
 }

.config/nvim/lua/plugins/nvim-surround.lua

@@ -1,9 +1,7 @@
 return {
   -- additional quote/parantheses funtions
-  {
-    'kylechui/nvim-surround',
-    version = "*",
-    event = "VeryLazy",
-    opts = {}
-  }
+  "kylechui/nvim-surround",
+  version = "*",
+  event = "VeryLazy",
+  opts = {},
 }

.config/nvim/lua/plugins/nvim-tree.lua

@@ -1,30 +1,28 @@
 return {
   -- fileexplorer on the side
-  {
-    "nvim-tree/nvim-tree.lua",
-    cmd = "NvimTreeToggle",
-    dependencies = {
-      {
-        "nvim-tree/nvim-web-devicons",
-        lazy = true
+  "nvim-tree/nvim-tree.lua",
+  cmd = "NvimTreeToggle",
+  dependencies = {
+    {
+      "nvim-tree/nvim-web-devicons",
+      lazy = true,
+    },
+  },
+  opts = {
+    sort_by = "case_sensitive",
+    view = {
+      width = 30,
+    },
+    filters = {
+      dotfiles = true,
+    },
+    renderer = {
+      group_empty = true,
+      icons = {
+        glyphs = {
+          git = Git_signs,
+        },
       },
     },
-    opts = {
-      sort_by = "case_sensitive",
-      view = {
-        width = 30,
-      },
-      filters = {
-        dotfiles = true,
-      },
-      renderer = {
-        group_empty = true,
-        icons = {
-          glyphs = {
-            git = Git_signs
-          },
-        },
-      }
-    }
-  }
+  },
 }

.config/nvim/lua/plugins/nvim-treesitter.lua

@@ -1,38 +1,36 @@
 return {
   -- better language highlighting by improved parsing
-  {
-    'nvim-treesitter/nvim-treesitter',
-    build = ':TSUpdate',
-    dependencies = {
-      -- automatically close html-tags
-      'windwp/nvim-ts-autotag',
-      -- color brackets
-      -- 'p00f/nvim-ts-rainbow',
-    },
-    config = function()
-      require("nvim-treesitter.configs").setup({
-        ensure_installed = {
-          "bash",
-          "css",
-          "html",
-          "markdown",
-          "markdown_inline",
-          "latex",
-          "python",
-          "rust",
-          "lua",
-          "yaml",
-        },
-        -- highlight = { enable = true },
-        autotag = { enable = false },
-        -- rainbow = {
-        --   enable = true,
-        --   extended_mode = true,
-        --   max_file_lines = nil,
-        --   -- colors = {},
-        --   -- termcolors = {}
-        -- }
-      })
-    end
-  }
+  "nvim-treesitter/nvim-treesitter",
+  build = ":TSUpdate",
+  dependencies = {
+    -- automatically close html-tags
+    "windwp/nvim-ts-autotag",
+    -- color brackets
+    -- 'p00f/nvim-ts-rainbow',
+  },
+  config = function()
+    require("nvim-treesitter.configs").setup({
+      ensure_installed = {
+        "bash",
+        "css",
+        "html",
+        "markdown",
+        "markdown_inline",
+        "latex",
+        "python",
+        "rust",
+        "lua",
+        "yaml",
+      },
+      -- highlight = { enable = true },
+      autotag = { enable = false },
+      -- rainbow = {
+      --   enable = true,
+      --   extended_mode = true,
+      --   max_file_lines = nil,
+      --   -- colors = {},
+      --   -- termcolors = {}
+      -- }
+    })
+  end,
 }

.config/nvim/lua/plugins/nvim-ufo.lua

@@ -1,20 +1,20 @@
 return {
   -- folding improvements
-  {
-    'kevinhwang91/nvim-ufo',
-    dependencies = { 'kevinhwang91/promise-async' },
-    config = function()
-      require('ufo').setup()
-      vim.api.nvim_create_autocmd({ 'BufEnter', 'FileType' },
-        {
-          pattern = { '*' },
-          callback = function() require("ufo").closeAllFolds() end
-        })
-      vim.api.nvim_create_autocmd({ 'BufEnter', 'FileType' },
-        {
-          pattern = { '*' },
-          callback = function() require("ufo").openAllFolds() end
-        })
-    end
-  }
+  "kevinhwang91/nvim-ufo",
+  dependencies = { "kevinhwang91/promise-async" },
+  config = function()
+    require("ufo").setup()
+    vim.api.nvim_create_autocmd({ "BufEnter", "FileType" }, {
+      pattern = { "*" },
+      callback = function()
+        require("ufo").closeAllFolds()
+      end,
+    })
+    vim.api.nvim_create_autocmd({ "BufEnter", "FileType" }, {
+      pattern = { "*" },
+      callback = function()
+        require("ufo").openAllFolds()
+      end,
+    })
+  end,
 }

.config/nvim/lua/plugins/ogpt.lua

@@ -1,6 +1,7 @@
 return {
-{
-  "huynle/ogpt.nvim",
+  -- ollama llm integration
+  {
+    "huynle/ogpt.nvim",
     event = "VeryLazy",
     opts = {
       default_provider = "ollama",
@@ -11,16 +12,16 @@ return {
           api_host = "http://localhost:11434", -- free resources: https://github.com/cheahjs/free-llm-api-resources
           api_key = "",
           model = "deepseek-r1:7b",
-        }
-      }
+        },
+      },
     },
     dependencies = {
       "MunifTanjim/nui.nvim",
       "nvim-lua/plenary.nvim",
-      "nvim-telescope/telescope.nvim"
-    }
-},
-{
+      "nvim-telescope/telescope.nvim",
+    },
+  },
+  {
     "folke/edgy.nvim",
     event = "VeryLazy",
     init = function()
@@ -135,5 +136,5 @@ return {
         },
       },
     },
-  }
+  },
 }

.config/nvim/lua/plugins/oil.lua

@@ -1,10 +1,8 @@
 return {
   -- rename files in buffer
-  {
-    "stevearc/oil.nvim",
-    ---@module 'oil'
-    ---@type oil.setupopts
-    opts = {},
-    dependencies = { "nvim-mini/mini.icons" },
-  },
+  "stevearc/oil.nvim",
+  ---@module 'oil'
+  ---@type oil.setupopts
+  opts = {},
+  dependencies = { "nvim-mini/mini.icons" },
 }

.config/nvim/lua/plugins/outline.lua

@@ -1,13 +1,12 @@
 return {
-  {
-    "hedyhli/outline.nvim",
-    opts = {
-      outline_window = {
-        width = 25
-      },
-      symbols = {
-        icon_source = 'lspkind',
-      }
-    }
-  }
+  -- outline for code
+  "hedyhli/outline.nvim",
+  opts = {
+    outline_window = {
+      width = 25,
+    },
+    symbols = {
+      icon_source = "lspkind",
+    },
+  },
 }

.config/nvim/lua/plugins/papis.lua

@@ -1,32 +1,16 @@
 return {
+  -- support for papis bibliography manager
   "jghauser/papis.nvim",
   dependencies = {
     "kkharji/sqlite.lua",
     "MunifTanjim/nui.nvim",
-    -- If not already installed, you may also want one of:
     "hrsh7th/nvim-cmp",
-    -- {
-    --   "saghen/blink.cmp",
-    --   config = function()
-    --     require("blink.cmp").setup({
-    --       sources = {
-    --         -- add 'papis' to the list of sources for the yaml filetype
-    --         per_filetype = {
-    --           yaml = { "papis" }
-    --         },
-    --     }
-    --   })
-    --   end,
-    -- },
-    -- Choose one of the following two if not already installed:
     "nvim-telescope/telescope.nvim",
-    -- "folke/snacks.nvim",
-
   },
   config = function()
     require("papis").setup({
-    -- Your configuration goes here
-    enable_keymaps = true,
+      -- Your configuration goes here
+      enable_keymaps = false,
     })
   end,
 }

.config/nvim/lua/plugins/projections.lua

@@ -1,4 +1,5 @@
 return {
+  -- navigate between projects using telescope
   "gnikdroy/projections.nvim",
   dependencies = { "nvim-telescope/telescope.nvim" },
   branch = "pre_release",

.config/nvim/lua/plugins/renamer.lua

@@ -1,9 +1,7 @@
 return {
   -- improved gui for renaming
-  {
-    "filipdutescu/renamer.nvim",
-    branch = "master",
-    dependencies = { "nvim-lua/plenary.nvim" },
-    opts = {},
-  },
+  "filipdutescu/renamer.nvim",
+  branch = "master",
+  dependencies = { "nvim-lua/plenary.nvim" },
+  opts = {},
 }

.config/nvim/lua/plugins/spelunker.lua

@@ -1,12 +1,12 @@
 return {
   -- improve spelling check for coding to feature camelcase, etc
   {
-    'kamykn/spelunker.vim',
-    dependencies = { 'kamykn/popup-menu.nvim' },
+    "kamykn/spelunker.vim",
+    dependencies = { "kamykn/popup-menu.nvim" },
     config = function()
       -- vim.o.nospell = true
       vim.g.enable_spelunker_vim = 0
       vim.g.spelunker_disable_acronym_checking = 1
-    end
-  }
+    end,
+  },
 }

.config/nvim/lua/plugins/tccs.lua

@@ -1,13 +1,13 @@
 return {
   -- colorscheme
   {
-    'tiyn/tccs.nvim',
+    "tiyn/tccs.nvim",
     lazy = false,
     priority = 1000,
     config = function()
-      require('tccs').setup({
-        require('tccs').load()
+      require("tccs").setup({
+        require("tccs").load(),
       })
-    end
-  }
+    end,
+  },
 }

.config/nvim/lua/plugins/telescope.lua

@@ -1,12 +1,12 @@
 return {
   -- fuzzy finder
   {
-    'nvim-telescope/telescope.nvim',
-    version = '0.1.2',
+    "nvim-telescope/telescope.nvim",
+    version = "0.1.2",
     dependencies = {
-      'nvim-lua/plenary.nvim',
-      'archie-judd/telescope-words.nvim'
+      "nvim-lua/plenary.nvim",
+      "archie-judd/telescope-words.nvim",
     },
-    opts = {}
-  }
+    opts = {},
+  },
 }

.config/nvim/lua/plugins/tidy.lua

@@ -4,7 +4,7 @@ return {
     "mcauley-penney/tidy.nvim",
     branch = "main",
     opts = {
-      filetype_exclude = { "diff" }
-    }
-  }
+      filetype_exclude = { "diff" },
+    },
+  },
 }

.config/nvim/lua/plugins/todo-comments.lua

@@ -1,8 +1,8 @@
 return {
   -- todo symbols and highlighting
   {
-    'folke/todo-comments.nvim',
-    dependencies = { 'nvim-lua/plenary.nvim' },
+    "folke/todo-comments.nvim",
+    dependencies = { "nvim-lua/plenary.nvim" },
     opts = {
       keywords = {
         ERRO = { icon = Error_sign, color = "error" },
@@ -12,11 +12,11 @@ return {
         TODO = { icon = Todo_sign, color = "info" },
         INFO = { icon = Info_sign, color = "hint", alt = { "NOTE" } },
         PERF = { icon = Perfect_sign, color = "default" },
-        TEST = { icon = Test_sign, color = "test" }
+        TEST = { icon = Test_sign, color = "test" },
       },
       colors = {
-        default = { "Operator" }
-      }
-    }
-  }
+        default = { "Operator" },
+      },
+    },
+  },
 }

.config/nvim/lua/plugins/trouble.lua

@@ -1,13 +1,11 @@
 return {
   -- list of errors
-  {
-    'folke/trouble.nvim',
-    dependencies = {
-      {
-        'nvim-tree/nvim-web-devicons',
-        lazy = true
-      }
+  "folke/trouble.nvim",
+  dependencies = {
+    {
+      "nvim-tree/nvim-web-devicons",
+      lazy = true,
     },
-    opts = {}
-  }
+  },
+  opts = {},
 }

.config/nvim/lua/plugins/undotree.lua

@@ -1,6 +1,4 @@
 return {
   -- tree style undo visualizer
-  {
-    'mbbill/undotree'
-  }
+  "mbbill/undotree",
 }

.config/nvim/lua/plugins/vim-abolish.lua

@@ -1,8 +1,5 @@
 return {
   -- better substitutions
-  {
-    'tpope/vim-abolish',
-    config = function ()
-    end
-  }
+  "tpope/vim-abolish",
+  config = function() end,
 }

.config/nvim/lua/plugins/vim-illuminate.lua

@@ -1,5 +1,4 @@
 return {
-  {
-    "RRethy/vim-illuminate"
-  }
+  -- highlight other occurences of the same word
+  "RRethy/vim-illuminate",
 }

.config/nvim/lua/plugins/vim-markdown.lua

@@ -1,10 +1,7 @@
 return {
   -- markdown improvements
-  {
-    'preservim/vim-markdown',
-    ft = { 'markdown' },
-    dependencies = { 'godlygeek/tabular' },
-    config = function()
-    end
-  }
+  "preservim/vim-markdown",
+  ft = { "markdown" },
+  dependencies = { "godlygeek/tabular" },
+  config = function() end,
 }

.config/nvim/lua/plugins/which-key.lua

@@ -1,6 +1,4 @@
 return {
   -- improved keybindings, previewing them
-  {
-    "folke/which-key.nvim",
-    }
-  }
+  "folke/which-key.nvim",
+}

.config/nvim/lua/plugins/winshift.lua

@@ -1,7 +1,5 @@
 return {
   -- improved movement of windows
-  {
-    "sindrets/winshift.nvim",
-    opts = {},
-  },
+  "sindrets/winshift.nvim",
+  opts = {},
 }