chore(refactor): move creating marks to handlers module

## Details

Makes the eventual move to async parsing a little easier if all the
logic to generate marks is wrapped up in its own module outside the rest
of the UI logic. All that's needed is a `context` and the `parser`.

Author: MeanderingProgrammer

doc/render-markdown.txt

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

lua/render-markdown/core/handlers.lua

@@ -0,0 +1,77 @@
+local log = require('render-markdown.core.log')
+
+---@class render.md.handlers.Config
+---@field custom table<string, render.md.Handler>
+
+---@class render.md.Handlers
+---@field private config render.md.handlers.Config
+local M = {}
+
+---@private
+---@type table<string, render.md.Handler>
+M.builtin = {
+    html = require('render-markdown.handler.html'),
+    latex = require('render-markdown.handler.latex'),
+    markdown = require('render-markdown.handler.markdown'),
+    markdown_inline = require('render-markdown.handler.markdown_inline'),
+}
+
+---called from state on setup
+---@param config render.md.handlers.Config
+function M.setup(config)
+    M.config = config
+end
+
+---@param context render.md.request.Context
+---@param parser vim.treesitter.LanguageTree
+---@return render.md.Mark[]
+function M.run(context, parser)
+    local marks = {} ---@type render.md.Mark[]
+    -- parse markdown after other nodes to get accurate state
+    local markdown = {} ---@type render.md.handler.Context[]
+    parser:for_each_tree(function(tree, language_tree)
+        ---@type render.md.handler.Context
+        local ctx = { buf = context.buf, root = tree:root() }
+        local language = language_tree:lang()
+        if language == 'markdown' then
+            markdown[#markdown + 1] = ctx
+        else
+            vim.list_extend(marks, M.tree(context, ctx, language))
+        end
+    end)
+    for _, ctx in ipairs(markdown) do
+        vim.list_extend(marks, M.tree(context, ctx, 'markdown'))
+    end
+    return marks
+end
+
+---Run custom & builtin handlers when available. Custom handler is always
+---executed, builtin handler is skipped if custom does not specify extends.
+---@private
+---@param context render.md.request.Context
+---@param ctx render.md.handler.Context
+---@param language string
+---@return render.md.Mark[]
+function M.tree(context, ctx, language)
+    log.buf('debug', 'language', ctx.buf, language)
+    if not context.view:overlaps(ctx.root) then
+        return {}
+    end
+    local marks = {} ---@type render.md.Mark[]
+    local custom = M.config.custom[language]
+    if custom then
+        log.buf('debug', 'handler', ctx.buf, 'custom')
+        vim.list_extend(marks, custom.parse(ctx))
+        if not custom.extends then
+            return marks
+        end
+    end
+    local builtin = M.builtin[language]
+    if builtin then
+        log.buf('debug', 'handler', ctx.buf, 'builtin')
+        vim.list_extend(marks, builtin.parse(ctx))
+    end
+    return marks
+end
+
+return M

lua/render-markdown/core/ui.lua

@@ -4,20 +4,12 @@ local Context = require('render-markdown.request.context')
 local Env = require('render-markdown.lib.env')
 local Extmark = require('render-markdown.lib.extmark')
 local Iter = require('render-markdown.lib.iter')
+local handlers = require('render-markdown.core.handlers')
 local log = require('render-markdown.core.log')
 local state = require('render-markdown.state')
 
----@type table<string, render.md.Handler>
-local builtin_handlers = {
-    html = require('render-markdown.handler.html'),
-    latex = require('render-markdown.handler.latex'),
-    markdown = require('render-markdown.handler.markdown'),
-    markdown_inline = require('render-markdown.handler.markdown_inline'),
-}
-
 ---@class render.md.ui.Config
 ---@field on render.md.on.Config
----@field custom_handlers table<string, render.md.Handler>
 
 ---@class render.md.Ui
 ---@field private config render.md.ui.Config
@@ -165,53 +157,8 @@ function M.parse_buffer(buf, win, config, mode)
     local context = Context.start(buf, win, config, mode)
     -- make sure injections are processed
     context.view:parse(parser)
-    -- parse markdown after other nodes to get accurate state
-    local marks = {} ---@type render.md.Mark[]
-    local markdown = {} ---@type render.md.handler.Context[]
-    parser:for_each_tree(function(tree, language_tree)
-        local language = language_tree:lang()
-        ---@type render.md.handler.Context
-        local ctx = { buf = buf, root = tree:root() }
-        if language == 'markdown' then
-            markdown[#markdown + 1] = ctx
-        else
-            vim.list_extend(marks, M.parse_tree(context, ctx, language))
-        end
-    end)
-    for _, ctx in ipairs(markdown) do
-        vim.list_extend(marks, M.parse_tree(context, ctx, 'markdown'))
-    end
+    local marks = handlers.run(context, parser)
     return Iter.list.map(marks, Extmark.new)
 end
 
----Run user & builtin handlers when available. User handler is always executed,
----builtin handler is skipped if user handler does not specify extends.
----@private
----@param context render.md.request.Context
----@param ctx render.md.handler.Context
----@param language string
----@return render.md.Mark[]
-function M.parse_tree(context, ctx, language)
-    log.buf('debug', 'language', ctx.buf, language)
-    if not context.view:overlaps(ctx.root) then
-        return {}
-    end
-
-    local marks = {}
-    local user = M.config.custom_handlers[language]
-    if user then
-        log.buf('debug', 'handler', ctx.buf, 'user')
-        vim.list_extend(marks, user.parse(ctx))
-        if not user.extends then
-            return marks
-        end
-    end
-    local builtin = builtin_handlers[language]
-    if builtin then
-        log.buf('debug', 'handler', ctx.buf, 'builtin')
-        vim.list_extend(marks, builtin.parse(ctx))
-    end
-    return marks
-end
-
 return M

lua/render-markdown/health.lua

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

lua/render-markdown/request/context.lua

@@ -135,7 +135,7 @@ function Context:percent(value, used)
     end
 end
 
----@class render.md.context.Manager
+---@class render.md.request.context.Manager
 local M = {}
 
 ---@private

lua/render-markdown/state.lua

@@ -17,6 +17,9 @@ function M.setup(config)
     M.config = config
     M.enabled = config.enabled
     M.file_types = config.file_types
+    require('render-markdown.core.handlers').setup({
+        custom = config.custom_handlers,
+    })
     require('render-markdown.core.log').setup({
         level = config.log_level,
         runtime = config.log_runtime,
@@ -34,7 +37,6 @@ function M.setup(config)
     })
     require('render-markdown.core.ui').setup({
         on = config.on,
-        custom_handlers = config.custom_handlers,
     })
     require('render-markdown.integ.source').setup({
         completions = config.completions,