v0.2.0 - multiline improved (#37)

    Fixed-width columns: Support for org-style alignment tags (<l30>, <c10>, <r20>)
        Tags specify alignment (left/center/right) and column width
        Automatic text wrapping for cells exceeding column width
    Automatic multiline row detection:
        detects if a table has multiline rows by checking for separator patterns
        Enabled when multiline option is set to 'auto' (now the default)
    Multiline formatting options:
        New multiline_format option with values: 'align', 'wrap', 'block_align', 'block_wrap' (default), 'paragraph_wrap'

Author: numEricL

CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to this project will be documented in this file.
 
+## [v0.2.0] - 2026-02-19
+
+### Added
+- **Fixed-width columns**: Support for org-style alignment tags (`<l30>`, `<c10>`, `<r20>`)
+  - Tags specify alignment (left/center/right) and column width
+  - Automatic text wrapping for cells exceeding column width
+- **Automatic multiline row detection**:
+  - detects if a table has multiline rows by checking for separator patterns
+  - Enabled when `multiline` option is set to `'auto'` (now the default)
+- **Multiline formatting options**:
+  - New `multiline_format` option with values: `'align'`, `'wrap'`, `'block_align'`, `'block_wrap'` (default), `'paragraph_wrap'`
+- Cell editor now automatically fills missing multiline rows when editing cells
+
+### Fixed
+- Sort functionality now works correctly with right-aligned columns
+- Org-style alignment detection no longer triggers false positives on empty lines
+- Improved table parser to handle column bounds for visual block operations
+- Fixed cleanup in table drawing lines to clear removed data
+- Fixed alignment row identification when placement align_sep_id is unset
+
+### Changed
+- **BREAKING**: Changed `multiline` option default from `v:false` to `'auto'`
+  - Now auto-detects multiline rows based on separator patterns in the table
+  - Set to `v:true` or `v:false` for explicit control
+- **BREAKING**: Replaced `preserve_indentation` with `multiline_format` option
+- `:TableOption` command renamed to `:TableConfig`.
+- org-style alignment tags take precedence over alignment header
+
+### Deprecated
+- `:TableOption` command is deprecated in favor of `:TableConfig`
+  - `:TableOption` still works but shows a deprecation warning
+
 ## [v0.1.1] - 2026-02-15
 
 ### Fixed

README.md

@@ -1,13 +1,15 @@
 # table.vim
 
-Your one-stop shop for all your table editing needs in Vim and Neovim. Supports
-multi-line rows and features a cell editing window for editing cell content in a
-separate buffer (Neovim users get a seamless floating window)
+Advanced table editing for Vim and Neovim. Easily create, edit, and format
+tables with support for multi-line rows, fixed-width columns, sorting, and
+various table styles. Edit cell content in a separate window for enhanced
+control. Highly configurable and extensible.
 
 ## Quick Start
 
 Create tables using pipes `|` and dashes `-`. The table is aligned and redrawn
-automatically on pipe insertion. Table style is configurable.
+automatically on pipe insertion. Table style is configurable, "double" is shown
+here:
 
 ```
 |Header 1| Header 2|Header 3|           ║ Header 1 ║ Header 2 ║ Header 3 ║
@@ -26,7 +28,7 @@ And may be completed to:
 ```
 
 - Use `:Table <action>` to perform table actions like completion, sorting, and style conversion.
-- Use `:TableOption <option>` to view and change configuration at runtime, such as enabling multiline rows or changing the table style.
+- Use `:TableConfig <option>` to view and change configuration at runtime, such as enabling multiline rows or changing the table style.
 
 See [`:help table.txt`](doc/table.txt) for complete documentation.
 
@@ -35,9 +37,16 @@ See [`:help table.txt`](doc/table.txt) for complete documentation.
 - Vim 8.1 or later
 - Neovim 0.11.5 or later
 
+## Upgrading from v0.1.x
+
+- **Multiline rows** are now auto-detected by default. Set `multiline` to `true` or `false` to override.
+- **`:TableOption`** is deprecated. Use **`:TableConfig`** instead.
+- If you used `preserve_indentation`, switch to `multiline_format` (see `:help table-configuration`). Default behavior is unchanged.
+
 ## Features
 
-- **Multiline rows**        - must be enabled in your configuration
+- **Multiline rows**        - auto-detected by default
+- **Fixed-width columns**   - hard-wrap columns with alignment tags
 - **Cell editing window**   - edit in a floating window, hooks provided (split window in Vim)
 - **Sorting**               - sort rows and columns by any column/row
 - **Table navigation**      - move between cells even if the table is not yet aligned
@@ -46,26 +55,27 @@ See [`:help table.txt`](doc/table.txt) for complete documentation.
 
 ## Demo
 
+Note: This demo is from an older version, options have changed.
 https://github.com/user-attachments/assets/352e23b0-33ba-4f9d-9fa0-e2aee5fd16cc
 
 ## Configuration (optional)
 
 Configuration is **buffer-local**. Set defaults in your vimrc, customize
-per-filetype in after/ftplugin files, or change at runtime with `:TableOption`.
+per-filetype in after/ftplugin files, or change at runtime with `:TableConfig`.
 
 ```vim
 " .vimrc - set defaults for all buffers (overridden by ftplugins)
 call table#Setup({
     \ 'style': 'default',
-    \ 'options': {'multiline': v:true}
+    \ 'options': {'multiline': 'auto', 'multiline_format': 'block_wrap'}
     \ })
 ```
 
 ```lua
 -- init.lua - set defaults for all buffers (overridden by ftplugins)
 require('table_vim').setup({
     style = 'default',
-    options = { multiline = true }
+    options = { multiline = 'auto', multiline_format = 'block_wrap' }
 })
 ```
 
@@ -93,7 +103,7 @@ keybindings work normally.
 
 ### Navigation
 
-- `<Tab>` / `<S-Tab>` - Next/previous cell (wraps rows)
+- `<Tab>` / `<S-Tab>` - Next/previous cell
 - `<C-h>` / `<C-j>` / `<C-k>` / `<C-l>` - Navigate left/down/up/right
 
 ### Text Objects
@@ -123,7 +133,7 @@ nnoremap <leader>te    <Plug>(table_cell_edit)
 
 ## Commands
 
-Two top level commands are defined, `:Table` and `:TableOption`. Tab-completion
+Two top level commands are defined, `:Table` and `:TableConfig`. Tab-completion
 is available for all subcommands and arguments.
 
 ### `:Table` - Table Actions
@@ -138,19 +148,21 @@ is available for all subcommands and arguments.
 :Table ToStyle {style}           " Convert to specified style and update buffer style
 ```
 
-### `:TableOption` - Runtime Configuration
+### `:TableConfig` - Runtime Configuration
 
 Runtime configuration for the current buffer. Use without arguments to show
 current configuration.
 
 ```vim
-:TableOption                              " Show all current settings
-:TableOption Style [name]                 " Get/set style
-:TableOption Option [key] [value]         " Get/set option
-:TableOption StyleOption [key] [value]    " Get/set style option
-:TableOption RegisterStyle [name]         " Register current style (session only)
+:TableConfig                              " Show all current settings
+:TableConfig Style [name]                 " Get/set style
+:TableConfig Option [key] [value]         " Get/set option
+:TableConfig StyleOption [key] [value]    " Get/set style option
+:TableConfig RegisterStyle [name]         " Register current style (session only)
 ```
 
+**Note:** `:TableOption` is deprecated, use `:TableConfig` instead.
+
 **Note:** Style registration is only for the current session. Add the
 registration to your vimrc/init.lua for persistence.
 
@@ -166,6 +178,38 @@ Sort table rows by a specific column or sort columns by a specific row:
 
 See `:help :Table-SortRows` and `:help :Table-SortCols`
 
+## Fixed-Width Columns
+
+Set column widths using alignment tags. Tags use the format
+`<[alignment][width]>` where alignment is `l` (left), `c` (center), or `r`
+(right), and width is a positive integer. Columns are padded to the specified
+width, and, if `multiline` is enabled and a `multiline_format` wrap option is
+set, long columns are also hard-wrapped to the specified width.
+
+```vim
+| Description        |   Column 1 width    |
+|--------------------|---------------------|
+| <l30>              |        <c10>        |
+| Next col will wrap | This cell will wrap |
+
+
+| Description        | Column 1  |
+|                    |   width   |
+|--------------------|-----------|
+| <l30>              |   <c10>   |
+| Next col will wrap | This cell |
+|                    | will wrap |
+```
+
+Enable wrapping in configuration:
+```vim
+call table#Setup({
+    \ 'options': {'multiline': 'auto', 'multiline_format': 'block_wrap'}
+    \ })
+```
+
+See `:help table-fixed-width` for details.
+
 ## Chunk Processing
 
 For performance, the align action (auto-align and `:Table Align`) only processes

TODO.md

@@ -1 +1,2 @@
 * table caching is disables in favor of chunk processing. re-enable later if needed.
+* validate config option values

autoload/table.vim

@@ -1,7 +1,7 @@
 let s:save_cpo = &cpo
 set cpo&vim
 
-let g:table_version = '0.1.1'
+let g:table_version = '0.2.0'
 
 function! table#Version() abort
     return g:table_version
@@ -31,11 +31,21 @@ function! table#AlignIfNotEscaped() abort
     if char_before_pipe ==# '\'
         return
     else
-        let coord = s:GetCursorLineCoord()
+        let cur_pos = getpos('.')[1:2]
+        let cfg_opts = table#config#Config(bufnr('%')).options
+        let table = table#table#Get(cur_pos[0], cfg_opts.chunk_size)
+        if !table.valid
+            return
+        endif
+        let coord = table#cursor#GetCoord(table, cur_pos)
+        if coord.type ==# 'alignment'
+            let coord = table#cursor#GetCoord(table, cur_pos, {'type_override': 'separator'})
+        endif
+        " if char under cursor before insertion is a pipe, offset by one for correct coordinate
         let char_under_cursor = getline('.')[col('.') - 1]
         let coord.coord[-1] -= ( char_under_cursor ==# '|' )? 1 : 0
-        call table#Align(line('.'))
-        call s:SetCursorLineCoord(coord)
+        let table = table#draw#CurrentlyPlaced(table)
+        call table#cursor#SetCoord(table, coord)
     endif
 endfunction
 
@@ -85,12 +95,13 @@ endfunction
 
 function! table#CycleCursor(dir, count1) abort
     let curpos = getpos('.')[1:2]
-    let table = table#table#Get(curpos[0], [0,0])
+    let table = table#table#Get(curpos[0], [-1,0])
     if !table.valid
         return
     endif
     let coord = table#cursor#GetCoord(table, getpos('.')[1:2], {'dir': a:dir})
     if coord.type ==# 'separator'
+        let table = table#table#Get(curpos[0], [0,0])
         let coord = table#cursor#GetCoord(table, getpos('.')[1:2], {'type_override': 'cell'})
     endif
     for _ in range(a:count1)
@@ -119,27 +130,6 @@ function! table#Sort(linenr, dim_kind, id, flags) abort
     call table#draw#CurrentlyPlaced(table)
 endfunction
 
-function! s:GetCursorLineCoord() abort
-    let table = table#table#Get(line('.'), [0,0])
-    return table#cursor#GetCoord(table, getpos('.')[1:2])
-endfunction
-
-function! s:SetCursorLineCoord(coord) abort
-    let table = table#table#Get(line('.'), [0,0])
-    if a:coord.type ==# 'cell'
-        let a:coord.coord[0] = 0
-    else
-        let sep_id = (table.placement.bounds[0] - line('.')) < 0? 0 : -1
-        if a:coord.type ==# 'alignment'
-            let a:coord.type= 'separator'
-            let a:coord.coord = [ sep_id, (a:coord.coord[0]+1)/2 ]
-        elseif a:coord.type ==# 'separator'
-            let a:coord.coord[0] = sep_id
-        endif
-    endif
-    call table#cursor#SetCoord(table, a:coord)
-endfunction
-
 function! s:UpdateOnCycleWrapCell(table, dir, coord) abort
     let new_table = a:table
     let new_coord = a:coord
@@ -176,7 +166,8 @@ endfunction
 function! s:CycleCursor(table, dir, coord) abort
     let step = (a:dir ==# 'forward') ? 1 : -1
     if a:coord.type ==# 'alignment'
-        let n = 2*len(a:table.col_align)
+        let align_id = a:table.placement.align_sep_id
+        let n = 2*( len(a:table.placement.positions[align_id]['separator_pos']) - 1 )
         let a:coord.coord[0] = (a:coord.coord[0] + step + n) % n
     elseif a:coord.type ==# 'cell'
         let row_bound = a:table.RowCount()

autoload/table/cell_editor.vim

@@ -105,7 +105,7 @@ function! s:OnWinClosed(tbl_id) abort
     endif
 
     call s:UpdateCell(tbl, cell_id, bufnr)
-    call table#draw#CurrentlyPlaced(tbl)
+    call table#draw#CurrentlyPlaced(tbl, {'fill_multiline_gaps': v:true})
     augroup table.vim
         autocmd!
     augroup END

autoload/table/commands.vim

@@ -58,11 +58,11 @@ function! table#commands#TableComplete(ArgLead, CmdLine, CursorPos) abort
     return []
 endfunction
 
-" :TableOption command - for configuration
-function! table#commands#TableOptionCommand(...) abort
+" :TableConfig command - for configuration
+function! table#commands#TableConfigCommand(...) abort
     if a:0 == 0
         let subcommands = ['Option', 'StyleOption', 'Style', 'RegisterStyle']
-        echomsg 'TableOption subcommands: ' .. join(subcommands, ', ')
+        echomsg 'TableConfig subcommands: ' .. join(subcommands, ', ')
         echomsg ' '
         echomsg 'table.vim ' .. table#Version()
         echomsg 'Configuration for buffer ' .. (bufname('%') !=# '' ? bufname('%') : bufnr('%'))
@@ -87,12 +87,12 @@ function! table#commands#TableOptionCommand(...) abort
         call s:RegisterStyle(args)
     else
         echohl ErrorMsg
-        echomsg "TableOption: unknown subcommand '" .. subcommand .. "'"
+        echomsg "TableConfig: unknown subcommand '" .. subcommand .. "'"
         echohl None
     endif
 endfunction
 
-function! table#commands#TableOptionComplete(ArgLead, CmdLine, CursorPos) abort
+function! table#commands#TableConfigComplete(ArgLead, CmdLine, CursorPos) abort
     let parts = split(a:CmdLine, '\s\+', 1)
     let num_args = len(parts) - 1
 
@@ -236,8 +236,10 @@ function! s:CompleteOption(ArgLead, CmdLine, CursorPos) abort
         let option_key = parts[1]
         if option_key ==# 'default_alignment'
             return filter(['left', 'center', 'right'], 'v:val =~? "^" .. a:ArgLead')
-        elseif option_key =~# 'multiline\|indentation'
-            return filter(['true', 'false'], 'v:val =~? "^" .. a:ArgLead')
+        elseif option_key ==# 'multiline'
+            return filter(['auto', 'true', 'false'], 'v:val =~? "^" .. a:ArgLead')
+        elseif option_key ==# 'multiline_format'
+            return filter(['align', 'wrap', 'block_align', 'block_wrap', 'paragraph_wrap'], 'v:val =~? "^" .. a:ArgLead')
         endif
     endif
     return []
@@ -315,5 +317,11 @@ function! s:ParseSortArgs(type, bang, args) abort
     return sort_args
 endfunction
 
+function! table#commands#TableOptionCommand(...) abort
+    echom 'TableOption command is deprecated, use TableConfig instead'
+    echom ''
+    call call('table#commands#TableConfigCommand', a:000)
+endfunction
+
 let &cpo = s:save_cpo
 unlet s:save_cpo

autoload/table/compat.vim

@@ -31,22 +31,10 @@ function! table#compat#virtcol2col(winid, lnum, col) abort
         return virtcol2col(a:winid, a:lnum, a:col)
     endif
 
-    " input col and output byte are 1-based, internal computations are 0-based
     let bufnr = winbufnr(a:winid)
     let line = table#compat#getbufoneline(bufnr, a:lnum)
-    let byte = 0
-    let vcol = 0
-    let idx = 0
-    while byte < len(line) && vcol < a:col-1
-        let char = strcharpart(line, idx, 1)
-        let idx += 1
-        let vcol += strdisplaywidth(char, vcol)
-        if vcol > a:col-1
-            break
-        endif
-        let byte += len(char)
-    endwhile
-    return byte+1
+    " input col and output byte are 1-based, internal computations are 0-based
+    return table#util#DisplayWidthToByteWidth(line, a:col-1) + 1
 endfunction
 
 let &cpo = s:save_cpo