refactor: indentation textobj uses config instead of noBlanks param

README.md

@@ -119,9 +119,9 @@ The `.setup()` call is optional if you are fine with the defaults below.
 ```lua
 -- default config
 require("various-textobjs").setup {
-	-- See overview table in README for the defaults keymaps. 
+	-- See overview table in README for the defaults keymaps.
 	-- (Note that lazy-loading this plugin, the default keymaps cannot be set up.
-	-- if you set this to `true`, you thus need to add `event = "VeryLazy"` to your
+	-- if you set this to `true`, you thus need to add `lazy = false` to your
 	-- lazy.nvim config.)
 	useDefaultKeymaps = false,
 
@@ -140,9 +140,15 @@ require("various-textobjs").setup {
 		whenObjectNotFound = true,
 	},
 
+	-- extra configuration for specific text objects
 	textobjs = {
-		diagnostic = { 
-			wrap = true 
+		indentation = {
+			-- `false`: only indentation changes delimit the text object
+			-- `true`: indentation changes as well as blanks delimit the text object
+			blanksAreDelimiter = false,
+		},
+		diagnostic = {
+			wrap = true,
 		},
 		subword = {
 			-- When deleting the start of a camelCased word, the result should
@@ -188,13 +194,6 @@ vim.keymap.set(
 	"ai",
 	'<cmd>lua require("various-textobjs").indentation("outer", "inner")<CR>'
 )
-
--- an additional parameter can be passed to control whether blank lines are included
-vim.keymap.set(
-	{ "o", "x" },
-	"ai",
-	'<cmd>lua require("various-textobjs").indentation("outer", "inner", "noBlanks")<CR>'
-)
 ```
 
 ## Advanced usage / API

lua/various-textobjs/config.lua

@@ -23,7 +23,13 @@ local defaultConfig = {
 		whenObjectNotFound = true,
 	},
 
+	-- extra configuration for specific text objects
 	textobjs = {
+		indentation = {
+			-- `false`: only indentation changes delimit the text object
+			-- `true`: indentation changes as well as blanks delimit the text object
+			blanksAreDelimiter = false,
+		},
 		diagnostic = {
 			wrap = true,
 		},

lua/various-textobjs/textobjs/linewise.lua

@@ -148,27 +148,33 @@ end
 
 --------------------------------------------------------------------------------
 
----indentation textobj
 ---@param startBorder "inner"|"outer"
 ---@param endBorder "inner"|"outer"
----@param blankLines? "withBlanks"|"noBlanks"
-function M.indentation(startBorder, endBorder, blankLines)
-	if not blankLines then blankLines = "withBlanks" end
+---@return boolean|nil success
+function M.indentation(startBorder, endBorder, oldBlankSetting)
+	-- DEPRECATION (2024-12-06)
+	if oldBlankSetting ~= nil then
+		u.warn(
+			"`.indentation()` does not use a 3rd argument anymore. Use the config `textobjs.indent.blanksAreDelimiter` instead."
+		)
+	end
+	local blanksAreDelimiter =
+		require("various-textobjs.config").config.textobjs.indentation.blanksAreDelimiter
 
 	local curLnum = vim.api.nvim_win_get_cursor(0)[1]
 	local lastLine = vim.api.nvim_buf_line_count(0)
 	while isBlankLine(curLnum) do -- when on blank line, use next line
 		if lastLine == curLnum then
 			u.notFoundMsg("No indented line found.")
-			return
+			return false
 		end
 		curLnum = curLnum + 1
 	end
 
 	local indentOfStart = vim.fn.indent(curLnum)
 	if indentOfStart == 0 then
 		u.warn("Current line is not indented.")
-		return false -- return value needed for `greedyOuterIndentation` textobj
+		return false
 	end
 
 	local prevLnum = curLnum - 1
@@ -177,7 +183,7 @@ function M.indentation(startBorder, endBorder, blankLines)
 	while
 		prevLnum > 0
 		and (
-			(blankLines == "withBlanks" and isBlankLine(prevLnum))
+			(isBlankLine(prevLnum) and not blanksAreDelimiter)
 			or vim.fn.indent(prevLnum) >= indentOfStart
 		)
 	do
@@ -186,7 +192,7 @@ function M.indentation(startBorder, endBorder, blankLines)
 	while
 		nextLnum <= lastLine
 		and (
-			(blankLines == "withBlanks" and isBlankLine(nextLnum))
+			(isBlankLine(nextLnum) and not blanksAreDelimiter)
 			or vim.fn.indent(nextLnum) >= indentOfStart
 		)
 	do