feat(highlight): warn when hunks exceed max_lines (#184)

lua/diffs/highlight.lua

@@ -310,16 +310,27 @@ function M.highlight_hunk(bufnr, ns, hunk, opts)
   local use_vim = not use_ts and hunk.ft and opts.highlights.vim.enabled
 
   local max_lines = use_ts and opts.highlights.treesitter.max_lines or opts.highlights.vim.max_lines
-  if (use_ts or use_vim) and #hunk.lines > max_lines then
-    dbg(
-      'skipping hunk %s:%d (%d lines > %d max)',
-      hunk.filename,
-      hunk.start_line,
-      #hunk.lines,
-      max_lines
-    )
-    use_ts = false
-    use_vim = false
+  if use_ts or use_vim then
+    local hl_count = 0
+    for _, line in ipairs(hunk.lines) do
+      local c = line:sub(1, 1)
+      if c == '+' or c == '-' then
+        hl_count = hl_count + 1
+      end
+    end
+    hunk._hl_line_count = hl_count
+    if hl_count > max_lines then
+      dbg(
+        'skipping hunk %s:%d (%d highlighted lines > %d max)',
+        hunk.filename,
+        hunk.start_line,
+        hl_count,
+        max_lines
+      )
+      hunk._skipped_max_lines = true
+      use_ts = false
+      use_vim = false
+    end
   end
 
   if use_vim and opts.defer_vim_syntax then
@@ -456,7 +467,7 @@ function M.highlight_hunk(bufnr, ns, hunk, opts)
     and intra_cfg
     and intra_cfg.enabled
     and pw == 1
-    and #hunk.lines <= intra_cfg.max_lines
+    and (hunk._hl_line_count or #hunk.lines) <= intra_cfg.max_lines
   then
     dbg('computing intra for hunk %s:%d (%d lines)', hunk.filename, hunk.start_line, #hunk.lines)
     intra = diff.compute_intra_hunks(hunk.lines, intra_cfg.algorithm)
@@ -467,8 +478,12 @@ function M.highlight_hunk(bufnr, ns, hunk, opts)
     end
   elseif intra_cfg and not intra_cfg.enabled then
     dbg('intra disabled by config')
-  elseif intra_cfg and #hunk.lines > intra_cfg.max_lines then
-    dbg('intra skipped: %d lines > %d max', #hunk.lines, intra_cfg.max_lines)
+  elseif intra_cfg and (hunk._hl_line_count or #hunk.lines) > intra_cfg.max_lines then
+    dbg(
+      'intra skipped: %d highlighted lines > %d max',
+      hunk._hl_line_count or #hunk.lines,
+      intra_cfg.max_lines
+    )
   end
 
   ---@type table<integer, diffs.CharSpan[]>

lua/diffs/init.lua

@@ -26,6 +26,7 @@
 ---@field gutter boolean
 ---@field blend_alpha? number
 ---@field overrides? table<string, table>
+---@field warn_max_lines boolean
 ---@field context diffs.ContextConfig
 ---@field treesitter diffs.TreesitterConfig
 ---@field vim diffs.VimConfig
@@ -132,6 +133,7 @@ local default_config = {
   highlights = {
     background = true,
     gutter = true,
+    warn_max_lines = true,
     context = {
       enabled = true,
       lines = 25,
@@ -203,6 +205,7 @@ local diff_windows = {}
 ---@field tick integer
 ---@field highlighted table<integer, true>
 ---@field pending_clear boolean
+---@field warned_max_lines boolean
 ---@field line_count integer
 ---@field byte_count integer
 
@@ -423,6 +426,7 @@ local function ensure_cache(bufnr)
     tick = tick,
     highlighted = carried or {},
     pending_clear = not carried,
+    warned_max_lines = false,
     line_count = lc,
     byte_count = bc,
   }
@@ -703,6 +707,7 @@ local function init()
     vim.validate('highlights.gutter', opts.highlights.gutter, 'boolean', true)
     vim.validate('highlights.blend_alpha', opts.highlights.blend_alpha, 'number', true)
     vim.validate('highlights.overrides', opts.highlights.overrides, 'table', true)
+    vim.validate('highlights.warn_max_lines', opts.highlights.warn_max_lines, 'boolean', true)
     vim.validate('highlights.context', opts.highlights.context, 'table', true)
     vim.validate('highlights.treesitter', opts.highlights.treesitter, 'table', true)
     vim.validate('highlights.vim', opts.highlights.vim, 'table', true)
@@ -910,6 +915,7 @@ local function init()
       end
       local t0 = config.debug and vim.uv.hrtime() or nil
       local deferred_syntax = {}
+      local skipped_count = 0
       local count = 0
       for i = first, last do
         if not entry.highlighted[i] then
@@ -923,6 +929,9 @@ local function init()
           highlight.highlight_hunk(bufnr, ns, hunk, fast_hl_opts)
           entry.highlighted[i] = true
           count = count + 1
+          if hunk._skipped_max_lines then
+            skipped_count = skipped_count + 1
+          end
           local has_syntax = hunk.lang and config.highlights.treesitter.enabled
           local needs_vim = not hunk.lang and hunk.ft and config.highlights.vim.enabled
           if has_syntax or needs_vim then
@@ -930,6 +939,19 @@ local function init()
           end
         end
       end
+      if skipped_count > 0 and not entry.warned_max_lines and config.highlights.warn_max_lines then
+        entry.warned_max_lines = true
+        local n = skipped_count
+        vim.schedule(function()
+          vim.notify(
+            (
+              '[diffs.nvim]: Syntax highlighting skipped for %d hunk(s) — too large.'
+              .. ' See :h diffs-max-lines to resolve or suppress this warning.'
+            ):format(n),
+            vim.log.levels.WARN
+          )
+        end)
+      end
       if #deferred_syntax > 0 then
         local tick = entry.tick
         dbg('deferred syntax scheduled: %d hunks tick=%d', #deferred_syntax, tick)

lua/diffs/parser.lua

@@ -17,6 +17,8 @@
 ---@field repo_root string?
 ---@field context_before string[]?
 ---@field context_after string[]?
+---@field _hl_line_count integer?
+---@field _skipped_max_lines boolean?
 
 local M = {}