feat: table min width property

## Details

Allows users to specify a minimum column width to use for padded cell style.

Other minor changes:

- Add a "help" issue template
- Remove running luarocks packaging workflow on pull requests

Author: MeanderingProgrammer

.github/ISSUE_TEMPLATE/help.yml

@@ -0,0 +1,11 @@
+name: Help
+description: Advice on how to do something
+title: "help: "
+labels: [question]
+body:
+  - type: textarea
+    attributes:
+      label: Description
+      description: What is it you're trying to do?
+    validations:
+      required: true

.github/workflows/luarocks.yml

@@ -1,7 +1,6 @@
 name: Luarocks
 
 on:
-  pull_request: # Tests packaging on PR
   workflow_dispatch:
   push:
     tags:

README.md

@@ -425,8 +425,8 @@ require('render-markdown').setup({
         --  raw:     replaces only the '|' characters in each row, leaving the cells unmodified
         --  padded:  raw + cells are padded with inline extmarks to make up for any concealed text
         cell = 'padded',
-        -- Gets placed in delimiter row for each column, position is based on alignmnet
-        alignment_indicator = '━',
+        -- Minimum column width to use for padded cell
+        min_width = 0,
         -- Characters used to replace table border
         -- Correspond to top(3), delimiter(3), bottom(3), vertical, & horizontal
         -- stylua: ignore
@@ -436,6 +436,8 @@ require('render-markdown').setup({
             '└', '┴', '┘',
             '│', '─',
         },
+        -- Gets placed in delimiter row for each column, position is based on alignmnet
+        alignment_indicator = '━',
         -- Highlight for table heading, delimiter, and the line above
         head = 'RenderMarkdownTableHead',
         -- Highlight for everything else, main table rows and the line below
@@ -818,8 +820,8 @@ require('render-markdown').setup({
         --  raw:     replaces only the '|' characters in each row, leaving the cells unmodified
         --  padded:  raw + cells are padded with inline extmarks to make up for any concealed text
         cell = 'padded',
-        -- Gets placed in delimiter row for each column, position is based on alignmnet
-        alignment_indicator = '━',
+        -- Minimum column width to use for padded cell
+        min_width = 0,
         -- Characters used to replace table border
         -- Correspond to top(3), delimiter(3), bottom(3), vertical, & horizontal
         -- stylua: ignore
@@ -829,6 +831,8 @@ require('render-markdown').setup({
             '└', '┴', '┘',
             '│', '─',
         },
+        -- Gets placed in delimiter row for each column, position is based on alignmnet
+        alignment_indicator = '━',
         -- Highlight for table heading, delimiter, and the line above
         head = 'RenderMarkdownTableHead',
         -- Highlight for everything else, main table rows and the line below

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*         For 0.10.0        Last change: 2024 September 14
+*render-markdown.txt*         For 0.10.0        Last change: 2024 September 15
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -458,8 +458,8 @@ Full Default Configuration ~
             --  raw:     replaces only the '|' characters in each row, leaving the cells unmodified
             --  padded:  raw + cells are padded with inline extmarks to make up for any concealed text
             cell = 'padded',
-            -- Gets placed in delimiter row for each column, position is based on alignmnet
-            alignment_indicator = '━',
+            -- Minimum column width to use for padded cell
+            min_width = 0,
             -- Characters used to replace table border
             -- Correspond to top(3), delimiter(3), bottom(3), vertical, & horizontal
             -- stylua: ignore
@@ -469,6 +469,8 @@ Full Default Configuration ~
                 '└', '┴', '┘',
                 '│', '─',
             },
+            -- Gets placed in delimiter row for each column, position is based on alignmnet
+            alignment_indicator = '━',
             -- Highlight for table heading, delimiter, and the line above
             head = 'RenderMarkdownTableHead',
             -- Highlight for everything else, main table rows and the line below
@@ -863,8 +865,8 @@ Wiki Page
             --  raw:     replaces only the '|' characters in each row, leaving the cells unmodified
             --  padded:  raw + cells are padded with inline extmarks to make up for any concealed text
             cell = 'padded',
-            -- Gets placed in delimiter row for each column, position is based on alignmnet
-            alignment_indicator = '━',
+            -- Minimum column width to use for padded cell
+            min_width = 0,
             -- Characters used to replace table border
             -- Correspond to top(3), delimiter(3), bottom(3), vertical, & horizontal
             -- stylua: ignore
@@ -874,6 +876,8 @@ Wiki Page
                 '└', '┴', '┘',
                 '│', '─',
             },
+            -- Gets placed in delimiter row for each column, position is based on alignmnet
+            alignment_indicator = '━',
             -- Highlight for table heading, delimiter, and the line above
             head = 'RenderMarkdownTableHead',
             -- Highlight for everything else, main table rows and the line below

lua/render-markdown/health.lua

@@ -4,7 +4,7 @@ local state = require('render-markdown.state')
 local M = {}
 
 ---@private
-M.version = '7.0.2'
+M.version = '7.0.3'
 
 function M.check()
     M.start('version')

lua/render-markdown/init.lua

@@ -58,6 +58,7 @@ local M = {}
 ---@field public preset? render.md.table.Preset
 ---@field public style? render.md.table.Style
 ---@field public cell? render.md.table.Cell
+---@field public min_width? integer
 ---@field public border? string[]
 ---@field public alignment_indicator? string
 ---@field public head? string
@@ -489,8 +490,8 @@ M.default_config = {
         --  raw:     replaces only the '|' characters in each row, leaving the cells unmodified
         --  padded:  raw + cells are padded with inline extmarks to make up for any concealed text
         cell = 'padded',
-        -- Gets placed in delimiter row for each column, position is based on alignmnet
-        alignment_indicator = '━',
+        -- Minimum column width to use for padded cell
+        min_width = 0,
         -- Characters used to replace table border
         -- Correspond to top(3), delimiter(3), bottom(3), vertical, & horizontal
         -- stylua: ignore
@@ -500,6 +501,8 @@ M.default_config = {
             '└', '┴', '┘',
             '│', '─',
         },
+        -- Gets placed in delimiter row for each column, position is based on alignmnet
+        alignment_indicator = '━',
         -- Highlight for table heading, delimiter, and the line above
         head = 'RenderMarkdownTableHead',
         -- Highlight for everything else, main table rows and the line below

lua/render-markdown/render/table.lua

@@ -55,7 +55,7 @@ function Render:setup()
     local delim, table_rows = nil, {}
     self.info:for_each_child(function(row)
         if row.type == 'pipe_table_delimiter_row' then
-            delim = Render.parse_delim(row)
+            delim = self:parse_delim(row)
         elseif self.context:contains_info(row) then
             if vim.tbl_contains({ 'pipe_table_header', 'pipe_table_row' }, row.type) then
                 table.insert(table_rows, row)
@@ -92,22 +92,25 @@ end
 ---@private
 ---@param row render.md.NodeInfo
 ---@return render.md.table.DelimRow?
-function Render.parse_delim(row)
+function Render:parse_delim(row)
     local pipes, cells = Render.parse_row_data(row, 'pipe_table_delimiter_cell')
     if pipes == nil or cells == nil then
         return nil
     end
+    local min_width = self.table.cell == 'padded' and self.table.min_width or 0
     local columns = {}
-    for i = 1, #cells do
-        local cell, width = cells[i], pipes[i + 1].start_col - pipes[i].end_col
+    for i, cell in ipairs(cells) do
+        local width = pipes[i + 1].start_col - pipes[i].end_col
         if width < 0 then
             return nil
         end
+        width = math.max(width, min_width)
         table.insert(columns, { width = width, alignment = Render.alignment(cell) })
     end
     return { info = row, columns = columns }
 end
 
+---@private
 ---@param cell render.md.NodeInfo
 ---@return render.md.table.Alignment
 function Render.alignment(cell)
@@ -134,8 +137,8 @@ function Render:parse_row(row, num_columns)
         return nil
     end
     local columns = {}
-    for i = 1, #cells do
-        local cell, width = cells[i], pipes[i + 1].start_col - pipes[i].end_col
+    for i, cell in ipairs(cells) do
+        local width = pipes[i + 1].start_col - pipes[i].end_col
         -- Account for double width glyphs by replacing cell spacing with width
         width = width - (cell.end_col - cell.start_col) + self.context:width(cell)
         if width < 0 then

lua/render-markdown/state.lua

@@ -335,6 +335,7 @@ function M.validate()
                 preset = one_of(pipe_table.preset, { 'none', 'round', 'double', 'heavy' }, {}, nilable),
                 style = one_of(pipe_table.style, { 'full', 'normal', 'none' }, {}, nilable),
                 cell = one_of(pipe_table.cell, { 'padded', 'raw', 'overlay' }, {}, nilable),
+                min_width = { pipe_table.min_width, 'number', nilable },
                 border = string_array(pipe_table.border, nilable),
                 alignment_indicator = { pipe_table.alignment_indicator, 'string', nilable },
                 head = { pipe_table.head, 'string', nilable },

lua/render-markdown/types.lua

@@ -43,6 +43,7 @@
 ---@field public preset render.md.table.Preset
 ---@field public style render.md.table.Style
 ---@field public cell render.md.table.Cell
+---@field public min_width integer
 ---@field public border string[]
 ---@field public alignment_indicator string
 ---@field public head string