-- luacheck: push ignore
--/*******************/ IMPORTS /*************************/--

-- File init

local tabsFrame = NysTDL.tabsFrame
NysTDL.tabsFrame = tabsFrame

-- Primary aliases

local libs = NysTDL.libs
local enums = NysTDL.enums
local utils = NysTDL.utils
local widgets = NysTDL.widgets
local database = NysTDL.database
local mainFrame = NysTDL.mainFrame
local dataManager = NysTDL.dataManager
local tutorialsManager = NysTDL.tutorialsManager

-- Secondary aliases

local L = libs.L

--/*******************************************************/--

-- // Variables
local private = {}
tabsFrame.authorized = true -- can it call Refresh() ? (just there for optimization)

--** UI pos control **--
local overflowButtonSize = 31
local listButtonWidgetHeight = 12

local rightEdgeOffset = -2
local inBetweenTabOffset = 5 -- POSITIVE, is part of the real tab size
local sidesBonusOffset = 2 -- POSITIVE
local MIN_TAB_SIZE, MAX_TAB_SIZE = 72, 90
local leftScrollFrameOffset = sidesBonusOffset + inBetweenTabOffset + 5
local rightScrollFrameOffset = sidesBonusOffset
local overflowButtonRightOffsetX = rightScrollFrameOffset + inBetweenTabOffset
local overflowButtonOffsetY = 2
local overflowButtonWidth = overflowButtonRightOffsetX + overflowButtonSize
local inBetweenButtonOffset = 5
local selectedTabBackdropWidth = 2
local selectedTabBackdropHeight = 9
local unselectedTabBackdropWidth = 2
local unselectedTabBackdropHeight = 2
local selectedTabBackdropOffsetX = -1
local unselectedTabBackdropOffsetX = -1
local selectedTabBackdropOffsetY = 4
local unselectedTabBackdropOffsetY = 4
local tabsOffsetY = 1

if not utils:IsDF() then -- classic
	overflowButtonSize = 30
	inBetweenTabOffset = -12
	sidesBonusOffset = 10
	MIN_TAB_SIZE, MAX_TAB_SIZE = 90, 110
	leftScrollFrameOffset = sidesBonusOffset - 5
	rightScrollFrameOffset = sidesBonusOffset
	overflowButtonRightOffsetX = rightScrollFrameOffset
	overflowButtonWidth = overflowButtonRightOffsetX + overflowButtonSize
	selectedTabBackdropWidth = -17
	selectedTabBackdropHeight = 0
	unselectedTabBackdropWidth = -17
	unselectedTabBackdropHeight = -1
	selectedTabBackdropOffsetX = 9
	unselectedTabBackdropOffsetX = 9
	selectedTabBackdropOffsetY = 4
	unselectedTabBackdropOffsetY = 4
	tabsOffsetY = 0
end
--** ************** **--

local _currentID = 0
local _nbWholeTabsShown, _shownWholeTabs = 0, {}
local _width = MAX_TAB_SIZE

local scrollFrame, content, overflowButtonFrame, overflowList, switchStateButtonFrame
local tabWidgets, listButtonWidgets = {}, {}

-- // WoW & Lua APIs

local wipe, pairs, ipairs = wipe, pairs, ipairs
local PanelTemplates_TabResize = PanelTemplates_TabResize
local PanelTemplates_SetTab = PanelTemplates_SetTab
-- local CreateFrame = CreateFrame

--[[
	Basically, the way this works is at follows:

	There is a parent <scrollFrame> (with a HORIZONTAL scrolling),
	showing the <content> frame which itself holds each of the <tabWidgets> one after another.

	On the right of the <scrollFrame>, there is a <overflowButtonFrame> that when clicked on,
	toggles the <overflowList> that shows each of the tabs that are not currently shown in the <scrollFrame>.
]]

MAX_TAB_SIZE = MAX_TAB_SIZE + inBetweenTabOffset
MIN_TAB_SIZE = MIN_TAB_SIZE + inBetweenTabOffset

local function getTabLeft(tabWidget)
	local offset = utils:IsDF() and 0 or 6
	return tabWidget:GetLeft() + offset
end

local function getTabRight(tabWidget)
	local offset = utils:IsDF() and inBetweenTabOffset or -6
	return tabWidget:GetRight() + offset + rightEdgeOffset
end

--/*******************/ ANIMATION /*************************/--

local animFrame = CreateFrame("Frame", nil, UIParent) -- OnUpdate frame
local ANIM_SPEED = 5
local animating = false
local _targetTab

function private:Event_AnimFrame_OnUpdate(elapsed)
	local totalDistanceNeeded, sign = private:GetScrollDistanceNeeded(_targetTab)

	if totalDistanceNeeded < 1.0 then
		tabsFrame:Refresh()
		return
	end

	totalDistanceNeeded = totalDistanceNeeded + 5 -- the secret to make it look nice

	local distanceNoCap = totalDistanceNeeded * elapsed * ANIM_SPEED
	local distanceToMove = (totalDistanceNeeded > 0) and math.min(totalDistanceNeeded, distanceNoCap) or math.max(totalDistanceNeeded, distanceNoCap)

	private:ScrollTo(math.max(scrollFrame:GetHorizontalScroll() + distanceToMove*sign, 0))
end

function private:StartAnim()
	if not animating then
		animating = true
		animFrame:SetScript("OnUpdate", private.Event_AnimFrame_OnUpdate)
	end
end

function private:StopAnim()
	if animating then
		animating = false
		animFrame:SetScript("OnUpdate", nil)
	end
end

function private:ScrollToTab(tabID)
	private:StopAnim()

	if private:GetScrollDistanceNeeded(tabID) < 1.0 then
		tabsFrame:Refresh()
		return
	end

	_targetTab = tabID
	private:StartAnim()
end

--/*******************/ MISC /*************************/--

function private:GetScrollDistanceNeeded(targetTabID)
	-- returns the amount of scrolling we have to add to the current scroll of the scrollframe,
	-- to INCLUDE the specified tab
	-- @return distance, sign

	if not tabWidgets[targetTabID] or not tabWidgets[targetTabID]:GetLeft() then
		return 0, 1
	end

	local tLeft, sLeft = getTabLeft(tabWidgets[targetTabID]), scrollFrame:GetLeft()
	local tRight, sRight = getTabRight(tabWidgets[targetTabID]), scrollFrame:GetRight()
	if tLeft < sLeft then
		-- the target tab is to the left, thus we have to scroll backwards until we match the LEFT position of the tab widget
		return math.abs(tLeft - sLeft), -1
	elseif tRight > sRight then
		-- the target tab is to the right, thus we have to scroll forward until we match the RIGHT position of the tab widget
		return math.abs(tRight - sRight), 1
	else
		return 0, 1
	end
end

function private:GetLeftMostTab()
	-- to know where we are in the scrollFrame
	-- returns the tabID of the found tab
	local scrollFrameLeft = scrollFrame:GetLeft()
	local tabsList = select(3, dataManager:GetData(database.ctabstate()))
	for _,tabID in ipairs(tabsList.orderedTabIDs) do -- in order, we check which is the first to be ENTIRELY (whole tab) on the right of the scrollFrame's left
		if tabWidgets[tabID] and tabWidgets[tabID]:GetLeft() then
			if getTabLeft(tabWidgets[tabID])+15 > scrollFrameLeft then
				return tabID
			end
		end
	end
	return select(2, next(tabsList.orderedTabIDs)) -- by default, if there are no tabs (specific cases), we return litterally the first tab
end

function private:RefreshShownWholeTabs()
	-- refreshes a table, containing in order the tabIDs of the found whole tabs

	wipe(_shownWholeTabs)

	local leftTab = private:GetLeftMostTab()
	local loc, pos = dataManager:GetPosData(leftTab)

	-- I'm betting on the fact that tabs are sorted, so I only need to know so much
	table.insert(_shownWholeTabs, leftTab)
	for i=1,_nbWholeTabsShown-1 do
		table.insert(_shownWholeTabs, loc[pos+i]) -- *specific
	end

	-- *specific:
	-- in a specific instance (when deleting and not on the leftMostMost tab)
	-- we will insert nil into _shownWholeTabs, and there will be less
	-- shown tabs than _nbWholeTabsShown, so we just snap left to fill the space
	if #_shownWholeTabs < _nbWholeTabsShown then
		local diff = _nbWholeTabsShown - #_shownWholeTabs
		private:SnapToTab(loc[math.max(pos-diff, 1)])
	end
end

function private:ScrollTo(pos) -- replacement for scrollFrame:SetHorizontalScroll
	scrollFrame:SetHorizontalScroll(pos)
	private:OnTabsMoving()
	if scrollFrame:IsMouseOver() then -- custom (if we hover during the anim)
		private:SetTabWidgetsContentAlpha(NysTDL.acedb.profile.frameContentAlpha/100, true)
	end
end

function private:SnapToTab(tabID)
	-- snaps the horizontal scroll to the left of the given tab
	if not tabWidgets[tabID] then return false end

	private:ScrollTo(0)
	local diff = getTabLeft(tabWidgets[tabID]) - scrollFrame:GetLeft()
	private:ScrollTo(math.max(diff, 0))
end

function private:IncludeTab(tabID)
	-- snaps the horizontal scroll to INCLUDE the given tab button,
	-- the difference with SnapToTab is that this one will snap to the RIGHT of the given tab,
	-- if it is after the current selection, will do nothing if the tab is already in the current selection, and snap to the left if it is before
	if not tabWidgets[tabID] then return false end
	if utils:HasValue(_shownWholeTabs, tabID) then -- if it's already shown, we have nothing to do
		return true
	end

	local firstPos = dataManager:GetPosData(private:GetLeftMostTab(), nil, true)
	local targetPos = dataManager:GetPosData(tabID, nil, true)

	local diff
	if targetPos < firstPos then -- if the tab is before the first shown one
		diff = getTabLeft(tabWidgets[tabID]) - scrollFrame:GetLeft() -- negative (go left)
	else -- if the tab is after the last one (bc it's not before the first one, and it's not currently shown)
		diff = getTabRight(tabWidgets[tabID]) - scrollFrame:GetRight() -- positive (go right)
	end
	private:ScrollTo(math.max(scrollFrame:GetHorizontalScroll() + diff, 0))
end

function private:CalculateTabSize()
	-- reused from wow's chat function (FCFDock_CalculateTabSize) for my purpose
	-- returns tabSize, hasOverflow, numWholeTabs

	local scrollSize = scrollFrame:GetParent():GetWidth() -- the default scroll size we're considering to use is the width of the tdlFrame (without considering the overflowButtonFrame)
	scrollSize = scrollSize - leftScrollFrameOffset - rightScrollFrameOffset

	local hasGlobalData = dataManager:HasGlobalData()
	if hasGlobalData then
		scrollSize = scrollSize - overflowButtonWidth + rightScrollFrameOffset -- '+ rightScrollFrameOffset' to zero the '- rightScrollFrameOffset' above
	end

	local tabsList = select(3, dataManager:GetData(database.ctabstate()))
	local numTabs = #tabsList.orderedTabIDs

	-- first, we see if we can fit all the tabs at the maximum size
	if numTabs*MAX_TAB_SIZE <= scrollSize then
		return MAX_TAB_SIZE, false, numTabs
	end

	if scrollSize/MIN_TAB_SIZE < numTabs then
		-- not everything fits, so we'll need room for the overflow button
		scrollSize = scrollSize - overflowButtonWidth + (hasGlobalData and 0 or rightScrollFrameOffset) -- '+ rightScrollFrameOffset' to zero the '- rightScrollFrameOffset' above
	end
	if scrollSize == 0 then
		return 1, numTabs > 0, 0
	end

	-- figure out how many tabs we're going to be able to fit at the minimum size
	local numWholeTabs = math.min(math.floor(scrollSize/MIN_TAB_SIZE), numTabs)
	if numWholeTabs == 0 then
		return scrollSize, true, numWholeTabs
	end

	-- how big each tab should be
	local tabSize = scrollSize/numWholeTabs
	return tabSize, (numTabs > numWholeTabs), numWholeTabs
end

function private:RefreshSize()
	-- updates the size of each tab widget depending on the list's width,
	-- also shows the overflow button if needed

	local tabSize, hasOverflow, numWholeTabs = private:CalculateTabSize()
	local leftTab = private:GetLeftMostTab()
	local tabToSnapTo = leftTab

	if numWholeTabs > _nbWholeTabsShown then
		local loc, pos = dataManager:GetPosData(leftTab)

		-- if there is enough tabs to the right, we don't change our left tab,
		-- if there are NOT enough tabs to the right, we go find more tabs left
		if not loc[pos+numWholeTabs-1] then -- if there is no more tabs to the right,
			tabToSnapTo = loc[math.max(#loc-numWholeTabs+1, 1)] -- we start from the right, and take enough tabs
		end
	end

	local tabsList = select(3, dataManager:GetData(database.ctabstate()))
	_width = tabSize-inBetweenTabOffset -- THE important line
	for _,tabID in ipairs(tabsList.orderedTabIDs) do
		if tabWidgets[tabID] then
			PanelTemplates_TabResize(tabWidgets[tabID], 0, _width)
		end
	end

	scrollFrame:ClearAllPoints()
	scrollFrame:SetPoint("TOPLEFT", mainFrame.tdlFrame, "BOTTOMLEFT", leftScrollFrameOffset, 2)

	local rightOffset = -rightScrollFrameOffset
	if hasOverflow then
		overflowButtonFrame:SetPoint("TOPRIGHT", mainFrame.tdlFrame, "BOTTOMRIGHT", -overflowButtonRightOffsetX, overflowButtonOffsetY)
		overflowButtonFrame:SetShown(true)
		rightOffset = -overflowButtonWidth
	else
		overflowButtonFrame:SetShown(false)
	end

	local hasGlobalData = dataManager:HasGlobalData()

	if hasGlobalData then
		overflowButtonFrame:SetPoint("TOPRIGHT", mainFrame.tdlFrame, "BOTTOMRIGHT", -overflowButtonWidth-inBetweenButtonOffset, overflowButtonOffsetY)
		switchStateButtonFrame:SetShown(true)

		if database.ctabstate() then
			-- global
			switchStateButtonFrame.btn.Texture:SetTexCoord(unpack(enums.icons.global.texCoords))
			switchStateButtonFrame.btn:SetSize(select(2, enums.icons.global.info()))
		else
			-- profile
			switchStateButtonFrame.btn.Texture:SetTexCoord(unpack(enums.icons.profile.texCoords))
			switchStateButtonFrame.btn:SetSize(select(2, enums.icons.profile.info()))
		end

		rightOffset = -overflowButtonWidth
	else
		switchStateButtonFrame:SetShown(false)
	end

	if hasGlobalData and hasOverflow then
		rightOffset = -overflowButtonWidth*2
	end

	scrollFrame:SetPoint("BOTTOMRIGHT", mainFrame.tdlFrame, "BOTTOMRIGHT", rightOffset+rightEdgeOffset, -40)

	private:SnapToTab(tabToSnapTo)

	private:OnTabsMoving()
end

function private:RefreshVisibility()
	-- shows/hides tabs depending on ctabstate (global/profile)

	local tabsToHide = select(3, dataManager:GetData(not database.ctabstate()))
	for tabID in pairs(tabsToHide) do
		if tabWidgets[tabID] then tabWidgets[tabID]:Hide() end
	end

	local tabsToShow = select(3, dataManager:GetData(database.ctabstate()))
	for tabID in pairs(tabsToShow) do
		if tabWidgets[tabID] then tabWidgets[tabID]:Show() end
	end
end

function private:RefreshPoints()
	-- updates the pos of each tab widget, depending on their order
	local tabsList = select(3, dataManager:GetData(database.ctabstate()))

	local lastWidget = nil
	for _,tabID in ipairs(tabsList.orderedTabIDs) do
		if tabWidgets[tabID] then
			if not lastWidget then
				tabWidgets[tabID]:SetPoint("TOPLEFT", content, "TOPLEFT", 0, tabsOffsetY)
			else
				if lastWidget ~= tabWidgets[tabID] then
					tabWidgets[tabID]:SetPoint("TOPLEFT", lastWidget, "TOPRIGHT", inBetweenTabOffset, 0)
				end
			end
			lastWidget = tabWidgets[tabID]
		end
	end

	private:OnTabsMoving()
end

function private:RefreshOverflowList()
	-- updates the pos of each ListButtonWidget, which ones are shown, and adapts the height of the overflowList
	for _,listButton in pairs(listButtonWidgets) do
		listButton:ClearAllPoints()
		listButton:Hide()
		listButton.ArrowLEFT:Hide()
		listButton.ArrowRIGHT:Hide()
	end

	local tabsList = select(3, dataManager:GetData(database.ctabstate()))
	local lastWidget, rightSide
	for _,tabID in ipairs(tabsList.orderedTabIDs) do
		if listButtonWidgets[tabID] then
			if utils:HasValue(_shownWholeTabs, tabID) then
				rightSide = true
			else -- !! if the tab is not already shown as a button under the list
				if not lastWidget then
					listButtonWidgets[tabID]:SetPoint("TOP", overflowList.content.title, "BOTTOM", 0, -5)
				else
					listButtonWidgets[tabID]:SetPoint("TOP", lastWidget, "BOTTOM", 0, -2)
				end
				listButtonWidgets[tabID]:Show()

				if rightSide then
					listButtonWidgets[tabID].ArrowRIGHT:Show()
				else
					listButtonWidgets[tabID].ArrowLEFT:Show()
				end

				lastWidget = listButtonWidgets[tabID]
			end
		end
	end

	if not lastWidget then lastWidget = overflowList.content.title end
	local top, bottom = overflowList:GetTop(), lastWidget:GetBottom()-8
	overflowList:SetHeight(top-bottom)
end

function private:OnTabsMoving()
	-- !! this must be updated only in 3 cases:
	-- --> the position (order) of the widgets changed
	-- --> the size of the widgets changed
	-- --> the horizontal scroll of the scrollFrame changed

	_nbWholeTabsShown = select(3, private:CalculateTabSize())
	private:RefreshShownWholeTabs()
	if overflowList:IsShown() then -- if the overflow list is shown for some reason, we update it as well
		private:RefreshOverflowList()
	end
end

--/*******************/ WIDGETS /*************************/--
-- those widgets are specific to this file, so I'm putting the widgets here instead of in the widgets file

function private:TabWidget(tabID, parentFrame)
	local tabData = select(3, dataManager:Find(tabID))

	_currentID = _currentID + 1
	local parentName = parentFrame:GetName() or "NysTDL_tdlFrame"
	local tabWidget = CreateFrame("Button", parentName.."Tab"..tostring(_currentID), parentFrame, utils:IsDF() and "CharacterFrameTabTemplate" or "CharacterFrameTabButtonTemplate")

	-- // backdrop
	-- I'm adding a backdrop only for the edge, so that we still see it when we lower the frame opacity
	-- it's mimicking the tabs appeareance, so that it's almost invisible

	tabWidget.backdropClip = CreateFrame("Frame", nil, tabWidget)
	tabWidget.backdropClip:SetSize(MAX_TAB_SIZE*2, 50)
	tabWidget.backdropClip:SetPoint("TOP", tabWidget, "TOP", 0, -2)
	tabWidget.backdropClip:SetClipsChildren(true)

	tabWidget.backdrop = CreateFrame("Frame", nil, tabWidget.backdropClip, BackdropTemplateMixin and "BackdropTemplate" or nil)
	tabWidget.backdrop:SetBackdrop(enums.backdrop)
	tabWidget.backdrop.Center:SetAlpha(0)
	tabWidget.backdrop:SetBackdropBorderColor(utils:ThemeDownTo01(enums.backdropBorderColor, true))

	tabWidget:HookScript("OnDisable", function(self) -- when selected
		self.backdrop.savedWidth = selectedTabBackdropWidth
		self.backdrop.savedHeight = selectedTabBackdropHeight
		self.backdrop:ClearAllPoints()
		self.backdrop:SetPoint("TOPLEFT", self, "TOPLEFT", selectedTabBackdropOffsetX, selectedTabBackdropOffsetY)
		self.backdrop:SetSize(self:GetWidth()+self.backdrop.savedWidth, self:GetHeight()+self.backdrop.savedHeight)
	end)
	local onEnable = function(self) -- when unselected
		self.backdrop.savedWidth = unselectedTabBackdropWidth
		self.backdrop.savedHeight = unselectedTabBackdropHeight
		self.backdrop:ClearAllPoints()
		self.backdrop:SetPoint("TOPLEFT", self, "TOPLEFT", unselectedTabBackdropOffsetX, unselectedTabBackdropOffsetY)
		self.backdrop:SetSize(self:GetWidth()+self.backdrop.savedWidth, self:GetHeight()+self.backdrop.savedHeight)
	end
	tabWidget:HookScript("OnEnable", onEnable)
	onEnable(tabWidget) -- init values

	tabWidget:HookScript("OnSizeChanged", function(self)
		self.backdrop:SetSize(self:GetWidth()+self.backdrop.savedWidth, self:GetHeight()+self.backdrop.savedHeight)
	end)

	tabWidget:SetFrameLevel(tabWidget:GetFrameLevel()+1)
	tabWidget.backdropClip:SetFrameLevel(tabWidget:GetFrameLevel()-1)

	-- // data

	tabWidget.tabID = tabID
	tabWidget.tabData = tabData

	-- // UI & actions

	tabWidget:SetID(_currentID)
	tabWidget:SetText(tabData.name)
	tabWidget:SetScript("OnClick", function(self)
		mainFrame:ChangeTab(self.tabID) -- changes ctab
		private:ScrollToTab(self.tabID)
		PanelTemplates_SetTab(self:GetParent(), self:GetID())
	end)

	return tabWidget
end

function private:ListButtonWidget(tabID, parentFrame)
	local tabData = select(3, dataManager:Find(tabID))

	local listButtonWidget = CreateFrame("Button", nil, parentFrame, "NysTDL_OverflowListButton")

	-- // data

	listButtonWidget.tabID = tabID
	listButtonWidget.tabData = tabData

	-- // UI & actions

	listButtonWidget:SetText(tabData.name)
	listButtonWidget:SetSize(parentFrame:GetWidth()-12, listButtonWidgetHeight)
	listButtonWidget:SetScript("OnClick", function(self)
		tabWidgets[self.tabID]:Click()
		private:SetTabWidgetsContentAlpha(NysTDL.acedb.profile.frameContentAlpha/100, true) -- I hate this alpha problem, but whatever, this fixes it
	end)

	return listButtonWidget
end

--/*******************/ GENERAL /*************************/--

function tabsFrame:HideOverflowList()
	if overflowList then
		overflowList:Hide()
	end
end

function tabsFrame:GLOBAL_MOUSE_DOWN()
	-- to replicate the behavior of the GameTooltip
	if overflowList and not overflowList:IsMouseOver() and not overflowButtonFrame:IsMouseOver() then
		tabsFrame:HideOverflowList()
	end
end

function tabsFrame:SetScale(scale)
	-- we don't actually need the scale, the width of the tdlFrame is enough
	tabsFrame:Refresh()
end

function tabsFrame:SetAlpha(alpha)
	-- // update the alpha (background) of the tab frames

	-- tabWidgets
	for _,tabWidget in pairs(tabWidgets) do
		if tabWidget.Left and tabWidget.Middle and tabWidget.Right then
			tabWidget.Left:SetAlpha(alpha)
			tabWidget.LeftActive:SetAlpha(alpha)
			tabWidget.Middle:SetAlpha(alpha)
			tabWidget.MiddleActive:SetAlpha(alpha)
			tabWidget.Right:SetAlpha(alpha)
			tabWidget.RightActive:SetAlpha(alpha)
		else
			local name = tabWidget:GetName()
			_G[name.."Left"]:SetAlpha(alpha)
			_G[name.."LeftDisabled"]:SetAlpha(alpha)
			_G[name.."Middle"]:SetAlpha(alpha)
			_G[name.."MiddleDisabled"]:SetAlpha(alpha)
			_G[name.."Right"]:SetAlpha(alpha)
			_G[name.."RightDisabled"]:SetAlpha(alpha)
			_G[name.."HighlightTexture"]:SetAlpha(0.5+alpha/2)
		end
	end

	-- overflowButtonFrame
	if overflowButtonFrame then
		overflowButtonFrame.backdrop.Center:SetAlpha(alpha)
	end

	-- switchStateButtonFrame
	if switchStateButtonFrame then
		switchStateButtonFrame.backdrop.Center:SetAlpha(alpha)
	end

	-- overflowList
	if overflowList then
		overflowList.Center:SetAlpha(alpha)
	end
end

function private:SetTabWidgetsContentAlpha(alpha, forAll)
	if forAll then
		for _,tabWidget in pairs(tabWidgets) do
			if tabWidget.Text then
				tabWidget.Text:SetAlpha(alpha)
			else
				_G[tabWidget:GetName().."Text"]:SetAlpha(alpha)
			end
		end
	else -- doesn't go through ALL of the tab widgets, only through the shown ones
		local ctab = database.ctab()
		for _,tabID in pairs(_shownWholeTabs) do -- for each tab widget that is currently shown under the tdlFrame
			if tabWidgets[tabID] then
				if tabID ~= ctab then -- doing that one after
					if tabWidgets[tabID].Text then
						tabWidgets[tabID].Text:SetAlpha(alpha)
					else
						_G[tabWidgets[tabID]:GetName().."Text"]:SetAlpha(alpha)
					end
				end
			end
		end
		if tabWidgets[ctab] then
			-- the ctab is ALWAYS shown, even when not whole
			if tabWidgets[ctab].Text then
				tabWidgets[ctab].Text:SetAlpha(alpha)
			else
				_G[tabWidgets[ctab]:GetName().."Text"]:SetAlpha(alpha)
			end
		end
	end
end

function tabsFrame:SetContentAlpha(alpha)
	-- // update the content alpha (text) of the tab frames

	-- tabWidgets
	private:SetTabWidgetsContentAlpha(alpha, true)

	-- overflowButtonFrame
	if overflowButtonFrame then
		overflowButtonFrame.btn:SetAlpha(alpha)
	end

	-- switchStateButtonFrame
	if switchStateButtonFrame then
		switchStateButtonFrame.btn:SetAlpha(alpha)
	end

	-- overflowList
	if overflowList then
		overflowList.content:SetAlpha(alpha)
	end
end

function tabsFrame:UpdateTab(tabID)
	-- updates (create/update) the given tab's associated button

	if tabWidgets[tabID] then
		tabWidgets[tabID]:ClearAllPoints()
		tabWidgets[tabID]:Hide()
	end
	if listButtonWidgets[tabID] then
		listButtonWidgets[tabID]:ClearAllPoints()
		listButtonWidgets[tabID]:Hide()
	end

	tabWidgets[tabID] = private:TabWidget(tabID, content)
	listButtonWidgets[tabID] = private:ListButtonWidget(tabID, overflowList.content)

	-- we update the alpha for the new tab (and for everything else)
	tabsFrame:SetAlpha(NysTDL.acedb.profile.frameAlpha/100)
	tabsFrame:SetContentAlpha(NysTDL.acedb.profile.frameContentAlpha/100)

	tabsFrame:Refresh() -- refresh
end

function tabsFrame:DeleteTab(tabID)
	if tabWidgets[tabID] then
		tabWidgets[tabID]:ClearAllPoints()
		tabWidgets[tabID]:Hide()
		tabWidgets[tabID] = nil
	end

	if listButtonWidgets[tabID] then
		listButtonWidgets[tabID]:ClearAllPoints()
		listButtonWidgets[tabID]:Hide()
		listButtonWidgets[tabID] = nil
	end

	tabsFrame:Refresh() -- refresh
end

---THE function to switch tab state.
---@param state nil|boolean nil = switch, false = profile, true = global
function tabsFrame:SwitchState(state)
	local originalState = database.ctabstate()

	if state == nil then
		database.ctabstate(not database.ctabstate())
	else
		database.ctabstate(state)
	end

	if originalState == database.ctabstate() then return end

	mainFrame:ChangeTab(database.ctab())
	tabsFrame:Refresh()
end

function tabsFrame:Refresh()
	-- // we refresh EVERYTHING

	private:StopAnim()

	if not tabsFrame.authorized then return end

	-- we update the nb of tabs so that wow's API works (PanelTemplates_SetTab)
	content.numTabs = _currentID

	local currentTabID = database.ctab()

	-- we select the currently selected tab's button
	if tabWidgets[currentTabID] then
		PanelTemplates_SetTab(tabWidgets[currentTabID]:GetParent(), tabWidgets[currentTabID]:GetID())
	end

	-- refresh the shown/hidden state (global/profile)
	private:RefreshVisibility()

	-- refresh the pos
	private:RefreshPoints()

	-- refresh the size
	private:RefreshSize()

	-- and we always focus ourserves on the currently selected tab
	private:IncludeTab(currentTabID)

	-- there we update the alpha of everyone (bc maybe we're not hovering the scrollFrame, so any refresh does it as well, thanks WoW API ;)
	private:SetTabWidgetsContentAlpha(NysTDL.acedb.profile.frameContentAlpha/100, true)
end

--/*******************/ INITIALIZATION /*************************/--

function tabsFrame:CreateTabsFrame()
	-- // scrollFrame
	scrollFrame = CreateFrame("ScrollFrame", nil, mainFrame.tdlFrame, "UIPanelScrollFrameTemplate")
	-- for scrollFrame:SetPoints(), see private:RefreshSize()
	scrollFrame:SetClipsChildren(true)
	scrollFrame.ScrollBar:Hide()
	scrollFrame.ScrollBar:ClearAllPoints()
	scrollFrame:SetScript("OnShow", function()
		tabsFrame:Refresh()
	end)
	local wasMouseOver = false
	scrollFrame:SetScript("OnUpdate", function(self)
		-- tabWidgets text alpha refresh (bc when hovering over them/clicking on them,
		-- the WoW template resets the alpha to 1, so we override that)
		if self:IsMouseOver() then
			wasMouseOver = true
			-- only go through the shown tab widgets for optimization
			private:SetTabWidgetsContentAlpha(NysTDL.acedb.profile.frameContentAlpha/100)
		elseif wasMouseOver then
			wasMouseOver = false
			-- this backup update is to counter the bug that happends when we pass at high speed over the tabs
			private:SetTabWidgetsContentAlpha(NysTDL.acedb.profile.frameContentAlpha/100)
		end
	end)

	-- // animFrame
	animFrame:SetParent(mainFrame:GetFrame())

	-- // content
	content = CreateFrame("Frame", "NysTDL_tabsFrame_content", scrollFrame) -- NAME IS MANDATORY HERE (bc there are tabs)
	content:SetSize(1, 1) -- just to show everything inside of it
	scrollFrame:SetScrollChild(content)

	-- // overflowButton / overflowButtonFrame
	-- !! both overflowButtonFrame and overflowButtonFrame.backdrop are there only to beautify the button,
	-- by creating a better backdrop and masking of the border
	overflowButtonFrame = widgets:TabIconFrame(mainFrame.tdlFrame, overflowButtonSize, -overflowButtonRightOffsetX, overflowButtonOffsetY, 0, 4, 18, 12)

	overflowList = CreateFrame("Frame", nil, UIParent, BackdropTemplateMixin and "BackdropTemplate" or nil)
	overflowList:SetBackdrop(enums.backdrop)
	overflowList:SetBackdropColor(utils:ThemeDownTo01(enums.backdropColor, true))
	overflowList:SetBackdropBorderColor(utils:ThemeDownTo01(enums.backdropBorderColor, true))
	overflowList:SetPoint("TOPRIGHT", overflowButtonFrame, "BOTTOMRIGHT", 0, -8)
	overflowList:SetSize(150, 1) -- the height is updated dynamically
	overflowList:EnableMouse(true)
	overflowList:SetClampedToScreen(true)
	overflowList:SetFrameStrata("TOOLTIP")
	overflowList:SetToplevel(true)
	overflowList:Hide()

	overflowList.content = CreateFrame("Frame", nil, overflowList)
	overflowList.content:SetPoint("TOPLEFT", overflowList, "TOPLEFT")
	overflowList.content:SetPoint("BOTTOMRIGHT", overflowList, "BOTTOMRIGHT")

	overflowList.content.title = overflowList.content:CreateFontString(nil)
	overflowList.content.title:SetPoint("TOP", overflowList.content, "TOP", 0, -5)
	overflowList.content.title:SetFontObject("GameFontHighlight")
	overflowList.content.title:SetText(L["Other Tabs"])

	overflowButtonFrame.btn:SetScript("OnClick", function()
		if not overflowList:IsShown() then -- if we're about to show the list, we refresh it
			private:RefreshOverflowList()
		end

		overflowList:SetShown(not overflowList:IsShown()) -- toggles the overflowList
	end)

	-- // switchStateButton (switch global/profile)
	switchStateButtonFrame = widgets:TabIconFrame(mainFrame.tdlFrame, overflowButtonSize, -overflowButtonRightOffsetX, overflowButtonOffsetY, 0, 3)

	switchStateButtonFrame.btn:SetNormalTexture(enums.icons.global.info())
	switchStateButtonFrame.btn.Texture:SetAlpha(0.9)

	-- click
	switchStateButtonFrame.btn:SetScript("OnClick", function()
		tabsFrame:SwitchState(nil) -- toggle
	end)

	-- tuto
	tutorialsManager:SetPoint("tabSwitchState", "explainSwitchButton", "LEFT", switchStateButtonFrame, "RIGHT", 22, 0)
end

function tabsFrame:Init()
	tabsFrame.authorized = false

	-- // widgets
	-- we delete and hide each widget
	for tabID in pairs(tabWidgets) do
		tabsFrame:DeleteTab(tabID)
	end
	wipe(tabWidgets)
	wipe(listButtonWidgets)

	-- before (re)creating them
	for tabID in dataManager:ForEach(enums.tab) do
		tabsFrame:UpdateTab(tabID)
	end

	tabsFrame.authorized = true

	-- one big refresh
	tabsFrame:Refresh()
end
