fix: address findings from 22-agent audit

- terminal.lua: Konsole detection changed from KONSOLE_VERSION (not an
  env var in modern Konsole) to KONSOLE_DBUS_SESSION, protocol changed
  from kitty to sixel (Konsole's kitty support is partial — no file
  transmission mode which image.nvim requires)
- chafa.lua: ANSI escape stripping pattern expanded to include repeat-
  char sequence (\e[Nb) used on vte/ctx terminals
- config.lua: added range clamping for zindex (>= 1), debounce_ms
  (>= 0), render_timeout_ms (>= 100), max_file_size_mb (> 0); added
  NaN/infinity/non-positive guard for chafa.max_output_bytes
- renderer.lua: stabilized priority sort with name tiebreaker to ensure
  deterministic renderer selection when priorities are equal
- preview.lua: replaced two vim.fn calls (line/col) with single
  vim.api.nvim_win_get_cursor() call in _create_anchor()
- docs: added mini.files to README requirements and CHANGELOG
- vimdoc: updated Konsole detection info in terminal table

Author: hmdfrds

CHANGELOG.md

@@ -9,7 +9,7 @@
 - LRU render cache for instant re-hover
 - Content swap for flicker-free image browsing
 - image.nvim (pixel-perfect) and chafa (universal fallback) renderers
-- Neo-tree, nvim-tree, oil, snacks source adapters
+- Neo-tree, nvim-tree, oil, snacks, mini.files source adapters
 - Runtime toggle (:FocalEnable/:FocalDisable/:FocalToggle)
 - Manual preview (:FocalShow [path])
 - Configurable border, winblend, zindex, title

README.md

@@ -33,7 +33,7 @@ focal.nvim is an extensible preview framework with dual backends (pixel-perfect
 - **At least one rendering backend:**
   - [image.nvim](https://github.com/3rd/image.nvim) — pixel-perfect graphics (Kitty, WezTerm, Ghostty, iTerm2, foot, Konsole)
   - [chafa](https://hpjansson.org/chafa/) — universal Unicode/ANSI fallback (any terminal with 256-color or truecolor)
-- **A file explorer:** neo-tree, nvim-tree, oil.nvim, or snacks.nvim
+- **A file explorer:** neo-tree, nvim-tree, oil.nvim, snacks.nvim, or mini.files
 
 ## Installation
 

doc/focal.txt

@@ -167,7 +167,7 @@ Terminals with graphics protocol support (image.nvim):
     Rio                 kitty           TERM_PROGRAM
     iTerm2              sixel           TERM_PROGRAM
     alacritty           (none)          ALACRITTY_SOCKET / TERM_PROGRAM
-    Konsole             kitty           KONSOLE_VERSION
+    Konsole             sixel           KONSOLE_DBUS_SESSION
     foot                sixel           TERM (prefix match)
     Windows Terminal    sixel           WT_SESSION
     Contour             sixel           TERMINAL_EMULATOR

lua/focal/config.lua

@@ -255,6 +255,21 @@ function M.merge(user_opts)
     if cfg.max_height_percent then
         cfg.max_height_percent = math.max(1, math.min(100, cfg.max_height_percent))
     end
+    if cfg.zindex and cfg.zindex < 1 then
+        warn("[focal] config.zindex must be >= 1, using default")
+        cfg.zindex = M.defaults.zindex
+    end
+    if cfg.debounce_ms and cfg.debounce_ms < 0 then
+        cfg.debounce_ms = 0
+    end
+    if cfg.render_timeout_ms and cfg.render_timeout_ms < 100 then
+        warn("[focal] config.render_timeout_ms must be >= 100, using default")
+        cfg.render_timeout_ms = M.defaults.render_timeout_ms
+    end
+    if cfg.max_file_size_mb and cfg.max_file_size_mb <= 0 then
+        warn("[focal] config.max_file_size_mb must be > 0, using default")
+        cfg.max_file_size_mb = M.defaults.max_file_size_mb
+    end
 
     -- Warn about unknown chafa sub-keys.
     if type(user_opts.chafa) == "table" then
@@ -292,6 +307,14 @@ function M.merge(user_opts)
     if type(cfg.chafa.max_output_bytes) ~= "number" then
         warn("[focal] config.chafa.max_output_bytes must be number, using default")
         cfg.chafa.max_output_bytes = M.defaults.chafa.max_output_bytes
+    elseif
+        cfg.chafa.max_output_bytes ~= cfg.chafa.max_output_bytes
+        or cfg.chafa.max_output_bytes == math.huge
+        or cfg.chafa.max_output_bytes == -math.huge
+        or cfg.chafa.max_output_bytes <= 0
+    then
+        warn("[focal] config.chafa.max_output_bytes is invalid, using default")
+        cfg.chafa.max_output_bytes = M.defaults.chafa.max_output_bytes
     end
     if cfg.chafa.color_space ~= nil and type(cfg.chafa.color_space) ~= "string" then
         warn("[focal] config.chafa.color_space must be string or nil, using default")

lua/focal/preview.lua

@@ -74,7 +74,8 @@ end
 ---Uses vim.fn.screenpos() which works for both splits and floating windows.
 ---@return FocalCursorAnchor
 function PM:_create_anchor()
-    local pos = vim.fn.screenpos(0, vim.fn.line("."), vim.fn.col("."))
+    local cursor = vim.api.nvim_win_get_cursor(0)
+    local pos = vim.fn.screenpos(0, cursor[1], cursor[2] + 1)
     return {
         screen_row = pos.row,
         screen_col = pos.col,

lua/focal/renderer.lua

@@ -30,7 +30,10 @@ local function rebuild_ext_map()
     -- Sort each extension's renderer list by priority descending
     for _, list in pairs(ext_map) do
         table.sort(list, function(a, b)
-            return a.priority > b.priority
+            if a.priority ~= b.priority then
+                return a.priority > b.priority
+            end
+            return a.name < b.name
         end)
     end
 end

lua/focal/renderers/chafa.lua

@@ -110,7 +110,7 @@ function M.render(ctx, done)
                 if line_count <= 2 then
                     -- Strip ANSI escape sequences to get visible character count.
                     -- Each chafa "pixel" is one character wide.
-                    local visible = line:gsub("\27%[[%d;]*m", "")
+                    local visible = line:gsub("\27%[[%d;]*[mB]", "")
                     local w = vim.fn.strdisplaywidth(visible)
                     if w > max_visible_width then
                         max_visible_width = w

lua/focal/terminal.lua

@@ -17,7 +17,7 @@ local terminals = {
     { env_key = "TERM_PROGRAM", value = "iTerm.app", terminal = "iTerm2", protocol = "sixel" },
     { env_key = "ALACRITTY_SOCKET", terminal = "alacritty", protocol = nil },
     { env_key = "TERM_PROGRAM", value = "Alacritty", terminal = "alacritty", protocol = nil },
-    { env_key = "KONSOLE_VERSION", terminal = "Konsole", protocol = "kitty" },
+    { env_key = "KONSOLE_DBUS_SESSION", terminal = "Konsole", protocol = "sixel" },
     { env_key = "TERM", prefix = "foot", terminal = "foot", protocol = "sixel" },
     { env_key = "WT_SESSION", terminal = "Windows Terminal", protocol = "sixel" },
     { env_key = "TERM_PROGRAM", value = "rio", terminal = "Rio", protocol = "kitty" },