--/*******************/ IMPORTS /*************************/--

-- File init

local widgets = NysTDL.widgets
NysTDL.widgets = widgets

-- Primary aliases

local libs = NysTDL.libs
local core = NysTDL.core
local utils = NysTDL.utils
local enums = NysTDL.enums
local database = NysTDL.database
local dragndrop = NysTDL.dragndrop
local mainFrame = NysTDL.mainFrame
local tabsFrame = NysTDL.tabsFrame
local databroker = NysTDL.databroker
local dataManager = NysTDL.dataManager
local tutorialsManager = NysTDL.tutorialsManager

-- Secondary aliases

local L = libs.L
local LibQTip = libs.LibQTip
local AceTimer = libs.AceTimer

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

widgets.frame = CreateFrame("Frame", nil, UIParent) -- utility frame
local widgetsFrame = widgets.frame

local private = {}

local tdlButton
local hyperlinkEditBoxes = {}
local descFrames = { -- all opened description frames
	-- [itemID] = frame,
	-- ...
}
local descFrameInfo = {
	width = 250,
	height = 100,
	buttons = 50,
	font = "ChatFontNormal"
}

local updateRate = 0.05
local refreshRate = 1

local currentHoverFrame = nil -- only one hover frame at a time (polish)

widgets.aebShownFlags = {
	item = bit.lshift(1, 0),
	cat = bit.lshift(1, 1)
	-- ...
}
widgets.aebShown = {
	-- [catID] = <flag>
}

-- // WoW & Lua APIs

-- local PlaySound = PlaySound -- TDLATER
-- local CreateFrame = CreateFrame -- breaks external hooks?
local UIParent = UIParent
local select = select

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

-- // hyperlink edit boxes

function widgets:AddHyperlinkEditBox(editBox)
	table.insert(hyperlinkEditBoxes, editBox)
end

function widgets:RemoveHyperlinkEditBox(editBox)
	table.remove(hyperlinkEditBoxes, select(2, utils:HasValue(hyperlinkEditBoxes, editBox))) -- removing the ref of the hyperlink edit box
end

function widgets:SetEditBoxesHyperlinksEnabled(enabled)
	-- IMPORTANT: this code is to activate hyperlink clicks in edit boxes such as the ones for adding new items in categories,
	-- I disabled this for practical reasons: it's easier to write new item names in them if we can click on the links without triggering the hyperlink (and it's not very useful anyways :D).

	for _, editBox in pairs(hyperlinkEditBoxes) do
		widgets:SetHyperlinksEnabled(editBox, enabled)
	end
end

function widgets:EditBoxInsertLink(text)
	-- when we shift-click on things, we hook the link from the chat function,
	-- and add it to the one of my edit boxes who has the focus (if there is one)
	-- basically, it's what allows hyperlinks in my addon edit boxes
	for _, v in pairs(hyperlinkEditBoxes) do
		if v and v:IsVisible() and v:HasFocus() then
			v:Insert(text)
			return true
		end
	end
end

-- // description frames

function widgets:GetDescFrames()
	return descFrames
end

function widgets:SetDescFramesAlpha(alpha)
	-- first we update (or not) the saved variable
	if NysTDL.acedb.profile.affectDesc then
		NysTDL.acedb.profile.descFrameAlpha = alpha
	end

	-- and then we update the alpha
	alpha = NysTDL.acedb.profile.descFrameAlpha/100
	for _, descFrame in pairs(descFrames) do -- we go through every desc frame
		descFrame.Center:SetAlpha(alpha)
		for k, x in pairs(descFrame.descriptionEditBox) do
			-- setting the backdrop alpha is not enough, we also have to change the alpha of the big edit box,
			-- the thing is that this template (from WoW) uses A LOT of sub-frames to make up that edit box,
			-- as well as other frames for the char count, etc, so we have to find all of the edit box frames,
			-- and set the alpha for each one
			if type(k) == "string" then
				if string.sub(k, k:len()-2, k:len()) == "Tex" then -- fortunately, they all end up with the letters "Tex" ("LeftTex", "RightTex", ...)
					x:SetAlpha(alpha)
				end
			end
		end
	end
end

function widgets:SetDescFramesContentAlpha(alpha)
	-- first we update (or not) the saved variable
	if NysTDL.acedb.profile.affectDesc then
		NysTDL.acedb.profile.descFrameContentAlpha = alpha
	end

	-- and then we update the alpha
	alpha = NysTDL.acedb.profile.descFrameContentAlpha/100
	for _, descFrame in pairs(descFrames) do -- we go through every desc frame
		descFrame.title:SetAlpha(alpha)
		descFrame.closeButton:SetAlpha(alpha)
		descFrame.clearButton:SetAlpha(alpha)
		descFrame.descriptionEditBox.EditBox:SetAlpha(alpha)
		descFrame.descriptionEditBox.ScrollBar:SetAlpha(alpha)
		descFrame.resizeButton:SetAlpha(alpha)
	end
end

function widgets:UpdateDescFramesTitle()
	-- refreshes the name & name color of each description frame
	-- (also useful to update the names when renaming items)
	local contentWidgets = mainFrame:GetContentWidgets()
	for _, descFrame in pairs(descFrames) do -- we go through each of them
		if contentWidgets[descFrame.itemID] then -- if the corresponding item still exists (i'm not sure if it's necessary, but it's just there in case it is)
			descFrame.title:SetText(descFrame.itemData.name)
			descFrame.title:SetTextColor(contentWidgets[descFrame.itemID].interactiveLabel.Text:GetTextColor())
			descFrame.title:SetAlpha(NysTDL.acedb.profile.descFrameContentAlpha/100)
			ExecuteFrameScript(descFrame.widthFrame, "OnSizeChanged", descFrame.widthFrame:GetWidth())
		end
	end
end

function widgets:DescFrameHide(itemID)
	-- we hide and delete the description frame of itemID if it exists
	local frame = descFrames[itemID]

	if frame then
		frame:Hide()
		frame:ClearAllPoints()
		widgets:RemoveHyperlinkEditBox(frame.descriptionEditBox.EditBox)
		descFrames[itemID] = nil
		return true
	end

	return false
end

function widgets:WipeDescFrames()
	-- resets every desc frame
	for _, frame in pairs(descFrames) do
		frame:Hide()
		frame:ClearAllPoints()
		widgets:RemoveHyperlinkEditBox(frame.descriptionEditBox.EditBox)
	end
	wipe(descFrames)
end

function widgets:DescriptionFrame(itemWidget)
	-- // the big function to create the description frame for each item

	local itemID = itemWidget.itemID
	local itemData = select(3, dataManager:Find(itemID))

	-- first we check if it's already opened, in which case we act as a toggle, and hide it
	if widgets:DescFrameHide(itemID) then return end

	-- // creating the frame and all of its content

	-- we create the mini frame holding the name of the item and his description in an edit box
	local descFrame = CreateFrame("Frame", nil, UIParent, BackdropTemplateMixin and "BackdropTemplate" or nil)

	-- background
	descFrame:SetBackdrop(enums.backdrop)
	descFrame:SetBackdropColor(utils:ThemeDownTo01(enums.backdropColor, true))
	descFrame:SetBackdropBorderColor(utils:ThemeDownTo01(enums.backdropBorderColor, true))

	-- quick access
	descFrame.itemID = itemID
	descFrame.itemData = itemData

	-- properties
	descFrame:SetFrameStrata(NysTDL.acedb.profile.frameStrata)
	descFrame:EnableMouse(true)
	descFrame:SetMovable(true)
	descFrame:SetClampedToScreen(true)
	descFrame:SetResizable(true)
	descFrame:SetToplevel(true)
	if not utils:IsDF() then
		descFrame:SetScale(0.95)
	end

	-- to move the frame
	descFrame:SetScript("OnMouseDown", function(self, button)
		if button == "LeftButton" then
			self:StartMoving()
		end
	end)
	descFrame:SetScript("OnMouseUp", descFrame.StopMovingOrSizing)

	-- OnUpdate script
	descFrame.opening = 0 -- for the scrolling up on opening
	descFrame:SetScript("OnUpdate", function(self)
		-- we update non-stop the width of the description edit box to match that of the frame if we resize it, and when the scrollbar kicks in. (this is the secret to make it work)
		self.descriptionEditBox.EditBox:SetWidth(self.descriptionEditBox:GetWidth() - (self.descriptionEditBox.ScrollBar:IsShown() and 15 or 0))

		if self.opening < 5 then -- doing this only on the 5 first updates after creating the frame, I won't go into the details but updating the vertical scroll of this template is a real fucker :D
			self.descriptionEditBox:SetVerticalScroll(0)
			self.opening = self.opening + 1
		end
	end)

	-- / content of the frame / --

	-- / resize button
	descFrame.resizeButton = widgets:IconTooltipButton(descFrame, "NysTDL_TooltipResizeButton", {string.format("|cff%s%s|r", utils:RGBToHex(database.themes.theme), L["Left-Click"])..utils:GetMinusStr()..L["Resize"], string.format("|cff%s%s|r", utils:RGBToHex(database.themes.theme), L["Right-Click"])..utils:GetMinusStr()..L["Reset"]})
	descFrame.resizeButton:SetPoint("BOTTOMRIGHT")
	descFrame.resizeButton:SetScript("OnMouseDown", function(self, button)
		if button == "LeftButton" then
			descFrame:StartSizing("BOTTOMRIGHT")
			self:GetHighlightTexture():Hide() -- more noticeable
			if self.tooltip and self.tooltip.Hide then self.tooltip:Hide() end
		end
	end)
	descFrame.resizeButton:SetScript("OnMouseUp", function(self, button)
		if button == "LeftButton" then
			descFrame:StopMovingOrSizing()
			self:GetHighlightTexture():Show()
			if self.tooltip and self.tooltip.Show then self.tooltip:Show() end
		end
	end)
	descFrame.resizeButton:SetScript("OnHide", function(self)  -- same as on mouse up, just security
		self:GetScript("OnMouseUp")(self, "LeftButton")
	end)
	descFrame.resizeButton:RegisterForClicks("RightButtonUp")
	descFrame.resizeButton:HookScript("OnClick", function(self) -- reset size
		self:GetScript("OnMouseUp")(self, "LeftButton")
		descFrame:SetSize(descFrameInfo.width, descFrameInfo.height+descFrame.heightFrame:GetHeight())
	end)

	-- / close button
	descFrame.closeButton = CreateFrame("Button", nil, descFrame, "NysTDL_CloseButton")
	descFrame.closeButton:SetPoint("TOPRIGHT", descFrame, "TOPRIGHT", -4, -3)
	descFrame.closeButton:SetScript("OnClick", function() widgets:DescFrameHide(itemID) end)

	-- / clear button
	descFrame.clearButton = widgets:IconTooltipButton(descFrame, "NysTDL_ClearButton", L["Clear"].." ("..string.format("|cff%s%s|r", utils:RGBToHex(database.themes.theme), L["Right-Click"])..")")
	descFrame.clearButton:SetPoint("TOPRIGHT", descFrame.closeButton, "TOPLEFT", 2, 0)
	descFrame.clearButton:RegisterForClicks("RightButtonUp") -- only responds to right-clicks
	descFrame.clearButton:SetScript("OnClick", function(self)
		self:GetParent().descriptionEditBox.EditBox:SetText("")
	end)

	-- / item name label
	widgets:SetHyperlinksEnabled(descFrame, true)
	descFrame.widthFrame = CreateFrame("Frame", nil, descFrame)
	descFrame.widthFrame:SetPoint("TOPLEFT", descFrame, "TOPLEFT", 7, -6)
	descFrame.widthFrame:SetPoint("TOPRIGHT", descFrame, "TOPRIGHT", -7-descFrameInfo.buttons, -6)
	descFrame.widthFrame:SetHeight(1)

	descFrame.heightFrame = CreateFrame("Frame", nil, descFrame.widthFrame)
	descFrame.heightFrame:SetPoint("TOPLEFT", descFrame.widthFrame)
	descFrame.heightFrame:SetWidth(1)

	descFrame.title = descFrame:CreateFontString(nil)
	descFrame.title:SetFontObject("GameFontNormalLarge")
	descFrame.title:SetPoint("TOPLEFT", descFrame.widthFrame)
	descFrame.title:SetText(itemData.name)
	descFrame.title:SetTextColor(itemWidget.interactiveLabel.Text:GetTextColor())
	descFrame.title:SetJustifyV("TOP")
	descFrame.title:SetJustifyH("LEFT")
	descFrame.title:SetMaxLines(enums.maxWordWrapLines)

	descFrame.widthFrame:SetScript("OnSizeChanged", function(self, width)
		if width < 18 then width = 18 end
		descFrame.title:SetWidth(width)
		descFrame.heightFrame:SetHeight(descFrame.title:GetStringHeight())

		local minHeight = descFrameInfo.height+descFrame.heightFrame:GetHeight()
		descFrame:SetHeight(math.max(minHeight, descFrame:GetHeight()))
		if descFrame.SetResizeBounds then
			descFrame:SetResizeBounds(75, minHeight, enums.tdlFrameMaxWidth, enums.tdlFrameMaxHeight)
		else
			descFrame:SetMinResize(75, minHeight)
			descFrame:SetMaxResize(enums.tdlFrameMaxWidth, enums.tdlFrameMaxHeight)
		end
	end)

	-- / size
	descFrame:SetWidth(descFrameInfo.width)
	ExecuteFrameScript(descFrame.widthFrame, "OnSizeChanged", descFrame.widthFrame:GetWidth())

	-- / position
	descFrame:SetPoint("BOTTOMRIGHT", itemWidget.descBtn, "TOPRIGHT", 0, 0) -- we spawn it basically where we clicked

	-- to unlink it from the itemWidget
	AceTimer:ScheduleTimer(function() -- next frame
		descFrame:StartMoving()
		descFrame:StopMovingOrSizing()
	end, 0)

	-- / description edit box
	descFrame.descriptionEditBox = CreateFrame("ScrollFrame", nil, descFrame, "NysTDL_InputScrollFrameTemplate")
	descFrame.descriptionEditBox:SetPoint("TOP", descFrame.heightFrame, "BOTTOM", 0, -10)
	descFrame.descriptionEditBox:SetPoint("LEFT", descFrame, "LEFT", 10, 0)
	descFrame.descriptionEditBox:SetPoint("BOTTOMRIGHT", descFrame, "BOTTOMRIGHT", -10, 10)
	descFrame.descriptionEditBox.EditBox:SetFontObject(descFrameInfo.font)
	descFrame.descriptionEditBox.EditBox:SetAutoFocus(false)
	descFrame.descriptionEditBox.EditBox:SetTextInsets(0, 0, 0, 16) -- secret #2 ;)

	-- /-> char count
	descFrame.descriptionEditBox.EditBox:SetMaxLetters(enums.maxDescriptionCharCount)
	descFrame.descriptionEditBox.CharCount:Hide()

	-- /-> hint
	descFrame.descriptionEditBox.EditBox.Instructions:SetFontObject("GameFontNormal")
	descFrame.descriptionEditBox.EditBox.Instructions:SetText(L["Add a description"].."...\n("..L["Automatically saved"]..")")
	descFrame.descriptionEditBox.EditBox.Instructions:SetPoint("RIGHT", descFrame.descriptionEditBox.EditBox)

	-- /-> scripts
	descFrame.descriptionEditBox.EditBox:HookScript("OnTextChanged", function(self)
		-- and here we save the description everytime the text is updated (best auto-save possible I think)
		dataManager:UpdateDescription(itemID, self:GetText())
	end)
	widgets:SetHyperlinksEnabled(descFrame.descriptionEditBox.EditBox, true)
	widgets:AddHyperlinkEditBox(descFrame.descriptionEditBox.EditBox)

	-- /-> default value
	if itemData.description then -- if there is already a description for this item, we write it on frame creation
		descFrame.descriptionEditBox.EditBox:SetText(itemData.description)
	end

	-- init width
	descFrame.descriptionEditBox.EditBox:SetWidth(descFrame.descriptionEditBox:GetWidth() - (descFrame.descriptionEditBox.ScrollBar:IsShown() and 15 or 0))

	descFrames[itemID] = descFrame -- we save it for access, hide, and alpha purposes

	-- // finished creating the frame

	-- we update the alpha if it needs to be
	mainFrame:Event_FrameAlphaSlider_OnValueChanged(NysTDL.acedb.profile.frameAlpha)
	mainFrame:Event_FrameContentAlphaSlider_OnValueChanged(NysTDL.acedb.profile.frameContentAlpha)
end

-- // tdl button

function widgets:RefreshTDLButton()
	-- // to refresh everything concerbing the tdl button

	-- updating its position and shown state in accordance to the saved variables
	local points = NysTDL.acedb.profile.tdlButton.points
	tdlButton:ClearAllPoints()
	tdlButton:SetPoint(points.point, nil, points.relativePoint, points.xOffset, points.yOffset) -- relativeFrame = nil -> entire screen
	tdlButton:SetShown(NysTDL.acedb.profile.tdlButton.show)

	-- and updating its color
	widgets:UpdateTDLButtonColor()
end

function widgets:UpdateTDLButtonColor()
	-- the TDL button red option, if any tab has a reset in less than 24 hours,
	-- and also has unchecked items, we color in red the text of the tdl button

	tdlButton:SetNormalFontObject("GameFontNormalLarge") -- by default, we reset the color of the TDL button to yellow
	if NysTDL.acedb.profile.tdlButton.red then -- if the option is checked
		local maxTime = time() + 86400
		dataManager:DoIfFoundTabMatch(maxTime, "totalUnchecked", function()
			-- we color the button in red
			tdlButton:SetNormalFontObject("NysTDL_GameFontNormalLarge_Red")
		end)
	end
end

-- // other

function widgets:SetFocusEditBox(editBox, forceHighlight) -- DRY
	editBox:SetFocus()
	if forceHighlight or NysTDL.acedb.profile.highlightOnFocus then
		editBox:HighlightText()
	else
		editBox:HighlightText(0, 0)
	end
end

function widgets:GetWidth(text, font)
	-- not the length (#) of a string, but the width it takes when placed on the screen as a font string
	local l = widgets:NoPointsLabel(UIParent, nil, text, font)

	local width = l:GetWidth()
	l:Hide()

	return width
end

function widgets:SetHyperlinksEnabled(frame, enabled)
	if enabled then
		frame:SetHyperlinksEnabled(true) -- to enable OnHyperlinkClick
		frame:SetScript("OnHyperlinkClick", function(_, linkData, link, button)
			SetItemRef(linkData, link, button)
		end)
	else
		frame:SetHyperlinksEnabled(false) -- to disable OnHyperlinkClick
		frame:SetScript("OnHyperlinkClick", nil)
	end
end

--/*******************/ FRAMES /*************************/--

function widgets:TutorialFrame(tutoCategory, tutoName, showCloseButton, arrowSide, text, width)
	local tutoFrame = CreateFrame("Frame", "NysTDL_TutorialFrame_"..tutoCategory.."_"..tutoName, UIParent, "NysTDL_HelpPlateTooltip") -- TDLATER POLISH check if name is mandatory, also checl ALL addon names for the same thing
	tutoFrame.Text:SetText(text)
	tutoFrame.Text:SetWidth(width-15-15)

	tutoFrame.SetArrowSide = function(self, arrowSide)
		tutoFrame.ArrowDOWN:Hide()
		tutoFrame.ArrowUP:Hide()
		tutoFrame.ArrowRIGHT:Hide()
		tutoFrame.ArrowLEFT:Hide()
		if arrowSide == "UP" then tutoFrame.ArrowDOWN:Show()
		elseif arrowSide == "DOWN" then tutoFrame.ArrowUP:Show()
		elseif arrowSide == "LEFT" then tutoFrame.ArrowRIGHT:Show()
		elseif arrowSide == "RIGHT" then tutoFrame.ArrowLEFT:Show() end
	end
	tutoFrame:SetArrowSide(arrowSide)

	if showCloseButton then
		tutoFrame.closeButton = CreateFrame("Button", nil, tutoFrame, "UIPanelCloseButton")
		tutoFrame.closeButton:SetFrameLevel(tutoFrame:GetFrameLevel()+1)
		tutoFrame.closeButton:SetPoint("TOPRIGHT", tutoFrame, "TOPRIGHT", 4, 4)
		tutoFrame.closeButton:SetScript("OnClick", function() tutorialsManager:Validate(tutoCategory, tutoName) end)
		tutoFrame.Text:SetWidth(width-15-25) -- we add an offset because of the close button
	end

	tutoFrame:SetWidth(width)
	tutoFrame:Hide() -- we hide them by default, we show them only when we need to

	tutoFrame:SetScript("OnUpdate", function(self)
		if not utils:Approximately(self:GetHeight(), self.Text:GetHeight()+30) then
			self:SetHeight(self.Text:GetHeight()+30)
		end
	end)

	return tutoFrame
end

function widgets:Dummy(parentFrame, relativeFrame, xOffset, yOffset)
	-- a frame with a nil template, this means that it'll be invisible no matter what (perfect for a dummy frame)
	local dummy = CreateFrame("Frame", nil, parentFrame, nil)
	dummy:SetPoint("TOPLEFT", relativeFrame, "TOPLEFT", xOffset, yOffset)
	dummy:SetSize(1, 1)
	dummy:Show()
	return dummy
end

--/*******************/ LABELS /*************************/--

function widgets:NoPointsLabel(relativeFrame, name, text, font)
	local label = relativeFrame:CreateFontString(name)
	if font and type(font) == "string" then
		label:SetFontObject(font)
	else
		label:SetFontObject("GameFontHighlightLarge")
	end
	label:SetText(text)
	return label
end

function widgets:NoPointsInteractiveLabel(parent, pointLeft, pointRight, name, text, fontObjectString)
	local interactiveLabel = CreateFrame("Frame", name, parent, "NysTDL_InteractiveLabel")
	interactiveLabel:SetPoint("LEFT", pointLeft, "RIGHT", 0, 0) -- width
	interactiveLabel:SetPoint("RIGHT", pointRight, "RIGHT", 0, 0) -- width
	interactiveLabel:SetSize(1, parent:GetHeight())
	interactiveLabel.pointLeft = pointLeft

	parent.heightFrame = CreateFrame("Frame", nil, parent)
	parent.heightFrame:SetPoint("TOPLEFT", parent, "TOPLEFT", 0, 0)
	parent.heightFrame:SetWidth(1) -- height is set just below

	interactiveLabel.Text:SetFontObject(fontObjectString)
	interactiveLabel.Text:SetText(text)

	interactiveLabel:SetScript("OnSizeChanged", function(self, width)
		if width < 18 then width = 18 end

		interactiveLabel.Text:SetWidth(width) -- we do it a first time to update the wrapped state
		interactiveLabel.Button:SetSize(math.max(interactiveLabel.Text:GetWrappedWidth(), 16), interactiveLabel.Text:GetStringHeight())

		-- if after that the text is all on one line (no wrap),
		-- we set its width to be its real visible size, not the one of the interactiveLabel
		-- (so that the interactive zone (the button) doesn't get bigger than the actual size of the text)
		if interactiveLabel.Text:GetNumLines() == 1 then
			interactiveLabel.Text:SetWidth(interactiveLabel.Text:GetWrappedWidth())
		end

		-- -- make the text dissapear if we are resizing the frame to be too small, so that the text doesn't go out of bounds to the left
		-- if self:GetLeft() >= pointLeft:GetRight() then
		-- 	interactiveLabel.Text:SetPoint("TOPLEFT", interactiveLabel)
		-- else
		-- 	interactiveLabel.Text:ClearPoint("TOPLEFT") --> ClearAllPoints for classic
		-- end

		parent.heightFrame:SetHeight(interactiveLabel.Text:GetStringHeight())

		if parent.enum == enums.item then
			private.Item_SetCheckBtnExtended(parent, not mainFrame.editMode)
		end
	end)

	interactiveLabel.Button.IsHighlightShown = function(self)
		return interactiveLabel.Button.ActiveLeft:IsShown()
	end
	interactiveLabel.Button.SetHighlightShown = function(self, show)
		interactiveLabel.Button.ActiveLeft:SetShown(show)
		interactiveLabel.Button.ActiveRight:SetShown(show)
		interactiveLabel.Button.ActiveMiddle:SetShown(show)
	end
	interactiveLabel.Button:SetHighlightShown(false)

	return interactiveLabel
end

function widgets:AutoWrapCatSubLabel(parent, label, pointRight)
	-- // here we create the sub-widget frame for empty label / completed label (categories)

	local widget = CreateFrame("Frame", nil, parent)
	widget:SetSize(parent:GetSize())

	widget.heightFrame = CreateFrame("Frame", nil, widget)
	widget.heightFrame:SetPoint("TOPLEFT", widget)
	widget.heightFrame:SetWidth(1) -- height is set just below

	widget.startPosFrame = CreateFrame("Frame", nil, widget)
	widget.startPosFrame:SetPoint("LEFT", widget, "LEFT", enums.ofsxItemIcons, 0)
	widget.startPosFrame:SetSize(widget:GetSize())

	widget.labelFrame = CreateFrame("Frame", nil, widget)
	widget.labelFrame:SetPoint("LEFT", widget.startPosFrame)
	widget.labelFrame:SetPoint("RIGHT", pointRight)
	widget.labelFrame:SetHeight(widget:GetHeight())

	widget.labelFrame.Text = label
	widget.labelFrame.Text:SetParent(widget.labelFrame)
	widget.labelFrame.Text:SetPoint("TOPLEFT", widget.labelFrame)
	widget.labelFrame.Text:SetJustifyV("TOP")
	widget.labelFrame.Text:SetJustifyH("LEFT")
	widget.labelFrame.Text:SetMaxLines(3)

	widget.labelFrame:SetScript("OnSizeChanged", function(self, width)
		if width < 18 then width = 18 end

		widget.labelFrame.Text:SetWidth(width)

		-- -- make the text dissapear if we are resizing the frame to be too small, so that the text doesn't go out of bounds to the left
		-- if widget.labelFrame:GetLeft() >= widget.startPosFrame:GetRight() then
		-- 	widget.labelFrame.Text:SetPoint("TOPLEFT", widget.labelFrame)
		-- else
		-- 	widget.labelFrame.Text:ClearPoint("TOPLEFT") --> ClearAllPoints for classic
		-- end

		widget.heightFrame:SetHeight(widget.labelFrame.Text:GetStringHeight())
	end)

	return widget
end

function widgets:HintLabel(relativeFrame, name, text)
	local label = relativeFrame:CreateFontString(name)
	label:SetFontObject("GameFontHighlightLarge")
	label:SetTextColor(0.5, 0.5, 0.5, 0.5)
	label:SetText(text)
	return label
end

--/*******************/ BUTTONS /*************************/--

function widgets:Button(name, relativeFrame, text, iconPath, fc, bonusWidth)
	fc = fc or false
	iconPath = type(iconPath) == "string" and iconPath or nil
	bonusWidth = bonusWidth or 0

	local btn = CreateFrame("Button", name, relativeFrame, "NysTDL_NormalButton")

	btn:SetText(text)
	btn:SetNormalFontObject("GameFontNormalLarge")
	if fc == true then btn:SetHighlightFontObject("GameFontHighlightLarge") end

	local w = widgets:GetWidth(text)
	if iconPath ~= nil then
		w = w + 23
		btn.Icon = btn:CreateTexture(nil, "ARTWORK")
		btn.Icon:SetPoint("LEFT", btn, "LEFT", 10, 0)
		btn.Icon:SetTexture(iconPath)
		btn.Icon:SetSize(17, 17)
		btn:GetFontString():SetPoint("LEFT", btn, "LEFT", 33, 0)
		btn:HookScript("OnMouseDown", function(self) self.Icon:SetPoint("LEFT", self, "LEFT", 12, -2) end)
		btn:HookScript("OnMouseUp", function(self) self.Icon:SetPoint("LEFT", self, "LEFT", 10, 0) end)
	end
	btn:SetWidth(w + 20 + bonusWidth)

	return btn
end

function widgets:AddTooltipToButton(btn, tooltipText, tooltipOffsetX, tooltipOffsetY)
	if not btn then return end
	--[[
		A tooltip button has these fields, that can be modified :

		btn.tooltipText : table of strings, one string = one line of tooltip
		btn.tooltipOffsetX : number
		btn.tooltipOffsetY : number

		btn.RefreshTooltip() : function, call it if any of the above values changes
	]]

	btn.tooltip = nil
	btn.tooltipText = tooltipText

	btn.tooltipOffsetX = tooltipOffsetX
	btn.tooltipOffsetY = tooltipOffsetY

	local OnEnter = function(self)
		if type(btn.tooltipText) ~= "table" then
			btn.tooltipText = {tostring(btn.tooltipText)}
		end
		if type(btn.tooltipText[1]) == "string" and btn.tooltipText[1] ~= "" then -- // Tooltip
			-- if the tooltip is already in use by someone else, return
			if LibQTip:IsAcquired("NysTDL_Tooltip_TooltipButton") then
				return
			end

			-- we're good to go
			btn.tooltip = widgets:AcquireTooltip("NysTDL_Tooltip_TooltipButton", self, btn.tooltipOffsetX, btn.tooltipOffsetY)
			btn.tooltip:SetFont("GameTooltipText")

			for _,text in ipairs(btn.tooltipText) do
				btn.tooltip:AddLine(text)
			end
		end
		btn.isHovered = true
	end

	local OnLeave = function(self)
		if btn.tooltip then
			LibQTip:Release(btn.tooltip)
			btn.tooltip = nil
		end
		btn.isHovered = false
	end

	btn:HookScript("OnEnter", OnEnter)
	btn:HookScript("OnLeave", OnLeave)

	btn.RefreshTooltip = function(self)
		if btn.isHovered then
			OnLeave(self)
			OnEnter(self)
		end
	end
end

function widgets:IconTooltipButton(relativeFrame, template, tooltipText, tooltipOffsetX, tooltipOffsetY)
	local btn = CreateFrame("Button", nil, relativeFrame, template)

	widgets:AddTooltipToButton(btn, tooltipText, tooltipOffsetX, tooltipOffsetY)

	return btn
end

function widgets:AcquireTooltip(name, relativeFrame, offsetx, offsety)
	local tooltip = LibQTip:Acquire(name, 1)

	tooltip:Clear()
	tooltip:SmartAnchorTo(relativeFrame)
	tooltip:ClearAllPoints()
	tooltip:SetPoint("BOTTOMRIGHT", relativeFrame, "TOPRIGHT", offsetx or 0, offsety or 0)

	tooltip:Show()

	return tooltip
end

function widgets:HelpButton(relativeFrame, tooltipText)
	local btn = widgets:IconTooltipButton(relativeFrame, "NysTDL_HelpButton", tooltipText, 0, 1)
	btn:SetAlpha(0.7)

	-- these are for changing the color depending on the mouse actions (since they are custom xml)
	btn:HookScript("OnEnter", function(self)
		self:SetAlpha(1)
	end)
	btn:HookScript("OnLeave", function(self)
		self:SetAlpha(0.7)
	end)
	btn:HookScript("OnShow", function(self)
		self:SetAlpha(0.7)
	end)
	return btn
end

function widgets:CreateTDLButton()
	-- creating the big button to easily toggle the frame
	tdlButton = widgets:Button("NysTDL_tdlButton", UIParent, core.simpleAddonName)

	-- properties
	tdlButton:SetFrameStrata("LOW")
	tdlButton:EnableMouse(true)
	tdlButton:SetMovable(true)
	tdlButton:SetClampedToScreen(true)
	tdlButton:SetToplevel(true)

	-- drag
	tdlButton:RegisterForDrag("LeftButton")
	tdlButton:SetScript("OnDragStart", function()
		if not NysTDL.acedb.profile.lockTdlButton then
			tdlButton:StartMoving()
		end
	end)
	tdlButton:SetScript("OnDragStop", function() -- we save its position
		tdlButton:StopMovingOrSizing()
		local points, _ = NysTDL.acedb.profile.tdlButton.points, nil
		points.point, _, points.relativePoint, points.xOffset, points.yOffset = tdlButton:GetPoint()
	end)

	-- click
	tdlButton:SetScript("OnClick", mainFrame.Toggle) -- the function the button calls when pressed
end

-- item buttons

function widgets:RemoveButton(widget, parent)
	local btn = CreateFrame("Button", nil, parent, "NysTDL_RemoveButton")
	local ID = widget.itemID or widget.catID
	local desaturated = nil
	-- local desaturated = widget.enum == enums.category and 1 or nil

	-- these are for changing the color depending on the mouse actions (since they are custom xml)
	btn:HookScript("OnEnter", function(self)
		if not dataManager:IsID(ID) then return end
		if not dataManager:IsProtected(ID) then
			self.Icon:SetDesaturated(desaturated)
			self.Icon:SetVertexColor(0.8, 0.2, 0.2)
		end
	end)
	btn:HookScript("OnLeave", function(self)
		if not dataManager:IsID(ID) then return end
		if not dataManager:IsProtected(ID) then
			if tonumber(string.format("%.1f", self.Icon:GetAlpha())) ~= 0.5 then
				self.Icon:SetDesaturated(desaturated)
				self.Icon:SetVertexColor(1, 1, 1)
			end
		end
	end)
	btn:HookScript("OnMouseUp", function(self)
		if not dataManager:IsID(ID) then return end
		if not dataManager:IsProtected(ID) then
			self.Icon:SetDesaturated(desaturated)
			self.Icon:SetVertexColor(1, 1, 1)
		end
	end)
	btn:HookScript("OnShow", function(self)
		if not dataManager:IsID(ID) then return end
		if dataManager:IsProtected(ID) then
			self:Disable()
			self.Icon:SetDesaturated(1)
			self.Icon:SetVertexColor(0.4, 0.4, 0.4)
		else
			self:Enable()
			self.Icon:SetDesaturated(desaturated)
			self.Icon:SetVertexColor(1, 1, 1)
		end
	end)
	return btn
end

function widgets:FavoriteButton(widget, parent)
	local btn = CreateFrame("Button", nil, parent, "NysTDL_FavoriteButton")

	-- these are for changing the color depending on the mouse actions (since they are custom xml)
	-- and yea, this one's a bit complicated because I wanted its look to be really precise...
	btn:HookScript("OnEnter", function(self)
		if not widget.itemData.favorite then -- not favorited
			self.Icon:SetDesaturated(nil)
			self.Icon:SetVertexColor(1, 1, 1)
		else
			self:SetAlpha(0.6)
		end
	end)
	btn:HookScript("OnLeave", function(self)
		if not widget.itemData.favorite then
			if tonumber(string.format("%.1f", self.Icon:GetAlpha())) ~= 0.5 then -- if we are currently clicking on the button
				self.Icon:SetDesaturated(1)
				self.Icon:SetVertexColor(0.4, 0.4, 0.4)
			end
		else
			self:SetAlpha(1)
		end
	end)
	btn:HookScript("OnMouseUp", function(self)
		self:SetAlpha(1)
		if not widget.itemData.favorite then
			self.Icon:SetDesaturated(1)
			self.Icon:SetVertexColor(0.4, 0.4, 0.4)
		end
	end)
	btn:HookScript("PostClick", function(self)
		self:GetScript("OnShow")(self)
	end)
	btn:HookScript("OnShow", function(self)
		self:SetAlpha(1)
		if not widget.itemData.favorite then
			self.Icon:SetDesaturated(1)
			self.Icon:SetVertexColor(0.4, 0.4, 0.4)
		else
			self.Icon:SetDesaturated(nil)
			self.Icon:SetVertexColor(1, 1, 1)
		end
	end)
	return btn
end

function widgets:DescButton(widget, parent)
	local btn = CreateFrame("Button", nil, parent, "NysTDL_DescButton")

	-- // Appearance

	-- these are for changing the color depending on the mouse actions (since they are custom xml)
	-- and yea, this one's a bit complicated too because it works in very specific ways
	btn:HookScript("OnEnter", function(self)
		if not widget.itemData.description then -- no description
			self.Icon:SetDesaturated(nil)
			self.Icon:SetVertexColor(1, 1, 1)
		else
			self:SetAlpha(0.6)
		end
	end)
	btn:HookScript("OnLeave", function(self)
		if not widget.itemData.description then
			if tonumber(string.format("%.1f", self.Icon:GetAlpha())) ~= 0.5 then -- if we are currently clicking on the button
				self.Icon:SetDesaturated(1)
				self.Icon:SetVertexColor(0.4, 0.4, 0.4)
			end
		else
			self:SetAlpha(1)
		end
	end)
	btn:HookScript("OnMouseUp", function(self)
		self:SetAlpha(1)
		if not widget.itemData.description then
			self.Icon:SetDesaturated(1)
			self.Icon:SetVertexColor(0.4, 0.4, 0.4)
		end
	end)
	btn:HookScript("PostClick", function(self)
		self:GetScript("OnShow")(self)
	end)
	btn:HookScript("OnShow", function(self)
		self:SetAlpha(1)
		if not widget.itemData.description then
			self.Icon:SetDesaturated(1)
			self.Icon:SetVertexColor(0.4, 0.4, 0.4)
		else
			self.Icon:SetDesaturated(nil)
			self.Icon:SetVertexColor(1, 1, 1)
		end
	end)

	-- // Tooltip

	btn.tooltip = nil
	btn.isTooltipShown = function()
		return not (descFrames[widget.itemID] and true or false)
	end

	btn:HookScript("OnEnter", function(self)
		-- we don't do anything in 3 cases
		-- if we unchecked the option in the addon options
		if not NysTDL.acedb.profile.descriptionTooltip then
			return
		end

		-- if the item doesn't have a description
		if not widget.itemData.description then
			return
		end

		-- if the tooltip is already in use by someone else
		if LibQTip:IsAcquired("NysTDL_Tooltip_DescButton") then
			return
		end

		-- we're good to go
		btn.tooltip = widgets:AcquireTooltip("NysTDL_Tooltip_DescButton", self)

		btn.tooltip:SetFont(descFrameInfo.font)

		btn.tooltip:AddLine()
		btn.tooltip:SetCell(1, 1, widget.itemData.description, nil, nil, nil, nil, nil, nil, descFrameInfo.width-20)

		btn.tooltip:SetShown(btn.isTooltipShown())
	end)
	btn:HookScript("OnLeave", function()
		if btn.tooltip then
			LibQTip:Release(btn.tooltip)
			btn.tooltip = nil
		end
	end)
	btn:HookScript("OnShow", function()
		if btn.tooltip then
			btn.tooltip:SetShown(btn.isTooltipShown())
		end
	end)

  return btn
end

function widgets:AddButton(widget, parent)
	local btn = widgets:IconTooltipButton(parent, "NysTDL_AddButton", {string.format("|cff%s%s|r", utils:RGBToHex(database.themes.theme), L["Left-Click"])..utils:GetMinusStr()..L["Add an item"], string.format("|cff%s%s|r", utils:RGBToHex(database.themes.theme), L["Right-Click"])..utils:GetMinusStr()..L["Add a category"]})

	-- // Appearance

	btn.Icon:SetTexture((enums.icons.add.info()))
	btn.Icon:SetSize(select(2, enums.icons.add.info()))
	btn.Icon:SetTexCoord(unpack(enums.icons.add.texCoords))

	-- these are for changing the color depending on the mouse actions (since they are custom xml)
	-- and yea, this one's a bit complicated too because it works in very specific ways
	btn:HookScript("OnEnter", function(self)
		self:SetAlpha(1)
	end)
	btn:HookScript("OnLeave", function(self)
		self:SetAlpha(0.5)
	end)
	btn:HookScript("OnShow", function(self)
		self:SetAlpha(0.5)
	end)

	return btn
end

function widgets:ValidButton(parent)
	local btn = CreateFrame("Button", nil, parent, "NysTDL_ValidButton")
	local function toGreen()
		btn.Icon = btn.IconGreen
		btn.IconYellow:Hide()
		btn.IconGreen:Show()
	end
	local function toYellow()
		btn.Icon = btn.IconYellow
		btn.IconGreen:Hide()
		btn.IconYellow:Show()
	end
	toYellow()

	-- these are for changing the color depending on the mouse actions (since they are custom xml)
	btn:HookScript("OnEnter", function()
		toGreen()
	end)
	btn:HookScript("OnLeave", function(self)
		if not self.pressed then
			toYellow()
		end
	end)
	btn:HookScript("OnMouseUp", function()
		toYellow()
	end)
	btn:HookScript("OnShow", function()
		toYellow()
	end)
	return btn
end

--/*******************/ ITEM/CATEGORY WIDGETS /*************************/--

local Widget_doubleClicked = false -- see CategoryWidget > interactiveLabel.Button > OnClick

---DRY function to rename the widgets (OnDoubleClick).
function private.Widget_OnDoubleClick(self, button)
	-- first we check if we can rename right now
	if not mainFrame.editMode then return end -- we can only rename in edit mode
	if dragndrop.dragging then return end -- we can't rename if we are dragging something
	if button ~= "LeftButton" then return end -- only double-left click

	Widget_doubleClicked = true

	-- we get all the relevant data
	local widget = self:GetParent():GetParent() -- self is the interactiveLabel's button (interactiveLabel.Button)

	local ID, name, renameEditBoxWidth
	if widget.enum == enums.item then
		ID = widget.itemID
		name = widget.itemData.name
	elseif widget.enum == enums.category then
		ID = widget.catID
		name = widget.catData.name
	end

	-- we're ready, now we start by hiding the interactiveLabel
	self:GetParent():Hide()

	-- then, we can create the new edit box to rename the object, where the label was
	local renameEditBox = widgets:NoPointsRenameEditBox(widget, name, self:GetHeight())
	renameEditBox:SetPoint("LEFT", widget.interactiveLabel, "LEFT", 5, 0)
	renameEditBox:SetPoint("RIGHT", widget:GetParent(), "RIGHT", -3, 0)

	if widget.enum == enums.item or widget.enum == enums.category then
		widgets:AddHyperlinkEditBox(renameEditBox) -- so that we can add hyperlinks in it
		-- widgets:SetHyperlinksEnabled(renameEditBox, true) -- to click on hyperlinks inside the edit box
	end

	-- let's go!
	renameEditBox:SetScript("OnEnterPressed", function(self)
		dataManager:Rename(ID, self:GetText())
	end)

	-- cancelling
	renameEditBox:SetScript("OnEscapePressed", function(self)
		-- we hide the edit box and show the label
		self:Hide()
		self:ClearAllPoints()
		widget.interactiveLabel:Show()

		if widget.enum == enums.item then
			widgets:RemoveHyperlinkEditBox(self)
		end
	end)
	renameEditBox:HookScript("OnEditFocusLost", function(self)
		self:GetScript("OnEscapePressed")(self)
	end)
end

--[[

-- // categoryWidget example:

contentWidgets = {
	[catID] = { -- widgets:CategoryWidget(catID)
		-- data
		enum = enums.category,
		catID = catID,
		catData = catData,

		-- frames
		interactiveLabel,
		favsRemainingLabel,
		addEditBox,
		...
	},
	...
}

]]

function private:Category_SetEditMode(state)
	local isSubCat = not not self.catData.parentCatID
	if state then
		self.editModeFrame:Show()

		self.startPosFrame:SetPoint("LEFT", self, "LEFT", enums.ofsxItemIcons-3, 0)

		self.interactiveLabel.Button:GetScript("OnLeave")(self.interactiveLabel.Button)
		self.interactiveLabel.Text:SetMaxLines(math.min(self.interactiveLabel.Text:GetNumLines(), enums.maxWordWrapLines))
	else
		self.editModeFrame:Hide()

		self.startPosFrame:SetPoint("LEFT", self, "LEFT", 0, 0)

		self.interactiveLabel.Text:SetMaxLines(enums.maxWordWrapLines)
	end

	if isSubCat then
		self.startPosFrame:SetPoint("LEFT", self, "LEFT", enums.ofsxItemIcons, 0)
	end

	self.interactiveLabel:GetScript("OnSizeChanged")(self.interactiveLabel, self.interactiveLabel:GetWidth())
end

function widgets:CategoryWidget(catID, parentFrame)
	local categoryWidget = CreateFrame("Frame", nil, parentFrame, nil)
	categoryWidget:SetSize(1, 16) -- so that its children are visible

	-- // data

	categoryWidget.enum = enums.category
	categoryWidget.catID = catID
	categoryWidget.catData = select(3, dataManager:Find(catID))
	categoryWidget.color = { 1, 1, 1, 1 }
	local catData = categoryWidget.catData

	-- // frames

	categoryWidget.startPosFrame = CreateFrame("Frame", nil, categoryWidget) -- frame to determine where we start the checkbox, or the label if we are in a non-checkable item
	categoryWidget.startPosFrame:SetPoint("LEFT", categoryWidget, "LEFT", 0, 0)
	categoryWidget.startPosFrame:SetSize(categoryWidget:GetSize())

	-- / interactiveLabel
	categoryWidget.interactiveLabel = widgets:NoPointsInteractiveLabel(categoryWidget, categoryWidget.startPosFrame, parentFrame, nil, catData.name, "GameFontNormalLargeLeftTop")
	categoryWidget.interactiveLabel.Text:SetTextColor(1, 1, 1)

	-- categoryWidget.divider = widgets:HorizontalDivider(categoryWidget)
	-- categoryWidget.divider:SetPoint("LEFT", categoryWidget.interactiveLabel, "BOTTOMLEFT", 0, -4)
	-- categoryWidget.divider:SetPoint("RIGHT", categoryWidget.interactiveLabel, "BOTTOMRIGHT", 0, -4)

	-- / interactiveLabel.Button
	categoryWidget.interactiveLabel.Button:SetScript("OnEnter", function(self)
		if dragndrop.dragging then return end

		local r, g, b = unpack(utils:ThemeDownTo01(database.themes.theme))
		self:GetParent().Text:SetTextColor(r, g, b, 1) -- when we hover it, we color the label
	end)
	categoryWidget.interactiveLabel.Button:SetScript("OnLeave", function(self)
		self:GetParent().Text:SetTextColor(unpack(categoryWidget.color)) -- back to the default color
	end)
	categoryWidget.interactiveLabel.Button:SetScript("OnClick", function(self, button, forced)
		if dragndrop.dragging then return end

		if button == "LeftButton" then -- we open/close the category
			if mainFrame.editMode and not forced then
				-- when in edit mode, since we can rename an object by double-clicking on it (only "LeftButton"),
				-- the first click also opens/closes the category, which is something I don't want.
				-- So I'm simply delaying the first click, and only doing it if we didn't meant to double-click.
				Widget_doubleClicked = false
				AceTimer:ScheduleTimer(function()
					if Widget_doubleClicked then return end
					categoryWidget.interactiveLabel.Button:GetScript("OnClick")(self, button, true)
				end, 0.3)
				return
			end

			dataManager:ToggleClosed(catID, database.ctab())
		end
	end)
	categoryWidget.interactiveLabel.Button:SetScript("OnDoubleClick", private.Widget_OnDoubleClick)

	-- / editModeFrame
	categoryWidget.editModeFrame = CreateFrame("Frame", nil, categoryWidget, nil)
	categoryWidget.editModeFrame:SetPoint("LEFT", categoryWidget, "LEFT", 0, 0)
	categoryWidget.editModeFrame:SetSize(categoryWidget:GetSize())
	local emf = categoryWidget.editModeFrame

	-- / removeBtn
	categoryWidget.removeBtn = widgets:RemoveButton(categoryWidget, emf)
	categoryWidget.removeBtn:SetPoint("LEFT", emf, "LEFT", 0, 0)
	categoryWidget.removeBtn:SetScript("OnClick", function() dataManager:DeleteCat(catID) end)

	categoryWidget.labelsStartPosFrame = CreateFrame("Frame", nil, categoryWidget) -- frame to determine where we start the category labels (favsRemainingLabel & originalTabLabel)
	categoryWidget.labelsStartPosFrame:SetPoint("TOPLEFT", categoryWidget.interactiveLabel.Text, "TOPRIGHT", 5, 0) -- 5 bc 6-width => 6-1 => 5 bc "RIGHT"
	categoryWidget.labelsStartPosFrame:SetSize(categoryWidget:GetSize())

	-- / favsRemainingLabel
	categoryWidget.favsRemainingLabel = widgets:NoPointsLabel(categoryWidget.interactiveLabel, nil, "")
	categoryWidget.favsRemainingLabel:SetPoint("LEFT", categoryWidget.labelsStartPosFrame, "RIGHT", 0, 0)
	categoryWidget.favsRemainingLabel:SetPoint("RIGHT", categoryWidget.interactiveLabel, "RIGHT", 0, 0)
	categoryWidget.favsRemainingLabel:SetJustifyV("TOP")
	categoryWidget.favsRemainingLabel:SetJustifyH("LEFT")
	categoryWidget.favsRemainingLabel:SetHeight(categoryWidget.favsRemainingLabel:GetLineHeight())

	-- / originalTabLabel
	categoryWidget.originalTabLabel = widgets:HintLabel(categoryWidget.interactiveLabel, nil, "")
	categoryWidget.originalTabLabel:SetJustifyV("TOP")
	categoryWidget.originalTabLabel:SetJustifyH("LEFT")
	categoryWidget.originalTabLabel:SetHeight(categoryWidget.originalTabLabel:GetLineHeight())

	-- / emptyLabel
	local emptyLabel = widgets:HintLabel(categoryWidget, nil, L["Empty category"])
	categoryWidget.emptyLabel = widgets:AutoWrapCatSubLabel(categoryWidget, emptyLabel, parentFrame)
	-- emptyLabel points are set in mainFrame:Refresh() (it is treated as an individual widget)

	-- / hiddenLabel
	local hiddenLabel = widgets:HintLabel(categoryWidget, nil, L["Completed category"])
	categoryWidget.hiddenLabel = widgets:AutoWrapCatSubLabel(categoryWidget, hiddenLabel, parentFrame)
	-- hiddenLabel points are set in mainFrame:Refresh() (it is treated as an individual widget)

	-- / add edit boxes & everything that goes with them
	local hoverFrameExtent = 26
	local hoverFrameTimeout = 0.6
	categoryWidget.hoverFrame = CreateFrame("Frame", nil, categoryWidget.interactiveLabel)
	categoryWidget.hoverFrame:SetPoint("TOPLEFT", categoryWidget.interactiveLabel.Button, "TOPLEFT", 0, 0)
	categoryWidget.hoverFrame:SetPoint("BOTTOMRIGHT", categoryWidget.interactiveLabel.Button, "BOTTOMRIGHT", hoverFrameExtent, 0)

	categoryWidget.hoverTimerID = -1
	categoryWidget.hoverFrame:SetScript("OnShow", function(self)
		categoryWidget.labelsStartPosFrame:ClearAllPoints()
		categoryWidget.labelsStartPosFrame:SetPoint("TOPLEFT", categoryWidget.hoverFrame, "TOPRIGHT", 0, 0)
	end)
	categoryWidget.hoverFrame:SetScript("OnHide", function(self)
		categoryWidget.labelsStartPosFrame:ClearAllPoints()
		categoryWidget.labelsStartPosFrame:SetPoint("TOPLEFT", categoryWidget.interactiveLabel.Text, "TOPRIGHT", 5, 0) -- 5 bc 6-width => 6-1 => 5 bc "RIGHT"
	end)
	categoryWidget.hoverFrame:SetScript("OnEnter", function(self)
		AceTimer:CancelTimer(categoryWidget.hoverTimerID)
	end)
	categoryWidget.hoverFrame:SetScript("OnLeave", function(self)
		if catData.closedInTabIDs[database.ctab()] then
			self:Hide()
			return
		end

		AceTimer:CancelTimer(categoryWidget.hoverTimerID)
		categoryWidget.hoverTimerID = AceTimer:ScheduleTimer(function()
			if self and self.Hide then
				self:Hide()
			end
		end, hoverFrameTimeout)
	end)
	local tryToShowHoverFrame = function()
		if dragndrop.dragging then return end
		AceTimer:CancelTimer(categoryWidget.hoverTimerID)
		categoryWidget.hoverFrame:SetShown(not catData.closedInTabIDs[database.ctab()])
		if categoryWidget.hoverFrame:IsShown() then
			if currentHoverFrame and currentHoverFrame ~= categoryWidget.hoverFrame then
				currentHoverFrame:Hide()
			end

			currentHoverFrame = categoryWidget.hoverFrame
		end
	end
	categoryWidget.interactiveLabel.Button:HookScript("OnEnter", function(self)
		tryToShowHoverFrame()
	end)
	categoryWidget.interactiveLabel.Button:HookScript("OnLeave", function(self)
		categoryWidget.hoverFrame:GetScript("OnLeave")(categoryWidget.hoverFrame)
	end)
	categoryWidget.interactiveLabel.Button:HookScript("OnShow", function(self)
		AceTimer:ScheduleTimer(function()
			if categoryWidget.hoverFrame:IsMouseOver() then
				tryToShowHoverFrame()
			else
				categoryWidget.hoverFrame:GetScript("OnLeave")(categoryWidget.hoverFrame)
			end
		end, 0.0) -- wait for the next frame, just to make sure that everything has been properly refreshed
	end)
	categoryWidget.hoverFrame:Hide()

	-- / addItemBtn
	categoryWidget.addItemBtn = widgets:AddButton(categoryWidget, categoryWidget.hoverFrame)
	categoryWidget.addItemBtn:SetPoint("TOPLEFT", categoryWidget.hoverFrame, "TOPRIGHT", -hoverFrameExtent+5, -1)
	categoryWidget.addItemBtn:SetScript("OnClick", function(self, button)
		if not widgets.aebShown[catID] then widgets.aebShown[catID] = 0 end

		local lastAddMode = categoryWidget.addMode or enums.item

		if button == "RightButton" then
			categoryWidget.addMode = enums.category
		else
			categoryWidget.addMode = enums.item
		end

		if lastAddMode == categoryWidget.addMode then
			widgets.aebShown[catID] = bit.bxor(widgets.aebShown[catID], widgets.aebShownFlags.item) -- toggle
		else
			widgets.aebShown[catID] = bit.bor(widgets.aebShown[catID], widgets.aebShownFlags.item) -- on
		end

		mainFrame:Refresh()

		if categoryWidget.addEditBox.edb:IsShown() then
			widgets:SetFocusEditBox(categoryWidget.addEditBox.edb)
		end
	end)
	categoryWidget.addItemBtn:RegisterForClicks("LeftButtonUp", "RightButtonUp")
	categoryWidget.addItemBtn:HookScript("OnEnter", function(self)
		categoryWidget.hoverFrame:GetScript("OnEnter")(categoryWidget.hoverFrame)
	end)
	categoryWidget.addItemBtn:HookScript("OnLeave", function(self)
		categoryWidget.hoverFrame:GetScript("OnLeave")(categoryWidget.hoverFrame)
	end)

	-- / addEditBox
	categoryWidget.addEditBox = widgets:NoPointsCatEditBox(categoryWidget, nil, true, parentFrame)
	categoryWidget.addEditBox:Hide()
	categoryWidget.addEditBox.edb:SetScript("OnEnterPressed", function(self)
		if categoryWidget.addMode == enums.item then
			if dataManager:CreateItem(self:GetText(), catData.originalTabID, catID) then -- calls mainFrame:Refresh()
				self:SetText("") -- we clear the box if the adding was a success
			end
		elseif categoryWidget.addMode == enums.category then
			if dataManager:CreateCategory(self:GetText(), catData.originalTabID, catID) then -- calls mainFrame:Refresh()
				self:SetText("") -- we clear the box if the adding was a success
			end
		end
		widgets:SetFocusEditBox(self)
	end)
	-- cancelling
	categoryWidget.addEditBox.edb:SetScript("OnEscapePressed", function(self)
		widgets.aebShown[catID] = bit.band(widgets.aebShown[catID], bit.bnot(widgets.aebShownFlags.item))
		mainFrame:Refresh()
	end)
	categoryWidget.addEditBox.edb:SetScript("OnShow", function(self)
		tutorialsManager:Validate("introduction", "addItem") -- tutorial

		if categoryWidget.addMode == enums.item then
			categoryWidget.addEditBox.edb.Hint:SetText(L["Add an item"])
		elseif categoryWidget.addMode == enums.category then
			categoryWidget.addEditBox.edb.Hint:SetText(L["Add a category"])
		end
	end)
	widgets:AddHyperlinkEditBox(categoryWidget.addEditBox.edb)

	-- -- TDLATER sub-cat creation
	-- -- / addCatEditBox
	-- categoryWidget.addCatEditBox = widgets:NoPointsCatEditBox(categoryWidget)
	-- categoryWidget.addCatEditBox:SetPoint("RIGHT", categoryWidget.interactiveLabel, "LEFT", 270, -20)
	-- categoryWidget.addCatEditBox:SetPoint("LEFT", categoryWidget.interactiveLabel, "RIGHT", 10, -20)
	-- categoryWidget.addCatEditBox:SetSize(100, 30)
	-- categoryWidget.addCatEditBox:Hide()
	-- categoryWidget.addCatEditBox:SetScript("OnEnterPressed", function(self)
	-- 	if dataManager:CreateCategory(self:GetText(), catData.originalTabID, catID) then
	-- 		self:SetText("") -- we clear the box if the adding was a success
	-- 	end
	-- 	self:Show() -- we keep it shown to add more categories
	-- 	widgets:SetFocusEditBox(self)
	-- end)
	-- -- cancelling
	-- categoryWidget.addCatEditBox:SetScript("OnEscapePressed", function(self)
	-- 	self:Hide()
	-- 	self:ClearAllPoints()
	-- end)
	-- categoryWidget.addCatEditBox:HookScript("OnEditFocusLost", function(self)
	-- 	self:GetScript("OnEscapePressed")(self)
	-- end)

	-- / tabulation
	categoryWidget.tabulation = widgets:Tabulation(categoryWidget)

	-- / drag&drop
	dragndrop:RegisterForDrag(categoryWidget)

	-- / edit mode
	categoryWidget.SetEditMode = private.Category_SetEditMode
	categoryWidget:SetEditMode(mainFrame.editMode)

	return categoryWidget
end

--[[

-- // itemWidget example:

contentWidgets = {
	[itemID] = { -- widgets:ItemWidget(itemID)
		-- data
		enum = enums.item,
		itemID = itemID,
		itemData = itemData,

		-- frames
		checkBtn,
		interactiveLabel,
		removeBtn,
		favoriteBtn,
		descBtn,
		...
	},
	...
}

]]

function private:Item_SetCheckBtnExtended(state)
	if state then
		if not utils:HasHyperlink(self.itemData.name) then -- so that we can actually click on the hyperlinks
			self.checkBtn:SetHitRectInsets(0, -(math.max(self.interactiveLabel.Text:GetWrappedWidth(), 16)), 0, -(self.interactiveLabel.Text:GetStringHeight()-self.interactiveLabel.Text:GetLineHeight()))
		end
	else
		self.checkBtn:SetHitRectInsets(0, 0, 0, 0)
	end
end

function private:Item_SetEditMode(state)
	if state then
		self.editModeFrame:Show()

		self.favoriteBtn:SetParent(self.editModeFrame)
		self.favoriteBtn:SetPoint("LEFT", self, "LEFT", enums.ofsxItemIcons, -2)
		self.descBtn:SetParent(self.editModeFrame)
		self.descBtn:SetPoint("LEFT", self, "LEFT", enums.ofsxItemIcons*2, 1)

		self.startPosFrame:SetPoint("LEFT", self, "LEFT", enums.ofsxItemIcons*3, 0)

		self.interactiveLabel.Button:Show()
		self.interactiveLabel.Text:SetMaxLines(math.min(self.interactiveLabel.Text:GetNumLines(), enums.maxWordWrapLines))
	else
		self.editModeFrame:Hide()

		self.favoriteBtn:SetParent(self)
		self.favoriteBtn:SetPoint("LEFT", self, "LEFT", 0, -2)
		self.descBtn:SetParent(self)
		self.descBtn:SetPoint("LEFT", self, "LEFT", 0, 1)

		self.startPosFrame:SetPoint("LEFT", self, "LEFT", enums.ofsxItemIcons, 0)

		self.interactiveLabel.Button:Hide()
		self.interactiveLabel.Text:SetMaxLines(enums.maxWordWrapLines)
	end
	self.interactiveLabel:GetScript("OnSizeChanged")(self.interactiveLabel, self.interactiveLabel:GetWidth())
	self.favoriteBtn:EnableMouse(not not state)
	private.Item_SetCheckBtnExtended(self, not state)
	mainFrame:UpdateItemButtons(self.itemID)
end

function widgets:ItemWidget(itemID, parentFrame)
	local itemWidget = CreateFrame("Frame", nil, parentFrame, nil)
	itemWidget:SetSize(1, 16) -- so that its children are visible

	-- // data

	itemWidget.enum = enums.item
	itemWidget.itemID = itemID
	itemWidget.itemData = select(3, dataManager:Find(itemID))
	local itemData = itemWidget.itemData

	-- // frames

	itemWidget.startPosFrame = CreateFrame("Frame", nil, itemWidget) -- frame to determine where we start the checkbox, or the label if we are in a non-checkable item
	itemWidget.startPosFrame:SetPoint("LEFT", itemWidget, "LEFT", enums.ofsxItemIcons, 0)
	itemWidget.startPosFrame:SetSize(itemWidget:GetSize())

	-- / checkBtn
	itemWidget.checkBtn = CreateFrame("CheckButton", nil, itemWidget, "UICheckButtonTemplate")
	itemWidget.checkBtn:SetPoint("LEFT", itemWidget.startPosFrame, "LEFT", -3, 0)
	itemWidget.checkBtn:SetScript("OnClick", function() dataManager:ToggleChecked(itemID) end)
	itemWidget.SetCheckBtnExtended = private.Item_SetCheckBtnExtended

	-- / interactiveLabel
	itemWidget.interactiveLabel = widgets:NoPointsInteractiveLabel(itemWidget, itemWidget.checkBtn, parentFrame, nil, itemData.name, "GameFontNormalLargeLeftTop")
	widgets:SetHyperlinksEnabled(itemWidget.interactiveLabel, true)
	itemWidget:SetCheckBtnExtended(true)

	-- / interactiveLabel.Button
	itemWidget.interactiveLabel.Button:Hide() -- we are not in edit mode by default
	itemWidget.interactiveLabel.Button:SetScript("OnDoubleClick", private.Widget_OnDoubleClick)

	-- / editModeFrame
	itemWidget.editModeFrame = CreateFrame("Frame", nil, itemWidget, nil)
	itemWidget.editModeFrame:SetPoint("LEFT", itemWidget, "LEFT", 0, 0)
	itemWidget.editModeFrame:SetSize(itemWidget:GetSize())
	local emf = itemWidget.editModeFrame

	-- / removeBtn
	itemWidget.removeBtn = widgets:RemoveButton(itemWidget, emf)
	itemWidget.removeBtn:SetPoint("LEFT", emf, "LEFT", 0, 1)
	itemWidget.removeBtn:SetScript("OnClick", function() dataManager:DeleteItem(itemID) end)

	-- / favoriteBtn
	itemWidget.favoriteBtn = widgets:FavoriteButton(itemWidget, emf)
	itemWidget.favoriteBtn:SetScript("OnClick", function() dataManager:ToggleFavorite(itemID) end)

	-- / descBtn
	itemWidget.descBtn = widgets:DescButton(itemWidget, emf)
	itemWidget.descBtn:SetScript("OnClick", function() widgets:DescriptionFrame(itemWidget) end)

	-- / drag&drop
	dragndrop:RegisterForDrag(itemWidget)

	-- / edit mode
	itemWidget.SetEditMode = private.Item_SetEditMode
	itemWidget:SetEditMode(mainFrame.editMode)

	return itemWidget
end

--/*******************/ EDIT BOXES /*************************/--

function widgets:NoPointsRenameEditBox(relativeFrame, text, height)
	local renameEditBox = CreateFrame("EditBox", nil, relativeFrame, "InputBoxTemplate")
	renameEditBox:SetHeight(height)
	renameEditBox:SetText(text)
	renameEditBox:SetFontObject("GameFontHighlightLarge")
	renameEditBox:SetAutoFocus(false)
	widgets:SetFocusEditBox(renameEditBox)
	return renameEditBox
end

function widgets:NoPointsCatEditBox(parent, hint, fullWidget, pointRight)
	local edb = CreateFrame("EditBox", nil, parent, "InputBoxTemplate")
	edb:SetFontObject("GameFontHighlightLarge")
	edb:SetHeight(16)
	edb:SetAutoFocus(false)
	edb:HookScript("OnEditFocusGained", function(self)
		if NysTDL.acedb.profile.highlightOnFocus then
			self:HighlightText()
		else
			self:HighlightText(self:GetCursorPosition(), self:GetCursorPosition())
		end
	end)

	edb.Hint = edb:CreateFontString(nil)
	edb.Hint:SetFontObject("GameFontNormal")
	edb.Hint:SetTextColor(0.35, 0.35, 0.35)
	edb.Hint:SetText(hint or "")
	edb.Hint:SetPoint("LEFT", edb, "LEFT", 3, -1)
	edb.Hint:SetPoint("RIGHT", edb, "RIGHT", -6, -1)
	edb.Hint:SetJustifyV("TOP")
	edb.Hint:SetJustifyH("LEFT")
	edb.Hint:SetHeight(edb.Hint:GetLineHeight())

	edb:HookScript("OnTextChanged", function(self)
		self.Hint:SetShown(self:GetText() == "")
	end)

	if not fullWidget then
		return edb
	end

	local widget = CreateFrame("Frame", nil, parent)
	widget:SetSize(parent:GetSize())

	widget.heightFrame = CreateFrame("Frame", nil, widget)
	widget.heightFrame:SetPoint("TOPLEFT", widget)
	widget.heightFrame:SetWidth(1)
	widget.heightFrame:SetHeight(widget:GetHeight()) -- fixed for now

	widget.startPosFrame = CreateFrame("Frame", nil, widget)
	widget.startPosFrame:SetPoint("LEFT", widget, "LEFT", enums.ofsxItemIcons+5, 0)
	widget.startPosFrame:SetSize(widget:GetSize())

	widget.widthFrame = CreateFrame("Frame", nil, widget)
	widget.widthFrame:SetPoint("LEFT", widget.startPosFrame)
	widget.widthFrame:SetPoint("RIGHT", pointRight)
	widget.widthFrame:SetHeight(widget:GetHeight())

	widget.edb = edb
	widget.edb:SetParent(widget)

	widget.edb:SetPoint("LEFT", widget.widthFrame)

	widget.widthFrame:HookScript("OnSizeChanged", function(self, width)
		if width < 22 then width = 22 end
		widget.edb:SetWidth(width)
	end)

	widget.removeBtn = CreateFrame("Button", nil, widget, "NysTDL_RemoveButton")
	widget.removeBtn:SetPoint("LEFT", widget, "LEFT", 0, 0)
	widget.removeBtn.Icon:SetDesaturated(1)
	widget.removeBtn.Icon:SetVertexColor(1, 1, 1)
	widget.removeBtn:HookScript("OnEnter", function(self)
		self:SetAlpha(0.5)
	end)
	widget.removeBtn:HookScript("OnLeave", function(self)
		self:SetAlpha(1)
	end)
	widget.removeBtn:HookScript("OnShow", function(self)
		self:SetAlpha(1)
	end)
	widget.removeBtn:SetScript("OnClick", function()
		widget.edb:GetScript("OnEscapePressed")(widget.edb) -- hide the edit box
	end)

	return widget
end

--/*******************/ OTHER /*************************/--

function widgets:NoPointsLine(relativeFrame, thickness, r, g, b, a)
	a = a or 1
	local line = relativeFrame:CreateLine()
	line:SetThickness(thickness)
	if r and g and b and a then line:SetColorTexture(r, g, b, a) end
	return line
end

function widgets:ThemeLine(relativeFrame, theme, dim)
	return widgets:NoPointsLine(relativeFrame, 2, unpack(utils:ThemeDownTo01(utils:DimTheme(theme, dim))))
end

function widgets:HorizontalDivider(parentFrame, width, height)
	local divider = parentFrame:CreateTexture()

	divider:SetTexture((enums.icons.divider.info()))
	divider:SetTexCoord(unpack(enums.icons.divider.texCoords))
	local defaultWidth, defaultHeight = select(2, enums.icons.divider.info())
	divider:SetSize(width or defaultWidth, height or defaultHeight)

	return divider
end

---Creates a tabulation frame for sub-category display
---Don't forget to call tabulation:SetPoint() (top and bottom) afterwards!
---@return Frame tabulation
function widgets:Tabulation(parentFrame)
	local tabulation = CreateFrame("Frame", nil, parentFrame)
	tabulation:SetWidth(10)
	tabulation:Hide()

	tabulation.line = tabulation:CreateLine()
	tabulation.line:SetThickness(3)
	tabulation.line:SetColorTexture(0.3, 0.3, 0.3, 0.5)
	tabulation.line:SetStartPoint("TOP", tabulation)
	tabulation.line:SetEndPoint("BOTTOM", tabulation)
	tabulation.line:SetDrawLayer("BACKGROUND")
	tabulation.line:Show()

	return tabulation
end

function widgets:TabIconFrame(parentFrame, size, offsetX, offsetY, btnOffsetX, btnOffsetY, btnSizeX, btnSizeY)
	-- Returns a frame used as a mini tab with an icon instead of text
	-- the table is as follows:
	-- 	return frame
	--		frame is a Frame
	--		frame.backdrop is the background
	--		frame.btn is the clickable Button

	local frame = CreateFrame("Frame", nil, parentFrame, nil)
	frame:SetPoint("TOPRIGHT", parentFrame, "BOTTOMRIGHT", offsetX, offsetY)
	frame:SetSize(size, size+1)
	frame:SetFrameStrata("BACKGROUND")
	frame:SetClipsChildren(true)

	frame.backdrop = CreateFrame("Frame", nil, frame, BackdropTemplateMixin and "BackdropTemplate" or nil)
	frame.backdrop:SetBackdrop(enums.backdrop)
	frame.backdrop:SetBackdropColor(utils:ThemeDownTo01(enums.backdropColor, true))
	frame.backdrop:SetBackdropBorderColor(utils:ThemeDownTo01(enums.backdropBorderColor, true))
	frame.backdrop:SetPoint("TOPLEFT", frame, "TOPLEFT", 0, 5)
	frame.backdrop:SetSize(frame:GetWidth(), frame:GetHeight()+2)
	frame.backdrop:SetClipsChildren(true)

	frame.btn = CreateFrame("Button", nil, frame, "NysTDL_OverflowButton")
	frame.btn:SetPoint("CENTER", frame, "CENTER", btnOffsetX, btnOffsetY)
	frame.btn:SetSize(btnSizeX or 0, btnSizeY or 0)
	local inset = -frame:GetWidth()*0.35
	frame.btn:SetHitRectInsets(inset, inset, inset, inset)
	frame.btn.Highlight:SetPoint("TOPLEFT", frame, "TOPLEFT", 2, 1)
	frame.btn.Highlight:SetPoint("BOTTOMRIGHT", frame, "BOTTOMRIGHT", -2, 4)
	frame.btn:SetScript("OnMouseDown", function(self)
		self:ClearAllPoints()
		self:SetPoint("CENTER", self:GetParent(), "CENTER", btnOffsetX+1, btnOffsetY-2)
	end)
	frame.btn:SetScript("OnMouseUp", function(self)
		self:ClearAllPoints()
		self:SetPoint("CENTER", self:GetParent(), "CENTER", btnOffsetX, btnOffsetY)
	end)

	widgets:AddTooltipToButton(frame.btn, "...", 12, 8)

	return frame
end

function widgets:Slider(parentFrame, value, minValue, maxValue, Title)
	-- creates and returns a slider (w/ BottomText), either with the dragonflight theme or the classic theme
	-- used for the mainFrame's opacity sliders
	-- DRY

	local slider = CreateFrame("Slider", "NysTDL_Slider_"..tostring(dataManager:NewID()), parentFrame, utils:IsDF() and "MinimalSliderWithSteppersTemplate" or "OptionsSliderTemplate")
	slider:SetWidth(200)

	if utils:IsDF() then
		local Enum = MinimalSliderWithSteppersMixin.Label
		local formatters = {
			[Enum.Right] = function(value) return value end,
			[Enum.Min] = function() return tostring(minValue).."%" end,
			[Enum.Max] = function() return tostring(maxValue).."%" end,
			[Enum.Top] = function() return Title end,
		}
		slider:Init(value, minValue, maxValue, maxValue-minValue, formatters)
		local hookScript = function(self, ...) slider.Slider:HookScript(...) end
		slider.SetScript = hookScript
		slider.HookScript = hookScript
	else
		slider:SetObeyStepOnDrag(true)
		slider:SetMinMaxValues(minValue, maxValue)
		slider:SetValueStep(1)
		slider:SetValue(value)

		_G[slider:GetName() .. 'Low']:SetText(tostring(minValue).."%") -- sets the left-side slider text (default is "Low")
		_G[slider:GetName() .. 'High']:SetText(tostring(maxValue).."%") -- sets the right-side slider text (default is "High")
		_G[slider:GetName() .. 'Text']:SetText(Title) -- sets the "title" text (top-center of slider)

		slider.BottomText = slider:CreateFontString("NysTDL_FontString_"..tostring(dataManager:NewID())) -- the font string to see the current value -- NAME IS MANDATORY
		slider.BottomText:SetPoint("TOP", slider, "BOTTOM", 0, 0)
		slider.BottomText:SetFontObject("GameFontNormalSmall")
		slider.BottomText:SetText(slider:GetValue())

		slider:HookScript("OnValueChanged", function(self, value)
			slider.BottomText:SetText(tostring(value))
		end)
	end

	return slider
end

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

function private:Event_widgetsFrame_OnUpdate(elapsed)
	widgetsFrame.timeSinceLastUpdate = widgetsFrame.timeSinceLastUpdate + elapsed
	widgetsFrame.timeSinceLastRefresh = widgetsFrame.timeSinceLastRefresh + elapsed

	-- // every frame // --

	-- ...

	-- // ----------- // --

	while widgetsFrame.timeSinceLastUpdate > updateRate do
		widgetsFrame.timeSinceLastUpdate = widgetsFrame.timeSinceLastUpdate - updateRate

		-- // every 0.05 sec // -- (20 times per second, instead of every frame which is every 1/144 (0.007) sec for a 144hz display... optimization :D)

		-- rainbow update
		if NysTDL.acedb.profile.rainbow then
			if next(descFrames) or mainFrame:GetFrame():IsShown() then -- we don't really need to update the color at all times
				mainFrame:ApplyNewRainbowColor()
			end
		end

		-- // -------------- // --

		while widgetsFrame.timeSinceLastRefresh > refreshRate do
			widgetsFrame.timeSinceLastRefresh = widgetsFrame.timeSinceLastRefresh - refreshRate

			-- // every 1 sec // --

			-- xxx

			-- // ----------- // --
		end
	end
end

function widgets:Initialize()
	-- first we create every visual widget of every file
	widgets:CreateTDLButton()
	databroker:CreateDatabrokerObject()
	-- databroker:CreateTooltipFrame() -- TDLATER
	databroker:CreateMinimapButton()
	mainFrame:CreateTDLFrame()
	tabsFrame:CreateTabsFrame()

	-- then we manage the widgetsFrame
	widgetsFrame.timeSinceLastUpdate = 0
	widgetsFrame.timeSinceLastRefresh = 0
	widgetsFrame:SetScript("OnUpdate", private.Event_widgetsFrame_OnUpdate)

	-- and finally, we can refresh everything
	widgets:ProfileChanged()
end

function widgets:ProfileChanged()
	-- visual updates to match the new profile
	widgets:RefreshTDLButton()
	databroker:SetMode(NysTDL.acedb.profile.databrokerMode)
	-- TDLATER ici ligne pr refresh tooltip frame de databroker
	databroker:RefreshMinimapButton()

	widgets:WipeDescFrames()
	mainFrame:Init()
	tabsFrame:Init()
	tutorialsManager:Refresh()
end
