clean nvim

2025-10-12 19:01:26 +03:00
parent ee1aae1562
commit c19881baf5
42 changed files with 763 additions and 1209 deletions
--- a/config/linux-dev/nvim/docs/docs.md
+++ b/config/linux-dev/nvim/docs/docs.md
@@ -0,0 +1,215 @@
+TODO:
+- wrap up invero theme in separate repo and proper colors?
+    - check plugins logins
+    - cache / create final result
+- simplify coding: ts, lsp, lint, format (check other repos)
+    - how to download parsers and plugins alternative
+- telescope alternative
+- keymaps
+- wrap up everything
+
+```lua
+--[[
+  Neovim Lua config: ways to set things
+
+  - vim.opt : preferred modern API for options (handles lists, cleaner syntax)
+  - vim.g   : global variables (leader key, plugin settings, disable builtins, etc.)
+  - vim.o   : global-only option (rarely needed directly)
+  - vim.wo  : window-local option (applies to current window only, use in autocmds)
+  - vim.bo  : buffer-local option (applies to current buffer only, use in autocmds)
+  - vim.env : set environment variables (like PATH, LANG)
+  - vim.fn  : call Vimscript functions (e.g. vim.fn.getcwd())
+  - vim.cmd : run raw Vimscript/Ex commands (e.g. vim.cmd("colorscheme desert"))
+  - vim.api : low-level Neovim API (create autocmds, keymaps, buffer/window ops, etc.)
+
+  TL;DR -> use vim.opt + vim.g in options.lua for defaults.
+           Use vim.wo/vim.bo only in context-specific tweaks (autocmds).
+           Use vim.env, vim.fn, vim.cmd, vim.api as needed for scripting.
+--]]
+```
+
+## check macos fileS: https://github.com/dsully/dotfiles/blob/main/.data/macos-defaults/globals.yaml
+
+# Used pacakges:
+- rockspaces        Metadata files describing how to build and install a Lua package.
+- luarocks          Package manager for Lua modules. (optional)
+- tree-sitter       Parser generator. Not needed except for using CLI. (optional)
+
+- fd-find (fd)      Alternative to `find`. (optional)
+- ripgrep (rg)      Line-oriented search tool. (recommended)
+
+- git               Revision control system. (requirement)
+- lazygit           Terminal UI for git commands. (optional)
+
+- fzf               Command-line fuzzy finder.
+- curl              Command-line for transferring data specified with URL syntax.
+- wget              Utility for downloading files from the Web.
+- make              
+- cc    Collection of compilers.
+- build-essential   Meta-package that installs standard C/C++ libraries and headers.
+                    These are needed to compile tree-sitter parsers. Run only on the first time.
+    cc (gcc, clang) C compiler. Usually it points to `clang` (on macos) or `gcc` (on linux).
+    g++             C++ compiler.
+    make            Build automation tool from source code.
+
+- unzip             Extraction utility for archives compressed in .zip.
+- ca-certificates   Provides a set of trusted Certificate Authority (CA) certificates.
+- openssh-client    Tools for connecting to remote servers securely over SSH.
+- libssl-dev        Development libraries and headers for OpenSSL.
+- sudo
+- tree
+- jq
+- man-db
+- python3
+- volta             Node manager
+- ncurses ncurses-dev ncurses-libs ncurses-terminfo \
+- check: https://github.com/glepnir/nvim/blob/main/Dockerfile
+
+
+# Currently installed
+- plenary.nvim
+- lazy.nvim
+
+- nvim-treesitter
+- neovim/nvim-lspconfig
+    - williamboman/mason.nvim
+    - williamboman/mason-lspconfig.nvim
+    - j-hui/fidget.nvim
+    - hrsh7th/cmp-nvim-lsp
+    - b0o/schemastore.nvim
+
+- windwp/nvim-ts-autotag # auto close,rename tags
+- nvim-autopairs # auto pair chars
+- stevearc/conform.nvim # formatter
+- nvim-cmp # completion
+    - cmp-path
+    - cmp-nvim-lsp
+
+- nvim-tree.lua # file explorer
+- telescope.nvim
+    - telescope-fzf-native.nvim
+    - telescope-ui-select.nvim
+    - plenary.nvim
+- harpoon # tags
+
+
+# Notes:
+- in lsp change tsserver to vtsls
+
+# New package definition
+- Plugin and Package managers
+    - folke/lazy.nvim
+    - mason-org/mason.nvim
+- TS
+    - nvim-treesitter
+    - nvim-treesitter-textobjects
+- LSP
+    - neovim/nvim-lspconfig
+    
+- nvim-ts-autotag                   tag elements (`</>`)
+- windwp/nvim-autopairs             auto pairs
+- blink.cmp                         autocompletion
+- stevearc/conform.nvim             autoformat
+- mini.ai                           `a/i` motions
+- mini.pairs
+- mini.surround
+- mfussenegger/nvim-lint
+- nvim-lspconfig
+- fzf-lua (replace telescope)
+- ? indent guides
+    - lukas-reineke/indent-blankline.nvim
+    - snacks.indent
+    - mini.indentscope
+    
+## Deps:
+- SchemaStore.nvim
+- mason-lspconfig.nvim
+- mason.nvim
+
+## Maybe:
+- folke/ts-comments.nvim            better comments
+- grug-far.nvim                     find and replace
+- markdown-preview.nvim             side by side md (disabled in folke)
+- toppair/peek.nvim                 another markdown preview?
+- render-markdown.nvim              inline viewer
+- diffview.nvim
+- octo.nvim                         edit and review GH issues and pr
+- yanky.nvim                        better yank+put. has history
+- inc-rename.nvim                   LSP renaming with visual feedback
+- mini.basics                       defaults options
+- mini.test                         run tests under cursor
+- mini.diff                         inline diff
+- mini.hipatters                    hilight patters and hex colors
+- mini.move                         move chunks (like vscode)
+- undo tree (find a plugin)
+
+## AI help
+- jackMort/ChatGPT.nvim
+- MunifTanjim/nui.nvim (dep)
+- nvim-lua/plenary.nvim (dep)
+- nvim-telescope/telescope.nvim (dep)
+- robitx/gp.nvim
+- zbirenbaum/copilot.lua (folke)
+- milanglacier/minuet-ai.nvim (folke)
+
+## Options
+```
+
+opt.backup = true
+opt.backupdir = vim.fn(stdpath("state") .. "/backup"
+opt.mousescroll = "vert:1,hor:4"
+opt.winborder = "rounded"
+opt.undofile = true
+-- lazy
+  rtp = {
+    disabled_plugins = { "gzip", "tarPlugin", "zipPlugin", "tohtml", "tutor" },
+  },
+
+vim.keymap.set("n", "<C-c>", "ciw")
+
+-- ts lsp
+    includeCompletionsWithSnippetText = true,
+    jsxAttributeCompletionStyle = "auto",
+
+-- tree-sitter parsers naming:
+    https://github.com/nvim-treesitter/nvim-treesitter/blob/master/lua/nvim-treesitter/parsers.lua
+```
+
+folke cmd
+```lua
+-- show cursor line only in active window
+vim.api.nvim_create_autocmd({ "InsertLeave", "WinEnter" }, {
+  callback = function()
+    if vim.w.auto_cursorline then
+      vim.wo.cursorline = true
+      vim.w.auto_cursorline = nil
+    end
+  end,
+})
+vim.api.nvim_create_autocmd({ "InsertEnter", "WinLeave" }, {
+  callback = function()
+    if vim.wo.cursorline then
+      vim.w.auto_cursorline = true
+      vim.wo.cursorline = false
+    end
+  end,
+})
+
+-- backups
+vim.api.nvim_create_autocmd("BufWritePre", {
+  group = vim.api.nvim_create_augroup("better_backup", { clear = true }),
+  callback = function(event)
+    local file = vim.uv.fs_realpath(event.match) or event.match
+    local backup = vim.fn.fnamemodify(file, ":p:~:h")
+    backup = backup:gsub("[/\\]", "%%")
+    vim.go.backupext = backup
+  end,
+})
+```
+
+Enable folding with TS:
+```
+vim.opt.foldmethod = "expr"
+vim.opt.foldexpr = "nvim_treesitter#foldexpr()"
+vim.opt.foldenable = false  -- start with all folds open
+```