chore(refactor): use setup & init pattern for treesitter and log modules

## Details

- Move log runtime behavior into `log` module, store the configuration
  directly rather than using `state`, simplify associated wrapper
- Move user config -> actual config resolution into `init` module and
  pass result to `state`
- Store injections and patterns directly in treesitter module, call
  methods without relying on `state`
- Use an enum for top level presets

Author: MeanderingProgrammer

CHANGELOG.md

@@ -13,6 +13,8 @@
 
 - more robust icon provider resolution [#403](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/403)
   [dfffdd2](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/dfffdd221570d36ac80d1a599643140a319a36de)
+- disable line wrapping in LSP hover docs in some cases [#408](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/408)
+  [080104e](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/080104e4dce26819efb4f4c83d1b7b2d82b96f7c)
 
 ## 8.3.0 (2025-04-15)
 

lua/render-markdown/core/buffer.lua

@@ -34,21 +34,26 @@ function Buffer:is_empty()
     return self.empty
 end
 
+---@param debounce boolean
 ---@param ms integer
 ---@param callback fun()
-function Buffer:debounce(ms, callback)
-    self.timer:start(ms, 0, function()
-        self.running = false
-    end)
-    if not self.running then
-        self.running = true
+function Buffer:run(debounce, ms, callback)
+    if debounce and ms > 0 then
+        self.timer:start(ms, 0, function()
+            self.running = false
+        end)
+        if not self.running then
+            self.running = true
+            vim.schedule(callback)
+        end
+    else
         vim.schedule(callback)
     end
 end
 
 ---@return boolean
-function Buffer:has_marks()
-    return self.marks ~= nil
+function Buffer:initial()
+    return self.marks == nil
 end
 
 ---@return render.md.Extmark[]

lua/render-markdown/core/log.lua

@@ -6,16 +6,29 @@ local Env = require('render-markdown.lib.env')
 ---@field name string
 ---@field message string
 
+---@class render.md.log.Config
+---@field level render.md.log.Level
+---@field runtime boolean
+
+---@alias render.md.log.Level 'off'|'debug'|'info'|'error'
+
 ---@class render.md.Log
 ---@field private file string
----@field private level render.md.config.LogLevel
 ---@field private entries render.md.log.Entry[]
+---@field private config render.md.log.Config
 local M = {}
 
----called from plugin directory
-function M.init()
+---called from state on setup
+---@param config render.md.log.Config
+function M.setup(config)
     -- typically resolves to ~/.local/state/nvim/render-markdown.log
     M.file = vim.fn.stdpath('state') .. '/render-markdown.log'
+    M.entries = {}
+    M.config = config
+end
+
+---called from plugin directory
+function M.init()
     -- clear the file contents if it is too big
     if Env.file_size_mb(M.file) > 5 then
         assert(io.open(M.file, 'w')):close()
@@ -27,11 +40,23 @@ function M.init()
     })
 end
 
----called from state on setup
----@param level render.md.config.LogLevel
-function M.setup(level)
-    M.level = level
-    M.entries = {}
+---@param name string
+---@param callback fun()
+---@return fun()
+function M.runtime(name, callback)
+    if M.config.runtime then
+        return function()
+            local Compat = require('render-markdown.lib.compat')
+            local start_time = Compat.uv.hrtime()
+            callback()
+            local end_time = Compat.uv.hrtime()
+            local elapsed = (end_time - start_time) / 1e+6
+            assert(elapsed < 1000)
+            vim.print(string.format('%8s : %5.1f ms', name:upper(), elapsed))
+        end
+    else
+        return callback
+    end
 end
 
 function M.open()
@@ -59,7 +84,7 @@ function M.unhandled_type(language, group, value)
     M.add('error', 'unhandled type', message)
 end
 
----@param level render.md.config.LogLevel
+---@param level render.md.log.Level
 ---@param name string
 ---@param buf integer
 ---@param ... any
@@ -79,11 +104,11 @@ function M.file_name(buf)
     return #name == 0 and 'EMPTY' or name
 end
 
----@param level render.md.config.LogLevel
+---@param level render.md.log.Level
 ---@param name string
 ---@param ... any
 function M.add(level, name, ...)
-    if M.level_value(level) < M.level_value(M.level) then
+    if M.level_value(level) < M.level_value(M.config.level) then
         return
     end
     local messages = {}
@@ -107,7 +132,7 @@ function M.add(level, name, ...)
 end
 
 ---@private
----@param level render.md.config.LogLevel
+---@param level render.md.log.Level
 ---@return integer
 function M.level_value(level)
     if level == 'debug' then

lua/render-markdown/core/ui.lua

@@ -97,28 +97,10 @@ function M.update(buf, win, event, change)
         return
     end
 
-    local update = function()
+    local update = log.runtime('update', function()
         M.run_update(buf, win, change)
-    end
-    if parse and state.log_runtime then
-        update = Env.runtime('update', update)
-    end
-
-    if parse and config.debounce > 0 then
-        buffer:debounce(config.debounce, update)
-    else
-        vim.schedule(update)
-    end
-end
-
----@private
----@param buf integer
----@param win integer
----@param change boolean
----@return boolean
-function M.parse(buf, win, change)
-    -- Need to parse when things change or we have not parsed the visible range yet
-    return change or not Context.contains(buf, win)
+    end)
+    buffer:run(parse, config.debounce, update)
 end
 
 ---@private
@@ -145,7 +127,7 @@ function M.run_update(buf, win, change)
     end
 
     if next_state == 'rendered' then
-        local initial = not buffer:has_marks()
+        local initial = buffer:initial()
         if initial or parse then
             M.clear(buf, buffer)
             buffer:set_marks(M.parse_buffer({
@@ -175,6 +157,16 @@ function M.run_update(buf, win, change)
     end
 end
 
+---@private
+---@param buf integer
+---@param win integer
+---@param change boolean
+---@return boolean
+function M.parse(buf, win, change)
+    -- need to parse when things change or we have not parsed the visible range yet
+    return change or not Context.contains(buf, win)
+end
+
 ---@private
 ---@param config render.md.main.Config
 ---@param win integer

lua/render-markdown/health.lua

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

lua/render-markdown/init.lua

@@ -3,7 +3,7 @@ local M = {}
 
 ---@class (exact) render.md.Config: render.md.buffer.Config
 ---@field preset render.md.config.Preset
----@field log_level render.md.config.LogLevel
+---@field log_level render.md.log.Level
 ---@field log_runtime boolean
 ---@field file_types string[]
 ---@field ignore fun(buf: integer): boolean
@@ -15,10 +15,6 @@ local M = {}
 ---@field overrides render.md.overrides.Config
 ---@field custom_handlers table<string, render.md.Handler>
 
----@alias render.md.config.Preset 'none'|'lazy'|'obsidian'
-
----@alias render.md.config.LogLevel 'off'|'debug'|'info'|'error'
-
 ---@class (exact) render.md.buffer.Config: render.md.base.Config
 ---@field max_file_size number
 ---@field debounce integer
@@ -714,7 +710,29 @@ function M.setup(opts)
         return
     end
     M.initialized = true
-    require('render-markdown.state').setup(opts or {})
+    local config = M.resolve_config(opts or {})
+    require('render-markdown.state').setup(config)
+end
+
+---@private
+---@param user render.md.UserConfig
+---@return render.md.Config
+function M.resolve_config(user)
+    local preset = require('render-markdown.presets').get(user)
+    local config = vim.tbl_deep_extend('force', M.default, preset, user)
+    -- override settings that require neovim >= 0.10.0 and have compatible alternatives
+    local has_10 = require('render-markdown.lib.compat').has_10
+    if not has_10 then
+        config.code.position = 'right'
+    end
+    -- use lazy.nvim file type configuration if available and no user value is specified
+    if user.file_types == nil then
+        local lazy_file_types = require('render-markdown.lib.env').lazy('ft')
+        if #lazy_file_types > 0 then
+            config.file_types = lazy_file_types
+        end
+    end
+    return config
 end
 
 return setmetatable(M, {

lua/render-markdown/integ/ts.lua

@@ -1,6 +1,12 @@
 local Compat = require('render-markdown.lib.compat')
 
----@class render.md.integ.TreeSitter
+---@class render.md.integ.ts.Config
+---@field file_types string[]
+---@field injections table<string, render.md.injection.Config>
+---@field patterns table<string, render.md.pattern.Config>
+
+---@class render.md.integ.TS
+---@field private config render.md.integ.ts.Config
 local M = {}
 
 ---@private
@@ -11,15 +17,23 @@ M.initialized = false
 ---@type table<string, vim.treesitter.Query>
 M.queries = {}
 
+---called from state on setup
+---@param config render.md.integ.ts.Config
+function M.setup(config)
+    M.config = config
+    for _, language in ipairs(M.config.file_types) do
+        M.inject(language)
+    end
+end
+
 ---called from manager on buffer attach
-function M.setup()
+function M.init()
     if M.initialized then
         return
     end
     M.initialized = true
-    local state = require('render-markdown.state')
-    for _, language in ipairs(state.file_types) do
-        M.disable(language, state.patterns[language])
+    for _, language in ipairs(M.config.file_types) do
+        M.disable(language)
     end
 end
 
@@ -35,9 +49,10 @@ function M.parse(language, query)
     return result
 end
 
+---@private
 ---@param language string
----@param injection? render.md.injection.Config
-function M.inject(language, injection)
+function M.inject(language)
+    local injection = M.config.injections[language]
     if injection == nil or not injection.enabled then
         return
     end
@@ -60,8 +75,8 @@ end
 
 ---@private
 ---@param language string
----@param pattern? render.md.pattern.Config
-function M.disable(language, pattern)
+function M.disable(language)
+    local pattern = M.config.patterns[language]
     if pattern == nil or not pattern.disable then
         return
     end

lua/render-markdown/lib/env.lua

@@ -44,20 +44,6 @@ function M.file_size_mb(file)
     return stats.size / (1024 * 1024)
 end
 
----@param name string
----@param callback fun()
----@return fun()
-function M.runtime(name, callback)
-    return function()
-        local start_time = Compat.uv.hrtime()
-        callback()
-        local end_time = Compat.uv.hrtime()
-        local elapsed = (end_time - start_time) / 1e+6
-        assert(elapsed < 1000)
-        vim.print(string.format('%8s : %5.1f ms', name:upper(), elapsed))
-    end
-end
-
 ---@param buf integer
 ---@param win integer
 ---@return boolean

lua/render-markdown/manager.lua

@@ -87,7 +87,7 @@ function M.attach(buf)
 
     local config = state.get(buf)
     state.on.attach({ buf = buf })
-    require('render-markdown.integ.ts').setup()
+    require('render-markdown.integ.ts').init()
     if state.completions.lsp.enabled then
         require('render-markdown.integ.lsp').setup()
     elseif state.completions.blink.enabled then