refactor(statusline): Added option to change ruler mode via config

feat(statusline): Help window's statusline now shows the ruler in Visual
mode(and it's varients)

doc(statusline): Updated ruler options type definitions

Author: OXY2DEV

lua/bars/components/statusline.lua

@@ -432,13 +432,11 @@ end
 slC.ruler = function (_, window, main_config)
 	---|fS
 
-	local mode = vim.api.nvim_get_mode().mode;
-
 	---@type ruler.opts
 	local config;
 	local x, y;
 
-	if vim.list_contains({ "v", "V", "" }, mode) then
+	if main_config.mode == "visual" then
 		vim.api.nvim_win_call(window, function ()
 			local f, t = vim.fn.getpos("v"), vim.fn.getpos(".");
 

lua/bars/statusline.lua

@@ -8,6 +8,8 @@ statusline.config = {
 	ignore_buftypes = {},
 
 	default = {
+		---|fS "Default configuration"
+
 		parts = {
 			{
 				kind = "mode",
@@ -204,6 +206,12 @@ statusline.config = {
 			},
 			{
 				kind = "ruler",
+				mode = function ()
+					local mode = vim.api.nvim_get_mode().mode;
+					local visual_modes = { "v", "V", "" };
+
+					return vim.list_contains(visual_modes, mode) and "visual" or "normal";
+				end,
 
 				default = {
 					padding_left = " ",
@@ -222,8 +230,12 @@ statusline.config = {
 				}
 			}
 		}
+
+		---|fE
 	},
 	["help"] = {
+		---|fS "Help statusline"
+
 		condition = function (buffer)
 			return vim.bo[buffer].buftype == "help";
 		end,
@@ -334,6 +346,31 @@ statusline.config = {
 
 				---|fE
 			},
+			{
+				kind = "ruler",
+				condition = function ()
+					local mode = vim.api.nvim_get_mode().mode;
+					local visual_modes = { "v", "V", "" };
+
+					return vim.list_contains(visual_modes, mode);
+				end,
+
+				default = {
+					padding_left = " ",
+					padding_right = " ",
+					icon = " ",
+
+					separator = "  ",
+
+					hl = "Color6R"
+				},
+
+				visual = {
+					icon = " ",
+
+					hl = "Color6R"
+				}
+			},
 			{
 				kind = "bufname",
 				condition = function (_, win)
@@ -374,6 +411,8 @@ statusline.config = {
 			},
 			{ kind = "empty", hl = "Normal" },
 		}
+
+		---|fE
 	}
 	-- ["lua"] = {
 	-- 	condition = function (buffer)

lua/definitions/statusline.lua

@@ -352,6 +352,12 @@
 --- What kind of component is this?
 ---@field kind "ruler"
 ---
+--- Should visual modes be shown
+---@field mode
+---| "normal" Show cursor position.
+---| "visual" Show selection size.
+---| fun(buffer: integer, window: integer): ( "normal" | "visual" )
+---
 --- Default configuration.
 ---@field default ruler.opts
 ---