doc: Added basic types

Author: OXY2DEV

lua/bars.lua

@@ -9,8 +9,8 @@ A *fancy* `bars & lines` plugin for `Neovim`.
 local bars = {};
 
 --[[ Executes an `action`. ]]
----@param action string
----@param on string[]
+---@param action bars.command
+---@param on bars.target[]
 ---@param ... any
 bars.exec = function (action, on, ...)
 	local modules = { "statusline", "statuscolumn", "winbar", "tabline" };
@@ -27,7 +27,9 @@ bars.exec = function (action, on, ...)
 	end
 end
 
+---@param config? bars.config
 bars.setup = function (config)
+	---@diagnostic disable-next-line: param-type-mismatch
 	for k, v in pairs(config) do
 		local could_load, submodule = pcall(require, "bars." .. k);
 

lua/bars/types/bars.lua

@@ -0,0 +1,27 @@
+---@meta
+
+---@alias bars.command
+---| "Disable" Disable `bar/line` for **all** windows.
+---| "Enable" Enable `bar/line` for **all** windows.
+---| "Start" Start a `bar/line`.
+---| "Stop" Stop a `bar/line`.
+---| "Toggle" Toggle `bar/line` for **all** windows.
+---| "disable" Disable `bar/line` for **specific** window.
+---| "enable" Enable `bar/line` for **specific** window.
+---| "toggle" Toggle `bar/line` for **specific** window.
+---| "update" Update *style* of a `bar/line` for **specific** window.
+
+--[[ Target for a command. ]]
+---@alias bars.target
+---| "statuscolumn"
+---| "statusline"
+---| "tabline"
+---| "winbar"
+
+--[[ Configuration for `bars.nvim`. ]]
+---@class bars.config
+---
+---@field statuscolumn? table | boolean
+---@field statusline? table | boolean
+---@field tabline? table | boolean
+---@field winbar? table | boolean