feat: allow custom link icons to be disabled for images

## Details

Currently when choosing an icon for image links we check the configured
`link.custom` patterns based on the destination and if a match exists
that is the icon that will be rendered.

Some users would like to always see the `link.image` regardless of the
destination. To support this have added a new `link.image_custom` option
that defaults to `true`. When `true` the behavior remains unchanged,
when `false` the destination is ignored and `link.image` is always used.

Author: MeanderingProgrammer

README.md

@@ -800,6 +800,8 @@ require('render-markdown').setup({
         },
         -- Inlined with 'image' elements.
         image = '󰥶 ',
+        -- Check custom for 'image' elements.
+        image_custom = true,
         -- Inlined with 'email_autolink' elements.
         email = '󰀓 ',
         -- Fallback icon for 'inline_link' and 'uri_autolink' elements.
@@ -1594,6 +1596,8 @@ require('render-markdown').setup({
         },
         -- Inlined with 'image' elements.
         image = '󰥶 ',
+        -- Check custom for 'image' elements.
+        image_custom = true,
         -- Inlined with 'email_autolink' elements.
         email = '󰀓 ',
         -- Fallback icon for 'inline_link' and 'uri_autolink' elements.

doc/render-markdown.txt

@@ -866,6 +866,8 @@ Default Configuration ~
             },
             -- Inlined with 'image' elements.
             image = '󰥶 ',
+            -- Check custom for 'image' elements.
+            image_custom = true,
             -- Inlined with 'email_autolink' elements.
             email = '󰀓 ',
             -- Fallback icon for 'inline_link' and 'uri_autolink' elements.
@@ -1640,6 +1642,8 @@ Link Configuration ~
             },
             -- Inlined with 'image' elements.
             image = '󰥶 ',
+            -- Check custom for 'image' elements.
+            image_custom = true,
             -- Inlined with 'email_autolink' elements.
             email = '󰀓 ',
             -- Fallback icon for 'inline_link' and 'uri_autolink' elements.

lua/render-markdown/health.lua

@@ -6,7 +6,7 @@ local state = require('render-markdown.state')
 local M = {}
 
 ---@private
-M.version = '8.11.10'
+M.version = '8.11.11'
 
 function M.check()
     M.start('versions')

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

@@ -30,7 +30,7 @@ function Render:setup()
     elseif self.node.type == 'image' then
         icon[1] = self.config.image
         local destination = self.node:child('link_destination')
-        if destination then
+        if destination and self.config.image_custom then
             self.context.config:set_link_text(destination.text, icon)
         end
         title = self.node:child('link_title')

lua/render-markdown/settings.lua

@@ -1225,6 +1225,7 @@ M.link = {}
 ---@class (exact) render.md.link.Config: render.md.base.Config
 ---@field footnote render.md.link.footnote.Config
 ---@field image string
+---@field image_custom boolean
 ---@field email string
 ---@field hyperlink string
 ---@field highlight string
@@ -1297,6 +1298,8 @@ M.link.default = {
     },
     -- Inlined with 'image' elements.
     image = '󰥶 ',
+    -- Check custom for 'image' elements.
+    image_custom = true,
     -- Inlined with 'email_autolink' elements.
     email = '󰀓 ',
     -- Fallback icon for 'inline_link' and 'uri_autolink' elements.
@@ -1378,6 +1381,7 @@ function M.link.schema()
             },
         },
         image = { type = 'string' },
+        image_custom = { type = 'boolean' },
         email = { type = 'string' },
         hyperlink = { type = 'string' },
         highlight = { type = 'string' },

lua/render-markdown/types.lua

@@ -214,6 +214,7 @@
 ---@class (exact) render.md.link.UserConfig: render.md.base.UserConfig
 ---@field footnote? render.md.link.footnote.UserConfig
 ---@field image? string
+---@field image_custom? boolean
 ---@field email? string
 ---@field hyperlink? string
 ---@field highlight? string