feat: user configurable anti conceal per component

## Details

Request: #204

Previously the decoration elements that are hidden on the cursor line
was not something the user had direct control over.

The default behavior was to never hide virtual lines, spacing, signs or
code backgrounds. All other decorations on the line would always be
hidden if the user kept anti conceal enabled.

For the time being virtual lines and spacing remain permanently enabled.

However signs, code backgrounds and most other elements that by default
would be hidden are entirely within the users control.

This is all managed through the new `anti_conceal.ignore` property. This
table is a mapping from element name to a boolean. A value of `true` for
an element means it will not be concealed when the cursor enters the
line. A value of `false` behaves the same as no value being set and will
be hidden. A table is used rather than a list so that when users modify
values the defaults remain the same as they were unless explicitely changed.

Signs and code backgrounds set their values to `true` to remain ignored by
default as before, however now users have the ability to change this
behavior if they would like to hide signs and backgrounds.

Additionally most other decorations that remain concealable by default
like before can now be ignored if the user sets their value to true. A
complete list of possible values is provided in the default configuration
in the README.

Author: MeanderingProgrammer

CHANGELOG.md

@@ -10,6 +10,8 @@
 - allow empty lists for all heading properties [0c6de74](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/0c6de743a8d3c61b87bc7db9ab97dcda12ca6818)
 - wiki link config & language highlight [#205](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/205)
   [965c222](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/965c222076b2d289ed498730845d533780f3c7c7)
+- code language name [#205](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/205)
+  [18c7ef7](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/18c7ef71fb4b8d83cb0160adc9127fc4d65ca42e)
 
 ### Bug Fixes
 

README.md

@@ -169,6 +169,13 @@ require('render-markdown').setup({
     anti_conceal = {
         -- This enables hiding any added text on the line the cursor is on
         enabled = true,
+        -- Which elements to always show, ignoring anti conceal behavior. Possible values are:
+        --  head_icon, head_background, head_border, code_language, code_background, code_border
+        --  dash, bullet, check_icon, check_scope, quote, table_border, callout, link, sign
+        ignore = {
+            code_background = true,
+            sign = true,
+        },
         -- Number of lines above cursor to show
         above = 0,
         -- Number of lines below cursor to show

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*          For 0.10.0         Last change: 2024 October 12
+*render-markdown.txt*          For 0.10.0         Last change: 2024 October 13
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -218,6 +218,13 @@ Default Configuration ~
         anti_conceal = {
             -- This enables hiding any added text on the line the cursor is on
             enabled = true,
+            -- Which elements to always show, ignoring anti conceal behavior. Possible values are:
+            --  head_icon, head_background, head_border, code_language, code_background, code_border
+            --  dash, bullet, check_icon, check_scope, quote, table_border, callout, link, sign
+            ignore = {
+                code_background = true,
+                sign = true,
+            },
             -- Number of lines above cursor to show
             above = 0,
             -- Number of lines below cursor to show

lua/render-markdown/core/list.lua

@@ -2,13 +2,16 @@ local log = require('render-markdown.core.log')
 local util = require('render-markdown.core.util')
 
 ---@class render.md.Marks
+---@field private ignore table<render.md.Element, boolean>
 ---@field private marks render.md.Mark[]
 local Marks = {}
 Marks.__index = Marks
 
+---@param ignore table<render.md.Element, boolean>
 ---@return render.md.Marks
-function Marks.new()
+function Marks.new(ignore)
     local self = setmetatable({}, Marks)
+    self.ignore = ignore
     self.marks = {}
     return self
 end
@@ -18,15 +21,15 @@ function Marks:get()
     return self.marks
 end
 
----@param conceal boolean
+---@param element boolean|render.md.Element
 ---@param start_row integer
 ---@param start_col integer
 ---@param opts vim.api.keyset.set_extmark
 ---@return boolean
-function Marks:add(conceal, start_row, start_col, opts)
+function Marks:add(element, start_row, start_col, opts)
     ---@type render.md.Mark
     local mark = {
-        conceal = conceal,
+        conceal = self:conceal(element),
         start_row = start_row,
         start_col = start_col,
         opts = opts,
@@ -44,12 +47,24 @@ function Marks:add(conceal, start_row, start_col, opts)
     return true
 end
 
+---@private
+---@param element boolean|render.md.Element
+---@return boolean
+function Marks:conceal(element)
+    if type(element) == 'boolean' then
+        return element
+    else
+        return self.ignore[element] ~= true
+    end
+end
+
 ---@class render.md.ListHelper
 local M = {}
 
+---@param ignore? table<render.md.Element, boolean>
 ---@return render.md.Marks
-function M.new_marks()
-    return Marks.new()
+function M.new_marks(ignore)
+    return Marks.new(ignore or {})
 end
 
 ---@generic T

lua/render-markdown/handler/markdown.lua

@@ -4,9 +4,9 @@ local state = require('render-markdown.state')
 local treesitter = require('render-markdown.core.treesitter')
 
 ---@class render.md.handler.buf.Markdown
----@field private marks render.md.Marks
 ---@field private config render.md.buffer.Config
 ---@field private context render.md.Context
+---@field private marks render.md.Marks
 ---@field private query vim.treesitter.Query
 ---@field private renderers table<string, render.md.Renderer>
 local Handler = {}
@@ -16,9 +16,9 @@ Handler.__index = Handler
 ---@return render.md.handler.buf.Markdown
 function Handler.new(buf)
     local self = setmetatable({}, Handler)
-    self.marks = list.new_marks()
     self.config = state.get(buf)
     self.context = Context.get(buf)
+    self.marks = list.new_marks(self.config.anti_conceal.ignore)
     self.query = treesitter.parse(
         'markdown',
         [[

lua/render-markdown/handler/markdown_inline.lua

@@ -4,9 +4,9 @@ local state = require('render-markdown.state')
 local treesitter = require('render-markdown.core.treesitter')
 
 ---@class render.md.handler.buf.MarkdownInline
----@field private marks render.md.Marks
 ---@field private config render.md.buffer.Config
 ---@field private context render.md.Context
+---@field private marks render.md.Marks
 ---@field private query vim.treesitter.Query
 ---@field private renderers table<string, render.md.Renderer>
 local Handler = {}
@@ -16,9 +16,9 @@ Handler.__index = Handler
 ---@return render.md.handler.buf.MarkdownInline
 function Handler.new(buf)
     local self = setmetatable({}, Handler)
-    self.marks = list.new_marks()
     self.config = state.get(buf)
     self.context = Context.get(buf)
+    self.marks = list.new_marks(self.config.anti_conceal.ignore)
     self.query = treesitter.parse(
         'markdown_inline',
         [[

lua/render-markdown/health.lua

@@ -4,7 +4,7 @@ local state = require('render-markdown.state')
 local M = {}
 
 ---@private
-M.version = '7.3.6'
+M.version = '7.3.7'
 
 function M.check()
     M.start('version')

lua/render-markdown/init.lua

@@ -174,8 +174,26 @@ local M = {}
 ---@class (exact) render.md.UserPadding
 ---@field public highlight? string
 
+---@alias render.md.Element
+---| 'head_icon'
+---| 'head_background'
+---| 'head_border'
+---| 'code_language'
+---| 'code_background'
+---| 'code_border'
+---| 'dash'
+---| 'bullet'
+---| 'check_icon'
+---| 'check_scope'
+---| 'quote'
+---| 'table_border'
+---| 'callout'
+---| 'link'
+---| 'sign'
+
 ---@class (exact) render.md.UserAntiConceal
 ---@field public enabled? boolean
+---@field public ignore? table<render.md.Element, boolean>
 ---@field public above? integer
 ---@field public below? integer
 
@@ -262,6 +280,13 @@ M.default_config = {
     anti_conceal = {
         -- This enables hiding any added text on the line the cursor is on
         enabled = true,
+        -- Which elements to always show, ignoring anti conceal behavior. Possible values are:
+        --  head_icon, head_background, head_border, code_language, code_background, code_border
+        --  dash, bullet, check_icon, check_scope, quote, table_border, callout, link, sign
+        ignore = {
+            code_background = true,
+            sign = true,
+        },
         -- Number of lines above cursor to show
         above = 0,
         -- Number of lines below cursor to show

lua/render-markdown/render/base.lua

@@ -38,7 +38,7 @@ function Base:sign(text, highlight)
     if highlight ~= nil then
         sign_highlight = colors.combine(highlight, sign_highlight)
     end
-    self.marks:add(false, self.info.start_row, self.info.start_col, {
+    self.marks:add('sign', self.info.start_row, self.info.start_col, {
         sign_text = text,
         sign_hl_group = sign_highlight,
     })

lua/render-markdown/render/checkbox.lua

@@ -46,7 +46,7 @@ end
 function Render:icon()
     local icon = self.checkbox.icon
     local text = self.inline and icon or str.pad_to(self.info.text, icon) .. icon
-    self.marks:add(true, self.info.start_row, self.info.start_col, {
+    self.marks:add('check_icon', self.info.start_row, self.info.start_col, {
         end_row = self.info.end_row,
         end_col = self.info.end_col,
         virt_text = { { text, self.checkbox.highlight } },
@@ -65,7 +65,7 @@ function Render:highlight_scope()
     if paragraph == nil then
         return
     end
-    self.marks:add(true, paragraph.start_row, paragraph.start_col, {
+    self.marks:add('check_scope', paragraph.start_row, paragraph.start_col, {
         end_row = paragraph.end_row,
         end_col = paragraph.end_col,
         hl_group = highlight,