feat: configurable indent for first line of paragraph

## Details

Request: #417

Add `paragraph.indent` configuration option. Functions similarly to
`paragraph.left_margin` but only applies to the first row of each
paragraph, mimicking the behavior of most word processors. By default
set to 0, resulting in no visible change out of the box.

Since we only query for paragraphs directly under sections this should
avoid any edge cases with paragraphs under list items and other ways
paragraphs get nested.

Other changes:

- Add `indent` module for computing line / size / level, create in
  `base` rather than containing all the logic directly.
- Make the separation between `core` and `lib` meaningful. Anything that
  gets `setup` from state or initialized through plugin directory goes
  in `core`. All other modules go in `lib`:
  - colors  : root  -> core
  - command : root  -> core
  - manager : root  -> core
  - config  : root  -> lib
  - presets : root  -> lib
  - buffer  : core  -> lib
  - context : core  -> lib
  - conceal : core  -> lib
  - extmark : core  -> lib
  - range   : core  -> lib
  - ts      : integ -> core
  - icons   : integ -> lib
- As a result the only remaining modules at the root are:
  - api    : in case user requires it
  - health : convention
  - init   : convention
  - state  : LazyVim requires it
  - types  : best location, can move at any time
- Aliases types that get resolved to a concrete value at runtime like
  heading icons now get generic names like `String` or `Integer`, no more
  field specific names like `Icons`.
- `config/custom_handlers.lua` -> `config/handlers.lua`
- add an alias for `string|string[]` in the context of highlights
- `render.md.callback` -> `render.md.on`
- remove `indent` field from code render data, compute where needed
- remove all `require` statements from top of `api` module
- update CHANGELOG

Author: MeanderingProgrammer

CHANGELOG.md

@@ -16,13 +16,17 @@
 - set quote highlights for 6 levels of nesting [7051859](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/70518594a4bf1a35d4e331677dd86bc065e599a4)
   [cyberdream](https://github.com/scottmckendry/cyberdream.nvim/pull/182)
 - use conceal lines for setext heading underline [78ffe3b](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/78ffe3b0500bbc7e37fabde723d96661538e8b32)
+- improve debug command [40fff90](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/40fff90caccb4a1c902681f0440806ee9ae95d0b)
+- use selene to prevent accidental print statements [7f81e9d](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/7f81e9dcc15504c044f20df39d28a590cd5c6ca5)
 
 ### Bug Fixes
 
 - more robust icon provider resolution [#403](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/403)
   [dfffdd2](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/dfffdd221570d36ac80d1a599643140a319a36de)
 - disable line wrapping in LSP hover docs in some cases [#408](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/408)
   [080104e](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/080104e4dce26819efb4f4c83d1b7b2d82b96f7c)
+- handle spaces before atx headings [bd56575](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/bd5657594bf1a96b04f900c87e8d74226a54d832)
+- remove accidental vim.print [bff12b4](https://github.com/MeanderingProgrammer/render-markdown.nvim/commit/bff12b4655d1537cf0f10859fcd63ef2cec65010)
 
 ### Collaborator Shoutouts
 

README.md

@@ -404,6 +404,9 @@ require('render-markdown').setup({
         -- | function | `value(context)` |
         -- | number   | `value`          |
         left_margin = 0,
+        -- Amount of padding to add to the first line of each paragraph.
+        -- Output is evaluated using the same logic as 'left_margin'.
+        indent = 0,
         -- Minimum width to use for paragraphs.
         min_width = 0,
     },
@@ -992,6 +995,9 @@ require('render-markdown').setup({
         -- | function | `value(context)` |
         -- | number   | `value`          |
         left_margin = 0,
+        -- Amount of padding to add to the first line of each paragraph.
+        -- Output is evaluated using the same logic as 'left_margin'.
+        indent = 0,
         -- Minimum width to use for paragraphs.
         min_width = 0,
     },

doc/custom-handlers.md

@@ -36,7 +36,9 @@ Each handler must conform to the following interface:
 
 ---@class (exact) render.md.mark.Text
 ---@field [1] string text
----@field [2] string|string[] highlights
+---@field [2] render.md.mark.Hl highlight
+
+---@alias render.md.mark.Hl string|string[]
 ```
 
 The `parse` function takes a `ctx` parameter whose fields are:

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*        For NVIM v0.11.1       Last change: 2025 April 30
+*render-markdown.txt*         For NVIM v0.11.1        Last change: 2025 May 02
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -469,6 +469,9 @@ Default Configuration ~
             -- | function | `value(context)` |
             -- | number   | `value`          |
             left_margin = 0,
+            -- Amount of padding to add to the first line of each paragraph.
+            -- Output is evaluated using the same logic as 'left_margin'.
+            indent = 0,
             -- Minimum width to use for paragraphs.
             min_width = 0,
         },
@@ -1053,6 +1056,9 @@ Paragraph Configuration ~
             -- | function | `value(context)` |
             -- | number   | `value`          |
             left_margin = 0,
+            -- Amount of padding to add to the first line of each paragraph.
+            -- Output is evaluated using the same logic as 'left_margin'.
+            indent = 0,
             -- Minimum width to use for paragraphs.
             min_width = 0,
         },

justfile

@@ -1,7 +1,7 @@
 init := "tests/minimal_init.lua"
 settings := "{ minimal_init = " + quote(init) + ", sequential = true, keep_going = false }"
 
-default: update check test health
+default: update check test bench health
 
 update:
   # keep documentation in sync with code

lua/render-markdown/api.lua

@@ -1,44 +1,41 @@
-local manager = require('render-markdown.manager')
-local state = require('render-markdown.state')
-
 ---@class render.md.Api
 local M = {}
 
 function M.enable()
-    manager.set_all(true)
+    require('render-markdown.core.manager').set_all(true)
 end
 
 function M.buf_enable()
-    manager.set_current(true)
+    require('render-markdown.core.manager').set_current(true)
 end
 
 function M.disable()
-    manager.set_all(false)
+    require('render-markdown.core.manager').set_all(false)
 end
 
 function M.buf_disable()
-    manager.set_current(false)
+    require('render-markdown.core.manager').set_current(false)
 end
 
 function M.toggle()
-    manager.set_all()
+    require('render-markdown.core.manager').set_all()
 end
 
 function M.buf_toggle()
-    manager.set_current()
+    require('render-markdown.core.manager').set_current()
 end
 
 function M.log()
     require('render-markdown.core.log').open()
 end
 
 function M.expand()
-    state.modify_anti_conceal(1)
+    require('render-markdown.state').modify_anti_conceal(1)
     M.enable()
 end
 
 function M.contract()
-    state.modify_anti_conceal(-1)
+    require('render-markdown.state').modify_anti_conceal(-1)
     M.enable()
 end
 
@@ -47,7 +44,7 @@ function M.debug()
 end
 
 function M.config()
-    local difference = state.difference()
+    local difference = require('render-markdown.state').difference()
     if not difference then
         -- selene: allow(deprecated)
         vim.print('default configuration')

lua/render-markdown/config/anti_conceal.lua

@@ -25,7 +25,7 @@ local Element = {
     sign = 'sign',
 }
 
----@class render.md.anti.conceal
+---@class render.md.anti.conceal.Cfg
 local M = {}
 
 ---@type render.md.anti.conceal.Config

lua/render-markdown/config/base.lua

@@ -4,7 +4,7 @@
 
 ---@alias render.md.Modes boolean|string[]
 
----@class render.md.base
+---@class render.md.base.Cfg
 local M = {}
 
 ---@enum render.md.base.Width

lua/render-markdown/config/bullet.lua

@@ -1,27 +1,27 @@
 ---@class (exact) render.md.bullet.Config: render.md.base.Config
----@field icons render.md.bullet.Text
----@field ordered_icons render.md.bullet.Text
----@field left_pad render.md.bullet.Int
----@field right_pad render.md.bullet.Int
----@field highlight render.md.bullet.Text
----@field scope_highlight render.md.bullet.Text
+---@field icons render.md.bullet.String
+---@field ordered_icons render.md.bullet.String
+---@field left_pad render.md.bullet.Integer
+---@field right_pad render.md.bullet.Integer
+---@field highlight render.md.bullet.String
+---@field scope_highlight render.md.bullet.String
 
 ---@class (exact) render.md.bullet.Context
 ---@field level integer
 ---@field index integer
 ---@field value string
 
----@alias render.md.bullet.Text
+---@alias render.md.bullet.String
 ---| string
 ---| string[]
 ---| string[][]
 ---| fun(ctx: render.md.bullet.Context): string?
 
----@alias render.md.bullet.Int
+---@alias render.md.bullet.Integer
 ---| integer
 ---| fun(ctx: render.md.bullet.Context): integer
 
----@class render.md.bullet
+---@class render.md.bullet.Cfg
 local M = {}
 
 ---@type render.md.bullet.Config

lua/render-markdown/config/callout.lua

@@ -5,7 +5,7 @@
 ---@field quote_icon? string
 ---@field category? string
 
----@class render.md.callout
+---@class render.md.callout.Cfg
 local M = {}
 
 -- stylua: ignore

lua/render-markdown/config/checkbox.lua

@@ -15,7 +15,7 @@
 ---@field highlight string
 ---@field scope_highlight? string
 
----@class render.md.checkbox
+---@class render.md.checkbox.Cfg
 local M = {}
 
 ---@type render.md.checkbox.Config

lua/render-markdown/config/code.lua

@@ -45,7 +45,7 @@ local Border = {
     none = 'none',
 }
 
----@class render.md.code
+---@class render.md.code.Cfg
 local M = {}
 
 ---@type render.md.code.Config

lua/render-markdown/config/completions.lua

@@ -11,7 +11,7 @@
 ---@field callout fun(value: render.md.callout.Config): boolean
 ---@field checkbox fun(value: render.md.checkbox.custom.Config): boolean
 
----@class render.md.completions
+---@class render.md.completions.Cfg
 local M = {}
 
 ---@type render.md.completions.Config

lua/render-markdown/config/dash.lua

@@ -6,7 +6,7 @@
 
 ---@alias render.md.dash.Width 'full'|number
 
----@class render.md.dash
+---@class render.md.dash.Cfg
 local M = {}
 
 ---@type render.md.dash.Config

lua/render-markdown/config/document.lua

@@ -5,7 +5,7 @@
 ---@field char_patterns string[]
 ---@field line_patterns string[]
 
----@class render.md.document
+---@class render.md.document.Cfg
 local M = {}
 
 ---@type render.md.document.Config

lua/render-markdown/config/custom_handlers.lua renamed to lua/render-markdown/config/handlers.lua

@@ -1,4 +1,12 @@
----@class render.md.custom.handlers
+---@class (exact) render.md.Handler
+---@field extends? boolean
+---@field parse fun(ctx: render.md.handler.Context): render.md.Mark[]
+
+---@class (exact) render.md.handler.Context
+---@field buf integer
+---@field root TSNode
+
+---@class render.md.handlers.Cfg
 local M = {}
 
 ---@type table<string, render.md.Handler>

lua/render-markdown/config/heading.lua

@@ -2,7 +2,7 @@
 ---@field atx boolean
 ---@field setext boolean
 ---@field sign boolean
----@field icons render.md.heading.Icons
+---@field icons render.md.heading.String
 ---@field position render.md.heading.Position
 ---@field signs string[]
 ---@field width render.md.base.Width|(render.md.base.Width)[]
@@ -23,7 +23,7 @@
 ---@field level integer
 ---@field sections integer[]
 
----@alias render.md.heading.Icons
+---@alias render.md.heading.String
 ---| string[]
 ---| fun(ctx: render.md.heading.Context): string?
 
@@ -40,7 +40,7 @@ local Position = {
 ---@field background? string
 ---@field foreground? string
 
----@class render.md.heading
+---@class render.md.heading.Cfg
 local M = {}
 
 ---@type render.md.heading.Config

lua/render-markdown/config/html.lua

@@ -11,7 +11,7 @@
 ---@field icon string
 ---@field highlight string
 
----@class render.md.html
+---@class render.md.html.Cfg
 local M = {}
 
 ---@type render.md.html.Config

lua/render-markdown/config/indent.lua

@@ -5,7 +5,7 @@
 ---@field icon string
 ---@field highlight string
 
----@class render.md.indent
+---@class render.md.indent.Cfg
 local M = {}
 
 ---@type render.md.indent.Config

lua/render-markdown/config/injections.lua

@@ -2,7 +2,7 @@
 ---@field enabled boolean
 ---@field query string
 
----@class render.md.injection
+---@class render.md.injection.Cfg
 local M = {}
 
 ---@type table<string, render.md.injection.Config>

lua/render-markdown/config/inline_highlight.lua

@@ -1,7 +1,7 @@
 ---@class (exact) render.md.inline.highlight.Config: render.md.base.Config
 ---@field highlight string
 
----@class render.md.inline.highlight
+---@class render.md.inline.highlight.Cfg
 local M = {}
 
 ---@type render.md.inline.highlight.Config

lua/render-markdown/config/latex.lua

@@ -11,7 +11,7 @@ local Position = {
     below = 'below',
 }
 
----@class render.md.latex
+---@class render.md.latex.Cfg
 local M = {}
 
 ---@type render.md.latex.Config

lua/render-markdown/config/link.lua

@@ -39,7 +39,7 @@ local Kind = {
     suffix = 'suffix',
 }
 
----@class render.md.link
+---@class render.md.link.Cfg
 local M = {}
 
 ---@type render.md.link.Config

lua/render-markdown/config/on.lua

@@ -1,20 +1,20 @@
----@class (exact) render.md.callback.Config
----@field attach fun(ctx: render.md.callback.attach.Context)
----@field initial fun(ctx: render.md.callback.render.Context)
----@field render fun(ctx: render.md.callback.render.Context)
----@field clear fun(ctx: render.md.callback.render.Context)
+---@class (exact) render.md.on.Config
+---@field attach fun(ctx: render.md.on.attach.Context)
+---@field initial fun(ctx: render.md.on.render.Context)
+---@field render fun(ctx: render.md.on.render.Context)
+---@field clear fun(ctx: render.md.on.render.Context)
 
----@class (exact) render.md.callback.attach.Context
+---@class (exact) render.md.on.attach.Context
 ---@field buf integer
 
----@class (exact) render.md.callback.render.Context
+---@class (exact) render.md.on.render.Context
 ---@field buf integer
 ---@field win integer
 
----@class render.md.callback
+---@class render.md.on.Cfg
 local M = {}
 
----@type render.md.callback.Config
+---@type render.md.on.Config
 M.default = {
     -- Called when plugin initially attaches to a buffer.
     attach = function() end,