feat: Custom statusline for help files

Author: OXY2DEV

lua/bars/highlights.lua

@@ -1013,6 +1013,82 @@ hl.groups = {
 
 		---|fE
 	end,
+
+	help_gradient = function ()
+		---|fS
+
+		---@type number, number, number Background color.
+		local ML, MA, MB = hl.rgb_to_oklab(
+			hl.num_to_rgb(
+				hl.get_attr("bg", { "StatusLine", "Normal" }) or hl.choice(15725045, 1973806)
+			)
+		);
+
+		ML = ML * 1.5;
+		MA = MA * 1.5;
+		MB = MB * 1.5;
+
+		---@type number, number, number Background color.
+		local BL, BA, BB = hl.rgb_to_oklab(
+			hl.num_to_rgb(
+				hl.get_attr("bg", { "StatusLine", "Normal" }) or hl.choice(15725045, 1973806)
+			)
+		);
+
+		local gradient = {};
+		local qf_steps = 15;
+
+		for s = 0, qf_steps - 1, 1 do
+			---|fS
+
+			local GL, GA, GB = hl.interpolate(
+				ML, MA, MB,
+				BL, BA, BB,
+				s / (qf_steps - 1)
+			);
+
+			local next_color;
+
+			if s ~= 0 then
+				next_color = string.format(
+					"#%02x%02x%02x",
+					hl.oklab_to_rgb(
+						hl.interpolate(
+							ML, MA, MB,
+							BL, BA, BB,
+							(s - 1) / (qf_steps - 1)
+						)
+					)
+				);
+			end
+
+			table.insert(gradient, {
+				group_name = "BarsHelp" .. (s + 1),
+				value = {
+					bg = string.format("#%02x%02x%02x", hl.oklab_to_rgb(GL, GA, GB)),
+					fg = next_color
+				}
+			});
+
+			---|fE
+		end
+
+		return vim.list_extend(gradient, {
+			{
+				group_name = "BarsHelp",
+				value = {
+					bg = string.format("#%02x%02x%02x", hl.oklab_to_rgb(ML, MA, MB)),
+					fg = string.format("#%02x%02x%02x", hl.oklab_to_rgb(
+						hl.visible_fg(ML)
+					)),
+
+					bold = true
+				}
+			}
+		});
+
+		---|fE
+	end,
 };
 
 hl.setup = function ()

lua/bars/statusline.lua

@@ -395,16 +395,11 @@ statusline.config = {
 			return vim.bo[buffer].buftype == "help";
 		end,
 		components = {
-			{ kind = "empty" },
-			TEMPLATES.mode,
+			vim.tbl_extend("force", TEMPLATES.mode, {
+				compact = true
+			}),
 			{
 				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 = " ",
@@ -413,17 +408,39 @@ statusline.config = {
 
 					separator = " 󰇛 ",
 
-					hl = "BarsRuler"
+					hl = "BarsFt0"
 				},
+			},
+			{ kind = "empty", hl = "StatusLine" },
+			{
+				kind = "custom",
+				value = function ()
+					local text = "";
 
-				visual = {
-					icon = " ",
+					for i = 15, 2, -1 do
+						text = text .. string.format("%%#BarsHelp%d#", i);
+						text = text .. "▟";
+					end
 
-					hl = "BarsRuler"
-				}
+					return text;
+				end
+			},
+			{
+				kind = "bufname",
+				max_len = 25,
+
+				default = {
+					padding_left = " ",
+					padding_right = " ",
+
+					icon = "",
+					nomodifiable_icon_hl = "BarsFt1",
+					nomodifiable_icon = "󰌾 ",
+					icon_hl = {
+						"BarsFt0", "BarsFt1", "BarsFt2", "BarsFt3", "BarsFt4", "BarsFt5", "BarsFt6"
+					},
+				},
 			},
-			TEMPLATES.bufname,
-			{ kind = "empty", hl = "StatusLine" },
 		}
 
 		---|fE
@@ -654,4 +671,3 @@ statusline.setup = function (config)
 end
 
 return statusline;
---- vim:foldmethod=markers:

plugin/bars.lua

@@ -1,7 +1,14 @@
 ---@diagnostic disable: undefined-field
 
+---|fS "chore: Cache default values"
+
 vim.g.__statusline = vim.api.nvim_get_option_value("statusline", { scope = "global" });
 vim.g.__statuscolumn = vim.o.statuscolumn;
+vim.g.__winbar = vim.api.nvim_get_option_value("winbar", { scope = "global" });
+
+vim.g.__tabline = vim.o.tabline;
+
+---|fE
 
 --- Update the tab list when opening new windows.
 vim.api.nvim_create_autocmd({ "VimEnter" }, {
@@ -15,12 +22,13 @@ vim.api.nvim_create_autocmd({ "VimEnter" }, {
 		require("bars.statusline").start();
 		require("bars.winbar").start();
 
-		require("bars.tabline").attach();
+		require("bars.tabline").start();
 	end
 });
 
 ---@type table Timer for the update task.
 local timer = vim.uv.new_timer();
+
 ---@type integer Debounce delay.
 local DELAY = 100;
 
@@ -64,20 +72,13 @@ vim.api.nvim_create_autocmd({
 	end
 });
 
-
 local mode_timer = vim.uv.new_timer();
 
 --- Update various bars & lines on Vim mode change.
 vim.api.nvim_create_autocmd({ "ModeChanged" }, {
 	callback = function ()
 		mode_timer:stop();
-
-		--- We wrap this in `vim.schedule()` so
-		--- that the update happens after doing
-		--- something like,
 		mode_timer:start(DELAY, 0, vim.schedule_wrap(function ()
-			--- Unstable API function.
-			--- Use `pcall()`
 			pcall(vim.api.nvim__redraw, {
 				statuscolumn = true,
 				winbar = true,
@@ -87,22 +88,9 @@ vim.api.nvim_create_autocmd({ "ModeChanged" }, {
 	end
 });
 
-
-
-
-
-
-
-
-
-
-
-
---- Update the tab list when opening new windows.
+--- Update the tab list when opening new tabs.
 vim.api.nvim_create_autocmd({ "TabNew" }, {
 	callback = function ()
-		---|fS
-
 		local max = vim.g.__tabline_max_tabs or 5;
 		local tabs = #vim.api.nvim_list_tabpages();
 
@@ -116,31 +104,13 @@ vim.api.nvim_create_autocmd({ "TabNew" }, {
 		end
 
 		vim.g.__bars_tabpage_from = math.max(1, tabs - math.floor(max * 0.25));
-		---|fE
 	end
 });
 
 --- Update the tab list when opening new windows.
 vim.api.nvim_create_autocmd({ "ColorScheme" }, {
 	callback = function ()
-		---|fS
-
-		---|fS "Cache default values."
-
-		vim.g.__statusline = vim.o.statusline;
-
-		vim.g.__relativenumber = vim.o.relativenumber;
-		vim.g.__numberwidth = vim.o.numberwidth;
-		vim.g.__statuscolumn = vim.o.statuscolumn;
-
-		vim.g.__winbar = vim.o.winbar;
-		vim.g.__tabline = vim.o.tabline;
-
-		---|fE
-
 		require("bars.highlights").setup();
-
-		---|fE
 	end
 });
 
@@ -361,7 +331,7 @@ vim.api.nvim_create_autocmd("LspProgress", {
 					set_state(nil);
 				end
 
-				vim.api.nvim__redraw({ statusline = true });
+				vim.cmd("redrawstatus");
 			end, 500);
 		end