feat: automatic source registration for blink.cmp

## Details

Follows release of `blink.cmp` 0.14.0, which provides additional APIs
for registering sources.

Now when the `blink` completion source is enabled in this plugin we'll
use the `add_source_provider` & `add_filetype_source` functions to
automatically register the completion source on behalf of the user.

This is an opt-in feature so out of the box nothing new happens.

The in-process LSP source is still the suggested approach for getting
completions from this plugin as they are completion engine agnostic.

Simplify the instructions for using the `blink.cmp` source in the README.

Author: MeanderingProgrammer

CHANGELOG.md

@@ -6,6 +6,11 @@
 
 - enabled flag for link footnote [#362](https://github.com/MeanderingProgrammer/render-markdown.nvim/pull/362)
   [9721ffe](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/9721ffe230ec90e49c49ee33b5ca44c3fc689214)
+- blink.cmp source registration [b8d93e8](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/b8d93e83a02dadddc6a566b1f60dab87190c1296)
+
+### Bug Fixes
+
+- account for indent when right aligning code language [125258a](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/125258ac5bccd21651505d78dbd6120906243749)
 
 ### Collaborator Shoutouts
 

README.md

@@ -148,17 +148,8 @@ cmp.setup({
 ## blink.cmp
 
 ```lua
-require('blink.cmp').setup({
-    sources = {
-        default = { 'lsp', 'path', 'snippets', 'buffer', 'markdown' },
-        providers = {
-            markdown = {
-                name = 'RenderMarkdown',
-                module = 'render-markdown.integ.blink',
-                fallbacks = { 'lsp' },
-            },
-        },
-    },
+require('render-markdown').setup({
+    completions = { blink = { enabled = true } },
 })
 ```
 

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*           For 0.10.0          Last change: 2025 March 18
+*render-markdown.txt*           For 0.10.0          Last change: 2025 March 19
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -210,17 +210,8 @@ NVIM-CMP                                *render-markdown-completions-nvim-cmp*
 BLINK.CMP                              *render-markdown-completions-blink.cmp*
 
 >lua
-    require('blink.cmp').setup({
-        sources = {
-            default = { 'lsp', 'path', 'snippets', 'buffer', 'markdown' },
-            providers = {
-                markdown = {
-                    name = 'RenderMarkdown',
-                    module = 'render-markdown.integ.blink',
-                    fallbacks = { 'lsp' },
-                },
-            },
-        },
+    require('render-markdown').setup({
+        completions = { blink = { enabled = true } },
     })
 <
 

lua/render-markdown/health.lua

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

lua/render-markdown/integ/blink.lua

@@ -1,6 +1,7 @@
 ---@module 'blink.cmp'
 
 local source = require('render-markdown.integ.source')
+local state = require('render-markdown.state')
 
 ---@class render.md.blink.Source: blink.cmp.Source
 local Source = {}
@@ -39,8 +40,10 @@ function Source:get_completions(context, callback)
 end
 
 ---@class render.md.integ.Blink
+---@field private id string
 ---@field private registered boolean
 local M = {
+    id = 'markdown',
     registered = false,
 }
 
@@ -50,8 +53,17 @@ function Source.setup()
         return
     end
     M.registered = true
-    -- TODO(blink.cmp): need add_source_provider to be released
-    vim.notify('render-markdown.nvim blink.cmp source registeration requires add_source_provider', 3)
+    local has_blink, blink = pcall(require, 'blink.cmp')
+    if not has_blink or blink == nil then
+        return
+    end
+    pcall(blink.add_source_provider, M.id, {
+        name = 'RenderMarkdown',
+        module = 'render-markdown.integ.blink',
+    })
+    for _, file_type in ipairs(state.file_types) do
+        pcall(blink.add_filetype_source, file_type, M.id)
+    end
 end
 
 return Source

lua/render-markdown/integ/cmp.lua

@@ -42,7 +42,7 @@ function M.setup()
     end
     M.registered = true
     local has_cmp, cmp = pcall(require, 'cmp')
-    if not has_cmp then
+    if not has_cmp or cmp == nil then
         return
     end
     pcall(cmp.register_source, Source:get_debug_name(), Source)

lua/render-markdown/integ/source.lua

@@ -19,58 +19,65 @@ end
 
 ---@return string[]
 function M.trigger_characters()
-    return { '-', '*', '+', '>', ' ' }
+    local characters = vim.tbl_values(list_markers)
+    return vim.list_extend(characters, { '>', ' ' })
 end
 
 ---@param buf integer 0 for current buffer
 ---@param row integer 0-indexed
 ---@param col integer 0-indexed
 ---@return lsp.CompletionItem[]?
 function M.items(buf, row, col)
-    if buf == 0 then
-        buf = util.current('buf')
-    end
-
-    local has_parser, parser = pcall(vim.treesitter.get_parser, buf)
-    if not has_parser or parser == nil then
-        return nil
-    end
-
-    -- Parse current row to get up to date node
-    parser:parse({ row, row })
-    local node = vim.treesitter.get_node({ bufnr = buf, pos = { row, col } })
+    buf = buf == 0 and util.current('buf') or buf
+    local node = M.get_node(buf, row, col)
     if node == nil then
         return nil
     end
-
-    local children = { 'block_quote_marker', 'block_continuation' }
-    if vim.tbl_contains(children, node:type()) or list_markers[node:type()] ~= nil then
-        node = node:parent()
-        if node == nil then
-            return nil
-        end
-    end
-
-    local items = {}
-    local config = state.get(buf)
+    local result, config = {}, state.get(buf)
     if node:type() == 'block_quote' then
         local quote_row = node:range()
         if quote_row == row then
             local prefix = M.space_prefix(buf, node)
             for _, component in pairs(config.callout) do
-                table.insert(items, M.item(prefix .. component.raw, component.rendered, nil))
+                table.insert(result, M.item(prefix .. component.raw, component.rendered, nil))
             end
         end
     elseif node:type() == 'list_item' then
         local checkbox = config.checkbox
         local prefix = M.list_prefix(buf, row, node)
-        table.insert(items, M.item(prefix .. '[ ] ', checkbox.unchecked.icon, 'unchecked'))
-        table.insert(items, M.item(prefix .. '[x] ', checkbox.checked.icon, 'checked'))
+        table.insert(result, M.item(prefix .. '[ ] ', checkbox.unchecked.icon, 'unchecked'))
+        table.insert(result, M.item(prefix .. '[x] ', checkbox.checked.icon, 'checked'))
         for name, component in pairs(checkbox.custom) do
-            table.insert(items, M.item(prefix .. component.raw .. ' ', component.rendered, name))
+            table.insert(result, M.item(prefix .. component.raw .. ' ', component.rendered, name))
         end
     end
-    return items
+    return result
+end
+
+---@private
+---@param buf integer
+---@param row integer
+---@param col integer
+---@return TSNode?
+function M.get_node(buf, row, col)
+    -- Parse current row to get up to date node
+    local has_parser, parser = pcall(vim.treesitter.get_parser, buf)
+    if not has_parser or parser == nil then
+        return nil
+    end
+    parser:parse({ row, row })
+
+    local node = vim.treesitter.get_node({
+        bufnr = buf,
+        lang = 'markdown',
+        pos = { row, col },
+    })
+    local children = vim.tbl_keys(list_markers)
+    vim.list_extend(children, { 'block_quote_marker', 'block_continuation' })
+    if node ~= nil and vim.tbl_contains(children, node:type()) then
+        node = node:parent()
+    end
+    return node
 end
 
 ---@private