init.lua.example

-- Modern Neovim Configuration for Genero Development
-- Compatible with Neovim 0.9.x through 0.11.x
-- Copy this to ~/.config/nvim/init.lua and adjust paths as needed

-- ============================================================================
-- VERSION DETECTION
-- ============================================================================

-- Detect Neovim version once for use throughout the config
local nvim_version = vim.version()
local is_nvim_010_plus = nvim_version.major > 0 or nvim_version.minor >= 10

-- ============================================================================
-- LEADER KEY
-- ============================================================================

vim.g.mapleader = " "
vim.g.maplocalleader = " "

-- UI & Display
vim.opt.number = true
vim.opt.relativenumber = true
vim.opt.termguicolors = true
vim.opt.background = 'dark'
vim.opt.cursorline = true
vim.opt.cursorcolumn = false
vim.opt.signcolumn = "yes:2"
vim.opt.colorcolumn = "100"
vim.opt.cmdheight = 1
vim.opt.pumheight = 10

-- Indentation & Formatting
vim.opt.expandtab = false
vim.opt.shiftwidth = 4
vim.opt.tabstop = 4
vim.opt.smartindent = true  -- Note: smartindent is overridden for Genero files (see indent/*.vim)
vim.opt.wrap = true
vim.opt.linebreak = true
vim.opt.breakindent = true

-- Preserve indentation when continuing comments (# in Genero)
-- r = auto-insert comment leader after Enter in insert mode
-- o = auto-insert comment leader after o/O in normal mode
-- Note: indent/*.vim files disable smartindent's # column-0 behavior for Genero files
vim.opt.formatoptions:append("ro")

-- Search & Navigation
vim.opt.ignorecase = true
vim.opt.smartcase = true
vim.opt.hlsearch = true
vim.opt.incsearch = true

-- Performance & Behavior
vim.opt.updatetime = 250
vim.opt.timeoutlen = 300
vim.opt.splitbelow = true
vim.opt.splitright = true
vim.opt.mouse = "a"
vim.opt.showcmd = false  -- Disable showcmd to prevent noice "calculator" popup

-- Use system clipboard if a provider is available (xclip, xsel, wl-copy, etc.)
-- Falls back to Neovim's internal registers if no provider is found
if vim.fn.executable("xclip") == 1 or vim.fn.executable("xsel") == 1
    or vim.fn.executable("wl-copy") == 1 or vim.fn.executable("pbcopy") == 1 then
  vim.opt.clipboard = "unnamedplus"
end

-- Persistent Undo (Neovim only)
vim.opt.undofile = true
vim.opt.undodir = vim.fn.expand("~/.vim/undo")
vim.opt.undolevels = 1000
vim.opt.undoreload = 10000

-- ============================================================================
-- GENERO TOOLS CONFIGURATION (must be set before plugin loads)
-- ============================================================================

vim.g.genero_tools_config = {
  -- Compiler settings
  -- Supports .4gl, .m3, .m4 files (fglcomp) and .per files (fglform)
  compiler_enabled = true,
  compiler_autocompile = true,
  compiler_autocompile_delay = 500,
  compiler_inline_diagnostics = true,    -- Show error/warning text on cursor line (Neovim only)
  compiler_type_info = true,             -- Show function signature on hover (Neovim only)
  autoclose_blocks = true,               -- Auto-insert END statements on Enter
  compiler_sign_column = true,
  compiler_sign_column_always_visible = true,  -- Keep sign column visible
  compiler_highlight_unused = true,
  compiler_show_warnings = true,
  compiler_show_errors = true,
  compiler_command = "fglcomp",                 -- For .4gl, .m3, .m4 files
  compiler_args = { "-M", "-W", "all" },
  compiler_form_command = "fglform",            -- For .per files (form compiler)
  compiler_form_args = { "-M", "-W", "all" },
  compiler_source_dir = ".",
  compiler_version = "auto",                    -- Auto-detect or specify: "3.10", "3.20", etc.
  
  -- Code hints configuration
  hints_enabled = true,
  hints_display = "both",               -- Display mode: "signs", "virtual_text", "both"
  hints_severity = "warning",           -- Severity level: "info", "warning", "style"
  hints_realtime = true,                -- Enable real-time detection
  hints_cache_enabled = true,           -- Enable hint caching
  hints_cache_ttl = 300,                -- Cache TTL in seconds
  hints_delay = 500,                    -- Debounce delay in milliseconds
  hints_current_line_only = true,       -- Only show virtual text hint on cursor line (less noisy)
  auto_fix_enabled = true,              -- Enable auto-fix suggestions
  
  -- Individual hint checks (true = enabled, false = disabled)
  trailing_whitespace = true,           -- Detect trailing whitespace (team consistency)
  mixed_indentation = true,             -- Detect mixed tabs/spaces (critical for team consistency)
  indentation_consistency = false,      -- Detect inconsistent indentation (too noisy, covered by mixed_indentation)
  multiple_blank_lines = true,          -- Detect excessive blank lines (keeps code clean)
  lowercase_keywords = true,            -- Detect lowercase keywords (Genero convention is uppercase)
  lowercase_functions = false,          -- Detect lowercase functions (too opinionated, many codebases use lowercase)
  keyword_consistency = true,           -- Detect inconsistent casing (important for team consistency)
  naming_convention = false,            -- Detect naming violations (too opinionated for existing codebase)
  unclosed_blocks = true,               -- Detect unclosed blocks (catches real bugs)
  nesting_depth = false,                -- DISABLED: Depth calculation has bugs, needs refactoring
  line_length = true,                   -- Detect long lines (readability, code review)
  missing_comments = false,             -- Detect missing comments (too noisy, subjective)
  missing_error_handling = true,        -- Detect missing error handling (catches potential bugs)
  deprecated_functions = true,          -- Detect deprecated functions (important for maintenance)
  
  -- Hint thresholds
  max_line_length = 120,                -- Maximum line length (increased for modern screens)
  max_nesting_depth = 4,                -- Maximum nesting depth (stricter for better code quality)
  max_blank_lines = 2,                  -- Maximum consecutive blank lines
  naming_convention_style = "snake_case", -- Naming style: "camelCase", "snake_case"
  
  -- Cache settings
  cache_enabled = true,                 -- Enable result caching
  cache_ttl = 3600,                     -- Cache time-to-live in seconds
  cache_max_size = 500,                 -- Maximum cache entries
  
  -- Result settings
  result_limit = 1000,                  -- Maximum results returned
  pagination_size = 50,                 -- Results per page
  
  -- Codebase detection
  codebase_markers = { "castle.sch", "genero.conf", ".genero", ".git" },
  
  -- Startup behavior
  startup_messages = "silent",          -- Message level: "silent", "normal", "verbose"
  
  -- Query tool path
  -- Set this to the location of your genero-tools query.sh script
  -- Common locations:
  --   BRODIR-based: (os.getenv("BRODIR") or "/opt/brodir") .. "/etc/genero-tools/query.sh"
  --   Home directory: vim.fn.expand("~/genero-tools/query.sh")
  genero_tools_path = os.getenv("GENERO_TOOLS_PATH")
    or (os.getenv("BRODIR") and os.getenv("BRODIR") .. "/etc/genero-tools/query.sh")
    or vim.fn.expand("~/genero-tools/query.sh"),
  
  -- Display and features
  display_mode = "floating",  -- Use floating windows for results (valid modes: quickfix, floating, echo)
  snippets_enabled = true,
  snippet_engine = "luasnip",            -- Snippet engine: "luasnip", "vim-snipmate", "vim-vsnip"
  snippet_smart_expansion = true,        -- Enable async parameter population
  snippet_custom_dir = vim.fn.expand("~/.config/nvim/genero-snippets"),  -- Custom snippet directory
  keybindings_enabled = true,            -- Enable default keybindings
  timeout = 10000,                       -- Command timeout in milliseconds
  async_enabled = true,                  -- Enable async operations
  
  -- Autocomplete configuration
  autocomplete_on_pause = false,     -- Disabled: nvim-cmp handles triggering (Vim still uses omnifunc)
  autocomplete_delay = 500,          -- Delay in ms before triggering (default: 500)
  
  -- Format flag configuration (for optimized output from genero-tools)
  format_hover_enabled = true,       -- Enable hover format (--format=vim-hover) for detailed display
  format_completion_enabled = true,  -- Enable completion format (--format=vim-completion) for autocomplete
  format_concise_enabled = true,     -- Enable concise format (--format=vim) for hints and statusline
  format_cache_enabled = true,       -- Enable caching of formatted results
  format_cache_ttl = 3600,           -- Format cache time-to-live in seconds (default: 1 hour)
  
  -- Statusline configuration
  statusline_show_function = true,   -- Show current function signature in statusline
  statusline_function_max_length = 50, -- Maximum length of function signature in statusline
  statusline_show_diagnostics = true, -- Show error/warning counts in statusline
  
  -- Floating window configuration
  floating_window_border = "rounded",
  floating_window_width = 80,
  floating_window_height = 20,
  floating_window_position = "center",
  floating_window_title = "Genero-Tools",
  popup_auto_close_delay = 5000,
  
  -- Debug streaming configuration (Neovim only)
  debug_stream_enabled = true,
  -- debug_stream_width = 50,  -- Uncomment to set fixed width (default: 0 = auto-size to 1/3 of screen)
  debug_stream_max_lines = 1000,
  debug_stream_auto_scroll = true,
  debug_stream_directory = (os.getenv("BRODIR") or "/opt/brodir") .. "/debug",
  
  -- Debug mode for troubleshooting
  debug_mode = false,  -- Set to true to enable debug logging
  
  -- SVN integration
  svn_enabled = true,
  svn_show_added = true,
  svn_show_modified = true,
  svn_show_deleted = true,
  svn_cache_ttl = 300,                  -- SVN cache time-to-live in seconds
  svn_auto_update = true,               -- Auto-update SVN markers on save
  
  -- Lua layer (Neovim only)
  lua_enabled = true,                   -- Enable Lua layer features (auto-detected: true on Neovim, false on Vim)
  
  -- Per-file configuration
  -- Create .genero-hints in project root for per-file hint configuration
  -- Example: { "rules": [ { "pattern": "src/**/*.4gl", "config": { "max_line_length": 120 } } ] }
}

-- ============================================================================
-- LAZY.NVIM BOOTSTRAP
-- ============================================================================

local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
local uv = vim.uv or vim.loop  -- vim.uv on 0.10+, vim.loop on 0.9.x
if not uv.fs_stat(lazypath) then
  vim.fn.system({
    "git",
    "clone",
    "--filter=blob:none",
    "https://github.com/folke/lazy.nvim.git",
    "--branch=stable",
    lazypath,
  })
end
vim.opt.rtp:prepend(lazypath)

-- ============================================================================
-- PLUGINS
-- ============================================================================

local plugins = {
  -- ============================================================================
  -- THEME SELECTION
  -- Uncomment ONE theme block below. Default: thorn (minimal green)
  -- ============================================================================

  -- Default: Thorn - Minimal dark green theme
  {
    "jpwol/thorn.nvim",
    lazy = false,
    priority = 1000,
    config = function()
      vim.cmd("colorscheme thorn")
    end,
  },

  -- Alternative: Tokyonight - Popular dark blue theme
  -- Uncomment this block and comment out thorn above to switch
  -- {
  --   "folke/tokyonight.nvim",
  --   lazy = false,
  --   priority = 1000,
  --   config = function()
  --     require("tokyonight").setup({
  --       style = "night",
  --       transparent = false,
  --       terminal_colors = true,
  --       styles = {
  --         comments = { italic = true },
  --         keywords = { italic = true },
  --         functions = {},
  --         variables = {},
  --         sidebars = "dark",
  --         floats = "dark",
  --       },
  --       lualine_bold = true,
  --     })
  --     vim.cmd("colorscheme tokyonight")
  --   end,
  -- },

  -- Alternative: Catppuccin - Warm pastel theme
  -- {
  --   "catppuccin/nvim",
  --   name = "catppuccin",
  --   lazy = false,
  --   priority = 1000,
  --   config = function()
  --     vim.cmd("colorscheme catppuccin-mocha")
  --   end,
  -- },

  -- Alternative: Gruvbox - Retro warm theme
  -- {
  --   "ellisonleao/gruvbox.nvim",
  --   lazy = false,
  --   priority = 1000,
  --   config = function()
  --     vim.cmd("colorscheme gruvbox")
  --   end,
  -- },

  -- LuaSnip - Required for Genero code snippets
  -- Note: jsregexp is optional (only needed for advanced regex in snippets)
  -- If you need jsregexp, install Lua dev headers: lua5.1-dev (Debian/Ubuntu) or lua-devel (RHEL/CentOS)
  {
    "L3MON4D3/LuaSnip",
    version = "v2.*",
    build = "make install_jsregexp || true",  -- Continue even if jsregexp build fails
  },

  -- Genero Tools Plugin
  {
    "hdean-ssp/genero-vim",
    name = "genero-tools",
    branch = "main",
    dependencies = { "L3MON4D3/LuaSnip" },
    config = function()
      -- Config is already set in vim.g.genero_tools_config above
      -- Initialize snippets module if enabled
      local ok_snippets, snippets = pcall(require, "genero_tools.snippets")
      if ok_snippets and vim.g.genero_tools_config.snippets_enabled then
        snippets.setup()
      end
    end,
  },

  -- Modern Statusline
  {
    "nvim-lualine/lualine.nvim",
    version = "v0.9.*",
    dependencies = { "genero-tools" },  -- Ensure genero-tools loads first
    config = function()
      -- Safely load genero-tools lualine integration
      local ok, lualine_genero = pcall(require, "genero_tools.lualine")
      if ok then
        lualine_genero.setup()  -- Initialize highlights
      end
      
      require("lualine").setup({
        options = {
          theme = "auto",
          component_separators = { left = "│", right = "│" },
          section_separators = { left = "", right = "" },
          globalstatus = true,
          refresh = {
            statusline = 1000,
            tabline = 1000,
            winbar = 1000,
          },
        },
        sections = {
          lualine_a = { "mode" },
          lualine_b = {},
          lualine_c = ok and { "diagnostics", lualine_genero.diagnostics, lualine_genero.breadcrumb } or { "diagnostics" },
          lualine_x = ok and { lualine_genero.svn_status, lualine_genero.cache_stats, "encoding", "filetype",
            function() return os.getenv("DEVNAME") or "" end } or { "encoding", "filetype" },
          lualine_y = { "progress" },
          lualine_z = { "location" },
        },
        tabline = {
          lualine_a = { "buffers" },
          lualine_z = { "tabs" },
        },
        extensions = { "quickfix", "man" },
      })
    end,
  },

  -- Notification system
  -- v3.13.1 is the last release compatible with Neovim 0.9.x
  -- v3.14.x+ requires Neovim 0.10+ but fixes animation bugs on 0.11
  {
    "rcarriga/nvim-notify",
    tag = not is_nvim_010_plus and "v3.13.1" or nil,  -- pin on 0.9, use latest on 0.10+
    config = function()
      require("notify").setup({
        background_colour = "#000000",
        fps = 30,
        icons = {
          DEBUG = "",
          ERROR = "",
          INFO = "",
          TRACE = "✎",
          WARN = "",
        },
        level = vim.log.levels.WARN,  -- Show warnings and errors
        minimum_width = 50,
        render = "compact",            -- Compact render to reduce visual noise
        stages = "static",             -- "static" avoids animation math bugs across all versions
        timeout = 3000,                -- Auto-dismiss after 3 seconds
        top_down = true,
      })
      vim.notify = require("notify")
    end,
  },

  -- Floating Window UI for commands
  -- noice.nvim supports Neovim 0.9+; pin to v4.5.2 on 0.9.x for stability,
  -- use latest on 0.10+ to avoid deprecated API warnings
  {
    "folke/noice.nvim",
    tag = not is_nvim_010_plus and "v4.5.2" or nil,
    dependencies = {
      "MunifTanjim/nui.nvim",
      "rcarriga/nvim-notify",
    },
    config = function()
      require("noice").setup({
        notify = {
          enabled = true,  -- Re-enable notifications (we filter specific ones below)
        },
        messages = {
          enabled = true,  -- Re-enable message handling
        },
        cmdline = {
          enabled = true,
          view = "cmdline_popup",
        },
        popupmenu = {
          enabled = true,
          backend = "nui",
        },
        -- Position cmdline popup at top of screen
        views = {
          cmdline_popup = {
            position = {
              row = 5,
              col = "50%",
            },
            size = {
              width = 60,
              height = "auto",
            },
          },
        },
        lsp = {
          progress = {
            enabled = false,  -- Disable LSP progress for Neovim 0.9.5 compatibility
          },
          signature = {
            enabled = false,  -- Disable signature help for Neovim 0.9.5 compatibility
          },
          message = {
            enabled = false,  -- Disable LSP messages
          },
          override = {
            ["vim.lsp.util.convert_input_to_markdown_lines"] = true,
            ["vim.lsp.util.stylize_markdown"] = true,
            ["cmp.entry.get_documentation"] = true,
          },
        },
        presets = {
          bottom_search = true,
          command_palette = true,
          long_message_to_split = true,
          inc_rename = false,
          lsp_doc_border = false,
        },
        routes = {
          -- Filter out specific noisy messages
          {
            filter = {
              event = "msg_show",
              any = {
                { find = "%d+L, %d+B" },
                { find = "; after #%d+" },
                { find = "; before #%d+" },
                { find = "lspconfig.*deprecated" },  -- Filter lspconfig deprecation
                { find = "vim%.lsp%.config" },       -- Filter vim.lsp.config mentions
                { find = "snippet" },                -- Filter snippet messages
                { find = "placeholder" },            -- Filter placeholder messages
                { find = "generotools" },            -- Filter generotools snippet messages
              },
            },
            view = "mini",
          },
          {
            filter = {
              event = "notify",
              any = {
                { find = "lspconfig.*deprecated" },
                { find = "vim%.lsp%.config" },
                { find = "snippet" },
                { find = "placeholder" },
                { find = "generotools" },
              },
            },
            opts = { skip = true },
          },
          -- Skip all msg_showcmd events (these create the calculator popup)
          {
            filter = {
              event = "msg_showcmd",
            },
            opts = { skip = true },
          },
        },
      })
    end,
  },

  -- Helpful command hints
  -- v1.x uses wk.register() API; v3.x uses wk.add() API
  -- Pin to v1.x on Neovim 0.9.x, use latest on 0.10+
  {
    "folke/which-key.nvim",
    version = not is_nvim_010_plus and "v1.*" or nil,
    config = function()
      local wk = require("which-key")

      if is_nvim_010_plus then
        -- which-key v3+ API (Neovim 0.10+)
        wk.setup({
          preset = "classic",
          icons = {
            breadcrumb = "»",
            separator = "➜",
            group = "+",
          },
          win = {
            border = "rounded",
            padding = { 2, 2, 2, 2 },
          },
          layout = {
            height = { min = 4, max = 25 },
            width = { min = 20, max = 50 },
            spacing = 3,
            align = "left",
          },
          show_help = true,
          show_keys = true,
        })
      else
        -- which-key v1.x API (Neovim 0.9.x)
        wk.setup({
          plugins = {
            marks = true,
            registers = true,
            spelling = {
              enabled = true,
              suggestions = 9,
            },
            presets = {
              operators = true,
              motions = true,
              text_objects = true,
              windows = true,
              nav = true,
              z = true,
              g = true,
            },
          },
          icons = {
            breadcrumb = "»",
            separator = "➜",
            group = "+",
          },
          popup_mappings = {
            scroll_down = "<c-d>",
            scroll_up = "<c-u>",
          },
          window = {
            border = "rounded",
            position = "bottom",
            margin = { 1, 0, 1, 0 },
            padding = { 2, 2, 2, 2 },
            winblend = 0,
          },
          layout = {
            height = { min = 4, max = 25 },
            width = { min = 20, max = 50 },
            spacing = 3,
            align = "left",
          },
          show_help = true,
          show_keys = true,
        })
      end
    end,
  },

  -- Indent guides
  {
    "lukas-reineke/indent-blankline.nvim",
    main = "ibl",
    config = function()
      require("ibl").setup({
        indent = { char = "│", highlight = "IblIndent" },
        whitespace = {
          highlight = "IblWhitespace",
          remove_blankline_trail = false,
        },
        scope = { enabled = true, highlight = "IblScope" },
      })
    end,
  },

  -- Better UI for vim.ui.select and vim.ui.input
  {
    "stevearc/dressing.nvim",
    config = function()
      require("dressing").setup({
        input = {
          enabled = true,
          default_prompt = "➜ ",
          prompt_align = "left",
          insert_only = true,
          start_in_insert = true,
          border = "rounded",
          relative = "cursor",
          prefer_width = 40,
          width = nil,
          max_width = { 140, 0.9 },
          min_width = { 20, 0.2 },
          buf_options = {},
          win_options = {
            wrap = false,
            list = true,
            listchars = "extends:…",
            sidescrolloff = 0,
          },
          get_config = function(opts)
            -- Disable dressing for snippet choice nodes (use default UI)
            if opts and opts.kind == "luasnip" then
              return { enabled = false }
            end
          end,
        },
        select = {
          enabled = true,
          backend = { "telescope", "fzf", "builtin" },
          trim_prompt = true,
          telescope = nil,
          fzf = {
            window = {
              yoffset = -0.5,
            },
          },
          builtin = {
            border = "rounded",
            relative = "editor",
            buf_options = {},
            win_options = {
              cursorline = true,
              cursorlineopt = "both",
            },
            width = nil,
            max_width = { 80, 0.8 },
            min_width = { 40, 0.2 },
            height = nil,
            max_height = 0.9,
            mappings = {
              ["<Esc>"] = "Close",
              ["<C-c>"] = "Close",
              ["<CR>"] = "Confirm",
            },
            override = function(conf)
              return conf
            end,
          },
          format_item_override = {},
          get_config = function(opts)
            -- Disable dressing for snippet choice nodes (use default UI)
            if opts and opts.kind == "luasnip" then
              return { enabled = false }
            end
          end,
        },
      })
    end,
  },

  -- Comment plugin for gcc/gbc keybindings
  {
    "numToStr/comment.nvim",
    config = function()
      require("Comment").setup({
        padding = true,
        sticky = true,
        ignore = nil,
        toggler = {
          line = "gcc",
          block = "gbc",
        },
        opleader = {
          line = "gc",
          block = "gb",
        },
        extra = {
          above = "gcO",
          below = "gco",
          eol = "gcA",
        },
        mappings = {
          basic = true,
          extra = true,
        },
        pre_hook = nil,
        post_hook = nil,
      })
    end,
  },

  -- Highlight TODO/FIX/BUG/TMP keywords in comments
  -- Also registers a custom keyword for the current user's temp code tag (#TMP<initials>)
  {
    "folke/todo-comments.nvim",
    dependencies = { "nvim-lua/plenary.nvim" },
    config = function()
      -- Build user-specific temp tag: hdean → TMPHD
      local user = os.getenv("USER") or ""
      local user_tag = "TMP" .. string.upper(string.sub(user, 1, 2))

      require("todo-comments").setup({
        signs = true,
        sign_priority = 8,
        keywords = {
          FIX =  { icon = " ", color = "error", alt = { "FIXME", "FIXIT", "ISSUE" } },
          TODO = { icon = " ", color = "info" },
          HACK = { icon = " ", color = "warning" },
          WARN = { icon = " ", color = "warning", alt = { "WARNING" } },
          NOTE = { icon = " ", color = "hint", alt = { "INFO" } },
          BUG =  { icon = " ", color = "error" },
          TMP =  { icon = " ", color = "warning", alt = { user_tag } },
        },
        merge_keywords = false,
        highlight = {
          multiline = false,
          before = "",
          keyword = "bg",  -- "wide" causes end_col overflow on keywords at EOL
          after = "",
          pattern = [[.*<(KEYWORDS)\s*]],
          comments_only = false,  -- Also highlight in code, not just comments (for #TMP tags)
          max_line_len = 400,  -- Skip very long lines
          exclude = {},
        },
        search = {
          command = "rg",
          args = {
            "--color=never", "--no-heading", "--with-filename",
            "--line-number", "--column", "--hidden",
          },
          pattern = [[\b(KEYWORDS)\b]],
        },
      })
    end,
  },

  -- Toggle terminal (in-buffer terminal with hotkey)
  {
    "akinsho/toggleterm.nvim",
    version = "*",
    config = function()
      require("toggleterm").setup({
        size = function(term)
          if term.direction == "horizontal" then
            return 15
          elseif term.direction == "vertical" then
            return vim.o.columns * 0.4
          end
        end,
        open_mapping = [[<C-\>]],         -- Toggle terminal with Ctrl+\
        hide_numbers = true,
        shade_filetypes = {},
        shade_terminals = true,
        shading_factor = 2,
        start_in_insert = true,
        insert_mappings = true,            -- Ctrl+\ works in insert mode too
        terminal_mappings = true,          -- Ctrl+\ works inside the terminal
        persist_size = true,
        persist_mode = true,
        direction = "horizontal",          -- Default: horizontal split at bottom
        close_on_exit = true,
        shell = "bash --login",            -- Login shell: sources ~/.bash_profile for env vars
        float_opts = {
          border = "rounded",
          winblend = 0,
        },
      })

      -- Terminal mode mappings (escape terminal mode easily)
      function _G.set_terminal_keymaps()
        local topts = { buffer = 0, noremap = true, silent = true }
        vim.keymap.set("t", "<Esc>", [[<C-\><C-n>]], topts)
        vim.keymap.set("t", "<C-h>", [[<C-\><C-n><C-w>h]], topts)
        vim.keymap.set("t", "<C-j>", [[<C-\><C-n><C-w>j]], topts)
        vim.keymap.set("t", "<C-k>", [[<C-\><C-n><C-w>k]], topts)
        vim.keymap.set("t", "<C-l>", [[<C-\><C-n><C-w>l]], topts)
      end

      vim.cmd("autocmd! TermOpen term://* lua set_terminal_keymaps()")
    end,
  },

  -- ============================================================================
  -- TREESITTER - Syntax highlighting and code understanding for all languages
  -- ============================================================================
  {
    "nvim-treesitter/nvim-treesitter",
    build = ":TSUpdate",
    config = function()
      -- Gracefully handle if treesitter isn't fully installed yet
      local ok, treesitter = pcall(require, "nvim-treesitter.configs")
      if not ok then
        -- Silently skip treesitter setup if not installed
        -- User can run :TSUpdate manually if they want syntax highlighting
        return
      end
      
      -- Lazy-load parsers: only install when opening a file of that type
      -- This avoids blocking startup with parser compilation
      treesitter.setup({
        -- Don't auto-install all parsers on startup (causes lag)
        ensure_installed = {},
        
        -- Install parsers on-demand when opening a file
        auto_install = true,
        
        highlight = {
          enable = true,
          -- Disable for very large files (>500KB) to avoid slowdown
          disable = function(_, buf)
            local max_filesize = 500 * 1024
            local ok_stat, stats = pcall(vim.loop.fs_stat, vim.api.nvim_buf_get_name(buf))
            return ok_stat and stats and stats.size > max_filesize
          end,
        },
        indent = { enable = true },
      })
    end,
  },

  -- ============================================================================
  -- LSP - Language Server Protocol for Python, Java, C, Perl, Bash, etc.
  -- ============================================================================
  -- IMPORTANT: LSP servers are NOT auto-installed to avoid startup lag.
  -- Install manually as needed:
  --   :Mason                    (open UI, press 'i' to install)
  --   :MasonInstall pyright     (Python)
  --   :MasonInstall jdtls       (Java)
  --   :MasonInstall clangd      (C/C++)
  --   :MasonInstall bashls      (Bash)
  --   :MasonInstall lua_ls      (Lua)
  --   :MasonInstall jsonls      (JSON)
  --   :MasonInstall yamlls      (YAML)
  --   :MasonInstall lemminx     (XML)
  --
  -- NOTE: nvim-lspconfig is pinned to v1.0.0 for Neovim 0.9.5 compatibility.
  -- v1.1+ requires Neovim 0.10+.

  -- Mason: installs and manages LSP servers, linters, and formatters
  {
    "williamboman/mason.nvim",
    build = ":MasonUpdate",
    config = function()
      require("mason").setup({
        ui = {
          border = "rounded",
          icons = {
            package_installed   = "✓",
            package_pending     = "➜",
            package_uninstalled = "✗",
          },
        },
      })
    end,
  },

  -- nvim-lspconfig: configures each language server
  -- Pin to v1.0.0 for Neovim 0.9.5 compatibility (v1.1+ requires 0.10+)
  {
    "neovim/nvim-lspconfig",
    version = "v1.0.0",
    dependencies = {
      "williamboman/mason.nvim",
      "hrsh7th/cmp-nvim-lsp",   -- feeds LSP completions into nvim-cmp
    },
    config = function()
      local lspconfig = require("lspconfig")
      local capabilities = require("cmp_nvim_lsp").default_capabilities()

      -- Shared on_attach: sets LSP keybindings for any language server
      local function on_attach(_, bufnr)
        local bopts = { noremap = true, silent = true, buffer = bufnr }

        -- Navigation (mirrors Genero-Tools bindings for non-Genero files)
        vim.keymap.set("n", "K",  vim.lsp.buf.hover,           vim.tbl_extend("force", bopts, { desc = "Hover docs" }))
        vim.keymap.set("n", "gi", vim.lsp.buf.implementation,  vim.tbl_extend("force", bopts, { desc = "Go to implementation" }))
        vim.keymap.set("n", "<leader>rn", vim.lsp.buf.rename,  vim.tbl_extend("force", bopts, { desc = "Rename symbol" }))
        vim.keymap.set("n", "<leader>la", vim.lsp.buf.code_action, vim.tbl_extend("force", bopts, { desc = "Code action" }))
        vim.keymap.set("n", "<leader>lf", function() vim.lsp.buf.format({ async = true }) end,
          vim.tbl_extend("force", bopts, { desc = "Format file" }))
        vim.keymap.set("n", "<leader>ld", vim.diagnostic.open_float, vim.tbl_extend("force", bopts, { desc = "Line diagnostics" }))

        -- On non-Genero files, wire gd/gr to LSP so the same keys work everywhere
        local ft = vim.bo[bufnr].filetype
        local genero_fts = { ["4gl"] = true, fgl = true, per = true }
        if not genero_fts[ft] then
          vim.keymap.set("n", "gd", vim.lsp.buf.definition,   vim.tbl_extend("force", bopts, { desc = "Go to definition" }))
          vim.keymap.set("n", "gr", vim.lsp.buf.references,   vim.tbl_extend("force", bopts, { desc = "Find references" }))
          vim.keymap.set("n", "gp", function()
            -- Peek: open definition in a floating preview
            vim.lsp.buf.definition({ reuse_win = false })
          end, vim.tbl_extend("force", bopts, { desc = "Peek definition" }))
        end
      end

      -- Helper: only setup server if it's installed via Mason
      local function setup_if_installed(server_name, config)
        local ok_registry, mason_registry = pcall(require, "mason-registry")
        if not ok_registry then
          -- Mason not installed yet, skip LSP setup
          return
        end
        if mason_registry.is_installed(server_name) then
          lspconfig[server_name].setup(config)
        end
      end

      -- Python
      setup_if_installed("pyright", {
        capabilities = capabilities,
        on_attach = on_attach,
        settings = {
          python = {
            analysis = {
              typeCheckingMode = "basic",
              autoSearchPaths = true,
              useLibraryCodeForTypes = true,
            },
          },
        },
      })

      -- Java (jdtls needs a workspace dir per project)
      setup_if_installed("jdtls", {
        capabilities = capabilities,
        on_attach = on_attach,
        settings = {
          java = {
            configuration = { updateBuildConfiguration = "interactive" },
            eclipse = { downloadSources = true },
            maven = { downloadSources = true },
          },
        },
      })

      -- C / C++
      setup_if_installed("clangd", {
        capabilities = capabilities,
        on_attach = on_attach,
        cmd = {
          "clangd",
          "--background-index",
          "--clang-tidy",
          "--header-insertion=iwyu",
          "--completion-style=detailed",
        },
      })

      -- Bash / shell scripts
      setup_if_installed("bashls", {
        capabilities = capabilities,
        on_attach = on_attach,
        filetypes = { "sh", "bash", "zsh" },
      })

      -- Lua (for editing this config file)
      setup_if_installed("lua_ls", {
        capabilities = capabilities,
        on_attach = on_attach,
        settings = {
          Lua = {
            runtime = { version = "LuaJIT" },
            diagnostics = { globals = { "vim" } },
            workspace = {
              library = vim.api.nvim_get_runtime_file("", true),
              checkThirdParty = false,
            },
            telemetry = { enable = false },
          },
        },
      })

      -- JSON
      setup_if_installed("jsonls", { capabilities = capabilities, on_attach = on_attach })

      -- YAML
      setup_if_installed("yamlls", { capabilities = capabilities, on_attach = on_attach })

      -- XML
      setup_if_installed("lemminx", { capabilities = capabilities, on_attach = on_attach })

      -- Diagnostic display settings (consistent with Genero-Tools style)
      vim.diagnostic.config({
        virtual_text = {
          prefix = "●",
          source = "if_many",
        },
        signs = true,
        underline = true,
        update_in_insert = false,   -- Don't flicker while typing
        severity_sort = true,
        float = {
          border = "rounded",
          source = "always",
        },
      })
    end,
  },

  -- ============================================================================
  -- COMPLETION - nvim-cmp for LSP + snippet completion on non-Genero files
  -- ============================================================================
  {
    "hrsh7th/nvim-cmp",
    dependencies = {
      "hrsh7th/cmp-nvim-lsp",    -- LSP source
      "hrsh7th/cmp-buffer",      -- Words from current buffer
      "hrsh7th/cmp-path",        -- Filesystem paths
      -- NOTE: cmp-cmdline removed - command-line completion disabled to avoid conflicts with noice
      "L3MON4D3/LuaSnip",        -- Snippet engine (shared with Genero snippets)
      "saadparwaiz1/cmp_luasnip", -- LuaSnip source for cmp
      "genero-tools",            -- Genero completion source
    },
    config = function()
      local cmp = require("cmp")
      local luasnip = require("luasnip")

      -- Load Genero cmp source (registers itself automatically)
      pcall(require, "genero_tools.cmp_source")

      cmp.setup({
        enabled = function()
          -- Disable in command-line mode (noice popup)
          local context = require("cmp.config.context")
          
          -- Check if we're in a command-line buffer
          local buftype = vim.api.nvim_buf_get_option(0, "buftype")
          if buftype == "prompt" then
            return false
          end
          
          -- Check buffer name for noice command-line
          local bufname = vim.api.nvim_buf_get_name(0)
          if bufname:match("^noice://") or bufname:match("^%[Command Line%]") then
            return false
          end
          
          -- Disable in comments (optional, but good practice)
          if context.in_treesitter_capture("comment") or context.in_syntax_group("Comment") then
            return false
          end
          
          return true
        end,
        snippet = {
          expand = function(args)
            luasnip.lsp_expand(args.body)
          end,
        },
        window = {
          completion    = cmp.config.window.bordered(),
          documentation = cmp.config.window.bordered(),
        },
        mapping = cmp.mapping.preset.insert({
          ["<C-Space>"] = cmp.mapping.complete(),
          ["<C-e>"]     = cmp.mapping.abort(),
          ["<CR>"]      = cmp.mapping.confirm({ select = false }),  -- only confirm explicit selection
          ["<Tab>"]     = cmp.mapping(function(fallback)
            if cmp.visible() then
              cmp.confirm({ select = true })  -- Accept highlighted item
            elseif luasnip.expand_or_jumpable() then
              luasnip.expand_or_jump()
            else
              fallback()
            end
          end, { "i", "s" }),
          ["<S-Tab>"] = cmp.mapping(function(fallback)
            if cmp.visible() then
              cmp.select_prev_item()
            elseif luasnip.jumpable(-1) then
              luasnip.jump(-1)
            else
              fallback()
            end
          end, { "i", "s" }),
          ["<C-u>"] = cmp.mapping.scroll_docs(-4),
          ["<C-d>"] = cmp.mapping.scroll_docs(4),
        }),
        sources = cmp.config.sources({
          { name = "genero",   priority = 1100 },  -- Genero functions (highest priority on .4gl files)
          { name = "nvim_lsp", priority = 1000 },
          { name = "luasnip",  priority = 750 },
          { 
            name = "buffer",
            priority = 500,
            option = {
              -- Prioritize matches closer to cursor position
              get_bufnrs = function()
                return { vim.api.nvim_get_current_buf() }
              end,
              keyword_pattern = [[\k\+]],
              -- Use locality bonus for sorting (closer matches ranked higher)
              keyword_length = 3,  -- Minimum 3 characters to trigger
            }
          },
          { name = "path",     priority = 250 },
        }),
        sorting = {
          priority_weight = 2,
          comparators = {
            -- Prioritize by source priority first (genero > lsp > buffer)
            require("cmp").config.compare.score,
            require("cmp").config.compare.recently_used,
            require("cmp").config.compare.locality,  -- Prioritize items closer to cursor
            require("cmp").config.compare.kind,
            require("cmp").config.compare.sort_text,
            require("cmp").config.compare.length,
            require("cmp").config.compare.order,
          },
        },
        formatting = {
          format = function(entry, item)
            -- Show source name in the menu
            local source_labels = {
              genero   = "[Genero]",
              nvim_lsp = "[LSP]",
              luasnip  = "[Snippet]",
              buffer   = "[Buf]",
              path     = "[Path]",
            }
            item.menu = source_labels[entry.source.name] or ""
            
            -- For snippets, show a snippet icon
            if entry.source.name == "luasnip" then
              item.kind = "Snippet"
            end
            
            return item
          end,
        },
      })

      -- NOTE: Command-line completion is intentionally disabled
      -- nvim-cmp in command mode conflicts with noice.nvim popup cmdline
      -- Use native Vim command-line completion instead (Tab, Ctrl+D)
    end,
  },

  -- Telescope - Fuzzy finder for files, grep, and more
  -- Falls back to native grep if ripgrep is not installed
  {
    "nvim-telescope/telescope.nvim",
    branch = "0.1.x",
    dependencies = {
      "nvim-lua/plenary.nvim",
    },
    config = function()
      local telescope = require("telescope")
      local actions = require("telescope.actions")

      -- Detect available grep tool: prefer ripgrep, fall back to grep
      local has_rg = vim.fn.executable("rg") == 1
      local vimgrep_arguments
      if has_rg then
        vimgrep_arguments = {
          "rg", "--color=never", "--no-heading", "--with-filename",
          "--line-number", "--column", "--smart-case", "--hidden",
        }
      else
        -- Fallback: use grep (available on virtually all systems)
        vimgrep_arguments = {
          "grep", "-r", "-n",
          -- Genero
          "--include=*.4gl", "--include=*.per", "--include=*.m3", "--include=*.m4",
          -- Common languages in the codebase
          "--include=*.py", "--include=*.java", "--include=*.c", "--include=*.h",
          "--include=*.cpp", "--include=*.pl", "--include=*.pm", "--include=*.sh",
          -- Config / data
          "--include=*.lua", "--include=*.vim", "--include=*.json", "--include=*.xml",
          "--include=*.yaml", "--include=*.yml", "--include=*.sql",
          "--include=*.txt", "--include=*.md", "--include=*.conf", "--include=*.cfg",
          "--exclude-dir=.git", "--exclude-dir=node_modules", "--exclude-dir=target",
          "--exclude-dir=build", "--exclude-dir=__pycache__",
          "-H", "-E",
        }
        vim.notify("ripgrep (rg) not found — Telescope grep using system grep (slower)", vim.log.levels.INFO)
      end

      telescope.setup({
        defaults = {
          vimgrep_arguments = vimgrep_arguments,
          prompt_prefix = "   ",
          selection_caret = "  ",
          entry_prefix = "  ",
          sorting_strategy = "ascending",
          layout_strategy = "horizontal",
          layout_config = {
            horizontal = {
              prompt_position = "top",
              preview_width = 0.55,
              results_width = 0.8,
            },
            vertical = {
              mirror = false,
            },
            width = 0.87,
            height = 0.80,
            preview_cutoff = 120,
          },
          file_ignore_patterns = {
            "node_modules", ".git/",
            "%.42m", "%.42f", "%.o",          -- Genero / C build artifacts
            "__pycache__/", "%.pyc",           -- Python
            "target/", "%.class", "%.jar",     -- Java
            "build/", "dist/",
          },
          path_display = { "truncate" },
          winblend = 0,
          border = {},
          borderchars = { "─", "│", "─", "│", "╭", "╮", "╯", "╰" },
          color_devicons = true,
          -- Disable treesitter highlighting in preview to avoid compatibility issues
          -- This prevents the "ft_to_lang is nil" error with some treesitter versions
          preview = {
            treesitter = false,  -- Use vim syntax highlighting instead
          },
          mappings = {
            i = {
              ["<C-n>"] = actions.cycle_history_next,
              ["<C-p>"] = actions.cycle_history_prev,
              ["<C-j>"] = actions.move_selection_next,
              ["<C-k>"] = actions.move_selection_previous,
              ["<C-c>"] = actions.close,
              ["<CR>"] = actions.select_default,
              ["<C-x>"] = actions.select_horizontal,
              ["<C-v>"] = actions.select_vertical,
              ["<C-u>"] = actions.preview_scrolling_up,
              ["<C-d>"] = actions.preview_scrolling_down,
            },
            n = {
              ["<Esc>"] = actions.close,
              ["q"] = actions.close,
              ["<CR>"] = actions.select_default,
              ["j"] = actions.move_selection_next,
              ["k"] = actions.move_selection_previous,
            },
          },
        },
        pickers = {
          grep_string = {
            additional_args = has_rg and { "--hidden" } or {},
          },
          live_grep = {
            additional_args = has_rg and { "--hidden" } or {},
          },
        },
      })
    end,
  },
}

require("lazy").setup(plugins, {
  defaults = {
    lazy = false,
  },
})

-- ============================================================================
-- KEYBINDINGS
-- ============================================================================

local map = vim.keymap.set
local opts = { noremap = true, silent = true }

-- Compile current file (F5)
map("n", "<F5>", ":GeneroCompile<CR>", opts)

-- Autocomplete (Ctrl+Space in insert mode)
map("i", "<C-Space>", "<C-x><C-o>", opts)

-- Navigate errors/warnings
-- Ctrl+. and Ctrl+, work in GUI Neovim and modern terminals (kitty, WezTerm)
-- ]d and [d work everywhere (standard Neovim diagnostic convention)
map("n", "<C-,>", ":GeneroPrevError<CR>", opts)
map("n", "<C-.>", ":GeneroNextError<CR>", opts)
map("n", "]d", ":GeneroNextError<CR>", { noremap = true, silent = true, desc = "Next error" })
map("n", "[d", ":GeneroPrevError<CR>", { noremap = true, silent = true, desc = "Previous error" })

-- Toggle autocompile
map("n", "<leader>ca", ":GeneroAutocompileEnable<CR>", opts)
map("n", "<leader>cd", ":GeneroAutocompileDisable<CR>", opts)

-- Clear errors
map("n", "<leader>cc", ":GeneroClearErrors<CR>", opts)

-- Error filtering (after compilation)
map("n", "<leader>ce", ":GeneroFilterErrors<CR>", { noremap = true, silent = true, desc = "Show errors only" })
map("n", "<leader>cw", ":GeneroFilterWarnings<CR>", { noremap = true, silent = true, desc = "Show warnings only" })
map("n", "<leader>cx", ":GeneroFilterAll<CR>", { noremap = true, silent = true, desc = "Show all diagnostics" })

-- Hint navigation
map("n", "<leader>hn", ":GeneroNextHint<CR>", opts)
map("n", "<leader>hp", ":GeneroPrevHint<CR>", opts)
map("n", "<leader>hl", ":GeneroListHints<CR>", opts)
map("n", "<leader>hd", ":GeneroHintDetails<CR>", opts)
map("n", "<leader>hf", ":GeneroHintAutofix<CR>", opts)
map("n", "]h", ":GeneroNextHint<CR>", { noremap = true, silent = true, desc = "Next hint" })
map("n", "[h", ":GeneroPrevHint<CR>", { noremap = true, silent = true, desc = "Previous hint" })

-- SVN diff markers
map("n", "<leader>sv", ":GeneroSVNToggle<CR>", opts)
map("n", "<leader>sr", ":GeneroSVNRefresh<CR>", opts)
map("n", "<leader>ss", ":GeneroSVNStatus<CR>", opts)

-- Unified signs (compiler + SVN)
map("n", "<leader>su", ":GeneroUnifiedSignsToggle<CR>", opts)

-- Debug streaming (toggle on/off)
map("n", "<leader>gd", ":GeneroDebugStreamToggle<CR>", opts)

-- Go to definition / Peek definition / Find references
map("n", "gd", ":GeneroGotoDefinition<CR>", { noremap = true, silent = true, desc = "Go to definition" })
map("n", "gp", ":GeneroPeekDefinition<CR>", { noremap = true, silent = true, desc = "Peek definition" })
map("n", "gr", ":GeneroFindSmartReferences<CR>", { noremap = true, silent = true, desc = "Find references (smart)" })
map("n", "gR", ":GeneroFindReferences<CR>", { noremap = true, silent = true, desc = "Find function references" })

-- Telescope pickers
map("n", "<leader>gF", ":GeneroFileFunctions<CR>", { noremap = true, silent = true, desc = "File functions (Telescope)" })
map("n", "<leader>gM", ":GeneroModuleFunctions<CR>", { noremap = true, silent = true, desc = "Module functions (Telescope)" })
map("n", "<leader>gS", ":GeneroModuleFiles<CR>", { noremap = true, silent = true, desc = "Module sibling files" })
map("n", "<leader>cD", ":GeneroDiagnostics<CR>", { noremap = true, silent = true, desc = "Diagnostics (Telescope)" })

-- Snippet commands (Neovim only with LuaSnip)
map("n", "<leader>sl", ":GeneroSnippetList<CR>", opts)
map("n", "<leader>sh", ":GeneroSnippetHelp<CR>", opts)

-- Window navigation
map("n", "<C-h>", "<C-w>h", opts)
map("n", "<C-j>", "<C-w>j", opts)
map("n", "<C-k>", "<C-w>k", opts)
map("n", "<C-l>", "<C-w>l", opts)

-- Buffer navigation
map("n", "<leader>bn", ":bnext<CR>", opts)
map("n", "<leader>bp", ":bprev<CR>", opts)
map("n", "<leader>bd", ":bdelete<CR>", opts)

-- Buffer navigation with wrapping
map("n", "]b", function()
  local current = vim.fn.bufnr('%')
  local last = vim.fn.bufnr('$')
  local next = current
  
  -- Find next listed buffer
  for i = 1, last do
    next = next + 1
    if next > last then
      next = 1  -- Wrap to first buffer
    end
    if vim.fn.buflisted(next) == 1 then
      vim.cmd('buffer ' .. next)
      return
    end
  end
end, { noremap = true, silent = true, desc = "Next buffer (wrap)" })

map("n", "[b", function()
  local current = vim.fn.bufnr('%')
  local last = vim.fn.bufnr('$')
  local prev = current
  
  -- Find previous listed buffer
  for i = 1, last do
    prev = prev - 1
    if prev < 1 then
      prev = last  -- Wrap to last buffer
    end
    if vim.fn.buflisted(prev) == 1 then
      vim.cmd('buffer ' .. prev)
      return
    end
  end
end, { noremap = true, silent = true, desc = "Previous buffer (wrap)" })

-- Temp code tag navigation: jump to next/prev #TMP<initials> tag for current user
-- Uses $USER to build the tag pattern (e.g. hdean → #TMPHD)
local username = os.getenv("USER") or ""
local tmp_tag = "#TMP" .. string.upper(string.sub(username, 1, 2))

map("n", "]]", function()
  local pattern = vim.fn.escape(tmp_tag, "#")
  local pos = vim.fn.getpos('.')
  
  -- Try to find next occurrence
  if vim.fn.search(pattern, "W") == 0 then
    -- Not found forward, wrap to beginning
    vim.fn.cursor(1, 1)
    if vim.fn.search(pattern, "W") == 0 then
      -- Still not found, restore position and notify
      vim.fn.setpos('.', pos)
      vim.notify("No " .. tmp_tag .. " tags found", vim.log.levels.WARN)
    else
      vim.notify("Wrapped to first " .. tmp_tag, vim.log.levels.INFO)
    end
  end
end, { noremap = true, silent = true, desc = "Next temp tag (" .. tmp_tag .. ", wrap)" })

map("n", "[[", function()
  local pattern = vim.fn.escape(tmp_tag, "#")
  local pos = vim.fn.getpos('.')
  
  -- Try to find previous occurrence
  if vim.fn.search(pattern, "bW") == 0 then
    -- Not found backward, wrap to end
    vim.fn.cursor(vim.fn.line('$'), 1)
    if vim.fn.search(pattern, "bW") == 0 then
      -- Still not found, restore position and notify
      vim.fn.setpos('.', pos)
      vim.notify("No " .. tmp_tag .. " tags found", vim.log.levels.WARN)
    else
      vim.notify("Wrapped to last " .. tmp_tag, vim.log.levels.INFO)
    end
  end
end, { noremap = true, silent = true, desc = "Prev temp tag (" .. tmp_tag .. ", wrap)" })

-- Navigate between splits with Ctrl+Arrow keys
map("n", "<C-Up>", "<C-w>k", { noremap = true, silent = true, desc = "Move to split above" })
map("n", "<C-Down>", "<C-w>j", { noremap = true, silent = true, desc = "Move to split below" })
map("n", "<C-Left>", "<C-w>h", { noremap = true, silent = true, desc = "Move to split left" })
map("n", "<C-Right>", "<C-w>l", { noremap = true, silent = true, desc = "Move to split right" })

-- ============================================================================
-- SEARCH HELPERS (Telescope with native grep/vimgrep fallback)
-- ============================================================================

-- Search word under cursor: tries Telescope grep_string, falls back to :vimgrep
local function search_word_under_cursor()
  local word = vim.fn.expand("<cword>")
  if word == "" then
    vim.notify("No word under cursor", vim.log.levels.WARN)
    return
  end
  local ok, builtin = pcall(require, "telescope.builtin")
  if ok then
    builtin.grep_string({ word_match = "-w" })
  else
    -- Fallback: use :vimgrep and open quickfix
    local escaped = vim.fn.escape(word, "/\\")
    vim.cmd("silent! vimgrep /\\<" .. escaped .. "\\>/j **/*")
    vim.cmd("copen")
  end
end

-- Live grep: tries Telescope live_grep, falls back to prompted :vimgrep
local function live_grep()
  local ok, builtin = pcall(require, "telescope.builtin")
  if ok then
    builtin.live_grep()
  else
    -- Fallback: prompt for pattern and use :vimgrep
    vim.ui.input({ prompt = "Grep pattern: " }, function(pattern)
      if pattern and pattern ~= "" then
        local escaped = vim.fn.escape(pattern, "/\\")
        vim.cmd("silent! vimgrep /" .. escaped .. "/j **/*")
        vim.cmd("copen")
      end
    end)
  end
end

-- Find files: tries Telescope find_files, falls back to :edit with wildmenu
local function find_files()
  local ok, builtin = pcall(require, "telescope.builtin")
  if ok then
    builtin.find_files()
  else
    -- Fallback: use the built-in file explorer
    vim.cmd("edit .")
  end
end

-- Search buffers: tries Telescope buffers, falls back to :ls + :buffer
local function search_buffers()
  local ok, builtin = pcall(require, "telescope.builtin")
  if ok then
    builtin.buffers()
  else
    -- Fallback: list buffers and prompt for selection
    vim.cmd("ls")
    vim.ui.input({ prompt = "Buffer number: " }, function(input)
      if input and input ~= "" then
        vim.cmd("buffer " .. input)
      end
    end)
  end
end

-- Telescope: search word under cursor in current directory
map("n", "<leader>fw", search_word_under_cursor, { noremap = true, silent = true, desc = "Search word under cursor" })

-- Telescope: live grep (interactive search)
map("n", "<leader>fg", live_grep, { noremap = true, silent = true, desc = "Live grep" })

-- Telescope: find files
map("n", "<leader>ff", find_files, { noremap = true, silent = true, desc = "Find files" })

-- Telescope: search buffers
map("n", "<leader>fb", search_buffers, { noremap = true, silent = true, desc = "Search buffers" })

-- Terminal toggles (Ctrl+\ is the main toggle, these are extras)
map("n", "<leader>tf", "<cmd>ToggleTerm direction=float<CR>", { noremap = true, silent = true, desc = "Float terminal" })
map("n", "<leader>th", "<cmd>ToggleTerm direction=horizontal<CR>", { noremap = true, silent = true, desc = "Horizontal terminal" })
map("n", "<leader>tv", "<cmd>ToggleTerm direction=vertical<CR>", { noremap = true, silent = true, desc = "Vertical terminal" })

-- Kiro AI assistant terminal (dedicated vertical split)
-- Uses ToggleTerm instance #9 so it doesn't conflict with regular terminals
-- Run 'kiro-cli' in a separate terminal first if you need to log in
local kiro_term = nil
local function toggle_kiro()
  if not kiro_term then
    local Terminal = require("toggleterm.terminal").Terminal
    kiro_term = Terminal:new({
      cmd = "kiro-cli",
      direction = "vertical",
      count = 9,
      close_on_exit = false,
    })
  end
  kiro_term:toggle()
end

map("n", "<leader>tk", toggle_kiro, { noremap = true, silent = true, desc = "Kiro AI terminal" })

-- Clear search highlight
map("n", "<Esc>", ":nohlsearch<CR>", opts)

-- Search navigation: center screen and briefly pulse the current match
map("n", "n", "nzzzv", opts)
map("n", "N", "Nzzzv", opts)
map("n", "*", "*zzzv", opts)
map("n", "#", "#zzzv", opts)

-- ============================================================================
-- WHICH-KEY DESCRIPTIONS
-- ============================================================================

local wk = require("which-key")

if is_nvim_010_plus then
  -- which-key v3+ uses wk.add() with a flat list
  wk.add({
    { "<leader>c", group = "Compiler" },
    { "<leader>ca", ":GeneroAutocompileEnable<CR>", desc = "Enable autocompile" },
    { "<leader>cd", ":GeneroAutocompileDisable<CR>", desc = "Disable autocompile" },
    { "<leader>cc", ":GeneroClearErrors<CR>", desc = "Clear errors" },
    { "<leader>ce", desc = "Show errors only" },
    { "<leader>cw", desc = "Show warnings only" },
    { "<leader>cx", desc = "Show all diagnostics" },
    { "<leader>cD", ":GeneroDiagnostics<CR>", desc = "Diagnostics (Telescope)" },

    { "<leader>f", group = "Find/Search" },
    { "<leader>fw", desc = "Search word under cursor" },
    { "<leader>fg", desc = "Live grep" },
    { "<leader>ff", desc = "Find files" },
    { "<leader>fb", desc = "Search buffers" },

    { "<leader>g", group = "Genero-Tools" },
    { "<leader>gl", ":GeneroLookup<CR>", desc = "Lookup function" },
    { "<leader>gf", ":GeneroListFunctions<CR>", desc = "List functions in file" },
    { "<leader>gs", ":GeneroFunctionSignature<CR>", desc = "Get function signature" },
    { "<leader>gm", ":GeneroFileMetadata<CR>", desc = "Get file metadata" },
    { "<leader>gd", ":GeneroDebugStreamToggle<CR>", desc = "Toggle debug stream" },
    { "<leader>gF", ":GeneroFileFunctions<CR>", desc = "File functions (Telescope)" },
    { "<leader>gM", ":GeneroModuleFunctions<CR>", desc = "Module functions (Telescope)" },
    { "<leader>gS", ":GeneroModuleFiles<CR>", desc = "Module sibling files" },
    { "<leader>gh", ":GeneroHelpToggle<CR>", desc = "Toggle help window" },

    { "<leader>h", group = "Hints" },
    { "<leader>hn", ":GeneroNextHint<CR>", desc = "Next hint" },
    { "<leader>hp", ":GeneroPrevHint<CR>", desc = "Previous hint" },
    { "<leader>hl", ":GeneroListHints<CR>", desc = "List all hints" },
    { "<leader>hd", ":GeneroHintDetails<CR>", desc = "Hint details" },
    { "<leader>hf", ":GeneroHintAutofix<CR>", desc = "Apply auto-fix" },

    { "<leader>s", group = "SVN/Signs/Snippets" },
    { "<leader>st", ":GeneroSVNToggle<CR>", desc = "Toggle SVN markers" },
    { "<leader>ss", ":GeneroSVNStatus<CR>", desc = "SVN status" },
    { "<leader>sb", ":GeneroSVNBlameCurrentLine<CR>", desc = "SVN blame current line" },
    { "<leader>sr", ":GeneroSVNRevertLine<CR>", desc = "SVN revert current line" },
    { "<leader>su", ":GeneroUnifiedSignsToggle<CR>", desc = "Toggle unified signs" },
    { "<leader>sl", ":GeneroSnippetList<CR>", desc = "List snippets" },
    { "<leader>sh", ":GeneroSnippetHelp<CR>", desc = "Snippet help" },

    { "<leader>t", group = "Terminal" },
    { "<leader>tf", desc = "Float terminal" },
    { "<leader>th", desc = "Horizontal terminal" },
    { "<leader>tv", desc = "Vertical terminal" },
    { "<leader>tk", desc = "Kiro AI terminal" },

    { "<leader>l", group = "LSP" },
    { "<leader>la", desc = "Code action" },
    { "<leader>lf", desc = "Format file" },
    { "<leader>ld", desc = "Line diagnostics" },
    { "<leader>rn", desc = "Rename symbol" },

    { "<leader>b", group = "Buffers" },
    { "<leader>bd", ":bdelete<CR>", desc = "Delete buffer" },
  })
else
  -- which-key v1.x uses wk.register()
  wk.register({
    c = {
      name = "+Compiler",
      a = { ":GeneroAutocompileEnable<CR>", "Enable autocompile" },
      d = { ":GeneroAutocompileDisable<CR>", "Disable autocompile" },
      c = { ":GeneroClearErrors<CR>", "Clear errors" },
      e = { "Show errors only" },
      w = { "Show warnings only" },
      x = { "Show all diagnostics" },
      D = { ":GeneroDiagnostics<CR>", "Diagnostics (Telescope)" },
    },
    f = {
      name = "+Find/Search",
      w = { "Search word under cursor" },
      g = { "Live grep" },
      f = { "Find files" },
      b = { "Search buffers" },
    },
    g = {
      name = "+Genero-Tools",
      l = { ":GeneroLookup<CR>", "Lookup function" },
      f = { ":GeneroListFunctions<CR>", "List functions in file" },
      s = { ":GeneroFunctionSignature<CR>", "Get function signature" },
      m = { ":GeneroFileMetadata<CR>", "Get file metadata" },
      d = { ":GeneroDebugStreamToggle<CR>", "Toggle debug stream" },
      r = { ":GeneroFindReferences<CR>", "Find references" },
      F = { ":GeneroFileFunctions<CR>", "File functions (Telescope)" },
      M = { ":GeneroModuleFunctions<CR>", "Module functions (Telescope)" },
      S = { ":GeneroModuleFiles<CR>", "Module sibling files" },
      h = { ":GeneroHelpToggle<CR>", "Toggle help window" },
    },
    h = {
      name = "+Hints",
      n = { ":GeneroNextHint<CR>", "Next hint" },
      p = { ":GeneroPrevHint<CR>", "Previous hint" },
      l = { ":GeneroListHints<CR>", "List all hints" },
      d = { ":GeneroHintDetails<CR>", "Hint details" },
      f = { ":GeneroHintAutofix<CR>", "Apply auto-fix" },
    },
    s = {
      name = "+SVN/Signs/Snippets",
      t = { ":GeneroSVNToggle<CR>", "Toggle SVN markers" },
      s = { ":GeneroSVNStatus<CR>", "SVN status" },
      b = { ":GeneroSVNBlameCurrentLine<CR>", "SVN blame current line" },
      r = { ":GeneroSVNRevertLine<CR>", "SVN revert current line" },
      u = { ":GeneroUnifiedSignsToggle<CR>", "Toggle unified signs" },
      l = { ":GeneroSnippetList<CR>", "List snippets" },
      h = { ":GeneroSnippetHelp<CR>", "Snippet help" },
    },
    t = {
      name = "+Terminal",
      f = { "Float terminal" },
      h = { "Horizontal terminal" },
      v = { "Vertical terminal" },
      k = { "Kiro AI terminal" },
    },
    l = {
      name = "+LSP",
      a = { "Code action" },
      f = { "Format file" },
      d = { "Line diagnostics" },
    },
    r = {
      name = "+Rename",
      n = { "Rename symbol" },
    },
    b = {
      name = "+Buffers",
      d = { ":bdelete<CR>", "Delete buffer" },
    },
  }, { prefix = "<leader>" })
end

-- ============================================================================
-- HELPFUL COMMANDS & AUTOCMDS
-- ============================================================================

-- Show keybindings help in floating window
vim.api.nvim_create_user_command("GeneroHelp", function()
  require('genero_tools.help').show()
end, {})

-- Toggle help window
vim.api.nvim_create_user_command("GeneroHelpToggle", function()
  require('genero_tools.help').toggle()
end, {})

-- Close help window
vim.api.nvim_create_user_command("GeneroHelpClose", function()
  require('genero_tools.help').close()
end, {})

-- Show help on startup if no files are opened
vim.api.nvim_create_autocmd("VimEnter", {
  callback = function()
    if vim.fn.argc() == 0 then
      vim.cmd("GeneroHelp")
    end
  end,
})

-- Highlight on yank
vim.api.nvim_create_autocmd("TextYankPost", {
  callback = function()
    vim.highlight.on_yank({ higroup = "IncSearch", timeout = 200 })
  end,
})

-- Restore cursor position when reopening a file
vim.api.nvim_create_autocmd("BufReadPost", {
  callback = function()
    local mark = vim.api.nvim_buf_get_mark(0, '"')
    local line = mark[1]
    if line > 0 and line <= vim.api.nvim_buf_line_count(0) then
      vim.api.nvim_win_set_cursor(0, mark)
    end
  end,
})

-- Parentheses/bracket matching: background-only highlight (no orange foreground)
-- Uses a subtle background that works across themes
vim.api.nvim_create_autocmd("ColorScheme", {
  callback = function()
    vim.api.nvim_set_hl(0, "MatchParen", { bg = "#3b4261", fg = "NONE", bold = true })
  end,
})
-- Apply immediately for the current colorscheme
vim.api.nvim_set_hl(0, "MatchParen", { bg = "#3b4261", fg = "NONE", bold = true })

-- Auto-resize splits when window is resized
-- Note: Disabled to preserve debug stream window width
-- Uncomment if you want equal-sized splits
-- vim.api.nvim_create_autocmd("VimResized", {
--   callback = function()
--     vim.cmd("tabdo wincmd =")
--   end,
-- })