UI.lua

--[[
	MidnightHelper - UI.lua

	Builds the main shell: movable/resizable frame, Blizzard dialog-style chrome
	(gold border + stone tile, same family as Changelog), title bar, search row,
	sidebar tabs, and module host panels. Core.lua toggles visibility via ns:ToggleMainWindow.
]]

local addonName, ns = ...

--------------------------------------------------------------------------------
-- Layout constants (tweak in one place)
--------------------------------------------------------------------------------
-- Wider default so Professions tab can show two treasure columns side-by-side.
-- Default matches a typical user-tuned layout (795×600 at UI scale 1.25 fits Delves + Guide).
local DEFAULT_WIDTH = 795
local DEFAULT_HEIGHT = 600
-- Suggested minimum for first-time installs only; never overrides mainWindowUserSized.
local MIN_DELVES_WINDOW_H = 800
local SIDEBAR_WIDTH = 132
local TITLE_BAR_HEIGHT = 32
-- Global search bar (full width under title) — not in the narrow sidebar: keeps the field wide on all tabs.
local SEARCH_BAR_HEIGHT = 30
local RESIZE_GRIP_SIZE = 16
local MIN_WIDTH, MIN_HEIGHT = 620, 600
-- Baseline caps; EnsureMainUI raises them on large displays (see UpdateMaxWindowBounds).
local MAX_WIDTH, MAX_HEIGHT = 1000, 920

-- Shared content-layout metrics for module panels (HomeDashboard, MidnightCodex,
-- and future tabs). Single source so insets stay consistent across tabs; modules
-- read these with local fallbacks so load order can never break them.
ns.UI_METRICS = {
	sidePad = 14,
	topPad = 12,
	sectionGap = 8,
	scrollGutter = 30,
}

local function ClampMainWidth(w)
	w = tonumber(w) or DEFAULT_WIDTH
	return math.max(MIN_WIDTH, math.min(MAX_WIDTH, w))
end

local function ClampMainHeight(h)
	h = tonumber(h) or DEFAULT_HEIGHT
	return math.max(MIN_HEIGHT, math.min(MAX_HEIGHT, h))
end

--- Raise the size caps on large displays (1440p+): the hard 1000x920 cap left
--- dead space on big screens. UIParent dimensions are in the same (scaled)
--- units as the main frame, so the comparison is scale-safe. Never lowers the
--- baseline caps, so small screens keep the original behavior.
local function UpdateMaxWindowBounds()
	local sw = UIParent and UIParent.GetWidth and UIParent:GetWidth() or 0
	local sh = UIParent and UIParent.GetHeight and UIParent:GetHeight() or 0
	if sw > 0 then
		MAX_WIDTH = math.max(1000, math.min(1400, math.floor(sw * 0.85)))
	end
	if sh > 0 then
		MAX_HEIGHT = math.max(920, math.min(1200, math.floor(sh * 0.9)))
	end
end

--- Prefer SavedVariables size; fall back to layout defaults.
local function GetSavedMainWidth()
	local ui = ns.db and ns.db.ui
	local w = ui and tonumber(ui.mainWidth)
	if w and w >= MIN_WIDTH then
		return ClampMainWidth(w)
	end
	return DEFAULT_WIDTH
end

local function GetSavedMainHeight()
	local ui = ns.db and ns.db.ui
	local h = ui and tonumber(ui.mainHeight)
	if h and h >= MIN_HEIGHT then
		return ClampMainHeight(h)
	end
	return DEFAULT_HEIGHT
end

--- One-time bump for pre-v3 saves that are too short for Delves; never shrink a user-resized window.
local function ResolveMainHeightForOpen()
	local ui = ns.db and ns.db.ui
	if not ui then
		return DEFAULT_HEIGHT
	end
	local h = GetSavedMainHeight()
	local ver = tonumber(ui.layoutVersion) or 0
	if ui.mainWindowUserSized and h >= MIN_HEIGHT then
		if ver < 3 then
			ui.layoutVersion = 3
		end
		return h
	end
	if ver < 3 and h < MIN_DELVES_WINDOW_H then
		h = DEFAULT_HEIGHT
		ui.mainHeight = h
		ui.layoutVersion = 3
	elseif ver < 3 then
		ui.layoutVersion = 3
	end
	return h
end

function ns:ApplySavedMainWindowSize()
	if not self.mainUI then
		return
	end
	local w = GetSavedMainWidth()
	local h = ResolveMainHeightForOpen()
	-- Programmatic resize: must not mark the window as user-sized (see OnSizeChanged guard).
	ns._mhProgrammaticResize = true
	self.mainUI:SetSize(w, h)
	ns._mhProgrammaticResize = false
end

--- Restore the saved window position (F4.6). No saved point = leave the default CENTER.
function ns:ApplySavedMainWindowPosition()
	local main = self.mainUI
	if not main then
		return
	end
	local ui = ns.db and ns.db.ui
	local p = ui and ui.mainPoint
	if type(p) ~= "table" or type(p.point) ~= "string" then
		return
	end
	main:ClearAllPoints()
	main:SetPoint(p.point, UIParent, p.relativePoint or p.point, tonumber(p.x) or 0, tonumber(p.y) or 0)
end

local ABOUT_BTN_WIDTH = 110
local ABOUT_BTN_HEIGHT = 22
local ABOUT_BTN_BOTTOM_INSET = 10

-- Chrome: Blizzard dialog stone + gold frame (aligns with Changelog), warm tab tints.
local MH_TEX = {
	dialogBg = "Interface\\DialogFrame\\UI-DialogBox-Background",
	dialogBgDark = "Interface\\DialogFrame\\UI-DialogBox-Background-Dark",
	goldEdge = "Interface\\DialogFrame\\UI-DialogBox-Gold-Border",
}
--- Children stay inside this inset so they don't paint over the dialog gold corner ornaments.
local MH_MAIN_EDGE = { L = 12, R = 12, T = 12, B = 11 }
local MH_CHROME = {
	-- Fallbacks if a region still uses flat color.
	mainBg = { 0.09, 0.09, 0.11, 0.96 },
	outerEdge = { 0, 0, 0, 0.42 },
	-- Title strip: warm bronze over dialog art.
	titleStrip = { 0.2, 0.15, 0.1, 0.88 },
	sidebar = { 0.075, 0.076, 0.082, 0.96 },
	contentWell = { 0.048, 0.05, 0.062, 0.9 },
	-- Gold accent (sidebar | content, subnav rules).
	separator = { 0.78, 0.62, 0.32, 0.75 },
	separatorShadow = { 0, 0, 0, 0.4 },
	tabTexActive = { 0.98, 0.94, 0.82 },
	tabTexInactive = { 0.78, 0.72, 0.62 },
}

-- Gedeeld kleur-palet (Tier-1 visuele-rust-pass, 16 jun). Eén accent-goud, één
-- rustige link-tint, één dim-grijs voor subtitels, en status-kleuren die ALLEEN
-- voor status zijn (niet voor decoratie). Panelen lezen hieruit i.p.v. elk hun
-- eigen tint te declareren → minder concurrerende kleuren = rustiger beeld.
-- RGB-tabellen voor SetTextColor; *_HEX voor |cff-markup (AARRGGBB, AA=ff).
-- The single source for panel status colours. Until now this table existed but was
-- read by nobody, so sixteen modules each declared their own COLOR_* and quietly
-- drifted apart: two greens, two ambers, two greys, and one link blue living under
-- three different names. The values below are the ones the panels already agreed on,
-- so adopting them changes nothing except the two outliers (DungeonGuide's duller
-- green/amber, WorldContent's duller heading gold), which is the point.
--
-- Status only. Category palettes (keybind roles, profession academy) encode meaning
-- of their own and are deliberately left alone.
ns.UI_COLORS = {
	header = { 0.91, 0.76, 0.42 }, -- section headings / titles
	gold = { 0.91, 0.76, 0.42 }, -- alias: chrome accents
	GOLD_HEX = "ffe8c36a",
	dim = { 0.75, 0.78, 0.82 }, -- secondary / explanatory text
	DIM_HEX = "ffbfc7d1",
	body = { 0.86, 0.87, 0.90 }, -- running text
	BODY_HEX = "ffdcdde6",
	footer = { 0.45, 0.47, 0.50 }, -- footnotes
	FOOTER_HEX = "ff73787f",
	good = { 0.45, 0.95, 0.5 }, -- done / ready
	GOOD_HEX = "ff73f280",
	warn = { 1, 0.84, 0.18 }, -- needs doing now
	WARN_HEX = "ffffd62e",
	soft = { 0.9, 0.82, 0.45 }, -- in hand, not urgent
	SOFT_HEX = "ffe6d173",
	prog = { 0.45, 0.85, 0.95 }, -- picked up / in progress
	PROG_HEX = "ff73d9f2",
	link = { 0.55, 0.78, 1 }, -- every clickable jump, one tint
	LINK_HEX = "ff8cc7ff",
	bad = { 0.90, 0.42, 0.42 },
	BAD_HEX = "ffe66b6b",
}

local function MHUnpack4(t)
	return t[1], t[2], t[3], t[4]
end

local function MHTintButtonTextures(btn, r, g, b)
	if not btn or not btn.GetRegions then
		return
	end
	for _, region in ipairs({ btn:GetRegions() }) do
		if region.GetObjectType and region:IsObjectType("Texture") and region.SetVertexColor then
			region:SetVertexColor(r, g, b)
		end
	end
end

--------------------------------------------------------------------------------
-- 4.0 palette C "Twilight lantern" (Rob's pick, 12 Sep 2026, out of three researched
-- proposals; contrast measured there: body 15.2:1, muted 8.4:1 on the window colour).
-- One table for the shell. The Classic look ignores it and keeps the 3.x Blizzard
-- textures and tints, restored live when the setting is switched.
--------------------------------------------------------------------------------
local LOOK_PALETTE = {
	window = { 0.106, 0.086, 0.200, 0.95 }, -- #1B1633; >= ~90% opaque so the world does not eat contrast
	sidebar = { 0.075, 0.059, 0.153, 0.97 }, -- #130F27
	active = { 0.239, 0.180, 0.471, 1 }, -- #3D2E78
	hover = { 0.165, 0.129, 0.314, 1 }, -- #2A2150
	chip = { 0.239, 0.180, 0.471, 0.80 }, -- a button at rest: the active fill, a touch see-through
	header = { 0.957, 0.871, 0.604 }, -- #F4DE9A
	body = { 0.945, 0.933, 0.980 }, -- #F1EEFA
	muted = { 0.722, 0.682, 0.859 }, -- #B8AEDB
	accent = { 0.788, 0.659, 1.0, 1 }, -- #C9A8FF
	row = { 0.137, 0.110, 0.259, 0.90 }, -- #231C42, a list row at rest: between window and hover
}
ns.LOOK_PALETTE = LOOK_PALETTE

local function MHLookOn()
	return not (ns.IsClassicLookEnabled and ns:IsClassicLookEnabled())
end

local mhLookFonts
local function MHLookFont(kind)
	if not mhLookFonts then
		local function make(name, base, c)
			local f = CreateFont(name)
			f:CopyFontObject(base)
			f:SetTextColor(c[1], c[2], c[3])
			return f
		end
		mhLookFonts = {
			normal = make("MidnightHelperLookFont", GameFontNormal, LOOK_PALETTE.body),
			active = make("MidnightHelperLookFontActive", GameFontNormal, LOOK_PALETTE.header),
			hover = make("MidnightHelperLookFontHover", GameFontHighlight, { 1, 1, 1 }),
		}
	end
	return mhLookFonts[kind]
end

--- Blizzard's red panel-button art cannot be tinted indigo (SetVertexColor only multiplies),
--- so the new look fades the template's own textures out and draws a flat fill and a 2 px
--- accent bar of its own. Nothing of the template is removed: Classic fades it back in.
local function MHLookButtonParts(btn)
	if btn._mhLookParts then
		return btn._mhLookParts
	end
	local parts = { tex = {} }
	for _, region in ipairs({ btn:GetRegions() }) do
		if region.IsObjectType and region:IsObjectType("Texture") then
			parts.tex[#parts.tex + 1] = region
		end
	end
	local fill = btn:CreateTexture(nil, "BACKGROUND", nil, -8)
	fill:SetAllPoints()
	fill:Hide()
	local bar = btn:CreateTexture(nil, "ARTWORK")
	bar:SetPoint("TOPLEFT", btn, "TOPLEFT", 0, 0)
	bar:SetPoint("BOTTOMLEFT", btn, "BOTTOMLEFT", 0, 0)
	bar:SetWidth(2)
	bar:Hide()
	parts.fill, parts.bar = fill, bar
	btn._mhLookParts = parts
	btn:HookScript("OnEnter", function(self)
		if self._mhLookOn and not self._mhLookActive then
			parts.fill:SetColorTexture(MHUnpack4(LOOK_PALETTE.hover))
			parts.fill:Show()
		end
	end)
	btn:HookScript("OnLeave", function(self)
		if self._mhLookOn and not self._mhLookActive then
			if self._mhLookRest then
				parts.fill:SetColorTexture(MHUnpack4(self._mhLookRest))
			else
				parts.fill:Hide()
			end
		end
	end)
	return parts
end

--- style "tab": a flat sidebar row, filled with a bar when active. style "chip": always a
--- filled button (title and search bar).
local function MHLookSkinButton(btn, active, style)
	local parts = MHLookButtonParts(btn)
	for _, t in ipairs(parts.tex) do
		t:SetAlpha(0)
	end
	btn._mhLookOn = true
	btn._mhLookActive = active and true or false
	btn._mhLookRest = nil
	parts.bar:Hide()
	if style == "row" then
		-- A list row (the Rares page, 15 Sep 2026): a quiet flat fill, lighter on hover. The row
		-- keeps its own scalable font; its text carries its colours as codes.
		btn._mhLookRest = LOOK_PALETTE.row
		btn._mhLookKeepFont = true
		parts.fill:SetColorTexture(MHUnpack4(LOOK_PALETTE.row))
		parts.fill:Show()
		return
	end
	if style == "chip" then
		btn._mhLookRest = LOOK_PALETTE.chip
		parts.fill:SetColorTexture(MHUnpack4(LOOK_PALETTE.chip))
		parts.fill:Show()
		btn:SetNormalFontObject(MHLookFont("active"))
	elseif active then
		parts.fill:SetColorTexture(MHUnpack4(LOOK_PALETTE.active))
		parts.fill:Show()
		parts.bar:SetColorTexture(MHUnpack4(LOOK_PALETTE.accent))
		parts.bar:Show()
		btn:SetNormalFontObject(MHLookFont("active"))
	else
		parts.fill:Hide()
		btn:SetNormalFontObject(MHLookFont("normal"))
	end
	btn:SetHighlightFontObject(MHLookFont("hover"))
end

local function MHLookUnskinButton(btn)
	local parts = btn._mhLookParts
	if not parts or not btn._mhLookOn then
		return
	end
	for _, t in ipairs(parts.tex) do
		t:SetAlpha(1)
	end
	parts.fill:Hide()
	parts.bar:Hide()
	btn._mhLookOn, btn._mhLookActive, btn._mhLookRest = false, false, nil
	if btn._mhLookKeepFont then
		btn._mhLookKeepFont = nil
		return
	end
	btn:SetNormalFontObject(GameFontNormal)
	btn:SetHighlightFontObject(GameFontHighlight)
end

--- For modules that draw their own buttons in the look (the Rares page, 15 Sep 2026).
ns.MHLookSkinButton = MHLookSkinButton
ns.MHLookUnskinButton = MHLookUnskinButton
ns.MHLookOn = MHLookOn

local function MHRefreshSidebarTabChrome(activeId)
	if not ns.tabButtons then
		return
	end
	local lookOn = MHLookOn()
	for id, btn in pairs(ns.tabButtons) do
		if lookOn then
			btn:SetAlpha(1)
			MHLookSkinButton(btn, id == activeId, "tab")
		else
			MHLookUnskinButton(btn)
			if id == activeId then
				btn:SetAlpha(1)
				MHTintButtonTextures(btn, MH_CHROME.tabTexActive[1], MH_CHROME.tabTexActive[2], MH_CHROME.tabTexActive[3])
			else
				btn:SetAlpha(0.9)
				MHTintButtonTextures(btn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
			end
		end
	end
end

local function MHGetLayoutMetrics()
	local compact = ns.db and ns.db.settings and ns.db.settings.compactMode == true
	return {
		compact = compact,
		sidebarWidth = compact and 124 or SIDEBAR_WIDTH,
		sidebarTabHeight = compact and 24 or 28,
		sidebarTabStep = compact and 30 or 34,
		addonSubTabHeight = compact and 22 or 24,
		addonSubNavHeight = compact and 34 or 40,
		addonSubContentTopGap = compact and -4 or -6,
		aboutBtnHeight = compact and 20 or ABOUT_BTN_HEIGHT,
		aboutBtnWidth = compact and 104 or ABOUT_BTN_WIDTH,
		searchBarHeight = compact and 26 or SEARCH_BAR_HEIGHT,
		searchResetBtnWidth = compact and 94 or 108,
		searchGoBtnWidth = compact and 64 or 72,
		infoWindowWidth = compact and 236 or 268,
		infoWindowHeight = compact and 180 or 210,
	}
end

local function FitTitleBarButton(btn, minW, maxW)
	if not btn or not btn.GetFontString then
		return
	end
	local fs = btn:GetFontString()
	if not fs or not fs.GetStringWidth then
		return
	end
	minW = minW or 56
	maxW = maxW or 120
	local w = math.ceil((fs:GetStringWidth() or 0) + 14)
	btn:SetWidth(math.min(maxW, math.max(minW, w)))
end

local function FitSidebarTabButton(btn, sidebarWidth)
	if not btn or not btn.GetFontString then
		return
	end
	local fs = btn:GetFontString()
	if not fs or not fs.GetStringWidth or not fs.SetFont then
		return
	end
	-- Capture the pristine font size ONCE. Without this, every relayout read the
	-- already-shrunk size and shrank again, so long labels (deDE/frFR) kept getting
	-- smaller each time the sidebar re-laid out (F3.8).
	if not btn._mhBaseFont then
		local font, size, flags = fs:GetFont()
		if not (font and size) then
			return -- font not ready yet
		end
		btn._mhBaseFont = { font = font, size = size, flags = flags }
	end
	local base = btn._mhBaseFont
	local maxW = (sidebarWidth or MHGetLayoutMetrics().sidebarWidth) - 16
	-- Always start from the base size, then shrink to fit (non-cumulative).
	fs:SetFont(base.font, base.size, base.flags)
	local size = base.size
	local textW = fs:GetStringWidth() or 0
	while textW + 24 > maxW and size > 9 do
		size = size - 1
		fs:SetFont(base.font, size, base.flags)
		textW = fs:GetStringWidth() or textW
	end
	btn:SetWidth(maxW)
end

-- Top-level beta-gated tabs. macros/academy (→ Toolbox sub-tabs) and
-- reference (→ Codex category) are no longer top-level; their beta keys still
-- gate the merged locations via ns.IsBetaTabEnabled, so the Settings
-- checkboxes keep working.
-- Beta-badges uitgezet (Rob, 3 jul 2026): geen zichtbare "Beta"-markering meer op de
-- tabs. De gating-logica (ns.IsBetaTabEnabled / Settings-checkboxes) blijft intact —
-- dit haalt alleen de badge + beta-tooltip weg. Weer aanzetten? Vul tab-id's aan.
local MH_BETA_TAB_IDS = {}

-- Sidebar is grouped into labelled sections (header + tabs). Tab ids whose
-- buttons do not exist yet (home, ritual) are skipped during layout, which
-- reserves their slot for later phases without breaking the current build.
-- 1.9.0 Phase 2 (4-kamer-model, stap 1 = hergroeperen): de zijbalk volgt nu de
-- blueprint-kamers. "Me" is gesplitst in This week / My characters; Codex bundelt
-- alle kennis (gidsen); Tools en Settings staan apart. Titels hergebruiken
-- bestaande locale-keys (TAB_CODEX/TAB_SETTINGS), dus geen nieuwe sleutels nodig.
-- Stap 2 maakt hier klikbare icoon-kamerknoppen van. Home blijft de default/
-- fallback-tab in SelectTab (sidebar-volgorde staat daar los van).
local SIDEBAR_SECTIONS = {
	{ key = "me_now", room = "me", titleKey = "SIDEBAR_SECTION_WEEK", ids = { "home", "starthere", "delves", "rares", "world", "events" } },
	-- The old single "Character" list was an eight-noun wall with no scannable bucket:
	-- someone hunting a collectible mount had nowhere obvious to look. Four named
	-- groups; no tab moved out of reach (Rob, 10 jul).
	{ key = "me_collections", room = "me", titleKey = "SIDEBAR_SECTION_COLLECTIONS", ids = { "mounts", "tradingpost", "achievements" } },
	{ key = "me_gear", room = "me", titleKey = "SIDEBAR_SECTION_GEAR", ids = { "enchants", "tier" } },
	{ key = "me_resources", room = "me", titleKey = "SIDEBAR_SECTION_RESOURCES", ids = { "currency", "omnium" } },
	{ key = "me_alts", room = "me", titleKey = "SIDEBAR_SECTION_ALTS", ids = { "account", "delvelog" } },
	{ key = "codex", room = "codex", titleKey = "TAB_CODEX", ids = { "codex", "dungeons", "raids", "guide", "smcguide" } },
	{ key = "tools", room = "tools", titleKey = "SIDEBAR_SECTION_TOOLS", ids = { "toolslaunch", "toolbox", "addons" } },
	{ key = "settings", room = "settings", titleKey = "TAB_SETTINGS", ids = { "settings" } },
}

-- 1.9.0 Phase 2 stap 2: klikbare icoon-kamerknoppen bovenaan de zijbalk. Elke
-- kamer toont alleen z'n eigen secties; de actieve kamer wordt AFGELEID van de
-- huidige tab (geen aparte staat om te syncen). Klikken op een kamer opent de
-- eerste zichtbare tab erin. Labels: SIDEBAR_ROOM_ME/_CODEX nieuw; Tools/Settings
-- hergebruiken bestaande keys.
local SIDEBAR_ROOMS = {
	{ id = "me", labelKey = "SIDEBAR_ROOM_ME", icon = "Interface\\Icons\\Achievement_Character_Human_Male", defaultTab = "home" },
	{ id = "codex", labelKey = "SIDEBAR_ROOM_CODEX", icon = "Interface\\Icons\\INV_Misc_Book_09", defaultTab = "codex" },
	{ id = "tools", labelKey = "SIDEBAR_ROOM_TOOLS", icon = "Interface\\Icons\\Trade_Engineering", defaultTab = "toolslaunch" },
	{ id = "settings", labelKey = "TAB_SETTINGS", icon = "Interface\\Icons\\INV_Misc_Gear_01", defaultTab = "settings" },
}
local SIDEBAR_ROOM_BY_ID = {}
for _, r in ipairs(SIDEBAR_ROOMS) do
	SIDEBAR_ROOM_BY_ID[r.id] = r
end

local function MHRoomForTab(tabId)
	if tabId == "screens" or tabId == "allsettings" then
		-- The 4.0 Screens page and the All settings page (Modules/SettingsPage.lua) sit in the
		-- Settings room.
		return "settings"
	end
	-- 4.0 room card grids (Modules/RoomLauncher.lua) are panels named "room_<room>".
	local launcherRoom = type(tabId) == "string" and tabId:match("^room_(%a+)$")
	if launcherRoom and SIDEBAR_ROOM_BY_ID[launcherRoom] then
		return launcherRoom
	end
	for _, section in ipairs(SIDEBAR_SECTIONS) do
		for _, id in ipairs(section.ids) do
			if id == tabId then
				return section.room
			end
		end
	end
	return nil
end

local function MHActiveRoom()
	return MHRoomForTab(ns.uiSelectedTab) or "me"
end

-- Phase 3 cross-links: interactieve tabs met een Codex-tegenhanger. De
-- titelbalk-knop "Read in Codex" springt naar die Codex-categorie.
local TAB_TO_CODEX = {
	delves = "delves",
	dungeons = "dungeons",
	world = "world",
	currency = "currencies",
	omnium = "weekly",
}

local SIDEBAR_SECTION_GAP = 10
local SIDEBAR_HEADER_HEIGHT = 16

-- (Simpele modus / Tier 3 uitgefaseerd in Phase 2 — de kamer-rail verving 'm; alle
-- resten opgeruimd in F3.8.)

--- Can this screen exist here: on this client, with the beta switches, under the Guide's own
--- level rule? Not the player's show/hide choice (see SidebarTabVisible), so anything deciding
--- whether a tab may be OPEN asks this one.
local function SidebarTabAvailable(tabId)
	if tabId == "omnium" and not (ns.IsOmniumFolioAvailable and ns.IsOmniumFolioAvailable()) then
		return false -- 12.0.7-content: alleen op clients >= 120007
	end
	if tabId == "guide" then
		return ns.IsBetaTabEnabled and ns.IsBetaTabEnabled("guide")
	end
	if MH_BETA_TAB_IDS[tabId] then
		return ns.IsBetaTabEnabled and ns.IsBetaTabEnabled(tabId)
	end
	return true
end

-- The Toolbox's sub-tabs are screens of their own for show/hide, as on the 4.0 Tools cards.
local TOOLBOX_SCREENS = {
	{ id = "consumables", labelKey = "TAB_CONSUMABLES" },
	{ id = "macros", labelKey = "TAB_MACROS" },
	{ id = "academy", labelKey = "TAB_ACADEMY" },
	{ id = "professionsHub", labelKey = "TAB_PROFESSIONS" },
}

--- Listed in the sidebar, the room cards and the favourites menu: available AND not hidden by
--- the player (4.0 per-screen show/hide, Core.lua). The Toolbox tab stays while any of its
--- sub-tabs is shown.
local function SidebarTabVisible(tabId)
	if not SidebarTabAvailable(tabId) then
		return false
	end
	if tabId == "toolbox" then
		for _, s in ipairs(TOOLBOX_SCREENS) do
			if not (ns.IsScreenHidden and ns.IsScreenHidden(s.id)) then
				return true
			end
		end
		return false
	end
	return not (ns.IsScreenHidden and ns.IsScreenHidden(tabId))
end

local function MHAttachTabBetaBadge(btn, tabId)
	if not btn or not MH_BETA_TAB_IDS[tabId] then
		return
	end
	if not btn._mhBetaBadge then
		local badge = btn:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
		badge:SetPoint("TOPRIGHT", btn, "TOPRIGHT", -3, -1)
		badge:SetTextColor(1, 0.72, 0.15)
		btn._mhBetaBadge = badge
		btn:HookScript("OnEnter", function(self)
			GameTooltip:SetOwner(self, "ANCHOR_CURSOR")
			GameTooltip:AddLine(ns:L("TAB_BETA_TOOLTIP_TITLE"), 1, 0.82, 0)
			GameTooltip:AddLine(ns:L("TAB_BETA_TOOLTIP_BODY"), 0.92, 0.92, 0.92, true)
			GameTooltip:Show()
		end)
		btn:HookScript("OnLeave", function()
			GameTooltip:Hide()
		end)
	end
	btn._mhBetaBadge:SetText(ns:L("TAB_BETA_BADGE"))
end

local function MHGetInfoBodyKeyForTab(tabId)
	if tabId == "codex" then
		-- The embedded Reference category keeps its own help text.
		if ns.GetActiveCodexCategory and ns.GetActiveCodexCategory() == "reference" then
			return "INFO_DRAWER_BODY_REFERENCE"
		end
		return "INFO_DRAWER_BODY_CODEX"
	elseif tabId == "home" then
		return "INFO_DRAWER_BODY_HOME"
	elseif tabId == "starthere" then
		return "INFO_DRAWER_BODY_STARTHERE"
	elseif tabId == "dungeons" then
		return "INFO_DRAWER_BODY_DUNGEONS"
	elseif tabId == "events" then
		return "INFO_DRAWER_BODY_EVENTS"
	elseif tabId == "omnium" then
		return "INFO_DRAWER_BODY_OMNIUM"
	elseif tabId == "toolslaunch" then
		return "INFO_DRAWER_BODY_TOOLSLAUNCH"
	elseif tabId == "delves" then
		return "INFO_DRAWER_BODY_DELVES"
	elseif tabId == "account" then
		return "INFO_DRAWER_BODY_ACCOUNT"
	elseif tabId == "rares" then
		return "INFO_DRAWER_BODY_RARES"
	elseif tabId == "achievements" then
		return "INFO_DRAWER_BODY_ACHIEVEMENTS"
	elseif tabId == "world" then
		return "INFO_DRAWER_BODY_WORLD"
	elseif tabId == "delvelog" then
		return "INFO_DRAWER_BODY_DELVELOG"
	elseif tabId == "enchants" then
		return "INFO_DRAWER_BODY_ENCHANTS"
	elseif tabId == "tier" then
		return "INFO_DRAWER_BODY_TIER"
	elseif tabId == "smcguide" then
		return "INFO_DRAWER_BODY_SMC"
	elseif tabId == "currency" then
		return "INFO_DRAWER_BODY_CURRENCY"
	elseif tabId == "professions" then
		return "INFO_DRAWER_BODY_PROFESSIONS"
	elseif tabId == "guide" then
		return "INFO_DRAWER_BODY_GUIDE"
	elseif tabId == "toolbox" then
		-- Per-sub-tab help text inside the merged Toolbox tab.
		local sid = ns.uiSelectedToolboxSubTab or "consumables"
		if sid == "macros" then
			return "INFO_DRAWER_BODY_MACROS"
		elseif sid == "academy" then
			return "INFO_DRAWER_BODY_ACADEMY"
		elseif sid == "professionsHub" then
			local inner = ns.uiSelectedProfHubInner or "overview"
			if inner == "treasures" then
				return "INFO_DRAWER_BODY_PROFESSIONS"
			elseif inner == "course" then
				return "INFO_DRAWER_BODY_PROFACADEMY"
			end
			return "INFO_DRAWER_BODY_PROFHUB"
		end
		return "INFO_DRAWER_BODY_CONSUMABLES"
	elseif tabId == "mounts" then
		-- No drawer text of their own (they fell back to Home's); each panel's subtitle
		-- says what the screen is and exists in all seven packs.
		return "MOUNTS_PANEL_SUBTITLE"
	elseif tabId == "tradingpost" then
		return "TRADINGPOST_SUBTITLE"
	elseif tabId == "raids" then
		return "RAIDS_PANEL_SUBTITLE"
	elseif tabId == "addons" then
		return "INFO_DRAWER_BODY_ADDONS"
	elseif tabId == "settings" then
		return "INFO_DRAWER_BODY_SETTINGS"
	elseif tabId == "screens" then
		return "SCREENS_PANEL_INTRO"
	elseif tabId == "allsettings" then
		return "SET_ALL_INTRO"
	end
	return "INFO_DRAWER_BODY_HOME"
end

--------------------------------------------------------------------------------
-- 4.0.0 look (Spec 37 concept A): a strip above the content column with the screen's
-- own icon and one line on what the screen is for. Built once for every tab, so no panel
-- needed an edit. The name is left out on purpose: nearly every panel draws its own
-- title, and the title bar already reads "Room > Tab".
-- The Classic setting (ns:IsClassicLookEnabled) hides it and puts the content back on
-- the level bar exactly as 3.x had it -- the way back Rob asked about, and the exit for
-- anyone who does not want the AI-made icons.
--------------------------------------------------------------------------------
-- Screen id -> icon stem (Media/Icons/<stem>_64.png) and tagline key. The Toolbox shows
-- its active sub-tab. Keys are literal so the linter can check that each one exists.
local LOOK_SCREENS = {
	starthere = { stem = "starthere", tagline = "TAB_TAGLINE_STARTHERE" },
	dungeons = { stem = "dungeons", tagline = "TAB_TAGLINE_DUNGEONS" },
	codex = { stem = "codex", tagline = "TAB_TAGLINE_CODEX" },
	home = { stem = "home", tagline = "TAB_TAGLINE_HOME" },
	delves = { stem = "delves", tagline = "TAB_TAGLINE_DELVES" },
	account = { stem = "account", tagline = "TAB_TAGLINE_ACCOUNT" },
	rares = { stem = "rares", tagline = "TAB_TAGLINE_RARES" },
	achievements = { stem = "achievements", tagline = "TAB_TAGLINE_ACHIEVEMENTS" },
	mounts = { stem = "mounts", tagline = "TAB_TAGLINE_MOUNTS" },
	tradingpost = { stem = "tradingpost", tagline = "TAB_TAGLINE_TRADINGPOST" },
	raids = { stem = "raids", tagline = "TAB_TAGLINE_RAIDS" },
	world = { stem = "world", tagline = "TAB_TAGLINE_WORLD" },
	events = { stem = "events", tagline = "TAB_TAGLINE_EVENTS" },
	delvelog = { stem = "delvelog", tagline = "TAB_TAGLINE_DELVELOG" },
	enchants = { stem = "enchants", tagline = "TAB_TAGLINE_ENCHANTS" },
	tier = { stem = "tier", tagline = "TAB_TAGLINE_TIER" },
	omnium = { stem = "omnium", tagline = "TAB_TAGLINE_OMNIUM" },
	smcguide = { stem = "smcguide", tagline = "TAB_TAGLINE_SMCGUIDE" },
	currency = { stem = "currency", tagline = "TAB_TAGLINE_CURRENCY" },
	guide = { stem = "guide", tagline = "TAB_TAGLINE_GUIDE" },
	toolslaunch = { stem = "toolslaunch", tagline = "TAB_TAGLINE_TOOLSLAUNCH" },
	addons = { stem = "addons", tagline = "TAB_TAGLINE_ADDONS" },
	settings = { stem = "settings", tagline = "TAB_TAGLINE_SETTINGS" },
	screens = { stem = "settings", tagline = "TAB_TAGLINE_SCREENS" },
	allsettings = { stem = "settings", tagline = "TAB_TAGLINE_ALLSETTINGS" },
	consumables ={ stem = "consumables", tagline = "TAB_TAGLINE_CONSUMABLES" },
	macros = { stem = "macros", tagline = "TAB_TAGLINE_MACROS" },
	academy = { stem = "academy", tagline = "TAB_TAGLINE_ACADEMY" },
	professionsHub = { stem = "professions", tagline = "TAB_TAGLINE_PROFESSIONSHUB" },
	-- The three room card grids (Modules/RoomLauncher.lua).
	room_me = { stem = "home", tagline = "TAB_TAGLINE_ROOM_ME" },
	room_codex = { stem = "codex", tagline = "TAB_TAGLINE_ROOM_CODEX" },
	room_tools = { stem = "toolslaunch", tagline = "TAB_TAGLINE_ROOM_TOOLS" },
}
local LOOK_ICON_PATH = "Interface\\AddOns\\MidnightHelper\\Media\\Icons\\%s_64.png"
local LOOK_HEADER_H = 64
local LOOK_HEADER_H_COMPACT = 54

--- Anchors the 4.0 header (when shown) and the content column below the level bar.
--- The one place that decides where content starts: compact mode, the Classic setting
--- and the first build all go through here.
local function MHAnchorContentColumn(refs, m)
	local top = refs.levelBar or refs.favRow or refs.searchBar
	local header = refs.lookHeader
	local useHeader = header ~= nil and not (ns.IsClassicLookEnabled and ns:IsClassicLookEnabled())
	if header then
		local h = m.compact and LOOK_HEADER_H_COMPACT or LOOK_HEADER_H
		header:ClearAllPoints()
		header:SetPoint("TOPLEFT", top, "BOTTOMLEFT", m.sidebarWidth, 0)
		header:SetPoint("TOPRIGHT", top, "BOTTOMRIGHT", 0, 0)
		header:SetHeight(h)
		if header._mhIcon then
			header._mhIcon:SetSize(h - 10, h - 10)
		end
		header:SetShown(useHeader)
	end
	if refs.content then
		refs.content:ClearAllPoints()
		if useHeader then
			refs.content:SetPoint("TOPLEFT", header, "BOTTOMLEFT", 0, 0)
		else
			refs.content:SetPoint("TOPLEFT", top, "BOTTOMLEFT", m.sidebarWidth, 0)
		end
		refs.content:SetPoint("BOTTOMRIGHT", refs.main, "BOTTOMRIGHT", -MH_MAIN_EDGE.R, MH_MAIN_EDGE.B)
	end
end

-- The shell surfaces: flat palette colours in the new look, and the exact 3.x Blizzard
-- dialog textures + tints (or flat colour) in Classic.
local LOOK_SURFACES = {
	{ ref = "titleTex", flat = "sidebar", texture = MH_TEX.dialogBgDark, vertex = { 0.55, 0.45, 0.35, 0.9 } },
	{ ref = "searchBg", flat = "sidebar", texture = MH_TEX.dialogBgDark, vertex = { 0.22, 0.2, 0.24, 0.92 } },
	{ ref = "favBg", flat = "sidebar", color = { 0.16, 0.15, 0.18, 0.85 } },
	{ ref = "sidebarBg", flat = "sidebar", texture = MH_TEX.dialogBgDark, vertex = { 0.34, 0.32, 0.38, 0.94 } },
	{ ref = "contentBg", flat = "window", texture = MH_TEX.dialogBg, vertex = { 0.42, 0.44, 0.52, 0.72 } },
}

local function MHLookSurface(tex, s, lookOn)
	if not tex then
		return
	end
	if lookOn then
		tex:SetColorTexture(MHUnpack4(LOOK_PALETTE[s.flat]))
		tex:SetVertexColor(1, 1, 1, 1)
	elseif s.texture then
		tex:SetTexture(s.texture)
		if tex.SetHorizTile then
			tex:SetHorizTile(true)
		end
		if tex.SetVertTile then
			tex:SetVertTile(true)
		end
		tex:SetVertexColor(MHUnpack4(s.vertex))
	else
		tex:SetColorTexture(MHUnpack4(s.color))
		tex:SetVertexColor(1, 1, 1, 1)
	end
end

--- Applies the palette (or restores 3.x) to the shell, once per change of the Classic
--- setting; the sidebar rows and room buttons follow on the relayout it forces.
local function MHApplyLookChrome(refs)
	local lookOn = MHLookOn()
	-- The header switch must follow every change, also one made in Settings, so it is set before
	-- the early return below.
	if ns._mhRefreshLookToggle then
		ns._mhRefreshLookToggle()
	end
	if refs._mhLookApplied == lookOn then
		return
	end
	refs._mhLookApplied = lookOn
	for _, s in ipairs(LOOK_SURFACES) do
		MHLookSurface(refs[s.ref], s, lookOn)
	end
	if refs.titleText then
		local c = lookOn and LOOK_PALETTE.header or { 1, 0.82, 0 }
		refs.titleText:SetTextColor(c[1], c[2], c[3])
	end
	for _, btn in ipairs({ refs.infoToggleBtn or false, refs.aboutBtn or false, refs.lookToggleBtn or false, ns._mhCodexLinkBtn or false,
		refs.searchResetBtn or false, refs.searchGoBtn or false }) do
		if btn then
			if lookOn then
				MHLookSkinButton(btn, false, "chip")
			else
				MHLookUnskinButton(btn)
			end
		end
	end
	MHRefreshSidebarTabChrome(ns.uiSelectedTab)
	-- The Silvermoon tab's pins follow the setting in place: 4.0 cards, or the 3.x buttons.
	if ns.MH_RelayoutSMCPins then
		ns.MH_RelayoutSMCPins()
	end
	-- The Rares page redraws its rows, rail and buttons in the look that is on now.
	if ns.RefreshRaresPanel then
		ns.RefreshRaresPanel()
	end
	if ns._mhRelayoutSidebarTabs and not ns._mhSidebarRelaying then
		ns._mhRelayoutSidebarTabs()
	end
	-- Als laatste: het open scherm naar de weergave brengen die in deze look bestaat. Dit kan
	-- SelectTab aanroepen en dus hier weer binnenkomen; de `_mhLookApplied`-poort hierboven staat
	-- dan al op de nieuwe waarde, dus die tweede keer keert meteen terug.
	if ns._mhRerouteForLook then
		ns._mhRerouteForLook(lookOn)
	end
end

--- Re-anchors (so a Classic value loaded after the window was built still wins) and
--- fills the header for the open screen. Called on every tab and Toolbox sub-tab switch
--- and on a language change.
function ns:RefreshLookHeader()
	local refs = self._mhLayoutRefs
	local header = refs and refs.lookHeader
	if not header then
		return
	end
	MHAnchorContentColumn(refs, MHGetLayoutMetrics())
	MHApplyLookChrome(refs)
	if not header:IsShown() then
		return
	end
	local sid = self.uiSelectedTab or "home"
	if sid == "toolbox" then
		sid = self.uiSelectedToolboxSubTab or "consumables"
	end
	local screen = LOOK_SCREENS[sid] or LOOK_SCREENS.home
	header._mhIcon:SetTexture(LOOK_ICON_PATH:format(screen.stem))
	header._mhText:SetText(self:L(screen.tagline))
end

--- Apply ns:L() to the main shell (tabs, search row, SMC headers, side helpers). See Locales/*.lua.
function ns:RefreshLocaleUI()
	if self.ApplyBindingLabels then
		self:ApplyBindingLabels()
	end
	local r = self._mhLocaleRefs
	if not r then
		return
	end

	if r.title and r.title.SetText then
		r.title:SetText(self:L("MAIN_TITLE"))
	end
	if r.titleVersion and r.titleVersion.SetText then
		local ver = ns.GetAddonVersion and ns.GetAddonVersion() or "?"
		r.titleVersion:SetText(self:L("MAIN_TITLE_VERSION_FMT"):format(ver))
	end
	if r.searchHint and r.searchHint.SetText then
		r.searchHint:SetText(self:L("SEARCH_LABEL"))
	end
	if ns.mhSearchPlaceholder then
		ns.mhSearchPlaceholder:SetText(self:L("SEARCH_PLACEHOLDER"))
	end
	if r.searchResetBtn and r.searchResetBtn.SetText then
		r.searchResetBtn:SetText(self:L("SEARCH_MY_CHARACTER"))
	end
	if r.searchGoBtn and r.searchGoBtn.SetText then
		r.searchGoBtn:SetText(self:L("SEARCH_GO"))
	end
	if r.aboutBtn and r.aboutBtn.SetText then
		r.aboutBtn:SetText(self:L("ABOUT_BUTTON"))
	end
	if ns._mhRefreshLookToggle then
		ns._mhRefreshLookToggle()
	end

	if r.tabKeys and self.tabButtons then
		for id, btn in pairs(self.tabButtons) do
			local key = r.tabKeys[id]
			if key and btn and btn.SetText then
				btn:SetText(self:EscapeButtonAmpersand(self:L(key)))
				FitSidebarTabButton(btn)
			end
		end
	end

	if r.smcHeader and r.smcHeader.SetText then
		r.smcHeader:SetText(self:L("SMC_GUIDE_TITLE"))
	end
	if r.smcSubtitle and r.smcSubtitle.SetText then
		r.smcSubtitle:SetText(self:L("SMC_GUIDE_SUBTITLE"))
	end

	local sg = self.panels and self.panels.smcguide
	local clRef = sg and sg._mhChecklistLocaleRefs
	if type(clRef) == "table" then
		if clRef.header and clRef.header.SetText then
			clRef.header:SetText(self:L("SMC_CHECKLIST_TITLE"))
		end
		if clRef.hint and clRef.hint.SetText then
			clRef.hint:SetText(self:L("SMC_CHECKLIST_HINT"))
		end
		local rows = clRef.rows
		if type(rows) == "table" then
			for i = 1, #rows do
				local row = rows[i]
				if row and row.titleFs and row.entry and row.entry.labelKey then
					row.titleFs:SetText(self:L(row.entry.labelKey))
				end
			end
		end
	end
	if ns.SMC_RefreshDynamicChecklist then
		ns.SMC_RefreshDynamicChecklist()
	end
	if ns.MH_RefreshRoleAcademyPanel and self.panels and self.panels.academy then
		ns.MH_RefreshRoleAcademyPanel(self.panels.academy)
	end

	if r.guideSubTabButtons then
		local bg = r.guideSubTabButtons.guide
		local bl = r.guideSubTabButtons.layout
		if bg and bg.SetText then
			bg:SetText(self:L("TAB_GUIDE_SUB_GUIDE"))
		end
		if bl and bl.SetText then
			bl:SetText(self:L("TAB_GUIDE_SUB_LAYOUT"))
		end
	end

	-- Toolbox sub-tab buttons + sub-panel headers (their ids are no longer in
	-- TAB_DEFS, so the generic tab relabel loop above does not cover them).
	if ns.toolboxSubTabButtons and ns._mhToolboxSubTabDefs then
		for _, def in ipairs(ns._mhToolboxSubTabDefs) do
			local btn = ns.toolboxSubTabButtons[def.id]
			if btn and btn.SetText then
				btn:SetText(self:L(def.labelKey))
			end
			local panel = self.panels and self.panels[def.id]
			if panel and panel._header and panel._header.SetText then
				panel._header:SetText(self:L(def.labelKey))
			end
		end
		if ns.RelayoutToolboxSubNav then
			ns.RelayoutToolboxSubNav()
		end
	end

	if self.uiSelectedTab == "guide" and self._mhGuideRefresh then
		self:_mhGuideRefresh()
	end
	local macroPanel = self.panels and self.panels.macros
	if macroPanel and macroPanel._mhRefreshMacros then
		macroPanel._mhRefreshMacros()
	end
	local consPanel = self.panels and self.panels.consumables
	if consPanel and consPanel._mhRefreshConsumables then
		consPanel._mhRefreshConsumables()
	end
	local layoutPanel = self._mhGuideLayoutPanel
	if layoutPanel and layoutPanel._mhProtoBuilt and ns.KeyboardLayoutPrototype_Refresh then
		ns.KeyboardLayoutPrototype_Refresh(layoutPanel)
	end
	if self.RefreshLookHeader then
		self:RefreshLookHeader()
	end
	if self._mhRefreshSidePanel then
		self:_mhRefreshSidePanel(self.uiSelectedTab or "delves")
	end
end

function ns:ApplyCompactMode()
	local refs = self._mhLayoutRefs
	if not refs or not refs.main then
		return
	end
	local m = MHGetLayoutMetrics()

	if refs.sidebar and refs.sidebar.SetWidth then
		refs.sidebar:SetWidth(m.sidebarWidth)
	end
	-- Content column, and the 4.0 screen header above it unless Classic: one helper, so
	-- compact mode and the Classic setting can never disagree about where content starts.
	MHAnchorContentColumn(refs, m)
	if refs.searchResetBtn and refs.searchResetBtn.SetWidth then
		refs.searchResetBtn:SetWidth(m.searchResetBtnWidth)
	end
	if refs.searchGoBtn and refs.searchGoBtn.SetWidth then
		refs.searchGoBtn:SetWidth(m.searchGoBtnWidth)
	end
	if refs.searchBar and refs.searchBar.SetHeight then
		refs.searchBar:SetHeight(m.searchBarHeight)
	end
	if refs.addonsSubNav and refs.addonsSubNav.SetHeight then
		refs.addonsSubNav:SetHeight(m.addonSubNavHeight)
	end
	if refs.addonsSubContent then
		refs.addonsSubContent:ClearAllPoints()
		refs.addonsSubContent:SetPoint("TOPLEFT", refs.addonsSubNav, "BOTTOMLEFT", 0, m.addonSubContentTopGap)
		refs.addonsSubContent:SetPoint("BOTTOMRIGHT", refs.addonsPanel, "BOTTOMRIGHT", -8, 8)
	end
	if refs.infoWindow and refs.infoWindow.SetWidth then
		refs.infoWindow:SetWidth(m.infoWindowWidth)
		-- Keep a height fitted to the text (see _mhRefreshSidePanel); only the minimum comes from here.
		refs.infoWindow:SetHeight(math.max(m.infoWindowHeight, refs.infoWindow._mhFitHeight or 0))
	end
	if refs.reanchorInfoWindow then
		refs.reanchorInfoWindow()
	end
	if self.tabButtons then
		for _, btn in pairs(self.tabButtons) do
			if btn and btn.SetSize then
				btn:SetSize(m.sidebarWidth - 16, m.sidebarTabHeight)
			end
		end
	end
	if self.addonSubTabButtons then
		for _, btn in pairs(self.addonSubTabButtons) do
			if btn and btn.SetHeight then
				btn:SetHeight(m.addonSubTabHeight)
			end
		end
	end
	if self.guideSubTabButtons then
		for _, btn in pairs(self.guideSubTabButtons) do
			if btn and btn.SetHeight then
				btn:SetHeight(m.addonSubTabHeight)
			end
		end
	end
	local gp = refs.guidePanel
	if gp and gp._mhSubNav and gp._mhSubNav.SetHeight then
		gp._mhSubNav:SetHeight(m.addonSubNavHeight)
	end
	if gp and gp._mhSubNav and gp._mhSubContent then
		gp._mhSubContent:ClearAllPoints()
		gp._mhSubContent:SetPoint("TOPLEFT", gp._mhSubNav, "BOTTOMLEFT", 0, m.addonSubContentTopGap)
		gp._mhSubContent:SetPoint("BOTTOMRIGHT", gp, "BOTTOMRIGHT", -8, 8)
	end
	if self._mhRelayoutSidebarTabs then
		self._mhRelayoutSidebarTabs()
	end

	local scale = (self.db and self.db.ui and self.db.ui.scale) or 1
	if refs.main.SetScale then
		refs.main:SetScale(scale * (m.compact and 0.92 or 1))
	end
end

local function MHRefreshAddonSubTabChrome(activeSubId)
	if not ns.addonSubTabButtons then
		return
	end
	for id, btn in pairs(ns.addonSubTabButtons) do
		if id == activeSubId then
			btn:SetAlpha(1)
			MHTintButtonTextures(btn, MH_CHROME.tabTexActive[1], MH_CHROME.tabTexActive[2], MH_CHROME.tabTexActive[3])
		else
			btn:SetAlpha(0.88)
			MHTintButtonTextures(btn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
		end
	end
end

local function MHRefreshGuideSubTabChrome(activeSubId)
	if not ns.guideSubTabButtons then
		return
	end
	for id, btn in pairs(ns.guideSubTabButtons) do
		if id == activeSubId then
			btn:SetAlpha(1)
			MHTintButtonTextures(btn, MH_CHROME.tabTexActive[1], MH_CHROME.tabTexActive[2], MH_CHROME.tabTexActive[3])
		else
			btn:SetAlpha(0.88)
			MHTintButtonTextures(btn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
		end
	end
end

local function MHRefreshToolboxSubTabChrome(activeSubId)
	if not ns.toolboxSubTabButtons then
		return
	end
	for id, btn in pairs(ns.toolboxSubTabButtons) do
		if id == activeSubId then
			btn:SetAlpha(1)
			MHTintButtonTextures(btn, MH_CHROME.tabTexActive[1], MH_CHROME.tabTexActive[2], MH_CHROME.tabTexActive[3])
		else
			btn:SetAlpha(0.88)
			MHTintButtonTextures(btn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
		end
	end
end

--- Reposition Toolbox sub-tab buttons, hiding beta-gated ones (macros/academy)
--- when their Settings checkbox is off. Called at build, on locale switch, and
--- from RefreshBetaTabVisibility.
function ns.RelayoutToolboxSubNav()
	local defs = ns._mhToolboxSubTabDefs
	local btns = ns.toolboxSubTabButtons
	local host = ns.panels and ns.panels.toolbox
	local subNav = host and host._mhSubNav
	if not defs or not btns or not subNav then
		return
	end
	local x = 0
	for _, def in ipairs(defs) do
		local btn = btns[def.id]
		if btn then
			local visible = ((not def.beta) or (ns.IsBetaTabEnabled and ns.IsBetaTabEnabled(def.id)))
				and not (ns.IsScreenHidden and ns.IsScreenHidden(def.id))
			if visible then
				btn:ClearAllPoints()
				btn:SetPoint("TOPLEFT", subNav, "TOPLEFT", x, -6)
				btn:Show()
				x = x + (btn:GetWidth() or 120) + 6
			else
				btn:Hide()
			end
		end
	end
end

--------------------------------------------------------------------------------
-- SMC City Guide (Midnight 12.0.5)
--------------------------------------------------------------------------------
local SMC_CITY_MAP_ID = 2393

--- ⚠️ EVERY PIN HERE USED TO CARRY A HARDCODED DUTCH SENTENCE.
---
--- Rob runs the addon on `auto`, which resolves to English, and on 12 Aug 2026 he
--- noticed the city guide's tooltips were Dutch. All 43 of them were, in every language,
--- since the page was built — the single largest untranslated surface in the addon.
---
--- Thirty of those sentences said nothing their own label did not already say: "Zet een
--- waypoint naar de Alchemy trainer" under a button that reads *Alchemy*. Those are gone
--- rather than translated, and the text is built from the label instead. Seven languages
--- times thirty sentences is the kind of bulk edit that broke three locale files on
--- 22 July; not writing them at all is better than writing them carefully.
---
--- So a pin now says nothing about its own description and gets the generic line, or sets
--- `trainer = true` for the profession phrasing, or names a `descKey` when it genuinely
--- has something to add. Anything still holding a literal `description` is a leftover
--- from the second pass and renders as it always did.
---
--- ⏭️ STILL DUTCH, deliberately (round two): the fifteen pins that carry real content, and
--- the seven category titles. Those need real translations, not a template.
--- A category heading, through the locale. Same reasoning as PinDescription: the seven
--- headings were English literals, which nobody in English ever noticed and nobody in
--- German could ever fix.
local function CategoryTitle(cat)
	if not cat then
		return ""
	end
	-- Two existing words joined ("Dungeons & Raids"): each pack already names both tabs, so the
	-- heading follows the pack's own words without a key of its own.
	if cat.titleKeys then
		local parts = {}
		for _, key in ipairs(cat.titleKeys) do
			parts[#parts + 1] = ns:L(key)
		end
		return table.concat(parts, " & ")
	end
	if cat.titleKey then
		return ns:L(cat.titleKey)
	end
	return cat.title or ""
end

local function PinDescription(point)
	if not point then
		return ""
	end
	if point.descKey then
		return ns:L(point.descKey)
	end
	if point.description then
		return point.description
	end
	local fmt = ns:L(point.trainer and "SMC_PIN_TRAINER_FMT" or "SMC_PIN_GOTO_FMT")
	local okFmt, text = pcall(string.format, fmt, tostring(point.label or "?"))
	return okFmt and text or tostring(point.label or "")
end

local SMC_CATEGORIES = {
	{
		titleKey = "SMC_CAT_ESSENTIAL",
		items = {
			{ id = "bank", label = "Bank & Vault", atlas = "services-icon-bank", x = 50.36, y = 65.19 },
			{ id = "item_upgrades", label = "Cuzoth — Item Upgrades", descKey = "SMC_PIN_ITEM_UPGRADES", atlas = "ItemUpgrade-FX-UpgradeArrow", x = 48.23, y = 61.75 },
			{ id = "crest_exchange", label = "Vaskarn — Crest Exchange", descKey = "SMC_PIN_CREST_EXCHANGE", atlas = "WarWithin-Icon-Crest", x = 48.28, y = 61.75 },
			{ id = "ah", label = "Auction House", atlas = "services-icon-auctioneer", x = 51.50, y = 74.68 },
			{ id = "mailbox", label = "Mailbox", atlas = "services-icon-mailroom", x = 49.41, y = 65.92 },
			{ id = "inn_cooking", label = "Inn & Cooking", atlas = "services-icon-innkeeper", x = 56.28, y = 70.33 },
			{ id = "trading_post", label = "Trading Post", atlas = "ui-delves", x = 48.88, y = 78.15 },
			{ id = "bmah", label = "BMAH", atlas = "services-icon-auctioneer", x = 51.86, y = 48.56 },
			{ id = "transmog", label = "Transmog", atlas = "services-icon-transmogrifier", x = 52.87, y = 57.44 },
			{ id = "crafting_orders", label = "Crafting Orders (Mar'nah)", atlas = "services-icon-battlenet", x = 45.0, y = 55.6 },
			--- ⚠️ COORDINATEN GEMETEN, NIET UIT EEN GIDS. Rob stond bij hem en draaide
			--- `/mh capture` op 12 aug 2026: map 2393, 45.03 / 56.20. De gids die dit
			--- aanreikte zei 44.95 / 56.07 — dichtbij, en dichtbij is precies hoe je iemand
			--- naast een NPC laat landen.
			---
			--- 20 aug hermeten met `/mh here`, nu mét npc-id: **45.05 / 56.17, npc 243280**.
			--- Twee honderdsten van de eerste meting — dat is geen correctie maar een
			--- bevestiging, en het is de reden om hem over te nemen: twee onafhankelijke
			--- metingen die samenvallen zijn sterker dan één. Het npc-id is de echte winst;
			--- daarmee is de pin te controleren zonder op de naam te vertrouwen.
			---
			--- ⚠️ DE TEKST KOMT UIT ZIJN EIGEN BEVESTIGINGSVENSTER, woordelijk: "You will
			--- lose all associated recipes and be able to re-allocate your knowledge as you
			--- see fit. This can only be done ONCE." De research die hier binnenkwam zei dat
			--- recepten "tijdelijk" weg zijn en vanzelf terugkomen als je identiek herbesteedt.
			--- Dat staat er niet, en het is de ene zin die iemand zijn recepten kan kosten.
			--- Het spel belooft niets terug — dus wij ook niet.
			{ id = "prof_reset", label = "Theremis — Reset specializations", descKey = "SMC_PIN_PROF_RESET", atlas = "services-icon-trainer", x = 45.05, y = 56.17, npcID = 243280 },
			{ id = "creation_catalyst", label = "Creation Catalyst", descKey = "SMC_PIN_CREATION_CATALYST", atlas = "creationcatalyst-32x32", x = 40.31, y = 64.85 },
		},
	},
	{
		titleKey = "SMC_CAT_VENDORS",
		items = {
			--- ⚠️ COORDS STILL UNCONFIRMED for both of these — they came from Wowhead
			--- (npc 255473 Maren, npc 255476 Triam, listed there as "Cosmetic Equipment
			--- Salvager") and nobody has stood next to them with `/mh capture`. Both
			--- point at the Ritual/Void hub, which is where they are said to be.
			---
			--- That caveat used to sit in the tooltip, where the player read
			--- "bevestig coords in-game" — an instruction to us, in a sentence meant for
			--- them. It belongs here. If a route lands you beside empty ground, this is
			--- the line that says why.
			{ id = "maren_silverwing", label = "Maren Silverwing — Gear caches", descKey = "SMC_PIN_MAREN_SILVERWING", atlas = "WarWithin-Icon-Crest", x = 48.11, y = 49.10 },
			{ id = "triam_dawnsetter", label = "Triam Dawnsetter — Transmog (cosmetics)", descKey = "SMC_PIN_TRIAM_DAWNSETTER", atlas = "services-icon-transmogrifier", x = 48.11, y = 49.10 },
		},
	},
	{
		titleKey = "SMC_CAT_TRAVEL",
		items = {
			{ id = "portals", label = "Portal Room", atlas = "portal-horde-white", x = 53.37, y = 66.31 },
			{ id = "portal_voidstorm", label = "Portal to Voidstorm", atlas = "portal-horde-white", x = 35.25, y = 65.85 },
			{ id = "portal_harandar", label = "Portal to Harandar", atlas = "portal-horde-white", x = 36.76, y = 68.52 },
			--- ⚠️ COORDINAAT GEMETEN, NIET UIT EEN GIDS. Rob stond op 19 aug bij Astalor,
			--- had hem aangeklikt (npc 246231 mee vastgelegd) en draaide `/mh here`: map
			--- 2393, 56.74 / 67.30. Onze Codex stuurde mensen tot vandaag naar 55.00 / 63.40
			--- — bijna vier punten mis, wat in een stad een andere straat is.
			---
			--- Deze pin is er omdat de addon het portaal wél kende (het staat in
			--- MIDNIGHT_PORTALS en het reisplan bood het al aan) maar nergens liet zien
			--- waar het stáát. Rob, 19 aug, vanaf het eiland: "ik weet niet 1 2 3 waar die
			--- portal is naar smc". Iets kennen en iemand het kunnen laten vinden zijn twee
			--- verschillende dingen.
			--- ✅ 3 sep 2026 — DE OUDE COÖRDINAAT WAS DE DEUR, NIET EEN FOUT. Rob stond op
			--- 94 yard van het portaal met de pijl dwars door een muur, en las de ingang af
			--- op 54.99 / 63.30. Dat is op een tiende na het 55.00 / 63.40 dat hierboven als
			--- "bijna vier punten mis" is weggeschreven. Twee onafhankelijke metingen van
			--- dezelfde deur, vijf weken uit elkaar. Op 19 aug hebben we hem vervángen door
			--- de bestemming; hij hoorde ernáást te staan.
			--- `arrivesOn = 2512`: stepping onto the Coiled Isle IS arriving. Without it the
			--- addon kept planning from "your destination is in Silvermoon" the moment Rob
			--- came out the far side. See the note above ns.lastTarget in RouteSmcPoint.
			{ id = "portal_coiled_isle", label = "Portal to The Coiled Isle", descKey = "SMC_PIN_PORTAL_ISLE", atlas = "portal-horde-white", x = 56.74, y = 67.30, entrance = { x = 54.99, y = 63.30 }, arrivesOn = 2512, requiresQuest = 96004 },
			{ id = "timeways", label = "Timeways (Lindormi)", atlas = "portal-horde-white", x = 42.30, y = 58.30 },
			{ id = "mplus_teleports", label = "M+ Teleports", atlas = "flightmaster", x = 42.03, y = 58.30 },
		},
	},
	{
		titleKey = "SMC_CAT_QUEST_HUBS",
		items = {
			{
				id = "world_boss_week",
				label = "World boss this week",
				descKey = "SMC_PIN_WORLD_BOSS_WEEK",
				atlas = "groupfinder-icon-flag",
				action = "worldboss_week",
				x = 48.95,
				y = 64.92,
			},
			{ id = "prey_hub", label = "Prey Hub", atlas = "ui-delves", x = 56.19, y = 65.33 },
			{ id = "astalor", label = "Magister Astalor Bloodsworn", atlas = "services-icon-transmogrifier", x = 55.00, y = 63.40 },
			{ id = "weekly_hub", label = "Weekly Quest Givers", descKey = "SMC_PIN_WEEKLY_HUB", atlas = "services-icon-innkeeper", x = 48.95, y = 64.92 },
			-- Eén knop voor twee systemen kon maar één ding doen, en werd dus de
			-- enige in dit raster die je niet ergens heen stuurde (Rob, 28 jul).
			-- Gesplitst, want de bestemmingen verschillen echt van aard: de
			-- ritual site is één obelisk met exacte coords die weekelijks
			-- rouleert, de void assault heeft géén enkel punt (strikes worden
			-- los gemarkeerd) en kan alleen naar de staging-hub wijzen.
			{ id = "ritual_hub", label = "Ritual Site (active)", descKey = "SMC_PIN_RITUAL_HUB", atlas = "groupfinder-icon-flag", action = "ritual_site", x = 48.2, y = 49.4 },
			{ id = "void_hub", label = "Void Assault hub", descKey = "SMC_PIN_VOID_HUB", atlas = "groupfinder-icon-flag", action = "void_hub", x = 48.2, y = 49.4 },
			{ id = "delves_hq", label = "Delves HQ", atlas = "ui-delves", x = 52.10, y = 77.70 },
			{ id = "valeera_delves", label = "Valeera Sanguinar (Delves)", atlas = "ui-delves", x = 52.40, y = 78.20 },
			{ id = "training_dummies", label = "Training Dummies", atlas = "services-icon-dueling", x = 36.0, y = 84.2 },
			{ id = "pvp_hub", label = "PvP Hub", atlas = "pvpqueue-icon-honor", x = 34.40, y = 81.00 },
		},
	},
	{
		titleKey = "SMC_CAT_HORDE",
		items = {
			{ id = "horde_inn", label = "Horde Inn", atlas = "services-icon-innkeeper", x = 66.91, y = 62.09 },
			{ id = "horde_bank", label = "Horde Bank & Vault", atlas = "services-icon-bank", x = 72.04, y = 64.87 },
			{ id = "horde_ah", label = "Horde Auction House", atlas = "services-icon-auctioneer", x = 67.64, y = 70.74 },
			{ id = "horde_creation_catalyst", label = "Horde Creation Catalyst", atlas = "creationcatalyst-32x32", x = 70.06, y = 83.27 },
		},
	},
	{
		titleKey = "SMC_CAT_PROFESSIONS",
		items = {
			{ id = "alchemy", label = "Alchemy", trainer = true, atlas = "ui-profession-alchemy", x = 47.02, y = 51.88 },
			{ id = "blacksmithing", label = "Blacksmithing", trainer = true, atlas = "ui-profession-blacksmithing", x = 43.74, y = 51.33 },
			{ id = "enchanting", label = "Enchanting", trainer = true, atlas = "ui-profession-enchanting", x = 47.97, y = 53.63 },
			{ id = "engineering", label = "Engineering", trainer = true, atlas = "ui-profession-engineering", x = 43.53, y = 54.01 },
			{ id = "inscription", label = "Inscription", trainer = true, atlas = "ui-profession-inscription", x = 46.78, y = 51.48 },
			{ id = "jewelcrafting", label = "Jewelcrafting", trainer = true, atlas = "ui-profession-jewelcrafting", x = 47.93, y = 55.15 },
			{ id = "leatherworking", label = "Leatherworking", trainer = true, atlas = "ui-profession-leatherworking", x = 43.15, y = 55.70 },
			{ id = "tailoring", label = "Tailoring", trainer = true, atlas = "ui-profession-tailoring", x = 48.25, y = 54.15 },
		},
	},
	{
		titleKey = "SMC_CAT_GATHERING",
		items = {
			{ id = "fishing", label = "Fishing", descKey = "SMC_PIN_FISHING", atlas = "ui-profession-fishing", x = 44.70, y = 60.20 },
			{ id = "herbalism_trainer", label = "Herbalism Trainer", atlas = "ui-profession-herbalism", x = 48.20, y = 51.52 },
			{ id = "mining_trainer", label = "Mining Trainer", atlas = "ui-profession-mining", x = 42.68, y = 52.84 },
			{ id = "skinning_trainer", label = "Skinning Trainer", atlas = "ui-profession-skinning", x = 43.27, y = 55.59 },
		},
	},
}

--- The city's own flight masters, built from ns.FLIGHT_POINTS rather than typed out.
---
--- Rob, 21 Aug 2026: "ik zoek nu een dichtstbijzijnde flightpoint in SMC, en vroeg me af
--- waar is ie". The addon has had every Midnight flight point since 16 Aug and routes
--- people through them — and the city guide, which lists portals, Timeways and even M+
--- teleports, never showed the one thing you use most. Same fault as the Coiled Isle
--- portal above: knowing a thing and letting someone find it are different jobs.
---
--- There are TWO in Silvermoon, which is the whole reason this belongs on a map pin:
--- the useful question is not "where is the flight master" but "which one is nearer".
---
--- Read from the data instead of copied into this table on purpose. A second copy of a
--- coordinate is a second thing to update, and this repo spent 20 Aug repairing text that
--- had drifted away from the data beside it.
do
	local SILVERMOON_MAP = 2393
	local fps = ns.FLIGHT_POINTS and ns.FLIGHT_POINTS[SILVERMOON_MAP]
	if type(fps) == "table" then
		for _, cat in ipairs(SMC_CATEGORIES) do
			if cat.titleKey == "SMC_CAT_TRAVEL" then
				-- First, the one that is not about Silvermoon: nearest stop from
				-- wherever you are. This is what Rob was actually asking for; the
				-- two pins below only answer the question inside this city.
				cat.items[#cat.items + 1] = {
					id = "nearest_fp",
					label = "Nearest flight master (any zone)",
					descKey = "SMC_PIN_NEAREST_FP",
					atlas = "flightmaster",
					action = "nearest_fp",
					x = 50.97,
					y = 71.25,
				}
				for i, fp in ipairs(fps) do
					local name, x, y = fp[1], tonumber(fp[2]), tonumber(fp[3])
					if name and x and y then
						cat.items[#cat.items + 1] = {
							id = "flightmaster_" .. i,
							-- Label stays English like every other pin here; only the
						-- description resolves through the locale. These labels are
						-- built once at load, so a resolved string would freeze on
						-- the language that was active at login.
						label = "Flight master — " .. name,
							descKey = "SMC_PIN_FLIGHTMASTER",
							atlas = "flightmaster",
							x = x,
							y = y,
						}
					end
				end
				break
			end
		end
	end
end

-- Search helpers (Guide.lua): keyword blobs per waypoint + scroll target after panel build.
--- ⚠️ REBUILT ON A LANGUAGE SWITCH, because the blobs now contain translated text.
--- They used to hold the hardcoded Dutch, which was wrong but at least never went stale;
--- resolving through the locale means a `/mh lang` would otherwise leave the index
--- searching for words the tooltips no longer show.
local function BuildSMCSearchRows()
	local rows = {}
	for _, cat in ipairs(SMC_CATEGORIES) do
		for _, point in ipairs(cat.items or {}) do
			local blob = string.lower(
				string.format(
					"%s %s %s %s",
					tostring(CategoryTitle(cat)),
					tostring(point.label or ""),
					tostring(PinDescription(point)),
					tostring(point.id or "")
				)
			)
			rows[#rows + 1] = { blob = blob, point = point }
		end
	end
	ns._mhSMCGuideSearchRows = rows
end

do
	BuildSMCSearchRows()
	local orig = ns.RefreshLocaleUI
	function ns:RefreshLocaleUI()
		if orig then
			orig(self)
		end
		BuildSMCSearchRows()
	end
end

--- The Dungeons & Raids block. Rob, 14 Sep 2026: "ik wil ook een blok dungeons en raids erbij
--- hebben in onze smc tab blad waar oa ook de portals staan".
---
--- ⚠️ Built when the panel is built, not at load: UI.lua loads before
--- Modules/DungeonRosterData.lua and Modules/RaidCoachData.lua, so their lists do not exist yet
--- when SMC_CATEGORIES does. Read from those lists, like the flight masters above, so every
--- entrance is typed in one place. Only entries that have one: the raids and the Midnight
--- dungeons. The older dungeons of the season lie on other continents and have the M+ Teleports
--- pin instead.
local smcInstancesAdded = false
local function AddSMCInstanceCategory()
	if smcInstancesAdded then
		return
	end
	smcInstancesAdded = true
	local items = {}
	-- "Dungeon" is the atlas Mythic Dungeon Tools draws entrances with. "Raid" is checked first:
	-- an unknown atlas does not error, it just draws nothing.
	local raidAtlas = (C_Texture and C_Texture.GetAtlasInfo and C_Texture.GetAtlasInfo("Raid")) and "Raid" or "Dungeon"
	local function add(entry, isRaid)
		local e = entry and entry.entrance
		if not (e and e.mapID and e.x and e.y) then
			return
		end
		items[#items + 1] = {
			id = "inst_" .. tostring(entry.key),
			label = (ns.GetDungeonDisplayName and ns.GetDungeonDisplayName(entry)) or entry.name or "?",
			atlas = isRaid and raidAtlas or "Dungeon",
			raid = isRaid and true or nil, -- picks the raids or the dungeons picture on a 4.0 card
			instance = entry,
			mapID = e.mapID,
			x = e.x,
			y = e.y,
		}
	end
	-- Raids and then the lairs (The Tidebound Grotto), the same list the Raids page shows.
	local raidList = (ns.GetRaidPageList and ns.GetRaidPageList())
		or (ns.GetRaidCoachRaids and ns.GetRaidCoachRaids()) or {}
	for _, raid in ipairs(raidList) do
		add(raid, true)
	end
	for _, d in ipairs(ns.GetDungeonRoster and ns.GetDungeonRoster() or {}) do
		if d.native then
			add(d, false)
		end
	end
	if #items == 0 then
		return
	end
	local cat = { titleKeys = { "TAB_DUNGEONS", "TAB_RAIDS" }, items = items }
	local at = #SMC_CATEGORIES + 1
	for i, c in ipairs(SMC_CATEGORIES) do
		if c.titleKey == "SMC_CAT_TRAVEL" then
			at = i + 1
			break
		end
	end
	table.insert(SMC_CATEGORIES, at, cat)
	-- The search index was built at load, before this block existed. Add its rows the way
	-- WorldBoss.lua adds its own; a full rebuild here would drop that one.
	ns._mhSMCGuideSearchRows = ns._mhSMCGuideSearchRows or {}
	for _, point in ipairs(items) do
		ns._mhSMCGuideSearchRows[#ns._mhSMCGuideSearchRows + 1] = {
			blob = string.lower(("%s %s %s dungeon raid entrance"):format(CategoryTitle(cat), point.label, point.id)),
			point = point,
		}
	end
end

local function TriggerTomTomWaySlash(point)
	if not C_AddOns then
		return false
	end

	if C_AddOns.IsAddOnLoaded and not C_AddOns.IsAddOnLoaded("TomTom") and C_AddOns.LoadAddOn then
		pcall(C_AddOns.LoadAddOn, "TomTom")
	end

	local slashWay = SlashCmdList and SlashCmdList["TOMTOM_WAY"]
	if type(slashWay) ~= "function" then
		return false
	end

	local mapID = SMC_CITY_MAP_ID
	local cmd = ("#%d %.2f %.2f %s"):format(mapID, point.x, point.y, point.label or "SMC")
	local ok = pcall(slashWay, cmd)
	return ok
end

local function SetSMCWaypoint(point)
	if type(point) ~= "table" then
		return
	end

	-- 14 Sep 2026: a dungeon or raid entrance in another zone (the Dungeons & Raids block).
	-- Same route the Dungeons and Raids pages set, so the three can never disagree.
	if point.instance then
		if ns.RouteDungeonEntrance then
			ns.RouteDungeonEntrance(point.instance)
		end
		return
	end

	-- Non-map actions (pseudo rows in SMC list).
	--- The only row here that is not about Silvermoon at all. It sits with the other
	--- travel buttons because that is where someone looks for "how do I get around",
	--- but it reads where you are standing and works in every zone we have stops for.
	if point.action == "nearest_fp" then
		if ns.RouteToNearestFlightPoint then
			ns.RouteToNearestFlightPoint()
		end
		return
	end

	if point.action == "worldboss_week" then
		if ns.ShowMainUI and ns.SelectTab then
			ns:ShowMainUI()
			ns.SelectTab("delves")
		end
		if ns.RouteToActiveWorldBoss then
			ns.RouteToActiveWorldBoss()
		end
		return
	end

	if point.action == "world_tab" then
		if ns.ShowMainUI and ns.SelectTab then
			ns:ShowMainUI()
			ns.SelectTab("world")
		end
		return
	end

	-- Route without opening the World tab: Rob asked for that on 9 jul, so the
	-- arrow starts pointing immediately instead of burying you in a screen. The
	-- tab is still a click away when the destination is not known.
	local function OpenWorldTab()
		if ns.ShowMainUI and ns.SelectTab then
			ns:ShowMainUI()
			ns.SelectTab("world")
		end
	end

	if point.action == "ritual_site" then
		local site = ns.GetActiveRitualSite and ns.GetActiveRitualSite() or nil
		if site and ns.RouteRitualSite and site.mapID and site.x and site.y then
			ns.RouteRitualSite(site)
		else
			OpenWorldTab() -- no active site known; do not invent a destination
		end
		return
	end

	if point.action == "void_hub" then
		if ns.RouteVoidHub then
			ns.RouteVoidHub()
		else
			OpenWorldTab()
		end
		return
	end

	--- 🔴 EVERY PIN BELOW THIS LINE IS IN SILVERMOON, AND SILVERMOON OPENS AT 80.
	--- Rob, 3 Sep 2026 on a level-69 Paladin: *"eigenlijk zou dit soort adviezen niet
	--- moeten kunnen, tenslotte kan ik nog niet naar dat gebied want ik ben <80. toch"*.
	--- He is right, and the first answer he got from me was too quick: I said it was not a
	--- bug because he had clicked the pin himself. That explains why the line appeared and
	--- excuses nothing -- an arrow and "head for Portal to Silvermoon" is still advice he
	--- cannot act on, and it is the same mistake as the weekly headline, one screen over.
	---
	--- 📌 The map STAYS. Looking up where Cuzoth stands is reference, and a city guide that
	--- goes blank below 80 would be the hiding we rejected this morning. What stops is the
	--- ROUTE: no waypoint, no arrow, no travel plan -- and a line saying why, so that
	--- nothing-happened cannot be mistaken for something-broke.
	--- ⚠️ `nearest_fp` and `world_tab` above are deliberately NOT gated: one reads where you
	--- are standing and works everywhere, the other only opens a tab.
	if ns.MidnightFloorMet and not ns.MidnightFloorMet() then
		if ns.PrintChatKey then
			ns:PrintChatKey("SMC_LOCKED_FMT", ns.MidnightFloorLevel or 80)
		end
		return
	end

	local mapID = SMC_CITY_MAP_ID
	point.mapID = mapID

	--- 🔴 SOME PINS ARE INSIDE A BUILDING, AND A COORDINATE DOES NOT OPEN A DOOR.
	--- Rob, 3 sep 2026, standing 94 yards from the Coiled Isle portal: the arrow
	--- pointed straight at the portal, through a wall. "onze pijl stuurt ons naar de
	--- plek op de kaart maar niet naar de ingang van het gebouw."
	---
	--- 📌 AND THE ENTRANCE WAS ALREADY IN THIS FILE, WRITTEN OFF AS A MISTAKE. The
	--- comment above the portal pin says the Codex used to send people to 55.00/63.40
	--- and calls it "bijna vier punten mis". Rob's own reading of the door today is
	--- 54.99/63.30 — the same spot. That coordinate was never wrong; it was the
	--- ENTRANCE, and on 19 aug we replaced it with the destination instead of keeping
	--- both. Two independent readings of the same doorway, five weeks apart.
	---
	--- So a pin may carry `entrance = { x, y }`: route there first, then hand over to
	--- the real target once the player is actually at the door.
	local target = point
	if type(point.entrance) == "table" and ns.StartSmcTwoStepRoute then
		target = ns.StartSmcTwoStepRoute(point, mapID) or point
	end

	local x = (tonumber(target.x) or 0) / 100
	local y = (tonumber(target.y) or 0) / 100
	if x <= 0 or y <= 0 then
		return
	end

	local mapPoint = nil
	if UiMapPoint and UiMapPoint.CreateFromCoordinates then
		local ok, created = pcall(UiMapPoint.CreateFromCoordinates, mapID, x, y)
		if ok and created then
			mapPoint = created
		end
	end

	if mapPoint and C_Map and C_Map.SetUserWaypoint then
		pcall(C_Map.SetUserWaypoint, mapPoint)
		if C_SuperTrack and C_SuperTrack.SetSuperTrackedUserWaypoint then
			pcall(C_SuperTrack.SetSuperTrackedUserWaypoint, true)
		end
	end

	-- Drive MidnightHelper's own on-screen arrow too (SMC sets its waypoint directly,
	-- so it wasn't engaging NativeArrow). Give it a lead + generic ownership, resetting
	-- a stale single-dest route so the arrow points here.
	--- 🔴 `arrivesOn` — A PORTAL ROUTE IS DONE WHEN YOU ARE THROUGH IT. Measured 5 Sep 2026,
	--- and only after the arrival message was built could anyone see it.
	---
	--- Rob routed to "Portal to The Coiled Isle", stepped through, and the addon promptly
	--- sent him back: on the isle it still believed his destination was a spot in SILVERMOON
	--- (which is where that portal stands), found the return portal two metres away, routed
	--- to that, and then declared him arrived at it. Every step was locally correct and the
	--- sum walked him backwards.
	---
	--- 📌 The flaw is what a portal route MEANS. "Route to the portal to X" is stored as the
	--- portal's own position, so the moment the player uses it we lose the thread and start
	--- planning the journey home. `arrivesOn` says where the far side is, so arriving there
	--- ends the route instead of starting a new one.
	ns.lastTarget = { mapID = mapID, x = tonumber(target.x) or 0, y = tonumber(target.y) or 0,
		name = target.label, via = "Silvermoon pin", arrivesOn = point.arrivesOn }
	local o = ns._mhRouteOwner
	if o == nil or o == "waypoint" or o == "delve" then
		ns._mhRouteOwner = "waypoint"
	end

	TriggerTomTomWaySlash(target)
	--- 🔴 SAY THAT WE PINNED, so the teardown can unpin. This route places a Blizzard user
	--- waypoint and a TomTom one directly, which NativeArrow's own bookkeeping (`mhOwnedKey`)
	--- cannot see -- and on 7 Sep both survived a route that had properly ended, leaving Rob
	--- with an arrow to Silvermoon while `/mh arrow` correctly read `route owner: none`.
	--- One flag, cleared by whoever tears the route down, whichever path ended it.
	ns._mhSmcPinsSet = true
	print(
		("|cffffcc00%s|r %s"):format(
			ns:L("PRINT_PREFIX"),
			ns:L("WAYPOINT_SET"):format(target.label or "SMC", mapID, target.x or 0, target.y or 0)
		)
	)
	-- One extra line when we are sending you to a door rather than the thing itself,
	-- because an arrow that stops at a building looks like an arrow that gave up.
	if target ~= point then
		print(("   |cffffff78%s|r"):format(
			(ns:L("SMC_ENTRANCE_THEN_FMT")):format(point.label or "?", point.x or 0, point.y or 0)))
	end

	--- 🔴 …AND THEN SAY HOW TO GET THERE. Rob, 5 Sep 2026, standing in Harandar and asking
	--- for the Coiled Isle portal: arrow, chat line, and no Travel Assistant — so no portal
	--- button and, on a mage, no teleport either. `/mh travelwhy` showed every gate green
	--- and both Harandar portals usable, which is what located it: the decision was fine,
	--- the popup was simply never asked for.
	---
	--- 📌 This route sets its own waypoint (SetUserWaypoint + the TomTom slash, above) and
	--- never touches `ns.AddSmartTomTomWay`, where the Travel Assistant lives. It is a
	--- SEVENTH bypass of that door — the 5 Sep audit found six and missed this one, because
	--- it grepped for the waypoint calls and this path hides its own behind
	--- `TriggerTomTomWaySlash`.
	---
	--- ⚠️ `ShowTravelAssistFor`, not a switch to `AddSmartTomTomWay`. This path deliberately
	--- owns its waypoint (the two-step door hand-off in TwoStepRoute.lua drives it), and
	--- rerouting it through the shared door would take that away to fix something else. The
	--- assistant is exactly the missing half and nothing more; it hides itself when the
	--- target is near or in the same region.
	if ns.ShowTravelAssistFor then
		pcall(ns.ShowTravelAssistFor, mapID, target.x, target.y, target.label)
	end
end

--- Route to a pin WITHOUT its two-step detour.
---
--- ⚠️ This exists so the second step cannot re-enter the first. TwoStepRoute calls it
--- on arrival at the door; handing it the original pin would look at `entrance` again,
--- decide you are not there yet (you are at the door, not at the portal) and send you
--- back out. A shallow copy with `entrance` stripped is the whole trick.
function ns.SetSMCWaypointDirect(point, mapID)
	if type(point) ~= "table" then
		return
	end
	local copy = {}
	for k, v in pairs(point) do
		copy[k] = v
	end
	copy.entrance = nil
	copy.mapID = mapID or copy.mapID
	SetSMCWaypoint(copy)
end

function ns.GetSMCCityPin(pinId)
	if not pinId then
		return nil
	end
	for _, cat in ipairs(SMC_CATEGORIES) do
		for _, pt in ipairs(cat.items or {}) do
			if pt.id == pinId then
				return pt
			end
		end
	end
	return nil
end

function ns.SetSMCCityWaypoint(pinId)
	local pt = ns.GetSMCCityPin(pinId)
	if pt then
		SetSMCWaypoint(pt)
	end
end

function ns.OpenSMCCityGuidePin(pinId)
	if ns.EnsureMainUI then
		ns:EnsureMainUI()
	end
	if ns.SelectTab then
		ns.SelectTab("smcguide")
	end
	local pt = ns.GetSMCCityPin(pinId)
	if not pt then
		return
	end
	if C_Timer and C_Timer.After then
		C_Timer.After(0.08, function()
			if ns.JumpSMCCityGuideToPoint then
				ns.JumpSMCCityGuideToPoint(pt)
			end
		end)
	else
		ns.JumpSMCCityGuideToPoint(pt)
	end
end

--- 4.0 cards for the Silvermoon tab. Rob, 14 Sep 2026: "misschien is het een idee om die pagina ook
--- grafisch aan te pakken"; he picked the pictures on his phone the same day and said "1 is ja 2 is
--- nu" (the pictures may go into the repo, build it now).
---
--- A pin without a picture of its own keeps Blizzard's map symbol. Classic keeps the 3.x buttons
--- exactly: 34 px, a 20 px symbol, the red template art. One local table on purpose, because this
--- chunk already declares a great many locals and Lua 5.1 stops at 200.
local SMCCard = {
	ICONS = {
		portals = "smc_portal",
		portal_voidstorm = "smc_portal",
		portal_harandar = "smc_portal",
		portal_coiled_isle = "smc_portal",
		timeways = "smc_portal",
		-- Not the flight master's picture. Rob: "voor portals niet dezelfde iconen als voor de
		-- flightpoints" — and a teleport is not a flight, so it got a keystone of its own.
		mplus_teleports = "smc_keystone",
		nearest_fp = "smc_flight",
		bank = "smc_bank",
		horde_bank = "smc_bank",
		ah = "smc_auction",
		bmah = "smc_auction",
		horde_ah = "smc_auction",
		inn_cooking = "smc_inn",
		horde_inn = "smc_inn",
		item_upgrades = "smc_upgrade",
		-- Round 2, picked by Rob on his phone the same day ("Op beide vragen ja").
		mailbox = "smc_mail",
		transmog = "smc_transmog",
		triam_dawnsetter = "smc_transmog",
		creation_catalyst = "smc_catalyst",
		horde_creation_catalyst = "smc_catalyst",
		crest_exchange = "smc_crest",
		maren_silverwing = "smc_crest",
		weekly_hub = "smc_weekly",
		pvp_hub = "smc_pvp",
		-- Round 3 (Rob, 14 Sep: "c", picked on his phone). These pins named Blizzard atlases that the game
		-- does not have, so their slot stayed empty; `/mh smcicons` lists any pin still in that state.
		alchemy = "smc_alchemy",
		blacksmithing = "smc_blacksmith",
		enchanting = "smc_enchanting",
		engineering = "smc_engineering",
		inscription = "smc_inscription",
		jewelcrafting = "smc_jewelcrafting",
		leatherworking = "smc_leatherworking",
		tailoring = "smc_tailoring",
		fishing = "smc_fishing",
		herbalism_trainer = "smc_herbalism",
		mining_trainer = "smc_mining",
		skinning_trainer = "smc_skinning",
		training_dummies = "smc_dummy",
		-- Round 4 (Rob, 15 Sep, from his screenshots: "we missen er een paar"): the last four pins whose
		-- Blizzard atlas does not exist either. Picked on his phone; "keuze geldt als ja".
		crafting_orders = "smc_crafting",
		prof_reset = "smc_reset",
		prey_hub = "smc_prey",
		astalor = "smc_astalor",
		-- Screen icons Rob already approved on 12 Sep, reused where the pin is that screen's subject.
		trading_post = "tradingpost",
		delves_hq = "delves",
		valeera_delves = "delves",
		ritual_hub = "world",
		void_hub = "world",
		world_boss_week = "raids",
	},
	FILL = { 0.153, 0.129, 0.271, 1 }, -- #272145, one step above the window colour
	EDGE = { 0.227, 0.184, 0.408, 1 }, -- #3A2F68
	HEIGHT = 52,
	-- Narrowest a card may get before the panel drops a column (15 Sep 2026, see _mhMeasureSMC):
	-- room for the 32 px picture and a name like "Horde Creation Catalyst".
	MIN_W = 190,
}

function SMCCard.Stem(point)
	if point.instance then
		return point.raid and "raids" or "dungeons"
	end
	local id = tostring(point.id or "")
	if id:find("^flightmaster_") then
		return "smc_flight"
	end
	return SMCCard.ICONS[id]
end

--- Whether the game has an atlas by this name. SetAtlas on an unknown name fails without an error,
--- so a pcall cannot tell. Without the API we cannot ask, and behave as before.
function SMCCard.AtlasExists(name)
	if not (C_Texture and C_Texture.GetAtlasInfo) then
		return true
	end
	return C_Texture.GetAtlasInfo(name) ~= nil
end

--- Paint one pin as a card (lookOn) or as the 3.x button. Creates nothing, so a switch of the Classic
--- setting repaints the same frames in place. The label colour is left to SMCApplyPinLock and the
--- quest tint, which run right after this in the panel's layout.
function SMCCard.Skin(btn, point, lookOn)
	local icon, label, sub = btn._mhSMCIcon, btn._mhSMCLabel, btn._mhSMCSub
	btn._mhCardMode = lookOn and true or false
	btn._mhOwnPicture = false
	for _, t in ipairs(btn._mhSMCTemplateTex or {}) do
		t:SetAlpha(lookOn and 0 or 1)
	end
	btn._mhCardEdge:SetShown(lookOn)
	btn._mhCardFill:SetShown(lookOn)
	btn._mhCardFill:SetColorTexture(MHUnpack4(SMCCard.FILL))

	local stem = lookOn and SMCCard.Stem(point)
	icon:ClearAllPoints()
	icon:SetVertexColor(1, 1, 1)
	if stem then
		icon:SetTexture(LOOK_ICON_PATH:format(stem))
		icon:SetTexCoord(0, 1, 0, 1)
		icon:SetSize(36, 36)
		icon:SetPoint("LEFT", btn, "LEFT", 8, 0)
	else
		local size = lookOn and 26 or 20
		-- 14 Sep: this used to be `select(1, pcall(...))`, which is pcall's own status and true even
		-- for an atlas the game does not have. Thirteen cards (professions, gathering, the dummies)
		-- showed an empty slot and nothing noticed. Ask the game first; `/mh smcicons` lists them.
		local iconSet = false
		if point.atlas and icon.SetAtlas and SMCCard.AtlasExists(point.atlas) then
			iconSet = pcall(icon.SetAtlas, icon, point.atlas) and true or false
		end
		if not iconSet then
			-- Only Classic gets here with a picture of our own: a card would have taken the branch above.
			-- Where the symbol is missing, Classic shows ours at the 3.x size (Rob, 14 Sep: "ja, doe
			-- Classic ook maar"); where it exists, Classic keeps it. Without either the slot stays empty
			-- rather than showing the bank's bag, because a wrong picture reads as information.
			local own = SMCCard.Stem(point)
			if own then
				icon:SetTexture(LOOK_ICON_PATH:format(own))
				btn._mhOwnPicture = true
			elseif point.atlas then
				icon:SetTexture(nil)
			else
				icon:SetTexture("Interface\\MINIMAP\\TRACKING\\Banker")
			end
			icon:SetTexCoord(0, 1, 0, 1)
		end
		icon:SetSize(size, size)
		-- On a card: centred in the same 36 px slot a picture gets, so every name starts at one x.
		icon:SetPoint("LEFT", btn, "LEFT", lookOn and 13 or 8, 0)
	end

	label:ClearAllPoints()
	sub:ClearAllPoints()
	local subText = sub:GetText()
	local hasSub = lookOn and subText ~= nil and subText ~= ""
	if lookOn then
		label:SetFontObject(GameFontNormal)
		label:SetPoint("LEFT", btn, "LEFT", 52, hasSub and 7 or 0)
		label:SetPoint("RIGHT", btn, "RIGHT", -8, hasSub and 7 or 0)
		label:SetMaxLines(hasSub and 1 or 2)
		sub:SetPoint("LEFT", btn, "LEFT", 52, -9)
		sub:SetPoint("RIGHT", btn, "RIGHT", -8, -9)
	else
		label:SetFontObject(GameFontNormalSmall)
		label:SetPoint("LEFT", icon, "RIGHT", 8, 0)
		label:SetPoint("RIGHT", btn, "RIGHT", -8, 0)
		label:SetMaxLines(0)
	end
	sub:SetShown(hasSub and true or false)
end

--- Called when the Classic setting changes (MHApplyLookChrome). The panel builds once a session, so
--- without this a switch would leave the other look's pins standing until the next login.
function ns.MH_RelayoutSMCPins()
	local sg = ns.panels and ns.panels.smcguide
	if sg and sg._mhSMCRelayout then
		sg._mhSMCRelayout()
	end
end

--- `/mh smcicons` — which Silvermoon pins end up without a picture. An empty slot and a loaded one
--- look the same to the code, so the game is asked per pin. Two looks, two answers: a card shows our
--- own icon when it has one and the Blizzard symbol otherwise; Classic shows the symbol, and our icon
--- only where the symbol is missing.
--- The "found" count is the positive control: if the game knew no symbol at all, that says the
--- question is broken, not the pins.
function ns.PrintSMCIconProbe()
	local own, found, both, classicOnly = 0, 0, {}, {}
	for _, cat in ipairs(SMC_CATEGORIES) do
		for _, point in ipairs(cat.items or {}) do
			local stem = SMCCard.Stem(point)
			local hasAtlas = point.atlas and SMCCard.AtlasExists(point.atlas)
			if stem then
				own = own + 1
			end
			if hasAtlas then
				found = found + 1
			elseif stem then
				classicOnly[#classicOnly + 1] = ("%s (%s)"):format(tostring(point.label), tostring(point.atlas))
			else
				both[#both + 1] = ("%s (%s)"):format(tostring(point.label), tostring(point.atlas))
			end
		end
	end
	print(("|cffc9a8ffMidnight Helper|r Silvermoon icons: %d pins with our own picture, %d Blizzard symbols the game knows."):format(own, found))
	print(("   |cffff5555Empty in both looks: %d|r"):format(#both))
	for _, line in ipairs(both) do
		print("      " .. line)
	end
	print(("   |cffffcc55Classic shows our picture (Blizzard symbol missing): %d|r"):format(#classicOnly))
	for _, line in ipairs(classicOnly) do
		print("      " .. line)
	end
end

-- Called from Guide search: open SMC tab and scroll the city list to a matching pin (no Delves.lua edits).
function ns.JumpSMCCityGuideToPoint(point)
	if type(point) ~= "table" then
		return
	end
	local panel = ns.panels and ns.panels.smcguide
	local scroll = panel and panel._mhSmlScroll
	if not scroll or not scroll.SetVerticalScroll then
		return
	end
	local maxV = 0
	if scroll.GetVerticalScrollRange then
		maxV = scroll:GetVerticalScrollRange() or 0
	end
	local y = tonumber(point._mhNavY)
	if not y or y < 0 then
		y = 0
	end
	local want = math.max(0, math.min(maxV, y - 28))
	scroll:SetVerticalScroll(want)
	if scroll.SetHorizontalScroll then
		scroll:SetHorizontalScroll(0)
	end
	if panel and panel._mhSmlSyncScroll then
		panel._mhSmlSyncScroll()
	end
	if scroll.UpdateScrollChildRect then
		scroll:UpdateScrollChildRect()
	end
	local btn = point._mhWaypointButton
	-- A 4.0 card has no template highlight to lock (its art is faded out), so it lights its own fill.
	if btn and btn._mhCardMode and btn._mhCardFill then
		btn._mhCardFill:SetColorTexture(MHUnpack4(LOOK_PALETTE.active))
		if C_Timer and C_Timer.After then
			C_Timer.After(1.6, function()
				if btn._mhCardMode and not btn:IsMouseOver() then
					btn._mhCardFill:SetColorTexture(MHUnpack4(SMCCard.FILL))
				end
			end)
		end
	elseif btn and btn.LockHighlight then
		btn:LockHighlight()
		if C_Timer and C_Timer.After then
			C_Timer.After(1.6, function()
				if btn and btn.UnlockHighlight then
					btn:UnlockHighlight()
				end
			end)
		end
	end
end

-- Shared label for the SMC "World boss this week" shortcut. Shows the boss
-- name whenever we know it (live API, week-anchored cache, SavedVariables
-- kill data) and falls back to the rotation guess WITH the name + an "open
-- map to confirm" suffix — the Home dashboard already displays the same
-- schedule guess, so the button no longer hides a name we do show elsewhere
-- (Rob, 10 Jun). Only when no boss is known at all does the bare
-- "(open map)" label remain.
local function SMCWorldBossButtonText()
	-- ⚠️ Not `f and f()`: `and` yields one value, so `fromClient` was always nil and
	-- the fallback below ran on every single call — including when the client HAD
	-- just answered. It reached the same boss by another road, which is why nothing
	-- ever looked wrong. Found by lint check [12], 17 aug.
	local boss, fromClient
	if ns.GetActiveWorldBoss then
		boss, fromClient = ns.GetActiveWorldBoss()
	end

	-- If we already know warband completion from SavedVariables, show the boss name even when
	-- Blizzard task/map APIs haven't loaded on this character yet.
	if (not fromClient) and ns.db and ns.db.ui and ns.db.ui.worldBossWeek and ns.db.ui.worldBossWeek.bossId and ns.WORLD_BOSSES then
		local wantId = ns.db.ui.worldBossWeek.bossId
		for i = 1, #ns.WORLD_BOSSES do
			local b = ns.WORLD_BOSSES[i]
			if b and b.id == wantId then
				boss = b
				fromClient = true
				break
			end
		end
	end

	local name = boss and boss.labelKey and ns.L and ns:L(boss.labelKey) or "?"
	local confirmed = fromClient or (ns.IsWorldBossKilled and boss and ns.IsWorldBossKilled(boss))
	if confirmed and name ~= "?" then
		return ns:L("WB_SMC_BUTTON_FMT"):format(name)
	end
	if boss and name ~= "?" then
		return ns:L("WB_SMC_BUTTON_UNCONFIRMED_FMT"):format(name)
	end
	return ns:L("WB_SMC_BUTTON_GUESS")
end

-- Update the special \"World boss this week\" SMC shortcut label.
function ns.MH_RefreshSMCWorldBossShortcut()
	local sg = ns.panels and ns.panels.smcguide
	local list = sg and sg._mhSMCWaypointButtons
	if type(list) ~= "table" then
		return
	end

	local text = SMCWorldBossButtonText()

	for i = 1, #list do
		local row = list[i]
		local btn = row and row[1]
		local pt = row and row[2]
		local label = btn and btn._mhSMCLabel
		if pt and pt.action == "worldboss_week" and label and label.SetText then
			label:SetText(text)
		end
	end
end

--- Is this pin's requirement still unmet, RIGHT NOW?
---
--- 🔴 Never cached. The old code stored the verdict on the point at build time and the panel
--- builds once a session, so a "no" read before the quest data loaded stood until logout —
--- which is what put "you cannot use this yet" on a portal Rob was walking through.
---
--- ⚠️ `nil` and `false` mean different things here. No requirement, no API, or a call that
--- errored all mean "we cannot say it is locked", and the pin must then look normal: telling
--- someone they cannot do a thing is the expensive mistake, and staying quiet is the cheap
--- one. Only a definite "not completed" locks it.
local function SMCPinLocked(point)
	if not (point and point.requiresQuest) then
		return false
	end
	if not (C_QuestLog and C_QuestLog.IsQuestFlaggedCompleted) then
		return false
	end
	local ok, done = pcall(C_QuestLog.IsQuestFlaggedCompleted, point.requiresQuest)
	if not ok then
		return false
	end
	return done ~= true
end

--- Paint one pin according to that answer. Split out so the styling and the tooltip cannot
--- drift apart, and so a refresh can re-apply it without rebuilding the panel.
local function SMCApplyPinLock(point, label, icon)
	local locked = SMCPinLocked(point)
	if label and label.SetTextColor then
		if locked then
			label:SetTextColor(0.55, 0.55, 0.58)
		else
			label:SetTextColor(1, 0.94, 0.75)
		end
	end
	if icon and icon.SetDesaturated then
		icon:SetDesaturated(locked and true or false)
	end
end

--- Re-apply the greying on every pin, so a panel built before the quest data arrived does
--- not keep showing a stale lock. Cheap: a handful of buttons and one API call each.
function ns.MH_RefreshSMCPinLocks()
	local sg = ns.panels and ns.panels.smcguide
	local list = sg and sg._mhSMCWaypointButtons
	if type(list) ~= "table" then
		return
	end
	for i = 1, #list do
		local row = list[i]
		local btn, pt = row and row[1], row and row[2]
		if btn and pt then
			SMCApplyPinLock(pt, btn._mhSMCLabel, btn._mhSMCIcon)
		end
	end
end

local function BuildSMCCityGuidePanel(panel)
	if not panel or panel._mhSmlBuilt then
		return
	end
	panel._mhSmlBuilt = true
	panel._mhSmlScroll = nil
	panel._mhSmlSyncScroll = nil

	if panel._header then
		panel._header:SetText(ns:L("SMC_GUIDE_TITLE"))
	end
	if panel._body then
		panel._body:Hide()
	end

	local subtitle = panel:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
	subtitle:SetPoint("TOPLEFT", panel, "TOPLEFT", 12, -34)
	subtitle:SetText(ns:L("SMC_GUIDE_SUBTITLE"))
	subtitle:SetTextColor(0.75, 0.78, 0.82)
	panel._mhSMCSubtitle = subtitle

	-- Host + guide-style chrome + Custom ScrollBar (mirrors `Addons/Guide.lua`):
	-- Never anchor the rail to the subtitle (too narrow) — that parks the bar mid-panel.
	local SMC_SCROLL_INSET = 2
	local SMC_SCROLL_BAR_GUTTER = 22
	local scrollHost = CreateFrame("Frame", "MidnightHelperSMCScrollHost", panel)
	scrollHost:SetPoint("TOPLEFT", subtitle, "BOTTOMLEFT", 0, -10)
	scrollHost:SetPoint("BOTTOMRIGHT", panel, "BOTTOMRIGHT", -12, 12)
	scrollHost:SetFrameLevel((panel:GetFrameLevel() or 0) + 8)

	-- Subtle "guide body" border around the whole viewport
	local smcRim = CreateFrame("Frame", nil, scrollHost, "BackdropTemplate")
	smcRim:SetAllPoints(scrollHost)
	smcRim:SetFrameStrata(scrollHost:GetFrameStrata())
	smcRim:SetFrameLevel(scrollHost:GetFrameLevel() + 1)
	if smcRim.SetBackdrop then
		smcRim:SetBackdrop({
			bgFile = "Interface\\Buttons\\WHITE8X8",
			edgeFile = "Interface\\Buttons\\WHITE8X8",
			tile = true,
			tileSize = 8,
			edgeSize = 1,
			insets = { left = 0, right = 0, top = 0, bottom = 0 },
		})
		smcRim:SetBackdropColor(0, 0, 0, 0)
		-- Tier-2: geen border-box meer rond de SMC-scroll (geen ander paneel heeft
		-- die → liet de SMC-gids "als een andere addon" ogen). Onzichtbaar gemaakt.
		smcRim:SetBackdropBorderColor(0, 0, 0, 0)
	end
	smcRim:EnableMouse(false)

	local scroll = CreateFrame("ScrollFrame", "MidnightHelperSMCGuideScroll", scrollHost)
	panel._mhSmlScroll = scroll
	scroll:SetPoint("TOPLEFT", scrollHost, "TOPLEFT", SMC_SCROLL_INSET, -SMC_SCROLL_INSET)
	scroll:SetPoint("BOTTOMRIGHT", scrollHost, "BOTTOMRIGHT", -SMC_SCROLL_INSET - SMC_SCROLL_BAR_GUTTER, SMC_SCROLL_INSET)
	scroll:SetFrameLevel(scrollHost:GetFrameLevel() + 2)
	scroll:EnableMouse(true)
	scroll:EnableMouseWheel(true)
	local smcScrollFill = scroll:CreateTexture(nil, "BACKGROUND", nil, -8)
	smcScrollFill:SetAllPoints()
	smcScrollFill:SetColorTexture(0.048, 0.05, 0.062, 1) -- = MH_CHROME.contentWell, gelijk aan de andere panelen

	local smcBar = CreateFrame("Slider", "MidnightHelperSMCScrollBar", scrollHost)
	smcBar:SetPoint("TOPLEFT", scroll, "TOPRIGHT", 2, 0)
	smcBar:SetPoint("BOTTOMLEFT", scroll, "BOTTOMRIGHT", 2, 0)
	smcBar:SetWidth(16)
	smcBar:SetOrientation("VERTICAL")
	smcBar:SetFrameLevel(scrollHost:GetFrameLevel() + 4)
	local smcBarBg = smcBar:CreateTexture(nil, "BACKGROUND")
	smcBarBg:SetAllPoints()
	smcBarBg:SetColorTexture(0.07, 0.07, 0.09, 0.88)
	local smcThumb = smcBar:CreateTexture(nil, "OVERLAY")
	smcThumb:SetSize(16, 28)
	smcThumb:SetColorTexture(0.72, 0.74, 0.78, 0.96)
	smcBar:SetThumbTexture(smcThumb)
	smcBar:SetValueStep(1)
	smcBar:SetObeyStepOnDrag(false)
	smcBar:SetScript("OnEnter", function()
		smcThumb:SetColorTexture(0.86, 0.88, 0.92, 1.0)
	end)
	smcBar:SetScript("OnLeave", function()
		smcThumb:SetColorTexture(0.72, 0.74, 0.78, 0.96)
	end)

	local smcScrollUp = CreateFrame("Button", nil, scrollHost)
	smcScrollUp:SetSize(20, 20)
	smcScrollUp:SetPoint("BOTTOM", smcBar, "TOP", 0, 4)
	smcScrollUp:SetFrameLevel(smcBar:GetFrameLevel() + 1)
	smcScrollUp:SetNormalTexture("Interface\\Buttons\\UI-ScrollBar-ScrollUpButton-Up")
	smcScrollUp:SetPushedTexture("Interface\\Buttons\\UI-ScrollBar-ScrollUpButton-Down")
	smcScrollUp:SetHighlightTexture("Interface\\Buttons\\UI-ScrollBar-ScrollUpButton-Highlight")

	local smcScrollDown = CreateFrame("Button", nil, scrollHost)
	smcScrollDown:SetSize(20, 20)
	smcScrollDown:SetPoint("TOP", smcBar, "BOTTOM", 0, -4)
	smcScrollDown:SetFrameLevel(smcBar:GetFrameLevel() + 1)
	smcScrollDown:SetNormalTexture("Interface\\Buttons\\UI-ScrollBar-ScrollDownButton-Up")
	smcScrollDown:SetPushedTexture("Interface\\Buttons\\UI-ScrollBar-ScrollDownButton-Down")
	smcScrollDown:SetHighlightTexture("Interface\\Buttons\\UI-ScrollBar-ScrollDownButton-Highlight")

	local scrollContent = CreateFrame("Frame", nil, scroll)
	scrollContent:SetSize(1, 1)
	scroll:SetScrollChild(scrollContent)

	local smcBarSyncing = false
	local function SyncSMCScrollBar()
		if not smcBar or not scroll or smcBarSyncing then
			return
		end
		if not smcBar.SetMinMaxValues or not smcBar.SetValue or not smcBar.Enable or not smcBar.Disable then
			return
		end
		smcBarSyncing = true
		local maxScroll = 0
		if scroll.GetVerticalScrollRange then
			maxScroll = scroll:GetVerticalScrollRange() or 0
		end
		if maxScroll < 0 then
			maxScroll = 0
		end
		smcBar:SetMinMaxValues(0, maxScroll)
		local cur = 0
		if scroll.GetVerticalScroll then
			cur = scroll:GetVerticalScroll() or 0
		end
		smcBar:SetValue(cur)
		if maxScroll <= 0.5 then
			smcBar:Disable()
			smcBar:SetAlpha(0.45)
			if smcScrollUp then
				smcScrollUp:Disable()
				smcScrollUp:SetAlpha(0.45)
			end
			if smcScrollDown then
				smcScrollDown:Disable()
				smcScrollDown:SetAlpha(0.45)
			end
		else
			smcBar:Enable()
			smcBar:SetAlpha(1)
			if smcScrollUp and smcScrollUp.Enable then
				smcScrollUp:Enable()
				smcScrollUp:SetAlpha(1)
			end
			if smcScrollDown and smcScrollDown.Enable then
				smcScrollDown:Enable()
				smcScrollDown:SetAlpha(1)
			end
		end
		smcBarSyncing = false
	end

	smcBar:SetScript("OnValueChanged", function(_, value)
		-- `SetValue` in SyncSMCScrollBar is programmatic; do not re-set scroll in that case.
		if smcBarSyncing or not scroll or not scroll.SetVerticalScroll then
			return
		end
		scroll:SetVerticalScroll(tonumber(value) or 0)
	end)
	scroll:SetScript("OnVerticalScroll", function()
		SyncSMCScrollBar()
	end)
	local scrollStep = (_G.WORLDWIDE_SCROLL_STEP and math.floor(_G.WORLDWIDE_SCROLL_STEP * 0.75)) or 30
	scroll:SetScript("OnMouseWheel", function(self, delta)
		if not self.GetVerticalScrollRange or not self.SetVerticalScroll or not self.GetVerticalScroll then
			return
		end
		local maxScroll = self:GetVerticalScrollRange() or 0
		if maxScroll <= 0 then
			return
		end
		local nextScroll = (self:GetVerticalScroll() or 0) - (delta * scrollStep)
		if nextScroll < 0 then
			nextScroll = 0
		elseif nextScroll > maxScroll then
			nextScroll = maxScroll
		end
		self:SetVerticalScroll(nextScroll)
		SyncSMCScrollBar()
	end)

	if smcScrollUp then
		smcScrollUp:SetScript("OnClick", function()
			if not scroll or not scroll.SetVerticalScroll or not scroll.GetVerticalScroll or not scroll.GetVerticalScrollRange then
				return
			end
			local maxV = scroll:GetVerticalScrollRange() or 0
			local v = (scroll:GetVerticalScroll() or 0) - scrollStep
			if v < 0 then
				v = 0
			elseif v > maxV then
				v = maxV
			end
			scroll:SetVerticalScroll(v)
			SyncSMCScrollBar()
		end)
	end
	if smcScrollDown then
		smcScrollDown:SetScript("OnClick", function()
			if not scroll or not scroll.SetVerticalScroll or not scroll.GetVerticalScroll or not scroll.GetVerticalScrollRange then
				return
			end
			local maxV = scroll:GetVerticalScrollRange() or 0
			local v = (scroll:GetVerticalScroll() or 0) + scrollStep
			if v < 0 then
				v = 0
			elseif v > maxV then
				v = maxV
			end
			scroll:SetVerticalScroll(v)
			SyncSMCScrollBar()
		end)
	end

	local BTN_H = 34
	local GAP_X, GAP_Y = 8, 6
	-- Match the ScrollFrame's inner width (inset L/R + right scrollbar gutter) using panel width.
	-- (scroll:GetWidth is often 0 the same frame it is created)
	local availableW = math.max(
		120,
		math.floor(
			(panel:GetWidth() or 640)
				- 24
				- 2 * SMC_SCROLL_INSET
				- SMC_SCROLL_BAR_GUTTER
		)
	)
	local cols = 3
	local btnW = math.max(100, math.floor((availableW - (cols - 1) * GAP_X) / cols))
	--- Rob, 15 Sep 2026 (screenshot): with the window made smaller, the third column fell off the right
	--- edge - Enchanting, Jewelcrafting and more were simply gone - because these three numbers were
	--- measured once, when the panel was built. LayoutPins now measures the panel every time. The 4.0
	--- cards drop to two columns, or one, when three would be too narrow to read; Classic keeps its
	--- three 3.x columns and only narrows them. A field, not a local: this function is near Lua's limit.
	panel._mhMeasureSMC = function()
		local w = panel:GetWidth()
		if w and w > 0 then
			availableW = math.max(120, math.floor(w - 24 - 2 * SMC_SCROLL_INSET - SMC_SCROLL_BAR_GUTTER))
		end
		cols = 3
		local minW = MHLookOn() and SMCCard.MIN_W or 0
		while cols > 1 and (availableW - (cols - 1) * GAP_X) / cols < minW do
			cols = cols - 1
		end
		btnW = math.max(100, math.floor((availableW - (cols - 1) * GAP_X) / cols))
	end

	panel._mhSMCWaypointButtons = {}
	panel._mhSMCChecklistRows = {}

	-- top-down Y so we can set a real content height for scrolling
	local y = 0

	--- 🔴 SAY IT WHERE HE CLICKED, NOT IN CHAT. Rob, 3 Sep 2026, on the level-69 Paladin,
	--- after the click correctly stopped setting a route: *"dat ziet er goed uit, maar
	--- niemand kijkt in de chat"*. He is right, and it sharpens a rule this file already
	--- had rather than reversing it. Chat beat the route-arrow LABEL because the label is
	--- hidden for everyone running TomTom — that still holds. But an answer to "why did
	--- nothing happen when I pressed this" has to be visible at the thing you pressed,
	--- ideally BEFORE you press it. Chat is a record; it is not an answer in place.
	---
	--- 📌 The pins stay live and clickable. This is a banner over a map, not a locked door
	--- — the same line the whole day settled on: presence is reference, routing is advice.
	if ns.MidnightFloorMet and not ns.MidnightFloorMet() then
		local locked = scrollContent:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
		locked:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", 0, -y)
		locked:SetWidth(availableW)
		locked:SetJustifyH("LEFT")
		locked:SetWordWrap(true)
		locked:SetText((ns:L("SMC_LOCKED_BANNER_FMT")):format(ns.MidnightFloorLevel or 80))
		-- Red for "not yet", not grey. Grey is what the other installed guides reserve for
		-- content you are PAST (measured in Zygor and the HandyNotes handler family, 3 Sep);
		-- using it for both makes the two states indistinguishable.
		locked:SetTextColor(1, 0.45, 0.4)
		y = y + math.max(18, math.ceil(locked:GetStringHeight() or 18)) + 10
		panel._mhSMCLockedBanner = locked
	end

	-- Dynamic checklist (quest IDs from Modules/SMCChecklistData.lua — verify after patches)
	do
		local defs = ns.SMC_CHECKLIST_DEF
		local anyTracked = false
		if type(defs) == "table" and ns.SMC_IsChecklistEntryTracked then
			for di = 1, #defs do
				local entry = defs[di]
				if entry and ns.SMC_IsChecklistEntryTracked(entry) then
					anyTracked = true
					break
				end
			end
		end
		if anyTracked then
			local clHeader = scrollContent:CreateFontString(nil, "OVERLAY", "GameFontHighlightMedium")
			clHeader:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", 0, -y)
			clHeader:SetText(ns:L("SMC_CHECKLIST_TITLE"))
			clHeader:SetTextColor(MH_CHROME.tabTexActive[1], MH_CHROME.tabTexActive[2], MH_CHROME.tabTexActive[3])
			y = y + 22
			local clHint = scrollContent:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
			clHint:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", 0, -y)
			clHint:SetWidth(availableW)
			clHint:SetJustifyH("LEFT")
			clHint:SetText(ns:L("SMC_CHECKLIST_HINT"))
			clHint:SetTextColor(0.72, 0.74, 0.78)
			y = y + 38
			local rowsLocale = {}
			for _, entry in ipairs(defs) do
				if ns.SMC_IsChecklistEntryTracked(entry) then
					local titleFs = scrollContent:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
					titleFs:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", 0, -y)
					titleFs:SetWidth(math.floor(availableW * 0.62))
					titleFs:SetJustifyH("LEFT")
					titleFs:SetText(ns:L(entry.labelKey))
					local statusFs = scrollContent:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
					statusFs:SetPoint("TOPRIGHT", scrollContent, "TOPRIGHT", 0, -y)
					statusFs:SetWidth(math.floor(availableW * 0.34))
					statusFs:SetJustifyH("RIGHT")
					local crow = { entry = entry, statusFs = statusFs, titleFs = titleFs }
					panel._mhSMCChecklistRows[#panel._mhSMCChecklistRows + 1] = crow
					rowsLocale[#rowsLocale + 1] = crow
					y = y + 18
				end
			end
			y = y + 10
			panel._mhChecklistLocaleRefs = {
				header = clHeader,
				hint = clHint,
				rows = rowsLocale,
			}
		end
	end

	AddSMCInstanceCategory()
	-- 14 Sep 2026 (4.0 cards): make every header and pin first, then place them. Placing is its own
	-- function below because the Classic setting can change while this panel exists (it is built once
	-- a session), and a card is taller than a 3.x button, so every y under the checklist moves.
	local pinsTopY = y
	local blocks = {}
	for _, cat in ipairs(SMC_CATEGORIES) do
		local header = scrollContent:CreateFontString(nil, "OVERLAY", "GameFontHighlightMedium")
		header:SetText(CategoryTitle(cat))

		local separator = scrollContent:CreateTexture(nil, "ARTWORK")
		separator:SetHeight(1)

		local pins = {}
		for _, point in ipairs(cat.items or {}) do
			local btn = CreateFrame("Button", nil, scrollContent, "UIPanelButtonTemplate")
			btn:SetText("")
			-- The template's own textures, collected before anything of ours is added: a card fades
			-- them out and Classic shows them, the same trick MHLookButtonParts uses for chips.
			local templateTex = {}
			for _, region in ipairs({ btn:GetRegions() }) do
				if region.IsObjectType and region:IsObjectType("Texture") then
					templateTex[#templateTex + 1] = region
				end
			end
			btn._mhSMCTemplateTex = templateTex
			local edge = btn:CreateTexture(nil, "BACKGROUND", nil, -8)
			edge:SetAllPoints()
			edge:SetColorTexture(MHUnpack4(SMCCard.EDGE))
			local fill = btn:CreateTexture(nil, "BACKGROUND", nil, -7)
			fill:SetPoint("TOPLEFT", btn, "TOPLEFT", 1, -1)
			fill:SetPoint("BOTTOMRIGHT", btn, "BOTTOMRIGHT", -1, 1)
			btn._mhCardEdge, btn._mhCardFill = edge, fill

			local icon = btn:CreateTexture(nil, "ARTWORK")

			local label = btn:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
			label:SetJustifyH("LEFT")
			if point.action == "worldboss_week" and ns.GetActiveWorldBoss then
				label:SetText(SMCWorldBossButtonText())
			else
				label:SetText(point.label)
			end

			-- The second line a card has room for: the zone an entrance lies in, since it is not in
			-- Silvermoon. Shown on cards only; SMCCard.Skin decides.
			local sub = btn:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
			sub:SetJustifyH("LEFT")
			sub:SetWordWrap(false)
			sub:SetTextColor(LOOK_PALETTE.muted[1], LOOK_PALETTE.muted[2], LOOK_PALETTE.muted[3])
			if point.instance and C_Map and C_Map.GetMapInfo then
				local info = C_Map.GetMapInfo(point.mapID)
				sub:SetText(info and info.name or "")
			end

			--- ⚠️ A PIN FOR SOMETHING YOU CANNOT USE YET MUST SAY SO ON ITS FACE.
			---
			--- Rob, 19 aug, reading the released notes: the portal pin "werkt alleen als je
			--- de pre-prey seizoen 2 quest hebt gedaan !!". The description said so and the
			--- label did not, so the first thing a player without the quest meets is a
			--- normal-looking button that walks them to an empty wall.
			---
			--- `Delves.lua` already settled the principle for the portal data itself: the
			--- cheap failure is a portal we forget to offer, not one we invent. The pin was
			--- the one place still offering it unconditionally.
			---
			--- Greyed rather than hidden — hiding it means nobody ever learns the portal
			--- exists, and finding out it is worth working towards is the point.
			--- 🔴 ASK EVERY TIME, DO NOT STORE THE ANSWER. Rob, 29 aug: the portal pin said
			--- "you cannot use this yet" while he walked straight through it. The verdict was
			--- computed here, once, and kept on `point._mhLocked` — and this panel is built
			--- exactly once per session (`_mhSmlBuilt` at the top). Right after a `/reload`
			--- the quest data is not loaded yet, `IsQuestFlaggedCompleted` answers false, and
			--- that "no" then stood for the rest of the session.
			---
			--- ⚠️ THE API WAS NEVER THE PROBLEM, and I nearly replaced it. `/mh questgate`
			--- settled it on his client: per-character AND account-wide both return true, quest
			--- 96004 is the right id. A wrong-looking answer from a right function, cached at
			--- the wrong moment. Measuring first is what stopped a pointless API swap.
			--- (Since 14 Sep that call, SMCApplyPinLock, runs in LayoutPins below, after the skin and
			--- every time the pins are placed, followed by the quest tint in the same order as before.)

			btn._mhSMCIcon = icon
			btn._mhSMCLabel = label
			btn._mhSMCSub = sub
			panel._mhSMCWaypointButtons[#panel._mhSMCWaypointButtons + 1] = { btn, point }
			point._mhWaypointButton = btn

			btn:SetScript("OnClick", function()
				SetSMCWaypoint(point)
			end)
			btn:SetScript("OnEnter", function(self)
				if self._mhCardMode then
					self._mhCardFill:SetColorTexture(MHUnpack4(LOOK_PALETTE.active))
				end
				GameTooltip:SetOwner(self, "ANCHOR_CURSOR")
				GameTooltip:SetText(point.label, 1, 0.9, 0.6)
				GameTooltip:AddLine(PinDescription(point), 0.9, 0.9, 0.9, true)
				-- Asked at hover time, not read from a flag set when the panel was built.
				if SMCPinLocked(point) then
					GameTooltip:AddLine(ns:L("SMC_PIN_LOCKED"), 1, 0.5, 0.4, true)
				end
				if point.instance then
					-- Not in Silvermoon: name the zone the entrance is in, and what a click does.
					local info = C_Map and C_Map.GetMapInfo and C_Map.GetMapInfo(point.mapID)
					local zone = (info and info.name) or ("Map " .. tostring(point.mapID))
					GameTooltip:AddLine(("%s • %.2f, %.2f"):format(zone, point.x, point.y), 0.8, 0.8, 0.8, false)
					GameTooltip:AddLine(ns:L("HOME_WB_ROUTE_BTN_FMT"):format(point.label), 0.7, 0.8, 1, true)
				else
					GameTooltip:AddLine(("Map 2393 • %.2f, %.2f"):format(point.x, point.y), 0.8, 0.8, 0.8, false)
					GameTooltip:AddLine(ns:L("SMC_PIN_CLICK_HINT"), 0.7, 0.8, 1, true)
				end
				GameTooltip:Show()
			end)
			btn:SetScript("OnLeave", function(self)
				if self._mhCardMode then
					self._mhCardFill:SetColorTexture(MHUnpack4(SMCCard.FILL))
				end
				GameTooltip:Hide()
			end)
			pins[#pins + 1] = { btn = btn, point = point }
		end
		blocks[#blocks + 1] = { header = header, separator = separator, pins = pins }
	end

	--- Place every header and pin for the look that is on right now. Classic reproduces the 3.x
	--- geometry exactly (BTN_H 34); the 4.0 cards are SMCCard.HEIGHT. `_mhNavY` is rewritten each
	--- time because the search jump scrolls to it.
	local function LayoutPins()
		panel._mhMeasureSMC()
		if panel._mhSMCLockedBanner then
			panel._mhSMCLockedBanner:SetWidth(availableW)
		end
		local lookOn = MHLookOn()
		local btnH = lookOn and SMCCard.HEIGHT or BTN_H
		local hc = lookOn and LOOK_PALETTE.header or MH_CHROME.tabTexActive
		local sc = lookOn and SMCCard.EDGE or MH_CHROME.separator
		-- The near-black well suits the 3.x buttons; cards sit on the window colour itself.
		smcScrollFill:SetShown(not lookOn)
		local yy = pinsTopY
		for _, block in ipairs(blocks) do
			block.header:ClearAllPoints()
			block.header:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", 0, -yy)
			block.header:SetTextColor(hc[1], hc[2], hc[3])
			yy = yy + 20
			block.separator:ClearAllPoints()
			block.separator:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", 0, -yy)
			block.separator:SetPoint("TOPRIGHT", scrollContent, "TOPRIGHT", 0, -yy)
			block.separator:SetColorTexture(sc[1], sc[2], sc[3], sc[4])
			yy = yy + 8
			for i, pin in ipairs(block.pins) do
				local col = (i - 1) % cols
				local row = math.floor((i - 1) / cols)
				pin.btn:SetSize(btnW, btnH)
				pin.btn:ClearAllPoints()
				pin.btn:SetPoint("TOPLEFT", scrollContent, "TOPLEFT", col * (btnW + GAP_X), -yy - row * (btnH + GAP_Y))
				SMCCard.Skin(pin.btn, pin.point, lookOn)
				SMCApplyPinLock(pin.point, pin.btn._mhSMCLabel, pin.btn._mhSMCIcon)
				if ns.SMC_ApplyQuestTintToWaypointButton then
					ns.SMC_ApplyQuestTintToWaypointButton(pin.btn, pin.point)
				end
				pin.point._mhNavY = yy + row * (btnH + GAP_Y)
			end
			yy = yy + math.ceil(#block.pins / cols) * (btnH + GAP_Y) + 10
		end
		scrollContent:SetWidth(availableW)
		scrollContent:SetHeight(math.max(1, yy + 8))
		if scroll.UpdateScrollChildRect then
			scroll:UpdateScrollChildRect()
		end
		SyncSMCScrollBar()
	end
	panel._mhSMCRelayout = LayoutPins
	-- Re-measure when the window is resized or the tab is shown again, one relayout per frame at most.
	panel._mhSMCScheduleRelayout = function()
		if panel._mhSMCRelayoutPending or not (C_Timer and C_Timer.After) then
			return
		end
		panel._mhSMCRelayoutPending = true
		C_Timer.After(0, function()
			panel._mhSMCRelayoutPending = false
			if panel:IsVisible() then
				LayoutPins()
			end
		end)
	end
	panel:HookScript("OnSizeChanged", panel._mhSMCScheduleRelayout)
	panel:HookScript("OnShow", panel._mhSMCScheduleRelayout)
	LayoutPins()
	if scroll.SetHorizontalScroll then
		scroll:SetHorizontalScroll(0)
	end
	scroll:SetVerticalScroll(0)
	SyncSMCScrollBar()
	panel._mhSmlSyncScroll = SyncSMCScrollBar
	if ns.SMC_RefreshDynamicChecklist then
		ns.SMC_RefreshDynamicChecklist()
	end
	if ns.MH_RefreshWorldBossSMCBlock then
		ns.MH_RefreshWorldBossSMCBlock()
	end
	if ns.MH_RefreshSMCWorldBossShortcut then
		ns.MH_RefreshSMCWorldBossShortcut()
	end
	-- The panel builds once a session; this is what lets a lock read before the quest data
	-- arrived correct itself instead of standing until logout.
	if ns.MH_RefreshSMCPinLocks then
		ns.MH_RefreshSMCPinLocks()
	end
end

--------------------------------------------------------------------------------
-- Tab configuration: order = display order in the sidebar
--------------------------------------------------------------------------------
local TAB_DEFS = {
	{ id = "starthere", labelKey = "TAB_START_HERE" },
	{ id = "dungeons", labelKey = "TAB_DUNGEONS" },
	{ id = "codex", labelKey = "TAB_CODEX" },
	{ id = "home", labelKey = "TAB_HOME" },
	{ id = "delves", labelKey = "TAB_DELVES" },
	{ id = "account", labelKey = "TAB_ACCOUNT_SNAPSHOT" },
	{ id = "rares", labelKey = "TAB_RARES" },
	{ id = "achievements", labelKey = "TAB_ACHIEVEMENTS" },
	{ id = "mounts", labelKey = "TAB_MOUNTS" },
	{ id = "tradingpost", labelKey = "TAB_TRADINGPOST" },
	{ id = "raids", labelKey = "TAB_RAIDS" },
	{ id = "world", labelKey = "TAB_WORLD" },
	{ id = "events", labelKey = "TAB_EVENTS" },
	{ id = "delvelog", labelKey = "TAB_DELVE_LOG" },
	{ id = "enchants", labelKey = "TAB_ENCHANTS" },
	{ id = "tier", labelKey = "TAB_TIER" },
	{ id = "omnium", labelKey = "TAB_OMNIUM" },
	-- reference is no longer top-level: it lives in the Codex as a category;
	-- SelectTab("reference") still works via the alias below.
	{ id = "smcguide", labelKey = "TAB_SMC" },
	{ id = "currency", labelKey = "TAB_CURRENCY" },
	-- professions is no longer top-level: it lives in the Toolbox as a sub-tab;
	-- SelectTab("professions") still works via the alias below.
	{ id = "guide", labelKey = "TAB_GUIDE" },
	-- Toolbox bundles the former macros/consumables/academy top-level tabs as
	-- sub-tabs; legacy tab ids still route there via the alias in SelectTab.
	{ id = "toolslaunch", labelKey = "TAB_TOOLSLAUNCH" },
	{ id = "toolbox", labelKey = "TAB_TOOLBOX" },
	{ id = "addons", labelKey = "TAB_ADDONS" },
	{ id = "settings", labelKey = "TAB_SETTINGS" },
}

local TAB_LABEL_BY_ID = {}
for _, tab in ipairs(TAB_DEFS) do
	TAB_LABEL_BY_ID[tab.id] = tab.labelKey
end
-- Not a sidebar tab, but the title bar and the help drawer name it: "Settings > Screens".
TAB_LABEL_BY_ID.screens = "SETTINGS_SCREENS_TITLE"
TAB_LABEL_BY_ID.allsettings = "SET_ALL_TITLE"

-- Shared, read-only, with Modules/RoomLauncher.lua (4.0 room card grid), so the grid lists
-- exactly what the sidebar lists and uses the same icons and taglines as the screen header.
ns._mhSidebarSections = SIDEBAR_SECTIONS
ns._mhSidebarRoomById = SIDEBAR_ROOM_BY_ID
ns._mhTabLabelById = TAB_LABEL_BY_ID
ns._mhSidebarTabVisible = SidebarTabVisible
ns._mhSidebarTabAvailable = SidebarTabAvailable
ns._mhLookScreens = LOOK_SCREENS
ns._mhLookIconPath = LOOK_ICON_PATH

--- Every screen a player can hide, room by room in sidebar order, for Settings -> Screens.
--- The Toolbox expands into its sub-tabs; This Week and Settings are never listed.
function ns.GetHideableScreens()
	local list = {}
	for _, section in ipairs(SIDEBAR_SECTIONS) do
		for _, id in ipairs(section.ids) do
			if id == "toolbox" then
				for _, s in ipairs(TOOLBOX_SCREENS) do
					list[#list + 1] = { id = s.id, room = section.room, labelKey = s.labelKey }
				end
			elseif TAB_LABEL_BY_ID[id] and ns.IsScreenHideable and ns.IsScreenHideable(id) then
				list[#list + 1] = { id = id, room = section.room, labelKey = TAB_LABEL_BY_ID[id] }
			end
		end
	end
	return list
end

--------------------------------------------------------------------------------
-- Internal Addons sub-tab registry (modules call ns.RegisterAddonSubTab at load)
--------------------------------------------------------------------------------
ns._mhAddonSubTabById = ns._mhAddonSubTabById or {}
ns._mhAddonSubTabOrder = ns._mhAddonSubTabOrder or {}

function ns.RegisterAddonSubTab(def)
	if type(def) ~= "table" or type(def.id) ~= "string" or type(def.label) ~= "string" then
		return
	end
	if type(def.Build) ~= "function" then
		return
	end
	if ns._mhAddonSubTabById[def.id] then
		return
	end
	ns._mhAddonSubTabById[def.id] = def
	tinsert(ns._mhAddonSubTabOrder, def.id)
end

--------------------------------------------------------------------------------
-- Forward declarations (filled in after main UI exists)
--------------------------------------------------------------------------------
local SelectTab
local SelectAddonSubTab
local RelayoutSidebarTabs

--------------------------------------------------------------------------------
-- Main shell: MidnightHelperMainUI
--------------------------------------------------------------------------------
function ns:EnsureMainUI()
	if self.mainUI then
		return self.mainUI
	end

	local main = CreateFrame("Frame", "MidnightHelperMainUI", UIParent, "BackdropTemplate")
	UpdateMaxWindowBounds()
	local initW = GetSavedMainWidth()
	local initH = ResolveMainHeightForOpen()
	main:SetSize(initW, initH)
	main:SetPoint("CENTER")
	-- HIGH strata so the window sits above action bars / keybind buttons (they render
	-- at MEDIUM and were bleeding through the bottom of the window). Below DIALOG so it
	-- doesn't cover real popups/tooltips.
	main:SetFrameStrata("HIGH")
	main:SetToplevel(true) -- clicking the window raises it above other HIGH frames
	main:SetFrameLevel(100)
	main:SetMovable(true)
	main:SetResizable(true)
	main:SetResizeBounds(MIN_WIDTH, MIN_HEIGHT, MAX_WIDTH, MAX_HEIGHT)
	main:SetClampedToScreen(true)
	main:EnableMouse(true)
	main:Hide()

	-- Main window closes with Escape like most addon windows.
	tinsert(UISpecialFrames, main:GetName())

	if main.SetBackdrop then
		main:SetBackdrop({
			bgFile = MH_TEX.dialogBg,
			edgeFile = MH_TEX.goldEdge,
			tile = true,
			tileSize = 32,
			edgeSize = 32,
			insets = { left = 11, right = 12, top = 12, bottom = 11 },
		})
		main:SetBackdropColor(1, 1, 1, 0.94)
		main:SetBackdropBorderColor(1, 1, 1, 1)
	end

	-- Title strip (drag handle); moving is started from here so tabs stay easy to click.
	local titleBar = CreateFrame("Frame", nil, main)
	titleBar:SetHeight(TITLE_BAR_HEIGHT)
	titleBar:SetPoint("TOPLEFT", main, "TOPLEFT", MH_MAIN_EDGE.L, -MH_MAIN_EDGE.T)
	titleBar:SetPoint("TOPRIGHT", main, "TOPRIGHT", -MH_MAIN_EDGE.R, -MH_MAIN_EDGE.T)
	titleBar:EnableMouse(true)
	titleBar:RegisterForDrag("LeftButton")
	titleBar:SetScript("OnDragStart", function()
		main:StartMoving()
	end)
	-- OnDragStop is set later (with the grip handler) so it also persists window
	-- size + position; the earlier duplicate here was dead code (F3.8).

	local titleHighlight = titleBar:CreateTexture(nil, "BACKGROUND")
	titleHighlight:SetAllPoints()
	titleHighlight:SetTexture(MH_TEX.dialogBgDark)
	if titleHighlight.SetHorizTile then
		titleHighlight:SetHorizTile(true)
	end
	if titleHighlight.SetVertTile then
		titleHighlight:SetVertTile(true)
	end
	titleHighlight:SetVertexColor(0.55, 0.45, 0.35, 0.9)

	local titleIcon = titleBar:CreateTexture(nil, "ARTWORK")
	titleIcon:SetSize(24, 24)
	titleIcon:SetTexture("Interface\\AddOns\\MidnightHelper\\Media\\Addon_Icon")
	titleIcon:SetPoint("TOPLEFT", titleBar, "TOPLEFT", 12, -(TITLE_BAR_HEIGHT - 24) / 2)

	-- Title on titleBar, OVERLAY: above bar tint (BACKGROUND) and icon (ARTWORK); thick outline reads as dark edge on gold.
	local title = titleBar:CreateFontString(nil, "OVERLAY")
	title:SetFontObject(GameFontNormalHuge)
	title:SetPoint("LEFT", titleIcon, "RIGHT", 6, 0)
	title:SetText(ns:L("MAIN_TITLE"))
	local font, size = title:GetFont()
	if font and size then
		title:SetFont(font, size, "THICKOUTLINE")
	end
	title:SetAlpha(1)
	title:SetTextColor(1, 0.82, 0)
	title:SetShadowOffset(1, -1)
	title:SetShadowColor(0, 0, 0, 1)

	local titleVersion = titleBar:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
	titleVersion:SetPoint("LEFT", title, "RIGHT", 8, -1)
	titleVersion:SetTextColor(0.72, 0.82, 0.95)

	-- Close hides the shell; slash can reopen.
	local closeBtn = CreateFrame("Button", nil, titleBar, "UIPanelCloseButton")
	closeBtn:SetPoint("RIGHT", titleBar, "RIGHT", -4, 0)
	closeBtn:SetScript("OnClick", function()
		main:Hide()
	end)

	local infoToggleBtn = CreateFrame("Button", "MidnightHelperInfoToggleBtn", titleBar, "UIPanelButtonTemplate")
	infoToggleBtn:SetSize(56, 22)
	infoToggleBtn:SetPoint("RIGHT", closeBtn, "LEFT", -4, 0)
	MHTintButtonTextures(infoToggleBtn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])

	-- About lives here, beside Info — not pinned to the sidebar bottom, where a growing
	-- tab list (Trading Post pushed it over) collided with the last group (Rob, 10 jul).
	local aboutBtn = CreateFrame("Button", "MidnightHelperAboutBtn", titleBar, "UIPanelButtonTemplate")
	aboutBtn:SetSize(56, 22)
	aboutBtn:SetPoint("RIGHT", infoToggleBtn, "LEFT", -4, 0)
	MHTintButtonTextures(aboutBtn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
	aboutBtn:SetText(ns:L("ABOUT_BUTTON"))
	aboutBtn:SetScript("OnClick", function()
		if ns._mhToggleAboutPanel then
			ns:_mhToggleAboutPanel()
		end
	end)

	-- Rob, 15 Sep 2026: "rechts boven in een knop die classic of modern als switch geeft voor de
	-- layout zodat ie snel om te zetten is. Later bepalen we of die daar blijft." It flips the same
	-- setting as Settings -> Classic look, through the same setter, so the two never disagree. The
	-- label names the look a click switches TO; MHApplyLookChrome keeps it right after every change.
	local lookToggleBtn = CreateFrame("Button", "MidnightHelperLookToggleBtn", titleBar, "UIPanelButtonTemplate")
	lookToggleBtn:SetSize(64, 22)
	lookToggleBtn:SetPoint("RIGHT", aboutBtn, "LEFT", -4, 0)
	MHTintButtonTextures(lookToggleBtn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
	lookToggleBtn:SetScript("OnClick", function()
		if ns.SetClassicLookEnabled and ns.IsClassicLookEnabled then
			ns:SetClassicLookEnabled(not ns:IsClassicLookEnabled())
		end
		if ns._mhRefreshLookToggle then
			ns._mhRefreshLookToggle()
		end
	end)
	lookToggleBtn:SetScript("OnEnter", function(self)
		GameTooltip:SetOwner(self, "ANCHOR_BOTTOM")
		GameTooltip:SetText(ns:L("SETTINGS_CLASSIC_LOOK"), 1, 0.82, 0)
		GameTooltip:AddLine(ns:L("LOOK_TOGGLE_TT"), 0.9, 0.9, 0.9, true)
		GameTooltip:Show()
	end)
	lookToggleBtn:SetScript("OnLeave", function()
		GameTooltip:Hide()
	end)
	ns._mhRefreshLookToggle = function()
		local classic = ns.IsClassicLookEnabled and ns:IsClassicLookEnabled()
		lookToggleBtn:SetText(ns:L(classic and "LOOK_TOGGLE_MODERN" or "LOOK_TOGGLE_CLASSIC"))
		FitTitleBarButton(lookToggleBtn, 56, 100)
	end
	ns._mhRefreshLookToggle()

	-- Phase 3 cross-link: "Read in Codex"-knop, verschijnt bij tabs met een
	-- Codex-tegenhanger (gevuld door SelectTab) en springt naar die categorie.
	local codexLinkBtn = CreateFrame("Button", "MidnightHelperCodexLink", titleBar, "UIPanelButtonTemplate")
	codexLinkBtn:SetSize(110, 20)
	codexLinkBtn:SetPoint("RIGHT", lookToggleBtn, "LEFT", -6, 0)
	MHTintButtonTextures(codexLinkBtn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])
	codexLinkBtn:SetText(ns:L("CODEX_LINK_OPEN"))
	codexLinkBtn:SetScript("OnClick", function(self)
		if self._mhCat and ns.SetActiveCodexCategory then
			ns.SetActiveCodexCategory(self._mhCat)
		end
		if ns.SelectTab then
			ns.SelectTab("codex")
		end
	end)
	codexLinkBtn:Hide()
	ns._mhCodexLinkBtn = codexLinkBtn

	-- Phase 3: breadcrumb in de titelbalk toont 'Kamer > Tab' voor oriëntatie.
	-- Gevuld door SelectTab; tussen versie en de Codex-knop/Info.
	local breadcrumb = titleBar:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
	breadcrumb:SetPoint("LEFT", titleVersion, "RIGHT", 14, 0)
	breadcrumb:SetPoint("RIGHT", codexLinkBtn, "LEFT", -8, 0)
	breadcrumb:SetJustifyH("LEFT")
	breadcrumb:SetWordWrap(false)
	breadcrumb:SetTextColor(0.78, 0.72, 0.55)
	if ns.MHScalableFont then
		breadcrumb:SetFontObject(ns.MHScalableFont("GameFontHighlightSmall"))
	end
	ns._mhBreadcrumb = breadcrumb

	-- Global search row: visible on every tab, full width (wider than the ~132px sidebar would allow).
	local searchBar = CreateFrame("Frame", "MidnightHelperGlobalSearch", main)
	searchBar:SetHeight(MHGetLayoutMetrics().searchBarHeight)
	searchBar:SetPoint("TOPLEFT", titleBar, "BOTTOMLEFT", 0, 0)
	searchBar:SetPoint("TOPRIGHT", titleBar, "BOTTOMRIGHT", 0, 0)
	searchBar:EnableMouse(true)
	local searchBarBg = searchBar:CreateTexture(nil, "BACKGROUND")
	searchBarBg:SetAllPoints()
	searchBarBg:SetTexture(MH_TEX.dialogBgDark)
	if searchBarBg.SetHorizTile then
		searchBarBg:SetHorizTile(true)
	end
	if searchBarBg.SetVertTile then
		searchBarBg:SetVertTile(true)
	end
	searchBarBg:SetVertexColor(0.22, 0.2, 0.24, 0.92)
	local searchBarEdge = searchBar:CreateTexture(nil, "BORDER")
	searchBarEdge:SetHeight(1)
	searchBarEdge:SetPoint("BOTTOMLEFT", searchBar, "BOTTOMLEFT", 0, 0)
	searchBarEdge:SetPoint("BOTTOMRIGHT", searchBar, "BOTTOMRIGHT", 0, 0)
	searchBarEdge:SetColorTexture(MH_CHROME.separator[1], MH_CHROME.separator[2], MH_CHROME.separator[3], 0.65)

	local searchBarHint = searchBar:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
	searchBarHint:SetPoint("LEFT", searchBar, "LEFT", 10, 0)
	searchBarHint:SetTextColor(0.82, 0.78, 0.68)
	searchBarHint:SetText(ns:L("SEARCH_LABEL"))

	local searchResetBtn = CreateFrame("Button", nil, searchBar, "UIPanelButtonTemplate")
	searchResetBtn:SetSize(MHGetLayoutMetrics().searchResetBtnWidth, 22)
	searchResetBtn:SetPoint("RIGHT", searchBar, "RIGHT", -8, 0)
	searchResetBtn:SetText(ns:L("SEARCH_MY_CHARACTER"))
	MHTintButtonTextures(searchResetBtn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])

	local searchGoBtn = CreateFrame("Button", nil, searchBar, "UIPanelButtonTemplate")
	searchGoBtn:SetSize(MHGetLayoutMetrics().searchGoBtnWidth, 22)
	searchGoBtn:SetPoint("RIGHT", searchResetBtn, "LEFT", -6, 0)
	searchGoBtn:SetText(ns:L("SEARCH_GO"))
	MHTintButtonTextures(searchGoBtn, MH_CHROME.tabTexInactive[1], MH_CHROME.tabTexInactive[2], MH_CHROME.tabTexInactive[3])

	local searchEdit = CreateFrame("EditBox", nil, searchBar)
	searchEdit:SetAutoFocus(false)
	searchEdit:SetMultiLine(false)
	searchEdit:SetFontObject("GameFontHighlightSmall")
	searchEdit:SetHeight(20)
	searchEdit:SetPoint("LEFT", searchBarHint, "RIGHT", 8, 0)
	searchEdit:SetPoint("RIGHT", searchGoBtn, "LEFT", -8, 0)
	if searchEdit.SetMaxLetters then
		searchEdit:SetMaxLetters(96)
	end
	searchEdit:SetTextInsets(6, 6, 0, 0)
	searchEdit:SetTextColor(0.95, 0.93, 0.88)
	ns.mhSearchEdit = searchEdit

	local searchEditBg = CreateFrame("Frame", nil, searchBar, "BackdropTemplate")
	searchEditBg:SetPoint("TOPLEFT", searchEdit, "TOPLEFT", -4, 2)
	searchEditBg:SetPoint("BOTTOMRIGHT", searchEdit, "BOTTOMRIGHT", 4, -2)
	searchEditBg:SetFrameLevel(searchBar:GetFrameLevel() + 1)
	if searchEditBg.SetBackdrop then
		searchEditBg:SetBackdrop({
			bgFile = "Interface\\Buttons\\WHITE8X8",
			edgeFile = "Interface\\Buttons\\WHITE8X8",
			tile = true,
			tileSize = 8,
			edgeSize = 1,
			insets = { left = 1, right = 1, top = 1, bottom = 1 },
		})
		searchEditBg:SetBackdropColor(0.05, 0.05, 0.07, 0.94)
		searchEditBg:SetBackdropBorderColor(0.55, 0.46, 0.3, 0.85)
	end
	searchEdit:SetFrameLevel(searchBar:GetFrameLevel() + 2)

	local function runSearchFromBar()
		local query = searchEdit:GetText()
		-- Navigation search (the "front door"): a strong tab-name match jumps
		-- straight there; weaker/keyword queries fall through to Codex/Guide.
		if ns.MHNavSearchTryJump and ns.MHNavSearchTryJump(query) then
			return
		end
		-- Codex topics route first (handbook: dawncrest/reference/weekly/...).
		-- Explicitly here at the call site: Guide.lua loads after
		-- MidnightCodex.lua and assigns ns.MH_RunSearchQuery wholesale, which
		-- silently disabled the old wrap-based precedence.
		if ns.TryCodexSearch and ns.TryCodexSearch(query) then
			return
		end
		if ns.MH_RunSearchQuery then
			ns.MH_RunSearchQuery(query)
		else
			print(("|cffffcc00%s|r %s"):format(ns:L("PRINT_PREFIX"), ns:L("SEARCH_NOT_READY")))
		end
	end
	searchEdit:SetScript("OnEnterPressed", function(self)
		runSearchFromBar()
		self:ClearFocus()
	end)

	--- 🔴 ESCAPE MUST LET GO OF THE KEYBOARD. A focused EditBox eats every keystroke,
	--- including the ones you walk with. Enter released it and Escape did not, so closing
	--- the window with Escape left this box holding focus while invisible — and from then
	--- on `A` strafes nothing.
	---
	--- ⚠️ AND THERE IS NOTHING TO FIND WHEN IT HAPPENS. WoWNext shipped 2.0.3 on 27 aug
	--- for exactly this and wrote it down: "No WoWNext key binding to A was found; the
	--- issue was caused by retained EditBox focus." They went looking for a keybind first,
	--- because that is what a stolen movement key looks like from the player's side.
	---
	--- `SetAutoFocus(false)` — which all twenty of our boxes have — stops the box from
	--- TAKING focus. It does nothing about giving it back.
	searchEdit:SetScript("OnEscapePressed", function(self)
		self:ClearFocus()
	end)

	-- Placeholder inside the box. This bar is the addon's front door — it finds tabs,
	-- tools and every boss we wrote steps for — but a bare "Search:" never tells you
	-- that. Greyed, and gone the moment you focus the box or type in it. Hooked after
	-- the scripts above, since a later SetScript would drop a HookScript chain.
	local searchPlaceholder = searchEdit:CreateFontString(nil, "OVERLAY", "GameFontDisableSmall")
	searchPlaceholder:SetPoint("LEFT", searchEdit, "LEFT", 6, 0)
	searchPlaceholder:SetPoint("RIGHT", searchEdit, "RIGHT", -6, 0)
	searchPlaceholder:SetJustifyH("LEFT")
	searchPlaceholder:SetText(ns:L("SEARCH_PLACEHOLDER"))
	ns.mhSearchPlaceholder = searchPlaceholder

	local function UpdateSearchPlaceholder()
		searchPlaceholder:SetShown((searchEdit:GetText() or "") == "" and not searchEdit:HasFocus())
	end
	searchEdit:HookScript("OnTextChanged", UpdateSearchPlaceholder)
	searchEdit:HookScript("OnEditFocusGained", UpdateSearchPlaceholder)
	searchEdit:HookScript("OnEditFocusLost", UpdateSearchPlaceholder)
	UpdateSearchPlaceholder()
	searchGoBtn:SetScript("OnClick", function()
		runSearchFromBar()
		searchEdit:ClearFocus()
	end)
	searchResetBtn:SetScript("OnClick", function()
		if ns.MH_ClearSearchAndPreview then
			ns.MH_ClearSearchAndPreview()
		else
			if ns.mhSearchEdit and ns.mhSearchEdit.SetText then
				ns.mhSearchEdit:SetText("")
			end
		end
	end)

	searchBar:SetScript("OnEnter", function()
		local gt = _G.GameTooltip
		if not gt or not gt.SetOwner then
			return
		end
		gt:SetOwner(searchBar, "ANCHOR_TOPRIGHT", 0, 0)
		gt:ClearLines()
		gt:AddLine(ns:L("SEARCH_TOOLTIP_TITLE"), 1, 0.9, 0.5)
		gt:AddLine(
			ns:L("SEARCH_TOOLTIP_BODY"),
			0.9,
			0.88,
			0.82,
			true
		)
		gt:Show()
	end)
	searchBar:SetScript("OnLeave", function()
		local gt = _G.GameTooltip
		if gt then
			gt:Hide()
		end
	end)

	ns.mhSearchBar = searchBar

	-- Pinned favourites row (1.9.0 Phase 5): a thin strip under the search bar with the
	-- player's most-used destinations for one-click access. Left-click a chip to jump,
	-- right-click to unpin, the "+" opens a menu to pin/unpin any tab. Stored in
	-- ns.db.favourites (tab ids). Sidebar/content anchor to this row (fixed 24px height,
	-- so pinning/unpinning never re-lays out the window).
	local FAV_MAX = 5
	local favRow = CreateFrame("Frame", "MidnightHelperFavRow", main)
	favRow:SetHeight(24)
	favRow:SetPoint("TOPLEFT", searchBar, "BOTTOMLEFT", 0, 0)
	favRow:SetPoint("TOPRIGHT", searchBar, "BOTTOMRIGHT", 0, 0)
	local favRowBg = favRow:CreateTexture(nil, "BACKGROUND")
	favRowBg:SetAllPoints()
	favRowBg:SetColorTexture(0.16, 0.15, 0.18, 0.85)
	local favRowEdge = favRow:CreateTexture(nil, "BORDER")
	favRowEdge:SetHeight(1)
	favRowEdge:SetPoint("BOTTOMLEFT", favRow, "BOTTOMLEFT", 0, 0)
	favRowEdge:SetPoint("BOTTOMRIGHT", favRow, "BOTTOMRIGHT", 0, 0)
	favRowEdge:SetColorTexture(MH_CHROME.separator[1], MH_CHROME.separator[2], MH_CHROME.separator[3], 0.5)
	ns.mhFavRow = favRow

	local MHRenderFavRow -- forward-declared (chip/menu callbacks re-render)
	local function MHFavList()
		ns.db = ns.db or {}
		if type(ns.db.favourites) ~= "table" then
			ns.db.favourites = { "delves", "enchants", "currency" } -- sensible defaults
		end
		return ns.db.favourites
	end
	local function MHIsFav(id)
		for _, v in ipairs(MHFavList()) do
			if v == id then
				return true
			end
		end
		return false
	end
	local function MHToggleFav(id)
		local list = MHFavList()
		for i, v in ipairs(list) do
			if v == id then
				table.remove(list, i)
				return
			end
		end
		if #list < FAV_MAX then
			list[#list + 1] = id
		end
	end

	-- Drag a chip to change the order (Rob, 13 Sep 2026: "doe het slepen ook maar voor de
	-- knopjes bovenin"), the same way the 4.0 room cards move. The dragged chip follows the
	-- cursor along the row and the others make room. On release the shown chips' new order is
	-- written back into the slots they held in ns.db.favourites, so an entry that is not shown
	-- (a hidden screen) keeps its place in the list.
	local function FavCursorX()
		local left = favRow:GetLeft()
		if not left then
			return nil
		end
		return GetCursorPosition() / favRow:GetEffectiveScale() - left
	end

	local function PlaceFavChips()
		local drag = favRow._drag
		local x, slot = 8, 0
		for _, c in ipairs(favRow._order or {}) do
			if not (drag and c == drag.chip) then
				slot = slot + 1
				if drag and slot == drag.to then
					x = x + drag.chip:GetWidth() + 5
				end
				c:ClearAllPoints()
				c:SetPoint("LEFT", favRow, "LEFT", x, 0)
				x = x + c:GetWidth() + 5
			end
		end
		if drag and drag.to > slot then
			x = x + drag.chip:GetWidth() + 5
		end
		if favRow._plus then
			favRow._plus:ClearAllPoints()
			favRow._plus:SetPoint("LEFT", favRow, "LEFT", x, 0)
		end
	end

	-- Which slot the cursor is over, measured on the row as it stands without the dragged chip.
	local function FavSlotAt(cx)
		local drag = favRow._drag
		local x, n, to = 8, 0, 1
		for _, c in ipairs(favRow._order or {}) do
			if c ~= drag.chip then
				n = n + 1
				local w = c:GetWidth()
				if cx > x + w / 2 then
					to = n + 1
				end
				x = x + w + 5
			end
		end
		return to
	end

	local function StartFavDrag(chip)
		if favRow._drag or not favRow._order then
			return
		end
		local from
		for i, c in ipairs(favRow._order) do
			if c == chip then
				from = i
			end
		end
		if not from then
			return
		end
		if GameTooltip then
			GameTooltip:Hide()
		end
		favRow._drag = { chip = chip, from = from, to = from }
		chip._mhLevel = chip:GetFrameLevel()
		chip:SetFrameLevel(chip._mhLevel + 10)
		chip:SetAlpha(0.8)
		chip:SetScript("OnUpdate", function(self)
			local drag = favRow._drag
			local cx = FavCursorX()
			if not (drag and cx) then
				return
			end
			self:ClearAllPoints()
			self:SetPoint("CENTER", favRow, "LEFT", cx, 0)
			local to = FavSlotAt(cx)
			if to ~= drag.to then
				drag.to = to
				PlaceFavChips()
			end
		end)
	end

	--- Drops the dragged chip (save) or puts it back (a re-render mid-drag), then re-renders.
	local function EndFavDrag(save)
		local drag = favRow._drag
		if not drag then
			return
		end
		local chip = drag.chip
		favRow._drag = nil
		chip:SetScript("OnUpdate", nil)
		chip:SetAlpha(1)
		if chip._mhLevel then
			chip:SetFrameLevel(chip._mhLevel)
		end
		chip._mhDragEnd = GetTime()
		if save and drag.to ~= drag.from then
			local order = favRow._order
			table.remove(order, drag.from)
			table.insert(order, drag.to, chip)
			local shown = {}
			for _, c in ipairs(order) do
				shown[c._mhId] = true
			end
			local list, k = MHFavList(), 0
			for i, id in ipairs(list) do
				if shown[id] then
					k = k + 1
					list[i] = order[k]._mhId
				end
			end
		end
		if MHRenderFavRow then
			MHRenderFavRow()
		end
	end

	local function InitFavPinMenu(_, level)
		if not (UIDropDownMenu_CreateInfo and UIDropDownMenu_AddButton) then
			return
		end
		for _, t in ipairs(TAB_DEFS) do
			if SidebarTabVisible(t.id) then
				local info = UIDropDownMenu_CreateInfo()
				info.text = ns:L(t.labelKey)
				info.checked = MHIsFav(t.id)
				info.isNotRadio = true
				info.keepShownOnClick = true
				info.func = function()
					MHToggleFav(t.id)
					MHRenderFavRow()
				end
				UIDropDownMenu_AddButton(info, level)
			end
		end
	end

	local function FavChip(i)
		favRow._chips = favRow._chips or {}
		local c = favRow._chips[i]
		if c then
			return c
		end
		c = CreateFrame("Button", nil, favRow)
		c:SetHeight(18)
		local bg = c:CreateTexture(nil, "BACKGROUND")
		bg:SetAllPoints()
		bg:SetColorTexture(0.30, 0.28, 0.34, 0.9)
		local hl = c:CreateTexture(nil, "HIGHLIGHT")
		hl:SetAllPoints()
		hl:SetColorTexture(1, 0.82, 0.2, 0.20)
		local fs = c:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
		if ns.MHScalableFont then
			fs:SetFontObject(ns.MHScalableFont("GameFontHighlightSmall"))
		end
		fs:SetPoint("CENTER")
		c.fs = fs
		c:RegisterForClicks("LeftButtonUp", "RightButtonUp")
		c:RegisterForDrag("LeftButton")
		c:SetScript("OnDragStart", StartFavDrag)
		c:SetScript("OnDragStop", function()
			EndFavDrag(true)
		end)
		c:SetScript("OnClick", function(self, button)
			if self._mhDragEnd and GetTime() - self._mhDragEnd < 0.3 then
				return -- the mouse-up that ended a drag is not a click
			end
			if button == "RightButton" then
				if self._mhId then
					MHToggleFav(self._mhId)
					MHRenderFavRow()
				end
				return
			end
			if self._mhId then
				if ns.ShowMainUI then
					ns:ShowMainUI()
				end
				if ns.SelectTab then
					ns.SelectTab(self._mhId)
				end
			end
		end)
		c:SetScript("OnEnter", function(self)
			if GameTooltip and self._mhId and not favRow._drag then
				GameTooltip:SetOwner(self, "ANCHOR_BOTTOM")
				GameTooltip:SetText(ns:L("FAV_CHIP_HINT"), 1, 0.82, 0.2, 1, true)
				GameTooltip:AddLine(ns:L("FAV_DRAG_HINT"), 0.72, 0.74, 0.78, true)
				GameTooltip:Show()
			end
		end)
		c:SetScript("OnLeave", function()
			if GameTooltip then
				GameTooltip:Hide()
			end
		end)
		favRow._chips[i] = c
		return c
	end

	MHRenderFavRow = function()
		if favRow._drag then
			EndFavDrag(false) -- puts the chip back and renders again
			return
		end
		local list = MHFavList()
		local n = 0
		favRow._order = {}
		for _, id in ipairs(list) do
			local labelKey = TAB_LABEL_BY_ID[id]
			if labelKey and SidebarTabVisible(id) then
				n = n + 1
				local c = FavChip(n)
				c._mhId = id
				c.fs:SetText(ns:L(labelKey))
				c:SetWidth(math.max(46, (c.fs:GetStringWidth() or 40) + 16))
				c:Show()
				favRow._order[n] = c
			end
		end
		if favRow._chips then
			for j = n + 1, #favRow._chips do
				favRow._chips[j]:Hide()
			end
		end
		local plus = favRow._plus
		if not plus then
			plus = CreateFrame("Button", nil, favRow)
			plus:SetSize(20, 18)
			local pbg = plus:CreateTexture(nil, "BACKGROUND")
			pbg:SetAllPoints()
			pbg:SetColorTexture(0.26, 0.24, 0.30, 0.9)
			local phl = plus:CreateTexture(nil, "HIGHLIGHT")
			phl:SetAllPoints()
			phl:SetColorTexture(1, 0.82, 0.2, 0.22)
			local pfs = plus:CreateFontString(nil, "OVERLAY", "GameFontNormalLarge")
			pfs:SetPoint("CENTER", 0, -1)
			pfs:SetText("+")
			plus:SetScript("OnClick", function(self)
				if not (UIDropDownMenu_Initialize and ToggleDropDownMenu) then
					return
				end
				if not favRow._pinMenu then
					favRow._pinMenu = CreateFrame("Frame", "MidnightHelperFavPinMenu", UIParent, "UIDropDownMenuTemplate")
				end
				UIDropDownMenu_Initialize(favRow._pinMenu, InitFavPinMenu, "MENU")
				ToggleDropDownMenu(1, nil, favRow._pinMenu, self, 0, 0)
			end)
			plus:SetScript("OnEnter", function(self)
				if GameTooltip then
					GameTooltip:SetOwner(self, "ANCHOR_BOTTOM")
					GameTooltip:SetText(ns:L("FAV_PLUS_HINT"), 1, 0.82, 0.2, 1, true)
					GameTooltip:Show()
				end
			end)
			plus:SetScript("OnLeave", function()
				if GameTooltip then
					GameTooltip:Hide()
				end
			end)
			favRow._plus = plus
		end
		plus:Show()
		PlaceFavChips()
	end

	ns.MHRenderFavRow = MHRenderFavRow
	MHRenderFavRow()

	--- 🔴 A RED STRIP ACROSS THE WHOLE WINDOW WHILE THE CHARACTER IS TOO LOW.
	--- Rob, 5 Sep 2026: *"Is het een idee om wanneer iemand onder lvl 78 is standaard een
	--- soort rode balk boven aan de addon te plakken en zeggen dat deze addon vooral werkt
	--- voor lvl 78 en hoger?"*
	---
	--- 📌 It is the same rule as the Silvermoon banner two days earlier, one level up: an
	--- answer to "why does so little of this apply to me" belongs in the room where the
	--- player is standing, not in chat and not one toast at a time. Per-route warnings tell
	--- you about ONE destination; this tells you about the whole addon, once, without being
	--- asked. Nothing is hidden or disabled -- every tab still opens.
	---
	--- ⚠️ 78 is the MIDNIGHT INTRO level and it is NOT the same number as the level-80 floor
	--- the Silvermoon banner uses. 80 is Blizzard's own announcement for when Eversong and
	--- Silvermoon are tuned; 78 is where the intro questline starts, from two guide sources
	--- read in full, and Rob's own reading agrees. Two different claims with two different
	--- strengths, so deliberately two numbers rather than one flattened one.
	---
	--- ⚠️ Fixed height, always created, hidden with a near-zero height rather than removed:
	--- the sidebar and content anchor to it, so a bar that appears and disappears must not
	--- be able to re-lay out the window on a level-up.
	local levelBar = CreateFrame("Frame", "MidnightHelperLevelBar", main)
	levelBar:SetPoint("TOPLEFT", favRow, "BOTTOMLEFT", 0, 0)
	levelBar:SetPoint("TOPRIGHT", favRow, "BOTTOMRIGHT", 0, 0)
	levelBar:SetHeight(0.01)
	local levelBarBg = levelBar:CreateTexture(nil, "BACKGROUND")
	levelBarBg:SetAllPoints()
	-- Red for "not yet", matching the Silvermoon banner. Grey is what the other installed
	-- guides reserve for content you are PAST; using it for both makes the two states
	-- indistinguishable (measured in Zygor and the HandyNotes handlers, 3 Sep).
	levelBarBg:SetColorTexture(0.42, 0.10, 0.09, 0.92)
	local levelBarEdge = levelBar:CreateTexture(nil, "BORDER")
	levelBarEdge:SetHeight(1)
	levelBarEdge:SetPoint("BOTTOMLEFT", levelBar, "BOTTOMLEFT", 0, 0)
	levelBarEdge:SetPoint("BOTTOMRIGHT", levelBar, "BOTTOMRIGHT", 0, 0)
	levelBarEdge:SetColorTexture(0.85, 0.35, 0.3, 0.7)
	local levelBarText = levelBar:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
	levelBarText:SetPoint("LEFT", levelBar, "LEFT", 10, 0)
	levelBarText:SetPoint("RIGHT", levelBar, "RIGHT", -10, 0)
	levelBarText:SetJustifyH("LEFT")
	levelBarText:SetWordWrap(false)
	levelBarText:SetTextColor(1, 0.88, 0.84)
	levelBar:Hide()
	ns.mhLevelBar = levelBar
	ns.mhLevelBarText = levelBarText
	if ns.RefreshMidnightLevelBar then
		ns.RefreshMidnightLevelBar()
	end

	-- Sidebar column for module tabs (left, below the favourites row).
	local sidebar = CreateFrame("Frame", nil, main)
	sidebar:SetWidth(MHGetLayoutMetrics().sidebarWidth)
	sidebar:SetPoint("TOPLEFT", levelBar, "BOTTOMLEFT", 0, 0)
	-- Inner shell uses only the gold-border inset; resize grip sits in the corner on top.
	sidebar:SetPoint("BOTTOMLEFT", main, "BOTTOMLEFT", MH_MAIN_EDGE.L, MH_MAIN_EDGE.B)

	local sidebarBg = sidebar:CreateTexture(nil, "ARTWORK", nil, -7)
	sidebarBg:SetAllPoints()
	sidebarBg:SetTexture(MH_TEX.dialogBgDark)
	if sidebarBg.SetHorizTile then
		sidebarBg:SetHorizTile(true)
	end
	if sidebarBg.SetVertTile then
		sidebarBg:SetVertTile(true)
	end
	sidebarBg:SetVertexColor(0.34, 0.32, 0.38, 0.94)

	local betaSepTop = sidebar:CreateTexture(nil, "ARTWORK")
	betaSepTop:SetHeight(1)
	betaSepTop:SetColorTexture(0.45, 0.40, 0.30, 0.55)
	sidebar._mhBetaSepTop = betaSepTop
	local betaSepBottom = sidebar:CreateTexture(nil, "ARTWORK")
	betaSepBottom:SetHeight(1)
	betaSepBottom:SetColorTexture(0.45, 0.40, 0.30, 0.45)
	sidebar._mhBetaSepBottom = betaSepBottom

	-- (About button now lives in the title bar beside Info; see above.)

	-- 4.0 screen header (Spec 37 concept A): icon + one line, above the content column.
	-- Anchored by MHAnchorContentColumn; hidden, with content back on the level bar, when
	-- the Classic setting is on.
	local lookHeader = CreateFrame("Frame", "MidnightHelperLookHeader", main)
	local lookBg = lookHeader:CreateTexture(nil, "BACKGROUND")
	lookBg:SetAllPoints()
	-- Night indigo from the logo; the icons were painted on the same ground.
	lookBg:SetColorTexture(MHUnpack4(LOOK_PALETTE.sidebar))
	local lookEdge = lookHeader:CreateTexture(nil, "BORDER")
	lookEdge:SetHeight(1)
	lookEdge:SetPoint("BOTTOMLEFT", lookHeader, "BOTTOMLEFT", 0, 0)
	lookEdge:SetPoint("BOTTOMRIGHT", lookHeader, "BOTTOMRIGHT", 0, 0)
	lookEdge:SetColorTexture(LOOK_PALETTE.accent[1], LOOK_PALETTE.accent[2], LOOK_PALETTE.accent[3], 0.7)
	local lookIcon = lookHeader:CreateTexture(nil, "ARTWORK")
	lookIcon:SetPoint("LEFT", lookHeader, "LEFT", 10, 0)
	lookIcon:SetSize(LOOK_HEADER_H - 10, LOOK_HEADER_H - 10)
	-- A thin gold frame hides the hard edge of the painted square (Rob, 12 Sep: "vierkant met
	-- een goud randje"). A child frame so it draws over the icon; it follows the icon's size.
	--- ⚠️ 16 sep 2026: vier texturen, geen backdrop-frame. Zelfde reden als bij de kaarten
	--- (`RoomLauncher.lua`, MakeCard): een kind-frame met een backdrop tekent op zijn eigen frame
	--- level, gelijk met de laag van het icoon eronder, en wie er dan bovenop komt ligt niet vast.
	--- Robs screenshots lieten het per kaart verschillen. Texturen op de OVERLAY-laag van dezelfde
	--- frame kennen die race niet.
	local lookIconEdges = {}
	for _, side in ipairs({ "top", "bottom", "left", "right" }) do
		local t = lookHeader:CreateTexture(nil, "OVERLAY")
		t:SetColorTexture(LOOK_PALETTE.header[1], LOOK_PALETTE.header[2], LOOK_PALETTE.header[3], 0.95)
		lookIconEdges[side] = t
	end
	lookIconEdges.top:SetPoint("BOTTOMLEFT", lookIcon, "TOPLEFT", -2, 0)
	lookIconEdges.top:SetPoint("BOTTOMRIGHT", lookIcon, "TOPRIGHT", 2, 0)
	lookIconEdges.top:SetHeight(2)
	lookIconEdges.bottom:SetPoint("TOPLEFT", lookIcon, "BOTTOMLEFT", -2, 0)
	lookIconEdges.bottom:SetPoint("TOPRIGHT", lookIcon, "BOTTOMRIGHT", 2, 0)
	lookIconEdges.bottom:SetHeight(2)
	lookIconEdges.left:SetPoint("TOPRIGHT", lookIcon, "TOPLEFT", 0, 2)
	lookIconEdges.left:SetPoint("BOTTOMRIGHT", lookIcon, "BOTTOMLEFT", 0, -2)
	lookIconEdges.left:SetWidth(2)
	lookIconEdges.right:SetPoint("TOPLEFT", lookIcon, "TOPRIGHT", 0, 2)
	lookIconEdges.right:SetPoint("BOTTOMLEFT", lookIcon, "BOTTOMRIGHT", 0, -2)
	lookIconEdges.right:SetWidth(2)
	local lookText = lookHeader:CreateFontString(nil, "OVERLAY", "GameFontHighlight")
	lookText:SetPoint("LEFT", lookIcon, "RIGHT", 12, 0)
	lookText:SetPoint("RIGHT", lookHeader, "RIGHT", -14, 0)
	lookText:SetJustifyH("LEFT")
	lookText:SetJustifyV("MIDDLE")
	lookText:SetWordWrap(true)
	if lookText.SetMaxLines then
		lookText:SetMaxLines(2)
	end
	lookText:SetTextColor(LOOK_PALETTE.body[1], LOOK_PALETTE.body[2], LOOK_PALETTE.body[3])
	lookHeader._mhIcon = lookIcon
	lookHeader._mhText = lookText

	-- Content region: hosts one visible module panel at a time.
	local content = CreateFrame("Frame", nil, main)
	MHAnchorContentColumn({ main = main, levelBar = levelBar, content = content, lookHeader = lookHeader },
		MHGetLayoutMetrics())

	local contentBg = content:CreateTexture(nil, "BACKGROUND")
	contentBg:SetAllPoints()
	contentBg:SetTexture(MH_TEX.dialogBg)
	if contentBg.SetHorizTile then
		contentBg:SetHorizTile(true)
	end
	if contentBg.SetVertTile then
		contentBg:SetVertTile(true)
	end
	contentBg:SetVertexColor(0.42, 0.44, 0.52, 0.72)

	local infoWindow = CreateFrame("Frame", "MidnightHelperInfoWindow", main, "BackdropTemplate")
	infoWindow:SetSize(MHGetLayoutMetrics().infoWindowWidth, MHGetLayoutMetrics().infoWindowHeight)
	infoWindow:SetFrameLevel(main:GetFrameLevel() + 8)
	infoWindow:SetClampedToScreen(true)
	if infoWindow.SetBackdrop then
		infoWindow:SetBackdrop({
			bgFile = MH_TEX.dialogBg,
			edgeFile = MH_TEX.goldEdge,
			tile = true,
			tileSize = 32,
			edgeSize = 16,
			insets = { left = 8, right = 9, top = 8, bottom = 8 },
		})
		infoWindow:SetBackdropColor(1, 1, 1, 0.93)
		infoWindow:SetBackdropBorderColor(1, 1, 1, 1)
	end
	infoWindow:Hide()

	local infoTitle = infoWindow:CreateFontString(nil, "OVERLAY", "GameFontHighlight")
	infoTitle:SetPoint("TOPLEFT", infoWindow, "TOPLEFT", 12, -12)
	infoTitle:SetPoint("TOPRIGHT", infoWindow, "TOPRIGHT", -12, -12)
	infoTitle:SetJustifyH("LEFT")
	infoTitle:SetTextColor(1, 0.9, 0.6)

	local infoBody = infoWindow:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
	infoBody:SetPoint("TOPLEFT", infoTitle, "BOTTOMLEFT", 0, -10)
	infoBody:SetPoint("TOPRIGHT", infoWindow, "TOPRIGHT", -12, -10)
	-- No bottom anchor (15 Sep 2026): the body sizes itself to its text and the window grows to
	-- fit it in _mhRefreshSidePanel. Pinned to a fixed 210 px window, the About text ended in
	-- "locatio..." on Rob's screen and the rest was unreadable.
	infoBody:SetJustifyH("LEFT")
	infoBody:SetJustifyV("TOP")
	infoBody:SetWordWrap(true)
	infoBody:SetTextColor(0.88, 0.86, 0.8)

	function ns:_mhRefreshSidePanel(tabId)
		if not infoWindow or not infoTitle or not infoBody then
			return
		end
		local mode = self._mhSidePanelMode or "info"
		if mode == "about" then
			infoTitle:SetText(self:L("ABOUT_WINDOW_TITLE"))
			local ver = ns.GetAddonVersion and ns.GetAddonVersion() or "?"
			infoBody:SetText(self:L("ABOUT_VERSION_FMT"):format(ver) .. "\n\n" .. self:L("ABOUT_WINDOW_BODY"))
		else
			local keyById = {
				codex = "TAB_CODEX",
				home = "TAB_HOME",
				delves = "TAB_DELVES",
				world = "TAB_WORLD",
				delvelog = "TAB_DELVE_LOG",
				enchants = "TAB_ENCHANTS",
				tier = "TAB_TIER",
				rares = "TAB_RARES",
				events = "TAB_EVENTS",
				account = "TAB_ACCOUNT_SNAPSHOT",
				reference = "TAB_REFERENCE",
				smcguide = "TAB_SMC",
				currency = "TAB_CURRENCY",
				professions = "TAB_PROFESSIONS",
				guide = "TAB_GUIDE",
				macros = "TAB_MACROS",
				academy = "TAB_ACADEMY",
				addons = "TAB_ADDONS",
			}
			local tabName = self:L(TAB_LABEL_BY_ID[tabId] or keyById[tabId] or "TAB_HOME")
			infoTitle:SetText(self:L("INFO_DRAWER_TITLE_FMT"):format(tabName))
			infoBody:SetText(self:L(MHGetInfoBodyKeyForTab(tabId)))
		end
		-- Grow the window to its text: never below the layout's height, never above 70% of the
		-- screen. The fitted height is kept on the frame so a relayout does not shrink it back.
		do
			local titleH = (infoTitle.GetStringHeight and infoTitle:GetStringHeight()) or 14
			local bodyH = (infoBody.GetStringHeight and infoBody:GetStringHeight()) or 0
			local want = math.ceil(12 + titleH + 10 + bodyH + 14)
			local maxH = ((UIParent.GetHeight and UIParent:GetHeight()) or 800) * 0.7
			local h = math.max(MHGetLayoutMetrics().infoWindowHeight, math.min(want, maxH))
			infoWindow._mhFitHeight = h
			infoWindow:SetHeight(h)
		end
		local infoToggleKey = (infoWindow:IsShown() and mode == "info") and "INFO_DRAWER_TOGGLE_HIDE" or "INFO_DRAWER_TOGGLE_SHOW"
		infoToggleBtn:SetText(self:EscapeButtonAmpersand(self:L(infoToggleKey)))
		FitTitleBarButton(infoToggleBtn, 56, 120)
		local aboutBtnKey = (infoWindow:IsShown() and mode == "about") and "INFO_DRAWER_TOGGLE_HIDE" or "ABOUT_BUTTON"
		aboutBtn:SetText(self:EscapeButtonAmpersand(self:L(aboutBtnKey)))
		FitTitleBarButton(aboutBtn, 56, 100)
	end

	local function reanchorInfoWindow()
		local m = MHGetLayoutMetrics()
		local gap = 8
		local uiLeft = UIParent.GetLeft and UIParent:GetLeft() or 0
		local uiRight = UIParent.GetRight and UIParent:GetRight() or 0
		local mainLeft = main.GetLeft and main:GetLeft() or 0
		local mainRight = main.GetRight and main:GetRight() or 0
		local need = (infoWindow.GetWidth and infoWindow:GetWidth() or m.infoWindowWidth) + gap
		local rightSpace = uiRight - mainRight
		local leftSpace = mainLeft - uiLeft

		infoWindow:ClearAllPoints()
		if rightSpace >= need then
			-- Preferred: compact helper window to the right of the addon.
			infoWindow:SetPoint("BOTTOMLEFT", main, "BOTTOMRIGHT", gap, 0)
		elseif leftSpace >= need then
			-- Fallback: place it to the left if right side is against screen edge.
			infoWindow:SetPoint("BOTTOMRIGHT", main, "BOTTOMLEFT", -gap, 0)
		else
			-- Last resort on very small screens: keep it inside the addon, bottom-right (inside gold border).
			infoWindow:SetPoint("BOTTOMRIGHT", main, "BOTTOMRIGHT", -MH_MAIN_EDGE.R - 6, MH_MAIN_EDGE.B + 6)
		end
	end

	local function setSidePanelMode(mode)
		if infoWindow:IsShown() and ns._mhSidePanelMode == mode then
			infoWindow:Hide()
		else
			ns._mhSidePanelMode = mode
			reanchorInfoWindow()
			infoWindow:Show()
		end
		ns:_mhRefreshSidePanel(ns.uiSelectedTab or "delves")
	end

	local function toggleInfoWindow()
		setSidePanelMode("info")
	end
	infoToggleBtn:SetScript("OnClick", toggleInfoWindow)
	function ns:_mhToggleAboutPanel()
		setSidePanelMode("about")
	end
	ns._mhSidePanelMode = ns._mhSidePanelMode or "info"

	-- Vertical rule + shadow (embossed gold accent between sidebar and content).
	local sidebarSepShadow = main:CreateTexture(nil, "ARTWORK", nil, 0)
	sidebarSepShadow:SetWidth(3)
	sidebarSepShadow:SetPoint("TOPLEFT", sidebar, "TOPRIGHT", -1, 0)
	sidebarSepShadow:SetPoint("BOTTOMLEFT", sidebar, "BOTTOMRIGHT", -1, 0)
	sidebarSepShadow:SetColorTexture(MHUnpack4(MH_CHROME.separatorShadow))
	local sidebarSep = main:CreateTexture(nil, "ARTWORK", nil, 1)
	sidebarSep:SetWidth(2)
	sidebarSep:SetPoint("TOPLEFT", sidebar, "TOPRIGHT", 0, 0)
	sidebarSep:SetPoint("BOTTOMLEFT", sidebar, "BOTTOMRIGHT", 0, 0)
	sidebarSep:SetColorTexture(MHUnpack4(MH_CHROME.separator))

	-- Module panels: siblings in `content`; tab clicks toggle visibility.
	ns.panels = ns.panels or {}

	local function CreateModulePanel(id, displayName)
		local panel = CreateFrame("Frame", nil, content)
		panel:SetAllPoints()
		panel:Hide()

		local header = panel:CreateFontString(nil, "OVERLAY", "GameFontHighlightMedium")
		header:SetPoint("TOPLEFT", 12, -12)
		header:SetText(displayName)
		panel._header = header

		local body = panel:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
		body:SetPoint("TOPLEFT", header, "BOTTOMLEFT", 0, -8)
		body:SetWidth(content:GetWidth() - 24)
		body:SetJustifyH("LEFT")
		body:SetText(ns:L("MODULE_PLACEHOLDER"):format(displayName))

		panel._body = body
		panel:SetScript("OnShow", function()
			body:SetWidth(panel:GetWidth() - 24)
		end)

		ns.panels[id] = panel
		return panel
	end

	local tabKeys = {}
	for _, tab in ipairs(TAB_DEFS) do
		tabKeys[tab.id] = tab.labelKey
	end

	for _, tab in ipairs(TAB_DEFS) do
		if tab.id ~= "addons" and tab.id ~= "guide" and tab.id ~= "toolbox" then
			local panel = CreateModulePanel(tab.id, ns:L(tab.labelKey))
			if tab.id == "smcguide" then
				BuildSMCCityGuidePanel(panel)
			elseif tab.id == "rares" and ns.BuildRaresPanel then
				ns.BuildRaresPanel(panel)
			elseif tab.id == "achievements" and ns.BuildAchievementsPanel then
				ns.BuildAchievementsPanel(panel)
			elseif tab.id == "codex" and ns.BuildCodexPanel then
				ns.BuildCodexPanel(panel)
			elseif tab.id == "home" and ns.BuildHomePanel then
				ns.BuildHomePanel(panel)
			elseif tab.id == "mounts" and ns.BuildMountsPanel then
				ns.BuildMountsPanel(panel)
			elseif tab.id == "tradingpost" and ns.BuildTradingPostPanel then
				ns.BuildTradingPostPanel(panel)
			elseif tab.id == "raids" and ns.BuildRaidsPanel then
				ns.BuildRaidsPanel(panel)
			elseif tab.id == "world" and ns.BuildWorldPanel then
				ns.BuildWorldPanel(panel)
			elseif tab.id == "events" and ns.BuildEventsPanel then
				ns.BuildEventsPanel(panel)
			elseif tab.id == "delvelog" and ns.BuildDelveLogPanel then
				ns.BuildDelveLogPanel(panel)
			elseif tab.id == "enchants" and ns.BuildGearEnchantPanel then
				ns.BuildGearEnchantPanel(panel)
			elseif tab.id == "tier" and ns.BuildTierSetPanel then
				ns.BuildTierSetPanel(panel)
			elseif tab.id == "omnium" and ns.BuildOmniumFolioPanel then
				ns.BuildOmniumFolioPanel(panel)
			elseif tab.id == "currency" and ns.BuildCurrencyGuidePanel then
				ns.BuildCurrencyGuidePanel(panel)
			elseif tab.id == "starthere" and ns.BuildStartHerePanel then
				ns.BuildStartHerePanel(panel)
			elseif tab.id == "dungeons" and ns.BuildDungeonGuidePanel then
				ns.BuildDungeonGuidePanel(panel)
			elseif tab.id == "toolslaunch" and ns.BuildToolsLaunchpad then
				ns.BuildToolsLaunchpad(panel)
			elseif tab.id == "settings" and ns.BuildSettingsPanel then
				ns.BuildSettingsPanel(panel)
			end
		end
	end

	-- Toolbox: Macros + Consumables + Role Academy merged into one tab with a
	-- sub-tab row (same pattern as the Addons host below). The three panels
	-- stay registered in ns.panels under their old ids so existing references
	-- (RefreshLocaleUI, ConsumablesPanel.lua) keep working; SelectTab's
	-- hide-all loop hides them, after which SelectToolboxSubTab re-shows the
	-- active one — same mechanism the Guide host uses for guideBody.
	do
		local toolboxHost = CreateFrame("Frame", "MidnightHelperToolboxHost", content)
		toolboxHost:SetAllPoints()
		toolboxHost:Hide()
		ns.panels.toolbox = toolboxHost

		local subNav = CreateFrame("Frame", nil, toolboxHost)
		subNav:SetHeight(MHGetLayoutMetrics().addonSubNavHeight)
		subNav:SetPoint("TOPLEFT", toolboxHost, "TOPLEFT", 8, -8)
		subNav:SetPoint("TOPRIGHT", toolboxHost, "TOPRIGHT", -8, -8)
		toolboxHost._mhSubNav = subNav

		local line = toolboxHost:CreateTexture(nil, "ARTWORK")
		line:SetHeight(1)
		line:SetPoint("TOPLEFT", subNav, "BOTTOMLEFT", 0, -2)
		line:SetPoint("TOPRIGHT", subNav, "BOTTOMRIGHT", 0, -2)
		line:SetColorTexture(MH_CHROME.separator[1], MH_CHROME.separator[2], MH_CHROME.separator[3], 0.55)

		local subContent = CreateFrame("Frame", nil, toolboxHost)
		subContent:SetPoint("TOPLEFT", subNav, "BOTTOMLEFT", 0, MHGetLayoutMetrics().addonSubContentTopGap)
		subContent:SetPoint("BOTTOMRIGHT", toolboxHost, "BOTTOMRIGHT", -8, 8)
		toolboxHost._mhSubContent = subContent

		-- Same frame contract as CreateModulePanel (header/body placeholders),
		-- but parented to the Toolbox sub-content well.
		local function CreateToolboxSubPanel(id, displayName)
			local panel = CreateFrame("Frame", nil, subContent)
			panel:SetAllPoints()
			panel:Hide()

			local header = panel:CreateFontString(nil, "OVERLAY", "GameFontHighlightMedium")
			header:SetPoint("TOPLEFT", 12, -12)
			header:SetText(displayName)
			panel._header = header

			local body = panel:CreateFontString(nil, "OVERLAY", "GameFontHighlightSmall")
			body:SetPoint("TOPLEFT", header, "BOTTOMLEFT", 0, -8)
			body:SetWidth((subContent:GetWidth() or 600) - 24)
			body:SetJustifyH("LEFT")
			body:SetText(ns:L("MODULE_PLACEHOLDER"):format(displayName))
			panel._body = body
			panel:SetScript("OnShow", function()
				body:SetWidth(panel:GetWidth() - 24)
			end)

			ns.panels[id] = panel
			return panel
		end

		-- Consumables first: not beta-gated, so it is the safe default sub-tab.
		ns._mhToolboxSubTabDefs = {
			{ id = "consumables", labelKey = "TAB_CONSUMABLES" },
			{ id = "macros", labelKey = "TAB_MACROS", beta = true },
			{ id = "academy", labelKey = "TAB_ACADEMY", beta = true },
			-- All profession tools live in one hub (Overview | Treasures &
			-- Books | Course); legacy ids route there via the SelectTab alias.
			{ id = "professionsHub", labelKey = "TAB_PROFESSIONS" },
		}
		local TOOLBOX_BUILDERS = {
			consumables = function(p)
				if ns.BuildConsumablesPanel then
					ns.BuildConsumablesPanel(p)
				end
			end,
			macros = function(p)
				if ns.BuildInterruptMacrosPanel then
					ns.BuildInterruptMacrosPanel(p)
				end
			end,
			academy = function(p)
				if ns.BuildRoleAcademyPanel then
					ns.BuildRoleAcademyPanel(p)
				end
			end,
			professionsHub = function(p)
				if ns.BuildProfessionsHubPanel then
					ns.BuildProfessionsHubPanel(p)
				end
			end,
		}

		ns.toolboxSubTabButtons = {}
		ns._mhToolboxSubFrames = {}
		for _, def in ipairs(ns._mhToolboxSubTabDefs) do
			local btn = CreateFrame("Button", "MidnightHelperToolboxSubTab_" .. def.id, subNav, "UIPanelButtonTemplate")
			btn:SetSize(120, MHGetLayoutMetrics().addonSubTabHeight)
			btn:SetText(ns:L(def.labelKey))
			local subId = def.id
			btn:SetScript("OnClick", function()
				if ns.SelectToolboxSubTab then
					ns.SelectToolboxSubTab(subId)
				end
			end)
			ns.toolboxSubTabButtons[def.id] = btn

			local panel = CreateToolboxSubPanel(def.id, ns:L(def.labelKey))
			TOOLBOX_BUILDERS[def.id](panel)
			ns._mhToolboxSubFrames[def.id] = panel
		end
		ns.RelayoutToolboxSubNav()
	end

	-- Leveling Guides: original advisor (Guide.lua) + Layout keyboard prototype sub-tabs.
	do
		local guideHost = CreateFrame("Frame", "MidnightHelperLevelingGuidesHost", content)
		guideHost:SetAllPoints()
		guideHost:Hide()
		ns.panels.guide = guideHost

		local subNav = CreateFrame("Frame", nil, guideHost)
		subNav:SetHeight(MHGetLayoutMetrics().addonSubNavHeight)
		subNav:SetPoint("TOPLEFT", guideHost, "TOPLEFT", 8, -8)
		subNav:SetPoint("TOPRIGHT", guideHost, "TOPRIGHT", -8, -8)
		guideHost._mhSubNav = subNav

		local line = guideHost:CreateTexture(nil, "ARTWORK")
		line:SetHeight(1)
		line:SetPoint("TOPLEFT", subNav, "BOTTOMLEFT", 0, -2)
		line:SetPoint("TOPRIGHT", subNav, "BOTTOMRIGHT", 0, -2)
		line:SetColorTexture(MH_CHROME.separator[1], MH_CHROME.separator[2], MH_CHROME.separator[3], 0.55)

		local subContent = CreateFrame("Frame", nil, guideHost)
		subContent:SetPoint("TOPLEFT", subNav, "BOTTOMLEFT", 0, MHGetLayoutMetrics().addonSubContentTopGap)
		subContent:SetPoint("BOTTOMRIGHT", guideHost, "BOTTOMRIGHT", -8, 8)
		guideHost._mhSubContent = subContent

		local guideBody = CreateFrame("Frame", nil, subContent)
		guideBody:SetAllPoints()
		ns.panels.guideBody = guideBody

		local layoutPanel = CreateFrame("Frame", nil, subContent)
		layoutPanel:SetAllPoints()
		layoutPanel:Hide()
		ns._mhGuideLayoutPanel = layoutPanel

		ns.guideSubTabButtons = {}
		local btnGuide = CreateFrame("Button", "MidnightHelperGuideSubTab_guide", subNav, "UIPanelButtonTemplate")
		btnGuide:SetSize(100, MHGetLayoutMetrics().addonSubTabHeight)
		btnGuide:SetPoint("TOPLEFT", subNav, "TOPLEFT", 0, -6)
		btnGuide:SetText(ns:L("TAB_GUIDE_SUB_GUIDE"))
		btnGuide:SetScript("OnClick", function()
			ns._mhSelectGuideSubTab("guide")
		end)
		ns.guideSubTabButtons.guide = btnGuide

		local btnLayout = CreateFrame("Button", "MidnightHelperGuideSubTab_layout", subNav, "UIPanelButtonTemplate")
		btnLayout:SetSize(100, MHGetLayoutMetrics().addonSubTabHeight)
		btnLayout:SetPoint("TOPLEFT", btnGuide, "TOPRIGHT", 6, 0)
		btnLayout:SetText(ns:L("TAB_GUIDE_SUB_LAYOUT"))
		btnLayout:SetScript("OnClick", function()
			ns._mhSelectGuideSubTab("layout")
		end)
		ns.guideSubTabButtons.layout = btnLayout

		function ns._mhSelectGuideSubTab(which)
			if which ~= "guide" and which ~= "layout" then
				which = "guide"
			end
			ns.uiSelectedGuideSubTab = which
			if which == "guide" then
				guideBody:Show()
				layoutPanel:Hide()
				if ns.KeyboardLayoutPrototype_SetHighlight then
					ns.KeyboardLayoutPrototype_SetHighlight(layoutPanel, nil)
				end
				MHRefreshGuideSubTabChrome("guide")
				if ns._mhGuideRefresh then
					ns:_mhGuideRefresh()
				end
			else
				guideBody:Hide()
				layoutPanel:Show()
				MHRefreshGuideSubTabChrome("layout")
				if ns.BuildKeyboardLayoutPrototypePanel then
					ns.BuildKeyboardLayoutPrototypePanel(layoutPanel)
				end
				if ns.KeyboardLayoutPrototype_Refresh then
					ns.KeyboardLayoutPrototype_Refresh(layoutPanel)
				end
			end
		end

		ns.uiSelectedGuideSubTab = ns.uiSelectedGuideSubTab or "guide"
		ns._mhSelectGuideSubTab(ns.uiSelectedGuideSubTab)
	end

	-- Addons: single main tab with a top row of sub-tabs and a shared content well.
	local addonsPanel = CreateFrame("Frame", "MidnightHelperAddonsHost", content)
	addonsPanel:SetAllPoints()
	addonsPanel:Hide()
	ns.panels["addons"] = addonsPanel

	local addonsSubNav = CreateFrame("Frame", nil, addonsPanel)
	addonsSubNav:SetHeight(MHGetLayoutMetrics().addonSubNavHeight)
	addonsSubNav:SetPoint("TOPLEFT", addonsPanel, "TOPLEFT", 8, -8)
	addonsSubNav:SetPoint("TOPRIGHT", addonsPanel, "TOPRIGHT", -8, -8)

	local addonsLine = addonsPanel:CreateTexture(nil, "ARTWORK")
	addonsLine:SetHeight(1)
	addonsLine:SetPoint("TOPLEFT", addonsSubNav, "BOTTOMLEFT", 0, -2)
	addonsLine:SetPoint("TOPRIGHT", addonsSubNav, "BOTTOMRIGHT", 0, -2)
	addonsLine:SetColorTexture(MH_CHROME.separator[1], MH_CHROME.separator[2], MH_CHROME.separator[3], 0.55)

	local addonsSubContent = CreateFrame("Frame", nil, addonsPanel)
	addonsSubContent:SetPoint("TOPLEFT", addonsSubNav, "BOTTOMLEFT", 0, MHGetLayoutMetrics().addonSubContentTopGap)
	addonsSubContent:SetPoint("BOTTOMRIGHT", addonsPanel, "BOTTOMRIGHT", -8, 8)

	ns._mhAddonSubFrames = {}
	ns.addonSubTabButtons = {}

	local navX = 0
	for _, subId in ipairs(ns._mhAddonSubTabOrder) do
		local def = ns._mhAddonSubTabById[subId]
		if def and def.Build then
			local btn = CreateFrame("Button", "MidnightHelperAddonSubTab_" .. subId, addonsSubNav, "UIPanelButtonTemplate")
			btn:SetSize(120, MHGetLayoutMetrics().addonSubTabHeight)
			btn:SetText(def.label)
			btn:SetPoint("TOPLEFT", addonsSubNav, "TOPLEFT", navX, -6)
			btn:SetScript("OnClick", function()
				SelectAddonSubTab(subId)
			end)
			ns.addonSubTabButtons[subId] = btn
			navX = navX + btn:GetWidth() + 6

			local child = def.Build(addonsSubContent)
			if child then
				child:SetAllPoints(addonsSubContent)
				child:Hide()
				ns._mhAddonSubFrames[subId] = child
			end
		end
	end

	-- Tab buttons stacked in the sidebar (Addons sits just above About).
	ns.tabButtons = ns.tabButtons or {}
	local y = -8
	for i, tab in ipairs(TAB_DEFS) do
		local btn = CreateFrame("Button", "MidnightHelperTab_" .. tab.id, sidebar, "UIPanelButtonTemplate")
		btn:SetSize(MHGetLayoutMetrics().sidebarWidth - 16, MHGetLayoutMetrics().sidebarTabHeight)
		btn:SetPoint("TOPLEFT", sidebar, "TOPLEFT", 8, y)
		y = y - MHGetLayoutMetrics().sidebarTabStep
		btn:SetText(ns:L(tab.labelKey))
		FitSidebarTabButton(btn, MHGetLayoutMetrics().sidebarWidth)
		btn:SetScript("OnClick", function()
			SelectTab(tab.id)
		end)
		MHAttachTabBetaBadge(btn, tab.id)
		ns.tabButtons[tab.id] = btn
	end

	-- Kamer-rail (Phase 2): 4 icoon+label-knoppen bovenaan de zijbalk. Klikken
	-- opent de eerste zichtbare tab van die kamer (SelectTab herlayout't de rail).
	ns._mhRoomButtons = ns._mhRoomButtons or {}
	local function MHFirstVisibleTabInRoom(roomId)
		for _, section in ipairs(SIDEBAR_SECTIONS) do
			if section.room == roomId then
				for _, id in ipairs(section.ids) do
					if ns.tabButtons and ns.tabButtons[id] and SidebarTabVisible(id) then
						return id
					end
				end
			end
		end
		-- The player hid every screen in this room: open the first one anyway, rather than a
		-- room button that silently does nothing.
		for _, section in ipairs(SIDEBAR_SECTIONS) do
			if section.room == roomId then
				for _, id in ipairs(section.ids) do
					if ns.tabButtons and ns.tabButtons[id] and SidebarTabAvailable(id) then
						return id
					end
				end
			end
		end
		return nil
	end
	--- Na een look-wissel het open scherm brengen naar de weergave die in DIE look bestaat.
	---
	--- Rob, 16 sep 2026: in Classic het Midnight Codex-scherm openen, dan op Modern klikken — hij
	--- bleef op die pagina staan mét de kaart-banner erboven. Andersom is het erger: een kaartgrid
	--- (`room_*`) bestaat in Classic niet, dus daar blijf je in een scherm hangen dat de zijbalk
	--- niet kan maken.
	---
	--- Dus: naar Modern gaat een scherm dat bij een kamer hoort naar de kaarten van die kamer
	--- (precies wat de kamerknop in Modern doet), en naar Classic gaat een kaartgrid naar het
	--- eerste scherm van die kamer, zoals 3.x deed. Een kamer met één scherm verandert niets:
	--- `OpenRoomLauncher` geeft dan false terug.
	ns._mhRerouteForLook = function(lookOn)
		local sel = ns.uiSelectedTab
		if not sel then
			return
		end
		local openRoom = sel:match("^room_(.+)$")
		if openRoom then
			if not lookOn then
				local target = MHFirstVisibleTabInRoom(openRoom)
				if target then
					SelectTab(target)
				end
			end
			return
		end
		if not lookOn then
			return
		end
		for _, section in ipairs(SIDEBAR_SECTIONS) do
			if section.room then
				for _, id in ipairs(section.ids) do
					if id == sel then
						if ns.OpenRoomLauncher then
							ns:OpenRoomLauncher(section.room)
						end
						return
					end
				end
			end
		end
	end

	local function MHSelectRoom(roomId)
		-- 4.0: a room with more than one screen opens its card grid (Modules/RoomLauncher.lua).
		-- Classic, or a room with a single screen, keeps the 3.x behaviour: its first tab.
		if ns.OpenRoomLauncher and ns:OpenRoomLauncher(roomId) then
			return
		end
		local target = MHFirstVisibleTabInRoom(roomId)
		if target then
			SelectTab(target)
		end
	end
	for _, roomDef in ipairs(SIDEBAR_ROOMS) do
		local rb = CreateFrame("Button", "MidnightHelperRoom_" .. roomDef.id, sidebar)
		rb:SetHeight(MHGetLayoutMetrics().sidebarTabHeight)
		local bg = rb:CreateTexture(nil, "BACKGROUND")
		bg:SetAllPoints()
		bg:SetColorTexture(0.18, 0.16, 0.20, 0.55)
		rb._mhBg = bg
		local icon = rb:CreateTexture(nil, "ARTWORK")
		icon:SetSize(16, 16)
		icon:SetPoint("LEFT", rb, "LEFT", 4, 0)
		icon:SetTexture(roomDef.icon)
		icon:SetTexCoord(0.08, 0.92, 0.08, 0.92)
		rb._mhIcon = icon
		local lbl = rb:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
		lbl:SetPoint("LEFT", icon, "RIGHT", 5, 0)
		lbl:SetPoint("RIGHT", rb, "RIGHT", -4, 0)
		lbl:SetJustifyH("LEFT")
		rb._mhLabel = lbl
		local hl = rb:CreateTexture(nil, "HIGHLIGHT")
		hl:SetAllPoints()
		hl:SetColorTexture(1, 0.82, 0.2, 0.15)
		rb._mhRoomId = roomDef.id
		rb._mhLabelKey = roomDef.labelKey
		rb:SetScript("OnClick", function()
			MHSelectRoom(roomDef.id)
		end)
		ns._mhRoomButtons[roomDef.id] = rb
	end

	-- (Simpele-modus-schakelaar verwijderd — uitgefaseerd in Phase 2 door de kamer-rail;
	-- schreef alleen nog het spookveld ns.db.simpleMode en werd altijd verborgen. F3.8.)

	RelayoutSidebarTabs = function()
		ns._mhSidebarRelaying = true -- recursion-guard: SelectTab relayout't ook
		local lm = MHGetLayoutMetrics()
		local yy = -8


		-- Kamer-rail: 4 knoppen, de actieve gemarkeerd. Daaronder tonen we alleen
		-- de secties van de actieve kamer (afgeleid van de huidige tab).
		local activeRoom = MHActiveRoom()
		if ns._mhRoomButtons then
			for _, roomDef in ipairs(SIDEBAR_ROOMS) do
				local rb = ns._mhRoomButtons[roomDef.id]
				if rb then
					local isActive = (roomDef.id == activeRoom)
					local lookOn = MHLookOn()
					-- 4.0: the rooms ARE the navigation (no tab list below them; the cards replace
					-- it), so they get room for our own painted icons. Classic keeps 3.x sizes.
					local railH = lookOn and (lm.compact and 38 or 44) or lm.sidebarTabHeight
					rb:SetSize(lm.sidebarWidth - 16, railH)
					if rb._mhIcon then
						if lookOn then
							local screen = LOOK_SCREENS[roomDef.id == "settings" and "settings" or ("room_" .. roomDef.id)]
							rb._mhIcon:SetTexture(LOOK_ICON_PATH:format((screen and screen.stem) or "home"))
							rb._mhIcon:SetTexCoord(0, 1, 0, 1)
							rb._mhIcon:SetSize(railH - 10, railH - 10)
						else
							rb._mhIcon:SetTexture(roomDef.icon)
							rb._mhIcon:SetTexCoord(0.08, 0.92, 0.08, 0.92)
							rb._mhIcon:SetSize(16, 16)
						end
					end
					if rb._mhLabel then
						rb._mhLabel:SetFontObject(lookOn and GameFontNormal or GameFontNormalSmall)
					end
					if rb._mhLabel then
						rb._mhLabel:SetText(ns:L(roomDef.labelKey))
						if lookOn then
							local c = isActive and LOOK_PALETTE.header or LOOK_PALETTE.muted
							rb._mhLabel:SetTextColor(c[1], c[2], c[3])
						elseif isActive then
							rb._mhLabel:SetTextColor(1, 0.95, 0.6)
						else
							rb._mhLabel:SetTextColor(0.82, 0.78, 0.68)
						end
					end
					if rb._mhBg then
						if lookOn then
							if isActive then
								rb._mhBg:SetColorTexture(MHUnpack4(LOOK_PALETTE.active))
							else
								rb._mhBg:SetColorTexture(0, 0, 0, 0)
							end
						elseif isActive then
							rb._mhBg:SetColorTexture(0.85, 0.65, 0.13, 0.55)
						else
							rb._mhBg:SetColorTexture(0.18, 0.16, 0.20, 0.55)
						end
					end
					if not rb._mhLookBar then
						local bar = rb:CreateTexture(nil, "ARTWORK")
						bar:SetPoint("TOPLEFT", rb, "TOPLEFT", 0, 0)
						bar:SetPoint("BOTTOMLEFT", rb, "BOTTOMLEFT", 0, 0)
						bar:SetWidth(2)
						rb._mhLookBar = bar
					end
					rb._mhLookBar:SetColorTexture(MHUnpack4(LOOK_PALETTE.accent))
					rb._mhLookBar:SetShown(lookOn and isActive)
					rb:ClearAllPoints()
					rb:SetPoint("TOPLEFT", sidebar, "TOPLEFT", 8, yy)
					rb:Show()
					yy = yy - (lookOn and (railH + 6) or lm.sidebarTabStep)
				end
			end
			yy = yy - SIDEBAR_SECTION_GAP
		end

		-- Eerst ÁLLE tab-knoppen verbergen: knoppen in volledig-verborgen secties
		-- (simpele modus) worden anders nooit aangeraakt en blijven op hun creatie-
		-- positie staan → overlap (Robs screen 1). Daarna plaatsen we de zichtbare.
		if ns.tabButtons then
			for _, b in pairs(ns.tabButtons) do
				if b and b.Hide then
					b:Hide()
				end
			end
		end

		sidebar._mhSectionHeaders = sidebar._mhSectionHeaders or {}

		-- The old beta band separators are unused in the sectioned layout.
		if sidebar._mhBetaSepTop then
			sidebar._mhBetaSepTop:Hide()
		end
		if sidebar._mhBetaSepBottom then
			sidebar._mhBetaSepBottom:Hide()
		end

		local function layoutTab(tabId)
			local btn = ns.tabButtons and ns.tabButtons[tabId]
			if not btn then
				return
			end
			local labelKey = TAB_LABEL_BY_ID[tabId]
			if labelKey then
				btn:SetText(ns:L(labelKey))
			end
			FitSidebarTabButton(btn, lm.sidebarWidth)
			btn:SetSize(lm.sidebarWidth - 16, lm.sidebarTabHeight)
			btn:ClearAllPoints()
			if not SidebarTabVisible(tabId) then
				btn:Hide()
				return
			end
			btn:SetPoint("TOPLEFT", sidebar, "TOPLEFT", 8, yy)
			btn:Show()
			MHAttachTabBetaBadge(btn, tabId)
			yy = yy - lm.sidebarTabStep
		end

		local firstSectionDrawn = false
		for _, section in ipairs(SIDEBAR_SECTIONS) do
			local visibleCount = 0
			-- 4.0: no tab list under the rooms; the room cards replace it (Rob, 12 Sep: "dan is
			-- die lange lijst aan de linker zijde in mijn ogen overbodig"). Classic keeps it.
			if section.room == activeRoom and not MHLookOn() then
				for _, tabId in ipairs(section.ids) do
					local btn = ns.tabButtons and ns.tabButtons[tabId]
					if btn and SidebarTabVisible(tabId) then
						visibleCount = visibleCount + 1
					end
				end
			end

			local header = sidebar._mhSectionHeaders[section.key]
			if not header then
				header = sidebar:CreateFontString(nil, "OVERLAY", "GameFontNormalSmall")
				header:SetJustifyH("LEFT")
				header:SetTextColor(0.91, 0.76, 0.42)
				sidebar._mhSectionHeaders[section.key] = header
			end
			header:SetText(ns:L(section.titleKey))
			if MHLookOn() then
				header:SetTextColor(LOOK_PALETTE.header[1], LOOK_PALETTE.header[2], LOOK_PALETTE.header[3])
			else
				header:SetTextColor(0.91, 0.76, 0.42)
			end

			if visibleCount > 0 then
				if firstSectionDrawn then
					yy = yy - SIDEBAR_SECTION_GAP
				end
				header:ClearAllPoints()
				header:SetPoint("TOPLEFT", sidebar, "TOPLEFT", 10, yy)
				header:Show()
				yy = yy - SIDEBAR_HEADER_HEIGHT
				firstSectionDrawn = true
				for _, tabId in ipairs(section.ids) do
					layoutTab(tabId)
				end
			else
				header:Hide()
			end
		end

		-- Keep the window tall enough for the full sidebar's tabs. About no longer sits
		-- at the sidebar bottom (it moved to the title bar), so we only reserve a little
		-- bottom padding — which is why the last tab used to be crowded by About.
		do
			local tabsHeight = -yy
			local aboutArea = 8
			-- The sidebar is anchored BELOW the favourites row, so its height must be
			-- reserved too — leaving it out made the auto-grow ~24px short, which pushed
			-- the last tab (Delve & Ritual Log in the tall "Me" room) off the bottom edge
			-- (Rob 16 jul). Read the row's real height so compact mode stays correct.
			local favH = (ns.mhFavRow and ns.mhFavRow.GetHeight and ns.mhFavRow:GetHeight()) or 0
			local overhead = MH_MAIN_EDGE.T + TITLE_BAR_HEIGHT + lm.searchBarHeight + favH + MH_MAIN_EDGE.B
			local requiredH = math.min(MAX_HEIGHT, math.ceil(tabsHeight + aboutArea + overhead))
			local minH = math.max(MIN_HEIGHT, requiredH)
			if main and main.SetResizeBounds then
				UpdateMaxWindowBounds()
				main:SetResizeBounds(MIN_WIDTH, minH, MAX_WIDTH, MAX_HEIGHT)
			end
			if main and (main:GetHeight() or 0) < minH then
				-- Programmatic resize: must not mark the window as user-sized.
				ns._mhProgrammaticResize = true
				main:SetHeight(minH)
				ns._mhProgrammaticResize = false
				local dbUi = ns.db and ns.db.ui
				if dbUi then
					dbUi.mainHeight = ClampMainHeight(minH)
				end
			end
		end

		-- Bestaat de geselecteerde tab hier niet meer (beta-gate)? Val terug op Home (altijd
		-- zichtbaar). Een scherm dat de speler zelf verstopte blijft open: verstoppen haalt het
		-- alleen uit de lijsten, en SelectTab komt hier ook langs (anders sprong zoeken terug).
		if ns.uiSelectedTab and ns.uiSelectedTab ~= "home" and not SidebarTabAvailable(ns.uiSelectedTab) then
			SelectTab("home")
		elseif ns.uiSelectedTab == "guide" and ns.IsGuideTabEnabled and not ns:IsGuideTabEnabled() then
			SelectTab("home")
		end
		ns._mhSidebarRelaying = false
	end

	-- Resize grip: bottom-right corner uses StartSizing so the shell stays resizable.
	local grip = CreateFrame("Button", nil, main)
	grip:SetSize(RESIZE_GRIP_SIZE, RESIZE_GRIP_SIZE)
	grip:SetPoint("BOTTOMRIGHT", main, "BOTTOMRIGHT", -MH_MAIN_EDGE.R - 2, MH_MAIN_EDGE.B + 2)
	grip:SetFrameLevel(main:GetFrameLevel() + 25)
	grip:RegisterForDrag("LeftButton")
	-- Simple corner affordance; drag starts BOTTOMRIGHT sizing on the main frame.
	grip:SetNormalTexture("Interface\\Buttons\\UI-ResizeButton-Up")
	grip:SetPushedTexture("Interface\\Buttons\\UI-ResizeButton-Down")
	grip:SetHighlightTexture("Interface\\Buttons\\UI-Common-MouseHilight", "ADD")
	grip:SetScript("OnDragStart", function()
		main:StartSizing("BOTTOMRIGHT")
	end)
	grip:SetScript("OnDragStop", function()
		main:StopMovingOrSizing()
		if ns._mhLayoutRefs and ns._mhLayoutRefs.reanchorInfoWindow then
			ns._mhLayoutRefs.reanchorInfoWindow()
		end
	end)

	local function SaveMainWindowSize()
		local dbUi = ns.db and ns.db.ui
		if not dbUi then
			return
		end
		dbUi.mainWidth = ClampMainWidth(math.floor(main:GetWidth() or DEFAULT_WIDTH))
		dbUi.mainHeight = ClampMainHeight(math.floor(main:GetHeight() or DEFAULT_HEIGHT))
		dbUi.mainWindowUserSized = true
		dbUi.layoutVersion = math.max(tonumber(dbUi.layoutVersion) or 0, 3)
	end

	-- Remember where the user dragged the window (F4.6). Stored relative to UIParent.
	local function SaveMainWindowPosition()
		local dbUi = ns.db and ns.db.ui
		if not dbUi then
			return
		end
		local point, _, relativePoint, x, y = main:GetPoint(1)
		if not point then
			return
		end
		dbUi.mainPoint = {
			point = point,
			relativePoint = relativePoint,
			x = math.floor(x or 0),
			y = math.floor(y or 0),
		}
	end

	function ns:SaveMainWindowSize()
		if not self.mainUI then
			return
		end
		SaveMainWindowSize()
	end

	function ns:PrintMainWindowSize()
		local dbUi = ns.db and ns.db.ui
		local w = self.mainUI and math.floor(self.mainUI:GetWidth() or 0) or 0
		local h = self.mainUI and math.floor(self.mainUI:GetHeight() or 0) or 0
		local scale = dbUi and tonumber(dbUi.scale) or 1
		local savedW = dbUi and tonumber(dbUi.mainWidth)
		local savedH = dbUi and tonumber(dbUi.mainHeight)
		local msg = self:L("FRAME_SIZE_REPORT"):format(w, h, scale, savedW or "-", savedH or "-")
		DEFAULT_CHAT_FRAME:AddMessage(("|cffffcc00%s|r %s"):format(self:L("PRINT_PREFIX"), msg))
	end

	main:SetScript("OnSizeChanged", function()
		-- Only persist user-driven resizes; programmatic SetHeight/SetSize calls
		-- (RelayoutSidebarTabs, Delves min-height, ApplySavedMainWindowSize) set
		-- this flag so they don't flip mainWindowUserSized and kill auto-sizing.
		if ns._mhProgrammaticResize then
			return
		end
		SaveMainWindowSize()
	end)
	titleBar:SetScript("OnDragStop", function()
		main:StopMovingOrSizing()
		if ns._mhLayoutRefs and ns._mhLayoutRefs.reanchorInfoWindow then
			ns._mhLayoutRefs.reanchorInfoWindow()
		end
		SaveMainWindowSize()
		SaveMainWindowPosition()
	end)
	grip:SetScript("OnDragStop", function()
		main:StopMovingOrSizing()
		if ns._mhLayoutRefs and ns._mhLayoutRefs.reanchorInfoWindow then
			ns._mhLayoutRefs.reanchorInfoWindow()
		end
		SaveMainWindowSize()
		SaveMainWindowPosition()
	end)

	ns._mhLocaleRefs = {
		title = title,
		titleVersion = titleVersion,
		searchHint = searchBarHint,
		searchResetBtn = searchResetBtn,
		searchGoBtn = searchGoBtn,
		aboutBtn = aboutBtn,
		infoToggleBtn = infoToggleBtn,
		tabKeys = tabKeys,
		guideSubTabButtons = ns.guideSubTabButtons,
		smcHeader = ns.panels.smcguide and ns.panels.smcguide._header,
		smcSubtitle = ns.panels.smcguide and ns.panels.smcguide._mhSMCSubtitle,
	}
	ns._mhLayoutRefs = {
		main = main,
		sidebar = sidebar,
		content = content,
		searchBar = searchBar,
		favRow = favRow,
		levelBar = levelBar,
		lookHeader = lookHeader,
		-- 4.0 palette surfaces (MHApplyLookChrome).
		titleTex = titleHighlight,
		titleText = title,
		searchBg = searchBarBg,
		favBg = favRowBg,
		sidebarBg = sidebarBg,
		contentBg = contentBg,
		infoToggleBtn = infoToggleBtn,
		searchResetBtn = searchResetBtn,
		searchGoBtn = searchGoBtn,
		aboutBtn = aboutBtn,
		lookToggleBtn = lookToggleBtn,
		guidePanel = ns.panels.guide,
		addonsPanel = addonsPanel,
		addonsSubNav = addonsSubNav,
		addonsSubContent = addonsSubContent,
		infoWindow = infoWindow,
		reanchorInfoWindow = reanchorInfoWindow,
	}
	ns._mhInfoWindow = infoWindow
	ns._mhRelayoutSidebarTabs = RelayoutSidebarTabs
	ns:RefreshLocaleUI()
	RelayoutSidebarTabs()

	self.mainUI = main
	self.mainUIContent = content

	-- Old keys: the standalone Great Vault ("vault") and Companion tabs merged into the
	-- Delves dashboard. NB: do NOT remap "dungeons" — that is a real tab again (F3.8).
	if ns.uiSelectedTab == "vault" or ns.uiSelectedTab == "companion" then
		ns.uiSelectedTab = "delves"
	end

	-- Default screen on first open: the 4.0 look opens on the Me room's cards (Rob, 12 Sep:
	-- he only saw the cards after clicking Me); Classic keeps This Week.
	local openedCards = not ns.uiSelectedTab and MHLookOn() and ns.OpenRoomLauncher and ns:OpenRoomLauncher("me")
	if not openedCards then
		SelectTab(ns.uiSelectedTab or "home")
	end
	ns:ApplySavedMainWindowSize()
	ns:_mhRefreshSidePanel(ns.uiSelectedTab or "home")

	-- The window can be built before the SavedVariables are loaded, so the look is settled
	-- again each time it opens: a Classic player never sees 4.0 colours or room cards.
	main:HookScript("OnShow", function()
		if type(ns.uiSelectedTab) == "string" and ns.uiSelectedTab:match("^room_") and not MHLookOn() then
			SelectTab(ns.uiSelectedTab) -- a card grid is 4.0-only; SelectTab opens the room's first tab
		elseif ns.RefreshLookHeader then
			ns:RefreshLookHeader()
		end
	end)

	main:SetScript("OnHide", function()
		if ns._mhInfoWindow and ns._mhInfoWindow.Hide then
			ns._mhInfoWindow:Hide()
		end
		-- 🔴 A HIDDEN BOX CAN STILL OWN THE KEYBOARD. The window closes by several routes
		-- — Escape through UISpecialFrames, the X, the minimap button, a slash command —
		-- and the OnEscapePressed handler on the box only covers one of them. Releasing
		-- here covers all of them at once, and costs nothing when the box never had focus.
		if ns.mhSearchEdit and ns.mhSearchEdit.ClearFocus then
			ns.mhSearchEdit:ClearFocus()
		end
	end)

	-- Enable interactive scaling with Shift + MouseWheel
	main:EnableMouseWheel(true)
	main:SetScript("OnMouseWheel", function(self, delta)
		if IsShiftKeyDown() then
			local currentScale = ns.db.ui.scale or 1
			-- Change scale by 5% per scroll tick
			local newScale = currentScale + (delta * 0.05)

			-- Keep scale within usable bounds (50% to 300%)
			newScale = math.max(0.5, math.min(3.0, newScale))

			ns.db.ui.scale = newScale
			ns:ApplyCompactMode()

			-- Optional: show scale in chat for feedback
			-- print(string.format("|cffffcc00Midnight Helper:|r Scale: %.2f", newScale))
		end
	end)

	-- Apply the saved scale on load, then restore user window dimensions (tab init must not override).
	ns:ApplyCompactMode()
	ns:ApplySavedMainWindowSize()

	return main
end

--------------------------------------------------------------------------------
-- Tab routing: one module frame visible at a time
--------------------------------------------------------------------------------
SelectTab = function(tabId)
	-- Legacy ids from before the Toolbox merge (saved tabs, Guide.lua
	-- navigation, slash commands) route to the matching Toolbox sub-tab.
	if tabId == "macros" or tabId == "consumables" or tabId == "academy" then
		ns.uiSelectedToolboxSubTab = tabId
		tabId = "toolbox"
	end
	-- Profession tools were merged into one hub sub-tab with inner tabs;
	-- legacy ids land on the matching inner tab.
	if tabId == "professions" or tabId == "profacademy" or tabId == "profoverview" then
		-- "professions" has always landed on Treasures & Books, which is fine for the
		-- legacy id but wrong for anyone sent here to SPEND Knowledge -- the advice
		-- lives on Overview. Hence a third id rather than changing what the old one
		-- does (Rob clicked a KP line and got a treasure list, 2026-07-22).
		local inner = "treasures"
		if tabId == "profacademy" then
			inner = "course"
		elseif tabId == "profoverview" then
			inner = "overview"
		end
		ns.uiSelectedProfHubInner = inner
		ns.uiSelectedToolboxSubTab = "professionsHub"
		tabId = "toolbox"
	end
	-- Same for the former Reference tab: now a Codex category.
	if tabId == "reference" then
		if ns.SetActiveCodexCategory then
			ns.SetActiveCodexCategory("reference")
		end
		tabId = "codex"
	end
	if tabId == "guide" and ns.IsGuideTabEnabled and not ns:IsGuideTabEnabled() then
		tabId = "home"
	end
	-- A room card grid is a 4.0 screen; with Classic on, open the room's own first tab.
	local launcherRoom = type(tabId) == "string" and tabId:match("^room_(%a+)$")
	if launcherRoom and ns.IsClassicLookEnabled and ns:IsClassicLookEnabled() then
		local roomDef = SIDEBAR_ROOM_BY_ID[launcherRoom]
		tabId = (roomDef and roomDef.defaultTab) or "home"
	end
	if not ns.panels or not ns.panels[tabId] then
		-- Saved/stale tab id no longer exists (e.g. merged or removed tab): fall
		-- back to Home rather than leaving the window blank.
		if ns.panels and ns.panels["home"] then
			tabId = "home"
		else
			return
		end
	end

	ns.uiSelectedTab = tabId

	-- Phase 3: breadcrumb 'Kamer > Tab' bijwerken (oriëntatie in de titelbalk).
	if ns._mhBreadcrumb then
		local roomId = MHRoomForTab(tabId)
		local roomDef = roomId and SIDEBAR_ROOM_BY_ID[roomId]
		local roomLabel = (roomDef and ns:L(roomDef.labelKey)) or ""
		local tabKey = TAB_LABEL_BY_ID[tabId]
		local tabLabel = (tabKey and ns:L(tabKey)) or ""
		local text = roomLabel
		if tabLabel ~= "" and tabLabel ~= roomLabel then
			text = (roomLabel ~= "" and (roomLabel .. "  >  ") or "") .. tabLabel
		end
		ns._mhBreadcrumb:SetText(text)
	end

	-- Phase 3 cross-link: toon "Read in Codex" als deze tab een Codex-categorie heeft.
	if ns._mhCodexLinkBtn then
		local cat = (tabId ~= "codex") and TAB_TO_CODEX[tabId] or nil
		if cat then
			ns._mhCodexLinkBtn._mhCat = cat
			ns._mhCodexLinkBtn:Show()
		else
			ns._mhCodexLinkBtn._mhCat = nil
			ns._mhCodexLinkBtn:Hide()
		end
	end

	for id, panel in pairs(ns.panels) do
		if id == tabId then
			panel:Show()
		else
			panel:Hide()
		end
	end

	-- Blizzard-ish tab chrome: warm metal active vs muted inactive (UIPanelButton textures only).
	MHRefreshSidebarTabChrome(tabId)
	if ns._mhRefreshSidePanel then
		ns:_mhRefreshSidePanel(tabId)
	end

	if tabId == "guide" then
		local sid = ns.uiSelectedGuideSubTab or "guide"
		if ns._mhSelectGuideSubTab then
			ns._mhSelectGuideSubTab(sid)
		end
	end

	if tabId == "rares" and ns.RefreshRaresPanel then
		ns.RefreshRaresPanel()
	end

	if tabId == "codex" and ns.RefreshCodexPanel then
		ns.RefreshCodexPanel()
	end
	if tabId == "home" and ns.RefreshHomePanel then
		ns.RefreshHomePanel()
	end
	if tabId == "world" and ns.RefreshWorldPanel then
		ns.RefreshWorldPanel()
	end
	if tabId == "delvelog" and ns.RefreshDelveLogPanel then
		ns.RefreshDelveLogPanel()
	end
	if tabId == "enchants" and ns.RefreshGearEnchantPanel then
		ns.RefreshGearEnchantPanel()
	end
	if tabId == "tier" and ns.RefreshTierSetPanel then
		ns.RefreshTierSetPanel()
	end
	if tabId == "currency" and ns.RefreshCurrencyGuidePanel then
		ns.RefreshCurrencyGuidePanel()
	end
	if tabId == "starthere" and ns.RefreshStartHerePanel then
		ns.RefreshStartHerePanel()
	end
	if tabId == "dungeons" and ns.RefreshDungeonGuidePanel then
		ns.RefreshDungeonGuidePanel()
	end
	if tabId == "settings" and ns.RefreshSettingsPanel then
		ns.RefreshSettingsPanel()
	end

	if tabId == "delves" then
		if ns.RefreshDelvesPanel then
			ns.RefreshDelvesPanel(true)
		end
		-- No window auto-resize here anymore: the Delves content lives in a
		-- ScrollFrame (Delves.lua), so the 800px jump on tab switch was only
		-- jarring without adding reachability. ResolveMainHeightForOpen still
		-- normalizes pre-v3 saved layouts once on open.
	end

	if tabId == "toolbox" and ns.SelectToolboxSubTab then
		ns.SelectToolboxSubTab(ns.uiSelectedToolboxSubTab or "consumables")
	end

	if tabId == "addons" then
		local sid = ns.uiSelectedAddonSubTab
		if not sid or not (ns._mhAddonSubFrames and ns._mhAddonSubFrames[sid]) then
			sid = ns._mhAddonSubTabOrder and ns._mhAddonSubTabOrder[1]
		end
		if sid then
			SelectAddonSubTab(sid)
		end
	end

	-- Herlayout de zijbalk zodat de kamer-rail de kamer van de nieuwe tab toont.
	-- Guard: de fallback SelectTab("home") in RelayoutSidebarTabs zou anders recursen.
	if RelayoutSidebarTabs and not ns._mhSidebarRelaying then
		RelayoutSidebarTabs()
	end

	-- Info-drawer (rechtsboven) live meeverversen, zodat-ie altijd de ÉCHTE open tab
	-- toont en niet die van het moment dat je 'm opende (Rob 25 jun). _mhRefreshSidePanel
	-- respecteert de modus zelf (About blijft About; Info volgt de nieuwe tab).
	if ns._mhInfoWindow and ns._mhInfoWindow.IsShown and ns._mhInfoWindow:IsShown()
		and ns._mhRefreshSidePanel then
		ns:_mhRefreshSidePanel(tabId)
	end

	-- 4.0 screen header follows the open screen (and re-checks the Classic setting).
	if ns.RefreshLookHeader then
		ns:RefreshLookHeader()
	end
end

ns.SelectTab = SelectTab

function ns:RefreshGuideTabVisibility()
	if ns.RefreshBetaTabVisibility then
		ns.RefreshBetaTabVisibility()
	end
end

function ns.RefreshBetaTabVisibility()
	if RelayoutSidebarTabs then
		RelayoutSidebarTabs()
	end
	-- Toolbox sub-tabs are beta-gated too (macros/academy): reposition the
	-- sub-nav and bounce off a now-disabled sub-tab.
	if ns.RelayoutToolboxSubNav then
		ns.RelayoutToolboxSubNav()
	end
	if ns.uiSelectedTab == "toolbox" and ns.SelectToolboxSubTab then
		ns.SelectToolboxSubTab(ns.uiSelectedToolboxSubTab or "consumables")
	end
	-- Same for the Reference category inside the Codex: bounce to Start and
	-- re-render the category nav when its checkbox goes off while visible.
	if ns.uiSelectedTab == "codex" and ns.GetActiveCodexCategory and ns.GetActiveCodexCategory() == "reference"
		and ns.IsBetaTabEnabled and not ns.IsBetaTabEnabled("reference") and ns.RefreshCodexPanel then
		-- RefreshCodexPanel self-corrects the saved category (reference → start).
		ns.RefreshCodexPanel()
	end
	local t = ns.uiSelectedTab
	if not t or not ns.SelectTab then
		return
	end
	if ns.IsBetaTabId and ns.IsBetaTabId(t) and ns.IsBetaTabEnabled and not ns.IsBetaTabEnabled(t) then
		ns.SelectTab("home")
	elseif t == "guide" and ns.IsGuideTabEnabled and not ns:IsGuideTabEnabled() then
		ns.SelectTab("home")
	end
end

--------------------------------------------------------------------------------
-- Addons sub-tab routing (internal modules inside the Addons main tab)
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
-- Toolbox sub-tab routing (Macros / Consumables / Role Academy)
--------------------------------------------------------------------------------
function ns.SelectToolboxSubTab(subId)
	local frames = ns._mhToolboxSubFrames
	if not frames then
		return
	end
	-- Beta-gated sub-tab (macros/academy) switched off, or unknown id: fall
	-- back to the always-available Consumables sub-tab.
	if not frames[subId] then
		subId = "consumables"
	end
	for _, def in ipairs(ns._mhToolboxSubTabDefs or {}) do
		if def.id == subId and def.beta and ns.IsBetaTabEnabled and not ns.IsBetaTabEnabled(subId) then
			subId = "consumables"
			break
		end
	end
	if not frames[subId] then
		return
	end

	ns.uiSelectedToolboxSubTab = subId

	for id, frame in pairs(frames) do
		if id == subId then
			frame:Show()
		else
			frame:Hide()
		end
	end

	MHRefreshToolboxSubTabChrome(subId)
	-- The 4.0 header shows the sub-tab's own icon and line.
	if ns.RefreshLookHeader then
		ns:RefreshLookHeader()
	end
	-- Help drawer text follows the active sub-tab.
	if ns._mhRefreshSidePanel and ns.uiSelectedTab == "toolbox" then
		ns:_mhRefreshSidePanel("toolbox")
	end
end

SelectAddonSubTab = function(subId)
	if not ns._mhAddonSubFrames or not ns._mhAddonSubFrames[subId] then
		return
	end

	ns.uiSelectedAddonSubTab = subId

	for id, frame in pairs(ns._mhAddonSubFrames) do
		if id == subId then
			frame:Show()
		else
			frame:Hide()
		end
	end

	MHRefreshAddonSubTabChrome(subId)
end

ns.SelectAddonSubTab = SelectAddonSubTab

do
	local f = CreateFrame("Frame")
	f:RegisterEvent("PLAYER_LEVEL_UP")
	f:RegisterEvent("PLAYER_ENTERING_WORLD")
	f:SetScript("OnEvent", function()
		if ns.RefreshGuideTabVisibility then
			ns:RefreshGuideTabVisibility()
		end
	end)
end

--------------------------------------------------------------------------------
-- Public entry points used by Core.lua and slash commands
--------------------------------------------------------------------------------
function ns:ToggleMainWindow()
	local main = self:EnsureMainUI()
	if main:IsShown() then
		main:Hide()
	else
		main:Show()
		self:ApplySavedMainWindowSize()
		self:ApplySavedMainWindowPosition()
		-- Re-sync the sidebar with the current beta-tab settings on every open, so a
		-- toggle made in Settings (a different sidebar room) is always reflected without
		-- needing a /reload (Rob 2026-07-07).
		if ns.RefreshBetaTabVisibility then
			ns.RefreshBetaTabVisibility()
		end
		if self.uiSelectedTab == "guide" and self._mhSelectGuideSubTab then
			C_Timer.After(0, function()
				if self._mhSelectGuideSubTab then
					self._mhSelectGuideSubTab(self.uiSelectedGuideSubTab or "guide")
				end
			end)
		end
	end
end

function ns:ShowMainUI()
	local main = self:EnsureMainUI()
	main:Show()
	self:ApplySavedMainWindowSize()
	self:ApplySavedMainWindowPosition()
	if ns.RefreshBetaTabVisibility then
		ns.RefreshBetaTabVisibility() -- keep the sidebar in sync with beta-tab settings (see ToggleMainWindow)
	end
	if self.uiSelectedTab == "guide" and self._mhSelectGuideSubTab then
		C_Timer.After(0, function()
			if self._mhSelectGuideSubTab then
				self._mhSelectGuideSubTab(self.uiSelectedGuideSubTab or "guide")
			end
		end)
	end
end