feat: rely on buffer enabled value rather than state enabled

## Details

Previously we used the global `state.enabled` value for the following:

- preventing autocommands callbacks from running
- enabling / disabling all attached buffers
- setting render state to default

These responsibilities have all been moved to the individual buffer
state. So autocommands are gated by that enabled value, same with
toggling buffers.

The main change in behavior is that disabled buffers now are attached to
since we need to attach to the buffer to listen for potential changes to
its state and trigger rendering.

This allows users to disable the plugin globally with the top level
`enabled` value, then render only the specific current buffer using the
`buf_toggle` API. Previously this would still not render buffers as the
global state remained disabled.

We still keep the `state.enabled` to determine what happens when the
`toggle` API is called since that modifies all attached buffers. The
behavior of this is not to toggle each buffer based on its state,
instead all buffers will end up being enabled or disabled, ignoring
individual changes using buffer level APIs.

Author: MeanderingProgrammer

doc/render-markdown.txt

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

lua/render-markdown/api.lua

@@ -6,23 +6,23 @@ function M.enable()
 end
 
 function M.buf_enable()
-    require('render-markdown.core.manager').set_current(true)
+    require('render-markdown.core.manager').set_buf(nil, true)
 end
 
 function M.disable()
     require('render-markdown.core.manager').set_all(false)
 end
 
 function M.buf_disable()
-    require('render-markdown.core.manager').set_current(false)
+    require('render-markdown.core.manager').set_buf(nil, false)
 end
 
 function M.toggle()
-    require('render-markdown.core.manager').set_all()
+    require('render-markdown.core.manager').set_all(nil)
 end
 
 function M.buf_toggle()
-    require('render-markdown.core.manager').set_current()
+    require('render-markdown.core.manager').set_buf(nil, nil)
 end
 
 function M.log()

lua/render-markdown/core/manager.lua

@@ -43,13 +43,12 @@ function M.init()
     vim.api.nvim_create_autocmd('WinResized', {
         group = M.group,
         callback = function(args)
-            if not state.enabled then
-                return
-            end
             for _, win in ipairs(vim.v.event.windows) do
                 local buf = Env.win.buf(win)
                 if M.attached(buf) then
-                    ui.update(buf, win, args.event, true)
+                    if state.get(buf).enabled then
+                        ui.update(buf, win, args.event, true)
+                    end
                 end
             end
         end,
@@ -74,13 +73,14 @@ function M.set_all(enabled)
         state.enabled = not state.enabled
     end
     for _, buf in ipairs(M.buffers) do
-        M.update(buf, 'UserCommand')
+        M.set_buf(buf, state.enabled)
     end
 end
 
+---@param buf? integer
 ---@param enabled? boolean
-function M.set_current(enabled)
-    local buf = Env.buf.current()
+function M.set_buf(buf, enabled)
+    buf = buf or Env.buf.current()
     if M.attached(buf) then
         local config = state.get(buf)
         if enabled ~= nil then
@@ -130,7 +130,7 @@ function M.attach(buf)
         group = M.group,
         buffer = buf,
         callback = function(args)
-            if not state.enabled then
+            if not state.get(buf).enabled then
                 return
             end
             local win, windows = Env.win.current(), Env.buf.windows(buf)
@@ -143,7 +143,9 @@ function M.attach(buf)
         end,
     })
 
-    M.update(buf, 'Initial')
+    if config.enabled then
+        M.update(buf, 'Initial')
+    end
 end
 
 ---@private
@@ -177,11 +179,6 @@ function M.should_attach(buf)
     end
 
     local config = state.get(buf)
-    if not config.enabled then
-        log.buf('info', 'attach', buf, 'skip', 'state disabled')
-        return false
-    end
-
     local file_size, max_file_size = Env.file_size_mb(buf), config.max_file_size
     if file_size > max_file_size then
         local reason = ('%f > %f'):format(file_size, max_file_size)

lua/render-markdown/core/ui.lua

@@ -82,8 +82,7 @@ function M.run_update(buf, win, change)
     local mode = Env.mode.get()
     local row = Env.row.get(buf, win)
 
-    local render = state.enabled
-        and config.enabled
+    local render = config.enabled
         and config:render(mode)
         and not Env.win.get(win, 'diff')
         and Env.win.view(win).leftcol == 0

lua/render-markdown/health.lua

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

lua/render-markdown/lib/config.lua

@@ -14,12 +14,13 @@ local Config = {}
 Config.__index = Config
 
 ---@param root render.md.Config
+---@param enabled boolean
 ---@param buf integer
 ---@return render.md.main.Config
-function Config.new(root, buf)
+function Config.new(root, enabled, buf)
     ---@type render.md.buffer.Config
     local config = {
-        enabled = true,
+        enabled = enabled,
         render_modes = root.render_modes,
         max_file_size = root.max_file_size,
         debounce = root.debounce,
@@ -96,12 +97,12 @@ end
 
 ---@private
 ---@generic T: render.md.callout.Config|render.md.checkbox.custom.Config
----@param components table<string, T>
+---@param component table<string, T>
 ---@return table<string, T>
-function Config.normalize(components)
+function Config.normalize(component)
     local result = {}
-    for _, component in pairs(components) do
-        result[component.raw:lower()] = component
+    for _, value in pairs(component) do
+        result[value.raw:lower()] = value
     end
     return result
 end
@@ -131,7 +132,7 @@ end
 
 ---@param destination string
 ---@param icon render.md.mark.Text
-function Config:link_text(destination, icon)
+function Config:set_link_text(destination, icon)
     local options = Iter.table.filter(self.link.custom, function(custom)
         if custom.kind == 'suffix' then
             return vim.endswith(destination, custom.pattern)

lua/render-markdown/render/inline/link.lua

@@ -30,11 +30,11 @@ function Render:setup()
     elseif self.node.type == 'inline_link' then
         local destination = self.node:child('link_destination')
         if destination then
-            self.context.config:link_text(destination.text, icon)
+            self.context.config:set_link_text(destination.text, icon)
         end
     elseif self.node.type == 'uri_autolink' then
         local destination = self.node.text:sub(2, -2)
-        self.context.config:link_text(destination, icon)
+        self.context.config:set_link_text(destination, icon)
         autolink = true
     end
     self.data = { icon = icon, autolink = autolink }

lua/render-markdown/render/inline/shortcut.lua

@@ -62,7 +62,7 @@ function Render:wiki_link()
     self:hide(ctx.end_col - 1, 1)
     ---@type render.md.mark.Text
     local icon = { config.icon, config.highlight }
-    self.context.config:link_text(ctx.destination, icon)
+    self.context.config:set_link_text(ctx.destination, icon)
     local body = config.body(ctx)
     if not body then
         -- add icon

lua/render-markdown/state.lua

@@ -50,7 +50,7 @@ end
 function M.get(buf)
     local result = M.cache[buf]
     if not result then
-        result = Config.new(M.config, buf)
+        result = Config.new(M.config, M.enabled, buf)
         M.cache[buf] = result
     end
     return result