GridLayout.lua

--[[
Created by Grid2 original authors, modified by Michael
--]]

local Grid2Layout = Grid2:NewModule("Grid2Layout")

local Grid2 = Grid2
local GetSetupValue = Grid2.GetSetupValue
local UnitExists = UnitExists
local InCombatLockdown = InCombatLockdown
local math, pairs, ipairs, next, strmatch, strsplit = math, pairs, ipairs, next, strmatch, strsplit

--{{{ Frame config function for secure headers
local function GridHeader_InitialConfigFunction(self, name)
	Grid2Frame:RegisterFrame(_G[name])
end
--}}}

--{{{ Class for group headers

local NUM_HEADERS = 0
local SPECIAL_HEADERS = {
	player       = 'Grid2InsecureGroupPlayerHeaderTemplate',
	target       = 'Grid2InsecureGroupTargetHeaderTemplate',
	focus        = 'Grid2InsecureGroupFocusHeaderTemplate' ,
	targettarget = 'Grid2InsecureGroupTargetTargetHeaderTemplate',
	focustarget  = 'Grid2InsecureGroupFocusTargetHeaderTemplate' ,
}
local FRAMES_TEMPLATE = "SecureUnitButtonTemplate"                        .. (BackdropTemplateMixin and ",BackdropTemplate" or "")
local FRAMEC_TEMPLATE = "ClickCastUnitTemplate,SecureUnitButtonTemplate"  .. (BackdropTemplateMixin and ",BackdropTemplate" or "")
local SECURE_INIT_TMP =  [[
	self:SetAttribute("*type1", "target")
	self:SetAttribute("*type2", "togglemenu")
	self:SetAttribute("useparent-toggleForVehicle", true)
	self:SetAttribute("useparent-allowVehicleTarget", true)
	self:SetAttribute("useparent-unitsuffix", true)
	local header = self:GetParent()
	local clickcast = header:GetFrameRef("clickcast_header")
	if clickcast then
		clickcast:SetAttribute("clickcast_button", self)
		clickcast:RunAttribute("clickcast_register")
	end
	header:CallMethod("initialConfigFunction", self:GetName())
]]
local SECURE_INIT = SECURE_INIT_TMP

local GridLayoutHeaderClass = {
	prototype = {},
	new = function (self, template)
		NUM_HEADERS = NUM_HEADERS + 1
		local frame = CreateFrame("Frame", "Grid2LayoutHeader"..NUM_HEADERS, Grid2Layout.frame, template )
		for name, func in pairs(self.prototype) do
			frame[name] = func
		end
		if ClickCastHeader and not self.isInsecure then
			frame:SetAttribute("template", FRAMEC_TEMPLATE)
			SecureHandler_OnLoad(frame)
			frame:SetFrameRef("clickcast_header", Clique.header)
		else
			frame:SetAttribute("template", FRAMES_TEMPLATE)
		end
		frame.initialConfigFunction = GridHeader_InitialConfigFunction
		frame:SetAttribute("initialConfigFunction", SECURE_INIT)
		frame:Reset()
		return frame
	end,
	template = function(self, dbx, insecure)
		local temp
		if dbx.type=='custom' then
			temp = SPECIAL_HEADERS[dbx.unitsFilter] or 'Grid2InsecureGroupCustomHeaderTemplate'
		elseif insecure or (dbx.nameList and (dbx.roleFilter or dbx.groupFilter)) then
			temp = dbx.type=='pet' and 'Grid2InsecureGroupPetHeaderTemplate' or 'Grid2InsecureGroupHeaderTemplate'
		else
			temp = dbx.type=='pet' and 'SecureGroupPetHeaderTemplate' or 'SecureGroupHeaderTemplate'
		end
		return temp, dbx.headerName and temp..dbx.headerName or temp
	end,
}

local HeaderAttributes = {
	"nameList", "groupFilter", "roleFilter", "strictFiltering",
	"sortDir", "groupBy", "groupingOrder", "maxColumns", "unitsPerColumn",
	"startingIndex", "columnSpacing", "columnAnchorPoint",
	"useOwnerUnit", "filterOnPet", "unitsuffix", "sortMethod",
	"toggleForVehicle", "showSolo", "showPlayer", "showParty", "showRaid",
	-- extra attributes used only by Grid2 Special Group Header
	"hideEmptyUnits", "unitsFilter", "detachHeader", "frameSpacing", "testMode", "headerName"
}

function GridLayoutHeaderClass.prototype:Reset()
	-- Hide the header before initializing attributes to avoid a lot of unnecesary SecureGroupHeader_Update() calls
	self:Hide()
	self:SetSize(1,1)
	-- SecureGroupFrames code does not correctly resets all the buttons, we need to do it manually because
	-- Grid2Frame relies on :OnAttributeChanged() event to add/delete units in roster and unit_frames tables.
	for _,uframe in ipairs(self) do
		if uframe.unit==nil then break end
		uframe:SetAttribute("unit", nil)
	end
	-- Initialize attributes
	local defaults = Grid2Layout.customDefaults
	for _, attr in ipairs(HeaderAttributes) do
		self:SetAttribute(attr, defaults[attr] or nil  )
	end
	--
	self.dbx = nil
end

local anchorPoints = {
	[false] = { TOPLEFT = "TOP" , TOPRIGHT= "TOP"  , BOTTOMLEFT = "BOTTOM", BOTTOMRIGHT = "BOTTOM" },
	[true]  = { TOPLEFT = "LEFT", TOPRIGHT= "RIGHT", BOTTOMLEFT = "LEFT"  , BOTTOMRIGHT = "RIGHT"  },
	TOP = -1, BOTTOM = 1, LEFT = 1, RIGHT = -1,
}

-- nil or false for vertical
function GridLayoutHeaderClass.prototype:SetOrientation(horizontal)
	local settings  = Grid2Layout.db.profile
	local vertical  = not horizontal
	local point     = anchorPoints[not vertical][self.groupAnchor]
	local direction = anchorPoints[point]
	local xOffset   = horizontal and settings.Padding*direction or 0
	local yOffset   = vertical   and settings.Padding*direction or 0
	self:SetAttribute( "xOffset", xOffset )
	self:SetAttribute( "yOffset", yOffset )
	self:ClearChildPoints()
	self:SetAttribute( "point", point )
end

-- Force a header Update, frame units and header size are updated
function GridLayoutHeaderClass.prototype:Update()
	if self:IsVisible() then
		self:Hide()
		self:Show()
	end
end

-- MSaint fix see: https://authors.curseforge.com/forums/world-of-warcraft/official-addon-threads/unit-frames/grid-grid2/222108-grid-compact-party-raid-unit-frames?page=11#c219
-- Must be called just before assigning the attributes: "point", "columnAnchorPoint" or "unitsPerColumn". But for optimization purposes we are calling the funcion only before
-- assigning "point" attribute inside SetOrientation() method, because this is the last attribute assigned when a layout is loaded.
-- Be carefull when changing the order in which these attributes are assigned in future changes.
function GridLayoutHeaderClass.prototype:ClearChildPoints()
	local count, uframe = 1, self:GetAttribute("child1")
	while uframe do
		uframe:ClearAllPoints()
		count = count + 1
		uframe = self:GetAttribute("child" .. count)
	end
end

--{{{ Grid2Layout

-- AceDB defaults
Grid2Layout.defaultDB = {
	profile = {
		--theme options ( active theme options in: self.db.profile, first theme options in: self.dba.profile, extra themes in: self.dba.profile.extraThemes[] )
		layouts = { solo = "By Group", party = "By Group", arena = "By Group", raid  = "By Group" },
		FrameDisplay = "Always",
		horizontal = true,
		clamp = true,
		FrameLock = false,
		Padding = 0,
		Spacing = 10,
		ScaleSize = 1,
		BorderTexture = "Blizzard Tooltip",
		BackgroundTexture = "Blizzard ChatFrame Background",
		BorderR = .5,
		BorderG = .5,
		BorderB = .5,
		BorderA = 1,
		BackgroundR = .1,
		BackgroundG = .1,
		BackgroundB = .1,
		BackgroundA = .65,
		anchor = "TOPLEFT",
		groupAnchor = "TOPLEFT",
		PosX = 500,
		PosY = -200,
		Positions = {},
		anchors = {},
		groupAnchors = {},
		groupHorizontals = {},
		unitsPerColumns = {},
		-- profile options shared by all themes, but stored on default/first theme
		minimapIcon = { hide = false },
	},
	global = {
		customLayouts  = {},
		customDefaults = { toggleForVehicle = true, showSolo = true, showPlayer = true, showParty = true, showRaid = true },
	},
}

Grid2Layout.groupFilters =  {
	{ groupFilter = "1" }, { groupFilter = "2" }, { groupFilter = "3" }, {	groupFilter = "4" },
	{ groupFilter = "5" }, { groupFilter = "6" }, {	groupFilter = "7" }, {	groupFilter = "8" },
}

Grid2Layout.groupsFilters = { "1", "1,2", "1,2,3", "1,2,3,4", "1,2,3,4,5", "1,2,3,4,5,6", "1,2,3,4,5,6,7", "1,2,3,4,5,6,7,8" }

Grid2Layout.relativePoints = {
	[false] = { TOPLEFT = "BOTTOMLEFT", TOPRIGHT = "BOTTOMRIGHT", BOTTOMLEFT = "TOPLEFT",     BOTTOMRIGHT = "TOPRIGHT"   },
	[true]  = { TOPLEFT = "TOPRIGHT",   TOPRIGHT = "TOPLEFT",     BOTTOMLEFT = "BOTTOMRIGHT", BOTTOMRIGHT = "BOTTOMLEFT" },
	xMult   = { TOPLEFT =  1, TOPRIGHT = -1, BOTTOMLEFT = 1, BOTTOMRIGHT = -1 },
	yMult   = { TOPLEFT = -1, TOPRIGHT = -1, BOTTOMLEFT = 1, BOTTOMRIGHT =  1 },
}

Grid2Layout.layoutSettings = {}

Grid2Layout.layoutHeaderClass = GridLayoutHeaderClass

function Grid2Layout:OnModuleInitialize()
	-- useful variables
	self.dba = self.db
	self.db = { global = self.dba.global, profile = self.dba.profile, shared = self.dba.profile }
	self.groups  = setmetatable( {}, { __index = function(t,k) t[k]= {}; return t[k]; end } )
	self.indexes = setmetatable( {}, { __index = function(t,k) return 0;  end } )
	self.groupsUsed = {}
	-- create main frame
	self.frame = CreateFrame("Frame", "Grid2LayoutFrame", UIParent)
	self.frame:SetMovable(true)
	self.frame:SetPoint("CENTER", UIParent, "CENTER")
	self.frame:SetScript("OnMouseUp", function () self:StopMoveFrame() end)
	self.frame:SetScript("OnHide", function () self:StopMoveFrame() end)
	self.frame:SetScript("OnMouseDown", function (_, button) self:StartMoveFrame(button) end)
	-- extra frame for background and border textures, to be able to resize in combat
	self.frame.frameBack = CreateFrame("Frame", "Grid2LayoutFrameBack", self.frame, BackdropTemplateMixin and "BackdropTemplate" or nil)
	-- custom defaults
	self.customDefaults = self.db.global.customDefaults
	-- avoid insecure headers in release versions
	self.useInsecureHeaders = (Grid2.debugging or Grid2.isVanilla) and self.db.global.useInsecureHeaders or nil
	-- add custom layouts
	self:AddCustomLayouts()
end

function Grid2Layout:OnModuleEnable()
	self:UpdateMenu()
	self:FixLayouts()
	self:UpdateFrame()
	self:UpdateTextures()
	self:RegisterMessage("Grid_RosterUpdate")
	self:RegisterMessage("Grid_GroupTypeChanged")
	self:RegisterMessage("Grid_UpdateLayoutSize")
	if not Grid2.isClassic then
		self:RegisterEvent("PET_BATTLE_OPENING_START", "PetBattleTransition")
		self:RegisterEvent("PET_BATTLE_CLOSE", "PetBattleTransition")
		self:RegisterEvent("ZONE_CHANGED_NEW_AREA")
		self:RegisterEvent("UNIT_TARGETABLE_CHANGED")
	end
end

function Grid2Layout:OnModuleDisable()
	self:UnregisterMessage("Grid_RosterUpdate")
	self:UnregisterMessage("Grid_GroupTypeChanged")
	self:UnregisterMessage("Grid_UpdateLayoutSize")
	if not Grid2.isClassic then
		self:UnregisterEvent("PET_BATTLE_OPENING_START")
		self:UnregisterEvent("PET_BATTLE_CLOSE")
		self:UnregisterEvent("ZONE_CHANGED_NEW_AREA")
		self:UnregisterEvent("UNIT_TARGETABLE_CHANGED")
	end
	self.frame:Hide()
end

function Grid2Layout:OnModuleUpdate()
	self:UpdateMenu()
	self:FixLayouts()
	self:RefreshTheme()
end

function Grid2Layout:UpdateTheme()
	local themes = self.dba.profile.extraThemes
	self.db.profile = themes and themes[Grid2.currentTheme] or self.dba.profile
	self.db.shared = self.dba.profile
	self:UpgradeThemeDB()
end

function Grid2Layout:RefreshTheme()
	self:UpdateFrame()
	self:ResetHeadersFramesSize()
	self:ReloadLayout(true)
end

function Grid2Layout:UpgradeThemeDB()
	local p = self.db.profile
	p.Positions = p.Positions or {}
	p.anchors = p.anchors or {}
	p.groupAnchors =  p.groupAnchors or {}
	p.groupHorizontals = p.groupHorizontals or {}
	p.unitsPerColumns = p.unitsPerColumns or {}
end

--{{{ Event handlers
function Grid2Layout:Grid_GroupTypeChanged(_, groupType, instType, maxPlayers, maxGroup)
	self:Debug("GroupTypeChanged", groupType, instType, maxPlayers, maxGroup)
	if not Grid2:ReloadTheme() then
		if not self:ReloadLayout() then
			if not self:UpdateFramesSizeByRaidSize() then
				self:UpdateVisibility()
			end
		end
	end
end

function Grid2Layout:Grid_RosterUpdate(_, unknowns)
	if unknowns and not self.useInsecureHeaders then
		Grid2:RunThrottled(self, "FixRoster", .25)
	end
end

-- Fixing Shadowlands bug when entering Maw Zone, see ticket #901.
function Grid2Layout:ZONE_CHANGED_NEW_AREA()
	if C_Map.GetBestMapForUnit("player")==1543 then
		self.flagEnteringMaw = true
	end
end

function Grid2Layout:UNIT_TARGETABLE_CHANGED(_,unit)
	if unit=="player" and self.flagEnteringMaw then
		self.flagEnteringMaw = nil
		if not Grid2:RunSecure(10, self, "UpdateHeaders") then
			self:UpdateHeaders()
		end
	end
end

-- We delay UpdateSize() call to avoid calculating the wrong window size, because when "Grid_UpdateLayoutSize"
-- message is triggered the blizzard code has not yet updated the size of the secure group headers.
function Grid2Layout:Grid_UpdateLayoutSize()
	Grid2:RunThrottled(self, "UpdateSize", 0.01)
end

function Grid2Layout:PetBattleTransition(event)
	if self.db.profile.HideInPetBattle then
		local inBattle = (event == "PET_BATTLE_OPENING_START") or nil
		if inBattle or self.inBattlePet then -- PET_BATTLE_CLOSE event fires twice so we check "inBattlePet" variable to ignore the second event
			self.inBattlePet = inBattle
			self:UpdateVisibility()
		end
	end
end
--}}}

-- PopupMenu
function Grid2Layout:UpdateMenu()
	local v = Grid2Frame.db.profile.menuDisabled
	if v ~= self.RightClickMenuDisabled then
		self.RightClickMenuDisabled = v
		SECURE_INIT = v and gsub( SECURE_INIT_TMP, '"togglemenu"', 'nil' ) or SECURE_INIT_TMP
		Grid2Frame:WithAllFrames( function(f) f:SetAttribute("*type2",(not v) and "togglemenu" or nil); end )
	end
end

-- Workaround to a blizzard bug in SecureGroupHeaders.lua (see: https://www.wowace.com/projects/grid2/issues/628 )
-- In patch 8.1 SecureTemplates code does not display "unknown entities" because GetRaidRosterInfo() returns nil for these units:
-- If unknown entities are detected in roster, we update the headers every 1/4 seconds until all unknown entities are gone.
function Grid2Layout:FixRoster()
	if Grid2:RosterHasUnknowns() then
		if not Grid2:RunSecure(5, self, "FixRoster") then
			self:UpdateHeaders()
			Grid2:UpdateRoster()
		end
	end
end

function Grid2Layout:StartMoveFrame(button)
	if button == "LeftButton" and (self.testLayoutName or not self.db.profile.FrameLock) then
		self.frame:StartMoving()
		self.frame.isMoving = true
		self:StartHeaderTracking(self.frame)
	end
end

function Grid2Layout:StopMoveFrame()
	if self.frame.isMoving then
		self.frame:StopMovingOrSizing()
		self.frame.isMoving = false
		self:SearchSnapToNearestHeader(self.frame, true)
		self:SavePosition()
		self:RestorePosition()
	end
end

function Grid2Layout:EnableMouse(enabled)
	self.frame:EnableMouse(enabled)
	for _, frame in self:IterateHeaders(true) do -- detached headers
		frame.frameBack:EnableMouse(enabled)
	end
end

-- nil:toggle, false:disable movement, true:enable movement
function Grid2Layout:FrameLock(locked)
	local p = self.db.profile
	if locked == nil then
		p.FrameLock = not p.FrameLock
	else
		p.FrameLock = locked
	end
	self:EnableMouse(not p.FrameLock)
end

-- display: Never, Always, Grouped, Raid, false|nil = toggle Never/Always
function Grid2Layout:FrameVisibility(display)
	local p = self.db.profile
	p.FrameDisplay = display or (p.FrameDisplay=='Never' and 'Always' or 'Never')
	self:UpdateVisibility()
end

-- reload text indicators db (because text indicators have a special testMode to display header index)
function Grid2Layout:ReloadTextIndicatorsDB()
	for _,indicator in Grid2:IterateIndicators('text') do
		indicator:UpdateDB()
	end
end

-- enable layout test mode
function Grid2Layout:SetTestMode(enabled, themeIndex, layoutName, maxPlayers)
	if enabled then
		self.testLayoutName = layoutName
		self.frameEnterEvent = function() SetCursor("UI_MOVE_CURSOR") end
		Grid2.testThemeIndex, Grid2.testMaxPlayers = themeIndex, maxPlayers
	else
		self.testLayoutName = nil
		self.frameEnterEvent = nil
		Grid2.testThemeIndex, Grid2.testMaxPlayers = nil, nil
	end
	if not Grid2:ReloadTheme() then
		self:ReloadTextIndicatorsDB()
		self:ReloadLayout(true)
	end
	if not InCombatLockdown() then
		self:EnableMouse( enabled or not self.db.profile.FrameLock )
	end
end

--{{{ ConfigMode support
CONFIGMODE_CALLBACKS = CONFIGMODE_CALLBACKS or {}
CONFIGMODE_CALLBACKS["Grid2"] = function(action)
	if action == "ON" then
		Grid2Layout:FrameLock(false)
	elseif action == "OFF" then
		Grid2Layout:FrameLock(true)
	end
end
--}}}

function Grid2Layout:UpdateFrame()
	local p = self.db.profile
	local f = self.frame
	f:SetClampedToScreen(p.clamp)
	f:SetFrameStrata( p.FrameStrata or "MEDIUM")
	f:SetFrameLevel(1)
	local b = f.frameBack
	b:SetFrameStrata( p.FrameStrata or "MEDIUM")
	b:SetFrameLevel(0)
	self:EnableMouse(not p.FrameLock)
end

function Grid2Layout:SetupMainFrame()
	local frame = self.frame
	frame.headerPosKey = self.layoutHasDetached and self.layoutName or nil -- used if there are detached headers to save/restore position in different place on db
	if frame:GetWidth()==0 then
		frame:SetSize(1,1) -- assign a default size, to make frame visible if we are in combat after a UI reload
	end
	frame:SetScript("OnEnter", self.frameEnterEvent)
end

function Grid2Layout:SetClamp()
	self.frame:SetClampedToScreen(self.db.profile.clamp)
end

function Grid2Layout:ResetHeaders()
	self.layoutHasAuto     = nil
	self.layoutHasDetached = nil
	for type, headers in pairs(self.groups) do
		for i=self.indexes[type],1,-1 do
			headers[i]:Reset()
		end
		self.indexes[type] = 0
	end
	wipe(self.groupsUsed)
end

function Grid2Layout:PlaceHeaders()
	local settings   = self.db.profile
	local horizontal = settings.horizontal
	local vertical   = not horizontal
	local padding    = settings.Padding
	local spacing    = settings.Spacing
	local anchor     = settings.groupAnchor
	local relPoint   = self.relativePoints[vertical][anchor]
	local xMult1     = self.relativePoints.xMult[anchor]
	local yMult1     = self.relativePoints.yMult[anchor]
	local xMult2 	 = vertical   and xMult1*padding or 0
	local yMult2 	 = horizontal and yMult1*padding or 0
	local xMult3     = xMult2 + (vertical   and xMult1*spacing*2 or 0)
	local yMult3     = yMult2 + (horizontal and yMult1*spacing*2 or 0)
	local prevFrame
	self:RestorePosition()
	for i, frame in self:IterateHeaders(false) do -- non detached headers
		frame:SetOrientation(horizontal)
		frame:ClearAllPoints()
		frame:SetParent(self.frame)
		if prevFrame then
			frame:SetPoint(anchor, prevFrame, relPoint, xMult2, yMult2 )
		else
			frame:SetPoint(anchor, self.frame, anchor, spacing * xMult1, spacing * yMult1)
		end
		frame:Show()
		prevFrame = frame
	end
	for i, frame in self:IterateHeaders(true) do -- detached headers
		frame:SetOrientation(frame.groupHorizontal)
		frame:SetParent(self.frame)
		if not self:RestoreHeaderPosition(frame) then
			self:SaveHeaderPositionForFirstTime( i, frame, anchor, relPoint, xMult3, yMult3 )
		end
	end
end

function Grid2Layout:UpdateHeaders()
	for _, header in ipairs(self.groupsUsed) do
		header:Update()
	end
end

function Grid2Layout:RefreshLayout() -- Used from Grid2Options
	self:ReloadLayout(true)
end

function Grid2Layout:SetGroupType(partyType, instType, maxPlayers, maxGroup)
	self.partyType      = partyType
	self.instType       = instType
	self.instMaxPlayers = maxPlayers
	self.instMaxGroup   = maxGroup
end

-- If player does not exist (this can happen just before a load screen when changing instances if layout load is delayed by RunSecure()
-- due to combat restrictions) we cannot setup SecureGroupHeaders so we ignore the layout change, anyway the layour will be reloaded
-- on PLAYER_ENTERING_WORLD event when the load screen finish. See Ticket #923.
function Grid2Layout:ReloadLayout(force)
	if UnitExists('player') then
		local p = self.db.profile
		local partyType, instType, maxPlayers, maxGroup = Grid2:GetGroupType()
		local layoutName = self.testLayoutName or p.layouts[maxPlayers] or p.layouts[partyType.."@"..instType] or p.layouts[partyType]
		if layoutName~=self.layoutName or (self.layoutHasAuto and (maxPlayers~=self.instMaxPlayers or maxGroup~=self.instMaxGroup)) or force or self.forceReload then
			self.forceReload = force
			if not Grid2:RunSecure(3, self, "ReloadLayout") then
				self:SetGroupType(partyType, instType, maxPlayers, maxGroup)
				self:LoadLayout(layoutName)
				self.forceReload = nil
			end
			return true
		else
			self:SetGroupType(partyType, instType, maxPlayers, maxGroup)
		end
	else
		self:Debug("ReloadLayout Ignored because player unit does not exist")
	end
end

function Grid2Layout:LoadLayout(layoutName)
	local layout = self.layoutSettings[layoutName]
	if layout then
		self:Debug("LoadLayout", layoutName)
		self.layoutName = layoutName
		self:ResetHeaders()
		if layout[1] then
			for index, layoutHeader in ipairs(layout) do
				if layoutHeader=="auto" then
					self:GenerateHeaders(layout.defaults, index)
				else
					self:AddHeader(layoutHeader, layout.defaults, index)
				end
			end
		elseif not layout.empty then
			self:GenerateHeaders(layout.defaults, 1)
		end
		self:AddSpecialHeaders()
		self:SetupMainFrame()
		self:PlaceHeaders()
		self:UpdateSize()
		self:UpdateTextures()
		self:UpdateColor()
		self:UpdateVisibility()
	end
end

--{{ Header management
function Grid2Layout:AddHeader(dbx, defaults, setupIndex, headerName)
	local template, groupType = self.layoutHeaderClass:template(dbx, self.useInsecureHeaders or self.testLayoutName)
	local index    = self.indexes[groupType] + 1
	local headers  = self.groups[groupType]
	local header   = headers[index]
	if not header then
		header = self.layoutHeaderClass:new(template)
		headers[index] = header
	end
	self.indexes[groupType] = index
	self.groupsUsed[#self.groupsUsed+1] = header
	self:SetHeaderProperties(header, dbx, setupIndex, headerName)
	self:SetHeaderAttributes(header, defaults)
	self:SetHeaderAttributes(header, dbx)
	self:FixHeaderAttributes(header, #self.groupsUsed)
	self:SetupDetachedHeader(header, setupIndex)
end

function Grid2Layout:GenerateHeaders(defaults, setupIndex)
	local testPlayers = Grid2.testMaxPlayers
	self.layoutHasAuto = not (testPlayers or self.db.profile.displayAllGroups) or nil
	local maxGroups = (testPlayers and math.ceil(testPlayers/5)) or (self.layoutHasAuto and self.instMaxGroup) or 8
	local firstIndex = setupIndex==1 and 1
	for i=1,maxGroups do
		self:AddHeader(self.groupFilters[i], defaults, firstIndex or setupIndex*100+i)
		firstIndex = nil
	end
end

function Grid2Layout:SetHeaderAttributes(header, layoutHeader)
	if layoutHeader then
		for attr, value in next, layoutHeader do
			if attr ~= 'type' then
				header:SetAttribute(attr, value)
			end
		end
	end
end

-- Display special units
do
	local template = { type = 'custom', detachHeader = true }
	local headers = { -- headerName, units/column, unitsFilter
		{ 'self',   1, 'player' },
		{ 'target', 1, 'target' },
		{ 'focus',  1, 'focus'  },
		{ 'targettarget', 1, 'targettarget' },
		{ 'focustarget',  1, 'focustarget'  },
		{ 'boss',   8, 'boss1,boss2,boss3,boss4,boss5,boss6,boss7,boss8' },
	}
	function Grid2Layout:AddSpecialHeaders()
		local specialHeaders = self.db.profile.specialHeaders
		if specialHeaders then
			for index, data in ipairs(headers) do
				local name = data[1]
				local showEmpty = specialHeaders[name]
				if showEmpty ~= nil then
					template.unitsFilter = data[3]
					template.unitsPerColumn = self.db.profile.unitsPerColumns[name] or data[2]
					template.maxColumns = math.ceil(8/template.unitsPerColumn)
					template.hideEmptyUnits = not showEmpty or nil
					self:AddHeader( template, nil, index+10000, name )
				end
			end
		end
	end
end

-- Calculate and store effective values for some header properties
do
	local BuiltInHeaders = { player = 'player', pet = 'pet', self = 'self', target = 'target', focus = 'focus', boss = 'boss', targettarget = 'targettarget', focustarget = 'focustarget' }

	function Grid2Layout:SetHeaderProperties(header, dbx, setupIndex, headerName)
		local p = self.db.profile
		header.dbx = dbx
		header.headerType = dbx.type or 'player' -- player, pet, custom
		header.headerName = headerName or dbx.headerName or header.headerType -- player, pet, self, target, focus, boss, custom or user defined
		header.headerClass = BuiltInHeaders[header.headerName] or 'other'
		header.wasDetached = header.isDetached
		header.isDetached = setupIndex>1 and (dbx.detachHeader or p.detachedHeaders=='player' or p.detachedHeaders==header.headerType) or nil
		header.groupHorizontal = GetSetupValue( header.isDetached, p.groupHorizontals[header.headerClass], p.horizontal )
		header.groupAnchor = GetSetupValue( header.isDetached, p.groupAnchors[header.headerClass], p.groupAnchor )
		header.headerAnchor = GetSetupValue( header.isDetached, p.anchors[header.headerClass], p.anchor )
		header.headerPosKey = header.isDetached and self.layoutName..setupIndex or nil -- used as key to save positions when the layout has detached headers
	end
end

-- Apply defaults and some special cases for each header and apply workarounds to some blizzard bugs
function Grid2Layout:FixHeaderAttributes(header, index)
	local p = self.db.profile
	-- testMode (only works for insecure frames)
	if self.testLayoutName then
		header:SetAttribute("testMode", Grid2.testMaxPlayers)
		header:SetAttribute("testIndex", index)
	end
	-- fix unitsPerColumn
	local unitsPerColumn = header:GetAttribute("unitsPerColumn")
	if not unitsPerColumn then
		unitsPerColumn = p.unitsPerColumns[header.headerClass] or 5
		header:SetAttribute("unitsPerColumn", unitsPerColumn)
	end
	-- fix anchors
	header:SetAttribute("columnSpacing", p.Padding)
	header:SetAttribute("columnAnchorPoint", anchorPoints[not header.groupHorizontal][header.groupAnchor] or header.groupAnchor)
	-- fix maxColumns
	local autoEnabled = not p.displayAllGroups or nil
	if header:GetAttribute("maxColumns") == "auto" then
		self.layoutHasAuto = autoEnabled
		header:SetAttribute( "maxColumns", math.ceil((autoEnabled and self.instMaxPlayers or 40)/unitsPerColumn) )
	end
	-- fix groupFilter
	local groupFilter = header:GetAttribute("groupFilter")
	if groupFilter then
		if groupFilter == "auto" then
			self.layoutHasAuto = autoEnabled
			groupFilter = self.groupsFilters[autoEnabled and self.instMaxGroup or 8] or "1"
			header:SetAttribute("groupFilter", groupFilter)
		end
		if header:GetAttribute("strictFiltering") then
			groupFilter = groupFilter .. ",DEATHKNIGHT,DEMONHUNTER,DRUID,HUNTER,MAGE,MONK,PALADIN,PRIEST,ROGUE,SHAMAN,WARLOCK,WARRIOR,EVOKER"
			header:SetAttribute("groupFilter", groupFilter)
		end
	end
	-- workaround to blizzard pet bug
	if header.dbx.type == 'pet' then -- force these so that the bug in SecureGroupPetHeader_Update doesn't trigger
		header:SetAttribute("filterOnPet", true)
		header:SetAttribute("useOwnerUnit", false)
		header:SetAttribute("unitsuffix", nil)
	end
	-- setup frames size
	self:UpdateFramesSizeForHeader(header)
	-- workaround to blizzard bug
	self:ForceFramesCreation(header)
end
--}}

-- Precreate frames to avoid a blizzard bug that prevents initializing unit frames in combat
-- https://authors.curseforge.com/forums/world-of-warcraft/official-addon-threads/unit-frames/grid-grid2/222076-grid?page=159#c3169
function Grid2Layout:ForceFramesCreation(header)
	local startingIndex = header:GetAttribute("startingIndex")
	local maxColumns = header:GetAttribute("maxColumns") or 1
	local unitsPerColumn = header:GetAttribute("unitsPerColumn") or 5
	local maxFrames = maxColumns * unitsPerColumn
	local count= header.FrameCount
	if not count or count<maxFrames then
		header:Show()
		header:SetAttribute("startingIndex", 1-maxFrames )
		header:SetAttribute("startingIndex", startingIndex)
		header.FrameCount = maxFrames
		header:Hide()
	end
end

function Grid2Layout:GetFramesSizeForHeader(header)
	local m  = Grid2.testMaxPlayers or self.instMaxPlayers
	local p  = Grid2Frame.db.profile
	local fw = p.frameWidths
	local fh = p.frameHeights
	local hw = p.frameHeaderWidths
	local hh = p.frameHeaderHeights
	local nl = not p.frameHeaderLocks[header.headerClass]
	local w = (nl and fw[m] or p.frameWidth)  * (hw[header.headerClass] or 1)
	local h = (nl and fh[m] or p.frameHeight) * (hh[header.headerClass] or 1)
	return w, h
end

-- used only in options to update configuration changes
function Grid2Layout:UpdateDisplay()
	self:UpdateTextures()
	self:UpdateColor()
	self:UpdateVisibility()
	self:UpdateFramesSize()
	self:UpdateSize()
end

-- Needed when the active theme changes to force a frames Layout() to reactivate possible suspended indicators (github issue #215)
function Grid2Layout:ResetHeadersFramesSize()
	for _, headers in pairs(self.groups) do
		for _, header in ipairs(headers) do
			header.frameWidth, header.frameHeight = nil, nil
		end
	end
end

function Grid2Layout:UpdateFramesSizeForHeader(header)
	local w, h = self:GetFramesSizeForHeader(header)
	if w~=header.frameWidth or h~=header.frameHeight or self.forceReload then -- forceReload => theme or profile changed, we need to Layout frames because icon/text sizes could change
		header.frameWidth, header.frameHeight = w, h
		for _,frame in ipairs(header) do
			frame:Layout()
		end
		return true
	end
end

function Grid2Layout:UpdateFramesSize()
	local modified
	for _,header in ipairs(self.groupsUsed) do
		modified = self:UpdateFramesSizeForHeader(header) or modified
	end
	if modified then
		Grid2Frame:UpdateIndicators()
		Grid2Layout:UpdateHeaders()
	end
	return modified
end

function Grid2Layout:UpdateFramesSizeByRaidSize()
	local p = Grid2Frame.db.profile
	if next(p.frameWidths) or next(p.frameHeights) then
		if not Grid2:RunSecure(6, self, "UpdateFramesSizeByRaidSize") then
			self:UpdateFramesSize()
			self:UpdateSize()
			self:UpdateVisibility()
		end
		return true
	end
end

function Grid2Layout:UpdateSize()
	local p = self.db.profile
	local mcol,mrow,curCol,maxRow,remSize = "GetWidth","GetHeight",0,0,0
	if p.horizontal then mcol,mrow = mrow,mcol end
	for _,g in self:IterateHeaders(false) do -- only non-detaches headers
		local row = g[mrow](g)
		if maxRow<row then maxRow = row end
		local col = g[mcol](g) + p.Padding
		curCol = curCol + col
		remSize = (g.dbx.type=='custom' or (g[1] and g[1]:IsVisible())) and 0 or remSize + col
	end
	curCol = curCol - remSize
	local col = math.max( curCol + p.Spacing*2 - p.Padding, 1 )
	local row = math.max( maxRow + p.Spacing*2, 1 )
	if p.horizontal then col,row = row,col end
	self.frame.frameBack:SetShown(curCol>1 and maxRow>1)
	self.frame.frameBack:SetSize(col,row)
	if not Grid2:RunSecure(7, self, "UpdateSize") then
		self.frame:SetSize(col,row)
	end
end

function Grid2Layout:UpdateTextures()
	local p = self.db.profile
	local backdrop = Grid2:GetBackdropTable( Grid2:MediaFetch("border", p.BorderTexture), 16, Grid2:MediaFetch("background", p.BackgroundTexture), false, nil, 4 )
	Grid2:SetFrameBackdrop(	self.frame.frameBack, backdrop )
	for _, frame in self:IterateHeaders(true) do -- detached headers
		Grid2:SetFrameBackdrop( frame.frameBack, backdrop )
	end
end

function Grid2Layout:UpdateColor()
	local settings = self.db.profile
	local frame    = self.frame.frameBack
	frame:SetBackdropBorderColor(settings.BorderR, settings.BorderG, settings.BorderB, settings.BorderA)
	frame:SetBackdropColor(settings.BackgroundR, settings.BackgroundG, settings.BackgroundB, settings.BackgroundA)
	frame:SetShown( settings.BorderA~=0 or settings.BackgroundA~=0 )
	for _, frame in self:IterateHeaders(true) do
		frame.frameBack:SetBackdropBorderColor(settings.BorderR, settings.BorderG, settings.BorderB, settings.BorderA)
		frame.frameBack:SetBackdropColor(settings.BackgroundR, settings.BackgroundG, settings.BackgroundB, settings.BackgroundA)
	end
end

function Grid2Layout:UpdateVisibility()
	if not Grid2:RunSecure(8, self, "UpdateVisibility") then
		local fd, pt = self.db.profile.FrameDisplay, Grid2:GetGroupType()
		self.frame:SetShown(
			self.testLayoutName~=nil or (
				fd~='Never' and
				( (fd == "Always") or (fd == "Grouped" and pt ~= "solo") or (fd == "Raid" and pt == "raid" ) ) and
				not (self.db.profile.HideInPetBattle and self.inBattlePet)
			)
		)
	end
end

-- Grid2 uses UI root coordinates to store the window position (always 768 pixels height) so these coordinates are
-- independent of the UI Frame Scale Coordinates and monitor physical resolution (assuming the same aspect ratio).
function Grid2Layout:SavePosition(header)
	local f = header or self.frame
	if f:GetLeft() and f:GetWidth() then
		local p = self.db.profile
		local a = f.headerAnchor or p.anchor
		local s = f:GetEffectiveScale()
		local t = UIParent:GetEffectiveScale()
		local x = (a:find("LEFT")  and f:GetLeft()*s) or
				  (a:find("RIGHT") and f:GetRight()*s-UIParent:GetWidth()*t) or
				  (f:GetLeft()+f:GetWidth()/2)*s-UIParent:GetWidth()/2*t
		local y = (a:find("BOTTOM") and f:GetBottom()*s) or
				  (a:find("TOP")    and f:GetTop()*s-UIParent:GetHeight()*t) or
				  (f:GetTop()-f:GetHeight()/2)*s-UIParent:GetHeight()/2*t
		if f.headerPosKey then
			p.Positions[f.headerPosKey] = { a, x, y }
		else
			p.PosX, p.PosY = x, y
		end
		self:Debug("Saved Position", a, x, y, k)
	end
end

-- Restores the Grid2 main window position, the window is always placed in the same exact absolute screen position
-- even if the WoW UI Scale or Grid2 window Scale was changed (assuming the screen aspect ratio has not changed).
-- It does not restore detached headers positions, Grid2Layout:RestorePositions() can be used instead.
function Grid2Layout:RestorePosition()
	if InCombatLockdown() then return end
	local p = self.db.profile
	-- foreground frame
	local f = self.frame
	f:SetScale(p.ScaleSize)
	local a, x, y = self:GetFramePosition(f)
	f:ClearAllPoints()
	f:SetPoint(a, x, y)
	-- background frame
	local b = f.frameBack
	b:ClearAllPoints()
	b:SetPoint(p.groupAnchor) -- Using groupAnchor instead of anchor, see ticket #442.
	self:Debug("Restored Position", a, p.ScaleSize, x, y)
end

function Grid2Layout:ResetPosition()
	local p  = self.db.profile
	local s  = UIParent:GetEffectiveScale()
	p.PosX   =   UIParent:GetWidth()  / 2 * s
	p.PosY   = - UIParent:GetHeight() / 2 * s
	p.anchor = "TOPLEFT"
	self:RestorePosition()
	self:SavePosition()
	if self.layoutHasDetached then
		for _,header in self:IterateHeaders(true) do
			p.Positions[header.headerPosKey] = nil
		end
		self:ReloadLayout(true)
	end
end

--{{{ Detached headers management
function Grid2Layout:SetupDetachedHeader(header, setupIndex)
	local isDetached = header.isDetached
	if isDetached ~= header.wasDetached then
		local frameBack = header.frameBack
		header.wasDetached = isDetached
		header:SetMovable(not not isDetached)
		if isDetached then
			frameBack = frameBack or CreateFrame("Frame", nil, header, BackdropTemplateMixin and "BackdropTemplate" or nil)
			frameBack.header = header
			frameBack:SetScript("OnMouseUp", self.StopMoveHeader )
			frameBack:SetScript("OnHide", self.StopMoveHeader )
			frameBack:SetScript("OnMouseDown", self.StartMoveHeader)
			header:SetScript("OnSizeChanged", self.UpdateDetachedVisibility)
			header.frameBack = frameBack
		elseif frameBack then
			frameBack:Hide()
			frameBack:ClearAllPoints()
			frameBack:SetScript("OnMouseUp",   nil)
			frameBack:SetScript("OnHide",      nil)
			frameBack:SetScript("OnMouseDown", nil)
			header:SetScript("OnSizeChanged", nil)
		end
	end
	if isDetached then
		local frameBack, Spacing, button = header.frameBack, self.db.profile.Spacing, header[1]
		frameBack:ClearAllPoints()
		frameBack:SetPoint('TOPLEFT', header, 'TOPLEFT', -Spacing, Spacing )
		frameBack:SetPoint('BOTTOMRIGHT', header, 'BOTTOMRIGHT', Spacing, -Spacing )
		frameBack:SetFrameLevel(0)
		frameBack:SetScript("OnEnter", self.frameEnterEvent)
		frameBack:Hide()
		self.layoutHasDetached = true
	end
end

function Grid2Layout:SaveHeaderPosition(header)
	self:SavePosition(header)
end

function Grid2Layout:SaveHeaderPositionForFirstTime(i, frame, anchor, relPoint, xMult3, yMult3)
	frame:ClearAllPoints()
	frame:SetClampedToScreen(true)
	frame:SetPoint(anchor, self.groupsUsed[i-1] or self.frame, relPoint, xMult3, yMult3)
	frame:Show()
	C_Timer.After(0, function()
		self:SaveHeaderPosition(frame)
		self:RestoreHeaderPosition(frame)
		frame:SetClampedToScreen(false)
	end)
end

function Grid2Layout:RestoreHeaderPosition(header)
	if InCombatLockdown() then return end
	local p = self.db.profile
	local pos = p.Positions[header.headerPosKey]
	if pos then
		local s = header:GetEffectiveScale()
		local a, x, y = pos[1], pos[2]/s, pos[3]/s
		header:ClearAllPoints()
		header:SetPoint(a, UIParent, a, x, y)
		header:Show()
		if a ~= header.headerAnchor then
			self:SavePosition(header)
			return self:RestoreHeaderPosition(header)
		end
		self:Debug("Placing detached group", header.headerPosKey, a, x, y)
		return true
	end
end

function Grid2Layout:UpdateDetachedVisibility(test) -- self~=Grid2Layout
	local button = self[1] -- self.header[1]
	self.frameBack:SetShown( button and button:IsVisible() )
end

function Grid2Layout:GetFramePosition(f)
	local p = self.db.profile
	local s = f:GetEffectiveScale()
	if f.headerPosKey then
		local pos = p.Positions[f.headerPosKey]
		if pos then	return pos[1], pos[2]/s, pos[3]/s end
		p.Positions[f.headerPosKey] = { p.anchor, p.PosX, p.PosY }
	end
	return p.anchor, p.PosX/s, p.PosY/s
end

function Grid2Layout:SnapHeaderToPoint(a1, header1, a2, x2, y2, intersect)
	local p  = self.db.profile
	local mf = header1 == self.frame and 0 or 1
	local xm = self.relativePoints.xMult[a1]
	local ym = self.relativePoints.yMult[a1]
	local x  = x2 + p.Spacing * xm * mf
	local y  = y2 + p.Spacing * ym * mf
	if intersect then -- intersect, substract border
		local sp = p.Padding - p.Spacing*2
		x = x + sp * xm * (not strfind(a1,'LEFT')~=not strfind(a2,'LEFT') and 1 or 0)
		y = y + sp * ym * (not strfind(a1,'TOP') ~=not strfind(a2,'TOP')  and 1 or 0)
	end
	header1:ClearAllPoints()
	header1:SetPoint(a1, UIParent, 'BOTTOMLEFT', x, y)
end

function Grid2Layout:SearchSnapToNearestHeader(header, adjust)
	if IsShiftKeyDown() or not self.layoutHasDetached or InCombatLockdown() then return end
	local frameBack = header.frameBack
	local x1, x2, y1, y2, xx1, xx2, yy1, yy2, intersect = frameBack:GetLeft(), frameBack:GetRight(), frameBack:GetTop(), frameBack:GetBottom()
	local function Check(a1,xxx1,yyy1,a2,xxx2,yyy2)
		if a1~=a2 and (xxx2-xxx1)^2+(yyy2-yyy1)^2<512 then
			intersect = not (x1>=xx2 or xx1>=x2 or y1<=yy2 or yy1<=y2)
			if adjust then self:SnapHeaderToPoint(a1, header, a2, xxx2, yyy2, intersect) end
			return true
		end
	end
	local function CheckPoint(a, x, y)
		return Check("TOPLEFT",x1,y1,a,x,y) or Check("TOPRIGHT",x2,y1,a,x,y) or Check("BOTTOMLEFT",x1,y2,a,x,y) or Check("BOTTOMRIGHT",x2,y2,a,x,y)
	end
	local function CheckFrame(frame, force)
		if header~=frame and (frame.isDetached or force) then -- check only main frame and detached headers
			local frameBack = frame.frameBack
			xx1, xx2, yy1, yy2 = frameBack:GetLeft(), frameBack:GetRight(), frameBack:GetTop(), frameBack:GetBottom()
			return (CheckPoint("TOPLEFT",xx1,yy1) or CheckPoint("TOPRIGHT",xx2,yy1) or CheckPoint("BOTTOMLEFT",xx1,yy2) or CheckPoint("BOTTOMRIGHT",xx2,yy2)) and frame
		end
	end
	local result = CheckFrame(self.frame, true) -- check main frame (parent of all non-detached headers)
	if not result then
		for _,frame in ipairs(self.groupsUsed) do
			result = CheckFrame(frame)
			if result then break end
		end
	end
	return result, intersect
end

function Grid2Layout:IterateHeaders(detached) -- true = detached headers; false|nil = non-detached headers
	if detached and not self.layoutHasDetached then return Grid2.Dummy end
	local i, t, d = 0, self.groupsUsed, detached or nil
	return function()
		repeat
			i = i + 1; if i>#t then return end
		until d == t[i].isDetached
		return i, t[i]
	end
end

-- Restores the Grid2 main window position and all possible detached headers (for use by external code like macros or weakauras)
function Grid2Layout:RestorePositions()
	self:RestorePosition()
	for _, frame in self:IterateHeaders(true) do -- detached headers
		self:RestoreHeaderPosition(frame)
	end
end

-- Dragging management
do
	local LCG = LibStub("LibCustomGlow-1.0")
	local colors = { [false] = {1,1,0,1}, [true] = {1,0,0,1} }
	local trackedHeader, nearestHeader, nearestOverlap

	local function HighlightHeader(header, enable, overlap)
		if header then
			header = header.isDetached and header.frameBack or header
			if enable then
				LCG.PixelGlow_Start( header, colors[overlap], 8, .2, nil, 1, 0,0, false, 'Grid2DragHighlight' )
			else
				LCG.PixelGlow_Stop( header, 'Grid2DragHighlight' )
			end
		end
	end

	local function TrackHeader()
		local newHeader, newOverlap
		if trackedHeader.isMoving and not IsShiftKeyDown() then
			newHeader, newOverlap = Grid2Layout:SearchSnapToNearestHeader(trackedHeader)
		end
		if newHeader~=nearestHeader or newOverlap~=nearestOverlap then
			HighlightHeader(nearestHeader, false )
			HighlightHeader(newHeader,     newHeader~=nil, newOverlap )
			HighlightHeader(trackedHeader, newHeader~=nil, newOverlap )
			nearestHeader, nearestOverlap = newHeader, newOverlap
		end
		if trackedHeader.isMoving and not InCombatLockdown() then
			C_Timer.After( .2, TrackHeader )
		end
	end

	function Grid2Layout:StartHeaderTracking(header)
		if self.layoutHasDetached then
			trackedHeader, nearestHeader = header, nil
			TrackHeader()
		end
	end

	function Grid2Layout:StartMoveHeader(button) -- called from frame event so: self == header.frameBack ~= Grid2Layout
		if button == "LeftButton" and (Grid2Layout.testLayoutName or not Grid2Layout.db.profile.FrameLock) then
			self.header:StartMoving()
			self.header.isMoving = true
			Grid2Layout:StartHeaderTracking(self.header)
		end
	end

	function Grid2Layout:StopMoveHeader() -- called from frame event so: self == header.frameBack ~= Grid2Layout
		if self.header.isMoving then
			self.header:StopMovingOrSizing()
			self.header.isMoving = nil
			Grid2Layout:SearchSnapToNearestHeader(self.header, true)
			Grid2Layout:SaveHeaderPosition(self.header)
			Grid2Layout:RestoreHeaderPosition(self.header)
		end
	end
end
--}}}

--{{{ Layouts registration
function Grid2Layout:AddLayout(layoutName, layout)
	self.layoutSettings[layoutName] = layout
end

-- Fix non existent layouts for a theme
function Grid2Layout:FixLayoutsTable(db)
	local defaults = self.defaultDB.profile.layouts
	for groupType,layoutName in pairs(db) do
		if not self.layoutSettings[layoutName] then
			db[groupType] = defaults[groupType] or defaults['raid'] or "By Group"
		end
	end
end

-- Fix non existent layouts for all themes
function Grid2Layout:FixLayouts()
	self:FixLayoutsTable(self.dba.profile.layouts)
	for _,theme in ipairs(self.dba.profile.extraThemes or {}) do
		self:FixLayoutsTable(theme.layouts)
	end
end

-- Register user defined layouts (called from Grid2Options do not remove)
function Grid2Layout:AddCustomLayouts()
	self.customLayouts = self.db.global.customLayouts
	if self.customLayouts then
		for n,l in pairs(self.customLayouts) do
			for _,h in ipairs(l) do
				h.type = strmatch(h.type or '', 'pet') or h.type -- conversion from old format
				if Grid2.versionCli<30000 and h.groupBy == 'ASSIGNEDROLE' then -- convert non existant roles in vanilla&bcc
					h.groupBy, h.groupingOrder = 'ROLE', 'MAINTANK,MAINASSIST,NONE'
				end
			end
			self:AddLayout(n,l)
		end
	end
end
--}}}

_G.Grid2Layout = Grid2Layout