chore(refactor): move renders to sub directory based on language

## Details

Rather than storing all the render classes in the render folder directly
move each one to a sub folder based on the language it is rendering for.

- html
  - html_comment -> comment
  - html_tag -> tag
- markdown
  - checkbox
  - code
  - dash
  - document
  - heading
  - bullet
  - paragraph
  - quote
  - section
  - table
- markdown_inline (uses folder name inline instead of markdown_inline)
  - code_inline -> code
  - inline_highlight -> highlight
  - link
  - shortcut

Other changes:

- instead of exposing any fields from `Base` render module, replace the
  `new` method with `execute` which in addition to calling `setup` also
  calls `run` if setup returns `true`, return whether `run` was executed
  as a boolean, for future use
- make `run` method `protected` in all render implementations, since
  it's not only used within `Base:execute`

Author: MeanderingProgrammer

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*         For NVIM v0.11.1        Last change: 2025 May 04
+*render-markdown.txt*         For NVIM v0.11.1        Last change: 2025 May 05
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*

lua/render-markdown/handler/html.lua

@@ -4,7 +4,7 @@ local ts = require('render-markdown.core.ts')
 
 ---@class render.md.handler.buf.Html
 ---@field private query vim.treesitter.Query
----@field private modules table<string, render.md.Render>
+---@field private renders table<string, render.md.Render>
 ---@field private context render.md.request.Context
 local Handler = {}
 Handler.__index = Handler
@@ -20,9 +20,9 @@ function Handler.new(buf)
             (element) @tag
         ]]
     )
-    self.modules = {
-        comment = require('render-markdown.render.html_comment'),
-        tag = require('render-markdown.render.html_tag'),
+    self.renders = {
+        comment = require('render-markdown.render.html.comment'),
+        tag = require('render-markdown.render.html.tag'),
     }
     self.context = Context.get(buf)
     return self
@@ -36,12 +36,9 @@ function Handler:parse(root)
     end
     local marks = Marks.new(self.context, true)
     self.context.view:nodes(root, self.query, function(capture, node)
-        local module = self.modules[capture]
-        assert(module ~= nil, 'unhandled html capture: ' .. capture)
-        local render = module:new(self.context, marks, node)
-        if render then
-            render:run()
-        end
+        local render = self.renders[capture]
+        assert(render ~= nil, 'unhandled html capture: ' .. capture)
+        render:execute(self.context, marks, node)
     end)
     return marks:get()
 end

lua/render-markdown/handler/markdown.lua

@@ -4,7 +4,7 @@ local ts = require('render-markdown.core.ts')
 
 ---@class render.md.handler.buf.Markdown
 ---@field private query vim.treesitter.Query
----@field private modules table<string, render.md.Render>
+---@field private renders table<string, render.md.Render>
 ---@field private context render.md.request.Context
 local Handler = {}
 Handler.__index = Handler
@@ -16,16 +16,10 @@ function Handler.new(buf)
     self.query = ts.parse(
         'markdown',
         [[
-            (document) @document
-
-            (section) @section
-
             [
-                (atx_heading)
-                (setext_heading)
-            ] @heading
-
-            (section (paragraph) @paragraph)
+                (task_list_marker_unchecked)
+                (task_list_marker_checked)
+            ] @checkbox
 
             (fenced_code_block) @code
 
@@ -35,29 +29,35 @@ function Handler.new(buf)
                 (plus_metadata)
             ] @dash
 
-            (list_item) @list
+            (document) @document
 
             [
-                (task_list_marker_unchecked)
-                (task_list_marker_checked)
-            ] @checkbox
+                (atx_heading)
+                (setext_heading)
+            ] @heading
+
+            (list_item) @list
+
+            (section (paragraph) @paragraph)
 
             (block_quote) @quote
 
+            (section) @section
+
             (pipe_table) @table
         ]]
     )
-    self.modules = {
-        checkbox = require('render-markdown.render.checkbox'),
-        code = require('render-markdown.render.code'),
-        dash = require('render-markdown.render.dash'),
-        document = require('render-markdown.render.document'),
-        heading = require('render-markdown.render.heading'),
-        list = require('render-markdown.render.bullet'),
-        paragraph = require('render-markdown.render.paragraph'),
-        quote = require('render-markdown.render.quote'),
-        section = require('render-markdown.render.section'),
-        table = require('render-markdown.render.table'),
+    self.renders = {
+        checkbox = require('render-markdown.render.markdown.checkbox'),
+        code = require('render-markdown.render.markdown.code'),
+        dash = require('render-markdown.render.markdown.dash'),
+        document = require('render-markdown.render.markdown.document'),
+        heading = require('render-markdown.render.markdown.heading'),
+        list = require('render-markdown.render.markdown.bullet'),
+        paragraph = require('render-markdown.render.markdown.paragraph'),
+        quote = require('render-markdown.render.markdown.quote'),
+        section = require('render-markdown.render.markdown.section'),
+        table = require('render-markdown.render.markdown.table'),
     }
     self.context = Context.get(buf)
     return self
@@ -68,12 +68,9 @@ end
 function Handler:parse(root)
     local marks = Marks.new(self.context, false)
     self.context.view:nodes(root, self.query, function(capture, node)
-        local module = self.modules[capture]
-        assert(module ~= nil, 'unhandled markdown capture: ' .. capture)
-        local render = module:new(self.context, marks, node)
-        if render then
-            render:run()
-        end
+        local render = self.renders[capture]
+        assert(render ~= nil, 'unhandled markdown capture: ' .. capture)
+        render:execute(self.context, marks, node)
     end)
     return marks:get()
 end

lua/render-markdown/handler/markdown_inline.lua

@@ -4,7 +4,7 @@ local ts = require('render-markdown.core.ts')
 
 ---@class render.md.handler.buf.MarkdownInline
 ---@field private query vim.treesitter.Query
----@field private modules table<string, render.md.Render>
+---@field private renders table<string, render.md.Render>
 ---@field private context render.md.request.Context
 local Handler = {}
 Handler.__index = Handler
@@ -16,9 +16,10 @@ function Handler.new(buf)
     self.query = ts.parse(
         'markdown_inline',
         [[
-            (code_span) @code_inline
+            (code_span) @code
 
-            (shortcut_link) @shortcut
+            ((inline) @highlight
+                (#lua-match? @highlight "==[^=]+=="))
 
             [
                 (email_autolink)
@@ -28,15 +29,14 @@ function Handler.new(buf)
                 (uri_autolink)
             ] @link
 
-            ((inline) @inline_highlight
-                (#lua-match? @inline_highlight "==[^=]+=="))
+            (shortcut_link) @shortcut
         ]]
     )
-    self.modules = {
-        code_inline = require('render-markdown.render.code_inline'),
-        inline_highlight = require('render-markdown.render.inline_highlight'),
-        link = require('render-markdown.render.link'),
-        shortcut = require('render-markdown.render.shortcut'),
+    self.renders = {
+        code = require('render-markdown.render.inline.code'),
+        highlight = require('render-markdown.render.inline.highlight'),
+        link = require('render-markdown.render.inline.link'),
+        shortcut = require('render-markdown.render.inline.shortcut'),
     }
     self.context = Context.get(buf)
     return self
@@ -47,12 +47,9 @@ end
 function Handler:parse(root)
     local marks = Marks.new(self.context, true)
     self.context.view:nodes(root, self.query, function(capture, node)
-        local module = self.modules[capture]
-        assert(module ~= nil, 'unhandled inline capture: ' .. capture)
-        local render = module:new(self.context, marks, node)
-        if render then
-            render:run()
-        end
+        local render = self.renders[capture]
+        assert(render ~= nil, 'unhandled inline capture: ' .. capture)
+        render:execute(self.context, marks, node)
     end)
     return marks:get()
 end

lua/render-markdown/health.lua

@@ -5,7 +5,7 @@ local state = require('render-markdown.state')
 local M = {}
 
 ---@private
-M.version = '8.3.26'
+M.version = '8.3.27'
 
 function M.check()
     M.start('version')

lua/render-markdown/render/base.lua

@@ -8,21 +8,26 @@ local colors = require('render-markdown.core.colors')
 ---@field protected marks render.md.Marks
 ---@field protected node render.md.Node
 ---@field protected setup fun(self: render.md.Render): boolean
----@field run fun(self: render.md.Render)
+---@field protected run fun(self: render.md.Render)
 local Base = {}
 Base.__index = Base
 
 ---@param context render.md.request.Context
 ---@param marks render.md.Marks
 ---@param node render.md.Node
----@return render.md.Render?
-function Base:new(context, marks, node)
+---@return boolean
+function Base:execute(context, marks, node)
     local instance = setmetatable({}, self)
     instance.context = context
     instance.config = context.config
     instance.marks = marks
     instance.node = node
-    return instance:setup() and instance or nil
+    if instance:setup() then
+        instance:run()
+        return true
+    else
+        return false
+    end
 end
 
 ---@protected

lua/render-markdown/render/html_comment.lua renamed to lua/render-markdown/render/html/comment.lua

@@ -15,6 +15,7 @@ function Render:setup()
     return true
 end
 
+---@protected
 function Render:run()
     self.marks:over(true, self.node, { conceal = '' })
     if self.info.text then

lua/render-markdown/render/html_tag.lua renamed to lua/render-markdown/render/html/tag.lua

@@ -20,6 +20,7 @@ function Render:setup()
     return self.info ~= nil
 end
 
+---@protected
 function Render:run()
     self.marks:over(true, self.node:child('start_tag'), { conceal = '' })
     self.marks:over(true, self.node:child('end_tag'), { conceal = '' })

lua/render-markdown/render/code_inline.lua renamed to lua/render-markdown/render/inline/code.lua

@@ -1,7 +1,7 @@
 local Base = require('render-markdown.render.base')
 local colors = require('render-markdown.core.colors')
 
----@class render.md.render.CodeInline: render.md.Render
+---@class render.md.render.inline.Code: render.md.Render
 ---@field private info render.md.code.Config
 local Render = setmetatable({}, Base)
 Render.__index = Render
@@ -19,6 +19,7 @@ function Render:setup()
     return true
 end
 
+---@protected
 function Render:run()
     local highlight = self.info.highlight_inline
     self.marks:over('code_background', self.node, { hl_group = highlight })

lua/render-markdown/render/inline_highlight.lua renamed to lua/render-markdown/render/inline/highlight.lua

@@ -1,6 +1,6 @@
 local Base = require('render-markdown.render.base')
 
----@class render.md.render.InlineHighlight: render.md.Render
+---@class render.md.render.inline.Highlight: render.md.Render
 ---@field private info render.md.inline.highlight.Config
 local Render = setmetatable({}, Base)
 Render.__index = Render
@@ -15,6 +15,7 @@ function Render:setup()
     return true
 end
 
+---@protected
 function Render:run()
     for _, range in ipairs(self.node:find('==[^=]+==')) do
         -- Hide first 2 equal signs