kickstart.nvim/lua/custom/plugins/init.lua

407 lines
13 KiB
Lua

-- ========================================================================
-- COMMON PLUGINS - Loaded for all filetypes/profiles
-- ========================================================================
--
-- This file contains plugins that are always loaded regardless of what
-- file type you're working with. These are your "core" plugins that
-- provide functionality across all your language profiles.
--
-- Examples: file explorers, git tools, common UI elements, copilot, etc.
--
-- See the kickstart.nvim README for more information
-- ========================================================================
return {
-- ========================================================================
-- FILE EXPLORER - Neo-tree
-- ========================================================================
-- Neo-tree provides a modern file explorer sidebar similar to VS Code.
-- It's loaded for all profiles so you can browse files regardless of
-- what language you're working with.
--
-- Keybindings:
-- \ (backslash) - Toggle Neo-tree file explorer
-- Within Neo-tree:
-- a - Add file/folder
-- d - Delete
-- r - Rename
-- x - Cut
-- c - Copy
-- p - Paste
-- ? - Show help (see all keybindings)
--
-- Note: This references the existing neo-tree configuration from
-- kickstart/plugins/neo-tree.lua. We're just ensuring it's loaded.
-- ========================================================================
-- {
-- 'nvim-neo-tree/neo-tree.nvim',
-- version = '*',
-- dependencies = {
-- 'nvim-lua/plenary.nvim',
-- 'nvim-tree/nvim-web-devicons', -- not strictly required, but recommended
-- 'MunifTanjim/nui.nvim',
-- },
-- cmd = 'Neotree', -- Lazy load on command
-- keys = {
-- { '\\', ':Neotree reveal<CR>', desc = 'NeoTree reveal', silent = true },
-- },
-- opts = {
-- filesystem = {
-- window = {
-- mappings = {
-- ['\\'] = 'close_window',
-- },
-- },
-- follow_current_file = {
-- enabled = true, -- Focus on the current file when opening
-- },
-- hijack_netrw_behavior = 'open_current', -- Use neo-tree instead of netrw
-- },
-- },
-- },
-- ========================================================================
-- GITHUB COPILOT - AI pair programming assistant
-- ========================================================================
-- GitHub Copilot provides AI-powered code completions and suggestions.
-- Works across all file types and integrates with your completion engine.
--
-- Setup:
-- 1. After installing, run :Copilot setup
-- 2. Follow the authentication flow
-- 3. You'll need an active GitHub Copilot subscription
--
-- Usage:
-- - Copilot suggestions appear automatically as you type
-- - Press Tab to accept a suggestion
-- - Press Ctrl+] to see next suggestion
-- - Press Ctrl+[ to see previous suggestion
-- - :Copilot panel - Open completion panel with multiple suggestions
--
-- Commands:
-- :Copilot setup - Authenticate with GitHub
-- :Copilot status - Check authentication status
-- :Copilot enable - Enable Copilot
-- :Copilot disable - Disable Copilot
-- ========================================================================
{
'github/copilot.vim',
lazy = false, -- Load immediately on startup (not lazy-loaded)
config = function()
-- Copilot keybindings (optional customization)
-- By default, Tab accepts suggestions, but this might conflict with completion
-- Uncomment below to use Ctrl+J to accept instead:
-- vim.keymap.set('i', '<C-J>', 'copilot#Accept("\\<CR>")', {
-- expr = true,
-- replace_keycodes = false,
-- })
-- vim.g.copilot_no_tab_map = true
-- Optional: Disable Copilot for certain filetypes
-- vim.g.copilot_filetypes = {
-- ['*'] = true,
-- ['markdown'] = false,
-- ['text'] = false,
-- }
end,
},
-- ========================================================================
-- SMOOTH SCROLLING & ANIMATIONS - mini.animate
-- ========================================================================
-- Provides smooth scrolling and cursor animations for a better visual experience.
--
-- Features:
-- - Smooth scrolling (when using Ctrl+D, Ctrl+U, etc.)
-- - Cursor path animation when jumping
-- - Window resize animations
-- - Window open/close animations
--
-- All animations are non-blocking and can be customized or disabled independently.
-- ========================================================================
{
'echasnovski/mini.animate',
event = 'VeryLazy', -- Load after UI is ready
opts = function()
-- Don't use animate when scrolling with the mouse
local mouse_scrolled = false
for _, scroll in ipairs({ 'Up', 'Down' }) do
local key = '<ScrollWheel' .. scroll .. '>'
vim.keymap.set({ '', 'i' }, key, function()
mouse_scrolled = true
return key
end, { expr = true })
end
local animate = require('mini.animate')
return {
-- Cursor path animation - shows path when cursor jumps
cursor = {
enable = true,
timing = animate.gen_timing.linear({ duration = 100, unit = 'total' }),
},
-- Smooth scrolling
scroll = {
enable = true,
timing = animate.gen_timing.linear({ duration = 150, unit = 'total' }),
subscroll = animate.gen_subscroll.equal({
predicate = function(total_scroll)
if mouse_scrolled then
mouse_scrolled = false
return false
end
return total_scroll > 1
end,
}),
},
-- Window resize animation
resize = {
enable = true,
timing = animate.gen_timing.linear({ duration = 50, unit = 'total' }),
},
-- Window open/close animation
open = {
enable = false, -- Disabled by default as it can be distracting
timing = animate.gen_timing.linear({ duration = 150, unit = 'total' }),
},
close = {
enable = false, -- Disabled by default
timing = animate.gen_timing.linear({ duration = 150, unit = 'total' }),
},
}
end,
},
-- ========================================================================
-- TROUBLE.NVIM - Beautiful diagnostics list (LazyVim-style)
-- ========================================================================
-- Provides a nice list view of diagnostics, quickfix, LSP references, etc.
-- Shows errors inline in a dedicated panel like LazyVim/VS Code.
-- Auto-opens when diagnostics are present to show errors in editor area.
--
-- Keymaps:
-- <leader>xx - Toggle diagnostics list
-- <leader>xX - Buffer diagnostics
-- <leader>cs - Symbols list
-- <leader>cl - LSP references
-- <leader>xL - Location list
-- <leader>xQ - Quickfix list
-- [q / ]q - Previous/next item in trouble list
-- ========================================================================
{
'folke/trouble.nvim',
cmd = 'Trouble', -- Lazy load on command
opts = {
focus = false, -- Don't focus the window when opened (LazyVim behavior)
auto_close = true, -- Auto close when no items
auto_open = false, -- Don't auto open (we'll handle this with autocmd)
warn_no_results = false,
open_no_results = false,
modes = {
-- Configure the diagnostics mode to show in editor area
diagnostics = {
mode = 'diagnostics',
preview = {
type = 'split',
relative = 'win',
position = 'right',
size = 0.3,
},
},
},
},
keys = {
{
'<leader>xx',
'<cmd>Trouble diagnostics toggle<cr>',
desc = 'Diagnostics (Trouble)',
},
{
'<leader>xX',
'<cmd>Trouble diagnostics toggle filter.buf=0<cr>',
desc = 'Buffer Diagnostics (Trouble)',
},
{
'<leader>cs',
'<cmd>Trouble symbols toggle focus=false<cr>',
desc = 'Symbols (Trouble)',
},
{
'<leader>cl',
'<cmd>Trouble lsp toggle focus=false win.position=right<cr>',
desc = 'LSP Definitions / references / ... (Trouble)',
},
{
'<leader>xL',
'<cmd>Trouble loclist toggle<cr>',
desc = 'Location List (Trouble)',
},
{
'<leader>xQ',
'<cmd>Trouble qflist toggle<cr>',
desc = 'Quickfix List (Trouble)',
},
{
'[q',
function()
if require('trouble').is_open() then
require('trouble').prev({ skip_groups = true, jump = true })
else
local ok, err = pcall(vim.cmd.cprev)
if not ok then
vim.notify(err, vim.log.levels.ERROR)
end
end
end,
desc = 'Previous Trouble/Quickfix Item',
},
{
']q',
function()
if require('trouble').is_open() then
require('trouble').next({ skip_groups = true, jump = true })
else
local ok, err = pcall(vim.cmd.cnext)
if not ok then
vim.notify(err, vim.log.levels.ERROR)
end
end
end,
desc = 'Next Trouble/Quickfix Item',
},
},
},
-- ========================================================================
-- NOICE.NVIM - Better UI for messages, cmdline, and notifications
-- ========================================================================
-- Provides a modern UI for command line, messages, and notifications (LazyVim-style).
-- Makes the editor feel more polished with popup notifications and floating cmdline.
--
-- Features:
-- - Floating command line
-- - Modern notification system
-- - Better message display
-- - Signature help while typing
--
-- Note: This can be disabled if you prefer the classic Vim UI
-- ========================================================================
{
'folke/noice.nvim',
event = 'VeryLazy',
dependencies = {
'MunifTanjim/nui.nvim',
-- Optional: If you want to use `nvim-notify` for notifications
-- 'rcarriga/nvim-notify',
},
opts = {
lsp = {
-- Override markdown rendering so that **cmp** and other plugins use **Treesitter**
override = {
['vim.lsp.util.convert_input_to_markdown_lines'] = true,
['vim.lsp.util.stylize_markdown'] = true,
['cmp.entry.get_documentation'] = true,
},
},
-- Presets for easier configuration
presets = {
bottom_search = true, -- Use a classic bottom cmdline for search
command_palette = true, -- Position the cmdline and popupmenu together
long_message_to_split = true, -- Long messages will be sent to a split
inc_rename = false, -- Enables an input dialog for inc-rename.nvim
lsp_doc_border = true, -- Add a border to hover docs and signature help
},
-- Routes configuration (optional customization)
routes = {
{
filter = {
event = 'msg_show',
kind = '',
find = 'written',
},
opts = { skip = true },
},
},
},
keys = {
{
'<leader>sn',
'',
desc = '+noice',
},
{
'<leader>snl',
function()
require('noice').cmd('last')
end,
desc = 'Noice Last Message',
},
{
'<leader>snh',
function()
require('noice').cmd('history')
end,
desc = 'Noice History',
},
{
'<leader>sna',
function()
require('noice').cmd('all')
end,
desc = 'Noice All',
},
{
'<leader>snd',
function()
require('noice').cmd('dismiss')
end,
desc = 'Dismiss All',
},
{
'<c-f>',
function()
if not require('noice.lsp').scroll(4) then
return '<c-f>'
end
end,
silent = true,
expr = true,
desc = 'Scroll Forward',
mode = { 'i', 'n', 's' },
},
{
'<c-b>',
function()
if not require('noice.lsp').scroll(-4) then
return '<c-b>'
end
end,
silent = true,
expr = true,
desc = 'Scroll Backward',
mode = { 'i', 'n', 's' },
},
},
},
-- ========================================================================
-- ADDITIONAL COMMON PLUGINS
-- ========================================================================
-- You can add more common plugins here that should be available across
-- all language profiles. Examples:
--
-- - Better terminal integration
-- - Git integration enhancements (beyond gitsigns in init.lua)
-- - Session management
-- - Project management
-- - Alternative completion sources
-- - UI enhancements
--
-- Just add them to this return table following the same pattern as above.
-- ========================================================================
}