Add loadout manager for copying, renaming and deleting loadouts

help.txt

@@ -134,7 +134,14 @@ Loadouts can be selected from the dropdown in the top middle of the screen. Sele
     3) If there is only one set for a set type (except passive tree), e.g. "Default" config set, it will be assigned to all existing loadouts.
 
 The "New Loadout" option allows the user to create all four sets from a single popup for convenience.
-The "Sync" option is a backup option to force the UI to update in case the user has changed this data behind the scenes.
+The "Manage Loadouts" option opens the loadout manager, which works like the set managers found on the Tree, Skills, Items, and Configuration tabs:
+    - "New" creates all four sets from a single popup, the same as the "New Loadout" option
+    - "Copy" duplicates all four sets of the selected loadout into a new loadout automatically
+    - "New/Copy Custom" creates a loadout from a mix of sets, choosing for each of the four whether to start fresh or copy an existing set. It defaults to the currently active sets, so saving straight away copies the active loadout
+    - "Rename" renames all four sets of the selected loadout, preserving any identifiers inside braces { }
+    - "Delete" deletes all four sets of the selected loadout; sets shared with other loadouts, or the last remaining set of a type, are kept
+    - Double-clicking a loadout activates it
+    - "Sync" is a backup option to force the UI to update in case the user has changed this data behind the scenes
 
 
 ---[Party Tab]

spec/System/TestLoadouts_spec.lua

@@ -0,0 +1,200 @@
+describe("TestLoadouts", function()
+	before_each(function()
+		newBuild()
+	end)
+
+	teardown(function()
+		-- newBuild() takes care of resetting everything in before_each()
+	end)
+
+	it("creates a new loadout with all four sets", function()
+		build:NewLoadout("My Loadout")
+		assert.are.equals("My Loadout", build.treeTab.specList[#build.treeTab.specList].title)
+		assert.are.equals("My Loadout", build.itemsTab.itemSets[build.itemsTab.itemSetOrderList[#build.itemsTab.itemSetOrderList]].title)
+		assert.are.equals("My Loadout", build.skillsTab.skillSets[build.skillsTab.skillSetOrderList[#build.skillsTab.skillSetOrderList]].title)
+		assert.are.equals("My Loadout", build.configTab.configSets[build.configTab.configSetOrderList[#build.configTab.configSetOrderList]].title)
+		local found = false
+		for _, loadout in ipairs(build.loadoutList) do
+			if loadout.name == "My Loadout" then
+				found = true
+			end
+		end
+		assert.is_true(found)
+	end)
+
+	it("copies a loadout automatically", function()
+		build:NewLoadout("My Loadout")
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		local loadout
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "My Loadout" then
+				loadout = entry
+			end
+		end
+		assert.is_not_nil(loadout)
+		listControl:CopyLoadout(loadout)
+		local copyFound = false
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "My Loadout (copy)" then
+				copyFound = true
+			end
+		end
+		assert.is_true(copyFound)
+		-- Copying again picks a unique name
+		listControl:CopyLoadout(loadout)
+		local copy2Found = false
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "My Loadout (copy 2)" then
+				copy2Found = true
+			end
+		end
+		assert.is_true(copy2Found)
+	end)
+
+	it("creates a custom loadout from a mix of new and copied sets", function()
+		build:NewLoadout("Source")
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		local source
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "Source" then
+				source = entry
+			end
+		end
+		assert.is_not_nil(source)
+
+		-- Copy the tree and item set, but start the skill and config sets fresh
+		listControl:CreateLoadout("Custom", source.specId, source.itemSetId, nil, nil)
+		local custom
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "Custom" then
+				custom = entry
+			end
+		end
+		assert.is_not_nil(custom)
+		-- Every set is newly created, so none are shared with the source loadout
+		assert.are_not.equals(source.specId, custom.specId)
+		assert.are_not.equals(source.itemSetId, custom.itemSetId)
+		assert.are_not.equals(source.skillSetId, custom.skillSetId)
+		assert.are_not.equals(source.configSetId, custom.configSetId)
+		assert.are.equals("Custom", build.treeTab.specList[custom.specId].title)
+		assert.are.equals("Custom", build.itemsTab.itemSets[custom.itemSetId].title)
+		assert.are.equals("Custom", build.skillsTab.skillSets[custom.skillSetId].title)
+		assert.are.equals("Custom", build.configTab.configSets[custom.configSetId].title)
+	end)
+
+	it("creates an all new custom loadout when nothing is copied", function()
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		listControl:CreateLoadout("All New", nil, nil, nil, nil)
+		local found = false
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "All New" then
+				found = true
+			end
+		end
+		assert.is_true(found)
+	end)
+
+	it("generates unique default names for custom loadouts", function()
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		assert.are.equals("New Loadout Custom", listControl:UniqueName("New Loadout Custom"))
+		listControl:CreateLoadout("New Loadout Custom", nil, nil, nil, nil)
+		assert.are.equals("New Loadout Custom 2", listControl:UniqueName("New Loadout Custom"))
+	end)
+
+	it("copies the untitled default loadout without erroring", function()
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		-- A fresh build has one untitled set of each type, which resolves to a "Default" loadout
+		assert.are.equals(1, #build.loadoutList)
+		assert.are.equals("Default", build.loadoutList[1].name)
+		listControl:CopyLoadout(build.loadoutList[1])
+		local copyFound = false
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "Default (copy)" then
+				copyFound = true
+			end
+		end
+		assert.is_true(copyFound)
+	end)
+
+	it("deletes a newly added loadout without breaking the remaining sets", function()
+		build:NewLoadout("Second")
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		assert.are.equals(2, #build.loadoutList)
+		local second
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "Second" then
+				second = entry
+			end
+		end
+		assert.is_not_nil(second)
+
+		listControl:DeleteLoadout(second)
+
+		assert.are.equals(1, #build.loadoutList)
+		assert.are.equals(1, #build.treeTab.specList)
+		assert.are.equals(1, #build.itemsTab.itemSetOrderList)
+		assert.are.equals(1, #build.skillsTab.skillSetOrderList)
+		assert.are.equals(1, #build.configTab.configSetOrderList)
+		-- The active sets must still point at sets that exist
+		assert.is_not_nil(build.treeTab.specList[build.treeTab.activeSpec])
+		assert.is_not_nil(build.itemsTab.itemSets[build.itemsTab.activeItemSetId])
+		assert.is_not_nil(build.skillsTab.skillSets[build.skillsTab.activeSkillSetId])
+		assert.is_not_nil(build.configTab.configSets[build.configTab.activeConfigSetId])
+	end)
+
+	it("keeps sets that are shared with another loadout when deleting", function()
+		-- Two trees sharing a single item, skill and config set each
+		build.treeTab.specList[1].title = "Shared A"
+		local listControl = new("LoadoutListControl"):LoadoutListControl(nil, {0, 0, 450, 200}, build)
+		listControl:AddSpec(1, "Shared B")
+		build:SyncLoadouts()
+		assert.are.equals(2, #build.loadoutList)
+
+		local sharedItemSetId = build.itemsTab.itemSetOrderList[1]
+		local toDelete
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "Shared B" then
+				toDelete = entry
+			end
+		end
+		listControl:DeleteLoadout(toDelete)
+
+		-- The tree is gone, but the single item set is still used by "Shared A"
+		assert.are.equals(1, #build.treeTab.specList)
+		assert.is_not_nil(build.itemsTab.itemSets[sharedItemSetId])
+		assert.are.equals(1, #build.loadoutList)
+	end)
+
+	it("resets the dropdown selection after opening the manager", function()
+		local dropdown = build.controls.buildLoadouts
+		local manageIndex
+		for i, value in ipairs(dropdown.list) do
+			if value == "^7^7Manage Loadouts" then
+				manageIndex = i
+			end
+		end
+		assert.is_not_nil(manageIndex)
+		dropdown:SetSel(manageIndex)
+		-- Selection must fall back to the header, otherwise picking "Manage Loadouts"
+		-- a second time would not fire the callback again
+		assert.are.equals(1, dropdown.selIndex)
+		main:ClosePopup()
+	end)
+
+	it("resolves link identifier loadouts", function()
+		build.treeTab.specList[1].title = "Tree {A}"
+		local itemSet = build.itemsTab.itemSets[build.itemsTab.itemSetOrderList[1]]
+		itemSet.title = "Items {A}"
+		-- With only one skill and config set, they are shared by all loadouts
+		build:SyncLoadouts()
+		local loadout
+		for _, entry in ipairs(build.loadoutList) do
+			if entry.name == "Tree {A}" then
+				loadout = entry
+			end
+		end
+		assert.is_not_nil(loadout)
+		assert.are.equals(1, loadout.specId)
+		assert.are.equals(build.itemsTab.itemSetOrderList[1], loadout.itemSetId)
+	end)
+end)